arduino-esp32 OpenThread CommissionerNode 实战Leader Commissioner 双角色安全组建 Thread 网络【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文基于 arduino-esp32 仓库中 CommissionerNode 示例文档 及其源码 CommissionerNode.ino 展开讲解如何用 OpenThread Native API 在一块 ESP32-H2 / C6 / C5 开发板上组建一个全新的 Thread 网络本地构建 Operational Dataset 并使其成为 Leader申请 Commissioner 角色再通过物理按钮触发addJoiner()打开加入窗口Joiner Window让第二块设备仅凭共享密钥 PSKd 就能安全入网。读完本文你将完整掌握 Commissioner 侧的调用顺序、关键宏配置、sdkconfig 要求、串口输出判读与常见故障排查方法。1. 定位CommissionerNode 是服务端CommissionerNode 与 JoinerNode 示例 是一对双板演示属于 Thread Commissioning 分组总览 中的Leader Commissioner角色。传统做法是把 network key 直接烧录进新设备的 sketch而本演示的关键点是新设备Joiner事先不知道网络密钥、网络名、PAN ID 中的任何一项它在 MeshCoP/DTLS 认证握手中只出示 PSKd网络信息通过空中下发。网络密钥在链路上从不以明文出现——它是在握手过程中由 PSKd 派生的。CommissionerNode 具体做了五件事与文档一致用硬编码的DataSet网络名、信道THREAD_CHANNEL、PAN ID、扩展 PAN ID、网络密钥组建一个全新 Thread 网络通过networkInterfaceUp()start()成为新分区的Leader一旦 attached自动申请Commissioner角色仅在按下按钮JOIN_BUTTON_PIN默认 BOOT时调用addJoiner(PSKD, 120)打开加入窗口接受任何出示 PSKdJ01NME的 Joiner在loop()中每 5 秒打印角色、RLOC、地址与 Commissioner 状态。重要提示原文档强调Commissioner 角色在 attach 后会自动开始但在你按下按钮之前不会接受任何 Joiner。必须等串口出现Press the button on GPIO ... to open the joiner window之后再按JOIN_BUTTON_PIN。这一申请角色与打开窗口的分离是 Thread 入网安全的核心角色是持续状态窗口是限时、按需开启的授权入口。2. 支持的芯片与 sdkconfig 要求2.1 支持的 TargetSoCThread 支持按钮引脚状态ESP32-H2支持BOOT_PINSupportedESP32-C6支持BOOT_PINSupportedESP32-C5支持BOOT_PINSupported如果开发板的按键不在 BOOT 引脚上可以在 sketch 顶部覆盖JOIN_BUTTON_PIN。从 CommissionerNode.ino 的注释可以看到BOOT_PIN是 Arduino 核心按板型提供的宏C6/H2 上为 GPIO9C5 上为 GPIO28BOOT 键为低电平有效因此 sketch 中用INPUT_PULLUP上拉后检测下降沿。2.2 必需的 IDF 特性sdkconfig特性作用CONFIG_OPENTHREAD_ENABLEDy构建 OpenThread 协议栈CONFIG_SOC_IEEE802154_SUPPORTEDy确保 SoC 具备 802.15.4 射频CONFIG_OPENTHREAD_COMMISSIONERy使能 Commissioner API这三项与示例目录下的 ci.yml 完全一致——验证测试正是按这些 requires 配置编译运行的。从 OThread.cpp 的源码结构看整段 Commissioner 实现startCommissioner、addJoiner、stopCommissioner、getCommissionerState都包裹在#if CONFIG_OPENTHREAD_COMMISSIONER条件编译中即不开启该 Kconfig 时这些 API 根本不存在这是必须显式使能的源码级依据。3. 前置条件与操作顺序先烧录本 CommissionerNode sketch再烧录 JoinerNode客户端。等待串口显示 attached 且Commissioner ACTIVE后按下 BOOT 键打开加入窗口然后才启动或复位Joiner。窗口保持打开 120 秒JOINER_WINDOW_SEC窗口过期后再按一次按钮即可重新打开。固定THREAD_CHANNEL默认 15使其与 Joiner 侧的信道提示一致避免 Joiner 全信道扫描。4. 工作流程解析对照源码文档给出的最小工作流与 CommissionerNode.ino 的实际实现一一对应// 1) 组建 Thread 网络并成为 Leader。 threadCommissionerNode.begin(false); dataset.initNew(); dataset.setNetworkName(ESP_OT_Joiner); dataset.setChannel(THREAD_CHANNEL); dataset.setPanId(0x1234); // ... ext PAN ID, network key ... threadCommissionerNode.commitDataSet(dataset); threadCommissionerNode.networkInterfaceUp(); threadCommissionerNode.start(); // 2) attached 之后申请 Commissioner在 loop() 中。 threadCommissionerNode.startCommissioner(); // 3) 按钮按下时打开加入窗口。 if (joinButtonPressed()) { threadCommissionerNode.addJoiner(J01NME, 120); }4.1 setup()构建并下发 Operational Datasetsetup()第 73–103 行的关键细节threadCommissionerNode.begin(false)参数false表示不自动从 NVS 加载数据集——因为本演示要的是从零组建不是恢复旧网络。dataset.initNew()生成一个合法的新数据集骨架随后逐项覆盖网络名ESP_OT_Joiner扩展 PAN ID 8 字节{0xDE, 0xAD, 0x00, 0xBE, 0xEF, 0x00, 0xCA, 0xFE}即串口输出中的dead00beef00cafe网络密钥 16 字节00 11 22 ... ff演示用生产环境必须更换dataset.setChannel(THREAD_CHANNEL)与setPanId(0x1234)固定物理层参数。commitDataSet(dataset)→networkInterfaceUp()→start()三步把栈拉起来设备随即进入等待成为 Leader状态。关于固定信道initNew()本身会选择一个有效近随机信道网络没有setChannel也能组建固定它只是为了与 Joiner 侧的THREAD_CHANNEL提示对齐让 Joiner 免扫描直接入网。4.2 loop()attached 后申请 Commissioner按键开窗口loop()第 105–188 行按三段逻辑运转a条件申请角色。每轮先读otGetDeviceRole()只要不是OT_ROLE_DETACHED/OT_ROLE_DISABLED就视为 attached。首次 attached 且尚未申请时调用otError err threadCommissionerNode.startCommissioner(/*timeoutMs*/30000); if (err ! OT_ERROR_NONE) { Serial.printf(Commissioner petition failed (err%d). Retrying in 5 s...\r\n, err); delay(5000); return; }失败时 5 秒后重试成功后置commissionerStarted true并打印提示Press the button on GPIO %u to open the joiner window.。b按键触发addJoiner。按键检测函数joinButtonPressed()第 62–71 行用静态变量记录上一轮电平检测高→低的下降沿并delay(50)去抖保证一次物理按压只返回一次true。按下后执行otError err threadCommissionerNode.addJoiner(PSKD, JOINER_WINDOW_SEC); if (err OT_ERROR_NONE) { Serial.printf(Joiner window OPEN: PSKd \%s\ accepted for %lu s.\r\n, PSKD, (unsigned long)JOINER_WINDOW_SEC); }c每 5 秒打印状态而不阻塞按键。loop()尾部用millis()节流未满 5 秒时delay(20); return;把 CPU 让给按键检测满 5 秒则打印角色、RLOC16、网络名、信道、PAN ID、扩展 PAN、Mesh Local EID、Leader RLOC、Node RLOC以及由getCommissionerState()映射出的DISABLED / PETITION / ACTIVE状态。若角色发生变化例如从 Detached 变为 Leader还会调用clearAllAddressCache()清除地址缓存。4.3 底层实现startCommissioner 与 addJoiner 做了什么OThread.cpp 中这两个同步封装的源码揭示了它们的行为边界startCommissioner(timeoutMs)是同步阻塞调用内部通过otCommissionerStart(mInstance, commissionerStateCallback, ...)向 Leader 发起 petition状态回调commissionerStateCallback在 OpenThread 任务中运行当状态变为ACTIVE成功或回落到DISABLED被拒绝时释放二进制信号量调用方在timeoutMs默认 30 s本示例显式传 30000 ms内等待该信号量超时则自动调用otCommissionerStop()并返回OT_ERROR_RESPONSE_TIMEOUT已处于 ACTIVE 时返回OT_ERROR_ALREADY封装层将其折算为OT_ERROR_NONE。addJoiner(pskd, timeoutSec, eui64)是非阻塞转发持OtLock后直接调用otCommissionerAddJoiner(mInstance, eui64, pskd, timeoutSec)。eui64传nullptr默认值即接受任何出示该 PSKd 的设备传入具体 EUI-64 则可白名单化到单一设备。PSKd 为空指针时返回OT_ERROR_INVALID_ARGS。对照 OpenThread 库 README 的 Commissioner 章节API 签名为otError startCommissioner(uint32_t timeoutMs 30000); otError addJoiner(const char *pskd, uint32_t timeoutSec 120, const otExtAddress *eui64 nullptr); void stopCommissioner(); otCommissionerState getCommissionerState() const;其中getCommissionerState()在实例未初始化或锁获取失败时一律返回OT_COMMISSIONER_STATE_DISABLED这也是示例串口打印中未申请成功就显示 DISABLED的原因。5. 预期串口输出按 README 给出的完整预期输出115200 波特率 Joiner Demo - Commissioner Node Thread network started, waiting to become Leader... Attached as Leader. Petitioning Commissioner... Commissioner ACTIVE. Press the button on GPIO 9 to open the joiner window. Role: Leader RLOC16: 0x0000 Network Name: ESP_OT_Joiner Channel: 15 PAN ID: 0x1234 Extended PAN: dead00beef00cafe Mesh Local EID: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... Commissioner: ACTIVE -- press the BOOT button here -- Joiner window OPEN: PSKd J01NME accepted for 120 s. Bring up the JoinerNode sketch now.其中RLOC16: 0x0000与Leader RLOC指向fdde:ad00:...前缀由扩展 PAN IDdead00beef00cafe派生的 mesh-local 前缀fdde:ad00:beef是自举分区的典型特征——Leader 的 RLOC 恒为 0。出现Joiner window OPEN之后才是烧录/复位 JoinerNode 的时机。6. 构建期宏定制sketch 顶部的四个宏均可用-D编译标志覆盖见 CommissionerNode.ino 第 30–54 行宏默认值用途THREAD_CHANNEL15802.15.4 信道11..26。必须与 Joiner 侧THREAD_CHANNEL一致。JOIN_BUTTON_PINBOOT_PIN打开加入窗口的低电平有效按键 GPIO。PSKDJ01NMEaddJoiner()接受的 Pre-Shared Key for Device。JOINER_WINDOW_SEC120每条addJoiner()记录的有效时长秒。PSKd 的格式约束来自 OpenThread READMEASCII 字符串6–32 个字符使用 base32-thread 字母表——数字与大写字母排除I、O、Q和数字0双端必须完全一致。源码注释还提醒JOINER_WINDOW_SEC对演示绑定的单 Joiner 足够宽裕生产环境应缩短窗口并配合eui64参数做设备级白名单。7. 故障排查启动顺序先烧本 Commissioner sketch等 Leader CommissionerACTIVE在烧 JoinerNode 之前按 BOOT 键120 s 过期后按再次开窗然后复位 Joiner。现象可能原因Commissioner petition failed设备尚未 attached或分区内已有其他 Commissioner 活动——重试或先停掉另一个 Commissioner。Joiner 一直不出现加入窗口未打开——先按按钮确认串口出现Joiner window OPEN再启动 JoinerNode。加入窗口过期窗口仅 120 s——再按一次按钮重新打开然后复位 Joiner。addJoiner failedPSKd 非法——须为 6–32 字符 ASCIIbase32-thread 字母表不含0、I、O、Q源码层还可能因 Commissioner 表满而失败OT_ERROR_NO_BUFS。Joiner 在错误信道上两个 sketch 必须使用相同THREAD_CHANNEL。从实现细节补充两条排查思路startCommissioner()返回非OT_ERROR_NONE时常见为OT_ERROR_REJECTEDpetition 被拒即分区内已有 Commissioner 或状态回落DISABLED与OT_ERROR_RESPONSE_TIMEOUT30 s 内无响应封装层已自动otCommissionerStop()所以 5 秒后重试是安全的串口若始终停在Status: Detached/Disabled - waiting for network start...说明start()之后的角色尚未推进先确认 sdkconfig 中CONFIG_SOC_IEEE802154_SUPPORTEDy且板型为 H2/C6/C5。8. 相关示例与延伸阅读Thread Commissioning 分组总览——两块板的完整运行顺序与双端排查表含CONFIG_OPENTHREAD_JOINERy的 Joiner 侧要求。JoinerNode客户端——无本地 DataSet、仅凭 PSKd 走startJoiner()入网的配套 sketch。UDP Light Switch — light服务端——Commissioner UDP 灯服务端的组合演示。Native 示例总目录 与 SimpleThreadNetwork——后者是直接共享网络密钥的简单组网方式可对照理解为什么要做 Commissioning。OpenThread 库 README——startJoiner/startCommissioner/addJoiner的 API 参考、三个超时的配对建议startJoiner(..., timeoutSec_for_commissioner * 1000 10000)与错误码清单。本示例遵循 Apache License 2.0见仓库 LICENSE.md。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
arduino-esp32 OpenThread CommissionerNode 实战：Leader + Commissioner 双角色安全组建 Thread 网络
arduino-esp32 OpenThread CommissionerNode 实战Leader Commissioner 双角色安全组建 Thread 网络【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文基于 arduino-esp32 仓库中 CommissionerNode 示例文档 及其源码 CommissionerNode.ino 展开讲解如何用 OpenThread Native API 在一块 ESP32-H2 / C6 / C5 开发板上组建一个全新的 Thread 网络本地构建 Operational Dataset 并使其成为 Leader申请 Commissioner 角色再通过物理按钮触发addJoiner()打开加入窗口Joiner Window让第二块设备仅凭共享密钥 PSKd 就能安全入网。读完本文你将完整掌握 Commissioner 侧的调用顺序、关键宏配置、sdkconfig 要求、串口输出判读与常见故障排查方法。1. 定位CommissionerNode 是服务端CommissionerNode 与 JoinerNode 示例 是一对双板演示属于 Thread Commissioning 分组总览 中的Leader Commissioner角色。传统做法是把 network key 直接烧录进新设备的 sketch而本演示的关键点是新设备Joiner事先不知道网络密钥、网络名、PAN ID 中的任何一项它在 MeshCoP/DTLS 认证握手中只出示 PSKd网络信息通过空中下发。网络密钥在链路上从不以明文出现——它是在握手过程中由 PSKd 派生的。CommissionerNode 具体做了五件事与文档一致用硬编码的DataSet网络名、信道THREAD_CHANNEL、PAN ID、扩展 PAN ID、网络密钥组建一个全新 Thread 网络通过networkInterfaceUp()start()成为新分区的Leader一旦 attached自动申请Commissioner角色仅在按下按钮JOIN_BUTTON_PIN默认 BOOT时调用addJoiner(PSKD, 120)打开加入窗口接受任何出示 PSKdJ01NME的 Joiner在loop()中每 5 秒打印角色、RLOC、地址与 Commissioner 状态。重要提示原文档强调Commissioner 角色在 attach 后会自动开始但在你按下按钮之前不会接受任何 Joiner。必须等串口出现Press the button on GPIO ... to open the joiner window之后再按JOIN_BUTTON_PIN。这一申请角色与打开窗口的分离是 Thread 入网安全的核心角色是持续状态窗口是限时、按需开启的授权入口。2. 支持的芯片与 sdkconfig 要求2.1 支持的 TargetSoCThread 支持按钮引脚状态ESP32-H2支持BOOT_PINSupportedESP32-C6支持BOOT_PINSupportedESP32-C5支持BOOT_PINSupported如果开发板的按键不在 BOOT 引脚上可以在 sketch 顶部覆盖JOIN_BUTTON_PIN。从 CommissionerNode.ino 的注释可以看到BOOT_PIN是 Arduino 核心按板型提供的宏C6/H2 上为 GPIO9C5 上为 GPIO28BOOT 键为低电平有效因此 sketch 中用INPUT_PULLUP上拉后检测下降沿。2.2 必需的 IDF 特性sdkconfig特性作用CONFIG_OPENTHREAD_ENABLEDy构建 OpenThread 协议栈CONFIG_SOC_IEEE802154_SUPPORTEDy确保 SoC 具备 802.15.4 射频CONFIG_OPENTHREAD_COMMISSIONERy使能 Commissioner API这三项与示例目录下的 ci.yml 完全一致——验证测试正是按这些 requires 配置编译运行的。从 OThread.cpp 的源码结构看整段 Commissioner 实现startCommissioner、addJoiner、stopCommissioner、getCommissionerState都包裹在#if CONFIG_OPENTHREAD_COMMISSIONER条件编译中即不开启该 Kconfig 时这些 API 根本不存在这是必须显式使能的源码级依据。3. 前置条件与操作顺序先烧录本 CommissionerNode sketch再烧录 JoinerNode客户端。等待串口显示 attached 且Commissioner ACTIVE后按下 BOOT 键打开加入窗口然后才启动或复位Joiner。窗口保持打开 120 秒JOINER_WINDOW_SEC窗口过期后再按一次按钮即可重新打开。固定THREAD_CHANNEL默认 15使其与 Joiner 侧的信道提示一致避免 Joiner 全信道扫描。4. 工作流程解析对照源码文档给出的最小工作流与 CommissionerNode.ino 的实际实现一一对应// 1) 组建 Thread 网络并成为 Leader。 threadCommissionerNode.begin(false); dataset.initNew(); dataset.setNetworkName(ESP_OT_Joiner); dataset.setChannel(THREAD_CHANNEL); dataset.setPanId(0x1234); // ... ext PAN ID, network key ... threadCommissionerNode.commitDataSet(dataset); threadCommissionerNode.networkInterfaceUp(); threadCommissionerNode.start(); // 2) attached 之后申请 Commissioner在 loop() 中。 threadCommissionerNode.startCommissioner(); // 3) 按钮按下时打开加入窗口。 if (joinButtonPressed()) { threadCommissionerNode.addJoiner(J01NME, 120); }4.1 setup()构建并下发 Operational Datasetsetup()第 73–103 行的关键细节threadCommissionerNode.begin(false)参数false表示不自动从 NVS 加载数据集——因为本演示要的是从零组建不是恢复旧网络。dataset.initNew()生成一个合法的新数据集骨架随后逐项覆盖网络名ESP_OT_Joiner扩展 PAN ID 8 字节{0xDE, 0xAD, 0x00, 0xBE, 0xEF, 0x00, 0xCA, 0xFE}即串口输出中的dead00beef00cafe网络密钥 16 字节00 11 22 ... ff演示用生产环境必须更换dataset.setChannel(THREAD_CHANNEL)与setPanId(0x1234)固定物理层参数。commitDataSet(dataset)→networkInterfaceUp()→start()三步把栈拉起来设备随即进入等待成为 Leader状态。关于固定信道initNew()本身会选择一个有效近随机信道网络没有setChannel也能组建固定它只是为了与 Joiner 侧的THREAD_CHANNEL提示对齐让 Joiner 免扫描直接入网。4.2 loop()attached 后申请 Commissioner按键开窗口loop()第 105–188 行按三段逻辑运转a条件申请角色。每轮先读otGetDeviceRole()只要不是OT_ROLE_DETACHED/OT_ROLE_DISABLED就视为 attached。首次 attached 且尚未申请时调用otError err threadCommissionerNode.startCommissioner(/*timeoutMs*/30000); if (err ! OT_ERROR_NONE) { Serial.printf(Commissioner petition failed (err%d). Retrying in 5 s...\r\n, err); delay(5000); return; }失败时 5 秒后重试成功后置commissionerStarted true并打印提示Press the button on GPIO %u to open the joiner window.。b按键触发addJoiner。按键检测函数joinButtonPressed()第 62–71 行用静态变量记录上一轮电平检测高→低的下降沿并delay(50)去抖保证一次物理按压只返回一次true。按下后执行otError err threadCommissionerNode.addJoiner(PSKD, JOINER_WINDOW_SEC); if (err OT_ERROR_NONE) { Serial.printf(Joiner window OPEN: PSKd \%s\ accepted for %lu s.\r\n, PSKD, (unsigned long)JOINER_WINDOW_SEC); }c每 5 秒打印状态而不阻塞按键。loop()尾部用millis()节流未满 5 秒时delay(20); return;把 CPU 让给按键检测满 5 秒则打印角色、RLOC16、网络名、信道、PAN ID、扩展 PAN、Mesh Local EID、Leader RLOC、Node RLOC以及由getCommissionerState()映射出的DISABLED / PETITION / ACTIVE状态。若角色发生变化例如从 Detached 变为 Leader还会调用clearAllAddressCache()清除地址缓存。4.3 底层实现startCommissioner 与 addJoiner 做了什么OThread.cpp 中这两个同步封装的源码揭示了它们的行为边界startCommissioner(timeoutMs)是同步阻塞调用内部通过otCommissionerStart(mInstance, commissionerStateCallback, ...)向 Leader 发起 petition状态回调commissionerStateCallback在 OpenThread 任务中运行当状态变为ACTIVE成功或回落到DISABLED被拒绝时释放二进制信号量调用方在timeoutMs默认 30 s本示例显式传 30000 ms内等待该信号量超时则自动调用otCommissionerStop()并返回OT_ERROR_RESPONSE_TIMEOUT已处于 ACTIVE 时返回OT_ERROR_ALREADY封装层将其折算为OT_ERROR_NONE。addJoiner(pskd, timeoutSec, eui64)是非阻塞转发持OtLock后直接调用otCommissionerAddJoiner(mInstance, eui64, pskd, timeoutSec)。eui64传nullptr默认值即接受任何出示该 PSKd 的设备传入具体 EUI-64 则可白名单化到单一设备。PSKd 为空指针时返回OT_ERROR_INVALID_ARGS。对照 OpenThread 库 README 的 Commissioner 章节API 签名为otError startCommissioner(uint32_t timeoutMs 30000); otError addJoiner(const char *pskd, uint32_t timeoutSec 120, const otExtAddress *eui64 nullptr); void stopCommissioner(); otCommissionerState getCommissionerState() const;其中getCommissionerState()在实例未初始化或锁获取失败时一律返回OT_COMMISSIONER_STATE_DISABLED这也是示例串口打印中未申请成功就显示 DISABLED的原因。5. 预期串口输出按 README 给出的完整预期输出115200 波特率 Joiner Demo - Commissioner Node Thread network started, waiting to become Leader... Attached as Leader. Petitioning Commissioner... Commissioner ACTIVE. Press the button on GPIO 9 to open the joiner window. Role: Leader RLOC16: 0x0000 Network Name: ESP_OT_Joiner Channel: 15 PAN ID: 0x1234 Extended PAN: dead00beef00cafe Mesh Local EID: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... Commissioner: ACTIVE -- press the BOOT button here -- Joiner window OPEN: PSKd J01NME accepted for 120 s. Bring up the JoinerNode sketch now.其中RLOC16: 0x0000与Leader RLOC指向fdde:ad00:...前缀由扩展 PAN IDdead00beef00cafe派生的 mesh-local 前缀fdde:ad00:beef是自举分区的典型特征——Leader 的 RLOC 恒为 0。出现Joiner window OPEN之后才是烧录/复位 JoinerNode 的时机。6. 构建期宏定制sketch 顶部的四个宏均可用-D编译标志覆盖见 CommissionerNode.ino 第 30–54 行宏默认值用途THREAD_CHANNEL15802.15.4 信道11..26。必须与 Joiner 侧THREAD_CHANNEL一致。JOIN_BUTTON_PINBOOT_PIN打开加入窗口的低电平有效按键 GPIO。PSKDJ01NMEaddJoiner()接受的 Pre-Shared Key for Device。JOINER_WINDOW_SEC120每条addJoiner()记录的有效时长秒。PSKd 的格式约束来自 OpenThread READMEASCII 字符串6–32 个字符使用 base32-thread 字母表——数字与大写字母排除I、O、Q和数字0双端必须完全一致。源码注释还提醒JOINER_WINDOW_SEC对演示绑定的单 Joiner 足够宽裕生产环境应缩短窗口并配合eui64参数做设备级白名单。7. 故障排查启动顺序先烧本 Commissioner sketch等 Leader CommissionerACTIVE在烧 JoinerNode 之前按 BOOT 键120 s 过期后按再次开窗然后复位 Joiner。现象可能原因Commissioner petition failed设备尚未 attached或分区内已有其他 Commissioner 活动——重试或先停掉另一个 Commissioner。Joiner 一直不出现加入窗口未打开——先按按钮确认串口出现Joiner window OPEN再启动 JoinerNode。加入窗口过期窗口仅 120 s——再按一次按钮重新打开然后复位 Joiner。addJoiner failedPSKd 非法——须为 6–32 字符 ASCIIbase32-thread 字母表不含0、I、O、Q源码层还可能因 Commissioner 表满而失败OT_ERROR_NO_BUFS。Joiner 在错误信道上两个 sketch 必须使用相同THREAD_CHANNEL。从实现细节补充两条排查思路startCommissioner()返回非OT_ERROR_NONE时常见为OT_ERROR_REJECTEDpetition 被拒即分区内已有 Commissioner 或状态回落DISABLED与OT_ERROR_RESPONSE_TIMEOUT30 s 内无响应封装层已自动otCommissionerStop()所以 5 秒后重试是安全的串口若始终停在Status: Detached/Disabled - waiting for network start...说明start()之后的角色尚未推进先确认 sdkconfig 中CONFIG_SOC_IEEE802154_SUPPORTEDy且板型为 H2/C6/C5。8. 相关示例与延伸阅读Thread Commissioning 分组总览——两块板的完整运行顺序与双端排查表含CONFIG_OPENTHREAD_JOINERy的 Joiner 侧要求。JoinerNode客户端——无本地 DataSet、仅凭 PSKd 走startJoiner()入网的配套 sketch。UDP Light Switch — light服务端——Commissioner UDP 灯服务端的组合演示。Native 示例总目录 与 SimpleThreadNetwork——后者是直接共享网络密钥的简单组网方式可对照理解为什么要做 Commissioning。OpenThread 库 README——startJoiner/startCommissioner/addJoiner的 API 参考、三个超时的配对建议startJoiner(..., timeoutSec_for_commissioner * 1000 10000)与错误码清单。本示例遵循 Apache License 2.0见仓库 LICENSE.md。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
