Skip to content

knurling-rs

Get a handle on bare-metal Rust

Knurling-rs is a project by Ferrous Systems. Our mission is to improve the embedded Rust experience. To achieve this, we build and improve tools and create learning materials.

We believe that developing for embedded systems should be no more difficult than developing for hosted platforms.

Tools

It should be possible to use the same workflows and equally powerful tooling to develop applications and libraries for tiny embedded systems as well as powerful server-class hardware.

To that end we have created following tools:

defmt

defmt is a highly efficient logging framework that targets resource-constrained devices, like microcontrollers. defmt stands for "deferred formatting".

Rather than performing formatting input like 255u8 into "The temperature is 255°C" on the embedded device, the formatting is deferred to the host that will output the logs. This way, only the relevant data needs to be sent to the host instead of the entire format string. Additionally the transmitted data is compressed, for example by compressing several booleans into one byte.

This means that defmt:

  • reduces compiled binary size, since it only has to contain indices to log strings saved by the host instead of the string itself
  • reduces computation efforts on the target, because the formatting of e.g. 255u8 to "255" happens on the host that displays the logging output, not the target
  • reduces delays and log buffer usage, since there is less data sent from the embedded device to the host

For more details on how it works, check out the defmt book.

flip-link

flip-link adds zero-cost stack overflow protection for your embedded programs – no MPU or stack probe support needed!

It does this by flipping the standard memory layout of ARM Cortex-M programs.

With this inverted memory layout, the stack "overflows" instead of corrupting memory when it hits the boundary of the RAM region. This boundary collision raises a hardware exception (usually the "hard fault" exception), which by default halts the program.

For more details, check out our blog post introducing flip-link.

app-template

The app-template is a Cargo project template, so you can hit the ground running with probe-run, defmt and flip-link. Using the knurling app-template, and cargo-generate, you can start your embedded project by just running

$ cargo generate \
    --git https://github.com/knurling-rs/app-template \
    --branch main \
    --name my-app

and specifying your desired HAL and compilation target.

defmt-test

defmt-test is an embedded test harness that lets you write and run unit tests as if you were using the built-in #[test] attribute, but they'll run on your embedded target.

Of course, defmt-test also gives you an #[init] attribute for initialization functions needed to set up your peripherals etc.

For more details, check out our blog post introducing defmt-test. Also check our blog post series on testing embedded Rust code.

Learning materials

Sometimes we create learning resources to help newcomers to embedded Rust to get their hands dirty

name website repository
Knurling Session 2020 "Build a C02 measuring device" https://session20q4.ferrous-systems.com/ https://github.com/knurling-rs/knurling-session-20q4

Blog

You can find some project updates and behind the scenes insights in the Ferrous Systems Blog.

Pinned

  1. defmt defmt Public

    Efficient, deferred formatting for logging on embedded systems

    Rust 745 67

  2. app-template app-template Public

    Quickly set up a `probe-rs` + `defmt` + `flip-link` embedded project

    Rust 294 29

  3. flip-link flip-link Public

    Adds zero-cost stack overflow protection to your embedded programs

    Rust 247 7

  4. knurling-session-20q4 knurling-session-20q4 Public

    Building your own embedded CO2 measuring device. With Rust!

    Rust 22 9

Repositories

Showing 10 of 19 repositories
  • defmt Public

    Efficient, deferred formatting for logging on embedded systems

    knurling-rs/defmt’s past year of commit activity
    Rust 745 Apache-2.0 67 77 (2 issues need help) 7 Updated Jun 15, 2024
  • flip-link Public

    Adds zero-cost stack overflow protection to your embedded programs

    knurling-rs/flip-link’s past year of commit activity
    Rust 247 Apache-2.0 7 9 1 Updated May 8, 2024
  • .github Public
    knurling-rs/.github’s past year of commit activity
    0 0 0 0 Updated Jan 30, 2024
  • probe-run Public archive

    Run embedded programs just like native ones

    knurling-rs/probe-run’s past year of commit activity
    Rust 643 Apache-2.0 75 51 6 Updated Jan 30, 2024
  • app-template Public

    Quickly set up a `probe-rs` + `defmt` + `flip-link` embedded project

    knurling-rs/app-template’s past year of commit activity
    Rust 294 Apache-2.0 29 4 2 Updated Oct 30, 2023
  • probe-rs Public Forked from probe-rs/probe-rs

    A debugging toolset and library for debugging embedded ARM and RISC-V targets on a separate host

    knurling-rs/probe-rs’s past year of commit activity
    Rust 5 Apache-2.0 322 0 0 Updated Oct 11, 2023
  • lm3s6965 Public Forked from japaric/lm3s6965

    A minimal device crate for the LM3S6965

    knurling-rs/lm3s6965’s past year of commit activity
    Rust 0 Apache-2.0 7 0 0 Updated Jul 20, 2023
  • groundhog Public Forked from jamesmunns/groundhog

    A rolling timer abstraction

    knurling-rs/groundhog’s past year of commit activity
    Rust 1 Apache-2.0 1 0 0 Updated Jul 13, 2023
  • rubble Public Forked from jonas-schievink/rubble

    (going to be a) BLE stack for embedded Rust

    knurling-rs/rubble’s past year of commit activity
    Rust 2 0BSD 56 0 0 Updated Jul 13, 2023
  • Knurling-companion-app Public

    Companion app with Vue.js + Tauri to visualise data sent by sensor.

    knurling-rs/Knurling-companion-app’s past year of commit activity
    Vue 4 2 0 0 Updated Jul 13, 2023