cargo-board

A cargo subcommand for managing embedded boards

Demo

The configuration for boards is specified in a boards.toml such as:

```toml [soc] STM32F2XXXB = { arch = "thumbv7m-none-eabi", flash = "128K", ram = "64K" } STM32F2XXXE = { arch = "thumbv7m-none-eabi", flash = "512K", ram = "128K" }

[board] flexperiment_mini = { soc = "STM32F2XXXB" } netboard = { soc = "STM32F2XXXE" } ```

Usage

cargo board [board_name] <ARGUMENTS TO CARGO>

e.g. cargo board netboard build -p blink

What it does

• enables the board_[board_name] feature of the compiled crate (passes --feature board_[board_name] to cargo)
• passes --target [soc.arch] to cargo
• sets CARGO_TARGET_DIR to target/[board_name]
  (TODO: this leads to duplication of compiled shared crates)
• exposes LD_FLASH_SIZE and LD_RAM_SIZE as environmental variables to cargo so it can be used in build scripts
  (TODO: make this generic and not hardcoded attributes?)

• exposes BOARD_FEATURES so we can expose the following features
  (exposed using rustc, so only available in code and not in cargo-configuration):

  • the soc_[soc_name] feature, you can check for a specific soc using #[cfg(feature="soc_[soc_name]")]

  This needs to be in your build.rs.