Arduino core support for STM32 based boards

• Introduction
  
• Getting Started
  
• Supported boards
  
• Troubleshooting
  
• Documentation
  
• API reference (Doxygen)

Introduction

This repo adds the support of STM32 MCU in Arduino IDE 2.x.

This porting is based on:

• STM32Cube MCU Packages including:
  • The HAL hardware abstraction layer, enabling portability between different STM32 devices via standardized API calls
  • The Low-Layer (LL) APIs, a light-weight, optimized, expert oriented set of APIs designed for both performance and runtime efficiency
  • CMSIS device definition for STM32
• CMSIS: Cortex Microcontroller Software Interface Standard (CMSIS) is a vendor-independent hardware abstraction layer for the Cortex®-M processor series and defines generic tool interfaces. It has been packaged as a module for Arduino IDE: https://github.com/stm32duino/ArduinoModule-CMSIS
• GNU Arm Embedded Toolchain: Arm Embedded GCC compiler, libraries and other GNU tools necessary for bare-metal software development on devices based on the Arm Cortex-M. Packages are provided thanks The xPack 3rd Party Development Tools:
  • https://github.com/xpack-dev-tools/arm-none-eabi-gcc-xpack
  • https://github.com/xpack-dev-tools/openocd-xpack

Getting Started

This repo is available as a package usable with Arduino Boards Manager.

Add this link in the "Additional Boards Managers URLs" field:

https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json

[!WARNING] Since core release 2.8.0, only Arduino IDE 2 is supported.

For full instructions on using the "Boards Manager", see Getting Started.

Advanced users can use the repository to benefit from the latest development. See Using git repository.

To build sketches with CMake, see the STM32duino CMake build documentation.

Users can add an STM32-based board by following Add a board variant.

Supported boards

See the supported boards list.

Next release

See milestones to have an overview of the next release content.

Troubleshooting

For question, support, ..., you could submit a topic on the stm32duino forum.

If you have any issue, you could file an issue on GitHub.

In any case, it always fine to search if your issue was not already existing before submit a new one.