| name | build-system |
| description | Build system management for Zephyr RTOS. Covers West workspace initialization, manifest management, Sysbuild multi-image builds, Kconfig symbols, and CMake integration. Trigger when setting up workspaces, configuring builds, or troubleshooting build-time errors. |
Zephyr Build System
Efficiently manage the complex build and configuration stack of Zephyr RTOS.
Core Workflows
1. West Workspace & Manifests
Manage multi-repo projects and dependency allow-lists.
- Reference: west.md
- Key Tools:
west init, west update, west manifest --resolve, name-allowlist.
2. Kconfig Configuration
Tune software features and hardware parameters.
- Reference: kconfig.md
- Key Tools:
west build -t menuconfig, symbol searching (/), help (?).
3. Sysbuild & Multi-Image
Configure complex projects like MCUboot + Application.
- Reference: cmake.md
- Key Tools:
west build --sysbuild, sysbuild.conf.
4. CMake & Project Structure
Core build logic for applications and modules.
- Reference: cmake.md
- Key Tools:
CMakeLists.txt, zephyr_library(), target_sources().
Quick Start (Workspace + Build)
west init -m <manifest-repo-url> zephyr-workspace
cd zephyr-workspace
west update
west build -b native_sim samples/hello_world
Validation Checklist
Automation Tools
- find_modules.sh: Scan your
build/ directory to automatically identify which modules you should add to your manifest's name-allowlist.
Examples & Templates
Resources
- References:
west.md: West commands, manifests, and allow-lists.kconfig.md: Project configuration and menuconfig usage.cmake.md: Sysbuild and CMake API integration.
- Scripts:
find_modules.sh: Automated allow-list discovery utility.
- Assets:
west_manifest_template.yml: Base west manifest template.
