Dealing with microcontrollers involves several tools as we'll be dealing with an architecture different than your computer's and we'll have to run and debug programs on a "remote" device.
Tooling is not everything though. Without documentation it is pretty much impossible to work with microcontrollers.
We'll be referring to all these documents throughout this book:
HEADS UP All these links point to PDF files and some of them are hundreds of pages long and several MBs in size.
- STM32F3DISCOVERY User Manual
- STM32F303VC Datasheet
- STM32F303VC Reference Manual
- LSM303DLHC *
- L3GD20 *
* NOTE: Newer (from around 2020/09) Discovery boards may have a different e-compass and gyroscope (see the user manual). As such, much in chapters 14-16 will not work as is. Checkout the github issues like this.
We'll use all the tools listed below. Where a minimum version is not specified, any recent version should work but we have listed the version we have tested.
Rust 1.31 or a newer toolchain.
cargo install itm). Tested versions: 0.3.1.
OpenOCD >=0.8. Tested versions: v0.9.0 and v0.10.0
arm-none-eabi-gdb. Version 7.12 or newer highly recommended. Tested versions: 7.10, 7.11, 7.12 and 8.1
cargo-binutils. Version 0.1.4 or newer.
minicomon Linux and macOS. Tested version: 2.7. Readers report that
picocomalso works but we'll use
minicomin this text.
If your computer has Bluetooth functionality and you have the Bluetooth module, you can additionally install these tools to play with the Bluetooth module. All these are optional:
- Linux, only if you don't have a Bluetooth manager application like Blueman.
macOS / OSX / Windows users only need the default bluetooth manager that ships with their OS.
Next, follow OS-agnostic installation instructions for a few of the tools:
Install rustup by following the instructions at https://rustup.rs.
If you already have rustup installed double check that you are on the stable
channel and your stable toolchain is up to date.
rustc -V should return a date
newer than the one shown below:
$ rustc -V rustc 1.31.0 (abe02cefd 2018-12-04)
cargo install itm
Verify the version is >=0.3.1
$ itmdump -V itmdump 0.3.1
rustup component add llvm-tools-preview
cargo install cargo-binutils
Run the following commands at your terminal
cargo new test-size
cargo size -- -version
The results should be something like:
~ $ cargo new test-size Created binary (application) `test-size` package ~ $ cd test-size ~/test-size (main) $ cargo run Compiling test-size v0.1.0 (~/test-size) Finished dev [unoptimized + debuginfo] target(s) in 0.26s Running `target/debug/test-size` Hello, world! ~/test-size (main) $ cargo size -- -version Finished dev [unoptimized + debuginfo] target(s) in 0.00s LLVM (http://llvm.org/): LLVM version 11.0.0-rust-1.50.0-stable Optimized build. Default target: x86_64-unknown-linux-gnu Host CPU: znver2
Now follow the instructions specific to the OS you are using: