Ver el código fuente en GitHub
La CLI de OpenThread expone las API de configuración y administración desde una interfaz de línea de comandos. Usa la CLI de OT para crear un entorno de desarrollo de OpenThread o úsalo como una herramienta con código de aplicación adicional. Por ejemplo, las secuencias de comandos de prueba de OpenThread usan la CLI para ejecutar casos de prueba.
Comienza ahora
Complete nuestro codelab de simulación con Docker y revise la referencia del comando de la CLI.
Ir al codelab de simulación Ir a la referencia de comandos de la CLI
Usar la CLI de OT
Puedes usar la CLI de OT con dispositivos Thread y el router de borde de OpenThread (OTBR). Los comandos de la CLI variarán según el tipo de dispositivo y las marcas de compilación.
OTBR
Para usar la CLI de OT con OTBR, ingresa el siguiente prefijo antes de cada comando:
sudo ot-ctl
Dispositivos de conversación
Para usar los comandos de la CLI en un dispositivo Thread, consulta la documentación, el codelab o la guía de la plataforma. En muchos ejemplos, puedes comenzar a escribir comandos sin un prefijo:
state
router
Done
A continuación, le presentamos algunos recursos que lo ayudarán a comenzar:
- Revisa las plataformas de OpenThread
- Codelab de hardware nórdico
- Codelab de hardware de Silicon Labs
- Ejemplos de plataformas en GitHub
Caracteres especiales
El carácter de espacio en blanco (' '
) se usa para delimitar el nombre del comando y los diferentes argumentos, junto con la tabulación ('\t'
) y los nuevos caracteres de línea ('\r'
, '\n'
).
Algunos argumentos pueden incluir espacios, como un nombre de red de Thread. Si deseas enviar argumentos que incluyen espacios, usa el carácter de barra inversa ('\'
) para separar los separadores o la barra inversa:
networkname Test\ Network
Donenetworkname
Test Network Done
Asignaciones de argumentos
La CLI de OT usa argumentos predefinidos que corresponden a los valores de configuración de la API. Estas asignaciones pueden pasarse con comandos de la CLI y también pueden volver a la consola de la CLI para varios comandos de datos de red, como netdata show.
otBorderRouterConfig
Algunos comandos, por ejemplo, prefix add
, requieren valores otBorderRouterConfig. Para configurar los miembros de otBorderRouterConfig
desde la línea de comandos, la CLI de OT analiza un argumento de letra asignado para cada miembro. Por ejemplo, la combinación paros
de argumentos establece los miembros mPreferred, mSlaac, mDefaultRoute, mOnMesh y mStable, de forma consecutiva.
Sintaxis
En el siguiente ejemplo, prefix
es obligatorio, y los argumentos otBorderRouterConfig son opcionales, mapeados como p
, a
, d
, c
, r
, o
, s
, n
y D
:
prefix add prefix [padcrosnD]
Uso
Para usar las asignaciones de argumentos, no ingreses espacios entre las letras:
prefix add 2001:dead:beef:cafe::/64 paros
otRoutePreference
Para configurar otRoutePreference, usa high
, med
o low
en los comandos de la CLI de OT.
Sintaxis
prefix add prefix [padcrosnD] [high|med|low]
Uso
A continuación, se muestra un ejemplo de cómo usar los parámetros mapeados otBorderRouterConfig
y otRoutePreference
:
prefix add 2001:dead:beef:cafe::/64 paros med
Done
otExternalRouteConfig
Para los valores otExternalRouteConfig, s
se asigna a mStable
y n
se asigna a mNat64
.
Sintaxis
publish route prefix [sn]
Uso
route add 2001:dead:beef:cafe::/64 s
Done
Valores que se muestran
La mayoría de los comandos muestran el valor solicitado, seguido de Done
:
br onlinkprefix
fd41:2650:a6f5:0::/64
Done
Otros comandos que incluyen datos de red pueden mostrar asignaciones de argumentos para los registros de prefijos, rutas y servicios. Para obtener más información, consulta Cómo mostrar y administrar datos de red con la CLI de OT.