The tutorial demonstrates the key features of the Hopter embedded operating system by blinking the four LEDs on STM32F407-Discovery, STM32F411-Discovery, or STM32F412-Discovery board. It covers essential topics, including:
- Project setup
- System initialization and the
maintask - Normal, restartable, and breathing tasks
- Interrupt handling (IRQ)
- Synchronization primitives
- Panic and stack overflow protection
The source code src/main.rs includes detailed explanations for each topic.
This guide also serves as a good starting point for building your own projects.
There is nothing to do if the code runs with an STM32F407-Discovery board.
For an F411 or F412 board, apply the corresponding patch to the source code. The patch rewrites a few configuration parameters to match the chosen board.
For example with F411, run the following command.
patch -p1 < stm32f411-discovery.patch
Hopter requires a customized Rust compiler toolchain. The easiest way to get it is by downloading a prebuilt version for your system. Follow the instructions here.
The tool arm-none-eabi-objcopy is needed to prepare the binary for flashing to the board.
- MacOS: Install using the following command:
brew install --cask gcc-arm-embedded - Ubuntu: Download the toolchain from here. Ensure the executable is included in your
PATH.
st-link is used to flash the binary onto the board.
- MacOS: Install using the following command:
brew install stlink - Ubuntu: Install using the following command:
sudo apt install stlink-tools
Run cargo build --release to compile the code. Run cargo run --release to flash the board.