OpenThread 调试器构建和配置

<ph type="x-smartling-placeholder"></ph> 在 GitHub 上查看源代码

本指南介绍了 OpenThread 调试器的基本构建和配置（OT 专员）。完成此流程后，您将获得一个 OT Commissioner CLI 可执行文件和静态 Commissioner 库。

设置 OT 调试器

克隆 OT Commissioner 代码库：

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

安装依赖项：

cd ot-commissioner
./script/bootstrap.sh

build OT 调试器

OT Commissioner 将安装到 /usr/local 目录。如果您想更改在安装目录中设置 -DCMAKE_INSTALL_PREFIX。

Build 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 Commissioner 会将以下内容安装到您的安装目录中：

OT Commissioner 库和头文件
OT Commissioner CLI 可执行二进制文件
默认配置文件和凭据
用于将 OT Commissioner CLI 作为守护程序运行的脚本

sudo ninja install

通过查看帮助菜单验证安装。

$COMMISSIONER_CLI -h

如果安装到 /usr/local 目录，则 commissioner-cli 可用。

commissioner-cli -h

配置

OT Commissioner CLI 支持 Thread 1.2 商业调试模式 (CCM) 和 Thread 1.1 调试（非 CCM）。连接到其他 Thread 网络，需要使用 JSON 配置文件才能启动 OT Commissioner CLI：

ccm-config.json - CCM Thread Network 的默认配置文件。
non-ccm-config.json - 非 CCM 线程的默认配置文件网络。

默认情况下，这些配置文件安装在 /usr/local/etc/commissioner 中。您可以还可查看 ot-commissioner GitHub 代码库中的示例文件。

CCM 配置

如需连接到 CCM Thread 网络，请更新 ccm-config.json 中的以下字段：

字段	说明
`DomainName`	企业网域内的唯一标识符。
`PrivateKeyFile`	PEM 格式的私钥文件。
`CertificateFile`	PEM 格式的证书文件。
`TrustAnchorFile`	PEM 格式的信任锚文件。

这些密钥和证书文件用于在 Google Cloud 控制台主管和边境代理人。

非 CCM 配置

预共享密钥 PSKc 用于在主管兼边境代理人。如需连接到非 CCM Thread 网络，您需要可以通过 OT Commissioner CLI 设置 PSKc。如需更多信息请参阅外部调试。

日志记录

从命令行运行 pi@raspberrypi: commissioner-cli 时， OT 调试器在当前工作中创建一个 commissioner.log 文件目录，例如 /home/pi/commissioner.log。在 JSON 配置中文件，您可以配置 LogFile 路径、日志记录级别和其他日志设置。

加载配置

如需使用您的配置设置启动 OT Commissioner，请按以下步骤操作：

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

委托加入人员

如需使用 OT Commissioner 来委托加入者，请参阅外部调试。