Afficher et gérer des ensembles de données avec OT CLI

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

Les paramètres de configuration du réseau Thread sont gérés à l'aide des options "Actif" et "En attente" Objets d'ensemble de données opérationnels. La CLI OT inclut des commandes pour obtenir et définir et en attente.

AVERTISSEMENT : Restrictions d'utilisation en production.

Les commandes CLI permettant d'écrire ou de modifier les ensembles de données opérationnels actifs et en attente peuvent permettre de définir des paramètres non valides. combinaisons de paramètres non valides, à des fins de test. Ces commandes CLI ne peuvent être utilisées que:

  • Configurer les paramètres réseau du premier appareil dans un réseau Thread nouvellement créé
  • À des fins de test (non applicable aux appareils de production).

Dans les réseaux Thread de production, la méthode appropriée pour écrire ou modifier des ensembles de données opérationnels consiste à utiliser Commissaire qui effectue la mise en service. Appareils de production qui ne sont pas des commissaires actifs et qui font partie d'un réseau Thread NE DOIT PAS modifier les ensembles de données opérationnels de quelque manière que ce soit.

Ensemble de données opérationnel actif

L'ensemble de données opérationnel actif inclut les paramètres en cours d'utilisation sur l'ensemble d'un réseau Thread. L'ensemble de données opérationnel actif contient:

  • Code temporel d'activation
  • Chaîne
  • Masque de chaîne
  • ID PAN étendu
  • Préfixe local du réseau maillé
  • Nom du réseau
  • ID PAN
  • PSKc
  • Règle de sécurité

Pour configurer facilement un appareil de sorte qu'il soit membre à part entière du réseau Thread, vous devez vous pouvez utiliser la commande dataset active -x pour obtenir une valeur TLV encodée en hexadécimal, la commande dataset set active sur définir l'ensemble de données sur un nouvel appareil.

Sur un appareil existant, obtenez la requête TLV encodée en hexadécimal:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Sur un nouvel appareil, définissez l'ensemble de données actif:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Ensemble de données opérationnel en attente

L'ensemble de données opérationnel en attente sert à communiquer les modifications des ensembles de données opérationnels avant leur entrée en vigueur. L'ensemble de données opérationnel en attente contient tous les paramètres de l'ensemble de données opérationnel actif, avec le Ajout de:

  • Retardateur
  • Code temporel en attente

Commencer

Pour gérer des ensembles de données à partir de la ligne de commande, suivez notre atelier de programmation de simulation avec Docker et consulter la documentation de référence sur les commandes CLI.

Accéder à l'atelier de programmation sur la simulation

Accéder à la documentation de référence sur les commandes CLI

Pour obtenir la liste des commandes dataset, saisissez help:

dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
Done

Mappages d'arguments

Règle de sécurité

Les commandes de stratégie de sécurité utilisent des mappages d'arguments pour obtenir et définir otSecurityPolicy membres. Par exemple, dataset active:

dataset active
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

Dans cet exemple, Security Policy: 0 indique mRotationTime.

Voici une liste de tous les arguments de la CLI le membre otSecurityPolicy correspondant à chaque argument:

Les commandes get et set dataset securitypolicy utilisent également le même argument. des mappages. Par exemple, en définissant securitypolicy et en transmettant o, n, r, et c:

dataset securitypolicy 672 onrc
Done

Composants de l'ensemble de données et commandes mgmt

Avec d'autres paramètres, mgmtgetcommand et mgmtsetcommand des ensembles de données actifs et en attente vous permettent d'obtenir et de définir n'importe quelle combinaison otOperationalDatasetComponents:

  • activetimestamp
  • pendingtimestamp
  • networkkey
  • networkname
  • extpanid
  • localprefix
  • delaytimer
  • panid
  • channel
  • securitypolicy

Pour mgmtgetcommand, vous pouvez spécifier ces composants dans n'importe quel ordre pour obtenir les valeurs correspondantes. Vous pouvez également transmettre -x pour utiliser une valeur hexadécimale. qui est traitée comme une représentation de séquence d'octets des TLV. Il peut s'agir d'un fournisseur des TLV spécifiques que vous pourriez vouloir ajouter en plus d'autres paramètres.

mgmtgetcommand vous permet également de spécifier l'adresse IPv6 des adresses IPv6 des le responsable. Sinon, l'ALOC principale est utilisée.

dataset mgmtgetcommand {active|pending} [address leader-address] [dataset-components] [-x tlv-list]

Par exemple, pour obtenir activetimestamp et securitypolicy, utilisez le code suivant : arguments:

dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done

Pour définir les composants, vous pouvez également fournir les composants de l'ensemble de données dans n'importe quel ordre, suivi de la valeur du composant.

dataset mgmtgetcommand {active|pending} [dataset-components] [-x tlv-list]

Pour définir activetimestamp et securitypolicy, utilisez le code suivant : arguments:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done