This is a (work in progress) rust crate to support the Nordic nRF52 Development Kit using Rust.
This crate uses the Nordic SoftDevice S132 (a binary Bluetooth stack), as well as the Nordic SDK (an open source hardware abstraction layer), which are written in C, and provides Rust bindings for those items.
This project aims to be a reference on how to combine C and Rust components, in order to create a Bluetooth peripheral which uses Rust for the main application software.
This project is not yet ready for public consumption.
This project requires the following tools before building:
Tool | Recommended Version | Minimum Version | Link/Install
:--- | :------------------ | :-------------- | :---
Clang | 3.9 | ? | debian/ubuntu or source
arm-none-eabi-gcc | 6.1 | ? | Current Version
Rust (nightly) | 1.19.0 | ? | rustup.rs
Rust source | 1.19.0 | ? | rustup component add rust-src
Xargo | 0.3.8 | ? | cargo install xargo
Bindgen | 0.25.3 | ? | cargo install bindgen
See the Dockerfile for more specific setup instructions for ubuntu/debian based systems.
Additionally, the following tools are required to run or debug the firmware:
Tool | Recommended Version | Link/Install --- | --- | --- SoftDevice | S132-v4.0.2 | Nordic Download JLink | v6.16 | JLink Download
text
git clone --recursive https://github.com/jamesmunns/nrf52dk-sys
cd nrf52dk-sys
xargo build --target thumbv7em-none-eabihf
Compiling core v0.0.0 (file:///root/.rustup/toolchains/nightly-x86_64-unknown-linux-gnu/lib/rustlib/src/rust/src/libcore)
Finished release [optimized] target(s) in 14.8 secs
Updating registry `https://github.com/rust-lang/crates.io-index`
Downloading r0 v0.2.1
Downloading cortex-m v0.1.6
Downloading volatile-register v0.1.2
Compiling volatile-register v0.1.2
Compiling gcc v0.3.50
Compiling r0 v0.2.1
Compiling cortex-m v0.1.6
Compiling smooth_blue v0.1.0 (file:///nrf52dk-sys)
Finished dev [unoptimized + debuginfo] target(s) in 15.66 secs
First, you must flash the Nordic Soft Device. This should only be necessary to do once (the rest of the firmware will not overwrite this section).
text
cd path/to/softdevice
JLinkExe -device NRF52832_XXAA -if SWD -speed 4000 -autoconnect 1
Device "NRF52832_XXAA" selected.
Found SWD-DP with ID 0x2BA01477
Found SWD-DP with ID 0x2BA01477
AP-IDR: 0x24770011, Type: AHB-AP
AHB-AP ROM: 0xE00FF000 (Base addr. of first ROM table)
Found Cortex-M4 r0p1, Little endian.
FPUnit: 6 code (BP) slots and 2 literal slots
CoreSight components:
ROMTbl 0 @ E00FF000
ROMTbl 0 [0]: FFF0F000, CID: B105E00D, PID: 000BB00C SCS
ROMTbl 0 [1]: FFF02000, CID: B105E00D, PID: 003BB002 DWT
ROMTbl 0 [2]: FFF03000, CID: B105E00D, PID: 002BB003 FPB
ROMTbl 0 [3]: FFF01000, CID: B105E00D, PID: 003BB001 ITM
ROMTbl 0 [4]: FFF41000, CID: B105900D, PID: 000BB9A1 TPIU
ROMTbl 0 [5]: FFF42000, CID: B105900D, PID: 000BB925 ETM
Cortex-M4 identified.
J-Link>loadfile s132_nrf52_4.0.2_softdevice.hex
Downloading file [s132_nrf52_4.0.2_softdevice.hex]...
Comparing flash [100%] Done.
Verifying flash [100%] Done.
O.K.
This only flashes the firmware built above. If you would like to flash and debug, skip forward.
text
cd nrf52dk-sys
arm-none-eabi-objcopy -O ihex target/thumbv7em-none-eabihf/debug/bin target.hex
JLinkExe -device NRF52832_XXAA -if SWD -speed 4000 -autoconnect 1
J-Link>loadfile target.hex
Downloading file [target.hex]...
Comparing flash [100%] Done.
Verifying flash [100%] Done.
O.K.
It may be necessary to reset the device after closing JLink with CTRL-c.
First, create a GDB server on one terminal:
```text JLinkGDBServer -device NRF52832_XXAA -if SWD -speed 4000
```
Then, in another terminal:
```text cd nrf52dk-sys arm-none-eabi-gdb -tui target/thumbv7em-none-eabihf/debug/bin (gdb) target remote :2331
(gdb) monitor reset
(gdb) load
(gdb) monitor reset
(gdb) continue
```
I wrote the Dockerfile in order to support CI. This is not done yet. For now if you would like to build it to verify the master branch builds:
```text cd nrf52dk-sys
docker build -t nrf52dk .
docker run -t nrf52dk ```
If the docker container ran successfully, you should see something like this at the end:
text
Compiling smooth_blue v0.1.0 (file:///nrf52dk-sys)
Finished dev [unoptimized + debuginfo] target(s) in 15.66 secs
All Rust components are provided under the MIT License. Additional components provided by the Nordic nRF5-sdk contain additional licenses.