网状调试

在 GitHub 上查看源代码

调试器和连接符

调试需要一台设备具有调试器角色,另一台设备具有加入者角色。委托人是现有 Thread 网络中的 Thread 设备,或者是执行委托人角色的 Thread 网络外部设备(例如手机)。Joiner 是指希望加入 Thread 网络的设备。

Thread 委员会成员用于对设备进行网络身份验证。它不会传输或拥有 Thread 网络凭据(例如网络密钥)。

本指南介绍了无需外部委员或边界路由器的基本网状网络调试。如需了解如何使用外部调试器,请参阅外部线程调试

如需查看使用虚拟设备进行调试的示例,请参阅 OpenThread 模拟 Codelab

启用角色

如需启用 Commissioner 和 Joiner 角色,请使用以下 cmake 选项:

选项 说明
-DOT_COMMISSIONER=ON 启用“委员会成员”角色
-DOT_JOINER=ON 启用“加入者”角色

例如,要构建仅用于连接符的 CC2538 示例平台,请使用以下代码:

./script/build -DOT_JOINER=ON

将每个二进制文件刷写到所需设备上。一台设备充当委托方,另一台设备充当加入方。

如需了解如何构建和刷写受支持的平台,请参阅每个平台的 OpenThread 代码库。请访问 OpenThread GitHub 组织,找到该代码库。

创建网络

在充当委托人的设备上创建网络:

dataset init new
Done
dataset
Active Timestamp: 1
Channel: 13
Channel Mask: 07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done
dataset commit active
Done
ifconfig up
Done
thread start
Done

等待几秒钟,然后验证设备是否已成为线程主导:

state
leader
Done

开始使用专员角色

在同一设备上,启动“管理员”角色:

commissioner start
Done

使用 * 通配符允许具有指定“连接符凭据”的任何连接者加入网络。加入者凭据(以及扩展 PAN ID 和网络名称)用于为设备生成预共享密钥 (PSKd)。然后,在线程调试期间,系统会使用 PSKd 对设备进行身份验证。每个设备的连接符凭据应该是唯一的。

commissioner joiner add * J01NME
Done

仅限特定加入者

如需将配置限制为特定 Joiner 设备,请使用 eui64 参数,即设备的出厂分配的 IEEE EUI-64。

在用作 Joiner 的设备上,获取 EUI-64:

eui64
2f57d222545271f1
Done

在 Commissioner 设备上的 commissioner joiner 命令中,使用该值代替 * 通配符:

commissioner joiner add 2f57d222545271f1 J01NME
Done

开始使用“加入者”角色

在用作加入者设备上,恢复出厂设置,然后使用委托人上指定的加入者凭据启用加入者角色:

factoryreset
ifconfig up
Done
joiner start J01NME
Done

等待几秒钟以确认:

Join success!

加入者设备已成功向委托人进行身份验证,并已收到 Thread 网络凭据。

现在,在 Joiner 设备上启动线程:

thread start
Done

验证身份验证

检查“连接器”设备上的状态,以验证它是否已加入网络。在两分钟内,状态会从子级转换为路由器:

state
child
Done
...
state
router
Done