Cómo mostrar y administrar conjuntos de datos con la CLI de OT

Ver código fuente en GitHub

Los parámetros de configuración de red de Thread se administran mediante objetos de conjuntos de datos operativos activos y pendientes. La CLI de PO incluye comandos para obtener y configurar conjuntos de datos activos y pendientes.

Conjunto de datos operativo activo

El conjunto de datos operativo activo incluye parámetros que están en uso en toda una red de Thread. El conjunto de datos operativo activo contiene lo siguiente:

  • Marca de tiempo activa
  • Canal
  • Máscara de canal
  • ID de PAN extendido
  • Prefijo local de la malla
  • Nombre de la red
  • ID PAN
  • PSK,
  • Política de seguridad

A fin de configurar con facilidad un dispositivo para que sea un miembro completo de la red de Thread, puedes usar el comando dataset active -x a fin de obtener un TLV con codificación hexadecimal, y el comando dataset set active a fin de configurar el conjunto de datos en un dispositivo nuevo.

En un dispositivo existente, obtén el TLV con codificación hexadecimal:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

En un dispositivo nuevo, establece el conjunto de datos activo:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Conjunto de datos operativo pendiente

El conjunto de datos operativo pendiente se usa para comunicar cambios al conjunto de datos operativo activo antes de que entren en vigencia. El conjunto de datos operativo pendiente contiene todos los parámetros del conjunto de datos operativo activo, además de lo siguiente:

  • Temporizador de demora
  • Marca de tiempo pendiente

Comienza ahora

Para administrar conjuntos de datos desde la línea de comandos, completa nuestro Codelab de simulación con Docker y revisa la referencia del comando de la CLI.

Ir al codelab de simulación

Ir a la referencia del comando de la CLI

Para obtener una lista de los comandos de dataset, escribe help:

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

Asignaciones de argumentos

Política de seguridad

Los comandos de las políticas de seguridad usan asignaciones de argumentos para obtener y configurar miembros de otSecurityPolicy. Por ejemplo, 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

En este ejemplo, Security Policy: 0 indica mRotationTime.

A continuación, se muestra una lista de todos los argumentos de la CLI de políticas de seguridad y el miembro otSecurityPolicy correspondiente para cada argumento:

Los comandos get y set de dataset securitypolicy también usan las mismas asignaciones de argumentos, como configurar securitypolicy y pasar o, n, r y c:

dataset securitypolicy 672 onrc
Done

Componentes del conjunto de datos y comandos mgmt

Junto con otros parámetros, el mgmtgetcommand y el mgmtsetcommand para los conjuntos de datos activos y pendientes te permiten obtener y configurar cualquier combinación de otOperationalDatasetComponents:

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

Para mgmtgetcommand, puedes especificar estos componentes en cualquier orden a fin de obtener los valores correspondientes. De manera opcional, también puedes pasar -x para usar una string hexadecimal que se trata como una representación de secuencia de bytes de TLV. Pueden ser TLV específicos del proveedor que desees agregar, además de otros parámetros.

mgmtgetcommand también te permite especificar de forma opcional la dirección IPv6 del líder. De lo contrario, se utiliza el ALOC líder.

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

Por ejemplo, para obtener activetimestamp y securitypolicy, usa los siguientes argumentos:

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

Para configurar los componentes, también puedes proporcionar los componentes del conjunto de datos en cualquier orden, seguidos del valor del componente.

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

Para configurar activetimestamp y securitypolicy, usa los siguientes argumentos:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done