Incorporate new modular tos-bsl.

[tinyos-2.x.git] / tools / platforms / msp430 / pybsl / tos-bsl.txt

diff --git a/tools/platforms/msp430/pybsl/tos-bsl.txt b/tools/platforms/msp430/pybsl/tos-bsl.txt
index 8f7c5fa4ddd7a49340eec18c82d8dcbe6eb9b9cb..121687b02c14afe80eb46e87feb51225e5c66b59 100644 (file)
--- a/tools/platforms/msp430/pybsl/tos-bsl.txt
+++ b/tools/platforms/msp430/pybsl/tos-bsl.txt
@@ -13,10 +13,16 @@ It is released under a free software license,
 see tos-bsl-license.txt for more details.
 
 (C) 2001-2003 Chris Liechti <cliechti@gmx.net>
+(C) 2007-2010 Sporian Microsystems, Inc. and
+              Titanium Mirror, Inc. <rsmckown@gmail.com>
 
 Features
 --------
 
+- new modular design supports multiple BSL interfacing techniques,
+  currently including standard serial as defined by TI, methods used by the
+  telosa and telosb platforms employing an FTDI usb/serial chip, and a new
+  open technique using the cp2103 usb/serial chip.
 - understands TI-Text and Intel-hex
 - download to Flash and/or RAM, erase, verify
 - reset and wait for keypress (to run a device directly from the port
@@ -67,10 +73,11 @@ First the MSP430 BSL hardware is needed. An example schematics can be found
 in the application note "slaa96b" from TI (see references). Then this
 programm can be used to communicate between the PC and the MSP430 device.
 
-The program can be started by typing "python bsl.py" in a console. Often
-it works also with just "bsl.py" or "./bsl.py".
+The program can be started by typing "python tos-bsl" in a console. Often
+it works also with just "tos-bsl" or "./tos-bsl".
 
-USAGE: bsl.py [options] [file]
+USAGE: %s [options] [file]
+Version: %s
 
 If "-" is specified as file the data is read from the stdinput.
 A file ending with ".txt" is considered to be in TIText format,
@@ -112,19 +119,29 @@ General options:
                         Possible values are 9600, 19200, 38400
                         (default 9600)
   -1, --f1x             Specify CPU family, in case autodetect fails
+  -2, --f2x             Specify CPU family, in case autodetect fails
   -4, --f4x             Specify CPU family, in case autodetect fails
-                        --F1x and --f2x are only needed when the "change
+                        --f1x, --f2x and --f4x are only needed when the "change
                         baudrate" feature is used and the autodetect feature
                         fails. If the device ID that is uploaded is known, it
                         has precedence to the command line option.
-  --invert-reset        Invert signal on RST pin (used for some BSL hardware)
-  --invert-test         Invert signal on TEST/TCK pin (used for some BSL
-                        hardware)
+  --device=device       Required device.  Supported devices are:
+                            standard - Standard BSL programmer per TI specs
+                           telosa - Telos revA and compatible boards
+                           telosb - Telos revB and compatible boards
+                           cp2103 - Boards using cp2103 gpio for BSL support
+                           cp2103_old - The old cp2103 gpio format
+                       Most settings for a device are defined within the
+                       device specific bsl_{device} class.
+  --no-BSL-download     Do not download replacement BSL (disable automatic)
+  --force-BSL-download  Download replacement BSL even if not needed (the one
+                        in the device would have the required features)
   --slow                Add delays when operating the conrol pins. Useful if
                         the pins/circuit has high capacitance.
 
 Program Flow Specifiers:
   -e, --masserase       Mass Erase (clear all flash memory)
+  -M, --mainerase       Erase main flash memory only (requires --password)
   -E, --erasecheck      Erase Check by file
   -p, --program         Program file
   -v, --verify          Verify by file
@@ -143,11 +160,11 @@ Data retreiving:
                         to redirect the output into a file.
 
 Do before exit:
-  -g, --go=address      Start programm execution at specified address.
+  -g, --go=address      Start program execution at specified address.
                         This implies option --wait.
   -r, --reset           Reset connected MSP430. Starts application.
                         This is a normal device reset and will start
-                        the programm that is specified in the reset
+                        the program that is specified in the reset
                         vector. (see also -g)
   -w, --wait            Wait for <ENTER> before closing serial port.
 
@@ -257,6 +274,11 @@ History
         ELF file support
         replacement BSLs are now internal
 
+  V1.6
+       modular design uses --device option to select a communications method
+       support for motes using a cp2103 usb/serial chip
+
+
 References
 ----------
 - Python: http://www.python.org