Rust Embedded BLE sensor tutorial

How to?

bike-sensor directory has the book. To read the book, you will need to:

1. install Rust
2. install mdbook
3. Go in the directory and serve the book:

cd book
mdbook serve

The code directory has the code that is discussed in the book.

What is inside?

This tutorial is an OSS project built with present and former colleagues at Ferrous Systems, started back in 2021. It was formerly a part of Knurling-rs, Ferrous systems open source project to improve Rust embedded tooling.

It provides step-by-step instructions and reference materials to build a Rust distance sensor with BLE and use Rust embedded beloved frameworks, RTIC and Embassy. It including a glossary, links to purchase the hardware, and relevant articles to help you dig deeper into the subject. We also include troubleshooting pages to help with common problems when setting up projects. Everything is open source and freely available.

Rust Embedded ecosystem keeps evolving, and this tutorial is a light introduction to the RTIC and Embassy frameworks.

Below is a brief outline:

The BLE Bike sensor 🚴🏽‍♀️

This tutorial starts with a simple application to send data to both a computer and a phone on bluetooth. We do it first using the simplest Rust embedded approach "don't-do-it-at-home" (Part One), then with RTIC and preemtive-concurrency (Part Two), and finally with Embassy and embedded async-await (Part Three), to learn about Rust embedded frameworks. We hope you will apply this knowledge on Embassy and RTIC to your own projects!

Bill of material

• nRF52840-DK
• HC-SR04 sensor
• Breadboard, resistors, jumper wires and a USB data cable.

Thanks!

Thanks to colleagues and friends, who opinionatedly rewrote, added their two pennies, many grains of salt and always tons of knowledge. If I forgot you, please ping! In order of participation, but not importance:

James Munns @OneVariable, Henrik -Henke- Alsér @kalkyl, Tanks Transfeld @Mirabellensaft, Sebastian Ziebell @justahero, Johann Hemmann @Urhengulas, Brigitte Markman @BriocheBerlin, Jonathan -JP- Pallant @jonathanpallant. Last but not least, our fabulous linguists reviewers Sabine Devins-Swift @sabine-devins, and Jessie Glockner @JBG89.