OT 专员 CLI

在 GitHub 上查看源代码

OT 调试器 CLI 支持外部调试,可在 ot-commissioner GitHub 代码库中获取。

在本指南中,您将构建并安装 OT 调试器并调试一位连接程序。

设置 OT 调试器

如需使用 OT 调试器 CLI,请先构建 OT 调试器

探索您的网络

如需启动 OT 调试器,您需要查找边界代理服务的 IP 地址和端口号。如需有关如何查找此信息的帮助,请参阅 mDNS Discovery。边界代理支持 IPv4 和 IPv6 连接。

连接到边界路由器

  1. 启动 OT 调试器 CLI:

    commissioner-cli
    
    
  2. 设置 PSKc:

    config set pskc 198886f519a8fd7c981fee95d72f4ba7
    [done]
    
  3. 连接到 OTBR,并提供 mDNS IP 地址和端口:

    start FD00::74D0:6FC9:6BE6:3582 49155
    [done]
    >
    
  4. 验证调试器处于有效状态:

    active
    true
    [done]
    
    

调试细木工

连接到边界路由器后,OT 调试器就可以对连接器设备进行调试。

  1. 在 OT 调试器中,为所有密码为 J01NU5 的联接器启用 Thread MeshCoP 联接器:

    joiner enableall meshcop J01NU5
    [done]
    
    

  2. 在 Joiner 设备上,使用 OT 调试器中配置的密码启动 Joiner 角色:

    ifconfig up
    Done
    joiner start J01NU5
    Done
    

  3. 等待调试器和连接器之间等待 DTLS 握手完成:

    
    Join success!
    

加入 Thread 网络

接下来,在 Joiner 设备上加入 Thread 网络并测试网络连接。

问题排查

如果您在使用 OT 调试器时遇到问题,请检查 commissioner.log(如果有)。如需配置日志记录,请参阅构建 OT 调试器

IO_ERROR:将套接字连接到对等地址

尝试使用其他 IP 地址启动 OT 调试器。

IO_ERROR:NET - 无法从套接字读取信息

当进行绑定或连接到 OTBR 的调用失败时,套接字 API 会返回此错误消息。如果您收到此错误消息,请尝试以下操作:

  • 启动 OT 调试器时,请确保传递的端口号正确无误。OTBR 可能会在重启后或您重新启动平台后使用其他端口。
  • 请确保 OTBR 正在运行,并且您的 Thread 网络(包括 PSKc)已正确配置。您的密码/佣金凭据必须是介于 6 到 255 个字符之间的字符串。
  • 检查全局 IP 地址,例如 ifconfig eth0。您使用的 IP 地址可能用于启动 OT 调试器。

安全性:SSL - 从我们的同行收到了严重提醒消息

OT 调试器与边界代理服务建立了安全的 DTLS 会话。 严重 SSL 错误通常表示安全 DTLS 会话失败。

如果您收到此消息,请检查您的 PSK。

来自 OTBR:

sudo ot-ctl pskc
198886f519a8fd7c981fee95d72f4ba7
Done

来自 OT Commissioner:

config get pskc
198886f519a8fd7c981fee95d72f4ba7
[done]

资源

如需了解其他 commissioner-cli 命令,请参阅 OT 调试器 CLI