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)