ai_face_test

一个基于 ESP32-S3 和 OV2640 的本地 AI 人脸跟踪云台项目。设备在板端完成人脸检测，通过双舵机驱动云台实时跟随目标，并提供 Wi-Fi 网页端用于视频预览、参数调节和调试。

项目特点

• 板端本地运行人脸检测，不依赖云端推理
• 双轴舵机云台跟踪，带控制参数和状态调试
• 内置网页端，可查看视频流、调节配置、观察运行状态
• 针对追踪稳定性做了滤波、冻结、重捕获和前馈等控制优化

硬件组成

• ESP32-S3 开发板
• OV2640 摄像头
• 2 路舵机云台
• 5V 稳定供电

主要文件

• ai_face_test.ino：主程序入口，负责相机、Wi-Fi、任务调度、追踪控制与舵机驱动
• app_httpd.cpp：网页服务、视频流、抓拍接口与调试页面
• tracking_state.h：追踪状态、配置项和共享数据结构
• camera_pins.h：摄像头引脚定义
• debug_page.h、index_ov2640.html：网页调试与交互界面资源

工作流程

1. ESP32-S3 启动后初始化摄像头、舵机和 Wi-Fi。
2. 视觉任务持续采集图像并做人脸检测。
3. 控制任务根据人脸位置和速度计算舵机动作。
4. 浏览器连接设备网页后，可以查看视频流并调节追踪参数。

编译与烧录

推荐使用 Arduino IDE 或 arduino-cli，并确保已安装 ESP32 开发板支持包。

基本准备

• 选择支持 ESP32-S3 的目标板
• 安装相机和 ESP32 相关依赖
• 按实际接线检查 camera_pins.h
• 根据供电情况连接双舵机

烧录后使用

• 上电后连接设备创建的 Wi-Fi 热点
• 在浏览器访问设备页面
• 打开视频流并观察人脸跟踪效果
• 根据现场情况微调追踪参数

仓库说明

仓库当前主要保存源码、网页界面和项目文档，不包含答辩 PPT 等大体积演示文件，也会忽略 Office 临时文件。