Build dan Konfigurasi OpenThread Commissioner

Lihat sumber di GitHub

Panduan ini membahas build dan konfigurasi dasar OpenThread Commissioner (Komisi OT). Setelah menyelesaikan prosedur ini, Anda akan memiliki OT CLI Commissioner yang dapat dieksekusi dan library Commissioner statis.

Menyiapkan OT Commissioner

  1. Clone repositori OT Commissioner: 

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

  2. Instal dependensi: 

    cd ot-commissioner
./script/bootstrap.sh

Membangun OT Commissioner

OT Commissioner diinstal ke direktori /usr/local. Jika Anda ingin mengubah direktori penginstalan Anda, setel -DCMAKE_INSTALL_PREFIX.

  1. Build OT Commissioner: 

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

  2. Buat variabel Lingkungan untuk menjalankan commissioner-cli di langkah berikutnya: 

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

  3. Opsional. Jalankan pengujian unit: 

    ./tests/commissioner-test

Instal OT Commissioner

OT Commissioner menginstal berikut ini ke direktori penginstalan Anda:

  • File header dan library OT Commissioner
  • Biner CLI Commissioner OT yang dapat dieksekusi
  • File konfigurasi dan kredensial default
  • Skrip untuk menjalankan CLI Commissioner OT sebagai daemon
sudo ninja install

Verifikasi penginstalan dengan memeriksa menu bantuan.

$COMMISSIONER_CLI -h

Jika Anda menginstal ke direktori /usr/local, commissioner-cli tersedia dari baris perintah.

commissioner-cli -h

Konfigurasi

OT Commissioner CLI mendukung Mode Commissioning Komersial Thread 1.2 (CCM) dan commissioning Thread 1.1 (Non-CCM). Untuk terhubung ke Thread lain jaringan, file konfigurasi JSON diperlukan untuk memulai OT Commissioner CLI:

  • ccm-config.json — File konfigurasi default untuk CCM Thread Network.
  • non-ccm-config.json — File konfigurasi default untuk Thread Non-CCM Jaringan.

Secara default, file konfigurasi ini diinstal di /usr/local/etc/commissioner. Anda dapat lihat juga file contoh di repositori GitHub ot-commissioner.

Konfigurasi CCM

Untuk terhubung ke jaringan Thread CCM, perbarui kolom berikut di ccm-config.json:

Kolom Deskripsi
DomainName ID unik dalam Domain Perusahaan.
PrivateKeyFile File kunci pribadi dalam format PEM.
CertificateFile File sertifikat dalam format PEM.
TrustAnchorFile File trust anchor dalam format PEM.

File kunci dan sertifikat ini digunakan untuk membuat sesi yang aman di antara Commissioner dan Agen Perbatasan.

Konfigurasi non-CCM

Kunci yang Dibagikan Sebelumnya PSKc digunakan untuk membuat sesi yang aman antara Commissioner dan Agen Perbatasan. Agar terhubung ke jaringan Thread Non-CCM, Anda dapat menetapkan PSKc Anda dari OT Commissioner CLI. Untuk informasi selengkapnya, lihat Penetapan Komisi Eksternal.

Logging

Saat Anda menjalankan pi@raspberrypi: commissioner-cli dari command line, OT Commissioner membuat file commissioner.log dalam fungsi saat ini direktori, misalnya /home/pi/commissioner.log. Dalam konfigurasi JSON Anda dapat mengonfigurasi jalur LogFile, level logging, dan log setelan.

Muat konfigurasi

Untuk memulai OT Commissioner dengan setelan konfigurasi Anda:

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

Memberikan tugas untuk bergabung

Untuk menggunakan OT Commissioner guna meminta penggabungan, lihat Eksternal Commissioning.