Visão geral da CLI do OpenThread

Veja o código-fonte no GitHub

A CLI do OpenThread expõe APIs de configuração e gerenciamento de uma interface de linha de comando do Compute Engine. Usar a CLI OT para criar um desenvolvimento do OpenThread ou usá-lo como uma ferramenta com código de aplicativo adicional. Por exemplo: o OpenThread scripts de teste usam a CLI para executar casos de teste.

Primeiros passos

Conclua nosso codelab de simulação com o Docker e revise a referência de comandos da CLI.

Acesse o codelab de simulação Acesse a referência de comandos da CLI

Usar a CLI OT

É possível usar a CLI OT com o roteador de borda do OpenThread (OTBR) e os dispositivos Thread. CLI variam de acordo com o tipo de dispositivo e as flags de build.

OTBR

Para usar a CLI OT com o OTBR, digite o seguinte: antes de cada comando:

sudo ot-ctl

Dispositivos Thread

Para usar comandos da CLI em um dispositivo Thread, consulte a documentação da plataforma, codelab ou guia. Em muitos exemplos, é possível começar a digitar comandos sem um prefixo:

state
router
Done

Aqui estão alguns recursos para ajudar você a começar:

Caracteres especiais

O caractere de espaço em branco (' ') é usado para delimitar o nome do comando e o argumentos diferentes, junto com a tabulação ('\t') e os caracteres de nova linha ('\r' e '\n').

Alguns argumentos podem incluir espaços, como um nome de rede Thread. Para envie argumentos que incluam espaços, use o caractere de barra invertida ('\') para separadores de escape ou a própria barra invertida:

networkname Test\ Network
Done
networkname
Test Network
Done

Mapeamentos de argumentos

A CLI do OT usa argumentos predefinidos que correspondem aos valores de configuração da API. Esses mapeamentos podem ser transmitidos com comandos da CLI e também podem retornar à CLI console para vários comandos de dados de rede, por exemplo, netdata show.

otBorderRouterConfig

Alguns comandos, como prefix add, exigem otBorderRouterConfig e a distribuição dos valores dos dados. Para definir otBorderRouterConfig membros na linha de comando, OT CLI analisa um argumento de letra mapeado para cada membro. Por exemplo, o argumento paros define a mPreferred, mSlaac, mDefaultRoute, mOnMesh, e mStable consecutivamente.

Sintaxe

No exemplo a seguir, prefix é obrigatório. otBorderRouterConfig são opcionais, mapeados como p, a, d, c, r, o, s, n, e D:

prefix add prefix [padcrosnD]

Uso

Para usar mapeamentos de argumentos, não insira espaços entre as letras:

prefix add 2001:dead:beef:cafe::/64 paros

otRoutePreference

Para definir otRoutePreference, use high, med ou low nos comandos da CLI OT.

Sintaxe

prefix add prefix [padcrosnD] [high|med|low]

Uso

Confira um exemplo de como usar otBorderRouterConfig e otRoutePreference mapeados parâmetros:

prefix add 2001:dead:beef:cafe::/64 paros med
Done

otExternalRouteConfig

Para otExternalRouteConfig s é mapeado para mStable e n é mapeado para mNat64.

Sintaxe

publish route prefix [sn]

Uso

route add 2001:dead:beef:cafe::/64 s
Done

Valores de retorno

A maioria dos comandos retorna o valor solicitado, seguido por Done:

br onlinkprefix
fd41:2650:a6f5:0::/64
Done

Outros comandos que incluem dados de rede podem retornar mapeamentos de argumentos para registros de prefixo, rota e serviço. Para mais informações, consulte Mostre e gerencie dados de rede com a CLI OT.