// Use when building rt-claw, choosing a platform target, running QEMU, flashing hardware, or debugging C/Meson/native build failures.
Use when adding CI coverage for a new rt-claw module, feature chain, endpoint backend, service integration, or regression.
Use when finding rt-claw definitions, call sites, subsystem ownership, build wiring, OSAL boundaries, or platform-specific implementations.
Use when analyzing rt-claw build logs, QEMU output, serial monitor logs, CI failures, network/API failures, or boot/runtime crashes.
Use when rt-claw behavior, APIs, configuration, build commands, platforms, or developer workflows change and documentation may need synchronization.
Use when adding a new rt-claw service, driver, tool, platform helper, platform port, or RTOS backend.
Use when reviewing rt-claw changes for OSAL boundary violations, RTOS coupling, platform leakage, driver layering, or portability risks.
| name | rt-claw-build |
| description | Use when building rt-claw, choosing a platform target, running QEMU, flashing hardware, or debugging C/Meson/native build failures. |
| license | MIT |
Use the repository Makefile before inventing ad hoc commands. Meson builds
the platform-independent libraries; each platform target then uses its native
build system when needed.
| Task | Command |
|---|---|
| Linux native build | make build-linux |
| Linux native run | make run-linux |
| Unit tests on Linux | make test-unit-linux |
| ESP32-C3 QEMU build | make build-esp32c3-qemu |
| ESP32-C3 QEMU run | make run-esp32c3-qemu |
| ESP32-C3 devkit build | make build-esp32c3-devkit |
| ESP32-C3 xiaozhi-xmini build | make build-esp32c3-xiaozhi-xmini |
| ESP32-C3 xiaozhi-xmini flash | make flash-esp32c3-xiaozhi-xmini |
| ESP32-S3 QEMU build | make build-esp32s3-qemu |
| ESP32-S3 hardware build | make build-esp32s3 |
| ESP32-S3 hardware flash | make flash-esp32s3 |
| vexpress-a9 QEMU build | make vexpress-a9-qemu |
| Zynq-A9 QEMU build | make build-zynq-a9-qemu |
| Zephyr Cortex-M3 QEMU build | make build-zephyr-cortex-m3-qemu |
| Zephyr Cortex-A9 QEMU build | make build-zephyr-cortex-a9-qemu |
| Style check | scripts/check-patch.sh --staged |
GDB=1 to QEMU run targets to start in debug mode on port 1234.GRAPHICS=1 to ESP32 QEMU run targets when an LCD window is needed.platform/linux/, osal/linux/, or unit tests -> make build-linuxplatform/esp32c3/ or Espressif C3 drivers -> make build-esp32c3-qemuplatform/esp32s3/ or shared Espressif changes -> make build-esp32s3-qemuplatform/vexpress-a9/ or osal/rtthread/ -> make vexpress-a9-qemuplatform/zynq-a9/ or osal/freertos/ -> make build-zynq-a9-qemuplatform/zephyr/ or osal/zephyr/ -> a Zephyr QEMU build targetesp32c3, esp32s3,
vexpress, zynq, or zephyr.make build-linux for the fastest compile check.git status -sb.CLAUDE.md for current platform commands before changing a command.scripts/check-patch.sh --staged before committing staged C changes.claw/, include/, osal/, drivers/, or
build-system files.scripts/check-patch.sh --staged, but do not
hide the build result behind style output.build/ artifacts out of commits.