Skip to content

Commit 2d1ea41

Browse files
Pull request project-chip#1113: Cherry-pick Pull request project-chip#1098: Feature/2.2.0 1.2 alpha.1 doc update
Merge in WMN_TOOLS/matter from cp/doc_update to RC_2.2.0-1.2 Squashed commit of the following: commit 60d2fb4fdc7851bae028bf75f1b49d34ec8c24d9 Author: Ezra Hale <ezra.hale@silabs.com> Date: Wed Aug 30 17:04:14 2023 +0000 Pull request project-chip#1098: Feature/2.2.0 1.2 alpha.1 doc update Merge in WMN_TOOLS/matter from feature/2.2.0-1.2-alpha-doc-update to silabs Squashed commit of the following: commit 977b1e408f7e03b482aed250c0b1060cd97cdca2 Author: Rehan Rasool <Rehan.Rasool@silabs.com> Date: Wed Aug 30 14:29:21 2023 +0000 Applied suggestion commit b31ea122a3c06b909eea477d6c1141e88ffee14b Author: KishorSilabs <kishor.rankhamb@silabs.com> Date: Wed Aug 30 19:07:43 2023 +0530 Applied suggestions commit 9ca85946f049c1ae291130b3d91833a8b06aabd8 Author: KishorSilabs <kishor.rankhamb@silabs.com> Date: Wed Aug 30 18:59:17 2023 +0530 Modified doc ... and 20 more commits
1 parent c017696 commit 2d1ea41

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+831
-355
lines changed

README.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,12 @@ Device: SiWx917 SoC
2727
This repo contains documentation, demos, examples and all the code needed for Matter Accessory Device development on both Thread and Wi-Fi. The Thread development use cases differs from Wi-Fi because the Thread protocol requires the use of an Open Thread Border Router (OTBR).
2828

2929
- To get started with the Thread demo and development see
30-
[Matter Thread](https://siliconlabs.github.io/matter/2.1.0-1.1/thread/DEMO_OVERVIEW.html)
30+
[Matter Thread](https://siliconlabs.github.io/matter/2.2.0-1.2-alpha.1/thread/DEMO_OVERVIEW.html)
3131
- To get started with the Wi-Fi demo and development see
32-
[Matter Wi-Fi](https://siliconlabs.github.io/matter/2.1.0-1.1/wifi/DEMO_OVERVIEW.html)
32+
[Matter Wi-Fi](https://siliconlabs.github.io/matter/2.2.0-1.2-alpha.1/wifi/DEMO_OVERVIEW.html)
3333

3434
The full documentation set starts here:
35-
[Silicon Labs Matter GitHub Documentation](https://siliconlabs.github.io/matter/2.1.0-1.1)
35+
[Silicon Labs Matter GitHub Documentation](https://siliconlabs.github.io/matter/2.2.0-1.2-alpha.1)
3636

3737
---
3838

docs/silabs/NEW_FEATURES.md

+38-8
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,81 @@
11
# Silicon Labs Matter New Features
22

3+
## New Features for v2.2.0-1.2-alpha.1
4+
5+
### Support for Intermittently Connected Devices (ICD)
6+
7+
- Full support for ICD Short idle time (SIT) Devices in support of the Matter 1.2 specification.
8+
- In this release Silicon Labs has provided full support for Short Idle Time intermittently connected devices.
9+
- These are ICDs (formerly called Sleepy End Devices) which must remain responsive to user input such as Door Locks and Window Coverings.
10+
- ICD Management cluster server implementation
11+
- Silicon Labs has provided an implementation of the ICD cluster server and the configuration of the ICD
12+
- ICD Manager and ICD Event manager has been implemented to manage the Idle and Active mode of the ICD
13+
- NEW DNS advertisement Text Key SAI: indicates the SLEEPY_ACTIVE_INTERVAL (default to 4000 ms when ICD is not enabled)
14+
- NEW Matter ICD configuration defines:
15+
- CHIP_CONFIG_ICD_IDLE_MODE_INTERVAL set value for the ICD IdleInterval attribute
16+
- CHIP_CONFIG_ICD_ACTIVE_MODE_INTERVAL set value for the ICD ActiveInterval attribute
17+
- CHIP_CONFIG_ICD_ACTIVE_MODE_THRESHOLD set value for the ICD ActiveThreshold attribute
18+
- CHIP_CONFIG_ICD_CLIENTS_SUPPORTED_PER_FABRIC set value for the ICD ClientsSupportedPerFabric attribute
19+
- All of these defines can be configured by our following build arguments (default values listed here)
20+
- sl_idle_mode_interval_ms = 600000 `# 10min Idle Mode Interval`
21+
- sl_active_mode_interval_ms = 1000 `# 1s Active Mode Interval`
22+
- sl_active_mode_threshold_ms = 500 `# 500ms Active Mode Threshold`
23+
- sl_icd_supported_clients_per_fabric = 2 `# 2 registration slots per fabric`
24+
- The OpenThread polling rates used in either ICD mode can be configured with (default value listed here)
25+
- sl_ot_idle_interval_ms = 15000 `# 15s Idle Intervals`
26+
- sl_ot_active_interval_ms = 200 `# 200ms Active Intervals`
27+
28+
- CHANGES:
29+
- Optimized the subscription reports by synchronizing all client’s subscriptions with the ICD idle mode interval. This ensures the minimal amount of wake ups possible due to subscription reports
30+
- The previous `--sed` build preset has been replaced by `--icd`. This goes in line with previous sleepy end device behavior being deprecated and replaced by the ICD behavior.
31+
- Silicon Labs' Light Switch and Door Lock apps support the ICD implementation and have the ICD cluster enabled. To build those apps as ICDs, use the aforementioned prefix `--icd` in your usual build command.
32+
- e.g.: `./scripts/examples/gn_silabs_example.sh ./examples/light-switch-app/silabs/efr32/ ./out/light-switch-app_ICD BRD4187C --icd`
333
## New Features for v2.1.0-1.1
434
- ### Update to GSDK Version 4.2.3
535

636
The GSDK Version 4.2.3 includes important security enhancements for the Open Thread Stack which in turn updates all Matter over Thread implementations.
737

838
## New Features for v2.0.0-1.1
939

10-
## Matter Intermittently Connected Devices (ICD / Sleepy) Improvements
11-
- ### Expose the API for a device to change the max interval in a subscription request
40+
### Matter Intermittently Connected Devices (ICD / Sleepy) Improvements
41+
- #### Expose the API for a device to change the max interval in a subscription request
1242
A device can, when accepting a subscription request, change the maximum reporting interval for it to match with its idle time instead of accepting the requested intervals.
1343
When not using this API, the ICDs idle time interval could functionally be shortened by a controller without the ICD being able to refuse the subscription.
1444

1545
For more details see the [Matter Intermittently Connected Devices](./general/MATTER_ICD.md) section.
1646

17-
- ### Persistent Subscription
47+
- #### Persistent Subscription
1848
The device will persist a subscription to be able to recover its subscription with a subscriber in case of a reboot.
1949

2050
For more details see the [Matter Intermittently Connected Devices](./general/MATTER_ICD.md) section.
2151

22-
- ### During the commissioning flow, the device will not be able to go to idle mode until the commissioning is complete.
52+
- #### During the commissioning flow, the device will not be able to go to idle mode until the commissioning is complete.
2353
Before, the thread devices would go to idle mode right after completing its srp registration but before the sigma1 message was received.
2454
With 1.1, devices will remain in Active Mode until the commissioning is complete.
2555

26-
- ### Adding the Active Mode Threshold feature.
56+
- #### Adding the Active Mode Threshold feature.
2757
When a thread ICD goes from Idle Mode to Active Mode, the ICD will stay in Active Mode for a defined amount before going back to Idle Mode.
2858
The timer starts after the last communication.
2959
For this feature to take affect, there needs to be at least one message coming in or going out. If the device just polls its thread router and nothing else happens, this doesn't come into play.
3060

3161
For more details see the [Openthread Sleepy End Device](./general/OT_SLEEPY_END_DEVICE.md) section.
3262

33-
## Matter Sleepy End Devices over Wi-Fi
63+
### Matter Sleepy End Devices over Wi-Fi
3464

3565
- A Matter Sleepy End Device is a device where the EFR32 along with the Wi-Fi coprocessor go into sleep mode during idle time resulting in less power consumption. This helps devices running on limited power sources like battery powered devices.
3666
The EFR32 goes into sleep mode whenever the device is idle. The Wi-Fi coprocessor goes into Power Save (PS) Poll legacy power save mode where it wakes for every Delivery Traffic Information Map (DTIM) interval to check for any packets.
3767

3868
For more details see the [Wi-Fi Sleepy End Device](wifi/WIFI_SLEEPY_END_DEVICE.md) section.
3969

40-
## Added support for CMPS (Custom Part Manufacturing Service)
70+
### Added support for CMPS (Custom Part Manufacturing Service)
4171

4272
- The new provisioning script allows easy setup of factory data in Matter devices. This tool provides a common architecture for use both in development and production environments, which allows easy deployment of the developed products.
4373

4474
The provisioning script may be used to set all factory settings, including Discriminator, Passcode, and the attestation credentials (PAI, DAC and CD).
4575

4676
The provision/provision.py tool supersedes the silabs_example/credentials/creds.py script.
4777

48-
## Matter Wi-Fi Direct Internet Connectivity
78+
### Matter Wi-Fi Direct Internet Connectivity
4979

5080
- The Matter Wi-Fi Direct Internet Connectivity (DIC) solution connects to proprietary cloud solutions for direct access to software downloads, to device controls, or to aggregate statistics on where and how the device is being used.
5181

docs/silabs/README.md

+4-6
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,10 @@
2121
1. [Matter Wi-Fi Demo Overview](wifi/DEMO_OVERVIEW.md)
2222
2. [Building a Matter Wi-Fi End Device](wifi/SW_SETUP.md)
2323
3. [Running the Matter Demo on EFR32 hosts](wifi/RUN_DEMO.md)
24-
4. [Ozone Environment Setup for the SiWx917 SoC](wifi/SiWx917_Enablement_For_Ozone.md)
25-
5. [Flashing the SiWx917 SoC](general/FLASH_SILABS_SiWx917_SOC_DEVICE.md)
26-
6. [Running the Matter Demo on SiWx917 SoC](wifi/RUN_DEMO_SiWx917_SoC.md)
27-
7. [Matter Wi-Fi Sleepy End Devices](wifi/WIFI_SLEEPY_END_DEVICE.md)
28-
8. [Matter Wi-Fi Sleepy End Device Power Measurement](wifi/WIFI_Sleepy_Device_Power_Measurement.md)
29-
9. [Matter Wi-Fi Direct Internet Connectivity(DIC)](wifi/DIC_Wi-Fi.md)
24+
4. [Running the Matter Demo on SiWx917 SoC](wifi/RUN_DEMO_SiWx917_SoC.md)
25+
5. [Matter Wi-Fi Sleepy End Devices](wifi/WIFI_SLEEPY_END_DEVICE.md)
26+
6. [Matter Wi-Fi Sleepy End Device Power Measurement](wifi/WIFI_Sleepy_Device_Power_Measurement.md)
27+
7. [Matter Wi-Fi Direct Internet Connectivity(DIC)](wifi/DIC_Wi-Fi.md)
3028

3129
6. Matter Bridging to Zigbee/Z-Wave
3230

docs/silabs/conf.py

+2-2
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@
99
project = 'Matter'
1010
copyright = 'Copyright © 2023 Silicon Laboratories. All rights reserved.'
1111
author = 'Silicon Labs'
12-
release = '2.1.0-1.1'
13-
version = '2.1.0-1.1'
12+
release = '2.2.0-1.2-alpha.1'
13+
version = '2.2.0-1.2-alpha.1'
1414

1515

1616
# -- General configuration ---------------------------------------------------

docs/silabs/general/ARTIFACTS.md

+32-13
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Matter chip-tool. Note the image is ~10GB in size so depending on your internet
1111
connection this download may take some time. Start the Matter Hub Raspberry Pi
1212
image download here:
1313

14-
https://www.silabs.com/documents/public/software/SilabsMatterPi_2.0.0-1.1.zip
14+
https://www.silabs.com/documents/public/software/SilabsMatterPi_2.2.0-1.2-alpha.1.zip
1515

1616
## Radio Co-Processor (RCP) Images
1717

@@ -20,15 +20,15 @@ used with a Raspberry Pi to allow the Raspberry Pi's Open Thread Border Router
2020
to access the Thread network. Radio Co-Processor (RCP) images are available in
2121
the Assets section of this page:
2222

23-
https://github.com/SiliconLabs/matter/releases/tag/v2.1.0-1.1
23+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
2424

2525
## Matter Accessory Device Images
2626

2727
The Matter Accessory Device Images are used to turn an EFR into a Matter device.
2828
These are pre-built binary images for the Matter Demo. Matter Accessory Device
2929
Images are located in the Assets section of this page:
3030

31-
https://github.com/SiliconLabs/matter/releases/tag/v2.1.0-1.1
31+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
3232

3333
For Matter over Thread, 3 different types of images are provided:
3434

@@ -43,21 +43,40 @@ EFR32MG2x device, you will need to flash a bootloader binary on your device alon
4343
with the application image. Bootloader binaries for all of the Matter supported
4444
devices are available here:
4545

46-
https://github.com/SiliconLabs/matter/releases/tag/v2.1.0-1.1
46+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
4747

4848
## RS9116 Firmware
4949

50-
The RS9116 firmware is used to update the RS9116 - it can be found in the
51-
repository you have cloned, at the following relative path from the `/matter`
52-
directory, `./third_party/silabs/wiseconnect-wifi-bt-sdk/firmware`
50+
The RS9116 firmware (rs9116_firmware_files_with_rev.zip) is used to update the RS9116 which can be found in the Assets section of this page:
5351

54-
## SiWx917 Firmware
52+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
5553

56-
> **Note**: SiWx917 firmware is only available to Alpha customers. Contact Silicon Labs support to obtain the WiseMCU SDK and install it as per the instructions on the [Software Requirements page](./SOFTWARE_REQUIREMENTS.md).
54+
**Note**:
55+
RS9116 chip/module needs to be flashed with proper firmware as mentioned below:
56+
- `RS916.x.x.x.x.x.rps - This firmware image is valid for RS9116 1.5 revision chip/module`
57+
- `RS9116.x.x.x.x.x.rps - This firmware image is valid for RS9116 1.4/1.3 revision chip/module`
5758

58-
The SiWx917 firmware is used to update the SiWx917 device connectivity firmware. It can be found in the
59-
repository you have cloned, at the following relative path from the `/matter`
60-
directory, `./third_party/silabs/wisemcu-wifi-bt-sdk/connectivity_firmware`
59+
## SiWx917 Firmware for SiWx917 NCP
60+
61+
The SiWx917 firmware(SiWx917NCP_firmware_files.zip) is used to update the SiWx917 NCP which can be found in the Assets section of this page:
62+
63+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
64+
65+
**Note**:
66+
SiWx917 NCP board need to be flashed with proper firmware as mentioned below:
67+
- ``SiWG917-A.2.9.X.X.X.rps - This firmware image is valid for BRD8036A (A0 Expansion v1.1) board`
68+
69+
70+
## SiWx917 Firmware for SiWx917 SoC
71+
72+
The SiWx917 firmware (SiWx917SOC_firmware_files.zip) along with WiSeConnect 3 SDK is used to update the SiWx917 SoC which can be found in the Assets section of this page:
73+
74+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1
75+
76+
**Note**:
77+
SiWx917 SoC boards need to be flashed with proper firmware as mentioned below:
78+
- `SiWG917-A.2.9.X.X.X.rps - This firmware image is valid for BRD4325B(A0 dual flash 1.2) board`
79+
- `SiWG917-B.2.9.X.X.X.rps - This firmware image is valid for BRD4325C(B0 common flash v1.2) board`
6180

6281
## SiWx917 SoC Configuration Files for Flashing the Matter Application
6382

@@ -67,4 +86,4 @@ be configured for the SiWx917 SoC device by following the instructions on the [O
6786
The **JLinkDevices.xml** and **ELF** files referenced in the instructions may be found
6887
in the Assets section of this page:
6988

70-
https://github.com/SiliconLabs/matter/releases/tag/v2.1.0-1.1
89+
https://github.com/SiliconLabs/matter/releases/tag/v2.2.0-1.2-alpha.1

docs/silabs/general/COMMISSIONING.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Commissioning
1+
# Matter Commissioning
22

33
## Overview
44

docs/silabs/general/COMMIT_HASHES.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,19 @@ in this release of the Silicon Labs Matter Out of Box Experience
77

88
| Repo | Branch | Commit Hash |
99
| ------------------------------------------ | ------ | ---------------------------------------- |
10-
| https://github.com/SiliconLabs/ot-br-posix | main | 1813352247aa60fb8993773918f1e5b4af6f3b79 |
10+
| https://github.com/SiliconLabs/ot-br-posix | main | bb565ca0164981f58a2659222c30917399703a9b |
1111

1212
## Radio Co-Processor (RCP)
1313

1414
| Repo | Branch | Commit Hash |
1515
| --------------------------------------- | ------ | ---------------------------------------- |
16-
| https://github.com/SiliconLabs/ot-efr32 | main | 7a567da02a078546eb34136c1c44170c8832dd55 |
16+
| https://github.com/SiliconLabs/ot-efr32 | main | 3528d4bba47743a5367a822e350aaccb04698542 |
1717

1818
## Connectivity Standards Alliance (CSA) connectedhomeip (Matter)
1919

2020
| Repo | Branch | Commit Hash |
2121
| ----------------------------------------------- | ------ | ---------------------------------------- |
22-
| https://github.com/project-chip/connectedhomeip | v1.1-branch | 8f66f4215bc0708efc8cc73bda80620e67d8955f |
22+
| https://github.com/project-chip/connectedhomeip | master | 684b9d6246e5e5ef33db589af61a30e224d61ee3 |
2323

2424
## Matter chip-tool
2525

0 commit comments

Comments
 (0)