bossac1

Usage

Overview

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 the device.

Options

-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 --erase option.

-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 device.

-d, --debug

Print verbose diagnostic messages for debug purposes.

-h, --help

Display short command line help information.

Examples

bossac -e -w -v -b image.bin # Erase FLASH, write image.bin to FLASH, verify the write, and set boot from FLASH
bossac --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 to ttyACM0 and reset the CPU after verifying the write
bossac -r0x10000 image.bin # Read 64KB from FLASH on the target device, then write it out to image.bin on your hard disk