Creazione e configurazione di OpenThread Commissioner

Visualizza sorgente su GitHub

Questa guida illustra le build di base e la configurazione di OpenThread Commissioner (OT Commissioner). Al termine di questa procedura, avrai un eseguibile dell'interfaccia a riga di comando di OT Commissioner e una libreria statica di Commissioner.

Configura OT Commissioner

  1. Clona il repository OT Commissioner:

    git clone https://github.com/openthread/ot-commissioner
    

  2. Installa le dipendenze:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Crea commissario OT

OT Commissioner si installa nella directory /usr/local. Per cambiare la directory di installazione, imposta -DCMAKE_INSTALL_PREFIX.

  1. Crea commissario OT:

    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
    ninja -j1
    

  2. Crea una variabile di ambiente per eseguire commissioner-cli nel passaggio successivo:

    export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
    

  3. Optional. Esegui test delle unità:

    ./tests/commissioner-test
    

Installa OT Commissioner

OT Commissioner installa quanto segue nella directory di installazione:

  • Libreria OT Commissioner e file di intestazione
  • Programma binario eseguibile dell'interfaccia a riga di comando di OT Commissioner
  • File e credenziali di configurazione predefiniti
  • Script per eseguire l'interfaccia a riga di comando di OT Commissioner come daemon
sudo ninja install

Verifica l'installazione controllando il menu Guida.

$COMMISSIONER_CLI -h

Se hai installato la directory /usr/local, sarà disponibile commissioner-cli dalla riga di comando.

commissioner-cli -h

Configurazione

L'interfaccia a riga di comando OT Commissioner supporta sia la modalità di messa in servizio commerciale di Thread 1.2 (CCM) sia la messa in servizio di Thread 1.1 (non CCM). Per connetterti a reti Thread diverse, è necessario un file di configurazione JSON per avviare l'interfaccia a riga di comando di OT Commissioner:

  • ccm-config.json: file di configurazione predefinito per la rete CCM.
  • non-ccm-config.json: file di configurazione predefinito per rete non Thread CCM.

Per impostazione predefinita, questi file di configurazione vengono installati in /usr/local/etc/commissioner. Puoi visualizzare i file di esempio anche nel repository GitHub del commissario.

Configurazione CCM

Per connetterti a una rete Thread CCM, aggiorna questi campi in ccm-config.json:

Campo Description
DomainName Identificatore univoco del dominio Enterprise.
PrivateKeyFile Il file della chiave privata in formato PEM.
CertificateFile Il file del certificato in formato PEM.
TrustAnchorFile Il file di ancoraggio trust in formato PEM.

Questi file di chiavi e certificati vengono utilizzati per stabilire sessioni sicure tra il commissario e l'agente di confine.

Configurazione non CCM

La chiave precondivisa PSKc viene utilizzata per stabilire una sessione sicura tra il commissario e l'agente di confine. Per connetterti a una rete non Thread CCM, puoi impostare PSKc dall'interfaccia a riga di comando OT Commissioner. Per ulteriori informazioni, consulta la sezione Commissione esterna.

Logging

Quando esegui pi@raspberrypi: commissioner-cli dalla riga di comando, OT Commissioner crea un file commissioner.log nella directory di lavoro attuale, ad esempio /home/pi/commissioner.log. Nel file di configurazione JSON, puoi configurare il percorso, il livello di logging e altre impostazioni dei log di LogFile.

Carica configurazione

Per avviare OT Commissioner con le tue impostazioni di configurazione:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

Commissionare un partecipante

Per utilizzare OT Commissioner per effettuare la messa in servizio di un membro, fai riferimento a External Commissioning.