This repository has been archived on 2024-06-16. You can view files and clone it, but cannot push or open issues or pull requests.
Robin Mueller 4160df667f
Completed BSP core features
- Added basic accelerometer example. Board in not populated so it is not complete, but it provides a starting point
- Added ADC base library and example building on the new `max116xx-10bit` device driver crate
2021-12-12 13:46:45 +01:00

83 lines
3.1 KiB

# Rust BSP for the Vorago REB1 development board
This is the Rust **B**oard **S**upport **P**ackage 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:
- [Rust Embedded Book](
- [Rust Discovery Book](
## 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
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.osx"`
## Flashing the non-volatile memory
Coming Soon