9. ieee802154 目录

9.1 ieee802154_cli

字段	描述
例程名称	IEEE802.15.4 命令行示例
所在文件夹路径	examples\ieee802154\ieee802154_cli
核心功能说明	提供一个命令行界面，用于配置和管理IEEE802.15.4网络，支持多种命令操作，包括通道设置、CCA配置、收发控制等
主要调用的内部/外部函数或模块	- IEEE802.15.4 子系统 API

• console 组件（命令行界面）
• ESP32-H2/C5/C6 芯片的 IEEE802.15.4 硬件支持
• 支持 UART 和 USB Serial/JTAG 控制台输出 |
  | 输入输出参数说明 | 配置参数：
• 控制台输出通道（UART 或 USB Serial/JTAG）
• IEEE802.15.4 网络参数（通道、PAN ID、地址等）

输出结果：

• 命令执行状态和结果
• 网络配置信息
• 收发数据状态
• 硬件寄存器信息
• 内存使用情况
• 芯片和SDK版本信息 |
  | 适用场景及典型应用案例 | - IEEE802.15.4 网络的开发和调试
• 硬件寄存器的直接操作和测试
• 无线通信参数的优化和测试
• 不同IEEE802.15.4设备之间的兼容性测试
• 基于IEEE802.15.4的物联网设备开发 |

9.2 技术要点

• 支持的命令类型：

  • 网络配置命令（channel, panid, extaddr, shortaddr）
  • 收发控制命令（rx, tx, txpower）
  • 硬件控制命令（coordinator, promisc, pending）
  • 测量和检测命令（cca, ed）
  • 系统命令（restart, free, heap, version）
  • 硬件寄存器命令（reg）

• 硬件支持：

  • 支持ESP32-H2/C5/C6等IEEE802.15.4芯片
  • 硬件级别的协调器支持
  • 硬件级别的混杂模式支持
  • 能量检测（ED）功能

• 控制台接口：

  • 支持UART和USB Serial/JTAG两种输出通道
  • 命令自动补全和帮助信息
  • 支持命令缩写和完整格式
  • 命令历史记录

9.3 主要命令功能

网络配置

• channel：设置和获取IEEE802.15.4通道号（11-26）
• panid：设置和获取PAN ID
• extaddr：设置和获取扩展地址（8字节）
• shortaddr：设置和获取短地址（2字节）

收发控制

• rx：启用/禁用接收模式
• tx：发送IEEE802.15.4 MAC帧，支持CCA触发
• txpower：设置和获取发射功率

硬件控制

• coordinator：启用/禁用硬件协调器
• promisc：启用/禁用混杂模式
• pending：管理待处理地址表和自动待处理模式

测量和检测

• cca：配置和获取CCA（空闲信道评估）参数
• ed：执行能量检测

系统信息

• version：获取芯片和SDK版本
• free：获取当前可用堆内存
• heap：获取最小可用堆内存

9.4 构建与运行

1. 配置项目：idf.py menuconfig
2. 选择控制台输出通道（可选）
3. 构建项目：idf.py build
4. 烧录并监控：idf.py -p PORT flash monitor
5. 在命令行中输入 help 查看所有可用命令

9.5 应用场景总结

该例程为IEEE802.15.4网络开发提供了一个强大的调试和测试工具，适用于：

• IEEE802.15.4协议栈的开发和验证
• 硬件级别的无线通信测试
• 不同IEEE802.15.4设备之间的互联互通测试
• 基于IEEE802.15.4的物联网应用原型开发
• 无线传感器网络的基础测试平台

通过该例程，开发者可以快速测试和验证IEEE802.15.4网络的各种配置和功能，加速基于IEEE802.15.4的产品开发进程。