Package: bossa-cli Version: 1.3~20120408-2 Severity: minor Tags: patch Cristian Maglie's patches added in bossa 1.3~20120408-2 implement two new bossac command line switches (-U and -R). These options should be documented in the bossac man page.
I attached two files to this message, each of which independently resolves the problem. The first is a minimally invasive patch which adds the two new options to the bossac man page and nothing more. The second is a completely new man page I wrote for bossac. It includes a better description of the program, more documentation on each option (including the two new ones), a proper copyright notice, and code that is hopefully easier to read and maintain. You can apply either one (or neither), but I recommend the new man page. -- System Information: Debian Release: jessie/sid APT prefers testing APT policy: (800, 'testing'), (400, 'unstable'), (200, 'experimental') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 3.12-1-amd64 (SMP w/4 CPU cores) Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages bossa-cli depends on: ii libc6 2.17-97 ii libgcc1 1:4.8.2-14 ii libreadline6 6.2+dfsg-0.1 ii libstdc++6 4.8.2-14 bossa-cli recommends no packages. bossa-cli suggests no packages.
..TH BOSSAC "1" "February 2014" "bossac 1.3a" "User Commands" ..SH NAME \fBbossac\fR \- Command line programmer for Atmel SAM ARM microcontrollers ..SH SYNOPSIS ..B bossac [\fIOPTIONS\fR] [\fIFILE\fR] ..SH 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 \fBbossac\fR may be used to dump binary data already on the target microcontroller or display diagnostic information about the device. ..SH OPTIONS ..IP \fB\-e\fR,\ \fB\-\-erase\fR Erase the target's entire flash memory before performing any read or write operations. ..IP \fB\-w\fR,\ \fB\-\-write\fR Write \fIFILE\fR to the target's flash memory. This operation can be expedited immensely if used in conjunction with the \fB\-\-erase\fR option. ..IP \fB\-r\fR,\ \fB\-\-read\fR[=\fISIZE\fR] Read \fISIZE\fR bytes from the target's flash memory and store the contents in \fIFILE\fR. If \fISIZE\fR is not specified the entire contents on the target's flash memory will subsequently be read and written to disk. ..IP \fB\-v\fR,\ \fB\-\-verify\fR Verify that \fIFILE\fR matches the contents of flash on the target, or vice\-versa if you prefer. ..IP \fB\-p\fR,\ \fB\-\-port\fR[=\fIPORT\fR] Use the serial port \fIPORT\fR to communicate with the device. By default this program will automatically scan all serial ports looking for a supported device. ..IP \fB\-b\fR,\ \fB\-\-boot\fR[=\fIBOOL\fR] Boot from ROM if \fIBOOL\fR is 0. Boot from FLASH if \fIBOOL\fR is 1. (The latter is default.) This option is completely disregarded on unsupported devices. ..IP \fB\-c\fR,\ \fB\-\-bod\fR[=\fIBOOL\fR] Disable brownout detection if \fIBOOL\fR is 0. Enable brownout detection if \fIBOOL\fR is 1. (The latter is default.) ..IP \fB\-t\fR,\ \fB\-\-bor\fR[=\fIBOOL\fR] Disable brownout reset if \fIBOOL\fR is 0. Enable brownout reset if \fIBOOL\fR is 1. (The latter is default.) ..IP \fB\-l\fR,\ \fB\-\-lock\fR[=\fIREGION\fR] Lock the flash region \fIREGION\fR. Multiple regions may be specified as a comma\-separated list. All regions will be locked if no \fIREGION\fR is given (default). ..IP \fB\-u\fR,\ \fB\-\-unlock\fR[=\fIREGION\fR] Unlock the flash region \fIREGION\fR. Multiple regions may be specified as a comma\-separated list. All regions will be unlocked if no \fIREGION\fR is given (default). ..IP \fB\-s\fR,\ \fB\-\-security\fR Set the flash security flag. ..IP \fB\-U\fR,\ \fB\-\-force_usb_port\fR[=\fIBOOL\fR] Enable automatic detection of the target's USB port if \fIBOOL\fR is false. Disable USB port autodetection if \fIBOOL\fR is true. (The former is default.) ..IP \fB\-R\fR,\ \fB\-\-reset\fR Reset the CPU after writing \fIFILE\fR to the target. This option is completely disregarded on unsupported devices. ..IP \fB\-i\fR,\ \fB\-\-info\fR Display diagnostic information identifying the target device. ..IP \fB\-d\fR,\ \fB\-\-debug\fR Print verbose diagnostic messages for debug purposes. ..IP \fB\-h\fR,\ \fB\-\-help\fR Display short command line help information. ..SH EXAMPLES \fBbossac\fR \-e \-w \-v \-b image.bin # Erase FLASH, write \fIimage.bin\fR to FLASH, verify the write, and set boot from FLASH ..br \fBbossac\fR \-\-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 \fIttyACM0\fR and reset the CPU after verifying the write ..br \fBbossac\fR \-r0x10000 image.bin # Read 64KB from FLASH on the target device, then write it out to \fIimage.bin\fR on your hard disk ..SH AUTHOR This manual page was written by Karl Lenz <xorangekil...@gmail.com> for the Debian project (but may be used by others). ..SH 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". ..SH "SEE ALSO" ..BR bossa (1), ..BR bossash (1)
--- a/debian/manpages/bossac.1 2014-02-01 01:14:05.000000000 -0500 +++ b/debian/manpages/bossac.1 2014-02-01 01:15:21.000000000 -0500 @@ -1,5 +1,4 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3. -.TH BOSSAC "1" "October 2013" "bossac 1.3" "User Commands" +.TH BOSSAC "1" "February 2014" "bossac 1.3" "User Commands" .SH NAME bossac \- Command line programmer for Atmel SAM ARM microcontrollers .SH SYNOPSIS @@ -52,6 +51,13 @@ \fB\-s\fR, \fB\-\-security\fR set the flash security flag .TP +\fB\-U\fR, \fB\-\-force_usb_port\fR[=\fIBOOL\fR] +perform automatic detection of USB ports if BOOL is false [default]; +override USB port autodetection if BOOL is true +.TP +\fB\-R, \fB\-\-reset\fR +reset the CPU after flashing (on supported CPUs) +.TP \fB\-i\fR, \fB\-\-info\fR display device information .TP
