Comissionamento de Rosca Externa

O OpenThread Border Router (OTBR) possui um Thread Border Agent, que oferece suporte a Thread Commissioning externo. No Thread Commissioning externo, um dispositivo fora da rede Thread (por exemplo, um telefone celular) comissiona novos dispositivos na rede.

O Thread Commissioner serve para autenticar um usuário (externo) ou um dispositivo Thread na rede Thread. Após a autenticação, o Comissário instrui o Roteador de Fronteira a transferir credenciais de rede do Thread, como a chave de rede, diretamente para o dispositivo.

Este é um exemplo de comissionamento dentro da banda, em que as credenciais da rede Thread são transferidas entre os dispositivos pelo rádio.

Este guia detalha como comissionar um dispositivo OpenThread em uma rede criada e gerenciada pelo OTBR Web GUI, usando um dos seguintes Comissários externos:

• Comissário OT CLI
• OT Commissioner App para Android
• Thread Commissioning App para Android

Para aprender a comissão sem um comissário externo, consulte Tópico Comissionamento .

Selecione o tipo de Comissário

Use os botões para filtrar este guia com base no tipo de Comissário:

OT Comissário CLI OT Comissário Android App Tópico Grupo App Android

Selecionado: Comissário OT CLI

Forme a rede Thread

GUI da web

A maneira recomendada para formar uma rede de linha é através do OTBR Web GUI . Ao fazê-lo, mudar todos os valores do padrão na opção de menu formulário, exceto pelo prefixo on-Mesh.

Anote a senha usada. Esta frase secreta é a credencial do comissário e é usada (junto com o PAN ID estendido e o nome da rede) para gerar a chave pré-compartilhada para o comissário (PSKc). O PSKc é necessário para autenticar o Thread Commissioner (o dispositivo externo) na rede.

Manual

A rede de fio também pode ser formado manualmente na linha de OpenThread POSIX comando, utilizando ot-ctl .

1. Inicializar um novo conjunto de dados operacional:

   sudo ot-ctl dataset init new
   Done
   

2. Defina as credenciais de rede:

   sudo ot-ctl dataset panid 0xdead
   Done
   

   sudo ot-ctl dataset extpanid dead1111dead2222
   Done
   

   sudo ot-ctl dataset networkname OpenThreadGuide
   Done
   

   sudo ot-ctl dataset networkkey 11112233445566778899DEAD1111DEAD
   Done
   

3. Gere um PSKc codificado em hexadecimal usando uma frase secreta (credencial do Comissário), o PAN ID estendido e o Nome da rede com a ferramenta Gerador PSKc no OTBR. Certifique-se de usar o mesmo estendida PAN ID e nome da rede que foi usado no conjunto de dados operacional:

   cd ~/ot-br-posix/build/otbr/tools
   ./pskc J01NME DEAD1111DEAD2222 OpenThreadGuide
   198886f519a8fd7c981fee95d72f4ba7

4. Defina o PSKC:

   sudo ot-ctl dataset pskc 198886f519a8fd7c981fee95d72f4ba7
   Done
   

5. Cometer o conjunto de dados activa, ajustar o prefixo em-mesh, e formar a rede Tópico:

   sudo ot-ctl dataset commit active
   Done
   

   sudo ot-ctl prefix add fd11:22::/64 pasor
   Done
   

   sudo ot-ctl ifconfig up
   Done
   

   sudo ot-ctl thread start
   Done
   

   sudo ot-ctl netdata register
   Done
   

6. Confirme a configuração de rede:

   sudo ot-ctl state
   leader
   Done
   

   sudo ot-ctl pskc
   198886f519a8fd7c981fee95d72f4ba7
   Done
   

Prepare o dispositivo Joiner

Construa e atualize um dispositivo com OpenThread, para funcionar como o Joiner. Para uma visão geral de construir OpenThread, consulte o Guia de Construção .

Use o -DOT_JOINER=ON opção de compilação para habilitar a função Joiner.

Por exemplo, para construir a plataforma de exemplo CC2538 para uso como um Joiner:

./script/build -DOT_JOINER=ON

Instruções específicas sobre a construção de plataformas suportadas com GNU Autotools pode ser encontrado em de cada exemplo pasta de plataforma / examples / plataformas).

Assim que o dispositivo Joiner estiver pronto, obtenha seu IEEE EUI-64 atribuído de fábrica. Use o eui64 comando no OpenThread CLI:

eui64
0000b57fffe15d68
Done

Baixe o aplicativo

Comissionamento externo é suportado pelos OT Commissioner CLI , disponível para download no .

Conecte-se ao roteador de fronteira

1. Com ambos os dispositivos na mesma rede, conecte o dispositivo com oOT Commissioner CLI ao roteador de borda.
2. Abra a OT Commissioner CLI e selecione o roteador de borda desejado na lista disponível. O nome é o mesmo da rede Thread criada pelo OTBR Web GUI.
3. Digite a frase secreta (credencial do comissário) definida no OTBR Web GUI (e usada para gerar o PSKc) quando for solicitada uma senha.

Comissionar o marceneiro

Depois de conectado ao Roteador de borda, o aplicativo fornece a opção de ler um código QR de conexão ou inserir uma senha de conexão manualmente. A frase de acesso de associação também é chamada de credencial de associação e é usada (junto com o PAN ID estendido e o nome da rede) para gerar a chave pré-compartilhada para o dispositivo (PSKd). O PSKd é então usado para autenticar um dispositivo durante o Thread Comissioning. A credencial do Joiner deve ser exclusiva para cada dispositivo.

Os códigos QR Thread Connect são criados com o seguinte formato de string de texto:

v=1&&eui=0000b57fffe15d68&&cc=J01NU5

Onde eui é valor EUI64 do dispositivo Joiner e cc é o Joiner Credencial. Use esta sequência de texto com um gerador de QR Code online para criar um QR Code para digitalização.

1. No OT Commissioner CLI, digitalizar o código QR Ligação do dispositivo Joiner, ou digite o EUI64 e Joiner Credencial manualmente. Isso gera o PSKd, propaga os dados de direcionamento através da rede Thread e estabelece uma sessão DTLS.
2. Enquanto o aplicativo está esperando, entre na CLI OpenThread no dispositivo Joiner e inicie a função Joiner com a mesma credencial de Joiner:

   ifconfig up
   Done
   joiner start J01NU5
   Done

3. Aguarde um minuto para que o handshake DTLS seja concluído entre o Comissário e o Associador:
   

   
   Join success!

4. O OT Commissioner CLI também atualiza com um "mensagem de confirmação".

O Joiner obteve as credenciais de rede do Thread e agora pode ingressar na rede.

Junte-se à rede

No dispositivo Joiner, inicie o protocolo Thread para se conectar automaticamente à rede.

thread start
Done

Verifique o estado após alguns momentos para confirmar. Ele pode começar inicialmente como uma criança, mas em dois minutos deve ser atualizado para um roteador.

state
router
Done

Verifique também os endereços IPv6 do dispositivo. Ele deve ter um endereço global usando o prefixo On-Mesh especificado durante a formação da rede Thread por meio do OTBR Web GUI.

ipaddr
fdde:ad11:11de:0:0:ff:fe00:9400
fd11:22:0:0:3a15:3211:2723:dbe1
fe80:0:0:0:6006:41ca:c822:c337
fdde:ad11:11de:0:ed8c:1681:24c4:3562

Faça ping na Internet externa

Teste a conectividade entre o dispositivo Joiner na rede Thread e a Internet externa executando o ping de um endereço IPv4 público.

Por exemplo, o prefixo NAT64 bem conhecida de 64:ff9b::/96 e um endereço de IPv4 8.8.8.8 combinam-se para formar um endereço IPv6 de 64:ff9b::808:808 .

Adicione uma rota externa para o prefixo NAT64:

sudo ot-ctl route add 64:ff9b::/96 s med
Done
sudo ot-ctl netdata register
Done

Ping do endereço IPv6 sintetizado 64:ff9b::808:808 a partir da CLI OpenThread no dispositivo Joiner:

ping 64:ff9b::808:808
16 bytes from 64:ff9b:0:0:0:0:808:808: icmp_seq=3 hlim=45 time=72ms