Arduino core support for STM32 based boards

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 the Getting Started page.

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

User can add a STM32 based board following this wiki.

Supported boards

Nucleo 144 boards
Nucleo 64 boards
Nucleo 32 boards
Discovery boards
Eval boards
STM32MP1 series coprocessor boards
Generic STM32C0 boards
Generic STM32F0 boards
Generic STM32F1 boards
Generic STM32F2 boards
Generic STM32F3 boards
Generic STM32F4 boards
Generic STM32F7 boards
Generic STM32G0 boards
Generic STM32G4 boards
Generic STM32H5 boards
Generic STM32H7 boards
Generic STM32L0 boards
Generic STM32L1 boards
Generic STM32L4 boards
Generic STM32L5 boards
Generic STM32U0 boards
Generic STM32U5 boards
Generic STM32WB boards
Generic STM32WBA boards
Generic STM32WL boards
3D printer boards
Blues boards
Elecgator boards
Electronic Speed Controller boards
Garatronic/McHobby boards
Generic flight controllers
IoT continuum boards
LoRa boards
Midatronics boards
SparkFun boards
ELV Boards
STeaMi board

Note

💚 board support is available since the specified release version.
💛 board support is available in the main branch and will be available in the specified release version.

Nucleo 144 boards

Status	Device(s)	Name	Release	Notes
💚	STM32F207ZG	Nucleo F207ZG	0.2.0
💚	STM32F412ZG	Nucleo F412ZG	2.6.0
💚	STM32F413ZH	Nucleo F413ZH	2.4.0
💚	STM32F429ZI	Nucleo F429ZI	0.1.0
💚	STM32F439ZI	Nucleo F439ZI	2.8.0
💚	STM32F446ZE	Nucleo F446ZE	2.7.0
💚	STM32F722ZE	Nucleo F722ZE	2.4.0
💚	STM32F767ZI	Nucleo F767ZI	1.4.0
💚	STM32F746ZG	Nucleo F746ZG	1.9.0
💚	STM32F756ZG	Nucleo F756ZG	1.9.0
💚	STM32H563ZI	Nucleo H563ZI	2.6.0
💚	STM32H723ZG	Nucleo H723ZG	2.4.0
💚	STM32H743ZI	Nucleo H743ZI(2)	1.5.0	Nucleo H743ZI2 since 1.6.0
💚	STM32H753ZI	Nucleo H753ZI	2.7.0
💚	STM32L496ZG	Nucleo L496ZG	1.3.0
💚	STM32L496ZG-P	Nucleo L496ZG-P	1.3.0
💚	STM32L4R5ZI	Nucleo L4R5ZI	1.4.0
💚	STM32L4R5ZI-P	Nucleo L4R5ZI-P	1.4.0
💚	STM32L552ZE-Q	Nucleo L552ZE-Q	2.0.0
💚	STM32U575ZI-Q	NUCLEO-U575ZI-Q	2.1.0

Nucleo 64 boards

Status	Device(s)	Name	Release	Notes
💚	STM32C031C6	Nucleo C031C6	2.5.0
💚	STM32C071RB	Nucleo C071RB	2.9.0
💚	STM32F030R8	Nucleo F030R8	0.2.0
💚	STM32F070RB	Nucleo F070RB	2.0.0
💚	STM32F072RB	Nucleo F072RB	1.9.0
💚	STM32F091RC	Nucleo F091RC	0.1.0
💚	STM32F103RB	Nucleo F103RB	0.2.0
💚	STM32F302R8	Nucleo F302R8	1.1.0
💚	STM32F303RE	Nucleo F303RE	0.1.0
💚	STM32F401RE	Nucleo F401RE	0.2.1
💚	STM32F411RE	Nucleo F411RE	0.2.1
💚	STM32F446RE	Nucleo F446RE	1.1.1
💚	STM32G070RB	Nucleo G070RB	2.3.0
💚	STM32G071RB	Nucleo G071RB	1.6.0
💚	STM32G0B1RE	Nucleo G0B1RE	2.1.0
💚	STM32G431RB	Nucleo G431RB	1.7.0
💚	STM32G474RE	Nucleo G474RE	1.7.0
💚	STM32H503RB	Nucleo H503RB	2.7.0
💚	STM32L010RB	Nucleo L010RB	2.1.0
💚	STM32L053R8	Nucleo L053R8	0.1.0
💚	STM32L073RZ	Nucleo L073RZ	1.4.0
💚	STM32L152RE	Nucleo L152RE	1.0.0
💚	STM32L433RC-P	Nucleo L433RC-P	1.9.0
💚	STM32L452RE	Nucleo L452RE	1.5.0
💚	STM32L452RE-P	Nucleo L452RE-P	1.8.0
💚	STM32L476RG	Nucleo L476RG	0.1.0
💚	STM32U083RC	Nucleo U083RC	2.9.0
💚	STM32WB15CCU	Nucleo-WB15CC	2.5.0
💚	STM32WBA55CGU	Nucleo-WBA55CG	2.8.0
💚	STM32WB55RG	P-Nucleo-WB55RG	1.6.0	BLE support with STM32duinoBLE
💚	STM32WB55CG	P-Nucleo-WB55 USB Dongle	2.5.0	BLE support with STM32duinoBLE
💚	STM32WL55JC	Nucleo WL55JC1	2.1.0	LoRa support not available

Nucleo 32 boards

Status	Device(s)	Name	Release
💚	STM32F031K6T	Nucleo F031K6	1.9.0
💚	STM32F042K6T	Nucleo F042K6	2.1.0
💚	STM32F303K8	Nucleo F303K8	1.1.0
💚	STM32G031K8	Nucleo G031K8	2.0.0
💚	STM32G431KB	Nucleo G431KB	1.7.0
💚	STM32L031K6	Nucleo L031K6	1.1.1
💚	STM32L412KB	Nucleo L412KB	1.5.0
💚	STM32L432KC	Nucleo L432KC	0.2.0

Discovery boards

Status	Device(s)	Name	Release
💚	STM32C011F6	STM32C0116-DK	2.6.0
💚	STM32C031C6	STM32C0316-DK	2.5.0
💚	STM32F030R8	32F0308DISCOVERY	1.3.0
💚	STM32F072RB	32F072BDISCOVERY	1.5.0
💚	STM32F100RB	STM32VLDISCOVERY	0.2.1
💚	STM32F303VC	STM32F3DISCOVERY	2.0.0
💚	STM32F407VG	STM32F407G-DISC1	0.1.0
💚	STM32F413ZH	32F413HDISCOVERY	1.9.0
💚	STM32F746NG	STM32F746G-DISCOVERY	0.1.0
💚	STM32G031J6	STM32G0316-DISCO	1.9.0
💚	STM32G431CB	B-G431B-ESC1	2.0.0
💚	STM32H573IIKxQ	STM32H573I-DK	2.6.0
💚	STM32H747XIHx	STM32H747I-DISCO	2.7.0
💚	STM32L4S5VI	B-L4S5I-IOT01A	2.0.0
💚	STM32U585AIIxQ	B-U585I-IOT02A	2.1.0
💚	STM32WB5MMG	STM32WB5MM-DK	2.1.0

Eval boards

Status	Device(s)	Name	Release	Notes
💚	STM32L4R9ZI	STEVAL-MKSBOX1V1 (SensorTile.box)	1.7.0
💚	STM32U585AIIxQ	STEVAL-MKBOXPRO (SensorTile.box Pro)	2.6.0

STM32MP1 series coprocessor boards

Status	Device(s)	Name	Release	Notes
💚	STM32MP157A	STM32MP157A-DK1	1.8.0	See the documentation to use this board
💚	STM32MP157C	STM32MP157C-DK2	1.8.0	See the documentation to use this board

Generic STM32C0 boards

Status	Device(s)	Name	Release
💚	STM32C011D6	Generic Board	2.6.0
💚	STM32C011F4 STM32C011F6	Generic Board	2.6.0
💚	STM32C011J4 STM32C011J6	Generic Board	2.8.0
💚	STM32C031C4 STM32C031C6	Generic Board	2.5.0
💚	STM32C031F4 STM32C031F6	Generic Board	2.6.0
💚	STM32C071R8 STM32C071RB	Generic Board	2.9.0

Generic STM32F0 boards

Status	Device(s)	Name	Release
💚	STM32F030C6	Generic Board	2.4.0
💚	STM32F030F4	STM32F030F4 Demo board	1.5.0
💚	STM32F030K6	Generic Board	2.4.0
💚	STM32F030C8	Generic Board	2.0.0
💚	STM32F030F4	Generic Board	2.0.0
💚	STM32F030R8	Generic Board	2.0.0
💚	STM32F031C4 STM32F031C6	Generic Board	2.4.0
💚	STM32F031E6 STM32F038E6	Generic Board	2.4.0
💚	STM32F031F4 STM32F031F6	Generic Board	2.4.0
💚	STM32F031G4 STM32F031G6	Generic Board	2.4.0
💚	STM32F031K4 STM32F031K6	Generic Board	2.4.0
💚	STM32F031K6T	Generic Board	2.0.0
💚	STM32F038C6	Generic Board	2.4.0
💚	STM32F038F6	Generic Board	2.4.0
💚	STM32F038G6	Generic Board	2.4.0
💚	STM32F038K6	Generic Board	2.4.0
💚	STM32F042C4 STM32F042C6	Generic Board	2.0.0
💚	STM32F042F4 STM32F042F6	Generic Board	2.4.0
💚	STM32F042G4 STM32F042G6	Generic Board	2.4.0
💚	STM32F042K4T STM32F042K6T	Generic Board	2.0.1
💚	STM32F042T6	Generic Board	2.4.0
💚	STM32F048G6	Generic Board	2.4.0
💚	STM32F048T6	Generic Board	2.4.0
💚	STM32F051C4	Generic Board	2.4.0
💚	STM32F051K4	Generic Board	2.4.0
💚	STM32F051K6U STM32F051K8U	Generic Board	2.0.0
💚	STM32F051R4	Generic Board	2.4.0
💚	STM32F051T8	Generic Board	2.4.0
💚	STM32F058C8	Generic Board	2.4.0
💚	STM32F058R8	Generic Board	2.4.0
💚	STM32F058T8	Generic Board	2.4.0
💚	STM32F070CB	Generic Board	2.0.0
💚	STM32F070RB	Generic Board	2.0.0
💚	STM32F071C8 STM32F071CB	Generic Board	2.4.0
💚	STM32F071RB	Generic Board	2.4.0
💚	STM32F071V8 STM32F071VB	Generic Board	2.4.0
💚	STM32F072C8 STM32F072CB	Generic Board	2.0.0
💚	STM32F072R8 STM32F072RB	Generic Board	2.0.0
💚	STM32F071C8 STM32F071CB	Generic Board	2.4.0
💚	STM32F072V8 STM32F072VB	Generic Board	2.4.0
💚	STM32F078CB	Generic Board	2.4.0
💚	STM32F078RB	Generic Board	2.4.0
💚	STM32F078VB	Generic Board	2.4.0
💚	STM32F091CB STM32F091CC	Generic Board	2.4.0
💚	STM32F091RB STM32F091RC	Generic Board	2.0.0
💚	STM32F091VB	Generic Board	2.4.0
💚	STM32F091VC	Generic Board	2.4.0
💚	STM32F098CC	Generic Board	2.4.0
💚	STM32F098RC	Generic Board	2.4.0
💚	STM32F098VC	Generic Board	2.4.0

Generic STM32F1 boards

Status	Device(s)	Name	Release	Notes
💚	STM32F100C4 STM32F100C6	Generic Board	2.0.0
💚	STM32F100C8 STM32F100CB	Generic Board	2.0.0
💚	STM32F100R4 STM32F100R6	Generic Board	2.4.0
💚	STM32F100V8 STM32F100VB	Generic Board	2.4.0
💚	STM32F100ZC STM32F100ZD STM32F100ZT	Generic Board	2.4.0
💚	STM32F101C4 STM32F101C6	Generic Board	2.4.0
💚	STM32F101R4 STM32F101R6	Generic Board	2.4.0
💚	STM32F101T4 STM32F101T6	Generic Board	2.4.0
💚	STM32F101V8 STM32F101VB	Generic Board	2.4.0
💚	STM32F101ZC STM32F101ZD STM32F101ZE	Generic Board	2.4.0
💚	STM32F103C6 STM32F103C8 STM32F103CB	Blue Pill	1.2.0	USB CDC support since 1.5.0 Maple bootloaders support since 1.6.0
💚	STM32F103C8 STM32F103CB	Black Pill	1.5.0
💚	STM32F103C4 STM32F103C6 STM32F103C8 STM32F103CB	Generic Board	1.9.0
💚	STM32F103R8 STM32F103RB STM32F103RC STM32F103RE	Blue Button F103Rx	1.9.0
💚	STM32F103R6 STM32F103R8 STM32F103RB STM32F103RC STM32F103RD STM32F103RE STM32F103RF STM32F103RG	Generic Board	1.9.0
💚	STM32F103T4 STM32F103T6 STM32F103T8 STM32F103TB	Generic Board	1.9.0
💚	STM32F103V8 STM32F103VB STM32F103VC STM32F103VD STM32F103VE STM32F103VF STM32F103VG	Generic Board	1.9.0
💚	STM32F103ZC STM32F103ZD STM32F103ZE STM32F103ZF STM32F103ZG	Generic Board	1.9.0
💚	STM32F103TB	HY-TinySTM103T	1.5.0
💚	STM32F103CB	Maple Mini	1.2.0	More info USB CDC support since 1.5.0 Maple bootloaders support since 1.6.0
💚	STM32F103ZE	vcc-gnd.com	1.9.0
💚	STM32F103ZE	vcc-gnd.com Mini	1.9.0

Generic STM32F2 boards

Status	Device(s)	Name	Release
💚	STM32F205RB STM32F205RC STM32F205RE STM32F205RF	Generic Board	2.4.0
💚	STM32F205VB STM32F205VC STM32F205VE STM32F205VF STM32F205VG	Generic Board	2.4.0
💚	STM32F205ZC STM32F205ZE STM32F205ZF STM32F205ZG	Generic Board	2.4.0
💚	STM32F207IC STM32F207IE STM32F207IF STM32F207IG	Generic Board	2.4.0
💚	STM32F207VC STM32F207VE STM32F207VF STM32F207VG	Generic Board	2.4.0
💚	STM32F207ZC STM32F207ZE STM32F207ZF STM32F207ZG	Generic Board	2.0.0
💚	STM32F215RE STM32F215RG	Generic Board	2.4.0
💚	STM32F215VE STM32F215VG	Generic Board	2.4.0
💚	STM32F215ZE STM32F215ZG	Generic Board	2.4.0
💚	STM32F217IE STM32F217IG	Generic Board	2.4.0
💚	STM32F217VE STM32F217VG	Generic Board	2.4.0
💚	STM32F217ZE STM32F217ZG	Generic Board	2.0.0

Generic STM32F3 boards

Status	Device(s)	Name	Release
💚	STM32F301C6 STM32F301C8	Generic Board	2.4.0
💚	STM32F301K6 STM32F301K8	Generic Board	2.4.0
💚	STM32F301R6 STM32F301R8	Generic Board	2.4.0
💚	STM32F302R6 STM32F302R8	Generic Board	2.0.0
💚	STM32F303C6 STM32F303C8	Generic Board	2.4.0
💚	STM32F303CB STM32F303CC	Generic Board	2.0.0
💚	STM32F303CC	RobotDyn Black Pill	1.6.1
💚	STM32F303K6 STM32F303K8	Generic Board	2.0.0
💚	STM32F303R6 STM32F303R8	Generic Board	2.4.0
💚	STM32F303RD STM32F303RE	Generic Board	2.0.0
💚	STM32F303RB STM32F303RC	Generic Board	2.0.0
💚	STM32F303RC	OLIMEXINO-STM32F3	2.0.0
💚	STM32F303VBT STM32F303VCT	Generic Board	2.0.0
💚	STM32F318C8	Generic Board	2.4.0
💚	STM32F318K8	Generic Board	2.4.0
💚	STM32F328C8	Generic Board	2.4.0
💚	STM32F334C4 STM32F334C6 STM32F334C8	Generic Board	2.4.0
💚	STM32F334K4 STM32F334K6 STM32F334K8	Generic Board	2.0.0
💚	STM32F334R6 STM32F334R8	Generic Board	2.4.0
💚	STM32F358CC	Generic Board	2.4.0
💚	STM32F358RC	Generic Board	2.4.0
💚	STM32F358VC	Generic Board	2.4.0
💚	STM32F378CC	Generic Board	2.4.0
💚	STM32F378RC	Generic Board	2.4.0
💚	STM32F378VC	Generic Board	2.4.0
💚	STM32F398VE	Generic Board	2.4.0

Generic STM32F4 boards

Status	Device(s)	Name	Release	Notes
💚	STM32F405RG	Adafruit Feather STM32F405 Express	1.8.0
💚	STM32F401CC	WeAct Black Pill	1.7.0	More info
💚	STM32F401CE	WeAct Black Pill	2.4.0	More info
💚	STM32F411CE	WeAct Black Pill	1.9.0	More info
💚	STM32F407VE STM32F407VG	STM32 F4VE / Black F407VET6	1.4.0	STM32F407VG support since 1.5.0
💚	STM32F407ZE STM32F407ZG	Black F407ZE / Black F407ZG	1.5.0
💚	STM32F407ZG	vcc-gnd.com Mini	2.0.0
💚	STM32F407VE	vcc-gnd.com Mini	1.4.0
💚	STM32F401RC	STM32F Core Board	1.7.0
💚	STM32F407VG	DIYMORE STM32F407VGT	1.5.0
💚	STM32F407VE	FK407M1	1.5.0
💚	STM32F401CB STM32F401CC STM32F401CD STM32F401CE	Generic Board	1.9.0
💚	STM32F401RB STM32F401RC STM32F401RD STM32F401RE	Generic Board	1.8.0
💚	STM32F401VB STM32F401VC STM32F401VD STM32F401VE	Generic Board	2.0.0
💚	STM32F405RG	Generic Board	1.9.0
💚	STM32F407VE STM32F407VG	Generic Board	1.9.0
💚	STM32F407ZE STM32F407ZG	Generic Board	2.0.0
💚	STM32F410C8 STM32F410CB	Generic Board	1.9.0
💚	STM32F410R8 STM32F410RB	Generic Board	1.9.0
💚	STM32F410T8 STM32F410TB	Generic Board	2.4.0
💚	STM32F411CC STM32F411CE	Generic Board	1.9.0
💚	STM32F411RC STM32F411RE	Generic Board	1.9.0
💚	STM32F412CE STM32F412CG	Generic Board	1.9.0
💚	STM32F412RE STM32F412RG	Generic Board	1.9.0
💚	STM32F412ZE STM32F412ZG	Generic Board	2.6.0
💚	STM32F413CG STM32F413CH	Generic Board	1.9.0
💚	STM32F413RG STM32F413RH	Generic Board	1.9.0
💚	STM32F413ZG STM32F413ZH	Generic Board	2.0.0
💚	STM32F415RG	Generic Board	1.9.0
💚	STM32F417VE STM32F417VG	Generic Board	1.9.0
💚	STM32F417ZE STM32F417ZG	Generic Board	2.0.0
💚	STM32F423CH	Generic Board	1.9.0
💚	STM32F423RH	Generic Board	1.9.0
💚	STM32F423ZH	Generic Board	2.0.0
💚	STM32F427ZG STM32F427ZI	Generic Board	2.0.0
💚	STM32F429ZE STM32F429ZG STM32F429ZI	Generic Board	2.0.0
💚	STM32F437ZG STM32F437ZI	Generic Board	2.0.0
💚	STM32F439ZG STM32F439ZI	Generic Board	2.0.0
💚	STM32F446RC STM32F446RE	Generic Board	1.9.0
💚	STM32F446ZC STM32F446ZE	Generic Board	2.7.0
💚	STM32F446VC STM32F446VE	Generic Board	2.0.0
💚	STM32F411CE	ThunderPack v1.1+	1.9.0

Generic STM32F7 boards

Status	Device(s)	Name	Release
💚	STM32F722RC STM32F722RE	Generic Board	2.3.0
💚	STM32F722ZC STM32F722ZE	Generic Board	2.4.0
💚	STM32F723IC STM32F723IE	Generic Board	2.7.0
💚	STM32F730I8K	Generic Board	2.7.0
💚	STM32F730R8	Generic Board	2.3.0
💚	STM32F732RE	Generic Board	2.3.0
💚	STM32F732ZE	Generic Board	2.4.0
💚	STM32F733IE	Generic Board	2.7.0
💚	STM32F745ZE STM32F745ZG	Generic Board	2.0.0
💚	STM32F746BE STM32F746BG STM32F746NE STM32F746NG	Generic Board	2.0.0
💚	STM32F746ZE STM32F746ZG	Generic Board	2.0.0
💚	STM32F750N8	Generic Board	2.0.0
💚	STM32F750Z8	Generic Board	2.0.0
💚	STM32F756BG STM32F756NG	Generic Board	2.0.0
💚	STM32F756ZG	Generic Board	2.0.0
💚	STM32F765IGK STM32F765IIK STM32F765IGT STM32F765IIT	Generic Board	2.3.0
💚	STM32F765VG STM32F765VI	Generic Board	2.0.0
💚	STM32F765ZG STM32F765ZI	Generic Board	2.0.0
💚	STM32F767IGK STM32F767IIK STM32F767IGT STM32F767IIT	Generic Board	2.3.0
💚	STM32F767VG STM32F767VI	Generic Board	2.0.0
💚	STM32F767ZG STM32F767ZI	Generic Board	2.0.0
💚	STM32F777IIK STM32F777IIT	Generic Board	2.3.0
💚	STM32F777VI	Generic Board	2.0.0
💚	STM32F777ZI	Generic Board	2.0.0

Generic STM32G0 boards

Status	Device(s)	Name	Release
💚	STM32G030C6 STM32G030C8	Generic Board	2.2.0
💚	STM32G030F6 STM32G030F6	Generic Board	2.2.0
💚	STM32G030K8	Aurora One	2.0.0
💚	STM32G071CB	AGAFIA SG0	2.3.0
💚	STM32G030J6	Generic Board	2.4.0
💚	STM32G030K6 STM32G030K8	Generic Board	2.0.0
💚	STM32G031C4 STM32G031C6 STM32G031C8	Generic Board	2.4.0
💚	STM32G031F4 STM32G031F6 STM32G031F8	Generic Board	2.3.0
💚	STM32G031G4 STM32G031G6 STM32G031G8	Generic Board	2.4.0
💚	STM32G031J4 STM32G031J6	Generic Board	2.0.0
💚	STM32G031K4 STM32G031K6 STM32G031K8	Generic Board	2.0.0
💚	STM32G031Y8	Generic Board	2.3.0
💚	STM32G041C6 STM32G041C8	Generic Board	2.4.0
💚	STM32G041F6 STM32G041F8	Generic Board	2.3.0
💚	STM32G041G6 STM32G041G8	Generic Board	2.4.0
💚	STM32G041J6	Generic Board	2.0.0
💚	STM32G041K6 STM32G041K8	Generic Board	2.0.0
💚	STM32G041Y8	Generic Board	2.3.0
💚	STM32G050C6 STM32G050C8	Generic Board	2.4.0
💚	STM32G050F6	Generic Board	2.4.0
💚	STM32G050K6 STM32G050K8	Generic Board	2.4.0
💚	STM32G051C6 STM32G051C8	Generic Board	2.4.0
💚	STM32G051F6 STM32G051F8	Generic Board	2.4.0
💚	STM32G051G6 STM32G051G8	Generic Board	2.4.0
💚	STM32G051K6 STM32G051K8	Generic Board	2.4.0
💚	STM32G061C6 STM32G061C8	Generic Board	2.4.0
💚	STM32G061F6 STM32G061F8	Generic Board	2.4.0
💚	STM32G061G6 STM32G061G8	Generic Board	2.4.0
💚	STM32G061K6 STM32G061K8	Generic Board	2.4.0
💚	STM32G070CB	Generic Board	2.3.0
💚	STM32G070KB	Generic Board	2.3.0
💚	STM32G070RB	Generic Board	2.3.0
💚	STM32G071C6 STM32G071C8 STM32G071CB	Generic Board	2.3.0
💚	STM32G071EB	Generic Board	2.4.0
💚	STM32G071G6 STM32G071G8 STM32G071GB	Generic Board	2.4.0
💚	STM32G071G8UxN	Generic Board	2.3.0
💚	STM32G071GBUxN	Generic Board	2.3.0
💚	STM32G071K6 STM32G071K8 STM32G071KB	Generic Board	2.4.0
💚	STM32G071R6 STM32G071R8 STM32G071RB	Generic Board	2.0.0
💚	STM32G081CBT STM32G081CBU	Generic Board	2.3.0
💚	STM32G081EB	Generic Board	2.4.0
💚	STM32G081GB	Generic Board	2.4.0
💚	STM32G081GBUxN	Generic Board	2.3.0
💚	STM32G081KB	Generic Board	2.4.0
💚	STM32G081RB	Generic Board	2.0.0
💚	STM32G0B0CE	Generic Board	2.4.0
💚	STM32G0B0RE	Generic Board	2.4.0
💚	STM32G0B0VE	Generic Board	2.4.0
💚	STM32G0B1CB STM32G0B1CC STM32G0B1CE	Generic Board	2.4.0
💚	STM32G0B1KB STM32G0B1KC STM32G0B1KE	Generic Board	2.4.0
💚	STM32G0B1MB STM32G0B1MC STM32G0B1ME	Generic Board	2.4.0
💚	STM32G0B1NE	Generic Board	2.4.0
💚	STM32G0B1VB STM32G0B1VC STM32G0B1VE	Generic Board	2.4.0
💚	STM32G0B1RB STM32G0B1RC STM32G0B1RE	Generic Board	2.1.0
💚	STM32G0C1CC STM32G0C1CE	Generic Board	2.4.0
💚	STM32G0C1KB STM32G0C1KC STM32G0C1KE	Generic Board	2.4.0
💚	STM32G0C1MC STM32G0C1ME	Generic Board	2.4.0
💚	STM32G0C1NE	Generic Board	2.4.0
💚	STM32G0C1VC STM32G0C1VE	Generic Board	2.4.0
💚	STM32G0C1RB STM32G0C1RE	Generic Board	2.1.0

Generic STM32G4 boards

Status	Device(s)	Name	Release
💚	STM32G431C6 STM32G431C8 STM32G431CB	Generic Board	2.4.0
💚	STM32G431C6U STM32G431C8U STM32G431CBU	Generic Board	2.0.0
💚	STM32G431M6 STM32G431M8 STM32G431MB	Generic Board	2.4.0
💚	STM32G431V6 STM32G431V8 STM32G431VB	Generic Board	2.4.0
💚	STM32G441CB	Generic Board	2.4.0
💚	STM32G441CBU	Generic Board	2.0.0
💚	STM32G441MB	Generic Board	2.4.0
💚	STM32G441VB	Generic Board	2.4.0
💚	STM32G431K6 STM32G431K8 STM32G431KB	Generic Board	2.0.0
💚	STM32G441KB	Generic Board	2.0.0
💚	STM32G431R6 STM32G431R8 STM32G431RB	Generic Board	2.0.0
💚	STM32G441RB	Generic Board	2.0.0
💚	STM32G471CC STM32G471CE	Generic Board	2.4.0
💚	STM32G471MC STM32G471ME	Generic Board	2.4.0
💚	STM32G471QC STM32G471QE	Generic Board	2.4.0
💚	STM32G471RC STM32G471RE	Generic Board	2.4.0
💚	STM32G471VC STM32G471VE	Generic Board	2.4.0
💚	STM32G473CB STM32G473CC STM32G473CE	Generic Board	2.4.0
💚	STM32G473MB STM32G473MC STM32G473ME	Generic Board	2.4.0
💚	STM32G473PB STM32G473PC STM32G473PE	Generic Board	2.4.0
💚	STM32G473QB STM32G473QC STM32G473QE	Generic Board	2.4.0
💚	STM32G473RB STM32G473RC STM32G473RE	Generic Board	2.0.0
💚	STM32G473VB STM32G473VC STM32G473VE	Generic Board	2.4.0
💚	STM32G474CB STM32G474CC STM32G474CE	Generic Board	2.4.0
💚	STM32G474MB STM32G474MC STM32G474ME	Generic Board	2.4.0
💚	STM32G474PB STM32G474PC STM32G474PE	Generic Board	2.4.0
💚	STM32G474QB STM32G474QC STM32G474QE	Generic Board	2.4.0
💚	STM32G474RB STM32G474RC STM32G474RE	Generic Board	2.0.0
💚	STM32G474VB STM32G474VC STM32G474VE	Generic Board	2.4.0
💚	STM32G483CE	Generic Board	2.4.0
💚	STM32G483ME	Generic Board	2.4.0
💚	STM32G483PE	Generic Board	2.4.0
💚	STM32G483QE	Generic Board	2.4.0
💚	STM32G483RE	Generic Board	2.0.0
💚	STM32G483VE	Generic Board	2.4.0
💚	STM32G484CE	Generic Board	2.4.0
💚	STM32G484ME	Generic Board	2.4.0
💚	STM32G484PE	Generic Board	2.4.0
💚	STM32G484QE	Generic Board	2.4.0
💚	STM32G484RE	Generic Board	2.0.0
💚	STM32G484VE	Generic Board	2.4.0
💚	STM32G491CC STM32G491CE	Generic Board	2.4.0
💚	STM32G491KC STM32G491KE	Generic Board	2.4.0
💚	STM32G491MC STM32G491ME	Generic Board	2.4.0
💚	STM32G491RC STM32G491RE	Generic Board	2.3.0
💚	STM32G491VC STM32G491VE	Generic Board	2.4.0
💚	STM32G4A1CE	Generic Board	2.4.0
💚	STM32G4A1KE	Generic Board	2.4.0
💚	STM32G4A1ME	Generic Board	2.4.0
💚	STM32G4A1RE	Generic Board	2.3.0
💚	STM32G4A1VE	Generic Board	2.4.0

Generic STM32H5 boards

Status	Device(s)	Name	Release
💚	STM32H503CB	Generic Board	2.9.0
💚	STM32H503KB	Generic Board	2.8.1
💚	STM32H503RB	Generic Board	2.7.0
💚	STM32H562RGT	WeAct H562RGT	2.9.0
💚	STM32H562RGT STM32H562RIT	Generic Board	2.9.0
💚	STM32H563IIKxQ	Generic Board	2.6.0
💚	STM32H563RG STM32H563RI	Generic Board	2.8.1
💚	STM32H563ZG STM32H563ZI	Generic Board	2.6.0
💚	STM32H573IIKxQ	Generic Board	2.6.0
💚	STM32H573RI	Generic Board	2.8.1
💚	STM32H573ZI	Generic Board	2.6.0

Generic STM32H7 boards

Status	Device(s)	Name	Release	Notes
💚	STM32H723ZE STM32H723ZG	Generic Board	2.4.0
💚	STM32H730ZBT	Generic Board	2.4.0
💚	STM32H733ZGT	Generic Board	2.4.0
💚	STM32H742IG STM32H742II	Generic Board	2.1.0
💚	STM32H742VG STM32H742VI	Generic Board	2.0.0
💚	STM32H742XG STM32H742XI	Generic Board	2.7.0
💚	STM32H742ZG STM32H742ZI	Generic Board	2.0.0
💚	STM32H743IG STM32H743II	Generic Board	2.0.0
💚	STM32H743VG STM32H743VI	Generic Board	2.0.0
💚	STM32H743VI	DevEBox H743VIT6	2.2.0
💚	STM32H743VI	WeAct MiniSTM32H743VIT6	2.2.0	More info
💚	STM32H743XG STM32H743XI	Generic Board	2.7.0
💚	STM32H743ZG STM32H743ZI	Generic Board	2.0.0
💚	STM32H745XG STM32H745XI	Generic Board	2.7.0
💚	STM32H747AG STM32H747AI	Generic Board	2.0.0
💚	STM32H747IG STM32H747II	Generic Board	2.0.0
💚	STM32H747XG STM32H747XI	Generic Board	2.7.0
💚	STM32H750ZB	Generic Board	2.0.0
💚	STM32H750IB STM32H750II	Generic Board	2.0.0
💚	STM32H750IB	Daisy	1.9.0
💚	STM32H750IB	Daisy Patch SM	2.2.0
💚	STM32H750IB	Daisy Petal SM	2.2.0
💚	STM32H750VB	Generic Board	2.0.0
💚	STM32H750VB	DevEBox H750VBT6	2.2.0
💚	STM32H750VB	WeAct MiniSTM32H750VBT6	2.2.0	More info
💚	STM32H750XB	Generic Board	2.7.0
💚	STM32H753VI	Generic Board	2.0.0
💚	STM32H753XI	Generic Board	2.7.0
💚	STM32H753ZI	Generic Board	2.0.0
💚	STM32H755XI	Generic Board	2.7.0
💚	STM32H757AI	Generic Board	2.0.0
💚	STM32H757II	Generic Board	2.0.0
💚	STM32H757XI	Generic Board	2.7.0
💚	STM32H7A3VGHX STM32H7A3VGTX	Generic Board	2.8.0
💚	STM32H7A3VIHX STM32H7A3VITX	Generic Board	2.8.0
💚	STM32H7B0VBTX	Generic Board	2.8.0
💚	STM32H7B3VIHX STM32H7B3VITX	Generic Board	2.8.0

Generic STM32L0 boards

Status	Device(s)	Name	Release
💚	STM32L010C6	Generic Board	2.4.0
💚	STM32L010F4	Generic Board	2.4.0
💚	STM32L010R8	Generic Board	2.4.0
💚	STM32L010RB	Generic Board	2.0.0
💚	STM32L011D3 STM32L011D4	Generic Board	2.4.0
💚	STM32L011E3 STM32L011E4	Generic Board	2.4.0
💚	STM32L011F3 STM32L011F4	Generic Board	2.4.0
💚	STM32L011G3 STM32L011G4	Generic Board	2.4.0
💚	STM32L011K3 STM32L011K4	Generic Board	2.4.0
💚	STM32L021F4	Generic Board	2.4.0
💚	STM32L021D4	Generic Board	2.4.0
💚	STM32L021F4	Generic Board	2.4.0
💚	STM32L021G4	Generic Board	2.4.0
💚	STM32L021K4	Generic Board	2.4.0
💚	STM32L031C4 STM32L031C6	Generic Board	2.4.0
💚	STM32L031E4 STM32L031E6	Generic Board	2.4.0
💚	STM32L031F4 STM32L031F6	Generic Board	2.4.0
💚	STM32L031G4 STM32L031G6	Generic Board	2.4.0
💚	STM32L031K4T STM32L031K6T	Generic Board	2.0.0
💚	STM32L041C4 STM32L041C6	Generic Board	2.4.0
💚	STM32L041E6	Generic Board	2.4.0
💚	STM32L041F6	Generic Board	2.4.0
💚	STM32L041G6	Generic Board	2.4.0
💚	STM32L041K6T	Generic Board	2.0.0
💚	STM32L051C6 STM32L051C8	Generic Board	2.0.0
💚	STM32L051K6 STM32L051K8	Generic Board	2.8.0
💚	STM32L052C6 STM32L052C8	Generic Board	2.4.0
💚	STM32L052K6 STM32L052K8	Generic Board	2.4.0
💚	STM32L052R6 STM32L052R8	Generic Board	2.4.0
💚	STM32L052R6T STM32L052R8T	Generic Board	2.0.0
💚	STM32L052T6 STM32L052T8	Generic Board	2.4.0
💚	STM32L053C6 STM32L053C8	Generic Board	2.4.0
💚	STM32L053R6 STM32L053R8	Generic Board	2.4.0
💚	STM32L053R6T STM32L053R8T	Generic Board	2.0.0
💚	STM32L062C8	Generic Board	2.4.0
💚	STM32L062K8	Generic Board	2.4.0
💚	STM32L063C8	Generic Board	2.4.0
💚	STM32L063R8T	Generic Board	2.0.0
💚	STM32L072CB STM32L072CZ	Generic Board	2.4.0
💚	STM32L072CBY STM32L072CZE STM32L072CZY	Generic Board	2.0.0
💚	STM32L072KB STM32L072KZ	Generic Board	2.4.0
💚	STM32L072KBT STM32L072KZT	Generic Board	2.0.0
💚	STM32L072KZT	ThunderPack v1.0	1.8.0
💚	STM32L072RBT	PX-HER0	1.8.0
💚	STM32L072RB STM32L072RZ	Generic Board	2.4.0
💚	STM32L072RBT STM32L072RZT	Generic Board	2.0.0
💚	STM32L072V8 STM32L072VB STM32L072VZ	Generic Board	2.4.0
💚	STM32L073CB STM32L073CZ	Generic Board	2.4.0
💚	STM32L073CZY	Generic Board	2.0.0
💚	STM32L073RB STM32L073RZ	Generic Board	2.4.0
💚	STM32L073RBT STM32L073RZT	Generic Board	2.0.0
💚	STM32L073V8 STM32L073VB STM32L073VZ	Generic Board	2.4.0
💚	STM32L082CZ	Generic Board	2.4.0
💚	STM32L082CZY	Generic Board	2.0.0
💚	STM32L082KB STM32L082KZ	Generic Board	2.4.0
💚	STM32L082KBT STM32L082KZT	Generic Board	2.0.0
💚	STM32L083CB	Generic Board	2.4.0
💚	STM32L083CZ	Generic Board	2.4.0
💚	STM32L083RB	Generic Board	2.4.0
💚	STM32L083RBT STM32L083RZT	Generic Board	2.0.0
💚	STM32L083RZ	Generic Board	2.4.0
💚	STM32L083V8 STM32L083VB STM32L083VZ	Generic Board	2.4.0

Generic STM32L1 boards

Status	Device(s)	Name	Release
💚	STM32L100C6 STM32L100C6-A	Generic Board	2.0.0
💚	STM32L151C6 STM32L151C8 STM32L151CB	Generic Board	2.0.0
💚	STM32L151C6-A STM32L151C8-A STM32L151CB-A	Generic Board	2.0.0
💚	STM32L152C6 STM32L152C8 STM32L152CB	Generic Board	2.0.0
💚	STM32L152C6-A STM32L152C8-A STM32L152CB-A	Generic Board	2.0.0
💚	STM32L151RE	Generic Board	2.0.0
💚	STM32L151ZD	Generic Board	2.6.0
💚	STM32L152RE	Generic Board	2.0.0
💚	STM32L152ZD	Generic Board	2.6.0
💚	STM32L162RE	Generic Board	2.0.0
💚	STM32L162ZD	Generic Board	2.6.0

Generic STM32L4 boards

Status	Device(s)	Name	Release
💚	STM32L412K8 STM32L412KB STM32L422KB	Generic Board	2.0.0
💚	STM32L431CB STM32L431CC	Generic Board	2.8.1
💚	STM32L431RB STM32L431RC	Generic Board	2.3.0
💚	STM32L432KB STM32L432KC STM32L442KC	Generic Board	2.0.0
💚	STM32L433CBT STM32L433CCT	Generic Board	2.1.0
💚	STM32L433CBU STM32L433CCU	Generic Board	2.1.0
💚	STM32L443CC STM32L443CC	Generic Board	2.1.0
💚	STM32L433RC STM32L443RC STM32L433RB	Generic Board	2.6.0
💚	STM32L433RC-P	Generic Board	2.0.0
💚	STM32L452RC STM32L452RE STM32L462RE	Generic Board	2.0.0
💚	STM32L452RE	Leafony AP03	2.4.0
💚	STM32L452RE-P	Generic Board	2.0.0
💚	STM32L475VC STM32L475VE STM32L475VG	Generic Board	2.0.0
💚	STM32L476VC STM32L476VE STM32L476VG	Generic Board	2.0.0
💚	STM32L476RC STM32L476RE STM32L476RG	Generic Board	2.0.0
💚	STM32L486VG	Generic Board	2.0.0
💚	STM32L496ZE STM32L496ZG	Generic Board	2.0.0
💚	STM32L496ZG-P	Generic Board	2.0.0
💚	STM32L4A6ZG	Generic Board	2.0.0
💚	STM32L4A6ZG-P	Generic Board	2.0.0
💚	STM32L4R5VG STM32L4R5VI	Generic Board	2.0.0
💚	STM32L4R5ZGTx STM32L4R5ZITx	Generic Board	2.0.0
💚	STM32L4R5ZGYx STM32L4R5ZIYx	Generic Board	2.1.0
💚	STM32L4R5ZI-P	Generic Board	2.0.0
💚	STM32L4R7VITx	Generic Board	2.0.0
💚	STM32L4R7ZITx	Generic Board	2.0.0
💚	STM32L4R9ZGJx STM32L4R9ZIJx	Generic Board	2.0.0
💚	STM32L4R9ZGYx STM32L4R9ZIYx	Generic Board	2.1.0
💚	STM32L4S5VI	Generic Board	2.0.0
💚	STM32L4S5ZITx	Generic Board	2.0.0
💚	STM32L4S5ZIYx	Generic Board	2.1.0
💚	STM32L4S7VI	Generic Board	2.0.0
💚	STM32L4S7ZITx	Generic Board	2.0.0
💚	STM32L4S9ZIJx	Generic Board	2.0.0
💚	STM32L4S9ZIYx	Generic Board	2.1.0

Generic STM32L5 boards

Status	Device(s)	Name	Release	Notes
💚	STM32L552ZC-Q STM32L552ZE-Q	Generic Board	2.0.0
💚	STM32L562ZE-Q	Generic Board	2.0.0

Generic STM32U0 boards

Status	Device(s)	Name	Release	Notes
💚	STM32U073R8 STSTM32U073RB STM32U073RC	Generic Board	2.9.0
💚	STM32U083RC	Generic Board	2.9.0

Generic STM32U5 boards

Status	Device(s)	Name	Release
💚	STM32U575AGIxQ STM32U575AIIxQ	Generic Board	2.1.0
💚	STM32U575CGx STM32U575CIx	Generic Board	2.7.0
💚	STM32U575ZGTxQ STM32U575ZITxQ	Generic Board	2.1.0
💚	STM32U585AIIxQ	Generic Board	2.1.0
💚	STM32U585CIx	Generic Board	2.7.0
💚	STM32U585ZITxQ	Generic Board	2.1.0

Generic STM32WB boards

Status	Device(s)	Name	Release
💚	STM32WB15CCU	Generic Board	2.5.0
💚	STM32WB55CC STM32WB55CE STM32WB55CG	Generic Board	2.0.0
💚	STM32WB5MMG	Generic Board	2.1.0
💚	STM32WB55RC STM32WB55RE STM32WB55RG	Generic Board	2.0.0

Generic STM32WBA boards

Status	Device(s)	Name	Release	Notes
💚	STM32WBA55CEU STM32WBA55CGU	Generic Board	2.8.0

Generic STM32WL boards

Status	Device(s)	Name	Release	Notes
💚	STM32WL55CC	Generic Node Sensor Edition (GNSE) by TTI	2.1.0	GNSE GitHub
💚	STM32WL54CC STM32WL55CC	Generic Board	2.1.0
💚	STM32WL55JC STM32WL55JC	Generic Board	2.1.0
💚	STM32WLE4C8 STM32WLE4CB STM32WLE4CC	Generic Board	2.1.0
💚	STM32WLE4J8 STM32WLE4JB STM32WLE4JC	Generic Board	2.1.0
💚	STM32WLE5C8 STM32WLE5CB STM32WLE5CC	Generic Board	2.1.0
💚	STM32WLE5J8 STM32WLE5JB STM32WLE5JC	Generic Board	2.1.0

3D printer boards

Status	Device(s)	Name	Release	Notes
💚	STM32F407VE	ARMED V1	1.5.0
💚	STM32F030	EExtruder F030 V1	1.5.0	Small companion board for Prntr Board V1
💚	STM32F103C8	Malyan M200 V1	1.5.0
💚	STM32F070C8	Malyan M200 V2	1.5.0
💚	STM32F070C8	Malyan M300	1.8.0
💚	STM32F407VE	Prntr Board V1	1.5.0
💚	STM32F407VE	Prntr Board V2	1.8.0
💚	STM32F765VI	RemRam v1	1.4.0
💚	STM32F446VE	RUMBA32	1.5.0
💚	STM32F401VE	STEVAL-3DP001V1	1.6.0
💚	STM32F446RE	VAkE v1.0	1.6.0
💚	STM32F446VE	FYSETC_S6	1.9.0
💚	STM32G0B1CB	BTT EBB42 CAN V1.1	2.4.0

Blues boards

Status	Device(s)	Name	Release	Notes
💚	STM32L4R5ZIYx	Swan R5	2.1.0
💚	STM32L433CC	Cygnet	2.8.0

Elecgator boards

Status	Device(s)	Name	Release	Notes
💚	STM32F746ZET	EtherCATduino	2.1.0

Electronic Speed Controller boards

Status	Device(s)	Name	Release	Notes
💚	STM32F051K6U	Wraith V1 ESC	1.8.0
💚	STM32F103RCT	STorM32 V1.31 RC	2.1.0

Garatronic/McHobby boards

Status	Device(s)	Name	Release	Notes
💚	STM32F072RB	PYBStick 26 Duino	1.9.0	More info
💚	STM32F401CE	PYBStick 26 Lite	1.9.0	More info
💚	STM32F411RE	PYBStick 26 Standard	1.9.0	More info
💚	STM32F412RE	PYBStick 26 Pro	1.9.0	More info

Generic flight controllers

Status	Device(s)	Name	Release	Notes
💚	STM32F103CB	Afro Flight Rev5 (8/12MHz)	1.7.0
💚	STM32F303CC	Sparky V1	1.6.0

IoT continuum boards

Status	Device(s)	Name	Release	Notes
💚	STM32U585CIU6	IoT continuum DevKit Board - STM32U585CIU6	2.7.0

LoRa boards

Status	Device(s)	Name	Release	Notes
💚	STM32L073RZ	AcSIP S76S	2.3.0
💚	STM32F072C8 STM32F072CB	Elektor LoRa Node	1.8.0	More info
💚	STM32WLE5JC	LoRa-E5 mini	2.6.0
💚	STM32WLE5CC	RAK3172 Module	2.6.0
💚	STM32WLE5CC	RAK3172T Module	2.8.1	RAK3172 Module with TCXO
💚	STM32L151CB	RAK811 LoRa Tracker	1.4.0	Wiki
💚	STM32L051C8	RHF76-052	1.7.0	Basic support

Midatronics boards

Status	Device(s)	Name	Release	Notes
💚	STM32WB55CE	SharkyMKR	1.7.0

SparkFun boards

Status	Device(s)	Name	Release	Notes
💚	STM32F405RG	SparkFun MicroMod Processor Board - STM32F405	2.6.0
💚	STM32WB5MMG	SparkFun MicroMod Processor Board - STM32WB5MMG	2.6.0

ELV Boards

Status	Device(s)	Name	Release	Notes
💚	STM32WLE5JB	ELV-BM-TRX1	2.8.0

STeaMi Board

Status	Device(s)	Name	Release	Notes
💚	STM32WB55RGV	STeaMi	2.9.0

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.

Name		Name	Last commit message	Last commit date
Latest commit History 3,415 Commits
.github		.github
CI		CI
cmake		cmake
cores/arduino		cores/arduino
debugger		debugger
libraries		libraries
system		system
tools		tools
variants		variants
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
License.md		License.md
README.md		README.md
README_CMAKE.md		README_CMAKE.md
SECURITY.md		SECURITY.md
boards.txt		boards.txt
keywords.txt		keywords.txt
package.json		package.json
platform.txt		platform.txt
programmers.txt		programmers.txt

License

stm32duino/Arduino_Core_STM32

Folders and files

Latest commit

History

Repository files navigation