Implementing a Matter Wi-Fi Light Bulb on Raspberry Pi Pico 2 W with Rust

The Raspberry Pi Pico 2 W (RP2350) can be used to create a fully compliant Matter smart device using the Rust programming language. By leveraging the rs-matter stack and the Embassy async framework, developers can implement a local-only smart home device that integrates directly with Apple Home, Google Home, and Home Assistant without requiring cloud accounts.

Matter Integration on RP2350

Implementing a Matter-compatible Wi-Fi light bulb on the Pico 2 W allows for seamless provisioning via Bluetooth Low Energy (BLE) and network connectivity via Wi-Fi. The device exposes a standard Matter On/Off cluster to toggle a physical LED wired to the GPIO pins.

Technical Implementation Details

Building a Matter device on bare metal requires specific handling of hardware and concurrency:

  • Bare Metal Execution: The project runs entirely no_std on bare metal using embassy-rp.
  • Radio Coexistence (CoEx): The CYW43439 wireless chip must handle concurrent BLE for commissioning and Wi-Fi for Matter IP traffic. This requires an async CoEx runner to safely multiplex the radio between the two stacks.
  • Clock Speed Adjustments: To prevent bus corruption when the radio is saturated, the PIO SPI clock divider must be dialed back to account for the RP2350's faster 150MHz core clock.

Provisioning Process

Provisioning a Pico 2 W Matter device into an ecosystem like Home Assistant involves the following steps:

  1. Advertising: The device begins advertising over BLE once flashed.
  2. Integration: The user adds a Matter device through the Home Assistant companion app.
  3. Authentication: The user enters a setup code (e.g., 3497-0112-332) or scans a QR code.
  4. Connectivity: Home Assistant transmits Wi-Fi credentials over BLE, and the device connects to the network as a standard light bulb.

Additional Raspberry Pi Pico 2 Rust Examples

Beyond Matter integration, the rust-rpico2-embassy-examples repository provides a variety of hardware interface examples using the Embassy async framework.

I2C and SPI Peripherals

  • HS3003 Sensor: Reads temperature and humidity using I2C0.
  • ADXL345 Accelerometer: Reads 3-axis accelerometer data over I2C0.
  • TFT LCD Display: The zermatt and zermatt_snow examples demonstrate SPI display capabilities. The snow animation utilizes a physics engine and an off-screen lcd-async framebuffer dispatched via DMA to avoid blocking the CPU.

1-Wire Protocol Implementation

Implementing timing-sensitive protocols on the RP2350's Cortex-M33 core requires precise timing control:

  • DS18B20: A waterproof temperature sensor that uses a custom, cycle-accurate PreciseDelay implementation to ensure jitter-free sub-microsecond timing.
  • DHT11: A low-cost temperature and humidity sensor. Due to the timing sensitivity of the bit-read phase, this example must be run in release mode to function correctly.

Community Insights and Perspectives

Developers discussing the project highlight the evolving state of embedded Rust and the Matter protocol:

"If you’ve been wanting to build local-only smart home devices but felt intimidated by the massive official C++ Matter SDK, doing it in Rust is actually becoming incredibly approachable."

Other contributors noted that while the Matter protocol is powerful because it is IP-based, the searchability of technical documentation for Thread and Matter remains a challenge. There is also a noted distinction between "ultra-low power" components and devices that are truly suitable for coin-cell battery operation, particularly when Wi-Fi modules are involved.

Sources