| commit | 22bc2542989f86743dfaf7a7c93b6ee441ee8d54 | [log] [tgz] |
|---|---|---|
| author | Woyten <woyten.tielesch@online.de> | Fri Nov 15 23:18:40 2019 +0100 |
| committer | Woyten <woyten.tielesch@online.de> | Wed Nov 27 19:02:51 2019 +0100 |
| tree | de7898e69975338489ef26b27074bd90cfedd1d4 | |
| parent | 8e96724746827a638d19db09729d9c19497495c7 [diff] |
Strict usage of TockResult
Rust userland library for Tock (WIP)
Tested with tock Release 1.4.1.
The library works in principle on most boards, but there is currently the showstopper bug #28 that prevents the generation of relocatable code. This means that all applications must be installed at the flash address they are compiled with, which usually means that they must be compiled especially for your board and that there can only be one application written in rust at a time and it must be installed as the first application on the board, unless you want to play games with linker scripts. There are some *_layout.ld files provided that allow to run the examples on common boards. Due to MPU region alignment issues they may not work for applications that use a lot of RAM, in that case you may have to change the SRAM start address to fit your application.
This project is nascent and still under heavy development, but first steps:
Ensure you have rustup installed.
Clone the repository.
git clone https://github.com/tock/libtock-rs cd libtock-rs
Install elf2tab.
cargo install -f elf2tab --version 0.4.0
Add dependencies for cross-compilation.
rustup target add thumbv7em-none-eabi
Use the run_example script to compile and run the example app you want to use:
./run_example.sh blink
Due to bug #28 this will currently only work if you are using the nRF52-DK platform.
If you have a nRF52840-DK you must change link-arg=-Tnrf52_layout.ld in .cargo/config to link-arg=-Tnrf52840_layout.ld
If you have a hail board you can flash your device as follows:
hail to 1link-arg=-Tnrf52_layout.ld in .cargo/config to link-arg=-Thail_layout.ldrun_example.sh as above.For other platforms, you may have to create your own memory layout definition.
The easiest way to start using libtock-rs is adding an example to the examples folder. The boiler plate code you would write is
#![no_std] async fn main() { // Your code }
If you want to use heap based allocation you will have to add
extern crate alloc;
to the preamble.
To run on the code on your board you can use
./run_example.sh <your app>
This script does the following steps for you:
Having an nRF52-DK board at hand, integration tests can be run using ./run_hardware_tests.sh. The pins P0.03 and P0.04 need to be connected (on a nRF52-DK). The expected output on the UART console will be as follows.
[test-results] heap_test = "Heap works." formatting = works should_be_one = 1 gpio_works = true trait_obj_value_usize = 1 trait_obj_value_string = string callbacks_work = true all_tests_run = true
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.