diff options
| author | rnld wbr <ronaldxweber@gmail.com> | 2025-01-15 20:11:27 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-01-15 19:11:27 +0000 |
| commit | 6f6a56387c22b8a4c5d526d407e2249a7ef7a538 (patch) | |
| tree | fe883d794be7fb6b828da38531f8d8dda221afcd /examples/stm32f1_bluepill_blinky/README.md | |
| parent | 1a1237690cf676733579ffde0f507a00950e474e (diff) | |
Add blinky example for STM32F1 bluepill board (#1007)
Code taken from stm32f3_blinky example with LED port adapted to bluepill
board.
Port initialization and README from v1 rtic-examples with slight edits.
Diffstat (limited to 'examples/stm32f1_bluepill_blinky/README.md')
| -rw-r--r-- | examples/stm32f1_bluepill_blinky/README.md | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/examples/stm32f1_bluepill_blinky/README.md b/examples/stm32f1_bluepill_blinky/README.md new file mode 100644 index 0000000..793de92 --- /dev/null +++ b/examples/stm32f1_bluepill_blinky/README.md @@ -0,0 +1,45 @@ +# STM32F103 Bluepill RTIC Blink example + +Working example of simple LED blinking application for popular Bluepill boards based on the STM32F103C8 chip. Example uses schedule API and peripherials access. You will need `stlink v2` tool or other programmer to flash the board. + +## How-to + +### Terminal workflow + +Rust embedded relies heavily on `terminal workflow`, you will enter commands in the terminal. This can be strange at first, but this enables usage of great things like continious integration tools. + +For Mac OS X consider using `iTerm2` instead of Terminal application. +For Windows consider using `powershell` (win + r -> powershell -> enter -> cd examples\stm3f1_bluepill_blinky) + +### Build + +Run `cargo build` to compile the code. If you run it for the first time, it will take some time to download and compile dependencies. After that, you will see comething like: + +```shell +$ cargo build +Finished dev [optimized + debuginfo] target(s) in 0.10s +``` + +If you see warnings, feel free to ask for help in chat or issues of this repo. + +### Connect the board + +You need to connect you bluepill board to ST-Link and connect pins: + +| BOARD | | ST-LINK | +|-------|----|---------| +| GND | -> | GND | +| 3.3V | -> | 3.3V | +| SWCLK | -> | SWCLK | +| SWDIO | -> | SWDIO | + +Plug in ST-Link to USB port and wait it to initialize. + +### Flashing and running + +Install `cargo embed` from probe-rs tools by following the instructions at https://probe.rs/docs/getting-started/installation/. +Flashing with a standard STLink v2 is easy with `cargo-embed`: + +```shell +$ cargo embed --release +``` |
