Thread Network Data contains information about Border Routers and other servers available in the Thread network. Border Routers and devices offering services register their information with the Leader. The Leader collects and structures this information within the Thread Network Data and distributes the information to all devices in the Thread Network.
Border Routers may register prefixes assigned to the Thread network and prefixes that they offer routes for. Services may register any information relevant to the service itself.
Border Router and service information can be stable or temporary. Stable Thread Network Data is distributed to all devices, including Sleepy End Devices (SEDs). Temporary Network Data is distributed to all nodes except SEDs.
Network Data Commands
For a list of netdata
commands, type help
:
netdata help
help
publish
register
show
steeringdata
unpublish
Done
publish
commands
The Network Data Publisher provides mechanisms to limit the number of similar Service and Prefix (On-Mesh Prefix or External Route) entries in the Thread Network Data by monitoring the network data and managing when to add or remove entries.
The Publisher requires OPENTHREAD_CONFIG_NETDATA_PUBLISHER_ENABLE
.
Form network and configure prefix
Generate new network configuration.
dataset init new
DoneDisplay the network configuration.
dataset
Active Timestamp: 1 Channel: 13 Channel Mask: 0x07fff800 Ext PAN ID: d63e8e3e495ebbc3 Mesh Local Prefix: fd3d:b50b:f96d:722d::/64 Network Key: dfd34f0f05cad978ec4e32b0413038ff Network Name: OpenThread-8f28 PAN ID: 0x8f28 PSKc: c23a76e98f1a6483639b1ac1271e2e27 Security Policy: 0, onrcb DoneCommit the new dataset to the Active Operational Dataset in non-volatile storage.
dataset commit active
DoneEnable the Thread interface
ifconfig up
Donethread start
DoneDisplay IPv6 addresses assigned to the Thread interface.
ipaddr
fd3d:b50b:f96d:722d:0:ff:fe00:fc00 fd3d:b50b:f96d:722d:0:ff:fe00:dc00 fd3d:b50b:f96d:722d:393c:462d:e8d2:db32 fe80:0:0:0:a40b:197f:593d:ca61 DoneRegister an IPv6 prefix assigned to the Thread network.
prefix add fd00:dead:beef:cafe::/64 paros med
Donenetdata register
DoneDisplay Thread Network Data.
netdata show
Prefixes: fd00:dead:beef:cafe::/64 paros med dc00 Routes: fd49:7770:7fc5:0::/64 s med 4000 Services: 44970 5d c000 s 4000 44970 01 9a04b000000e10 s 4000 DonePrefixes and routes include argument mappings and the RLOC value.
Service records include otServiceConfig values, including
mEnterpriseNumber
,mServiceData
,otServerConfig::mServerData
, ands
to indicateotServerConfig::mStable
. The RLOC is also appended to the end of the record.Display IPv6 addresses assigned to the Thread interface, including the added prefix.
ipaddr
fd00:dead:beef:cafe:4da8:5234:4aa2:4cfa fd3d:b50b:f96d:722d:0:ff:fe00:fc00 fd3d:b50b:f96d:722d:0:ff:fe00:dc00 fd3d:b50b:f96d:722d:393c:462d:e8d2:db32 fe80:0:0:0:a40b:197f:593d:ca61 Done
Attach to existing network
Only the Network Key is required for a device to attach to a Thread network.
While not required, specifying the channel avoids the need to search across multiple channels, improving both latency and efficiency of the attach process.
After a device successfully attaches to a Thread network, the device retrieves the complete Active Operational Dataset.
Create a partial Active Operational Dataset.
dataset networkkey dfd34f0f05cad978ec4e32b0413038ff
Donedataset commit active
DoneEnable the Thread interface.
ifconfig up
Donethread start
DoneAfter attaching to the existing network, display Thread Network Data.
netdata show
Prefixes: fd00:dead:beef:cafe::/64 paros med dc00 Routes: Services: DoneDisplay IPv6 addresses assigned to the Thread interface.
ipaddr
fd00:dead:beef:cafe:4da8:5234:4aa2:4cfa fd3d:b50b:f96d:722d:0:ff:fe00:fc00 fd3d:b50b:f96d:722d:0:ff:fe00:dc00 fd3d:b50b:f96d:722d:393c:462d:e8d2:db32 fe80:0:0:0:a40b:197f:593d:ca61 Done