====== Firmware updates using the CAN communication interface ======

===== Bootloader configuration =====

In order to perform firmware updates with the OpenBLT through the CAN communication interface, double-check that this communication interface is configured in "blt_conf.h". The following macro should have a value of 1. If this macro did not yet have a value of 1, the bootloader should be rebuild after making the change.

<code>
#define BOOT_COM_CAN_ENABLE            (1)
</code>

===== Using MicroBoot =====

The MicroBoot utility needs to be configured to connect to the correct CAN interface on the PC:

  * Start MicroBoot by double-clicking "\Host\**MicroBoot.exe**" (on Linux it is "\Host\**MicroBoot**").
  * Click the "**Settings**"-button and select "**XCP on CAN**" from the "Interface selection" dropdown box
  * Select the CAN communication device that your PC uses to connect to the CAN bus.
  * Select the channel you intend to use on the CAN communication device, if applicable.
  * Set the baudrate to the value specified by macro BOOT_COM_CAN_BAUDRATE in "blt_conf.h". Typically, this is **500** kbits/sec for the demo programs.
  * Set the Transmit ID as a hexadecimal value. This is the value specified by macro BOOT_COM_CAN_RX_MSG_ID in "blt_conf.h".
  * Set the Receive ID as a hexadecimal value. This is the value specified by macro BOOT_COM_CAN_TX_MSG_ID in "blt_conf.h".
  * If the Transmit/Receive ID's are 29-bit instead of the default 11-bit, make sure to check the "29-bit extended CAN identifiers"-checkbox.

Once you saved the settings by clicking the "**OK**"-button, MicroBoot is now ready for action!

After building your user program, its S-record formatted firmware file can be downloaded to the remaining flash memory using the bootloader. In **MicroBoot** click the "**Browse**"-button and select your user program's firmware file. For the demo programs, this one is located in the ".\**Prog**\bin\" directory. Once the firmware file was selected, the download should automatically start. 

{{:manual:olimex_stm32p405_download_can.png?|}}

Once the download completed, the newly programmed software will be started by the bootloader. For the demo program's you can verify this by checking that the LED blinks. Congratulations! That's all there is to using the bootloader.

===== Using BootCommander =====

The BootCommander command line interface (CLI) program allows you to configure all communication settings via options on the command line. The following example demonstrates how to call BootCommander for making a firmware update with one of the demo programs. Just correct the “**-d**” option to select the CAN communication device that your PC uses to connect to the CAN bus. 

On Windows, the name of the CAN device depends on those that are supported by BootCommander and [[manual:libopenblt|LibOpenBLT]]. Refer to the [[manual:bootcommander#program_usage|BootCommander user manual]] for a list of supported CAN devices. On Linux, specify the SocketCAN device on your system, for example **can0** or **slcan0**. You can use the "ip addr" command to find out the name of the SocketCAN devices on your system. It is assumed that the SocketCAN device is already configured and online (this also means that the "-b" baudrate command line option is don't care when using Linux).

<code>
BootCommander -s=xcp -t=xcp_can -d=peak_pcanusb -b=500000 -c=0 -tid=667 -rid=7e1 -xid=0 demoprog_olimex_stm32p405.srec
</code>

The example assumes that the S-record of the demo user program is located in the same directory as where the BootCommander executable itself resides. If not, then simply prepend the absolute (or relative) directory to the name of the S-record firmware file.


===== Notes =====

Depending on the configuration of the bootloader, there might be a delay between a system reset and the actual start of the user program. This is needed by design for the bootloader's backdoor functionality. Check configurable BOOT_BACKDOOR_ENTRY_TIMEOUT_MS in "blt_conf.h" for the exact delay time.

==== Lawicel ====

Starting with OpenBLT version 1.14, the included Windows binaries (MicroBoot, BootCommander and LibOpenBLT) are 64-bit. For this reason you should download and install the [[http://www.can232.com/download/canusb_setup_win64_v_2_2.zip|64-bit driver for the CANUSB DLL API]]. 

Note though that the installer has a problem: it might not properly install the actuall **canusbdrv64.dll** file. To fix this problem, you can [[http://www.canusb.com/download/canusbdrv64.zip|download this DLL]] separately and manually copy it to the **C:\Program Files\LAWICEL\CANUSB\libs** directory.

When using an OpenBLT version from before 1.14, the included Windows binaries are still 32-bit. In this case, you should download and install the [[http://www.can232.com/download/canusb_setup_win32_v_2_2.zip|32-bit driver for the CANUSB DLL API]].

==== Peak Systems ====

When using the Peak Systems PCAN-USB interface, the [[https://www.peak-system.com/PCAN-Basic.239.0.html?L=1|PCAN-Basic API]] should be installed. Refer to the included Readme.txt of the PCAN-Basic API for instructions on how to install the PCANBasic.dll onto your Windows system.