Comissionamento de Linha 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 Border Router a transferir credenciais de rede Thread, como a chave mestra, para o dispositivo diretamente.

Este é um exemplo de comissionamento em banda, em que as credenciais de 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:

Para saber como fazer o comissionamento sem um Comissário externo, consulte Thread Comissionamento .

Selecione o tipo de Comissário

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

Selecionado: aplicativo Android

Forme a rede Thread

Web GUI

A maneira recomendada de formar uma rede Thread é por meio do OTBR Web GUI . Ao fazer isso, altere todos os valores padrão na opção de menu Formulário , exceto para o Prefixo na Malha.

Anote a frase - senha usada. Esta frase secreta é a Credencial do Comissário e é usada (junto com a PAN ID Estendida 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 Thread também pode ser formada manualmente na linha de comando do OpenThread POSIX, usando ot-ctl .

Inicialize um novo conjunto de dados operacional:
```
sudo ot-ctl dataset init new
Done
```

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 masterkey 11112233445566778899DEAD1111DEAD
Done

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 PAN ID estendido e nome de rede que foi usado no conjunto de dados operacional:
```
cd ~/ot-br-posix/tools
./pskc J01NME DEAD1111DEAD2222 OpenThreadGuide
198886f519a8fd7c981fee95d72f4ba7
```

Defina o PSKc:

sudo ot-ctl dataset pskc 198886f519a8fd7c981fee95d72f4ba7
Done

Confirme o conjunto de dados ativo, defina o prefixo na malha e forme a rede Thread:

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 netdataregister
Done

Confirme a configuração da 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 da construção do OpenThread, consulte o Guia de Construção .

Use a opção de compilação JOINER=1 para habilitar a função Joiner.

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

make -f examples/Makefile-cc2538 JOINER=1

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

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

eui64
0000b57fffe15d68
Done

Baixe o aplicativo Thread Commissioning

O comissionamento externo é suportado pelo Thread Commissioning App , disponível para download na Google Play Store para dispositivos Android.

Conecte-se ao roteador de fronteira

Conecte o dispositivo com o Thread Commissioning App ao ponto de acesso Wi-Fi no Border Router.
Abra o Thread Commissioning App e selecione o Border Router desejado na lista disponível. O nome é o mesmo da rede Thread criada pelo OTBR Web GUI. Se o mesmo Border Router aparecer várias vezes com diferentes endereços IPv4 e IPv6, selecione aquele com o endereço IPv4 estático usado para a configuração do ponto de acesso Wi-Fi .
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 oferece a opção de ler um código QR de conexão ou inserir uma senha de acesso 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 Commissioning. 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 é o valor EUI64 do dispositivo Joiner e cc é a credencial do Joiner. Use esta sequência de texto com um gerador de QR Code online para criar um QR Code para digitalização.

No aplicativo Thread Commissioning, digitalize o código QR do Connect do dispositivo Joiner ou insira o EUI64 e a credencial do Joiner manualmente. Isso gera o PSKd, propaga os dados de direcionamento através da rede Thread e estabelece uma sessão DTLS.
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
```
Aguarde um minuto para que o handshake DTLS seja concluído entre o Comissário e o Associador:
```
Join success!
```
O aplicativo Thread Commissioning também é atualizado com uma mensagem de confirmação "Added My Thread Product".

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 ping em um endereço IPv4 público. Se o NAT64 foi configurado conforme detalhado em Configuração do ponto de acesso Wi-Fi para OpenThread Border Router , use o valor do prefix configurado lá, combinado com o endereço IPv4 traduzido.

Por exemplo, o Prefixo conhecido de 64:ff9b::/96 e um endereço IPv4 de 8.8.8.8 combinam para formar um endereço IPv6 de 64:ff9b::808:808 .

Faça ping neste endereço 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

Solução de problemas do aplicativo de comissionamento de tópicos

Você pode encontrar problemas com o aplicativo Thread Commissioning, devido a informações de rede alteradas ou obsoletas. O aplicativo retém informações da rede OTBR localmente e nem sempre solicita atualizações.

Para resolver esses problemas, exclua todos os dados do aplicativo local, reinicie o aplicativo e tente o processo de comissionamento novamente.

Para excluir dados de aplicativos locais:

No dispositivo Android, abra o aplicativo Configurações
Vá para Aplicativos e notificações > Informações do aplicativo > Tópico > Armazenamento
Selecione CLEAR DATA
Volte para as informações do aplicativo e selecione FORCE STOP
Feche o aplicativo Configurações e reinicie o aplicativo Thread

Web GUI