VScode+esp-idf:基于esp32-web-camera实现延时摄影与AVI合成(附源码)

1. ESP32-CAM延时摄影系统设计思路

第一次接触ESP32-CAM时，我就被这个小巧的硬件震撼到了——指甲盖大小的板子居然集成了摄像头、Wi-Fi和蓝牙功能。当时就在想，能不能用它做个便携的延时摄影设备？比如记录植物生长或者建筑工地的变化过程。经过多次尝试，终于摸索出一套稳定可靠的方案。

延时摄影的本质是定时拍摄静态照片，然后通过视频合成技术实现时间压缩效果。ESP32-CAM的OV2640摄像头支持最高1600x1200分辨率，配合SD卡扩展存储，完全能满足基础需求。但难点在于如何在资源受限的环境下实现稳定的定时拍摄和视频合成。

我选择esp-idf作为开发环境，原因很简单：它是乐鑫官方的开发框架，对硬件支持最完善，而且VScode的插件生态让开发体验非常流畅。整个系统的工作流程可以分为三个核心环节：硬件初始化配置、定时拍摄控制、AVI视频合成。每个环节都有需要注意的细节，比如SD卡需要格式化为FAT32，摄像头初始化时要根据光照条件调整白平衡等。

2. 开发环境搭建与硬件配置

2.1 VScode与esp-idf环境配置

建议使用VScode 1.7以上版本，安装Espressif IDF插件时会自动下载工具链。我遇到过Python版本冲突的问题，后来发现用Python 3.8最稳定。配置时注意两点：一是设置好IDF_PATH环境变量，二是在settings.json中添加以下配置：

{ "idf.port": "/dev/ttyUSB0", "idf.flashBaudRate": "460800", "idf.adapterTargetName": "esp32" }

硬件连接有个坑要注意：ESP32-CAM的GPIO0需要下拉才能进入下载模式。我的做法是用个拨码开关控制，烧写时按下，运行时断开。电源建议使用5V/2A以上适配器，实测USB供电在拍摄时容易电压不稳导致重启。

2.2 摄像头与SD卡初始化

摄像头初始化代码要放在app_camera.c中，关键参数是帧尺寸和JPEG质量：

static camera_config_t camera_config = { .pixel_format = PIXFORMAT_JPEG, .frame_size = FRAMESIZE_SVGA, .jpeg_quality = 12, .fb_count = 2 };

SD卡挂载需要特别注意分区格式。有次我用exFAT格式的卡死活识别不了，后来发现必须用以下命令格式化：

sudo mkfs.vfat -F 32 /dev/sdX

在代码中挂载时要设置正确的模式：

esp_vfs_fat_sdmmc_mount_config_t mount_config = { .format_if_mount_failed = false, .max_files = 5, .allocation_unit_size = 16 * 1024 };

3. 定时拍摄功能实现

3.1 硬件定时器配置

ESP32内置4个硬件定时器，我用TIMER0实现秒级定时。关键是要注意分频系数计算：

timer_config_t config = { .divider = 80, // 80MHz/80=1MHz .counter_dir = TIMER_COUNT_UP, .counter_en = TIMER_PAUSE, .alarm_en = TIMER_ALARM_EN, .auto_reload = true };

定时器中断服务函数里要避免耗时操作。我的做法是设置标志位，在主循环中处理实际拍摄逻辑：

void IRAM_ATTR timer_isr(void* arg) { timer_spinlock_take(0); shot_flag = true; timer_group_clr_intr_status_in_isr(0, 0); timer_group_enable_alarm_in_isr(0, 0); }

3.2 图像捕获优化

直接调用esp_camera_fb_get()获取帧缓冲时，如果光线不足容易卡住。我加了超时机制：

camera_fb_t *fb = NULL; int retry = 3; while(retry--){ fb = esp_camera_fb_get(); if(fb) break; vTaskDelay(100/portTICK_PERIOD_MS); }

存储时建议用时间戳命名文件，避免覆盖：

time_t now; time(&now); char filename[64]; strftime(filename, sizeof(filename), "/sdcard/%Y%m%d_%H%M%S.jpg", localtime(&now));

4. AVI视频合成技术详解

4.1 jpeg2avi库移植要点

原野追逐大佬的jpeg2avi库确实好用，但直接移植到ESP32要注意三个问题：内存分配要用heap_caps_malloc，文件操作要用fwrite替代部分内存操作，还有字节序问题。修改后的头文件应该包含：

#include "esp_heap_caps.h" #define malloc(size) heap_caps_malloc(size, MALLOC_CAP_SPIRAM)

4.2 视频参数配置

实测发现帧率超过15fps时ESP32处理不过来。我的配置方案是：

jpeg2avi_start(fp_avi, 800, 600, 15); // 宽,高,fps

每个jpeg帧写入前要检查文件大小，避免SD卡写满：

if(ftell(fp_avi) > (1024*1024*4)) { // 限制4MB jpeg2avi_end(fp_avi); fclose(fp_avi); // 创建新文件... }

4.3 合成过程优化

合成视频时最耗时的操作是文件写入。我采用双缓冲策略：一个任务专门负责拍摄，另一个任务负责写入。通过队列传递帧数据：

typedef struct { uint8_t *buf; size_t len; } frame_data_t; QueueHandle_t frame_queue = xQueueCreate(5, sizeof(frame_data_t));

5. 完整工作流程与调试技巧

系统上电后的完整流程应该是：初始化硬件→连接WiFi（可选）→启动定时器→进入主循环等待拍摄。我习惯用事件标志组来管理状态：

EventGroupHandle_t cam_event; #define WIFI_CONNECTED_BIT (1 << 0) #define SD_READY_BIT (1 << 1) #define CAM_READY_BIT (1 << 2)

调试时发现几个常见问题：

1. 图片写入SD卡失败：检查文件是否正常关闭，建议每次写入后调用fsync()
2. 视频播放卡顿：降低帧率或分辨率，OV2640在SVGA模式下最稳定
3. 系统随机重启：检查电源质量，必要时给ESP32-CAM的5V引脚并联1000μF电容

6. 进阶功能扩展

基于这个基础框架，可以扩展很多实用功能。比如我最近添加的：

• 光敏电阻控制：只在光线充足时拍摄
• PIR人体感应：检测到运动才启动录制
• 无线控制：通过手机APP调整拍摄间隔

还有个有趣的玩法是结合FreeRTOS的低功耗模式，让ESP32在拍摄间隙进入light sleep状态，实测可以降低70%功耗。关键代码：

esp_sleep_enable_timer_wakeup(interval_us); esp_light_sleep_start();

7. 关键代码解析与优化

拍摄控制的核心逻辑在app_main.c中。我优化后的主循环结构如下：

while(1) { if(shot_flag) { take_photo(); shot_flag = false; } if(xQueueReceive(frame_queue, &frame, 0) == pdTRUE) { write_frame_to_avi(frame); free(frame.buf); } vTaskDelay(10/portTICK_PERIOD_MS); }

对于视频合成，jpeg2avi_add_frame函数有个隐藏bug——当JPEG文件包含APPn标记时会出错。修复方法是修改解析逻辑：

// 在jpeg2avi.c中找到parse_jpeg函数 while(pos < len) { if(buf[pos] != 0xFF) break; marker = buf[pos+1]; if(marker >= 0xE0 && marker <= 0xEF) { // APPn标记 pos += 2 + (buf[pos+2]<<8 | buf[pos+3]); } else break; }

8. 实测效果与性能数据

经过一周的稳定性测试（间隔10秒拍摄，每天合成一个视频），得出以下数据：

存储卡使用情况测试（SVGA分辨率，质量12）：

9. 常见问题解决方案

SD卡写入速度慢：换用Class10以上的卡，实测SanDisk Extreme Pro速度最快。另外可以修改SDMMC时钟频率：

sdmmc_host_t host = SDMMC_HOST_DEFAULT(); host.max_freq_khz = SDMMC_FREQ_HIGHSPEED;

图像出现条纹噪声：调整摄像头时钟频率，在camera_config中添加：

.xclk_freq_hz = 20000000, // 默认值可能太高

视频播放器无法识别：检查AVI头信息是否正确，建议用ffmpeg检查：

ffmpeg -i output.avi

10. 源码结构与使用说明

工程目录结构如下：

├── main/ │ ├── app_camera.c # 摄像头驱动 │ ├── app_sdcard.c # SD卡操作 │ ├── jpeg2avi.c # 视频合成库 │ └── app_main.c # 主逻辑 ├── components/ │ └── esp32-camera/ # 官方摄像头驱动

使用步骤：

1. 修改app_main.c中的拍摄间隔（TIMER_INTERVAL_MS）
2. 配置WiFi参数（如需要远程访问）
3. 插入格式化好的SD卡
4. 编译烧录后，按RST键开始运行

按键操作：

• 长按BOOT键3秒：进入配置模式（AP热点）
• 双击BOOT键：手动触发立即拍摄
• 短按BOOT键：查看剩余存储空间

11. 硬件改造建议

原始ESP32-CAM模块的供电设计有缺陷，建议做以下改进：

1. 在5V引脚并联470μF电容
2. 添加AMS1117-3.3稳压芯片单独给摄像头供电
3. 用热熔胶固定SD卡座，防止接触不良

如果想做防水外壳，记得给镜头开孔并做好密封。我用3D打印了个带O型圈的壳子，雨天也能正常工作。

12. 延时摄影创意应用

除了常规的风景记录，这个系统还可以玩出很多花样：

• 植物生长观察：设置每10分钟拍摄一次，用ffmpeg合成生长过程

ffmpeg -r 24 -i %04d.jpg -vcodec libx264 output.mp4

• 星空轨迹记录：夜间模式下调高ISO，配合长曝光（需修改sensor寄存器）
• DIY监控系统：结合PIR传感器，检测到运动才启动拍摄

有次我用它记录了整个装修过程，三个月拍了上万张照片，最后合成的视频让装修公司都惊叹不已。这就是嵌入式开发的魅力——用几十元的硬件就能实现专业设备的功能。