7. phy 目录

7.1 antenna

字段	描述
例程名称	Wi-Fi 天线软切换示例
所在文件夹路径	examples\phy\antenna
核心功能说明	演示如何使用 ESP 芯片的多天线软件切换功能，实现 Wi-Fi 天线的动态选择和切换
主要调用的内部/外部函数或模块	- Wi-Fi 驱动

• 天线切换组件（antenna_soft_switch）
• 事件处理系统
• 支持 ESP32、ESP32-C2、ESP32-C3、ESP32-C6、ESP32-S2、ESP32-S3 芯片 |
  | 输入输出参数说明 | 配置参数：
• Wi-Fi SSID 和密码
• 天线切换 GPIO 引脚配置

输出结果：

• Wi-Fi 连接状态
• 天线切换状态
• 接收和发射模式
• 天线使能状态
• 连接的 AP 信息 |
  | 适用场景及典型应用案例 | - 智能家居设备的信号优化
• 物联网设备的无线通信增强
• 移动设备的天线切换机制
• 信号质量动态优化系统
• 工业自动化设备的无线连接 |

7.2 cert_test

字段	描述
例程名称	认证测试示例
所在文件夹路径	examples\phy\cert_test
核心功能说明	演示如何使用认证测试 API，提供 Wi-Fi 和 Bluetooth 认证测试功能，用于 RF 认证测试
主要调用的内部/外部函数或模块	- Wi-Fi 认证测试 API

• Bluetooth 认证测试 API
• console 组件（命令行界面）
• 事件处理系统
• 支持多种 ESP32 芯片 |
  | 输入输出参数说明 | 配置参数：
• 启用 RF 认证测试功能
• 禁用中断看门狗
• 禁用任务看门狗定时器

输出结果：

• 命令执行状态和结果
• 测试配置信息
• 测试数据和统计
• RSSI 值
• 发送和接收状态 |
  | 适用场景及典型应用案例 | - 无线设备的认证测试
• RF 性能验证
• 产品认证和合规性测试
• 无线通信质量评估
• 研发阶段的性能测试 |

7.3 技术要点

• 天线切换功能：

  • 支持多天线的软件切换
  • 动态选择最佳天线
  • 支持接收和发射模式的天线配置
  • 可配置的天线 GPIO 引脚

• 认证测试功能：

  • Wi-Fi 认证测试支持
  • Bluetooth 认证测试支持
  • BLE DTM 测试功能（ESP32-H2 和 ESP32-C6）
  • 支持多种测试模式（连续发射、数据包测试、单载波测试等）
  • 详细的测试数据和统计

• 硬件支持：

  • 支持多种 ESP32 芯片
  • 支持多天线配置
  • 支持不同频率范围
  • 支持不同调制方式

• 命令行界面：

  • 丰富的测试命令
  • 命令历史记录
  • 自动补全功能
  • 清晰的测试结果输出

7.4 构建与运行

所有 phy 例程的构建方法基本一致：

1. 设置目标芯片：idf.py set-target <chip_name>
2. 配置项目：idf.py menuconfig
3. 设置网络参数和测试配置
4. 构建项目：idf.py build
5. 烧录并监控：idf.py -p PORT flash monitor
6. 根据具体例程的要求进行测试操作

7.5 应用场景总结

• antenna：适用于需要动态优化无线信号质量的场景，如智能家居设备和物联网设备
• cert_test：适用于无线设备的认证测试和性能验证，如产品研发和认证阶段

这些例程展示了 ESP-IDF 在物理层（PHY）方面的强大功能，从天线优化到认证测试，满足不同场景下的无线通信需求。开发者可以根据自己的应用场景选择合适的例程作为基础，进行二次开发和扩展。