Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status


Rust userland library for Tock

Generally this library was tested with Tock Release 2.1.1.

The library should work on all Tock boards, but currently apps must be compiled for the flash and RAM address they are executed at. See Fix relocation for more details. This means that process binaries 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.

Getting Started

  1. Ensure you have rustup installed.

  2. Clone the repository:

    git clone --recursive
    cd libtock-rs
  3. Install the dependencies:

    make setup
  4. Use make to build examples

    make nrf52 EXAMPLE=console # Builds the console example for the nrf52

Using libtock-rs

The easiest way to start using libtock-rs is adding an example to the examples/ folder. We recommend starting by copying the console example, as it is a simple example that shows you how to perform normal debug prints.

To build your example for your board you can use

make <platform> EXAMPLE=<example>

An example can be flashed to your board after the build process by running:

make flash-<platform> EXAMPLE=<example>

This script does the following steps for you:

  • cross-compile your program
  • create a TAB (tock application bundle)
  • if you have a J-Link compatible board connected: flash this TAB to your board (using tockloader)


libtock-rs is licensed under either of

at your option.

Submodules, as well as the code in the ufmt directory, have their own licenses.


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.

The contribution guidelines can be found here: contribution guidelines