Build e configurazione di OpenThread Commissioner

Visualizza il codice sorgente su GitHub

Questa guida illustra la build e la configurazione di base di OpenThread Commissioner. (OT Commissioner). Una volta completata questa procedura, Eseguibile dell'interfaccia a riga di comando di Commissioner e una libreria statica di Commissioner.

Configura OT Commissioner

  1. Clona il repository di OT Commissioner:

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

  2. Installa le dipendenze:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Commissario OT per la creazione

OT Commissioner esegue l'installazione nella directory /usr/local. Se desideri modificare nella directory di installazione, imposta -DCMAKE_INSTALL_PREFIX.

  1. Creazione OT Commissioner:

    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. Facoltativo. Esegui i test delle unità:

    ./tests/commissioner-test
    

Installa OT Commissioner

OT Commissioner installa quanto segue nella directory di installazione:

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

Verifica l'installazione controllando il menu Guida.

$COMMISSIONER_CLI -h

Se hai eseguito l'installazione nella directory /usr/local, commissioner-cli è disponibile dalla riga di comando.

commissioner-cli -h

Configurazione

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

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

Per impostazione predefinita, questi file di configurazione sono installati in /usr/local/etc/commissioner. Puoi Puoi inoltre visualizzare i file di esempio nel repository GitHub di ot-commissioner.

Configurazione CCM

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

Campo Descrizione
DomainName Identificatore univoco all'interno del dominio aziendale.
PrivateKeyFile Il file della chiave privata in formato PEM.
CertificateFile Il file del certificato in formato PEM.
TrustAnchorFile Il file trust anchor in formato PEM.

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

Configurazione non CCM

La chiave precondivisa PSKc viene utilizzata per stabilire una sessione sicura tra Commissario e agente di frontiera. Per connetterti a una rete Thread non CCM, devi puoi impostare PSKc dall'interfaccia a riga di comando di OT Commissioner. Per ulteriori informazioni, consulta la sezione Messa in servizio esterna.

Logging

Quando esegui pi@raspberrypi: commissioner-cli dalla riga di comando, OT Commissioner crea un file commissioner.log nell'attuale standard dell'applicazione, ad esempio /home/pi/commissioner.log. Nella configurazione JSON puoi configurare il percorso LogFile, il livello di logging e altri log impostazioni.

Carica configurazione

Per avviare OT Commissioner con le tue impostazioni di configurazione:

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

Commissione un joiner

Per utilizzare OT Commissioner per commissionare un joiner, consulta le istruzioni Messa in servizio.