Konfigurasi dan Pembuatan Komisaris OpenThread

Lihat sumber di GitHub

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

Menyiapkan Komisaris OT

  1. Clone repositori OT Commissioner:

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

  2. Instal dependensi:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Membuat Komisaris OT

OT Commissioner menginstal ke direktori /usr/local. Jika ingin mengubah direktori penginstalan, tetapkan -DCMAKE_INSTALL_PREFIX.

  1. Membuat Komisaris OT:

    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
    

Menginstal Komisaris OT

OT Commissioner menginstal yang berikut ke direktori penginstalan Anda:

  • Library dan file header OT Commissioner
  • Biner eksekusi yang dapat dijalankan CLI OT Komisaris
  • File konfigurasi dan kredensial default
  • Skrip untuk menjalankan OT Commissioner CLI 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 command line.

commissioner-cli -h

Konfigurasi

OT Commissioner CLI mendukung Thread 1.2 Commercial Commissioning Mode (CCM) dan Thread 1.1 Commissioning (Non-CCM). Agar terhubung ke jaringan Thread yang berbeda, 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 Jaringan Thread Non-CCM.

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

Konfigurasi CCM

Agar dapat terhubung ke jaringan CCM Thread, 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 anchor kepercayaan dalam format PEM.

File kunci dan sertifikat ini digunakan untuk membuat sesi yang aman antara Commissioner dan Border Agent.

Konfigurasi non-CCM

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

Logging

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

Muat konfigurasi

Untuk memulai OT Commissioner dengan setelan konfigurasi:

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

Membuat komisi joiner

Untuk menggunakan Komisaris OT untuk membuat komisi penggabung, lihat Komisi Eksternal.