OpenThread Commissioner 构建和配置

在 GitHub 上查看源代码

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

设置 OT 调试器

  1. 克隆 OT 调试器代码库:

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

  2. 安装依赖项:

    cd ot-commissioner
    ./script/bootstrap.sh
    

构建 OT 调试器

OT 调试器安装到 /usr/local 目录。如果您希望更改安装目录,请设置 -DCMAKE_INSTALL_PREFIX

  1. 构建 OT 调试器:

    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 调试器

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 调试器来调试连接器,请参阅外部调试