Board Support Package crate for the Vorago REB1 development board
Go to file
Robin Müller 09c5dcd171
Rust/vorago-reb1/pipeline/head This commit looks good Details
update changelog
2021-12-13 11:38:58 +01:00
.cargo BSP update 2021-11-09 19:21:50 +01:00
.github BSP update 2021-11-09 19:21:50 +01:00
.vscode Completed BSP core features 2021-12-12 13:46:45 +01:00
automation preparations for v0.3.0 2021-12-12 14:31:26 +01:00
examples some form changes 2021-12-12 14:42:35 +01:00
src updated links, deps for updated ADC code 2021-12-12 21:06:42 +01:00
.gitignore init commit 2021-11-02 20:50:05 +01:00
CHANGELOG.md update changelog 2021-12-13 11:38:58 +01:00
Cargo.toml dependency update for max device 2021-12-13 00:34:30 +01:00
LICENSE-APACHE added license files 2021-11-02 20:48:49 +01:00
NOTICE preparations for v0.3.0 2021-12-12 14:31:26 +01:00
README.md Completed BSP core features 2021-12-12 13:46:45 +01:00
jlink.gdb BSP update 2021-11-09 19:21:50 +01:00
memory.x BSP update 2021-11-09 19:21:50 +01:00

README.md

Crates.io ci docs.rs

Rust BSP for the Vorago REB1 development board

This is the Rust Board Support Package crate for the Vorago REB1 development board. Its aim is to provide drivers for the board features of the REB1 board

The BSP builds on top of the HAL crate for VA108xx devices.

Building

Building an application requires the thumbv6m-none-eabi cross-compiler toolchain. If you have not installed it yet, you can do so with

rustup target add thumbv6m-none-eabi

This repository provides some example applications to show how the BSP is used. For example you can build the blinky example with

cargo build --example blinky-leds

If you have not done this yet, it is recommended to read some of the excellent resources available to learn Rust:

Flashing from the command line

A jlink.gdb file is provided to allow flashing of the board from the command line.

  1. Ensure that you have a suitable GDB application like arm-none-eabi-gdb or gdb-multiarch installed first. On Windows, you can use xPacks. On Linux, you can install gdb-multiarch from the package manager.

  2. Install the JLink Tools.

  3. Start the JLink GDB server with the GUI or from the command line. The device should be recognized automatically

  4. Make sure to select an appropriate runner in the .cargo/config.toml file depending on which GDB application you are using

  5. Use

    cargo run --example blinky-leds
    

    to flash the board. The debugger should stop at the start of the main.

Debugging with VS Code

The REB1 board features an on-board JTAG, so all that is required to flash the board is a Micro-USB cable and an You can debug applications on the REB1 board with a graphical user interface using VS Code with the Cortex-Debug plugin.

Some sample configuration files for VS code were provided as well. You can simply use Run and Debug to automatically rebuild and flash your application.

The tasks.json and the launch.json files are generic and you can use them immediately by opening the folder in VS code or adding it to a workspace.

If you would like to use a custom GDB application, you can specify the gdb binary in the following configuration variables in your settings.json:

  • "cortex-debug.gdbPath"
  • "cortex-debug.gdbPath.linux"
  • "cortex-debug.gdbPath.windows"
  • "cortex-debug.gdbPath.osx"

Flashing the non-volatile memory

Coming Soon