/stm32h5-classic-coremw-apps

Provide a set of applications for STM32H5xx series based on the STM32 Classic Core Middleware libraries.

Primary LanguageCOtherNOASSERTION

STM32H5 Classic Core Middleware (CoreMW) MCU Firmware Package

latest tag

usb_device usb_host fatfs lwip

Description

STM32Cube is an STMicroelectronics original initiative to ease developers' life by reducing efforts, time and cost.

Classic CoreMW is a collection of middleware stacks and associated applications allowing RTOS management, File System operations and connectivity through USB and Ethernet. It is based on:

  • ST's proprietary stacks: ST USB Device and ST USB Host
  • Third parties' stacks: FreeRTOS, FatFS, and LwIP

Note

  • FreeRTOS Middleware and examples are delivered on STM32H5 in the form of X-CUBE-FREERTOS that is available from st.com, from GitHub and from STM32CubeMX.

This package is exclusively published on GitHub (and is neither available in STM32CubeMX nor STM32CubeIDE available on www.st.com). It contains the integration of the Classic CoreMW stacks with STM32H5 devices, allowing users to get quick access to pre-built projects integrating them.

Note

  • The repository containing this package has been created using the git submodule command. Please refer to the "How to use" section explaining how to clone this repository and how to get the latest updates.

List of applications

The STM32H5 Classic CoreMW package contains the following applications:

Middleware Application Short Description
FatFs FatFs_RAMDISK_Standalone Shows how to use STM32Cube firmware with FatFs middleware component as a generic FAT file system module
ST USB Device HID_Standalone Shows a typical application where the STM32 MCU is enumerated as a HID device
ST USB Host HID_Standalone Shows how to use USB host application based on the Human Interface Class (HID) to connect a mouse or a keyboard
LwIP LwIP_TCP_Echo_Server This application guides STM32Cube HAL API users to run TCP Echo Server application based on Raw API of LwIP TCP/IP stack
LwIP LwIP_UDP_Echo_Server This application guides STM32Cube HAL API users to run UDP Echo Server application based on Raw API of LwIP TCP/IP stack

Note

  • All examples are provided only with pre-configured projects for EWARM toolchain.
  • Projects in this package have not been generated with STM32CubeMX (i.e., no .ioc files are delivered).

Boards available

Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain 9.20.1 + ST-LINKV3.Patch available here
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37 + ST-LINKV3.Patch available here
  • STM32CubeIDE V1.12.0 + ST-LINKV3

Dependencies

This package has been developed and tested using the list of components detailed in the table below.

Name Version
Cortex-M CMSIS V5.6.0_cm33
STM32H5xx CMSIS V1.0.0
STM32H5xx HAL V1.0.0
BSP STM32H5xx NUCLEO V1.0.0
BSP Common V7.2.1
BSP lan8742 V1.0.2
FatFS r0.12c
LwIP V2.1.2 (ST_Tag 15-March-2019)
STM32 USB Device Library V2.11.1
STM32 USB Host Library V3.5.0
STM32 USBPD Core Library V4.1.1
STM32 USBPD Device Library H5_V1.1.1

How to use

This repository intrinsically contains the applications (projects and source files) located under folder ./Projects. It also contains the CMSIS Core files under folder ./Drivers/CMSIS/Include for size optimization reason. Other dependencies such as the HAL and BSP drivers, or the middleware libraries themselves are linked using the git submodule command. Please check the instructions below for a proper use.


Note

  • USB-PD library is momentarily contained in this repository pending its publication on GitHub. Once published, it will be added as a submodule like the other components.

  • To clone this repository along with the linked submodules, option --recursive has to be specified as shown below.
git clone --recursive https://github.com/STMicroelectronics/stm32h5-classic-coremw-apps
  • To get the latest updates, issue the following two commands (with the repository stm32h5-classic-coremw-apps as the current working directory).
git pull
git submodule update --init --recursive

Note

  • If GitHub "Download ZIP" option is used instead of the git clone command, then the required components have to be collected manually by the user.

Known Limitations

  • None

Troubleshooting

Please refer to the CONTRIBUTING.md guide.