2022-12-30 12:55:30 +01:00
|
|
|
Vorago Rust Workspace
|
|
|
|
|
========
|
2021-11-11 19:49:41 +01:00
|
|
|
|
2021-11-02 20:32:01 +01:00
|
|
|
Workspace for developing Rust code for the Vorago devices
|
2021-11-11 19:49:41 +01:00
|
|
|
|
|
|
|
|
After cloning, run
|
|
|
|
|
|
|
|
|
|
```sh
|
2022-12-30 12:55:30 +01:00
|
|
|
git submodule update --init
|
2021-11-11 19:49:41 +01:00
|
|
|
```
|
2021-12-10 10:13:42 +01:00
|
|
|
|
2022-12-30 12:55:30 +01:00
|
|
|
# Preparing the Rust installation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Building an application for the VA108XX family requires the `thumbv6m-none-eabi`
|
|
|
|
|
cross-compiler toolchain. If you have not installed it yet, you can do so with
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
rustup target add thumbv6m-none-eabi
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# Debugging with VS Code
|
2021-12-10 10:13:42 +01:00
|
|
|
|
2021-12-10 10:14:09 +01:00
|
|
|
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](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug).
|
|
|
|
|
|
|
|
|
|
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.
|
2021-12-10 10:13:42 +01:00
|
|
|
|
|
|
|
|
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"`
|
