Skip to content

v2.2.0
Compare
Choose a tag to compare
@rerasool rerasool released this 13 Dec 18:37
· 7 commits to main since this release
v2.2.0
73910fc

Silicon Labs Matter Extension v2.2.0-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.0

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

Versions

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

  • Matter: d140d5c8775
  • Gecko SDK: v4.4.0
  • Thread
    • Silicon Labs OpenThread: v2.4.0.0 (7074a43e4)
  • Wi-Fi
    • WiSeConnect 3 SDK: v3.1.1 (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.0-1.2 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)'s Matter 1.2 certification program (https://csa-iot.org/) for Thread (MG12, MG24) and Wi-Fi NCP platforms (MG24/RS9116, MG24/WF200).

  • To get started, download Simplicity Studio from the following link: https://www.silabs.com/developers/simplicity-studio, and install GSDK 4.4.0, along with Silicon Labs Matter v2.2.0. For SiWx917, install WiSeConnect v3.1.1 as well.

  • This release was fully tested with WiSeConnect v3.1.1. The release passed basic testing when using WiSeConnect v3.1.2. However with WiSeConnect v3.1.3, the user will need to make modifications to 2 files in the project. These changes are described
    here
    NOTE: These files should not be edited in the SDK, a copy should be made for the individual project.

Highlights of this release

  • Quality-tested Matter 1.2 solution for Thread (MG12, MG24), Wi-Fi NCP platforms (MG24/RS9116, MG24/WF200, MG24/SiWx917), and Wi-Fi SoC platforms (SiWx917).
    • Works with Thread and Wi-Fi device combinations in the Google, Apple, Amazon and Samsung ecosystems (see the Ecosystem section below).
    • Adds support for Matter 1.2 Intermittently Connected Devices (ICD).
      • Adds Intermittently Connected Devices (ICD) Sample applications.
      • The Light Switch and Lock sample applications come with a preconfigured data model to support the ICD option.
    • Introduction of the Dishwasher sample application.
    • Introduction of a third LCD screen to display application information.
  • Works with Gecko SDK v4.4.0 and WiSeConnect SDK v3.1.1.
  • Expands Matter support for Wi-Fi SiWx917 NCP and SiWx917 SoC - with Beta quality.
    • Adds support for OTA Software Update functionality on SiWx917 SoC platform.
    • Adds support for Intermittently Connected Devices(ICD) functionality on SiWx917 SoC & SiWx917 NCP platforms.
    • Adds Certificate Provisioning support for SiWx917 SoC platform.
  • Adds support for Self-Provisioning Mode.
  • Provides functionality to build a Silicon Labs Matter project using SLC-CLI and make.
  • Adds support for editing, building, and debugging Simplicity Studio Matter projects with Visual Studio Code.

Issues fixed in this release

  • SEGGER SystemView component should function properly after installing (without additional defines manually added).
  • Enabling/disabling clusters within the ZAP GUI inside of Simplicity Studio properly adds/removes the corresponding cluster component within the Software Components tab.

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 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 device combinations:

  • SiWx917 SoC
  • EFR32xG24 + RS9116
  • EFR32xG24 + SiWx917
  • EFR32xG24 + WF200

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

  • MG24 boards:

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

  • Wi-Fi Dev Kit

    • RS9116
    • SiWx917
      • NCP mode:
        • SiWx917-EB4346A
      • SoC mode:
    • 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
  • Light Switch  
    • Note: This App is supported for SiWx917 SoC devices only.
  • Window Covering
  • On/Off plug
  • Thermostat
    • Note: This App is not supported for SiWx917 SoC devices.
  • Dishwasher

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

Reference guide to enable the sleepy functionality for Wi-Fi: Wi-Fi ICD

Wi-Fi changes in this release:

  • Adds Matter support on SiWx917 NCP board variants - SiWx917-EB4346A.
  • Adds Matter support on SiWx917 SoC 1.8 MB Common flash variants - BRD4338A.
  • Adds Matter support for new WiSeConnect 3.1.1 SDK on SiWx917 SoC & NCP boards.
  • Adds support for OTA functionality on Wi-Fi SoC platforms (SiWx917).
  • Adds support for ICD functionality on SiWx917 SoC & NCP platforms.
  • Adds Certificate Provisioning support for SiWx917 SoC platforms.

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 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 LCD functionality on SiWx917 SoC.
  • 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.
  • LCD on EFR32xG24 with SiWx917 NCP (planned in a future release).
  • External Flash on EFR32xG24 with RS9116 or SiWx917 (planned in a future release).
  • OTA Update functionality on EFR32xG24 with RS9116 or SiWx917 NCP (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: BRD4186C EFR32MG24+9116/WF200/SiWx917 NCP combinations, SiWx917 SoC
      • App: lighting-app, lock-app, window-app, on-off plug app, thermostat-app
  • Google Hub:
    • Hardware: Google Nest Hub Gen 2
    • Software: Hub Software Version: 54.103.7.577294944
  • Phone
    • Hardware: Pixel 5a
    • Software: Android version 14
  • App Software:
    • Google Home version: 3.10.1.6
  • Wi-Fi Access Point:
    • Eero AP
    • Asus_Ax3000
    • NETGEAR44

Apple

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: BRD4186C EFR32MG24+9116/WF200 NCP combinations, SiWx917 SoC
      • App: lighting-app, lock-app, window-app, on-off plug app, thermostat-app
  • Apple Hub:
    • Hardware: Apple Home Pod Mini
    • Software: 16.5.1 (Thread)
    • Software: 17.2 (Wi-Fi)
  • Phone:
    • Hardware: iPhone SE
    • Software: 17.1.1
  • App Software:
    • Apple Home version: 16.5.1
  • Wi-Fi Access Point:
    • Eero AP
    • Asus_Ax3000
    • NETGEAR44

Amazon 

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: BRD4186C EFR32MG24+9116/WF200 NCP combinations, SiWx917 SoC
      • App: lighting-app, lock-app, window-app, on-off plug app, thermostat-app
  • Amazon Hub:
    • Hardware: Amazon Echo 4th Gen
    • Software: Hub Software Version: 9698490244
  • Phone
    • Hardware: Pixel 5a
    • Software: Android version 14
  • App Software:
    • Alexa version: 2.2.545469.0
  • Wi-Fi Access Point:
    • Eero AP
    • Asus_Ax3000
    • NETGEAR44

Samsung

  • Silicon Labs Device:
    • Thread: BRD4187C EFR32MG24
      • App: lighting-app
    • Wi-Fi: BRD4186C EFR32MG24+9116/WF200 NCP combinations, SiWx917 SoC
      • App: lighting-app, lock-app, window-app, on-off plug app, thermostat-app
  • Samsung Hub:
    • Hardware: SmartThings Station
    • Software: Hub Software Version: 000.047.00012
    • Hardware: Aeotec
    • Software controller version: 2.3.29-7
    • Hardware: Charging Hub
    • Software Controller version: 1.0.15-5
  • Phone
    • Hardware: Pixel 5a
    • Software: Android version 14
  • App Software:
    • SmartThings Version: 1.8.11.25
  • Wi-Fi Access Point:
    • Eero AP
    • Asus_Ax3000
    • NETGEAR44

Known Issues

General

  • Existing Simplicity Studio installations require that Matter 2.2.0-1.2 projects must be explicitly configured to use the version 12.2.1 of the GNU ARM toolchain. The new Simplicity Studio installation uses the 12.2.1 toolchain by default. For instructions on managing the toolchains see Step 6 in the following document: https://community.silabs.com/s/article/Notes-on-Simplicity-Studio-SV5-8-0-0-and-Gecko-SDK-4-4-0-0-release?language=en_US

  • With the change of Lock/Light-Switch applications to default as ICD's, users must still manually enable the ICD Management server cluster within the ZAP GUI upon project generation (the corresponding Simplicity Studio components are already enabled). Not enabling the cluster within ZAP will return an "UNSUPPORTED_CLUSTER" error message when trying to interact with the cluster.

  • 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 cases an "incorrect state" error is encountered while commissioning additional fabrics.

  • The SLC-CLI scripts currently work only for EFR32 boards, the SiWx917 support is coming in the next release.

  • 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).

  • Visual Studio Code is not supported for Matter Solutions, only individual Matter projects are currently supported.

  • Due to the large scope of the code changes between Matter 1.1 and 1.2 an upgrade of an existing Simplicity Studio project to Matter Extension version v2.2.0-1.2 requires additional manual steps. Furthermore, in v2.2.0-1.2 the Light Switch and Lock sample apps become Intermittently Connected Devices by default, project upgrades for these applications are not recommended. 
    To upgrade an existing project created with the Matter Extension version 2.1.1-1.1 or earlier:

    In the Simplicity Studio project tab click on "Change Target/SDK/Generators" and select GSDK 4.4.0/Extension 2.2.0-1.2 as the new SDK. Click through the prompts.
    Wait until the old GSDK and Matter folders in the project view are replaced by the new ones (this takes approximately a minute). Invoke "Force Generation" from the menu in the Project Details tab.
    Manually update (copy or merge) the files in the src/ and include/ directories of the Simplicity Studio project folder with the content from the Matter extension for the corresponding application type (e.g. Lighting). Also copy/merge the updated FreeRTOSConfig.h into the project's config/ directory. 
    Below is an example of Mac or Linux commands for copying the files, if some of the files were modified in the project (as main.cpp probably would be) then the new content should be merged with the local changes. If is the location of GSDK 4.4.0 used by Simplicity Studio and is the location of the Simplicity Studio project, the copy commands for the Lighting app are:

    cp <GSDK>/extension/matter_extension/examples/lighting-app/silabs/src/* <Project>/src/
cp <GSDK>/extension/matter_extension/examples/lighting-app/silabs/include/* <Project>/include/
cp <GSDK>/extension/matter_extension/examples/platform/silabs/main.cpp  <Project>/src/
cp <GSDK>/extension/matter_extension/examples/platform/silabs/FreeRTOSConfig.h <Project>/config/

    For other app types (Window, Thermostat etc) replace "lighting-app" with the corresponding directory name, for the Sensor and On-Off Plug apps use "silabs_examples" instead of "examples".  

  • In the latest Simplicity Studio release, the default GCC toolchain version is v12.2.1. When using this toolchain to build a Matter 1.1 based project (v2.1.1-1.1 or v2.1.0-1.1), there will be some compiler warnings such as the following:

    libc_nano.a(libc_a-closer.o): in function `_close_r': closer.c.text._close_r+0xc): warning: _close is not implemented and will always fail.

    The project will still build with these warnings. To get rid of these warnings, one must change the GCC toolchain to the 10.3 version in Simplicity Studio. Steps to add the 10.3 toolchain to Simplicity Studio:
    Download the 10.3 toolchain per your OS here - https://developer.arm.com/downloads/-/gnu-rm, or use a 10.3 based gcc toolchain of your choice.
    Right-click on the Matter 1.1 based project in Simplicity Studio. Properties -> C/C++ Build -> Manage Configurations -> New -> Manage Toolchains -> Add -> Browse. Locate the desired toolchain to be added to the project.
    Click OK -> Select the dialog box for the 10.3 toolchain, and deselect the dialog box for the 12.2 toolchain -> Apply and Close -> OK
    Locate the 10.3 toolchain in “Manage Build Configurations”. Click on it and hit “Set Active” then OK. Apply and Close out of the “Properties” pop up
    If set up correctly, GNU ARM v10.3.1 - Default should appear to the right of the project name rather than GNU ARM v12.2.1
    Now the Matter 1.1 based project should build without warnings.

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

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 a Thread app in the Amazon ecosystem and then commissioning it in the Google ecosystem the device may appear offline in the Google Home app, however it can be controlled in the Amazon app. After removing the device in the Google Home in may become unresponsive in the Amazon app.

Wi-Fi

  • Below issues are observed on SiWx917 SoC:
    • Multi-admin commissioning window not closed after 900s.
    • Sleepy apps are not stable.
    • Window covering app is not stable and has open/close issues.
    • Ecosystems: Failures observed in Long Duration Scenarios where timeout occurs within 1 hour sometimes.
    • WiFi 917 SOC will fail building out of the box. There are 2 options to fix this.
      • Downgrade WiseConnect 3 SDK to 3.1.2
      • Comment out nvm3 lock/unlock in SilabsConfig.cpp. Apply the diff from 26119 to FreeRTOSConfig.h in the config/ folder
  • Below issues are observed on SiWx917 NCP:
    • Sometimes Timeout issues are observed immediately after commissioning.
    • Sleepy apps are not stable.
    • Unable to Commission the DUT if there is a time delay (more than 1 minute) after Factory Reset.
  • When LCD is enabled, in order to reset the RS9116 EVK 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/SiWx917NCP 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.
  • This release does not support the following SiWx917 SoC boards.
    • BRD4325B
    • BRD4325C
    • BRD4325G
  • BRD4325A is an allowed board in Simplicity Studio, however, it is not supported in Matter.
  • Ensure to short R100 pin on SiWx917 NCP board to resolve BlueZ errors shown-up during commissioning.
  • Matter shell on SiWx917 SoC will only work, when pins 4 & 6 are connected with USB to UART converter. 
  • 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.
  • Commissioning step 18 failure occurs occasionally:
    • This has been seen to occur more frequently with one specific access point – MI Router 4C.
    • When this issue occurs, try the following steps to run commissioning successfully:
      • Delete all files in your chip-tool's /tmp  folder
      • Factory Reset your access point
  • 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