====== ARM-CM3 STM32 Nucleo-L152RE Keil MDK ======

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

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

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

{{:manual:demos:stm32_nucleo_l152re.png? |}}

This demo is targeted towards the [[https://www.st.com/en/evaluation-tools/nucleo-l152re.html|Nucleo-L152RE]] board, with 512 kB internal Flash EEPROM and 80 kB internal RAM.

To compile the demo programs you can use the [[http://www.keil.com/|Keil MDK]] development environment. 

To program the bootloader into the internal flash, the on-board ST-Link debugger interface was used. Firmware updates via the serial communication port are preconfigured to use the virtual COM-port offered by the ST-Link. This means that no additional hardware is needed, besides a standard micro-USB cable.

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

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

When using Keil MDK, simply open the project from within uVision. The project file (stm32l152.uvprojx) is located at: \Target\Demo\ARMCM3_STM32L1_Nucleo_L152RE_Keil\**Boot**\ide\. Once opened, select Project->Rebuild all target files from the menu to compile all the bootloader sources and link the together into the final executable.

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

  * \Target\Demo\ARMCM3_STM32L1_Nucleo_L152RE_Keil\**Boot**\bin\**openblt_stm32l152.axf**
  * \Target\Demo\ARMCM3_STM32L1_Nucleo_L152RE_Keil\**Boot**\bin\**openblt_stm32l152.srec**


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

When using Keil MDK, simply open the project from within uVision. The project file (stm32l152.uvprojx) is located at: \Target\Demo\ARMCM3_STM32L1_Nucleo_L152RE_Keil\**Prog**\ide\. Once opened, select Project->Rebuild all target files from the menu to compile all the demo program sources and link the together into the final executable.

The output file is

  * \Target\Demo\ARMCM3_STM32L1_Nucleo_L152RE_Keil\**Prog**\bin\**demoprog_stm32l152.srec**


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

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

  * [[manual:rs232_demo|Firmware updates using the RS232 communication interface]]

===== Notes =====
  * For the bootloader's flash driver to work properly, the functions inside //stm32l1xx_hal_flash_ramfunc.c// need to be copied to RAM by the C startup routine, such that they run from RAM. You achieve this by adding the following line to the RAM section in the scatter file:
<code>
stm32l1xx_hal_flash_ramfunc.o (+RO)
</code> 

{{:manual:demos:nucleo_l152re_keil_ram_func.png?|}}