Este guia aborda a criação e a configuração básicas do OpenThread Commissioner (OT Commissioner). Após a conclusão deste procedimento, você terá um OT O executável da CLI do Commissioner e uma biblioteca estática do Commissioner.
Configurar o OT Commissioner
Clone o repositório do OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Instale as dependências:
cd ot-commissioner
./script/bootstrap.sh
Criar comissário de OT
O OT Commissioner instala no diretório /usr/local
. Se você quiser mudar
no diretório de instalação, defina -DCMAKE_INSTALL_PREFIX
.
Comissário de criação de OT:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Crie uma variável de ambiente para executar
commissioner-cli
na próxima etapa:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Opcional. Executar testes de unidade:
./tests/commissioner-test
Instalar o OT Commissioner
O OT Commissioner instala o seguinte código no seu diretório de instalação:
- Arquivos de cabeçalho e biblioteca do OT Commissioner
- Binário executável da CLI do OT Commissioner
- Credenciais e arquivos de configuração padrão
- Scripts para executar a CLI do OT Commissioner como daemon
sudo ninja install
Confirme a instalação no menu de ajuda.
$COMMISSIONER_CLI -h
Se você instalou o diretório /usr/local
, commissioner-cli
está disponível
na linha de comando.
commissioner-cli -h
Configuração
A OT Commissioner CLI oferece suporte ao modo de comissionamento comercial do Thread 1.2 (CCM) e comissionamento do Thread 1.1 (não CCM). Para se conectar a uma linha de execução diferente é necessário um arquivo de configuração JSON para iniciar a OT Commissioner CLI:
ccm-config.json
: o arquivo de configuração padrão para a rede Thread CCM.non-ccm-config.json
: o arquivo de configuração padrão para linhas de execução não CMM do Google.
Por padrão, esses arquivos de configuração são instalados em /usr/local/etc/commissioner
. Você pode
Veja também os arquivos de exemplo no repositório ot-commissioner do GitHub (em inglês).
Configuração do CCM
Para se conectar a uma rede Thread CCM, atualize estes campos em ccm-config.json
:
Campo | Descrição |
---|---|
DomainName |
Identificador exclusivo no domínio da empresa. |
PrivateKeyFile |
O arquivo da chave privada no formato PEM. |
CertificateFile |
O arquivo de certificado no formato PEM. |
TrustAnchorFile |
O arquivo da âncora de confiança no formato PEM. |
Esses arquivos de chave e certificado são usados para estabelecer sessões seguras entre comissário e agente de borda.
Configuração não CMM
A chave pré-compartilhada PSKc
é usada para estabelecer uma sessão segura entre as
Comissário e Agente de Fronteira. Para se conectar a uma rede Thread não CMM,
pode definir seu PSKc
na CLI do OT Commissioner. Para mais informações,
consulte Comissão externa.
Logging
Quando você executa pi@raspberrypi: commissioner-cli
na linha de comando,
O OT Commissioner cria um arquivo commissioner.log
no trabalho atual
como /home/pi/commissioner.log
. Na configuração do JSON
é possível configurar o caminho LogFile
, o nível de geração de registros e outros
configurações.
Configuração de carregamento
Para iniciar o OT Commissioner com suas configurações:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
Comissão de um marceneiro
Para usar o OT Commissioner para contratar um parceiro, consulte Externo Comissionamento.