Skip to content

Commit 831d14c

Browse files
kkasperczyk-noArekBalysNordic
authored andcommitted
doc: matter: Extended low power documentation
Added piece of documentation explaining how to configure the radio driver calibration period. Signed-off-by: Kamil Kasperczyk <kamil.kasperczyk@nordicsemi.no>
1 parent b4fcfd1 commit 831d14c

File tree

2 files changed

+21
-0
lines changed

2 files changed

+21
-0
lines changed

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

+20
Original file line numberDiff line numberDiff line change
@@ -288,6 +288,26 @@ Configure radio transmitter power
288288

289289
See :ref:`ug_matter_gs_transmission_power` for more information.
290290

291+
.. _ug_matter_device_low_power_calibration_period:
292+
293+
Configure radio driver temperature calibration period
294+
*****************************************************
295+
296+
The radio driver requires periodic calibration events to compensate the potential temperature changes that may affect the clock configuration.
297+
The frequency of the calibration depends on the device's environment and the temperature changes the device is exposed to.
298+
For example, a device that is mobile or installed outdoors likely requires shorter calibration period than a device that is installed indoors.
299+
300+
Additionally, the calibration period has an impact on the device's power consumption, because it results in device wake-ups.
301+
It is recommended not to use a calibration period value smaller than required to avoid the unnecessary increase in power consumption.
302+
303+
You can configure the calibration period using the following Kconfig options:
304+
305+
* :kconfig:option:`CONFIG_NRF_802154_TEMPERATURE_UPDATE_PERIOD` - Configures the 802.15.4 radio driver calibration period in milliseconds.
306+
The default value is 60000 ms (60 s), which is optimal for most use cases.
307+
* :kconfig:option:`CONFIG_MPSL_CALIBRATION_PERIOD` - Configures Multiprotocol Service Layer (MPSL) driver calibration period in milliseconds.
308+
This is used only, if the application uses LFRC or it is run on an nRF54L Series SoC.
309+
The default value is 4000 ms (4 s), which is likely too aggressive for most use cases.
310+
291311
Disable unused RAM sections
292312
***************************
293313

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

+1
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,7 @@ Matter
189189
* New arguments to the :ref:`ug_matter_gs_tools_matter_west_commands_zap_tool_gui` to provide a custom cache directory and add new clusters to Matter Data Model.
190190
* :ref:`ug_matter_debug_snippet`.
191191
* Storing Matter key materials in the :ref:`matter_platforms_security_kmu`.
192+
* A new section :ref:`ug_matter_device_low_power_calibration_period` in the :ref:`ug_matter_device_low_power_configuration` page.
192193

193194
* Disabled the :ref:`mpsl` before performing factory reset to speed up the process.
194195

0 commit comments

Comments
 (0)