本指南介绍了 OpenThread Commissioner(OT 调试器)的基本构建和配置。完成此过程后,您将获得一个 OT 调试器 CLI 可执行文件和一个静态调试器库。
设置 OT 调试器
克隆 OT 调试器代码库:
git clone https://github.com/openthread/ot-commissioner
安装依赖项:
cd ot-commissioner
./script/bootstrap.sh
构建 OT 调试器
OT 调试器安装到 /usr/local
目录。如果您希望更改安装目录,请设置 -DCMAKE_INSTALL_PREFIX
。
构建 OT 调试器:
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 调试器
OT 调试器会将以下内容安装到您的安装目录中:
- OT 调试器库和头文件
- OT 调试器 CLI 可执行文件
- 默认配置文件和凭据
- 用于将 OT Commissioner CLI 作为守护程序运行的脚本
sudo ninja install
通过查看帮助菜单来验证安装。
$COMMISSIONER_CLI -h
如果安装到 /usr/local
目录中,您可以通过命令行使用 commissioner-cli
。
commissioner-cli -h
配置
OT 调试器 CLI 支持 Thread 1.2 商业调试模式 (CCM) 和 Thread 1.1 调试 (Non-CCM)。如需连接到不同的线程网络,需要使用 JSON 配置文件才能启动 OT 调试器 CLI:
ccm-config.json
- CCM 线程网络的默认配置文件。non-ccm-config.json
- 非 CCC 线程网络的默认配置文件。
默认情况下,这些配置文件安装在 /usr/local/etc/commissioner
中。您还可以在 ot-commissioner GitHub 代码库中查看示例文件。
CCM 配置
如需连接到 CCM Thread 网络,请更新 ccm-config.json
中的以下字段:
字段 | 说明 |
---|---|
DomainName |
企业网域内的唯一标识符。 |
PrivateKeyFile |
采用 PEM 格式的私钥文件。 |
CertificateFile |
PEM 格式的证书文件。 |
TrustAnchorFile |
PEM 格式的信任锚文件。 |
这些密钥和证书文件用于在调试器和边界代理之间建立安全会话。
非 CCM 配置
预共享密钥 PSKc
用于在专员和边界代理之间建立安全会话。如需连接到非 CCM 线程网络,您可以通过 OT 调试器 CLI 设置您的 PSKc
。如需了解详情,请参阅外部调试。
日志记录
从命令行运行 pi@raspberrypi: commissioner-cli
时,OT 调试器会在当前工作目录中创建一个 commissioner.log
文件,例如 /home/pi/commissioner.log
。在 JSON 配置文件中,您可以配置 LogFile
路径、日志记录级别和其他日志设置。
加载配置
如需使用配置设置启动 OT 调试器,请执行以下操作:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
委托员工
如需使用 OT 调试器来调试连接器,请参阅外部调试。