Codal target for STM32 MCU

Codal target for the STM32 familly. Codal is the core set of drivers, mechanisms and types that make up the runtime for a board in Makecode.

Overview

The codal runtime provides an easy to use environment for programming the board in the C/C++ language, written by Lancaster University. It contains device drivers for all the hardware capabilities, and also a suite of runtime mechanisms to make programming the easier and more flexible. These range from control of the LED matrix display to peer-to-peer radio communication and secure Bluetooth Low Energy services.

In addition to supporting development in C/C++, the runtime is also designed specifically to support higher level languages provided by our partners that target physical computing and computer science education. It is currently used as a support library for Microsoft MakeCode

Codal-core must be implemented by third party developper to support new hardware target. This repository constain the codal implementation for the STM32 MCU familly.

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 defintion 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 GNU Arm Embedded GCC: https://github.com/xpack-dev-tools/arm-none-eabi-gcc-xpack

Boards available

Status	Nucleo 144	Release	Comment
💔	Nucleo F207ZG
💔	Nucleo F429ZI
💔	Nucleo F767ZI
💔	Nucleo F746ZG
💔	Nucleo F756ZG
💔	Nucleo L496ZG
💔	Nucleo L496ZG-P
💔	Nucleo L4R5ZI
💔	Nucleo L4R5ZI-P
💔	Nucleo H743ZI(2)

Status	Nucleo 64	Release
💔	Nucleo F030R8
💔	Nucleo F091RC
💔	Nucleo F103RB
💔	Nucleo F302R8
💔	Nucleo F303RE
💔	Nucleo F401RE
💔	Nucleo F411RE
💔	Nucleo F446RE
💔	Nucleo G071RB
💔	Nucleo G431RB
💔	Nucleo G474RE
💔	Nucleo L053R8
💔	Nucleo L073RZ
💔	Nucleo L152RE
💔	Nucleo L452RE
💔	Nucleo L452RE-P
💔	Nucleo L476RG
💛	P-Nucleo-WB55RG	0.0.1

Status	Nucleo 32	Release	Comment
💔	Nucleo F031K6
💔	Nucleo F303K8
💔	Nucleo G431KB
💔	Nucleo L031K6
💔	Nucleo L412KB
💔	Nucleo L432KC

Status	Discovery	Release
💔	32F0308DISCOVERY
💔	32F072BDISCOVERY
💔	STM32VLDISCOVERY
💔	STM32F407G-DISC1
💔	STM32F746G-DISCOVERY
💔	STM32G0316-DISCO
💔	B-L072Z-LRWAN1
💛	B-L475E-IOT01A	0.0.1
💔	32F413HDISCOVERY

Status	Eval	Release	Comment
💔	STEVAL-MKSBOX1V1 (SensorTile.box)

Status	STM32MP1 series coprocessor	Release	Comment
💔	STM32MP157A-DK1
💔	STM32MP157C-DK2

Status	Generic STM32F0xx	Release	Comment
💔	STM32F030F4 Demo board

Status	Generic STM32F1xx	Release	Comment
💔	BluePill F103C(6-8-B)
💔	BlackPill F103C(8-B)
💔	Generic F103R(8-B-C-E)T6
💔	Generic F103Z(C-D-E-F-G)
💔	HY-TinySTM103T
💔	MapleMini F103CB
💔	Vcc-Gnd F103ZET6

Status	Generic STM32F3xx	Release	Comment
💔	RobotDyn BlackPill F303CC

Status	Generic STM32F4xx	Release	Comment
💔	Adafruit Feather STM32F405 Express
💔	BlackPill F401CC
💔	BlackPill F411CE
💔	Black F407VET6
💔	Blue F407VET6 Mini
💔	Core Board F401RC
💔	DIYMORE STM32F407VGT
💔	FK407M1
💔	Generic F401C(B-C-D-E)
💔	Generic F401R(B-C-D-E)
💔	Generic F405RG
💔	Generic F407V(E-G)
💔	Generic F410C(8-B)
💔	Generic F410R(8-B)
💔	Generic F411C(C-E)
💔	Generic F411R(C-E)
💔	Generic F412C(E-G)
💔	Generic F412R(E-G)
💔	Generic F413C(G-H)
💔	Generic F413R(G-H)
💔	Generic F415RG
💔	Generic F417V(E-G)
💔	Generic F423CH
💔	Generic F423RH
💔	Generic F446R(C-E)
💔	ThunderPack v1.1+

Status	Generic STM32L0xx	Release	Comment
💔	PX-HER0
💔	ThunderPack v1.0

Status	LoRa boards	Release	Comment
💔	RAK811 LoRa Tracker
💔	RHF76-052

Installation

Before using this target you need to configure your platforms with some software. Codal is also a build system to simplify as much as possible the experience of novice users.

Install git, ensure it is available on your platforms path.
Install the arm-none-eabi-* command line utilities for ARM based devices.
Install CMake(Cross platform make), this is the entirety of the build system.
Install Python 2.7 (if you are unfamiliar with CMake), python scripts are used to simplify the build process.
Clone the repository https://github.com/lancaster-university/codal

Building

Generate or create a codal.json file
- python build.py codal-stm32 generates a codal.json file for our target
In the root of this repository type python build.py the -c option cleans before building.

Next release

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

Troubleshooting

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

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.