Сборка и настройка OpenThread Commissioner

Посмотреть исходный код на GitHub

В этом руководстве описывается базовая сборка и настройка OpenThread Commissioner (OT Commissioner). По завершении этой процедуры у вас будет исполняемый файл CLI OT Commissioner и статическая библиотека Commissioner.

Настройка комиссара OT

  1. Клонируйте репозиторий OT Commissioner:

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

  2. Установите зависимости:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Комиссар по строительству ОТ

OT Commissioner устанавливается в каталог /usr/local . Если вы хотите изменить каталог установки, установите -DCMAKE_INSTALL_PREFIX .

  1. Комиссар по ОТ:

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

  2. Создайте переменную среды для запуска commissioner-cli на следующем шаге:

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

  3. Необязательный . Запустите модульные тесты:

    ./tests/commissioner-test
    

Установить Комиссара ОТ

OT Commissioner устанавливает в ваш установочный каталог следующее:

  • Библиотека OT Commissioner и заголовочные файлы
  • Исполняемый двоичный файл OT Commissioner CLI
  • Файлы конфигурации и учетные данные по умолчанию
  • Скрипты для запуска CLI OT Commissioner в качестве демона
sudo ninja install

Проверьте установку, проверив меню справки.

$COMMISSIONER_CLI -h

Если вы установили в каталог /usr/local , commissioner-cli доступен из командной строки.

commissioner-cli -h

Конфигурация

Интерфейс командной строки OT Commissioner поддерживает как режим коммерческого ввода в эксплуатацию потока 1.2 (CCM), так и ввод в эксплуатацию потока 1.1 (без CCM). Для подключения к различным сетям Thread необходим файл конфигурации JSON для запуска CLI OT Commissioner:

  • ccm-config.json — файл конфигурации по умолчанию для сети потоков CCM.
  • non-ccm-config.json — файл конфигурации по умолчанию для сети потоков без CCM.

По умолчанию эти файлы конфигурации устанавливаются в /usr/local/etc/commissioner . Вы также можете просмотреть файлы примеров в репозитории ot-commissioner на GitHub .

Конфигурация CCM

Чтобы подключиться к сети потоков CCM, обновите эти поля в ccm-config.json :

Поле Описание
DomainName Уникальный идентификатор в домене предприятия.
PrivateKeyFile Файл закрытого ключа в формате PEM.
CertificateFile Файл сертификата в формате PEM.
TrustAnchorFile Файл привязки доверия в формате PEM.

Эти файлы ключей и сертификатов используются для установления безопасных сеансов между комиссаром и пограничным агентом.

Конфигурация без CCM

Предварительный общий ключ PSKc используется для установления безопасного сеанса между комиссаром и пограничным агентом. Чтобы подключиться к сети потоков, не относящихся к CCM, вы можете настроить PSKc из интерфейса командной строки OT Commissioner. Дополнительную информацию см. в разделе Внешний ввод в эксплуатацию .

Ведение журнала

Когда вы запускаете pi@raspberrypi: commissioner-cli из командной строки, OT Commissioner создает файл commissioner.log в текущем рабочем каталоге, например /home/pi/commissioner.log . В файле конфигурации JSON вы можете настроить путь LogFile , уровень ведения журнала и другие параметры журнала.

Загрузить конфигурацию

Чтобы запустить OT Commissioner с вашими настройками конфигурации:

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

Нанять столяра

Чтобы использовать OT Commissioner для ввода в эксплуатацию столярного устройства, обратитесь к разделу «Внешний ввод в эксплуатацию» .