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

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

Это руководство охватывает базовую сборку и настройку OpenThread Commissioner (OT Commissioner). По завершении этой процедуры у вас будет исполняемый файл командной строки 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 и заголовочные файлы
  • Исполняемый двоичный файл CLI комиссара OT
  • Файлы конфигурации и учетные данные по умолчанию
  • Скрипты для запуска OT Commissioner CLI в качестве демона
sudo ninja install

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

$COMMISSIONER_CLI -h

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

commissioner-cli -h

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

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

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

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

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

Чтобы подключиться к сети CCM Thread, обновите эти поля в 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 . В LogFile конфигурации JSON вы можете настроить путь к файлу журнала, уровень ведения журнала и другие параметры журнала.

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

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

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

Заказать столяра

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