Zephyr Applications

Getting Started

You need mise installed. Everything else — Python, uv, cmake/ninja/ccache, Zephyr's remaining Ubuntu host deps (via apt), west, and the Zephyr SDK — is managed by the tooling.

First-time setup

git clone https://github.com/rosterloh/zephyr-applications
cd zephyr-applications
mise trust                   # trust this repo's mise.toml
mise bootstrap                # apt-install Zephyr's host deps + install [tools] (cmake, ninja, ccache, python, uv)
mise run sync                 # create .venv and install all Python tools (uv sync)
mise x -- pre-commit install  # install pre-commit hooks
mise run setup                 # west update (deps/) + Zephyr SDK toolchains

Building

Build any app against its default (or an explicitly allowed) board:

mise run app motor_controller                        # default: robotis_openrb_150
mise run app joystick_controller                     # default: adafruit_qt_py_esp32s3
mise run app rasprover --sysbuild                    # rasprover hw build + MCUboot
mise run app rasprover --board native_sim/native/64  # rasprover native_sim

Each app has an allowed-board list (see the app task in mise.toml); boards outside it are rejected.

Flashing

mise run flash motor_controller

Available tasks

mise tasks ls

Task	Description
setup	First-time workspace setup (west update + SDK install)
west-update	Fetch/update all west dependencies into deps/
sdk-install	Install Zephyr SDK toolchains for this project's targets
app <name> [--board <b>] [--sysbuild]	Build an app for its default (or an explicitly allowed) board
flash <name>	Flash a previously built app
agent-build <name> [--board <b>] [--sysbuild]	app with tail-truncated logs written to logs/
run-rasprover-sim	Run an already-built native_sim rasprover image
fmt	Format Python scripts with ruff

Repository layout

.
├── applications/       # Zephyr applications
├── boards/             # Out-of-tree board definitions
├── deps/               # West-managed dependencies (git-ignored)
├── scripts/            # Utility scripts
├── mise.toml           # Tool versions + task runner configuration
├── pyproject.toml      # Python dependencies (uv)
└── west.yml            # West manifest

Notes

• golioth and pouch are excluded until pouch adds full_name to its board.yml (required by the current Zephyr board schema). Re-enable in west.yml to restore Golioth support to bluetooth_proxy_device. rasprover has had Golioth removed and builds cleanly without it.
• pico_fw uses Zephyr's in-tree AIROC driver for the Pico W's CYW43439; the firmware blobs come from hal_infineon (fetched by mise run blobs-fetch).
• deps/ is git-ignored. Run mise run west-update to refresh after pulling changes to west.yml.