Google 致力于为黑人社区推动种族平等。查看具体行动

OpenThread Debugger 构建和配置

在 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 调试程序 CLI 作为守护进程运行的脚本
sudo ninja install

查看帮助菜单以验证安装效果。

$COMMISSIONER_CLI -h

如果您安装到 /usr/local 目录,可以通过命令行访问 commissioner-cli

commissioner-cli -h

配置

OT 调试程序 CLI 支持线程 1.2 商业调试模式 (CCM) 和线程 1.1 调试(非 CCM)。如需连接到不同的线程网络,需要 JSON 配置文件才能启动 OT 调试程序 CLI:

  • 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 线程网络,您可以从 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 调试器委托连接器,请参阅外部佣金