Skip to content

v2.2.1
Compare
Choose a tag to compare
@rerasool rerasool released this 10 Apr 17:46
· 6 commits to main since this release
v2.2.1
ec07c87

Silicon Labs Matter Extension v2.2.1-1.2

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.2.1

Releases notes may be truncated on GitHub. Full text can be found here: github.com/SiliconLabs/matter_extension/releases/tag/v2.2.1

Versions

These versions are automatically included with our Matter release, listed here for informational purposes only.

  • Matter: d140d5c8775
  • Gecko SDK: v4.4.2
  • Thread
  • Wi-Fi
    • WiSeConnect 3 SDK: v3.1.4 (SiWx917 SoC, SiWx917 NCP)
    • WiSeConnect SDK: v2.8.2 (RS9116)
    • WF200 does not use WiSeConnect SDK, it uses Gecko SDK components

Features

This is the Silicon Labs Matter v2.2.1-1.2 GSDK extension 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.2 certification program (https://csa-iot.org/) for Thread (MG12, MG24) and Wi-Fi NCP platform (MG24/WF200).

This release will provide long-term support for series 0/1 devices. Going forward, future releases will only support series 2/3 devices.

Highlights of this release

  • Works with Gecko SDK v4.4.2 and WiSeConnect SDK v3.1.4.
  • Provides Matter Solutions functionality for all sample applications. Example-only project generation has been removed to simplify user options.
  • Adds support for custom clusters in Matter Studio projects – simply add the cluster XML file through the "Extensions" menu in ZAP.
  • Enables LCD and OTA support (M4 image only) for MG24+SiWx917 NCP.
  • Miscellaneous bug fixes and improvements.

Issues fixed in this release

  • Custom attributes do not have initialization code generated by ZAP tool. (UID:1243502)
  • boot-count attribute correctly resets to 0 after factory reset. (UID:1275507)
  • Increased power consumption on sensor and on-off plug ICD devices. (UID:1264649)
  • Ability to use OT certified libraries with ICD devices. (UID:1249392)
  • Compilation error building with Segger System View component. (UID:1247565)
  • CPMS flashing issue on SiWx917 SoC. (UID:1276713)
  • Reporting HardwareAddress and IP addresses via diagnostic cluster. (UID:1264801)
  • Removal of std duplication. (UID:1258834)
  • WI-FI FreeRTOS assert in init/de-init loop. (UID:1234004)
  • Low power server generation build compilation error. (UID:1264800)
  • Sensor app refactor. (UID:1234309)
  • SiWx917 SoC sleep functionality while uncommissioned. (UID:1247796)
  • GCC makefile project generation issues. (UID:1213420)
  • Security test mode commissioning failure. (UID:1225096)

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:

  •  MGM24 boards:

    • BRD4316A / SLWSTK6006A / Wireless Start Kit / 2.4GHz@10dBm
    • BRD4317A / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm
    • BRD4318A / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm
    • BRD4319A (Rev A00 only) / SLWSTK6006A / Wireless Starter Kit/ 2.4GHz@20dBm
    • BRD2704A / Sparkfun Thing Plus MGM240P 
    • BRD4337A / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@20dBm

  • MG12 boards:

    • EFR32MG12 Development Kit
    • BRD4161A / SLWSTK6000B / Wireless Starter Kit / 2.4GHz@19dBm
    • BRD4162A / SLWSTK6000B / Wireless Starter Kit / 2.4GHz@10dBm
    • BRD4163A / SLWSTK6000B / Wireless Starter Kit / 2.4GHz@19dBm
    • BRD4164A / SLWSTK6000B / Wireless Starter Kit / 2.4GHz@19dBm
    • BRD4170A / SLWSTK6000B / Multiband Wireless Starter Kit / 2.4GHz@19dBm, 915MHz@19dBm
    • BRD4166A / SLTB004A / Thunderboard Sense 2 / 2.4GHz@10dBm

Thread support in Simplicity Studio for the following applications:

  • Light
  • Light Switch
  • Lock
  • Window Covering
  • Thermostat
  • OnOff Plug
  • Sensor
  • Dishwasher

Wi-Fi

In order to run Matter over Wi-Fi, a developer must have the following hardware:

  • Silicon Labs Wireless starter/development kit (WSTK)
  • Silicon Labs Wi-Fi development kits & boards
    • For SiWx917 SoC variants, an SiWx917 SoC Common flash boards (refer to the board details below).
    • For Network Co-Processor (NCP) variants
      • Silicon Labs EFR32 - is used as a host processor and, with the WF200, provides Bluetooth LE capabilities
      • Silicon Labs Wi-Fi Processor
        • RS9116 development kit
        • WF200 expansion board
        • SiWx917 NCP expansion board
  • Raspberry Pi with a >32 GB SD Card

Wi-Fi support in Simplicity Studio for the following boards:

  • SiWx917 SoC Mode:
  • SiWx917 NCP Mode:

    • MG24 boards:

      • BRD4186C / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@10dBm
      • BRD4187C / SLWSTK6006A / Wireless Starter Kit / 2.4GHz@10dBm

    • Wi-Fi Dev Kit

      • RS9116
      • SiWx917
        • EB4346A
      • WF200
        • WF200 / Single Band Wi-Fi Expansion Board / 2.4GHz
        • WFM200S / Single Band Wi-Fi Expansion Board / 2.4GHz
      • Interconnect board (included in the Wi-Fi kits)
      • SPI Cable (included in the RS9116 kit)
      • Jumper Cables (included in the RS9116 kit)

Wi-Fi support in Simplicity Studio for the following applications:

  • Light
  • Lock
    • Note: By default, M4 is active and the TA will be in sleep mode for SiWx917 SoC devices. Please refer to the configuration options in the Wi-Fi changes in this release section.
  • Light Switch  
    • Note: This App is supported for SiWx917 SoC devices only.
  • Window Covering
  • On/Off plug
  • Thermostat
  • Dishwasher
  • Sensor
    • Note: This app is supported for SiWx917 NCP device combinations only.

Wi-Fi ICD support for the following applications:

  • Lock
    • With chip-tool
    • With EFR32xG24 with RS9116, WF200, SiWx917 NCP, SiWx917 SoC
  • Window Covering
    • With chip-tool 
    • With EFR32xG24 with RS9116, WF200, SiWx917 NCP, SiWx917 SoC
  • Thermostat
    • With chip-tool
    • With EFR32xG24 with RS9116, WF200 and 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.1.4 SDK on SiWx917 SoC & NCP boards.
  • Enabled LCD support for MG24+SiWx917 NCP device combinations.
  • Enabled OTA (M4 image only) support for MG24+SiWx917 NCP device combinations.
  • Added configuration to override SiWx917 SoC M4 sleep mode:
    • By default, M4 is active and TA will be in sleep mode. This configuration provides high stability.
    • To enable both M4 and TA sleep modes, need to add matter_siwx917_m4_sleep component.

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 supported in this release:

  • Networks with up to 12 devices including up to 6 IoT devices, and a single EFR-9116 or EFR-WF200 or EFR-SiWx917 NCP mode device combination.
  • Wi-Fi Mixed and Transition Modes of AP connection security modes. Wi-Fi Mixed Mode is enabled by default.
  • Certificate Provisioning 1.0 for Matter Device Attestation Credentials on SiWx917 SoC.
  • Supports SiWx917 SoC 1.8 MB Common flash board variants - BRD4338A
  • Supported OTA functionality on SiWx917 SoC.
  • Supported OTA (M4 image only) functionality on SiWx917 NCP.
  • Supported LCD functionality on SiWx917 SoC & NCP devices.
  • Supported ICD functionality on SiWx917 SoC & NCP devices.

Wi-Fi not supported in this release:

  • SiWx917 SoC 1.6 MB Common flash board variants - BRD4338A 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:

Google

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: SiWx917 SoC
      • App: lighting-app, lock-app, window-app
  • Google Hub:
    • Thread:
      • Hardware: Google Nest Hub Gen 2
      • Software: Hub Software Version: 54.103.7.577294944
    • Wi-Fi:
      • Hardware: Google Nest Hub, Model : GUIK2
      • Software: Hub Software Version: Chromecast 3.71.396338
  • Phone
    • Thread:
      • Hardware: Pixel 5a
      • Software: Android version 14
    • Wi-Fi:
      • Hardwar: Xiaomi 5G
      • Software: Android version 13
  • App Software:
    • Thread:
      • Google Home version: 3.10.1.6
    • Wi-Fi:
      • Google Home version: 3.15.1.4
  • Wi-Fi Access Point:
    • Thread
      • Eero AP
      • Asus_Ax3000
      • NETGEAR44
    • Wi-Fi:
      • ASUS (Model : XT8 )

Apple

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: SiWx917 SoC
      • App: lighting-app, lock-app, window-app
  • Apple Hub:
    • Hardware: Apple Home Pod Mini
    • Software: 16.5.1 (Thread)
    • Software: 17.4 (21L227) (Wi-Fi)
  • Phone:
    • Thread:
      • Hardware: iPhone SE
      • Software: 16.1.1
    • Wi-Fi:
      • Hardware: iPhone 15 Pro
      • Software : 17.3.1
  • App Software:
    • Thread:
      • Apple Home version: 16.5.1
    • Wi-Fi:
      • Apple Home version : 17.3.1
  • Wi-Fi Access Point:
    • Thread
      • Eero AP
      • Asus_Ax3000
      • NETGEAR44
    • Wi-Fi:
      • ASUS (Model : XT8 )

Amazon 

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: SiWx917 SoC
      • App: lighting-app, lock-app, window-app.
  • Amazon Hub:
    • Thread:
      • Hardware: Amazon Echo 4th Gen
      • Software: Hub Software Version: 10101192836
    • Wi-Fi:
      • Hardware: Amazon Echo 4th Gen
      • Software: Hub Software Version: 0010101202820
  • Phone
    • Thread:
      • Hardware: Pixel 5a
      • Software: Android version 14
    • Wi-Fi:
      • Hardware: OPPO Reno CPH1919
      • Software: Android version 12
  • App Software:
    • Thread:
      • Alexa version: 2.2.595606
    • Wi-Fi:
      • Alexa version: 2.2.558246.0
  • Wi-Fi Access Point:
    • Thread
      • Eero AP
      • Asus_Ax3000
      • NETGEAR44
    • Wi-Fi:
      • ASUS (Model: XT8)

Samsung

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: SiWx917 SoC
      • App: lighting-app, lock-app, window-app
  • Samsung Hub:
    • Thread:
      • Hardware: SmartThings Station
      • Software: Hub Software Version: 000.047.00012
      • Hardware: Charging Hub
      • Software Controller version: 1.0.15-5
    • Wi-Fi:
      • Hardware: SmartThings Station
      • Software: Hub Software Version: 000.052.0011
  • Phone
    • Thread:
      • Hardware: Pixel 5a
      • Software: Android version 14
    • Wi-Fi:
      • Hardware: OPPO Reno CPH1919
      • Software: Android version 12
  • App Software:
    • Thread:
    • SmartThings Version: 1.8.13.22
    • Wi-Fi:
    • SmartThings Version: 1.8.13.22
  • Wi-Fi Access Point:
    • Thread
      • Eero AP
      • Asus_Ax3000
      • NETGEAR44
    • Wi-Fi:
      • ASUS (Model: XT8)

Known Issues

General

  • Project upgrade of the Sensor application to the current extension version is not supported – this is due to the extensive rework of the app done in the current release. It is recommended that the user creates a new Sensor project from scratch and ports the custom code to it.
  • During project upgrades to the current extension version ZAP warnings are sometimes displayed. In such cases it is recommended that the .zap/ folder is deleted from the local directory and "Force Generation" is triggered from the Project Details tab in Studio.
  • The Matter device images require approximately 700k in flash space. As a result only a subset of EFR32MG12 and EFR32MG2x devices are supported. For a complete list of devices supported consult the documentation located at Matter Hardware Requirements.
  • For the BRD4319A board only the A00 revision is supported, other revisions do not have enough RAM to run Matter.
  • 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-WiFi 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.
  • Timeout can sometimes happen during operationalSessionStatus.
  • 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"). The workaround is to delete the ".zap" folder in the home directory.
  • 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).
  • In some cases the device may run out of space in the packet buffer pool when running multi-admin tests with ecosystems. This can be mitigated by increasing CHIP_SYSTEM_CONFIG_PACKETBUFFER_POOL_SIZE.
  • Visual Studio Code generation is currently not supported for Matter Solutions.
    • Workaround: Create Matter Solutions in Simplicity Studio using Simplicity IDE and then manually change the project generator from the <project_name>.slcp (using UI) to Visual Studio Code and follow the regular flow to add the project directory to VS 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, ~6 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.
  • After commissioning with the Samsung Hub, resetting the Lock app (Sleepy) sometimes does not reconnect to the Hub

Wi-Fi

  • Below issues are observed on SiWx917 SoC:
    • Sleepy apps are not stable.
    • Window covering app is not stable and has open/close issues.
    • Commissioning fails with Thermostat app.
    • Ecosystems:
      • Failures observed in long duration Scenarios where timeout occurs within 1 hour sometimes.
      • With Google, device goes to offline after successful commissioning with windows application.
    • The device got lost within 10-15 minutes after commissioning on sending the unicast commands every 5 sec on the non-sleepy app.
    • Randomly observing "Timeout issues" and "resource busy" while sending commands
    • Sometimes commissioning is failing with step 24 or step 27 or step 29 as DUT is failed to give response for sigma 1 after connecting to the network.
    • "Cancelling incomplete address resolution as device is being deleted" is observed during commissioning and also when trying to send any unicast command.
    • Matter shell on SiWx917 SoC will only work, when pins 4 & 6 are connected with USB to UART converter.
  • Below issues are observed on SiWx917 NCP:
    • Sometimes Timeout issues are observed immediately after commissioning.
    • Sleepy apps are not stable.
    • Ensure to short R100 pin on SiWx917 NCP board to resolve BlueZ errors shown-up during commissioning.
    • "Cancelling incomplete address resolution as device is being deleted" is observed when trying to send any unicast command.
  • Below issues are observed on RS9116 EVK:
    • Sometimes 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 is appeared on the LCD.
  • The external bootloader should not be used with the EFR32MG24+RS9116/SiWx917 NCP device combination. Only use the internal bootloader.
  • If the user modifies the discriminator in CHIProjectconfig.h , the modified discriminator is not updated in QR code.
  • BRD4325A is an allowed board in Simplicity Studio, however, it is not supported in Matter.
  • 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 [Wi-Fi FAQ](Matter Wi-Fi FAQ).
  • 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.
  • Commissioning fails with an "out of memory" error when an OpenThread device in the same network was added using an Apple HomePod Mini.
  • TriggerEffect command in Identify cluster does not work on EFR32xG24 with RS9116/WF200.
  • 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.
Assets 11
Loading