arduino-esp32 OpenThread 双板极简 Thread 网络实战Native API 组网Leader Router 入网【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文基于仓库中libraries/OpenThread/examples/Native/SimpleThreadNetwork/示例组讲解如何用 Arduino ESP32 核心的 OpenThread 原生类型化 APIOpenThreadDataSet类无需 CLI 字符串搭建一个最简两块板卡的 Thread 网络一块板通过完整 Operational Dataset 建网并成为 Leader另一块板仅凭共享的 16 字节网络密钥network key入网。读完本文你将掌握begin(false)显式数据集配置的完整调用链、commitDataSet()的建网/入网差异、双板烧录顺序与串口预期输出以及 Detached 等常见故障的定位方法。双板演示架构与角色分工示例位于 SimpleThreadNetwork 目录包含两个独立 SketchSketch角色说明LeaderNode建网方Leader用完整DataSet网络名、信道、PAN ID、扩展 PAN ID、网络密钥建网并成为 LeaderRouterNode入网方Router/Child仅需与 Leader 匹配的网络密钥即可附着其余参数由 Leader 下发学习两个 Sketch 的关键共同点是都使用OThread.begin(false)——即不从 NVS 自动加载数据集而是在 Sketch 代码中显式构建并提交数据集。这使得演示行为完全由代码常量决定便于复现代价是首次尝试者需注意旧 NVS 数据可能干扰见文末排障表。支持芯片与必备 IDF 特性演示仅适用于内置 IEEE 802.15.4 射频且已启用 OpenThread 的 SoC。根据子目录 README 与 ci.yml 中的校验要求SoCThread 支持状态ESP32-H2是支持ESP32-C6是支持ESP32-C5是支持必备 sdkconfig 项两个 Sketch 的 ci.yml 均以requires声明特性用途CONFIG_OPENTHREAD_ENABLEDy编译进 OpenThread 协议栈CONFIG_SOC_IEEE802154_SUPPORTEDy确认 SoC 具备 802.15.4 射频硬件从 OThread.h 源码结构看整个头文件的 API 声明都包裹在#if SOC_IEEE802154_SUPPORTED与#if CONFIG_OPENTHREAD_ENABLED宏内与上述配置项一一对应——在缺少 802.15.4 射频的芯片如经典 ESP32上OpenThread/DataSet类将直接不可用。LeaderNode用完整 DataSet 建网并成为 Leader建网方在setup()中完成三步启动协议栈、构建数据集、提交并拉起网络。核心代码来自 LeaderNode.ino#include Arduino.h #include OThread.h OpenThread threadLeaderNode; // 自建实例也可使用全局 OThread DataSet dataset; void setup() { Serial.begin(115200); // 启动协议栈参数 false 表示不从 NVS 加载数据集 threadLeaderNode.begin(false); // 1) initNew() 生成带随机默认值的全新数据集 dataset.initNew(); // 2) 覆写网络参数 dataset.setNetworkName(ESP_OpenThread); uint8_t extPanId[OT_EXT_PAN_ID_SIZE] {0xDE, 0xAD, 0x00, 0xBE, 0xEF, 0x00, 0xCA, 0xFE}; dataset.setExtendedPanId(extPanId); uint8_t networkKey[OT_NETWORK_KEY_SIZE] { 0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF }; dataset.setNetworkKey(networkKey); dataset.setChannel(15); dataset.setPanId(0x1234); // 3) 提交数据集作为 Active Dataset拉起网口启动 Thread 协议 threadLeaderNode.commitDataSet(dataset); threadLeaderNode.networkInterfaceUp(); threadLeaderNode.start(); }数据集各参数的示例默认值在setup()中commitDataSet()之前修改即可自定义参数示例默认值约束网络名称ESP_OpenThread以\0结尾的字符串信道15必须是 11..26PAN ID0x123416 位扩展 PAN IDDE AD 00 BE EF 00 CA FE8 字节网络密钥00 11 22 ... EE FF16 字节OT_NETWORK_KEY_SIZE同一网络内所有设备必须使用相同的网络密钥信道与 PAN 建议保持一致以获得可预期的入网行为。loop()中该 Sketch 每 5 秒打印一次角色、RLOC16、网络名、信道、PAN、扩展 PAN ID、网络密钥、Mesh Local EID、Leader RLOC、Node RLOC并用两种方式演示地址枚举单播地址走计数 下标APIgetUnicastAddressCount()/getUnicastAddress(i)组播地址走批量 APIgetAllMulticastAddresses()返回std::vectorIPAddress同时检测角色变化并在变化时调用clearAllAddressCache()清理地址缓存LeaderNode.ino 的loop()部分。预期串口输出115200 波特率 OpenThread Network Information: Role: Leader RLOC16: 0x0000 Network Name: ESP_OpenThread Channel: 15 PAN ID: 0x1234 Extended PAN ID: dead00beef00cafe Network Key: 00112233445566778899aabbccddeeff Mesh Local EID: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... --- Unicast Addresses (Using Count Index API) --- [0]: fdde:ad00:beef:0:.... --- Multicast Addresses (Using std::vector API) --- [0]: ff02::1附着前的过渡状态会打印Thread Node Status: Detached - Waiting for thread network start...RouterNode只带网络密钥入网入网方演示了 Thread 数据集的最小组合本地只需网络密钥附着成功后信道、PAN ID、扩展 PAN ID、网络名等参数由 Leader 通过协议学习。核心代码见 RouterNode.inoOpenThread threadChildNode; DataSet dataset; void setup() { Serial.begin(115200); // 同样不从 NVS 加载数据集 threadChildNode.begin(false); // 先清空数据集丢弃 initNew/默认值只保留网络密钥 dataset.clear(); uint8_t networkKey[OT_NETWORK_KEY_SIZE] { 0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF }; dataset.setNetworkKey(networkKey); // 必须与 Leader 逐字节一致 threadChildNode.commitDataSet(dataset); threadChildNode.networkInterfaceUp(); threadChildNode.start(); }注意它与 Leader 的差异在于dataset.clear()而非dataset.initNew()入网方不生成随机默认值避免与 Leader 的参数冲突。loop()则改用getCurrentDataSet()读取当前 Active Dataset即附着后从 Leader 学习到的完整参数并打印同时输出本机与 Leader 的 RLOC验证跨节点拓扑信息RouterNode.ino。预期输出 OpenThread Network Information (Active Dataset): Role: Router RLOC16: 0xfc00 Network Name: ESP_OpenThread Channel: 15 PAN ID: 0x1234 Extended PAN ID: dead00beef00cafe Network Key: 00112233445566778899aabbccddeeff Mesh Local EID: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:0:ff:fe00:0入网成功后几秒内第二块板会附着为Router小网络中也可能先是Child属于正常现象角色可能随网络规模升级。双板操作步骤在第一块 ESP32-H2 / ESP32-C6 / ESP32-C5 上烧录 LeaderNode串口监视器设为115200等待串口出现Role: Leader确认建网成功在第二块板上烧录 RouterNode使用相同的网络密钥数秒后第二块板附着为Router或Child两块板每 5 秒打印一次实时网络信息。从源码看 Native API 的关键机制结合 OThread.h 与示例代码本演示涉及的 API 行为可进一步说明begin(bool OThreadAutoStart)声明见 OThread.h#L152true时使用 NVS 中保存的数据集自动启动 Thread示例传false后协议栈初始化但网络参数完全交由应用通过commitDataSet()提供。hasActiveDataset()L189可用于判断当前是否存在已提交的 Active Dataset从而决定恢复旧网还是新建网络。DataSet构建器封装底层otOperationalDataset结构OThread.h#L60-L116。initNew()生成带随机默认值的新数据集clear()复位为未设置状态setChannel()文档注明取值范围为 11..26setNetworkKey()要求 16 字节setExtendedPanId()要求 8 字节——与两个 Sketch 的常量数组完全对应。角色枚举ot_device_role_t定义了OT_ROLE_DISABLED/DETACHED/CHILD/ROUTER/LEADER五个取值OThread.h#L42-L49otGetDeviceRole()/otGetStringDeviceRole()返回当前角色示例loop()正是据此区分打印网络信息与打印 Detached 等待提示两个分支。地址缓存getUnicastAddressCount()等地址查询接口带有用户可控缓存mCachedUnicastAddresses/mCachedMulticastAddressesOThread.h#L401-L407头文件注释明确要求角色变化后调用clearAllAddressCache()强制重新解析地址——这正是 LeaderNode 中角色变化检测分支的用途。进阶路径头文件还暴露了startJoiner()/startCommissioner()/addJoiner()等 Thread Commissioning 接口需CONFIG_OPENTHREAD_JOINERy/CONFIG_OPENTHREAD_COMMISSIONERyOThread.h#L251-L305即无需预共享网络密钥、改用 PSKd 安全入网的方案对应仓库中的 ThreadCommissioning 示例。常见问题排查启动顺序必须先烧录并启动 Leader等待Role: Leader再烧录 Router若 Router 在 Leader 就绪前启动在 Leader 起来后按一次复位即可。症状可能原因与处理Router 一直 DetachedLeader 尚未运行或网络密钥不匹配——先启动 Leader再复位 Router核对密钥字节Router 加入了错误的网络某块板上残留旧 NVS 数据集——两块板均使用begin(false)但若旧数据集干扰擦除 flash 后重试Leader 无法成为 Leader同信道/PAN 上存在另一个 Leader——关掉其他 Thread 设备或修改数据集常量串口无输出串口监视器未设为115200或选错 USB 口改了密钥/常量却不生效旧 NVS 残留——擦除 flash两块板均应使用一致的常量附着为 Child 而非 Router小网络中的正常现象角色可能随时间升级相关示例Thread Commissioning 示例使用 PSKd 代替预共享网络密钥安全地将设备入网Joiner Commissioner 模式。CLI 版 Simple Thread Network同一建网 入网场景但通过 OpenThread CLI 字符串驱动可与本 Native 版对照阅读。Native 示例总览OpenThread 原生 API 全部示例分类UDP、CoAP、ThreadScan、ThreadDNSSD、StackShutdown 等。本组示例遵循 Apache License 2.0 许可。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 arduino-esp32 OpenThread 双板极简 Thread 网络实战：Native API 组网（Leader + Router 入网）
arduino-esp32 OpenThread 双板极简 Thread 网络实战Native API 组网Leader Router 入网【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文基于仓库中libraries/OpenThread/examples/Native/SimpleThreadNetwork/示例组讲解如何用 Arduino ESP32 核心的 OpenThread 原生类型化 APIOpenThreadDataSet类无需 CLI 字符串搭建一个最简两块板卡的 Thread 网络一块板通过完整 Operational Dataset 建网并成为 Leader另一块板仅凭共享的 16 字节网络密钥network key入网。读完本文你将掌握begin(false)显式数据集配置的完整调用链、commitDataSet()的建网/入网差异、双板烧录顺序与串口预期输出以及 Detached 等常见故障的定位方法。双板演示架构与角色分工示例位于 SimpleThreadNetwork 目录包含两个独立 SketchSketch角色说明LeaderNode建网方Leader用完整DataSet网络名、信道、PAN ID、扩展 PAN ID、网络密钥建网并成为 LeaderRouterNode入网方Router/Child仅需与 Leader 匹配的网络密钥即可附着其余参数由 Leader 下发学习两个 Sketch 的关键共同点是都使用OThread.begin(false)——即不从 NVS 自动加载数据集而是在 Sketch 代码中显式构建并提交数据集。这使得演示行为完全由代码常量决定便于复现代价是首次尝试者需注意旧 NVS 数据可能干扰见文末排障表。支持芯片与必备 IDF 特性演示仅适用于内置 IEEE 802.15.4 射频且已启用 OpenThread 的 SoC。根据子目录 README 与 ci.yml 中的校验要求SoCThread 支持状态ESP32-H2是支持ESP32-C6是支持ESP32-C5是支持必备 sdkconfig 项两个 Sketch 的 ci.yml 均以requires声明特性用途CONFIG_OPENTHREAD_ENABLEDy编译进 OpenThread 协议栈CONFIG_SOC_IEEE802154_SUPPORTEDy确认 SoC 具备 802.15.4 射频硬件从 OThread.h 源码结构看整个头文件的 API 声明都包裹在#if SOC_IEEE802154_SUPPORTED与#if CONFIG_OPENTHREAD_ENABLED宏内与上述配置项一一对应——在缺少 802.15.4 射频的芯片如经典 ESP32上OpenThread/DataSet类将直接不可用。LeaderNode用完整 DataSet 建网并成为 Leader建网方在setup()中完成三步启动协议栈、构建数据集、提交并拉起网络。核心代码来自 LeaderNode.ino#include Arduino.h #include OThread.h OpenThread threadLeaderNode; // 自建实例也可使用全局 OThread DataSet dataset; void setup() { Serial.begin(115200); // 启动协议栈参数 false 表示不从 NVS 加载数据集 threadLeaderNode.begin(false); // 1) initNew() 生成带随机默认值的全新数据集 dataset.initNew(); // 2) 覆写网络参数 dataset.setNetworkName(ESP_OpenThread); uint8_t extPanId[OT_EXT_PAN_ID_SIZE] {0xDE, 0xAD, 0x00, 0xBE, 0xEF, 0x00, 0xCA, 0xFE}; dataset.setExtendedPanId(extPanId); uint8_t networkKey[OT_NETWORK_KEY_SIZE] { 0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF }; dataset.setNetworkKey(networkKey); dataset.setChannel(15); dataset.setPanId(0x1234); // 3) 提交数据集作为 Active Dataset拉起网口启动 Thread 协议 threadLeaderNode.commitDataSet(dataset); threadLeaderNode.networkInterfaceUp(); threadLeaderNode.start(); }数据集各参数的示例默认值在setup()中commitDataSet()之前修改即可自定义参数示例默认值约束网络名称ESP_OpenThread以\0结尾的字符串信道15必须是 11..26PAN ID0x123416 位扩展 PAN IDDE AD 00 BE EF 00 CA FE8 字节网络密钥00 11 22 ... EE FF16 字节OT_NETWORK_KEY_SIZE同一网络内所有设备必须使用相同的网络密钥信道与 PAN 建议保持一致以获得可预期的入网行为。loop()中该 Sketch 每 5 秒打印一次角色、RLOC16、网络名、信道、PAN、扩展 PAN ID、网络密钥、Mesh Local EID、Leader RLOC、Node RLOC并用两种方式演示地址枚举单播地址走计数 下标APIgetUnicastAddressCount()/getUnicastAddress(i)组播地址走批量 APIgetAllMulticastAddresses()返回std::vectorIPAddress同时检测角色变化并在变化时调用clearAllAddressCache()清理地址缓存LeaderNode.ino 的loop()部分。预期串口输出115200 波特率 OpenThread Network Information: Role: Leader RLOC16: 0x0000 Network Name: ESP_OpenThread Channel: 15 PAN ID: 0x1234 Extended PAN ID: dead00beef00cafe Network Key: 00112233445566778899aabbccddeeff Mesh Local EID: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... --- Unicast Addresses (Using Count Index API) --- [0]: fdde:ad00:beef:0:.... --- Multicast Addresses (Using std::vector API) --- [0]: ff02::1附着前的过渡状态会打印Thread Node Status: Detached - Waiting for thread network start...RouterNode只带网络密钥入网入网方演示了 Thread 数据集的最小组合本地只需网络密钥附着成功后信道、PAN ID、扩展 PAN ID、网络名等参数由 Leader 通过协议学习。核心代码见 RouterNode.inoOpenThread threadChildNode; DataSet dataset; void setup() { Serial.begin(115200); // 同样不从 NVS 加载数据集 threadChildNode.begin(false); // 先清空数据集丢弃 initNew/默认值只保留网络密钥 dataset.clear(); uint8_t networkKey[OT_NETWORK_KEY_SIZE] { 0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF }; dataset.setNetworkKey(networkKey); // 必须与 Leader 逐字节一致 threadChildNode.commitDataSet(dataset); threadChildNode.networkInterfaceUp(); threadChildNode.start(); }注意它与 Leader 的差异在于dataset.clear()而非dataset.initNew()入网方不生成随机默认值避免与 Leader 的参数冲突。loop()则改用getCurrentDataSet()读取当前 Active Dataset即附着后从 Leader 学习到的完整参数并打印同时输出本机与 Leader 的 RLOC验证跨节点拓扑信息RouterNode.ino。预期输出 OpenThread Network Information (Active Dataset): Role: Router RLOC16: 0xfc00 Network Name: ESP_OpenThread Channel: 15 PAN ID: 0x1234 Extended PAN ID: dead00beef00cafe Network Key: 00112233445566778899aabbccddeeff Mesh Local EID: fdde:ad00:beef:0:.... Node RLOC: fdde:ad00:beef:0:.... Leader RLOC: fdde:ad00:beef:0:0:ff:fe00:0入网成功后几秒内第二块板会附着为Router小网络中也可能先是Child属于正常现象角色可能随网络规模升级。双板操作步骤在第一块 ESP32-H2 / ESP32-C6 / ESP32-C5 上烧录 LeaderNode串口监视器设为115200等待串口出现Role: Leader确认建网成功在第二块板上烧录 RouterNode使用相同的网络密钥数秒后第二块板附着为Router或Child两块板每 5 秒打印一次实时网络信息。从源码看 Native API 的关键机制结合 OThread.h 与示例代码本演示涉及的 API 行为可进一步说明begin(bool OThreadAutoStart)声明见 OThread.h#L152true时使用 NVS 中保存的数据集自动启动 Thread示例传false后协议栈初始化但网络参数完全交由应用通过commitDataSet()提供。hasActiveDataset()L189可用于判断当前是否存在已提交的 Active Dataset从而决定恢复旧网还是新建网络。DataSet构建器封装底层otOperationalDataset结构OThread.h#L60-L116。initNew()生成带随机默认值的新数据集clear()复位为未设置状态setChannel()文档注明取值范围为 11..26setNetworkKey()要求 16 字节setExtendedPanId()要求 8 字节——与两个 Sketch 的常量数组完全对应。角色枚举ot_device_role_t定义了OT_ROLE_DISABLED/DETACHED/CHILD/ROUTER/LEADER五个取值OThread.h#L42-L49otGetDeviceRole()/otGetStringDeviceRole()返回当前角色示例loop()正是据此区分打印网络信息与打印 Detached 等待提示两个分支。地址缓存getUnicastAddressCount()等地址查询接口带有用户可控缓存mCachedUnicastAddresses/mCachedMulticastAddressesOThread.h#L401-L407头文件注释明确要求角色变化后调用clearAllAddressCache()强制重新解析地址——这正是 LeaderNode 中角色变化检测分支的用途。进阶路径头文件还暴露了startJoiner()/startCommissioner()/addJoiner()等 Thread Commissioning 接口需CONFIG_OPENTHREAD_JOINERy/CONFIG_OPENTHREAD_COMMISSIONERyOThread.h#L251-L305即无需预共享网络密钥、改用 PSKd 安全入网的方案对应仓库中的 ThreadCommissioning 示例。常见问题排查启动顺序必须先烧录并启动 Leader等待Role: Leader再烧录 Router若 Router 在 Leader 就绪前启动在 Leader 起来后按一次复位即可。症状可能原因与处理Router 一直 DetachedLeader 尚未运行或网络密钥不匹配——先启动 Leader再复位 Router核对密钥字节Router 加入了错误的网络某块板上残留旧 NVS 数据集——两块板均使用begin(false)但若旧数据集干扰擦除 flash 后重试Leader 无法成为 Leader同信道/PAN 上存在另一个 Leader——关掉其他 Thread 设备或修改数据集常量串口无输出串口监视器未设为115200或选错 USB 口改了密钥/常量却不生效旧 NVS 残留——擦除 flash两块板均应使用一致的常量附着为 Child 而非 Router小网络中的正常现象角色可能随时间升级相关示例Thread Commissioning 示例使用 PSKd 代替预共享网络密钥安全地将设备入网Joiner Commissioner 模式。CLI 版 Simple Thread Network同一建网 入网场景但通过 OpenThread CLI 字符串驱动可与本 Native 版对照阅读。Native 示例总览OpenThread 原生 API 全部示例分类UDP、CoAP、ThreadScan、ThreadDNSSD、StackShutdown 等。本组示例遵循 Apache License 2.0 许可。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考