BootAppOfArm

Minimal STM32F412 boot + app sandbox. Keeps startup and UART-only examples as small as possible and defaults to Renode simulation so you do not need real hardware.

Directory layout

• apps/boot/ – bootloader stub (UART hello + TODO jump hook)
• apps/app/ – application example (UART heartbeat)
• cmsis/, drivers/ – startup/system files and device headers from STM32CubeF4
• build/ – CMake build output (kept empty in git)
• renode/ – Renode script + GDB port config
• .vscode/ – tasks/launch configs for building, uploading, running Renode
• docs/ – debug guide and flow diagram

Quick build

Before building, fetch the CMSIS/driver submodules:

git submodule update --init --recursive

cmake -S . -B build
cmake --build build

Outputs: build/app.elf and build/boot.elf.

Commit message template

This repo provides a bilingual (中文/English) Conventional Commits template in .gitmessage.

Enable it locally:

git config --local commit.template .gitmessage

Debug/sim tips

• Renode GDB server defaults to port 3333 (see renode/platform.resc).
• VSCode tasks can upload app.elf (or boot.elf) to a remote Renode host.
• See docs/DEBUG.md for step-by-step debugging notes.

License

MIT (see LICENSE).