Посмотреть исходный код на GitHub
В этом руководстве описывается базовая сборка и настройка OpenThread Commissioner (OT Commissioner). По завершении этой процедуры у вас будет исполняемый файл CLI OT Commissioner и статическая библиотека Commissioner.
Настройка комиссара OT
Клонируйте репозиторий OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Установите зависимости:
cd ot-commissioner
./script/bootstrap.sh
Комиссар по строительству ОТ
OT Commissioner устанавливается в каталог /usr/local
. Если вы хотите изменить каталог установки, установите -DCMAKE_INSTALL_PREFIX
.
Комиссар по ОТ:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Создайте переменную среды для запуска
commissioner-cli
на следующем шаге:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Необязательный . Запустите модульные тесты:
./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 для ввода в эксплуатацию столярного устройства, обратитесь к разделу «Внешний ввод в эксплуатацию» .