1 unstable release
Uses old Rust 2015
0.1.0 | Aug 25, 2017 |
---|
#124 in #board
6KB
60 lines
cargo-board
A cargo subcommand for managing embedded boards
Demo
The configuration for boards is specified in a boards.toml
such as:
[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
totarget/[board_name]
(TODO: this leads to duplication of compiled shared crates) -
exposes
LD_FLASH_SIZE
andLD_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]")]
- the
Dependencies
~0.5–1MB
~25K SLoC