v2.3.2
Matter Extension v2.3.2-1.3 Release Notes
Silicon Labs Matter Simplicity SDK Extension v2.3.2-1.3
This release is only supported for use with Simplicity Studio. Standalone GitHub builds using Ninja are not supported.
Documentation can be viewed at: docs.silabs.com/matter/2.3.2
Releases notes may be truncated on GitHub. Full text can be found: github.com/SiliconLabs/matter_extension/releases/tag/v2.3.2
Versions
These versions are automatically included with our Matter release, listed here for informational purposes only.
- Matter: v1.3 (5bb5c9e)
- Simplicity SDK: v2024.6.2
- GCC compiler version: 12.2.1
- Thread
- Silicon Labs OpenThread: v2.5.1.0 (1fceb225b)
- ot-br-posix (e56c02006)
- Wi-Fi
Features
This is the Silicon Labs Matter v2.3.2-1.3 release, which provides the functionality to build Matter applications in the Simplicity Studio environment. This release is intended for developers who wish to run a Matter Demo over Thread (15.4) or Wi-Fi, and also manually build examples through Simplicity Studio, SLC-CLI or Visual Studio Code.
This release is certifiable to the Connectivity Standards Alliance (CSA) Matter 1.3 certification program (https://csa-iot.org/) for Thread (MG24 / MG26), Wi-Fi 917 SoC and NCP platform (MG24/WF200).
This release supports only series 2 devices. Series 3 will come in a future release. Use v2.2.x-1.2 for series 1 devices.
- To get started, download Simplicity Studio from the following link: https://www.silabs.com/developers/simplicity-studio, and install Simplicity SDK v2024.6.2 along with Silicon Labs Matter v2.3.2. For SiWx917, install WiSeConnect v3.3.3 as well.
Highlights of this release
- Quality-tested Matter 1.3 GA solution for Thread MG24 / MG26, Wi-Fi SiWx917 SoC and DevKit (BRD2605A), Wi-Fi MG24/WF200, Wi-Fi SiWx917 NCP and Wi-Fi MG24/RS9116 (non-sleepy) platforms. Beta solution for Wi-Fi MG24/RS9116 (sleepy) platforms.
- Works with Simplicity SDK v2024.6.2 and WiSeConnect SDK v3.3.3.
- BRD4342A PSRAM board support is enabled for all the Matter Wi-Fi applications - beta quality.
- Miscellaneous bug fixes and improvements.
Issues fixed in this release
- Installing the OpenThread Certification Libraries component in a Matter Studio project results in "error: unused parameter" compilation errors. (UID: 1326566)
- Matter ICD cannot sleep with SiSDK 2024.6.1. (UID: 1344132)
- A hard fault on the door lock sample app on MG26, MGM240, etc.
- A different hard fault with the lighting app and an MG24 board.
- Wi-Fi 917 NCP commissioning and sleepy fixes.
General
- Quick-start guides are provided for running pre-compiled demos and for building examples manually.
- The Developer's Guide provides information on various technical topics.
Thread
In order to run Matter over Thread, a developer must have at least two Silicon Labs EFR-based devices and a Raspberry Pi with a >32 GB SD Card.
Thread support in Simplicity Studio for the following boards:
- MG24 boards:
- BRD4186C / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@10dBm - xG24-RB4186C
- BRD4187C / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@20dBm - xG24-RB4187C
- BRD2601B / MG24 Developer Kit - xG24-DK2601B
- BRD2703A / MG24 Explorer Kit - xG24-EK2703A
- BRD2601B / MG24 Developer Kit- Thunderboard Sense 2
- MGM24 boards:
- BRD4316A / SLWSTK6006A / Wireless Start Kit / 2.4GHz@10dBm - xGM240-RB4316A
- BRD4317A / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm - xGM240-RB4317A
- BRD4318A / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm - xGM240-RB4318A
- BRD4319A (Rev A00 only) / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm
- BRD2704A / Sparkfun Thing Plus MGM240P
- BRD4337A / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@20dBm - xGM240-RB4337A
- MG26 boards
- BRD4116A
- BRD4117A
- BRD4118A
- BRD2608A
Thread support in Simplicity Studio for the following applications:
- Light
- Light Switch
- Lock
- Window Covering
- Thermostat
- OnOff Plug
- Sensor
- Dishwasher
- Air Quality Sensor
Wi-Fi
In order to run Matter over Wi-Fi, a developer must have the following hardware:
- Silicon Labs Wireless starter/development kit which is mentioned below
- Raspberry Pi with a >32 GB SD Card
Wi-Fi support for the following boards:
- SoC mode:
- SiWx917-PK6031A - SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit
- SiWx91x-RB4342A - SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash + 8 MB ext PSRAM Radio Board with an internal RF switch - beta quality
- SiWx917-DK2605A - SiWx917 Wi-Fi 6 and Bluetooth LE Dev Kit
- NCP mode:
- Host Processor:
- xG24-RB4186C - EFR32xG24 Wireless 2.4 GHz +10 dBm Radio Board (EFR32 radio board)
- xG24-RB4187C - EFR32xG24 Wireless 2.4 GHz +20 dBm Radio Board
- Silicon Labs Wi-Fi Processor:
- RS9116X EVK1 Wi-Fi + Bluetooth Dev Kit - RS9116X-SB-EVK1 / RS9116X-SB-EVK2 / RS9116X-DB-EVK1
- SiWx917-EB4346A - SiWx917 Wi-Fi 6 and Bluetooth LE Co-processor EXP Expansion Kit.
- SLEXP8022A - WF200 Wi-Fi Expansion Kit.
- Host Processor:
Note: Firmware for RS9116, SiWx917 NCP & SiWx917 SoC can be found in the Matter Software Artifacts page in the documentation or Assets section of this page.
Wi-Fi support in Simplicity Studio for the following applications:
- SoC supported applications:
- Light
- Lock
- Light Switch
- Window Covering
- On/Off plug
- Thermostat
- Dishwasher
- Air Quality Sensor
- Sensor
- Dev Kit Supported applications:
- Light
- Lock
- Dishwasher
- NCP supported applications:
- Lock
- Thermostat
- Window Covering
- Note: SiWx917 NCP is the only device combination which supports Window Covering App.
Wi-Fi ICD support for the following applications:
- Lock (ICD is enabled by default)
- With chip-tool
- With EFR32xG24 with RS9116, WF200, SiWx917 NCP, SiWx917 SoC
- Window Covering
- With chip-tool
- With EFR32xG24 with SiWx917 NCP, SiWx917 SoC
- Thermostat
- With chip-tool
- With EFR32xG24 with RS9116, WF200, SiWx917 NCP
- Light Switch
- With chip-tool
- With SiWx917 SoC
Reference guide to enable the sleepy functionality for Wi-Fi: Wi-Fi ICD
Wi-Fi changes in this release:
- Adds Matter support for WiSeConnect 3.3.3 SDK on SiWx917 SoC, DevKit (BRD2605A) & SiWx917 NCP boards.
- BRD4342A PSRAM board support is enabled for all the Matter Wi-Fi applications.
Wi-Fi supported in this release:
- Wi-Fi Mixed and Transition Modes of AP connection security modes. Wi-Fi Mixed Mode is enabled by default.
- Certificate Provisioning 2.0 for Matter Device Attestation Credentials on SiWx917 SoC.
- Supports SiWx917 SoC 1.8 MB Common flash board variants - BRD4338A and BRD2605A
- Supports SiWx917 SoC 1.8 MB Common flash board variants (8 MB ext PSRAM support, with an internal RF switch) - BRD4342A
- Supported OTA functionality on SiWx917 SoC.
- Supported OTA (M4 image only) functionality on SiWx917 NCP.
- Supported LCD functionality on SiWx917 SoC and SiWx917 NCP.
- Supported ICD functionality on SiWx917 SoC & NCP devices.
Wi-Fi not supported in this release:
- SiWx917 SoC 1.6 MB Common flash board variants are no longer supported.
- Note: Please contact Silicon Labs for converting 1.6MB to 1.8MB mode.
- External Flash on EFR32xG24 with RS9116 or SiWx917 (planned in a future release).
- OTA Update with Internal Flash on EFR32xG24 with WF200.
- Connection to APs using Enterprise security modes (only Personal WPAx security modes are supported).
- Connection to APs from WF200 using WPA3 security mode.
Ecosystems -
This release has been tested and proven to work for commissioning and control with the following Ecosystems on the hardware and software versions listed below:
Silicon Labs Device | Application | Hub | Phone | App Software | Wi-Fi Access Point | |
---|---|---|---|---|---|---|
Thread | BRD4187C EFR32MG24 | lighting-app |
Hardware: Google Nest Hub Gen 2 Software: Hub Software Version: 54.103.7.577294944 |
Hardware: Pixel 5a Software: Android version 14 |
Google Home version: 3.18.1.4 |
Eero AP Asus_Ax3000 NETGEAR44 |
Wi-Fi |
BRD4338A BRD4342A |
lighting-app, on-off app, lock-app, window-app |
Software: Hub Software Version: Chromecast 3.74.419799
|
Software: Android version 12
|
|
|
Apple
Silicon Labs Device | Application | Hub | Phone | App Software | Wi-Fi Access Point | |
---|---|---|---|---|---|---|
Thread | BRD4187C EFR32MG24 | lighting-app, lock-app |
Hardware: Apple TV Model MXH02LL/A Software: 17.4 |
Hardware: iPhone 11 Software: 17.5.1 |
Apple Home version: 17.5.1 |
Eero AP Asus_Ax3000 NETGEAR44 |
Wi-Fi |
BRD4338A BRD4342A |
lighting-app, on-off app, lock-app, window-app |
|
|
|
|
Amazon
Silicon Labs Device | Application | Hub | Phone | App Software | Wi-Fi Access Point | |
---|---|---|---|---|---|---|
Thread | BRD4187C EFR32MG24 | lighting-app |
Hardware: Amazon Echo 4th Gen Software: Hub Software Version:10369673092 |
Hardware: Pixel 5a Software: Android version 14 |
Alexa version: 2.2.572499 |
Eero AP Asus_Ax3000 NETGEAR44 |
Wi-Fi |
BRD4338A BRD4342A |
lighting-app, lock-app, window-app |
Hardware: Amazon Echo 4th Gen Software: Hub Software Version: 10705249412
|
Hardware: OPPO Reno CPH1919 Software: Android version 12
|
Alexa version: 2.2.589086
|
ASUS (Model: XT8)
|
Samsung
Silicon Labs Device | Application | Hub | Phone | App Software | Wi-Fi Access Point | |
---|---|---|---|---|---|---|
Thread | BRD4187C EFR32MG24 | lighting-app, lock-app |
Hardware: SmartThings Station Software: Hub Software Version: 000.052.00009 Hardware: Charging Hub Software Controller version: 1.0.15-5 |
Hardware: Pixel 5a Software: Android version 14 |
SmartThings Version: 1.7.19.19 |
Eero AP Asus_Ax3000 NETGEAR44 |
Wi-Fi |
BRD4338A BRD4342A |
lighting-app, on-off app, lock-app, window-app |
Software: Hub Software Version: 000.053.00019
|
Software: Android version 12
|
|
|
Known Issues
General
- On some EFR32 boards the RTT logs might not display correctly. The workaround is to use the "-device EFR32MG12PXXXF1024" and "-if SWD" parameters when invoking JLinkExe.
- The Matter device images require approximately 700k in flash space. As a result only a subset of EFR32MG2x devices are supported. For a complete list of devices supported consult the documentation located at Matter Hardware Requirements.
- Matter SDK Issues (https://github.com/project-chip/connectedhomeip)
- BLE Connection/Timeout error occurs occasionally during commissioning with the chip-tool running on Raspberry Pi or Linux (project-chip#16178). Running on these platforms requires an access point with both 2.4 GHz and 5 GHz capabilities. There is BLE-Wi-Fi interference when connected over the 2.4 GHz channel. This is resolved by connecting the chip-tool device to a 5 GHz SSID and the end device to a 2.4 GHz SSID for the same Wi-Fi network.
- An upgrade of an existing Studio project from Matter 2.2.2-1.2 or earlier to the current version of the extension is not supported.
- In some rare cases a Simplicity Studio project build may fail due to missing files in the
zap-generated/
directory (e.g. "gen_config.h not found").- Workaround: Delete the
.zap
folder in the home directory.
- Workaround: Delete the
- The Simplicity Studio project upgrade dialog can be exited only by closing the project tab (clicking on the "x" button in the top right corner).
- Incorrect state error sometimes while commissioning another fabric.
- Window App device goes offline after commissioning with the Apple Ecosystem.
- Unbolt feature is not supported via the ecosystems like Amazon Alexa but it is supported by our device default due to which Unlock with these Ecosystem will fail. To disable unbolt feature, the feature bit for the DoorLock Cluster should be update from 0x1DB3 to 0xDB3.
- Due to an electrical issue on the WPK main boards (BRD4002x), sometimes the current measurement value reported is wrong in the Energy Profiler, making it seem like an ICD is not going to sleep properly even though it is. This issue does not happen when using a WSTK (BRD4001x). (UID: 1197733 & 1228823).
- The configuration parameters for the internal storage bootloader used in the OTA software updates must always be custom-configured based on the actual image size for the given application. See https://docs.silabs.com/matter/2.3.2/matter-ota/01-ota-bootloader.
- If the user modifies the discriminator in
CHIProjectconfig.h
, the modified discriminator is not updated in QR code.
Thread
- Silicon Labs has provided a complete image file for the Raspberry Pi that can be flashed onto an SD card to create the "Matter Hub", which is a Raspberry Pi running Ubuntu and includes a pre-built version of the Open Thread Border Router (OTBR) and chip-tool. The image we have provided is quite large, ~2 GB. As a result it can take quite a while to download the .zip file and flash it onto an SD card. Depending on your connection the process could take up to half an hour. Regardless, the demo and development experiences using this pre-built image is a much faster process than building the Matter Hub from scratch.
- The Matter Zigbee sequential CMP app does not properly disconnect/shutdown the Zigbee network once it joined the Matter/Thread network.
- Matter attestation credentials can conflict with Lockbits in Series 2, requiring moving the location of the attestation credentials when lockbits are used. Please see the guide Moving the Matter Attestation Credentials on Series 2 (MG24) for details. (UID: 1235425)
Wi-Fi
- In high traffic Environment, mDNS timeout is seen with BRD4338A, BRD4342A, BRD2605A, 9116 NCP and SiWx917 NCP.
- In high-traffic environment, sometimes command timeouts are seen as the processing of the command takes more than 20 seconds for sleepy apps.
- The following issues are observed on SiWx917 SoC:
- The BRD4342A PSRAM support is enabled only for the text segment; it is not working for the data segment.
- Apple ecosystem commissioning fails with BRD4342A PSRAM Board.
- Amazon ecosystem Commissioning fails with the lock app on BRD4342A PSRAM Board.
- OTA upgrade and factory reset doesn't not work if Jlink is connected, a manual reset is needed. We recommend to use UART.
- Observed CASE session timeout rarely during sigma packet transaction while sending a unicast command with the Lock Sleepy app, which sometimes results in a resource busy error from the device (until the device commissioning times out).
- When Sleepy is enabled, Jlink gets disconnected resulting in RTT logging issue. In order to capture logs during sleepy, enable UART on serial terminal.
- The P37 pin should be pulled up to enable the Matter shell for sleepy applications.
- Stability issue with the Thermostat application during command processing.
- Sometimes the SiWx917 might not work properly with commander, but with the latest commander (v1.16.11), this issue is not observed. Steps to recover the board are provided below:
export WSTK_IP=<WSTK_IP> commander device info --ip $WSTK_IP --device SiWG917M111MGTBA commander adapter reset --ip $WSTK_IP commander device masserase --ip $WSTK_IP --device SiWG917M111MGTBA commander adapter reset --ip $WSTK_IP commander manufacturing erase userdata --ip $WSTK_IP --device SiWG917M111MGTBA commander adapter reset --ip $WSTK_IP commander flash <path-to-rps> --ip $WSTK_IP --device "SiWG917M111MGTBA" commander rtt connect --noreset --ip $WSTK_IP --device SiWG917M111MGTBA | tee dut.log
- The following issues are observed on RS9116 EVK:
- Intermittent Init failures are observed after resetting the device.
- When LCD is enabled, in order to reset the device properly, reset button to be pressed until the Silabs logo appeared on the LCD.
- RSI Send failure sometimes occurs within 1 hour of commissioning with the RS9116 EVK with Apple/Google Home. To recover from this issue, try one of the following:
- Reboot the device and wait for 5-10 minutes, or
- Erase the flash, re-flash the application and repeat commissioning.
- In EFR32MG24+WF200 device combination, WF200 Firmware exception is observed when both ICD and matter shell is enabled. In order to make matter shell to work for Lock application with this device combination, ICD is disabled.
- The external bootloader should not be used with the EFR32MG24+RS9116/SiWx917NCP device combination. Only use the internal bootloader.
- OTA Update: sometimes boot loading with latest image does not work with WF200 with EFR32xG24 device combination. This issue is resolved by applying the workaround described in the Matter Wi-Fi FAQ.
- Commissioning fails with an "out of memory" error when an OpenThread device in the same network was added using an Apple HomePod Mini.
- Group commands only work for some specific access points when IGMP snooping is disabled.
- When setting up the Ozone Debugger on Mac the location of the JLinkDevices.xml file has moved, Follow this documentation in order to place it in the proper location.
- RS9116 and WF200 apps do not build with VS Code as generator.
- Provisioning on the SiWx917 boards requires version 1.16.12 of the Simplicity Commander.