OpenBLT Bootloader

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== ARM-CM3 STM32 Olimex STM32H103 STM32CubeIDE ======

===== Supported firmware update interfaces =====

^ RS232         ^ CAN            ^ USB         ^ TCP/IP      ^ SD-card      ^ Modbus RTU   ^
| No            | No             | Yes         | No          | No           | No           |

===== Development Environment =====

{{:manual:demos:olimex_stm32h103.png?200 |}}

This demo is targeted towards the [[http://olimex.com/dev/stm32-h103.html|Olimex STM32H103]] board, with 128 kB internal Flash EEPROM and 20 kB internal RAM. 

This header board is a small version of the Olimex STM32P103, however it does not have a UART or CAN connector, but a USB connector. Therefore, the OpenBLT demo for this board features bootloading over USB. Note that this demo is compatible with the STM32P103 board as well.

To program the bootloader into the internal flash on the STM32F103 microcontroller, the [[http://www.st.com/en/development-tools/st-link-v2.html|ST-LINK/V2]] debugger interface was used. However, this is not required if you have another means of programming the internal flash.

To compile the demo programs you can use the [[https://www.st.com/en/development-tools/stm32cubeide.html|STM32CubeIDE]] development environment. Note that STM32CubeIDE is cross-platform. The information outlined on this page applies to both Microsoft Windows and Linux users.

===== Workspace creation in STM32CubeIDE =====

Two demo projects are included in the OpenBLT bootloader package. One for the bootloader itself and one for the demo user program. This user program is configured such that it can be programmed, into the internal flash memory of the microcontroller, during a firmware update with the bootloader.

The first step in getting the the bootloader up-and-running, is the creation of the Eclipse workspace in STM32CubeIDE. After starting STM32CubeIDE, you are prompted to open a workspace. It is easiest to create a new one in the following directory: .\Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\

{{:manual:demos:olimex_stm32h103_cubeide_workspace_creation.png?550|}}

To import the demo programs into the workspace, select //File -> Import// from the program menu. Then select //General -> Existing Projects into Workspace//. On the next screen you select the following directory as the root directory: .\Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\. Eclipse will automatically find the **Boot** and **Prog** projects and select them:

{{:manual:demos:olimex_stm32h103_cubeide_project_import.png?650|}}

Click the //Finish// button to complete the project import operation.

===== Building and programming the Bootloader =====

Before the bootloader can be used, it needs to be built and programmed into the STM32F103RB's internal flash memory. The steps in this section only need to be done once.

  - Set the project as the active project in Eclipse. This is achieved by clicking the **Boot** project in the //Project Explorer// to select it.
  - Next, right-click the **Boot** project in the //Project Explorer// and select //Refresh// from the popup menu.
  - Finally, right-click the **Boot** project in the //Project Explorer// and select //Build Project// from the popup menu to compile all the bootloader sources and link them together into the final executable.

The bootloader program is now ready to be programmed into the internal flash memory of the STM32F103RB microcontroller. Make sure the Olimex STM32-H103 board is connected to your PC via a ST-LINK/V2 debugger interface. Next, select //Run -> Debug// from the menu to flash the bootloader program. This will launch the Debug perspective in Eclipse. Once done, you can start the bootloader program by selecting //Run -> Resume// from the menu.

Alternatively, you can use your favorite programmer to flash the bootloader using one of the following files, depending on what file type your programmer supports:

  * \Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\**Boot**\Debug\**openblt_olimex_stm32h103.elf**
  * \Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\**Boot**\Debug\**openblt_olimex_stm32h103.srec**

===== Building the Demo Program =====

  - Set the project as the active project in Eclipse. This is achieved by clicking the **Prog** project in the //Project Explorer// to select it.
  - Next, right-click the **Prog** project in the //Project Explorer// and select //Refresh// from the popup menu.
  - Finally, right-click the **Prog** project in the //Project Explorer// and select //Build Project// from the popup menu to compile all the user program sources and link them together into the final executable.

The output file is

  * \Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\**Prog**\Debug\**demoprog_olimex_stm32h103.srec**

===== Firmware update procedure =====

To download the demo program \Target\Demo\ARMCM3_STM32F1_Olimex_STM32H103_CubeIDE\**Prog**\Debug\**demoprog_olimex_stm32h103.srec** using the bootloader, follow the instructions in the following links, depending on the communication interface you intend to use:

  * [[manual:usb_demo|Firmware updates using the USB communication interface]]
OpenBLT Bootloader

User Tools

Site Tools

Page Tools
