$ show NabuCasa/silabs-firmware-builder
This repository is a firmware build system for Silicon Labs wireless chips (EFR32, MGM210) used in Home Assistant hardware (SkyConnect, Yellow, ZBT-2, ZWA-2). It provides a Python-based CLI tool (`tools/build_project.py`) that reads YAML manifests, generates projects using the Silicon Labs Configurator (slc), applies SDK patches, compiles with GCC or LLVM, and produces signed/encrypted GBL firmware images. The repo also includes a multi-stage Dockerfile for reproducible builds, CI/CD pipelines, and a set of custom firmware extensions (LED effects, accelerometer driver, watchdog, Zigbee XNCP commands, Z-Wave Serial API commands) that demonstrate high-quality embedded engineering patterns such as priority-based LED management, temporal dithering for WS2812 LEDs, linker-wrapping for stack fixes, and Jinja-templated command dispatchers. The build system is well-architected with attention to reproducibility, LTO handling, and validation of linker wraps. While the firmware extensions are specific to NabuCasa hardware, many patterns are reusable in other Silicon Labs projects.
The LLM identified 8 files worth highlighting for reuse:
High-performance WS2812 addressable RGB LED driver using SPIDRV. Implements temporal dithering for 16-bit color precision, precomputed lookup tables for bit patterns, and a reset signal. The driver is self-contained, uses a context struct for state, and can be reused in any Silicon Labs project requiring WS2812 LEDs.
Priority-based LED manager with support for multiple layers (background, manual, notification, critical). Each layer can have a pattern (off, static, blink, pulse) with configurable timing and auto-expiry. Uses a sleeptimer for periodic updates and critical sections for thread safety. Reusable pattern for any embedded system needing multi-priority LED control.
Overrides the weak default callback for Zigbee Dynamic Link Key (DLK) negotiation to fix a join issue where the trust center commits to install-code negotiation without a fallback. Only negotiates when a transient key is provisioned for the joiner's exact EUI64, otherwise returns an error to fall back to well-known-key transport. Self-contained, demonstrates deep understanding of Zigbee stack internals.
Jinja template that auto-generates an XNCP command dispatcher from component contributions. Iterates over command tables and feature flags to produce `xncp_get_supported_features()` and `xncp_dispatch_command()`. Reusable pattern for extensible firmware frameworks where multiple components register handlers.
Hardware watchdog (WDOG0) for bare-metal superloop with warning interrupt routed to the crash collector. The warning fires at 75% of the timeout, capturing the stuck PC and stack before reset. Uses `naked` attribute to preserve exception frame. Demonstrates advanced embedded reliability patterns.
Wraps `sl_token_manager_get_data` to invert the last 6 octets of the EUI64 at the earliest possible point. Prevents conflicts when a former Zigbee coordinator is reused as a router. Clever use of linker wrapping to modify token data transparently.
Compatibility shim that reimplements the Z-Wave SDK's LDMA_IRQHandler on top of DMADRV, allowing I2C and SPI drivers to function alongside the Z-Wave stack. Uses linker wrapping to intercept both the IRQ handler and the ZPAL UART transmit start function. Demonstrates deep platform integration knowledge.
Implements a suite of common XNCP commands for Zigbee coordinators: manual source route management, route table access, MFG token overrides, build string, flow control type, chip info, TX power per country, and combined unicast send. Well-structured command table pattern with clear handler functions. Reusable as a reference for custom EZSP extensions.