Skip to content

Commit 90d9927

Browse files
kkasperczyk-noArekBalysNordic
kkasperczyk-no
authored and
ArekBalysNordic
committed
doc: Updated Matter docs to include recent v1.4.0.0 features
Updated documentation to list all new features and configuration that were introduced in Matter v1.4. Signed-off-by: Kamil Kasperczyk <[email protected]>
1 parent 193a2f4 commit 90d9927

File tree

4 files changed

+70
-9
lines changed

4 files changed

+70
-9
lines changed

‎doc/nrf/protocols/matter/getting_started/low_power_configuration.rst‎

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,10 +90,19 @@ The typical use case for a SIT device are actuators, meaning devices such as doo
9090
Conversely, LIT devices are designed to be used for sensors or light switches, devices that only report data and are not controllable.
9191
In such scenarios, the LIT device initiates communication and it is not able to answer with a small latency, but it can sleep for extended periods of time and achieve much lower power consumption than an SIT.
9292

93+
The LIT device starts operation in the SIT mode and remains in this state until the first ICD client registers to it.
94+
This is necessary because the device is not responsive in the LIT mode, so client registration would be difficult.
95+
Once the ICD client is registered, the ICD device switches to LIT mode in order to save the energy.
96+
9397
The LIT device implementation requires multiple new features, such as Check-In protocol (CIP) support, ICD client registration, and User Active Mode Trigger (UAT).
9498
These features are not required for SIT device implementation, but can be optionally enabled.
9599

96-
To configure the LIT, CIP or UAT, use the following Kconfig options:
100+
You can enable optional Dynamic SIT LIT switching (DSLS) support for the LIT device.
101+
When enabled, the device can dynamically switch between SIT and LIT modes, even if it has an ICD client registered.
102+
The primary use case for this feature is device types like Smoke/CO Alarm, allowing the device to work as SIT when using a wired power source and switch to LIT and using a battery power source in case of a power outage.
103+
This feature is not available for the SIT device.
104+
105+
To configure the LIT, CIP, UAT or DSLS, use the following Kconfig options:
97106

98107
* :kconfig:option:`CONFIG_CHIP_ICD_LIT_SUPPORT` to enable the Long Idle Time device support.
99108
* :kconfig:option:`CONFIG_CHIP_ICD_CHECK_IN_SUPPORT` to enable the Check-In protocol support.
@@ -103,9 +112,11 @@ To configure the LIT, CIP or UAT, use the following Kconfig options:
103112
* :kconfig:option:`CONFIG_CHIP_ICD_UAT_SUPPORT` to enable the User Active Mode Trigger support.
104113
The User Active Mode Trigger allows triggering the ICD device to move from the idle to active state and make it immediately responsive, for example to change its configuration.
105114
This option is by default enabled for the LIT device.
106-
107-
The LIT, CIP and UAT features were not finalized for Matter v1.3 and they are marked as provisional, so it is not recommended to use them, though you can find some of the LIT implementation in the Matter SDK and Matter specification.
108-
You can still enable them for testing purposes.
115+
* :kconfig:option:`CONFIG_CHIP_ICD_SIT_SLOW_POLL_LIMIT` to limit the slow polling interval value while the device is in the SIT mode.
116+
This option can be used to limit the slow poll interval of an LIT device while temporarily working in the SIT mode.
117+
* :kconfig:option:`CONFIG_CHIP_ICD_DSLS_SUPPORT` to enable Dynamic SIT LIT switching (DSLS) support.
118+
The DSLS support allows the application to dynamically switch between SIT and LIT modes, as long as the requirements for these modes are met.
119+
This option is by default disabled for the LIT device.
109120

110121
Enable low power mode for the selected networking technology
111122
************************************************************

‎doc/nrf/protocols/matter/index.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ For a full list of |NCS| and Matter versions, view the following table:
2323
+--------------------------+-----------------------------------------------------+------------------------+
2424
| nRF Connect SDK version | Matter specification version | Matter SDK version |
2525
+==========================+=====================================================+========================+
26-
| v2.8.99 (latest) | :ref:`1.3.0 <ug_matter_overview_dev_model_support>` | 1.3.0.0 |
27-
+--------------------------+ | |
28-
| |release| | | |
26+
| v2.8.99 (latest) | :ref:`1.4.0 <ug_matter_overview_dev_model_support>` | 1.4.0.0 |
27+
+--------------------------+-----------------------------------------------------+------------------------+
28+
| |release| | :ref:`1.3.0 <ug_matter_overview_dev_model_support>` | 1.3.0.0 |
2929
+--------------------------+ | |
3030
| v2.7.0 | | |
3131
+--------------------------+-----------------------------------------------------+------------------------+

‎doc/nrf/protocols/matter/overview/data_model.rst‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,14 @@ Smart Plugs/Outlets device types
189189
| Water Valve | A Water Valve is a device that is capable of being switched on and off | Certifiable | |
190190
| | and performing flow measurements. | | |
191191
+-------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
192+
| Mounted On/Off | A Mounted On/Off Control is a fixed device that provides power to another | Certifiable | |
193+
| Control | device that is plugged into it, and is capable of switching that provided | | |
194+
| | power on or off. | | |
195+
+-------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
196+
| Mounted Dimmable | A Mounted Dimmable Load Control is a fixed device that provides power | Certifiable | |
197+
| Load Control | to another device that is plugged into it, and is capable of being | | |
198+
| | switched on or off and have its level adjusted. | | |
199+
+-------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
192200

193201
.. _ug_matter_device_types_switches_controls:
194202

@@ -410,6 +418,22 @@ Energy device types
410418
| Supply Equipment | (Electric Vehicle) to be connected to the mains electricity supply to allow | | |
411419
| | it to be charged | | |
412420
+--------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
421+
| Water Heater | A Water Heater is a device that is installed to heat water for showers, | Certifiable | |
422+
| | baths etc. | | |
423+
+--------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
424+
| Solar Power | A Solar Power device is a device that allows a solar panel array, associated | Certifiable | |
425+
| | controller and, if appropriate, inverter, to be monitored and controlled | | |
426+
| | by Energy Management System. | | |
427+
+--------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
428+
| Battery Storage | A Battery Storage device is a device that allows a DC battery, an associated | Certifiable | |
429+
| | controller, and an AC inverter, to be monitored and controlled by | | |
430+
| | an Energy Management System in order to manage the peaks and troughs | | |
431+
| | of supply and demand, and/or to optimize cost of the energy consumed | | |
432+
| | in premises. | | |
433+
+--------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
434+
| Heat Pump | A Heat Pump device is a device that uses electrical energy to heat either | Certifiable | |
435+
| | spaces or water tanks using ground, water or air as the heat source. | | |
436+
+--------------------+------------------------------------------------------------------------------+---------------------+---------------------------------------+
413437

414438
.. _ug_matter_device_types_utility:
415439

‎doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst‎

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -142,11 +142,37 @@ Matter
142142
Matter fork
143143
+++++++++++
144144

145-
The Matter fork in the |NCS| (``sdk-connectedhomeip``) contains all commits from the upstream Matter repository up to, and including, the ``v1.3.0.0`` tag.
145+
The Matter fork in the |NCS| (``sdk-connectedhomeip``) contains all commits from the upstream Matter repository up to, and including, the ``v1.4.0.0`` tag.
146146

147147
The following list summarizes the most important changes inherited from the upstream Matter:
148148

149-
|no_changes_yet_note|
149+
* Added:
150+
151+
* Enhanced Network Infrastructure with Home Routers and Access Points (HRAP).
152+
This provides requirements for devices such as home routers, modems or access points to create a necessary infrastructure for Matter products.
153+
* Enhanced Multi-Admin that aims to simplify the smart home management from the user perspective.
154+
This term includes several different features and in this release only Fabric Synchronization was fully delivered.
155+
The Fabric Synchronization enables commissioning of devices from one fabric to another without requiring manual user actions, only user consent.
156+
* Dynamic SIT LIT switching support that allows the application to switch between these modes, as long as the requirements for these modes are met.
157+
This can be enabled using the :kconfig:option:`CONFIG_CHIP_ICD_DSLS_SUPPORT` Kconfig option.
158+
* The Kconfig option :kconfig:option:`CONFIG_CHIP_ICD_SIT_SLOW_POLL_LIMIT` to limit the slow polling interval value for the device while it is in the SIT mode.
159+
This can be used to limit the slow poll interval for the ICD LIT device while it is temporarily working in the SIT mode.
160+
* New device types:
161+
162+
* Water heater
163+
* Solar power
164+
* Battery storage
165+
* Heat pump
166+
* Mounted on/off control
167+
* Mounted dimmable load control
168+
169+
* Updated:
170+
171+
* Thermostat cluster with support for scheduling and preset modes, like vacation, and home or away settings.
172+
* Electric Vehicle Supply Equipment (EVSE) with support for user-defined charging preferences, like specifying the time when the car will be charged.
173+
* Occupancy sensing cluster with features like radar, vision, and ambient sensing.
174+
* Intermittently Connected Devices feature with enhancements for the Long Idle Time (LIT) and Check-In Protocol.
175+
With this enhancements, the state of this feature is changed from provisional to certifiable.
150176

151177
nRF IEEE 802.15.4 radio driver
152178
------------------------------

0 commit comments

Comments
 (0)