- Command line programmer for Atmel SAM ARM microcontrollers
] [ FILE
BOSSA - the Basic Open Source SAM-BA Application - is a flash programmer for
Atmel SAM microcontrollers. This is the command line interface for writing
binary images to the target microcontroller's FLASH or ROM over a USB or
serial connection. Secondarily bossac
may be used to dump binary data
already on the target microcontroller or display diagnostic information about
- -e, --erase
- Erase the target's entire flash memory before performing
any read or write operations.
- -w, --write
- Write FILE to the target's flash memory. This
operation can be expedited immensely if used in conjunction with the
- -r, --read[=SIZE]
- Read SIZE bytes from the target's flash memory and
store the contents in FILE. If SIZE is not specified the
entire contents on the target's flash memory will subsequently be read and
written to disk.
- -v, --verify
- Verify that FILE matches the contents of flash on
the target, or vice-versa if you prefer.
- -p, --port[=PORT]
- Use the serial port PORT to communicate with the
device. By default this program will automatically scan all serial ports
looking for a supported device.
- -b, --boot[=BOOL]
- Boot from ROM if BOOL is 0. Boot from FLASH if
BOOL is 1. (The latter is default.) This option is completely
disregarded on unsupported devices.
- -c, --bod[=BOOL]
- Disable brownout detection if BOOL is 0. Enable
brownout detection if BOOL is 1. (The latter is default.)
- -t, --bor[=BOOL]
- Disable brownout reset if BOOL is 0. Enable brownout
reset if BOOL is 1. (The latter is default.)
- -l, --lock[=REGION]
- Lock the flash region REGION. Multiple regions may
be specified as a comma-separated list. All regions will be locked if no
REGION is given (default).
- -u, --unlock[=REGION]
- Unlock the flash region REGION. Multiple regions may
be specified as a comma-separated list. All regions will be unlocked if no
REGION is given (default).
- -s, --security
- Set the flash security flag.
- -U, --force_usb_port[=BOOL]
- Enable automatic detection of the target's USB port if
BOOL is false. Disable USB port autodetection if BOOL is
true. (The former is default.)
- -R, --reset
- Reset the CPU after writing FILE to the target. This
option is completely disregarded on unsupported devices.
- -i, --info
- Display diagnostic information identifying the target
- -d, --debug
- Print verbose diagnostic messages for debug purposes.
- -h, --help
- Display short command line help information.
-e -w -v -b image.bin # Erase FLASH, write image.bin
FLASH, verify the write, and set boot from FLASH
--port=ttyACM0 -U false -e -w -v -b -R image.bin # Do the same
thing as the previous example, except forceably write to the device connected
and reset the CPU after verifying the write
-r0x10000 image.bin # Read 64KB from FLASH on the target device,
then write it out to image.bin
on your hard disk
This manual page was written by Karl Lenz <firstname.lastname@example.org> for
the Debian project (but may be used by others).
Copyright (c) 2011-2013 ShumaTech <http://www.shumatech.com>
Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty provided the copyright notice and this
notice are preserved.
Bossac is provided "as is" with no warranty. This program is free
software: you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation, either
version 3 of the License, or (at your option) any later version. On Debian
systems, the complete text of the GNU General Public License version 3 can be
found in "/usr/share/common-licenses/GPL-3".