Skip to content

Commit 9fd559c

Browse files
kkasperczyk-norlubos
authored andcommitted
doc: Added docs for available OT networking options in Matter
Added section about configuring Matter to work with and without Zephyr networking layer. Signed-off-by: Kamil Kasperczyk <[email protected]>
1 parent a8609df commit 9fd559c

File tree

4 files changed

+28
-12
lines changed

4 files changed

+28
-12
lines changed

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -359,3 +359,18 @@ For example, for the ``nrf52840dk/nrf52840`` board target and the :ref:`matter_l
359359

360360
You can increase the UART speed using this snippet only for Nordic Development Kits.
361361
If you want to use the snippet for your custom board, you need to adjust the UART speed manually.
362+
363+
.. _ug_matter_networking_selection:
364+
365+
Networking layer selection
366+
==========================
367+
368+
The |NCS| supports two networking architectures for the Matter protocol:
369+
370+
* The Zephyr networking layer, which is enabled by default for Matter over Wi-Fi.
371+
You can also enable this architecture for Matter over Thread by setting the :kconfig:option:`CONFIG_CHIP_USE_ZEPHYR_NETWORKING` Kconfig option to ``y``.
372+
* The APIs of the OpenThread stack and the IEEE 802.15.4 radio driver, which are enabled by default for Matter over Thread.
373+
This architecture is not supported for Matter over Wi-Fi.
374+
To enable it, set the :kconfig:option:`CONFIG_CHIP_USE_OPENTHREAD_ENDPOINT` Kconfig option to ``y``.
375+
376+
To learn more about the available architectures and suitable use cases for the presented options, see the :ref:`openthread_stack_architecture` user guide.

doc/nrf/protocols/thread/configuring.rst

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -36,23 +36,21 @@ Thread requires the following Zephyr modules to properly operate in the |NCS|:
3636
Enable OpenThread in the |NCS|
3737
==============================
3838

39-
You can use the Thread protocol in the |NCS| in two ways: by utilizing the Zephyr networking layer, or by passing Thread frames directly to the nRF 802.15.4 radio driver.
39+
You can enable the Thread protocol in the |NCS| by using the Zephyr networking layer or by passing Thread frames directly to the nRF 802.15.4 radio driver.
4040

4141
* To use the Thread protocol with Zephyr networking layer, enable the following Kconfig options:
4242

4343
* :kconfig:option:`CONFIG_NETWORKING` - This option enables a generic link layer and the IP networking support.
4444
* :kconfig:option:`CONFIG_NET_L2_OPENTHREAD` - This option enables the OpenThread stack required for operating the Thread protocol effectively.
4545

46-
* To use the Thread protocol and nRF 802.15.4 radio directly, disable the previous Kconfig options, and enable the following:
47-
48-
* :kconfig:option:`CONFIG_OPENTHREAD` - This option enables the OpenThread stack, allowing the direct use of the nRF 802.15.4 radio.
46+
* To use the Thread protocol and nRF 802.15.4 radio directly, disable the previous Kconfig options and enable the :kconfig:option:`CONFIG_OPENTHREAD` option.
47+
This enables the OpenThread stack, allowing for direct use of the nRF 802.15.4 radio.
4948

5049
To learn more about available architectures, see the :ref:`openthread_stack_architecture` user guide.
5150

52-
Additionally, you can set the following Kconfig options:
53-
54-
* :kconfig:option:`CONFIG_MPSL` - This option enables the :ref:`nrfxlib:mpsl` (MPSL) implementation, which provides services for both :ref:`single-protocol and multi-protocol implementations <ug_thread_architectures>`.
55-
This is automatically set for all samples in the |NCS| that use the :ref:`zephyr:ieee802154_interface` radio driver.
51+
Additionally, you can set the :kconfig:option:`CONFIG_MPSL` Kconfig option.
52+
It enables the :ref:`nrfxlib:mpsl` (MPSL) implementation, which provides services for both :ref:`single-protocol and multi-protocol implementations <ug_thread_architectures>`.
53+
This is automatically set for all |NCS| samples that use the :ref:`zephyr:ieee802154_interface` radio driver.
5654

5755
.. _ug_thread_select_libraries:
5856
.. _ug_thread_configuring_basic_building:
@@ -183,7 +181,7 @@ You can configure the EUI-64 for a device in the following ways depending on cho
183181

184182
Replace the company ID
185183
You can enable the :kconfig:option:`CONFIG_IEEE802154_VENDOR_OUI_ENABLE` Kconfig option to replace Nordic Semiconductor's company ID with your own company ID.
186-
Specify your company ID in :kconfig:option:`CONFIG_IEEE802154_VENDOR_OUI`.
184+
Specify your company ID with the :kconfig:option:`CONFIG_IEEE802154_VENDOR_OUI` option.
187185

188186
The extension identifier is set to the default, namely the DEVICEID from FICR.
189187

@@ -220,7 +218,7 @@ You can configure the EUI-64 for a device in the following ways depending on cho
220218
221219
If you used a different value for :kconfig:option:`CONFIG_IEEE802154_NRF5_UICR_EUI64_REG`, you must use different register addresses.
222220

223-
At the end of the configuration process, you can check the EUI-64 value using OpenThread CLI:
221+
At the end of the configuration process, you can check the EUI-64 value using the OpenThread CLI as follows:
224222

225223
.. code-block:: console
226224
@@ -236,7 +234,7 @@ You can configure the EUI-64 for a device in the following ways depending on cho
236234

237235
Replace the company ID
238236
You can enable the :kconfig:option:`CONFIG_IEEE802154_VENDOR_OUI_ENABLE` Kconfig option to replace Nordic Semiconductor's company ID with your own company ID.
239-
Specify your company ID in :kconfig:option:`CONFIG_NRF5_VENDOR_OUI`.
237+
Specify your company ID with the :kconfig:option:`CONFIG_NRF5_VENDOR_OUI` option.
240238

241239
The extension identifier is set to the default, namely the DEVICEID from FICR.
242240

doc/nrf/releases_and_maturity/migration/migration_guide_3.1.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Matter
3939
* The :kconfig:option:`CONFIG_NCS_SAMPLE_MATTER_ZAP_FILE_PATH` Kconfig option has been introduced.
4040
Previously, the path to the ZAP file was deduced based on hardcoded locations.
4141
Now, the location is configured using the :kconfig:option:`CONFIG_NCS_SAMPLE_MATTER_ZAP_FILE_PATH` Kconfig option.
42-
This change requires you to update your application ``prj.conf`` file by setting the :kconfig:option:`CONFIG_NCS_SAMPLE_MATTER_ZAP_FILE_PATH` option to point the location of you ZAP file.
42+
This change requires you to update your application :file:`prj.conf` file by setting the :kconfig:option:`CONFIG_NCS_SAMPLE_MATTER_ZAP_FILE_PATH` option to point to the location of you ZAP file.
4343

4444
* For the :ref:`Matter light bulb <matter_light_bulb_sample>` sample:
4545

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,9 @@ Matter
184184
* Matter-over-Thread apps can now use the OpenThread API directly, instead of using intermediate Zephyr L2 layer.
185185
This change significantly reduces memory usage in Matter applications.
186186
On the :zephyr:board:`nrf54l15dk`, it saves approximately 15 kB of RAM and 40 kB of flash.
187+
To learn more about the new architecture option, see the :ref:`ug_matter_networking_selection` user guide.
188+
* The :ref:`ug_matter_networking_selection` section on the :ref:`ug_matter_device_advanced_kconfigs` page.
189+
The section describes how to select the networking layer for Matter applications.
187190

188191
* Updated:
189192

0 commit comments

Comments
 (0)