Skip to content

Commit 59470df

Browse files
maciejbaczmanskinordicjm
authored andcommitted
doc: openthread: Add documentation about Thread 1.4
Add documentation about Thread 1.4 and change default version from 1.3 to 1.4 Signed-off-by: Maciej Baczmanski <[email protected]>
1 parent 0e4a372 commit 59470df

File tree

4 files changed

+67
-9
lines changed

4 files changed

+67
-9
lines changed

doc/_scripts/software_maturity/software_maturity_features.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,8 @@ features:
5656
Thread 1.2 - CSL Receiver: OPENTHREAD_CSL_RECEIVER
5757
Thread 1.2 - Link Metrics: OPENTHREAD_LINK_METRICS_INITIATOR && OPENTHREAD_LINK_METRICS_SUBJECT
5858
Thread 1.3 - Core: OPENTHREAD_THREAD_VERSION_1_3
59+
Thread 1.4 - Core: OPENTHREAD_THREAD_VERSION_1_4
60+
Thread 1.4 - DNS over TCP: OPENTHREAD_DNS_CLIENT_OVER_TCP
5961
Thread - Full Thread Device (FTD): OPENTHREAD_FTD
6062
Thread - Minimal Thread Device (MTD): OPENTHREAD_MTD
6163
Thread FTD + Bluetooth LE multiprotocol: OPENTHREAD_FTD && BT

doc/nrf/links.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1192,6 +1192,7 @@
11921192
.. _`Thread Group members`: https://www.threadgroup.org/thread-group
11931193
.. _`Thread Group's certification information`: https://www.threadgroup.org/What-is-Thread/Certification
11941194
.. _`Thread 1.3.0 Features White Paper`: https://www.threadgroup.org/Portals/0/documents/support/Thread1.3.0WhitePaper_07192022_3990_1.pdf
1195+
.. _`Thread 1.4 Features White Paper`: https://www.threadgroup.org/Portals/0/Documents/Thread_1.4_Features_White_Paper_September_2024.pdf
11951196

11961197
.. _`Thread Group's Confluence wiki page`: https://threadgroup.atlassian.net/wiki/spaces/THREADTEST/pages/25900869/Supporting+Material
11971198

doc/nrf/protocols/thread/configuring.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -103,15 +103,16 @@ See the following files for more options that you might want to change:
103103
Thread Specification options
104104
============================
105105

106-
The OpenThread stack can be configured to operate in compliance with either the Thread 1.1 Specification, the :ref:`Thread 1.2 Specification <thread_ug_supported_features_v12>`, or the :ref:`Thread 1.3 Specification <thread_ug_supported_features_v13>`.
106+
The OpenThread stack can be configured to operate in compliance with either the Thread 1.1 Specification, the :ref:`Thread 1.2 Specification <thread_ug_supported_features_v12>`, the :ref:`Thread 1.3 Specification <thread_ug_supported_features_v13>`, or the :ref:`Thread 1.4 Specification <thread_ug_supported_features_v14>`.
107107
You can change the stack version by using the following Kconfig options:
108108

109109
* :kconfig:option:`CONFIG_OPENTHREAD_THREAD_VERSION_1_1` - Selects the Thread stack version that is compliant with the Thread 1.1 Specification.
110110
* :kconfig:option:`CONFIG_OPENTHREAD_THREAD_VERSION_1_2` - Selects the Thread stack version that is compliant with the Thread 1.2 Specification.
111111
* :kconfig:option:`CONFIG_OPENTHREAD_THREAD_VERSION_1_3` - Selects the Thread stack version that is compliant with the Thread 1.3 Specification.
112+
* :kconfig:option:`CONFIG_OPENTHREAD_THREAD_VERSION_1_4` - Selects the Thread stack version that is compliant with the Thread 1.4 Specification.
112113
This option is enabled by default if no other option is selected.
113114

114-
By enabling support for Thread 1.2, you enable the following :ref:`thread_ug_supported_features_v12` in addition to the Thread 1.1 features:
115+
By selecting support for Thread 1.2, you enable the following :ref:`thread_ug_supported_features_v12` in addition to the Thread 1.1 features:
115116

116117
* Coordinated Sampled Listening (CSL)
117118
* Link Metrics Probing
@@ -120,12 +121,16 @@ By enabling support for Thread 1.2, you enable the following :ref:`thread_ug_sup
120121
* Enhanced Frame Pending
121122
* Enhanced Keep Alive
122123

123-
By selecting support for Thread 1.3, you enable the following features in addition to the :ref:`Thread 1.2 features <thread_ug_supported_features>`:
124+
By selecting support for Thread 1.3, you enable the following :ref:`thread_ug_supported_features_v13` in addition to the :ref:`thread_ug_supported_features_v12`:
124125

125126
* Service Registration Protocol (SRP) client
126127

128+
By selecting support for Thread 1.4, you enable the following :ref:`thread_ug_supported_features_v14` in addition to the :ref:`thread_ug_supported_features_v13` and :ref:`thread_ug_supported_features_v12`:
129+
130+
* Enhanced Internet Connectivity
131+
* Enhanced Network Diagnostics
132+
127133
For a list of all supported features in the |NCS|, see the :ref:`thread_ug_feature_sets`.
128-
For more information about Thread 1.2 features, see the `Thread 1.2 Base Features`_ document.
129134

130135
.. _ug_thread_configuring_eui64:
131136

doc/nrf/protocols/thread/overview/supported_features.rst

Lines changed: 55 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Supported Thread features
77
:local:
88
:depth: 2
99

10-
The OpenThread implementation of the Thread protocol supports all features defined in the Thread 1.3.0 Specification that are required for the Thread 1.3 Certification program:
10+
The OpenThread implementation of the Thread protocol supports all features defined in the Thread 1.4 Specification that are required for the Thread 1.4 Certification program:
1111

1212
* All Thread networking layers:
1313

@@ -26,13 +26,19 @@ The OpenThread implementation of the Thread protocol supports all features defin
2626
* Multicast across Thread networks
2727
* Thread Domain unicast addressing
2828

29-
* Features introduced with Thread 1.3.0:
29+
* Features introduced with Thread 1.3:
3030

3131
* Service Registration Protocol (SRP) client
3232
* Transport Control Protocol (TCP)
3333

34+
* Features introduced with Thread 1.4:
35+
36+
* Enhanced Internet Connectivity
37+
* Enhanced Network Diagnostics
38+
* Secure Commissioning at Scale with TCAT
39+
3440
In the |NCS|, you can choose which version of the Thread protocol to use in your application.
35-
By default, the |NCS| supports Thread 1.3, which includes support for Thread 1.2.
41+
By default, the |NCS| supports Thread 1.4, which includes support for Thread 1.3 and Thread 1.2.
3642
You can enable and configure any Thread version by using :ref:`dedicated options <thread_ug_thread_specification_options>`.
3743

3844
.. _thread_ug_supported_features_v12:
@@ -151,7 +157,51 @@ An alternative TCP stack implementation incorporated from the OpenThread project
151157

152158
See the :file:`tcp.conf` configuration file in the :file:`snippets/tcp/` directory of the :ref:`ot_cli_sample` sample for an example how to enable the alternative TCP implementation.
153159

154-
Limitations for Thread 1.3 support
160+
.. _thread_ug_supported_features_v14:
161+
162+
Thread 1.4 features
163+
*******************
164+
165+
For more information about this Thread version, see the official `Thread 1.4 Features White Paper`_.
166+
167+
.. note::
168+
See :ref:`thread_ug_thread_specification_options` for how to enable the 1.4 features that are currently available in the |NCS|.
169+
170+
Enhanced Internet Connectivity
171+
==============================
172+
173+
Thread 1.4 introduces significant enhancements to how Thread devices can connect to the public internet.
174+
This expansion is achieved through robust support for both IPv6 and IPv4, ensuring a future-proof compatibility with the existing internet infrastructure.
175+
176+
Enhanced Network Diagnostics
177+
============================
178+
179+
The Enhanced Network Diagnostics added in Thread 1.4 include:
180+
181+
* EUI-64
182+
* Thread Protocol Version and Thread Stack Version
183+
* Vendor Name, Vendor Model, and Vendor Software Version
184+
* Detailed Child information - for Thread Mesh Extenders only
185+
* Child IPv6 Address List - for Thread Mesh Extenders only
186+
* Mesh Extender (Router) Neighbors - for Thread Mesh Extenders only
187+
* Mesh Link Establishment (MLE) Protocol Counters
188+
* Vendor App URL
189+
* A method ("Answer TLV") to split a particularly large diagnostic data set over multiple UDP messages
190+
191+
The entity collecting the Thread diagnostic information may itself be directly connected to a Thread network, for example situated on a Thread 1.4 Border Router.
192+
The collected information can then be retrieved via an authenticated, secure connection from an app or back-end to this Border Router.
193+
The entity could also be situated outside the Thread Network, collecting diagnostic information in the role of a Thread Commissioner - via a secured IPv6 link to a Thread Border Router.
194+
195+
Thread Commissioning over Authenticated TLS (TCAT)
196+
==================================================
197+
198+
Thread 1.4 introduces TCAT to enable fast and secure commissioning of large volumes of Thread devices.
199+
This feature uses an authenticated, certificate-based TLS session between the new Thread device and a commissioning tool/device.
200+
TCAT support is optional and is expected to be used primarily in commercial (B2B) markets.
201+
202+
See the :file:`tcat.conf` configuration file in the :file:`snippets/tcat/` directory of the :ref:`ot_cli_sample` sample for an example how to enable the TCAT functionality.
203+
204+
Limitations for Thread 1.4 support
155205
==================================
156206

157-
Transport Control Protocol (TCP) as defined by the Thread 1.3 Specification is only supported in experimental mode by the |NCS|.
207+
Thread Commissioning over Authenticated TLS (TCAT) is an optional feature and is only supported in experimental mode by the |NCS|.

0 commit comments

Comments
 (0)