Navigation
External Links
Donate
Show your appreciation for OpenBLT
and support future development by
donating.
External Links
Donate
Show your appreciation for OpenBLT
and support future development by
donating.
This is an old revision of the document!
BootCommander is a command line interface (CLI) program for performing firmware updates on a microcontroller that runs the OpenBLT bootloader. It provides a firmware update tool for those that prefer a command line interface program over one with a graphical user interface, such as Microboot.
BootCommander was written in the C programming language (C99) and developed with cross-platform support in mind. It has been successfully tested on a Windows PC, Linux PC and even on embedded Linux systems such as a Raspberry Pi and a Beagle Board.
Under the hood, BootCommander relies on the OpenBLT host library (LibOpenBLT) for handling the actual communication with the bootloader. Thanks to the open source nature of the OpenBLT project, full source code is available for the BootCommander program. This makes it a great reference and starting point for those that would like to develop their own firmware update tool. For details on its implementation, refer to the compiled HTML help reference manual that is located at: .\Doc\RM_BootCommander.chm.
When calling the BootCommander program from the terminal, it expects a few options followed by a firmware file. The currently supported firmware file format is S-records: BootCommander [options] [firmware file].
The options the make it possible to select and configure the communication protocol and transport layer to use:
Additional XCP version 1.0 communication protocol settings (xcp):
Additional XCP on RS232 settings (xcp_rs232):
Note that is it not necessary to specify an option if its default value is already the desired value. This means that the following two examples behave exactly the same:
BootCommander -d=COM4 demoprog.srec
and
BootCommander -s=xcp -t=xcp_rs232 -d=COM4 -b=57600 -t1=1000 -t3=2000 -t4=10000 -t5=1000 -t7=2000 demoprog.srec