A bare metal STM32F103C8T6/STM32F103 MCU program written in pure Rust

Hema Shushu

Last update: Dec 18, 2022

Related tags

Utilities rust arm stm32 mcu bare-metal cortex-m3 stm32f103c8t6

Overview

MCU STM32F103C8T6 Bare-metal in Rust

A bare metal (register level) STM32F103C8T6/STM32F103 MCU program written in pure Rust without any IDE, SDK, HAL or library, and no assembly code, the only tool required is the Rust compiler. Implement basic input and output, timer, serial communication, etc. by directly reading and writing registers of hardware.

Implemented Features

GPIO read and write
Set system clock
SysTick and interrupt
UART read and write

stm32f103-v2.mp4

Demo video

Source Code Structure

src/register_*.rs Definition of register structures and values
src/startup.rs startup and vector array
src/main.rs main program
.vscode/launch.json configuration file for VSCode debug
svd/ System View Description file for displaying various register names and address values during GDB debugging
build.sh script for compiling
flash.sh script for compiling and downloading firmware

Wires

PC13: builtin LED -
PB5: external LED +
PA0: button (the another button pin connect to GND)
PA9: USART1_TX -> CP2012 RX
PA10: USART1_RX -> CP2012 TX

Compile

Install Rust on your platform first, then run:

$ ./build.sh

Flash

Connect the MCU to your computer using the CMSIS_DAP debugger (hardware) and then run:

$ ./flash.sh

Debug

$ ./server-gdb-server.sh

then open another terminal, and run:

$ ./start-gdb-client-with-svd.sh

Reference Documents

Hardware description and register structure and value description documentations:

STM32F103c8 Datasheet https://www.st.com/resource/en/datasheet/cd00161566.pdf
RM0008 Reference manual https://www.st.com/resource/en/reference_manual/cd00171190-stm32f101xx-stm32f102xx-stm32f103xx-stm32f105xx-and-stm32f107xx-advanced-arm-based-32-bit-mcus-stmicroelectronics.pdf
PM0214 Programming manual https://www.st.com/resource/en/programming_manual/pm0214-stm32-cortexm4-mcus-and-mpus-programming-manual-stmicroelectronics.pdf

For those who want to know how it works and who want to go further and implement more features, check out these:

Bare metal programming guide (C lang on STM32F429) https://github.com/cpq/bare-metal-programming-guide
The Embedonomicon https://docs.rust-embedded.org/embedonomicon/
libopencm3 project https://github.com/libopencm3/libopencm3

C language version

This project is also implemented in C by the author, for those interested please check out MCU STM32F030C8T6 Bare-metal in C

Pure Rust library for Apache ZooKeeper built on tokio

zookeeper-async Async Zookeeper client written 100% in Rust, based on tokio. This library is intended to be equivalent with the official (low-level) Z

16 Dec 16, 2022

Pure rust implementation of python's random module with compatible generator behaviour.

pyrand Pure rust implementation of (parts of) python's random module with compatible PRNG behaviour: seeding with equivalent values will yield identic

4 Feb 10, 2024

Rust program to monitor Windows 10 Registry keys for changes or modifications.

RegMon This Rust program monitors changes to multiple registry keys in Windows 10 and writes the changes to a text file. It also periodically sends a

3 Jan 16, 2023

Waits until the exit code of a program is zero

Waitz A rust utility to wait that a program exits with 0. You need to wait for something to start up and don't know when it finishes?

15 Apr 10, 2022

✨ Safe, global singletons initialized at program start

✨ magic_static Safe, global singletons initialized at program start. Usage Simply add magic_static as a dependency in your Cargo.toml to get started:

5 Nov 8, 2022

Soufflé is a variant of Datalog for tool designers crafting analyses in Horn clauses. Soufflé synthesizes a native parallel C++ program from a logic specification.

Welcome! This is the official repository for the Soufflé language project. The Soufflé language is similar to Datalog (but has terms known as records)