Creazione e configurazione di OpenThread Commissioner

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Visualizza origine su GitHub

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

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
    

Build OT Commissioner

OT Commissioner viene installato nella directory /usr/local. Se vuoi cambiare la directory di installazione, imposta -DCMAKE_INSTALL_PREFIX.

  1. Build 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) Test delle unità:

    ./tests/commissioner-test
    

Installa OT Commissioner

OT Commissioner installa quanto segue nella directory di installazione:

  • File di intestazione e libreria OT Commissioner
  • File 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 consultando 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 OT Commissioner supporta la modalità di messa in servizio commerciale Thread 1.2 (CCM) e la messa in servizio Thread 1.1 (non CCM). Per connetterti a diverse reti Thread, è necessario un file di configurazione JSON per avviare l'interfaccia a riga di comando OT Commissioner:

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

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

Configurazione CCM

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

Campo Descrizione
DomainName L'identificatore univoco all'interno 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 attendibilità in formato PEM.

Questi file di chiavi e certificati vengono utilizzati per stabilire le sessioni protette tra il Commissioner e l'agente di confine.

Configurazione non CCM

La chiave precondivisa PSKc viene utilizzata per stabilire una sessione sicura tra il Commissioner e l'agente di confine. Per connetterti a una rete Thread non CCM, puoi impostare PSKc tramite l'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 per LogFile.

Carica configurazione

Per avviare OT Commissioner con le impostazioni di configurazione:

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

Commissiona un joiner

Per utilizzare OT Commissioner per la commissione di joiner, consulta la sezione Commissione esterna.