NAME

       bossac - Command line programmer for Atmel SAM ARM microcontrollers

SYNOPSIS

       bossac [OPTIONS] [FILE]

DESCRIPTION

       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

AUTHOR

       This manual page was written by Karl Lenz <xorangekiller@gmail.com> for the Debian project
       (but may be used by others).

COPYRIGHT

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

SEE ALSO

       bossa(1), bossash(1)