Afficher et gérer des données réseau avec OT CLI

<ph type="x-smartling-placeholder"></ph> Consulter le code source sur GitHub

Les données réseau Thread contiennent des informations sur les routeurs de bordure et d'autres serveurs disponibles sur le réseau Thread. Routeurs de bordure et appareils offrant des services enregistrer leurs informations auprès du leader. Le leader recueille et structure ces informations dans les données réseau Thread et les distribue à tous les appareils du réseau Thread.

Les routeurs de bordure peuvent enregistrer des préfixes attribués au réseau Thread et des préfixes pour lesquels ils proposent des itinéraires. Les Services peuvent enregistrer toute information pertinente le service lui-même.

Les informations sur le routeur de bordure et le service peuvent être stables ou temporaires. Thread stable Les Données du réseau sont distribuées à tous les appareils, y compris aux appareils endormeux (SED). Les données réseau temporaires sont distribuées à tous les nœuds, sauf aux SED.

Commandes de données réseau

Pour obtenir la liste des commandes netdata, saisissez help:

netdata help
help
full
length
maxlength
publish
register
show
steeringdata
unpublish
Done

Commandes full

Les commandes full indiquent l'état de l'indicateur ou restreignent l'indicateur pour savoir si la valeur "net data full" a été invoqué.

Cette commande nécessite OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL.

Commandes length et maxlength

La commande length obtient la longueur actuelle des données réseau du thread, rapportée en nombre d'octets. Les commandes maxlength obtiennent la longueur maximale observée, ou réinitialise la longueur maximale suivie.

Commandes publish

L'éditeur de données réseau fournit des mécanismes permettant de limiter le nombre Entrées de service et de préfixe (préfixe sur réseau maillé ou route externe) dans le thread les données réseau en surveillant les données réseau et en gérant quand ajouter ou supprimer des entrées.

L'éditeur a besoin de OPENTHREAD_CONFIG_NETDATA_PUBLISHER_ENABLE.

Créer un réseau et configurer le préfixe

  1. Générer une nouvelle configuration réseau

    dataset init new
Done

  2. Affichez la configuration du réseau.

    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
Done

  3. Valider le nouvel ensemble de données dans l'ensemble de données opérationnel actif dans un environnement non volatile stockage.

    dataset commit active
Done

  4. Activer l'interface Thread

    ifconfig up
Done
thread start
Done

  5. Affiche les adresses IPv6 attribuées à l'interface Thread.

    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
Done

  6. Enregistre un préfixe IPv6 attribué au réseau Thread.

    prefix add fd00:dead:beef:cafe::/64 paros med
Done
netdata register
Done

  7. Afficher les données réseau Thread.

    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
Done

    Les préfixes et les routes incluent mappages d'arguments et la valeur RLOC.

    Les enregistrements de service incluent otServiceConfig telles que mEnterpriseNumber, mServiceData, otServerConfig::mServerData et s pour indiquer otServerConfig::mStable Le RLOC est également ajouté à la fin de la enregistrer.

  8. Afficher la longueur actuelle, en nombre d'octets, du réseau de threads de la partition Données.

    netdata length
23
Done

  9. Affiche les adresses IPv6 attribuées à l'interface Thread, y compris les ajout d'un préfixe.

    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

Associer au réseau existant

Seule la clé réseau est nécessaire pour qu'un appareil puisse se connecter à un réseau Thread.

Bien que cela ne soit pas obligatoire, spécifier le canal évite d'avoir à rechercher dans plusieurs canaux, ce qui améliore à la fois la latence et l'efficacité du processus d'association.

Une fois qu'un appareil s'est connecté à un réseau Thread, il récupère l'ensemble de données opérationnel complet.

  1. Créer un ensemble de données opérationnel actif partiel

    dataset networkkey dfd34f0f05cad978ec4e32b0413038ff
Done
dataset commit active
Done

  2. Activer l'interface Thread

    ifconfig up
Done
thread start
Done

  3. Après l'association au réseau existant, affichez les données du réseau Thread.

    netdata show
Prefixes:
fd00:dead:beef:cafe::/64 paros med dc00
Routes:
Services:
Done

  4. Afficher la longueur actuelle, en nombre d'octets, du réseau de threads de la partition Données.

    netdata length
23
Done

  5. Affiche les adresses IPv6 attribuées à l'interface Thread.

    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

Débogage et diagnostics

La taille des données réseau est limitée à 254 octets. Si les routeurs de bordure ne cessent d'ajouter (préfixes, routes ou entrées de service, par exemple) aux Données réseau qu'il peut devenir plein. Dans ce cas, les nouvelles demandes d'ajout éléments seront rejetés ou ignorés par le responsable. Le leader n'a pas doit nécessairement signaler le rejet au routeur de bordure, de sorte que celui-ci ne réalisez pas immédiatement que les données réseau sont pleines. Toutefois, disponible pour détecter quand les données réseau sont saturées.

La méthode de détection, mise en œuvre à la fois sur les routeurs de bordure et la variante optimale, utilise un mécanisme d'API de rappel et permet aux utilisateurs d'être avertis lorsque des données réseau sont plein. Le rappel peut être utilisé pour effectuer des actions, comme supprimer des préfixes obsolètes ou les entrées de service. Les commandes netdata full sont utilisées pour l'option qui détermine si la valeur "net data full" a été invoqué. Ces commandes pouvez signaler l'état de l'indicateur ou le réinitialiser.

Pour les cas d'utilisation typiques de Thread, il est peu probable que les données réseau même s'il existe de nombreux routeurs de bordure en ajoutant des préfixes de route.

Il est techniquement possible que les données réseau soient pleines, mais cela est souvent en raison d'une mauvaise configuration ou d'un problème sur le routeur de bordure. netdata length et netdata maxlength peuvent vous aider à déboguer les erreurs de données réseau complètes. length obtient la longueur actuelle des données réseau, exprimée en octets. maxlength obtient la durée maximale observée et peut également réinitialiser la valeur sa longueur maximale.