User Tools

Site Tools


manual:demos:olimex_stm32h103_gcc

This is an old revision of the document!


ARM-CM3 STM32 Olimex STM32H103 GCC

Development Environment

This demo is targeted towards the 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 Olimex ARM-USB-TINY-H JTAG interface was used in combination with OpenOCD 0.4.0. However, this is not required if you have another means of programming the internal flash.

To compile the demo program with Codesourcery G++ Lite (Target OS EABI), you can invoke the make utility from the command line.

Building and programming the Bootloader

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

Batch files are added to aid in building the software program. First clean the bootloader program by double-clicking the file “\Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Boot\cmd\clean.bat”. Next, build the bootloader program by double-clicking the file “\Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Boot\cmd\build.bat”. The output should look like:

+++ Compiling [hooks.o]
+++ Compiling [main.o]
+++ Compiling [boot.o]
...
+++ Linking [openbtl_olimex_stm32h103.elf]
...
+++ Build complete [openbtl_olimex_stm32h103.srec]

The bootloader program is now ready to be programmed into the internal flash memory of the STM32F103. Using your favorite programmer, flash the bootloader using one of the following files, depending on what file type your programmer supports:

  • \Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Boot\bin\openbtl_olimex_stm32h103.elf
  • \Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Boot\bin\openbtl_olimex_stm32h103.srec

USB driver installation

With the bootloader programmed and running on the board, you will be prompted to install the USB driver, after connecting the board to your PC's USB port. The driver installation is described on a seperate page: OpenBLT USB driver installation instructions.

Configuring Microboot

The Microboot utility needs to be configured to use USB as the communication interface:

  • Start Microboot by double-clicking “\Host\MicroBoot.exe”.
  • Click the “Settings”-button and select “OpenBLT using USB” from the dropdown box.

After selecting the USB communication interface, you can close Microboot by clicking the “Cancel”-button on the main screen. Microboot is now ready for action!

Building and downloading the Demo Program

Batch files are added to aid in building the demo program. First clean the demo program by double-clicking the file “\Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Prog\cmd\clean.bat”. Next, build the demo program by double-clicking the file “\Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Prog\cmd\build.bat”. The output should look like:

+++ Compiling [boot.c]
+++ Compiling [main.c]
...
+++ Linking [demoprog_olimex_stm32h103.elf]
...
+++ Build complete [demoprog_olimex_stm32h103.srec]

The output file is

  • \Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Prog\bin\demoprog_olimex_stm32h103.srec

To download this demoprog_olimex_stm32h103.srec file to the remaining flash memory using the bootloader, start the Microboot program and click the “Browse”-button. Browse to the “\Target\Demo\ARMCM3_STM32_Olimex_STM32H103_GCC\Prog\bin\” directory and select the demoprog_olimex_stm32h103.srec file to start the download.

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

Backdoor entry

With USB as the communication interface, it is not practical to automatically support re-entry into the bootloader from a running user program. This is because the USB device in the user program is most likely different from the USB device in the OpenBLT bootloader. Therefore an alternative backdoor entry is pre-configured in the demo which was enabled by setting the following configuration macro in “config.h”:

#define BOOT_BACKDOOR_HOOKS_ENABLE      (1)

Its implementation as such that to reactivate the bootloader you can keep button BUT on the board pressed during reset. Assuming the board is connected to your PC's USB port, you can check that the bootloader is active, by looking in the Window's Device Manager. It should show “WinUSB Bulk Device”. Once active, you can reprogram your program with Microboot as described above.

manual/demos/olimex_stm32h103_gcc.1324118905.txt.gz · Last modified: 2019/09/24 22:13 (external edit)