Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/hemashushu/practice-mcu-bare-metal-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.
https://github.com/hemashushu/practice-mcu-bare-metal-rust

arm bare-metal cortex-m3 mcu rust stm32 stm32f103c8t6

Last synced: 4 months ago
JSON representation

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.

Host: GitHub
URL: https://github.com/hemashushu/practice-mcu-bare-metal-rust
Owner: hemashushu
License: mpl-2.0
Created: 2022-11-05T22:28:15.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-01-19T03:22:49.000Z (over 1 year ago)
Last Synced: 2023-11-07T20:09:32.163Z (8 months ago)
Topics: arm, bare-metal, cortex-m3, mcu, rust, stm32, stm32f103c8t6
Language: Rust
Homepage:
Size: 3.99 MB
Stars: 114
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-stars - hemashushu/practice-mcu-bare-metal-rust - `★116` 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. (Rust)

README

# MCU STM32F103C8T6 Bare-metal in Rust

[EN](README.md) | [中文](README.zh-Hans.md)

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. Implemented the basic input and output, timer, serial communication, etc. by directly reading and writing registers of hardware.

![stm32f103 rust bare-metal](images/stm32f103-title-v2.jpg)

## Implemented Features

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

[Demo video](https://user-images.githubusercontent.com/394223/206145763-c068ce9e-dcf1-4c87-a6ef-062fdc21162d.mp4)

[Demo video](images/stm32f103-v2.mp4)

## 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](https://github.com/hemashushu/practice-mcu-bare-metal-stm32f030)