mbed-os/targets/TARGET_STM
Martin Kojtal 0169915a71
Merge pull request #13998 from MultiTechSystems/mtqn-crash-data-ram
Add crash reporting and autoreboot capability to MTS_DRAGONFLY_L471QG
2020-12-09 11:58:19 +00:00
..
TARGET_STM32F0 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32F1 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32F2 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32F3 Merge pull request #13962 from 0xc0170/cmake-fix-stm-armclang 2020-11-26 13:13:34 +00:00
TARGET_STM32F4 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32F7 Delete objects.h 2020-11-27 09:24:31 +01:00
TARGET_STM32G0 Merge pull request #13906 from jeromecoutant/PR_G070 2020-11-27 12:49:52 +00:00
TARGET_STM32G4 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32H7 STM32H7: system power supply configuration 2020-12-04 10:52:59 +01:00
TARGET_STM32L0 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32L1 STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
TARGET_STM32L4 Merge pull request #13998 from MultiTechSystems/mtqn-crash-data-ram 2020-12-09 11:58:19 +00:00
TARGET_STM32L5 Merge pull request #13929 from JeanMarcR/DEEP_SLEEP 2020-12-03 08:47:01 +00:00
TARGET_STM32WB STM: fix ARMClang sct files, using proper -E command 2020-11-25 13:35:36 +00:00
tools STM32_gen_PeripheralPins.py v1.19 2020-12-01 15:52:20 +01:00
CMakeLists.txt CMake: add STM32F0 targets 2020-11-17 11:43:09 +00:00
PeripheralPins.h add opsi driver 2020-09-16 11:27:23 +08:00
PinNamesTypes.h Move GPIO_AF_NONE from PeripheralPins.h to PinNamesTypes.h 2019-11-28 08:32:10 +01:00
PortNames.h
README.md STM32_gen_PeripheralPins.py v1.19 2020-12-01 15:52:20 +01:00
USBPhyHw.h CMake: remove string.h in STM32 usb, already included (#13773) 2020-11-06 17:25:22 +00:00
USBPhy_STM32.cpp Merge pull request #13780 from JojoS62/PR-fix-H7-USB 2020-11-26 13:19:35 +00:00
analogin_api.c NUCLEO_H743ZI: add initial SDK 2019-01-04 10:03:36 +01:00
analogout_api.c
can_api.c Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
device.h STM: move us_ticker_defines.h include 2020-06-09 11:04:23 +02:00
gpio_api.c STM32H7: enable dual analogic pad 2020-06-05 16:26:22 +02:00
gpio_irq_api.c STM32L5 : update generic STM files for L5 2020-01-23 17:54:55 +01:00
gpio_object.h TARGET_STM: Remove timeout on HSEM. 2019-11-27 14:25:43 +01:00
hal_tick_overrides.c Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
i2c_api.c STM32 I2C: use correct HAL API 2020-11-19 12:03:48 +01:00
lp_ticker.c STM32H7: define RCC_LSE_BYPASS to allow using PC_15 as gpio 2020-10-27 11:24:30 +01:00
mbed_crc_api.c Update HAL CRC API 2019-12-02 14:45:37 +02:00
mbed_overrides.c Merge pull request #14003 from jeromecoutant/PR_H7_PWR 2020-12-09 08:57:43 +00:00
mbed_rtx.h Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
nvic_addr.h Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
ospi_api.c Merge pull request #13932 from LDong-Arm/st_trace_verbosity 2020-11-24 14:12:13 +00:00
pinmap.c STM pin_function(), pin_mode(): return immediately when given pin is NC 2020-02-19 11:46:59 +01:00
port_api.c
pwmout_api.c use descriptive variable names 2020-09-08 10:54:09 +02:00
qspi_api.c Reduce ST QSPI/OSPI trace verbosity to debug 2020-11-19 16:22:12 +00:00
reset_reason.c Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
rtc_api.c STM32H7: define RCC_LSE_BYPASS to allow using PC_15 as gpio 2020-10-27 11:24:30 +01:00
rtc_api_hal.h STM32 RTC : Prescaler calculation issue 2018-10-22 15:58:32 +02:00
serial_api.c STM32 SERIAL: free RTS/CTS pins 2020-11-04 15:47:14 +01:00
serial_api_hal.h TARGET_STM astyle 2018-06-27 14:21:07 +02:00
sleep.c STM32L4+ : SRAM3 is powered off in Stop 2 mode 2020-09-07 09:48:02 +02:00
stm32_assert.h TARGET_STM astyle 2018-06-27 14:21:07 +02:00
stm_spi_api.c STM32 warning remove 2020-04-24 10:57:45 +02:00
trng_api.c STM32WB RNG: enable use from both M4 and M0+ core 2020-07-02 10:17:08 +02:00
us_ticker.c Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00
us_ticker_defines.h STM: Correct macro test in us_ticker_defines.h 2019-07-01 13:34:55 +03:00
watchdog_api.c Add SPDX license identifier to Arm files 2020-10-15 10:47:27 +01:00

README.md

README for Mbed OS STM32 targets

ST TOOLS

USB drivers

Mandatory: get the latest USB driver in order to make available all the USB interfaces provided by the ST-LINK:

  • ST Debug
  • Virtual COM port
  • ST Bridge interfaces

Default Windows USB drivers will not setup full capabilities.

https://www.st.com/en/development-tools/stsw-link009.html

Mandatory: get the latest ST-Link Firmware:

https://www.st.com/en/development-tools/stsw-link007.html

You could have some issue to connect your board if you didn't install full USB drivers.

Note that with the latest FW version, you are able to check the version number easily with a simple "mbedls":

$ mbedls
| platform_name       | platform_name_unique   | mount_point | serial_port | target_id                | interface_version |
|---------------------|------------------------|-------------|-------------|--------------------------|-------------------|
| DISCO_H747I         | DISCO_H747I[0]         | D:          | COM13       | 081402210D03E72132477E08 | V3J7M2            |
| DISCO_L475VG_IOT01A | DISCO_L475VG_IOT01A[0] | E:          | COM9        | 07640221683B630A577FF553 | V2J37M26          |

STM32 Cube

https://www.st.com/en/embedded-software/stm32cube-mcu-packages.html

There is one STM32Cube package for each individual STM32 MCU family.

It includes:

  • The hardware abstraction layer (HAL) enabling portability between different STM32 devices via standardized API calls
  • Low-layer (LL) APIs, a light-weight, optimized, expert oriented set of APIs designed for both performance and runtime efficiency
  • A collection of middleware components including RTOS, USB library, file system, TCP/IP stack, touch-sensing library or graphics library (depending on the STM32 series)
  • BSP drivers, based on HAL drivers.

Part of STM32Cube files are copied in each targets/TARGET_STM/TARGET_STM32<xx>/STM32Cube_FW directory:

  • CMSIS header files in CMSIS sub-directory
  • HAL and LL files in STM32<XX>xx_HAL_Driver sub-directory

Mbed OS HAL calls ST porting layer, which calls ST HAL and LL API.

Note that all ST HAL and LL files are available:

  • you can then develop some applications with direct ST HAL and LL call, even if feature is not supported in Mbed OS
  • BSP for LCD, AUDIO, SENSORS, etc... are not available in Mbed OS, but you should be able to use it in your local application.

Each STM32Cube package is also available in Github. This table summarizes the STM32Cube versions currently used in Mbed OS master branch :

STM32 Serie Cube version Github source
F0 1.9.0 https://github.com/STMicroelectronics/STM32CubeF0
F1 1.8.0 https://github.com/STMicroelectronics/STM32CubeF1
F2 1.6.0 https://github.com/STMicroelectronics/STM32CubeF2
F3 1.9.0 https://github.com/STMicroelectronics/STM32CubeF3
F4 1.25.0 https://github.com/STMicroelectronics/STM32CubeF4
F7 1.16.0 https://github.com/STMicroelectronics/STM32CubeF7
G0 1.3.0 https://github.com/STMicroelectronics/STM32CubeG0
G4 1.1.0 https://github.com/STMicroelectronics/STM32CubeG4
H7 1.8.0 https://github.com/STMicroelectronics/STM32CubeH7
L0 1.11.3 https://github.com/STMicroelectronics/STM32CubeL0
L1 1.8.1 https://github.com/STMicroelectronics/STM32CubeL1
L4 1.16.0 https://github.com/STMicroelectronics/STM32CubeL4
L5 1.3.0 https://github.com/STMicroelectronics/STM32CubeL5
WB 1.8.0 https://github.com/STMicroelectronics/STM32CubeWB

In Mbed OS repository, we try to minimize the difference between "official" and copied files.

STM32CubeMX

STM32CubeMX is a graphical tool that allows a very easy configuration of all STM32

https://www.st.com/en/development-tools/stm32cubemx.html

Tool is not used in Mbed OS, but it can be useful for you.

STM32CubeProgrammer

It provides an easy-to-use and efficient environment for reading, writing and verifying device memory.

https://www.st.com/en/development-tools/stm32cubeprog.html

Tool is not used in Mbed OS, but it can be useful for you.

STM32 families

STM32WB

STM32WB README

STM32H7

STM32H7 README

Custom boards

It should be "easy" to add your custom board with a STM32 MCU in Mbed OS

STM32 organisation

STM32 root directory is https://github.com/ARMmbed/mbed-os/tree/master/targets/TARGET_STM

This contains:

  • all STM32 families directories: F0, F1, F2, F3, F4, F7, G0, H7, L0, L1, L4, WB
  • Mbed OS porting layer common for all

Each STM32 family contains several "sub-families".

Each STM32 Part Number defines a sub-family: STM32F401 / STM32F407 / STM32F429 / ...

But also each STM32 Part Number with different FLASH size : STM32F401xC / STM32F401xE

Mbed OS porting layer specific for this family are placed here.

Example in TARGET_STM32G0:

  • TARGET_STM32G031xx
  • TARGET_STM32G071xx
  • ...

Each STM32 sub-family contains:

  • toolchains files
  • board specific files

Add a custom board

ST provides the complete support for few NUCLEO and DISCO boards.

Locate one of these boards with the minimum difference with your chosen MCU.

Copy paste, and update!

Board specific files (pinmap)

2 files in Mbed OS:

  • PeripheralPins.c
  • PinNames.h

It is recommended to use a python script to generate those files

https://github.com/ARMmbed/mbed-os/blob/master/targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py

This script is using MCU database from https://github.com/STMicroelectronics/STM32_open_pin_data.git repo

$ python targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py -h

SScript version 1.19

Checking STM32_open_pin_data repo...
*** git clone done

usage: STM32_gen_PeripheralPins.py [-h] (-l | -b | -m xml | -t HW | -c CUSTOM)
                                   [-g]

Script will generate PeripheralPins.c thanks to the xml files description available in STM32_open_pin_data GitHub repo

More information in targets/TARGET_STM/README.md

optional arguments:
  -h, --help            show this help message and exit
  -l, --list            list available mcu xml files description in STM32CubeMX
  -b, --boards          list available boards description in STM32CubeMX
  -m xml, --mcu xml     specify the mcu xml file description in STM32CubeMX to use (use double quotes).
                           Parameter can be a filter like L496 if you want to parse all L496 chips (-m STM32 to parse all).
  -t HW, --target HW    specify the board file description in STM32CubeMX to use (use double quotes).
                           Parameter can be a filter like L496 (only the first file found will be parsed).
  -c CUSTOM, --custom CUSTOM
                        specify a custom board .ioc file description to use (use double quotes).
  -g, --gpio            Add GPIO PinMap table

Once generated, you have to check and comment pins that can not be used (specific HW, internal ADC channels, remove PWM using us ticker timer, ...)

How to generate files for a custom boards based on a STM32F427 MCU:

$ python targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py -l | grep F427
STM32F427A(G-I)Hx.xml
STM32F427I(G-I)Hx.xml
STM32F427I(G-I)Tx.xml
STM32F427V(G-I)Tx.xml
STM32F427Z(G-I)Tx.xml

$ python targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py -m "STM32F427V(G-I)Tx.xml"

Script version 1.19

Checking STM32_open_pin_data repo...
        Already up to date.

STM32_open_pin_data DB version STM32CubeMX-DB.6.0.10

 * Output directory: targets_custom\TARGET_STM\TARGET_STM32F4\TARGET_STM32F427xG\TARGET_STM32F427VGT
 * Generating PeripheralPins.c and PinNames.h with 'STM32_open_pin_data\mcu\STM32F427V(G-I)Tx.xml'
 * GPIO file: STM32_open_pin_data\mcu\IP\GPIO-STM32F427_gpio_v1_0_Modes.xml
 * I/O pins found: 135 connected: 0

 * Output directory: targets_custom\TARGET_STM\TARGET_STM32F4\TARGET_STM32F427xI\TARGET_STM32F427VIT
 * Generating PeripheralPins.c and PinNames.h with 'STM32_open_pin_data\mcu\STM32F427V(G-I)Tx.xml'
 * GPIO file: STM32_open_pin_data\mcu\IP\GPIO-STM32F427_gpio_v1_0_Modes.xml
 * I/O pins found: 135 connected: 0

Use of custom_targets.json

https://os.mbed.com/docs/mbed-os/v6.0/porting/porting-a-custom-board.html

Example with a board based on STM32F103C8 (like BluePill):

  • MCU_STM32F103x8 generic configuration is already available in targets.json file
$ python targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py -m "STM32F103C(8-B)Tx.xml"
// PeripheralPins.c and PinNames.h template files are created in targets_custom/TARGET_STM/TARGET_STM32F1/TARGET_STM32F103x8/TARGET_STM32F103C8T directory

$ mv TARGET_STM32F103C8T TARGET_BLUEPILL_F103C8
// Edit PeripheralPins.c and PinNames.h to match your board configuration

// Create a custom_targets.json with:
{
    "BLUEPILL_F103C8": {
        "inherits": [
            "MCU_STM32F103x8"
        ],
        "overrides": {
            "clock_source": "USE_PLL_HSE_XTAL"
        },
        "device_has_remove": [
            "STDIO_MESSAGES"
        ],
        "device_name": "STM32F103C8"
    }
}

Example with a board based on STM32H745ZI

  • this is dual core MCU with CM4 and CM7
  • MCU_STM32H745I_CM4 and MCU_STM32H745I_CM7 generic configuration is already available in targets.json file
$ python targets/TARGET_STM/tools/STM32_gen_PeripheralPins.py -m "STM32H745ZITx.xml"
// PeripheralPins.c and PinNames.h template files are created in targets_custom/TARGET_STM/TARGET_STM32H7/TARGET_STM32H745xI/TARGET_STM32H745ZIT directory

$ mv TARGET_STM32H745ZIT TARGET_H745ZI_BOARD
// Edit PeripheralPins.c and PinNames.h to match your board configuration

// Create a custom_targets.json with:
{
    "H745ZI_BOARD_CM4": {
        "inherits": [
            "MCU_STM32H745I_CM4"
        ],
        "extra_labels_add": [
            "H745ZI_BOARD"
        ]
    },
    "H745ZI_BOARD_CM7": {
        "inherits": [
            "MCU_STM32H745I_CM7"
        ],
        "extra_labels_add": [
            "H745ZI_BOARD"
        ]
    }
}

ST specific implementation

Pin configuration

It can be useful to have a look on files that describes pin configuration for your board:

  • targets/TARGET_STM/TARGET_STM32XX/TARGET_STM32XXXXX/TARGET_XXXXX/PeripheralPins.c
  • targets/TARGET_STM/TARGET_STM32XX/TARGET_STM32XXXXX/TARGET_XXXXX/PinNames.h

Alternate feature

You can easily see the alternate functions for each pin.

Ex:

    {PC_10,      UART_3,  STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART3)},
    {PC_10_ALT0, UART_4,  STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF5_UART4)},
  • If your application is using PC_10 pin for UART, drivers will configure UART3 instance.
  • If your application is using PC_10_ALT0 pin for UART, drivers will configure UART4 instance.

The same alternate choice feature is also used for PWM, ADC, SPI, etc...

Conflict pins

Sometimes there are some conflicts in pin use.

Ex:

    {PA_5,       SPI_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_NOPULL, GPIO_AF5_SPI1)}, // Connected to LD2 [green led]

==> You can use PA_5 pin as SPI, only if your application is not using LED...

Sometimes, pin is explicitly removed by default to avoid issues (but you can uncomment the line for your custom board)

//  {PB_4,       UART_2,  STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)}, // Connected to same instance as STDIO 

WiFi configuration

https://github.com/ARMmbed/wifi-ism43362

https://os.mbed.com/teams/ST/wiki/How-to-make-wifi-tests

Ethernet configuration

Depending on your PHY, you will have to customize several configuration values:

  • the number of RX buffers
  • the number of TX buffers
  • thread size
  • PHY address
  • media interface
  • AutoNegotiation mode
  • DuplexMode mode
  • Speed mode
  • PHY register Offset
  • Speed mask information in the PHY status register
  • Duplex mask information in the PHY status register

Check the default values in: https://github.com/ARMmbed/mbed-os/blob/master/connectivity/drivers/emac/TARGET_STM/mbed_lib.json

Option is also to define your own HAL_ETH_MspInit function, you then have to add USE_USER_DEFINED_HAL_ETH_MSPINIT macro.

Mbed OS Wiki pages

https://os.mbed.com/teams/ST/wiki/

https://os.mbed.com/teams/ST/wiki/STDIO

https://os.mbed.com/teams/ST/wiki/How-to-enable-flash-dual-bank

https://os.mbed.com/teams/ST/wiki/Nucleo-144pins-ethernet-spi-conflict