Skip to content

v2.5.0

Latest
Latest
Compare
Choose a tag to compare
@rerasool rerasool released this 18 Dec 20:08
v2.5.0
2ce3baa

Matter Extension v2.5.0-1.4 Release Notes

Silicon Labs Matter Simplicity SDK Extension v2.5.0-1.4

This release is supported for use with Simplicity Studio. For CLI based experience, use the SiliconLabsSoftware/matter_extension repo.
Documentation can be viewed at: docs.silabs.com/matter/2.5.0

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

Versions  

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

  • Matter: v1.4 (fd2d000)
  • Simplicity SDK: v2024.12.0
  • GCC compiler version: 12.2.1
  • Thread
    • Silicon Labs OpenThread: v2.6.0.0 (7f6723ffb)
    • ot-br-posix (7d327005e)
  • Wi-Fi
    • WiSeConnect 3 SDK: v3.4.0 (SiWx917 SoC, SiWx917 NCP)
    • WiSeConnect SDK: v2.10.3 (RS9116)
    • WF200 does not use WiSeConnect SDK, it uses Simplicity SDK components

Features 

This is the Silicon Labs Matter v2.5.0-1.4 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.4 certification program (https://csa-iot.org/) for Thread (MG24 / MG26) and Wi-Fi NCP platform (MG24/WF200).

This release supports series 2 devices. Alpha support for series 3 is also enabled. Use v2.2.x-1.2 for series 1 devices.

Highlights of this release 

  • Quality-tested Matter 1.4 GA solution for Thread MG24 / MG26, Wi-Fi MG24/WF200 and Wi-Fi MG24/RS9116 (non-sleepy). 
    • For Wi-Fi SiWx917 SoC and RCP mode, this is an Alpha. Basic functionality works but there are issues with stress testing, for details see the Known Issues section. If GA quality is desired, use v2.4.0 release until the v2.5.1 patch is available.
  • Works with Simplicity SDK v2024.12.0 and WiSeConnect SDK v3.4.0.
  • Expands our existing Matter support in Thread with new hardware and software capabilities.
    • xG26 support is enabled for BRD4350A module, BRD4351A module, and BRD2709A Explorer Kit.
    • SixG301 Alpha support is enabled for BRD1019A.
    • GA support of the Matter Zigbee CMP (concurrent multi-protocol) Light example application.
      • Some limitations exist, for details see the Known Issues section.
  • Expands our existing Matter support in Wi-Fi with new hardware and software capabilities.
    • Improved power numbers for the Wi-Fi SiWx917 SoC with the Selective Listening feature.
    • Refrigerator application and Dimmer switch application support has been added for SiWx917.
    • SiWx917 SoC module board support is enabled for BRD4343A and BRD2708A.
    • SiWx917 NCP board support is enabled for BRD4357A. Matter uses this board as an RCP; LwIP task runs on the EFR32.
    • Matter SiWx917 RCP Linux Host support has been added.
    • The mbedTLS library has been upgraded from 2.x to 3.x for the SiWx917.
  • DX Improvement: Added conformance data to Matter XML files and a 'Device Type Features' page in ZAP. Toggling a feature auto-updates the featureMap and aligns attributes, commands, and events to correct conformance plus shows detailed conformance warnings for them if their enabled state conflicts with conformance value.
  • Miscellaneous bug fixes and improvements.

Issues fixed in this release

  • DAC size was previously limited to 512 bytes. This is now increased to 600 bytes as required by the specs, section 6.1.3. Certificate Sizes. (UID: 1377303)
  • The Zigbee Matter Light app now stores the proper value for kConfigKey_UniqueID which is used by the Basic Information cluster. (UID: 1362463)
  • Corrected an issue where the function sl_memory_get_heap_high_watermark() may sometimes return the wrong value. (UID: 1354963)
  • Resolved compilation issues in Matter over Wi-Fi projects when buttons or LED components are disabled. (UID: 1368663)
  • Fixed a possible crash with the multi-sensor app after commissioning with the Apple HomePod app. (UID: 1362893)
  • Resolved a race condition that could rarely prevent an ICD Matter over Thread device from going to sleep for a polling duration. (UID: 1362030)
  • Corrected an issue in SSv5 where the Zigbee Matter Light app would fail to build if the option "Copy contents" was used for the SDK. (UID: 1348601)
  • Fixed an issue where a Matter over Thread device may report the wrong current consumption values between polls. (UID: 1336943)

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 a Silicon Labs EFR-based device and either

  • another EFR-based device and a Raspberry Pi with a 32 GB SD Card
  • or an ecosystem device with OpenThread Border Router capabilities such as Amazon Echo, Apple HomePod, Samsung SmartThings Hub or Google Nest Hub

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
  • 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
    • BRD2709A
  • MGM26 boards
    • BRD4350A
    • BRD4351A

Thread support in Simplicity Studio for the following applications:

  • Light
  • Light Switch
  • Lock
  • Window Covering
  • Thermostat
  • OnOff Plug
  • Sensor
  • Dishwasher
  • Air Quality Sensor
  • Refrigerator
  • Zigbee Matter Light

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 or an ecosystem with Matter support

Wi-Fi support for the following boards:

  • SoC mode:

    • BRD4338A / SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit - SiWx917-PK6031A
    • BRD2605A / SiWx917 Wi-Fi 6 and Bluetooth LE Dev Kit - SiWx917-DK2605A
    • BRD4342A / SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash + 8 MB ext PSRAM Radio Board with an internal RF switch - SiWx91x-RB4342A
    • BRD4343A / SiWG917Y Module Wi-Fi 6 and Bluetooth LE 8MB Flash RF-Pin Radio Board - SiW917Y-RB4343A
    • Early access for new module board BRD2708A / SiW917Y-EK2708A

  • RCP mode:

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. Connectivity firmware update is mandatory for new release binaries.

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

  • SoC and Dev Kit supported applications:
    • Light
    • Lock
    • Light Switch
    • Window Covering
    • On/Off plug
    • Thermostat
    • Dishwasher
    • Air Quality Sensor
    • Sensor
    • Fan Control
    • Refrigerator
  • 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 SiWx917 NCP, SiWx917 SoC
  • Window Covering
    • With chip-tool 
    • With EFR32xG24 with SiWx917 NCP, SiWx917 SoC
  • Thermostat
    • With chip-tool
    • With EFR32xG24 with RS9116, SiWx917 NCP, SiWx917 SoC
  • 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.4.0 SDK on SiWx917 SoC, DevKit (BRD2605A) & SiWx917 NCP boards.
  • Improved power numbers for the Wi-Fi SiWx917 SoC with the Selective Listening feature.
  • The mbedTLS library has been upgraded from 2.x to 3.x for the SiWx917.
  • Refrigerator application is enabled for the SiWx917 SoC.
  • Added Dimmer Switch support in the existing Light Switch application for SiWx917 SoC.
  • SiWx917 SoC module board support is enabled for BRD4343A and BRD2708A.
  • SiWx917 NCP board support is enabled for BRD4357A. Matter uses this board as an RCP; LwIP task runs on the EFR32.
  • Matter SiWx917 RCP Linux Host support has been added.

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.
  • Supported OTA functionality on SiWx917 SoC.
  • Supported OTA (M4 image only) functionality on SiWx917 NCP.
  • 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 are no longer supported.
  • 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 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

 SiWx917 SoC
BRD4338A,

 lighting-app, on-off app, lock-app, window-app,
fan-app



Hardware: Google Nest Hub, Model : GUIK2

Software: Hub Software Version: Chromecast 3.75.446835

 


Hardware: OPPO Reno CPH1919

Software: Android version 12

 


Google Home version:  3.27.1.6

 



ASUS (Model: XT8) 

 

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

 SiWx917 SoC
BRD4338A, BRD4342A

 lighting-app, on-off app, lock-app, window-app,
fan-app


Hardware: Home Pod Mini
Software: 18.2 (22K155)

 


Hardware: iPhone SE
Software : 17.7

 


Apple Home version: 17.7

 


ASUS (Model: XT8) 

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

 SiWx917 SoC
BRD4338A, BRD4342A

 lighting-app, on-off app, lock-app, window-app,
fan-app

Hardware: Amazon Echo 4th Gen

Software: Hub Software Version: 0011040824196

 

Hardware: OPPO Reno CPH1919

Software: Android version 12

 

Alexa version: 1.8.21.28

 

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

 SiWx917 SoC
BRD4338A, BRD4342A

 lighting-app, on-off app, lock-app, window-app,
fan-app


Hardware: SmartThings Station

Software: Hub Software Version: 000.053.00019

 


Hardware: OPPO Reno CPH1919

Software: Android version 12

 


SmartThings Version: 1.8.21.28

 


ASUS (Model: XT8) 

 

Known Issues

General

  • The Matter logs are now printed to the UART interface by default. To view the logs use the Simplicity Studio console or a standalone terminal emulator such as PuTTY. The logging destination can be controlled by installing the "Logging To UART" or the "Logging to RTT" component under Matter -> Platform -> Utils in a Matter Studio project.
  • 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.
  • Upgrades of pre-2.4.0-1.4 projects based on the Lighting application require that user manually removes the references to OnOffSwitchConfiguration from ZclCallbacks.cpp.
  • 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.
  • 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 Apple, Samsung and 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.5.0/matter-ota/01-ota-bootloader.
  • For ICD applications, after upgrading the project, users should update the configuration values in the ICD Server Configuration  component accordingly.
  • ConnectMaxTimeSeconds attribute (and others) exposed by ZAP even though it cannot be modified (read only). Work in progress in PR#36516. (UID: 1370882)

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.
  • 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)
  • In some cases the Zigbee Matter Light (sequential variant) may fail to transmit the NotifyUpdateApply command after an OTA Software update.
  • Zigbee Matter Light commissioning failure due to kFindOperationalForStayActive timeout can occur. (UID: 1360555)
  • In rare cases the Zigbee Matter Light CLI becomes unresponsive. Device reboot is required (UID: 1337094).
  • After a power cycle, Zigbee Matter Light may become unreachable from the controller due to a SRP request timeout. Device recovers after a reboot (UID: 1360564)
  • The StartUpOnOff attribute of the OnOff cluster in the Zigbee Matter Light application does not maintain its setting after a reboot (UID: 1381037)
  • CurrentHeapHighWatermark sometimes gets reported improperly to the Matter layer from the platform code (UID: 1336190)
  • Zigbee MatterLight app may fail to build when created using the 'Copy contents' option (UID: 1348601)
  • Matter ICD over Thread may rarely not enter sleep/idle its radio until the next poll phase due to waiting on a TX ACK operation (UID: 1362030; 1362028)
  • The Concurrent Listening functionality is not enabled by default in the Matter Zigbee Light example. The use of this functionality with an Internal Storage Bootloader for OTA updates requires that the bootloader is built with BOOTLOADER_MSC_DMA_WRITE set to false in Simplicity Studio, this configuration is found in the "Internal Storage" component under Platform→Bootloader→Storage. Without this bootloader setting the OTA update functionality will not work. Concurrent Listening is enabled by installing the RAIL Utility, IEEE802.15.4 Fast Channel Switching Configuration and the RAIL Utility, DMA components in the Studio project (to find the components uncheck the "Production Ready" from the filter).
  • After upgrading a project, users need to remove the IO Stream: EUSART component. Then search for UARTDRV EUSART component, click on the gear icon on the vcom instance to configure it, and add the following configuration changes for the EUSART0 module:
    CTS => PB05, RTS => PA00, RX => PA09, TX => PA08

Wi-Fi

  • In high traffic Environment, mDNS timeout is seen with SiWx917 SoC and NCP.
  • In high-traffic environment, sometimes command timeouts are seen as the processing of the command takes more than 20 seconds.
  • Below issues are observed on SiWx917 SoC:
    • Hang issue is observed with the BRD4338A board during the commissioning stress test, causing BLE scan failures.
    • Occasional Commissioning failures seen in high traffic environment.
    • The BRD4342A PSRAM support is enabled only for the text segment; it is not working for the data segment.
    • After flashing sleepy applications, the BRD4343A boards cannot be flashed or erased unless the ISP button is reset.
    • BLE scan issues are observed with Raspberry Pi when the distance between the device and the controller exceeds 1.5 meters
    • The lock application does not receive data reports when subscriptions are active with chip-tool.
    • Applications from this release are not backward compatible with the previous one due to some changes in the provisioning and hence OTA update is not recommended.
    • After AP (Access Point) power cycle, devices in the Amazon, Samsung, or Google smart home ecosystems fail to execute actions such as locking/unlocking and opening/closing with lock app and window app. 
    • Observed CASE session timeout 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).
    • The P37 pin should be pulled up to enable the Matter shell for sleepy applications.
  • Below issues are observed on RS9116 EVK:
    • RSI send failure and SPI timeout issues are observed with the 9116, causing a timeout issue during command processing.
  • 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.
  • With EFR32 MG24 + 9116 after going idle for some time, Apple devices may not be able to control an LED. (UID: 1085568)
  • 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.
  • LCD is disabled on RS9116 and SiWx917 NCP.
  • Project upgrades to v2.5.0 release are not supported. 
Assets 12
Loading