Optogenetics LED control firmware for Nucleo-F303RE

Building

To build the ELF executable, install the following:

# In the directory with Cargo.toml for led-box-firmware
rustup component add rust-src
rustup target add thumbv7em-none-eabihf

To convert the ELF executable to a .bin file which can be copied onto the nucleo, install the following:

cargo install cargo-binutils
rustup component add llvm-tools-preview

To build the ELF executable and convert it to a .bin file, do this:

cargo objcopy --bin led-box-firmware --release -- -O binary ./target/thumbv7em-none-eabihf/release/led-box-firmware.bin

The file at ./target/thumbv7em-none-eabihf/release/led-box-firmware.bin can now be copied onto the emulated USB mass storage device of the Nucleo board.

Debugging with Knurling (probe-rs)

We use the Knurling project to facilitate debugging. probe-rs can be used to debug the device from a host computer and view log messages send using the defmt infrastructure. Install probe-run with cargo install probe-run.

To see defmt messages, compile with the DEFMT_LOG environment variable set appropriately. (By default, defmt will show only error level messages.)

Powershell (Windows)

$Env:DEFMT_LOG="trace"

Bash (Linux/macOS)

export DEFMT_LOG=trace

Probe: onboard STLINKv2

This is the easiest option and works with only a mini-USB cable to your device. If probe-run returns with Error: The firmware on the probe is outdated, you can update the STLINKv2 firmware on your Nucleo using a download from st.com.

Run with:

cargo run --release

License

Portions of this project are derived from the cortex-m-quickstart project, which is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)