Skip to content

Latest commit

 

History

History
83 lines (66 loc) · 3 KB

README.md

File metadata and controls

83 lines (66 loc) · 3 KB

BOSSA (Rust-edition)

Audit Dependencies Legacy Makefile Build Environment Rust Linux Rust macOS Rust Windows

docs.rs Crates.io Crates.io Crates.io

BOSSA is a flash programming utility for Atmel's SAM family of flash-based ARM microcontrollers. The motivation behind BOSSA is to create a simple, easy-to-use, open source utility to replace Atmel's SAM-BA software. BOSSA is an acronym for Basic Open Source SAM-BA Application to reflect that goal.

The software was originally by Scott Shumate with contributions from several contributors. Scott has not been active in a number of years and HaaTa needed a rust-lib version of BOSSA, hence this fork.

The software is released under the terms of the BSD license as specified in the LICENSE file.

Supported Builds

  • Rust (libbossa, bossac)
    • cargo build
    • cd bossac; cargo build; cargo run -- --help
    • Supports: msvc, macos, linux
  • C++ (bossa, bossac, bossash)
    • make -j
    • Supports: mingw, macos, linux msvc support hasn't been tested recently

Please see the GitHub Actions for build specifics.

Installation

If you already have rust on your system, you can use it to easily install bossac.

cargo install bossac

Supported Device Families

  • SAM7S
  • SAM7SE
  • SAM7X
  • SAM7XC
  • SAM3N
  • SAM3S
  • SAM3U
  • SAM4E
  • SAM4S
  • SAMD21
  • SAMD51
  • SAM3X*
  • SAM3A*
  • SAM7L*
  • SAM9XE*
  • SAMR21*
  • SAML21*
  • SAME51*
  • SAME53*
  • SAME54*
  • SAME70*
  • SAMS70*
  • SAMV70*
  • SAMV71*

* Device families which are not tested for each release and could stop working.

Please submit a PR if you're interested in fixing or adding support.

Actively looking for a co-maintainer for BOSSA

The following individuals and companies graciously provided development boards to assist the BOSSA project.

  • Atmel Corporation (SAM3N, SAM3S, SAM3U)
  • David Crocker (SAM4E, SAM4S)
  • Adafruit Industries (SAMD21, SAMD51)