BlackCrab

Next gen software for heterogeneous embedded development boards

Before the new boards are available we will Initially be targeting the existing MyStorm IceCore SOM for experimentation.

Required setup: Rust 1.50 or a newer toolchain.

• itmdump >=0.3.1 (cargo install itm). Tested versions: 0.3.1.
• OpenOCD >=0.8. Tested versions: v0.9.0 and v0.10.0
• gdb-multiarch. Tested versions: 8.1
• cargo-binutils. Version 0.1.4 or newer.
• minicom on Linux and macOS.
• PuTTY on Windows.

rustc & Cargo

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.50.0 (cb75ad5db 2021-02-10)

itmdump

cargo install itm

Verify the version is >=0.3.1

 $ itmdump -V
 itmdump 0.3.1

cargo-binutils

Install llvm-tools-preview

rustup component add llvm-tools-preview

Install cargo-binutils

cargo install cargo-binutils

Verify tools are installed Run the following commands at your terminal

 cargo new test-size
 cd test-size
 cargo run
 cargo size -- -version`

you should see 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

Ubuntu 18.04 Linux (Including WSL) requirements:

 sudo apt-get install \
  gdb-multiarch \
  minicom \
  openocd

Add new udev rules for ST-Link/open-OCD

 sudo vi /etc/udev/rules.d/99-openocd.rules

Add the following line :

ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374b", MODE:="0666"

You may need to adjust the idVendor and idProduct ids, you can find these by examining lsusb output after plugging in yout ST-Linktool

Then reload the rules

 sudo udevadm control --reload-rules

Run OpenOCD

openocd -f interface/stlink-v2.cfg -f extra/IceCore.cfg

For WSL you will need to install a Windows executeable for OpenOCD as WSL cannot use the usb ST-Link tool.

you should see something like:

stlink-V2.cfg -f .\IceCore.cfg
Open On-Chip Debugger 0.10.0 (2019-07-15) [https://github.com/sysprogs/openocd]
Licensed under GNU GPL v2
For bug reports, read
        http://openocd.org/doc/doxygen/bugs.html
WARNING: interface/stlink-v2.cfg is deprecated, please switch to interface/stlink.cfg
WARNING: interface/stlink-v2.cfg is deprecated, please switch to interface/stlink.cfg
Warn : Interface already configured, ignoring
Error: already specified hl_layout stlink
Info : The selected transport took over low-level target control. The results might differ compared to plain JTAG/SWD
none separate

Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Info : clock speed 2000 kHz
Info : STLINK V2J21S4 (API v2) VID:PID 0483:3748
Info : Target voltage: 3.164644
Error: BUG: can't assert SRST
Info : STM32F730R8Tx.cpu: hardware has 8 breakpoints, 4 watchpoints

To build and run BlackCrab

The first time you may need to add the correct target :

rustup target add thumbv7em-none-eabihf

From then on you should just be able to build/run :

cargo run --features "stm32f730 rt usb_fs"