Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Development Environment

DevContainer

A DevContainer is provided in .devcontainer/. Open the repo in VS Code with the Dev Containers extension and choose “Reopen in Container”

Tip

probe-rs firmware deployments will not work on MacOS or Windows due to USB passthrough limitations with Docker Desktop.

On native Linux, USB passthrough can be enabled by uncommenting the relevant lines in .devcontainer/docker-compose.yml.

On MacOS and Windows, the firmware binary can be built inside of the dev container with task firmware:build and subsequently deployed using a local probe-rs install.

Local Install

Linux and MacOS are officially supported development platforms. Developing on Windows should be possible with some tinkering. If you would like to improve Windows support, please open a pull request.

Install the following tools:

ToolPurposeInstallation Method
rustcargo (package manager), rustc (compiler), rust-analyzer (language server)https://rustup.rs/
go-tasktask runnerhttps://taskfile.dev/installation/
uvpython package and project managerhttps://docs.astral.sh/uv/getting-started/installation/
nodebuild / run configuration webpage via typescript, vite, and sveltehttps://nodejs.org/en/download
probe-rsflash and debug embedded systemshttps://probe.rs/docs/getting-started/installation/
wasm-packused for TS - rust interopcargo install wasm-pack
mdBookdocumentation generatorhttps://rust-lang.github.io/mdBook/guide/installation.html