ESP32-CAM图像传输项目说明文档
1. 项目概述
本项目基于ESP32-CAM模块实现图像采集与网络传输功能，通过WiFi连接将摄像头采集的图像实时传输到客户端，支持实时视频流和单帧图像捕获两种模式。
主要功能：
-
摄像头图像采集（JPEG格式）
-
WiFi网络连接
-
HTTP服务器提供图像服务
-
实时视频流传输
-
单帧图像捕获
应用场景：
-
智能家居监控
-
远程监控系统
-
物联网视觉检测
-
视频会议终端
2. 技术架构
2.1 系统架构
本项目采用分层架构设计，主要分为硬件层、驱动层、网络层和应用层。
2.2 模块划分
|-------------|--------------|--------------------|
| 模块名称 | 功能描述 | 文件位置 |
| camera | 摄像头驱动与图像采集 | main/camera.c |
| wifi | WiFi连接管理 | main/wifi.c |
| http_server | HTTP服务器与图像传输 | main/http_server.c |
| app_main | 应用主入口 | main/app_main.c |
2.3 数据流
摄像头采集 -> JPEG编码 -> WiFi传输 -> HTTP响应 -> 客户端显示
3. 硬件设计
3.1 硬件清单
|--------|-------------|----------------------|--------|
| 序号 | 元件名称 | 型号 | 数量 |
| 1 | ESP32-CAM模块 | AI-Thinker ESP32-CAM | 1 |
| 2 | 摄像头模组 | OV2640/OV3660 | 1 |
| 3 | USB-TTL转换器 | CP2102/CH340 | 1 |
| 4 | 天线 | 2.4G天线 | 1 |
| 5 | 电源 | 5V 2A | 1 |
3.2 引脚配置
|--------|--------|----------|
| 引脚 | 功能 | 连接 |
| GPIO0 | XCLK | 摄像头XCLK |
| GPIO5 | D0 | 摄像头D0 |
| GPIO18 | D1 | 摄像头D1 |
| GPIO19 | D2 | 摄像头D2 |
| GPIO21 | D3 | 摄像头D3 |
| GPIO22 | PCLK | 摄像头PCLK |
| GPIO23 | HREF | 摄像头HREF |
| GPIO25 | VSYNC | 摄像头VSYNC |
| GPIO26 | SIOD | 摄像头SDA |
| GPIO27 | SIOC | 摄像头SCL |
| GPIO32 | PWDN | 摄像头电源控制 |
| GPIO34 | D6 | 摄像头D6 |
| GPIO35 | D7 | 摄像头D7 |
| GPIO36 | D4 | 摄像头D4 |
| GPIO39 | D5 | 摄像头D5 |
4. 软件设计
4.1 开发环境
-
ESP-IDF v5.5.x
-
C语言开发
-
Windows/Linux/macOS
4.2 文件结构
.
|- CMakeLists.txt # 项目主配置文件
|- sdkconfig.defaults # SDK默认配置
|- partitions.csv # 分区表配置
|- main/
|- CMakeLists.txt # 主组件配置
|- app.h # 头文件声明
|- app_main.c # 应用入口
|- camera.c # 摄像头驱动
|- wifi.c # WiFi驱动
|- http_server.c # HTTP服务器
4.3 核心函数说明
|---------------------|---------------|---------------|
| 函数名 | 功能说明 | 所属文件 |
| app_main() | 应用入口函数，初始化各模块 | app_main.c |
| camera_init() | 初始化摄像头模块 | camera.c |
| wifi_init_sta() | 初始化WiFi STA模式 | wifi.c |
| http_server_start() | 启动HTTP服务器 | http_server.c |
| capture_handler() | 处理单帧图像捕获请求 | http_server.c |
| stream_handler() | 处理实时视频流请求 | http_server.c |
4.4 HTTP API接口
|----------|-----------------|-----------|
| 接口路径 | HTTP 方法 | 功能描述 |
| / | GET | 返回首页HTML |
| /capture | GET | 捕获并返回单帧图像 |
| /stream | GET | 返回实时视频流 |
5. 配置与编译
5.1 环境配置
-
安装ESP-IDF v5.5.x
-
设置环境变量IDF_PATH
-
在app.h中配置WiFi SSID和密码
5.2 编译步骤
Windows PowerShell:
source ESP-IDF export script
cd project_path
idf.py set-target esp32
idf.py build
Linux/macOS:
source ~/esp/esp-idf/export.sh
cd /path/to/project
idf.py set-target esp32
idf.py build
5.3 烧录命令
idf.py -p COMx flash monitor
注意：COMx为实际的串口端口号
6. 使用说明
6.1 硬件连接
-
将USB-TTL转换器连接到ESP32-CAM
-
连接TX-RX, RX-TX, GND-GND
-
给ESP32-CAM供电（建议使用5V 2A电源）
-
连接天线
6.2 软件配置
编辑main/app.h文件，修改WiFi配置：
#define WIFI_SSID "YOUR_WIFI_SSID"
#define WIFI_PASSWORD "YOUR_WIFI_PASSWORD"
6.3 访问方式
-
烧录程序后，打开串口监视器
-
等待ESP32-CAM连接WiFi，获取IP地址
-
在浏览器中访问：http://IP地址
-
点击Capture Single Image捕获单帧图像
-
首页自动显示实时视频流
7. 故障排除
|----------|-----------|------------------|
| 问题现象 | 可能原因 | 解决方案 |
| 摄像头初始化失败 | 摄像头模组连接问题 | 检查摄像头排线连接 |
| WiFi连接失败 | SSID或密码错误 | 检查app.h中的WiFi配置 |
| 无法获取图像 | 电源不足 | 使用5V 2A以上电源 |
| HTTP访问失败 | 网络不通 | 确认设备和电脑在同一网络 |
| 图像质量差 | 摄像头参数未优化 | 调整jpeg_quality参数 |
8. 附录
8.1 摄像头分辨率配置
|---------|-----------------|----------|
| 分辨率 | 宏定义 | 说明 |
| QQVGA | FRAMESIZE_QQVGA | 160x120 |
| QCIF | FRAMESIZE_QCIF | 176x144 |
| HQVGA | FRAMESIZE_HQVGA | 240x176 |
| QVGA | FRAMESIZE_QVGA | 320x240 |
| VGA | FRAMESIZE_VGA | 640x480 |
| SVGA | FRAMESIZE_SVGA | 800x600 |
| XGA | FRAMESIZE_XGA | 1024x768 |
9、项目已上传至：https://download.csdn.net/download/m0_67097444/92953536