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-commissionerInstale 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 buildcd buildcmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..ninja -j1Crie uma variável de ambiente para executar
commissioner-clina próxima etapa:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cliOpcional. 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.