不到十美元的一块小板子,集成了 ESP32-S 芯片、一颗 OV2640 摄像头和一个 microSD 卡槽,这就是丝印写着 AI-Thinker 的 ESP32-CAM。它的玩法有两条最实用的主线:一是按一下 RESET 拍一张照片存进卡里,二是让它连上 Wi-Fi 起一个 MJPEG 服务器,浏览器打开 IP 就能看实时画面。这两条主线的完整代码,我把 Random Nerd Tutorials 的两篇原帖逐段核对后整理成一篇,引脚、接线、烧录步骤全部对过原文。
把这两件事放一起讲是有理由的:硬件准备和烧录链路完全是同一套——同一块 FTDI 串口板、同一个 GPIO 0 接地进烧录模式的动作,代码却分别对应离线拍照存卡和在线视频流两个方向。照着这一篇走完,两份程序都能直接烧进去跑。封面图就是这块板子本尊,镜头和卡槽的位置一目了然。

先交代口径:下文的引脚定义、接线表、报错清单均以原帖可见文本为准,代码逐字符搬运,没有改动任何一行逻辑。唯一动过的地方是头文件写法,在代码段旁边单独说明。板子按丝印是 AI-Thinker 模组,其他厂家的 ESP32-CAM 也能跑,条件是在代码里改对引脚映射。
一、准备材料与一张格式化好的卡
材料清单不长:带 OV2640 的 ESP32-CAM 一块、FTDI 串口下载器一个、母对母杜邦线若干、一张 microSD 卡;想长期挂机再备一个 5V 电源或充电宝。串流方案里原帖还用到一个假监控罩(dummy dome camera),板子正好能塞进去,放到最后说。
卡先格式化:插进电脑,右键选格式化,文件系统选 FAT32,点开始走完流程。这里有个原帖核对过的细节值得记:按产品规格,ESP32-CAM 官方只支持 4GB 卡,但原作者用 16GB 卡实测正常。我的建议是按原帖口径来——手头有什么卡先按 FAT32 格一遍,挂载失败再换小卡。
二、接线与烧录模式:GPIO 0 接地是关键
ESP32-CAM 本身没有 USB 口,烧录靠 FTDI 串口板。接线一共五根,对应关系如下,注意 FTDI 板上的电压跳线帽要拨到 5V 档,这一点原帖专门强调过。
| ESP32-CAM | FTDI 烧录器 |
|---|---|
| GND | GND |
| 5V | VCC(5V) |
| U0R | TX |
| U0T | RX |
| GPIO 0 | GND(仅烧录时接) |

GPIO 0 接上 GND 之后,还要再按一下板载 RESET 键,板子才真正进入烧录模式。烧完记得把这根线拔掉,否则重启之后用户程序不跑——这是新手最容易卡住的一步,串口明明有输出、程序却像是没烧进去,多半就是它。
三、代码一:按 RESET 拍一张,存进卡里
这份程序的逻辑:上电后初始化摄像头,拍一张,以 pictureX.jpg 的命名存进 microSD 卡;照片编号写进 EEPROM 的 flash 区,所以 RESET 之后编号不丢、照片不会互相覆盖。存完自动进深度睡眠,再按一次 RESET 就再拍一张,正好当一个离线快门用。
有个工程细节值得记一笔:代码开头用 WRITE_PERI_REG 关掉了 brownout 检测器。这块板对供电波动敏感,欠压复位是 ESP32-CAM 的常见报错,原帖直接在代码层规避掉了。
摄像头初始化之后,程序先用 SD_MMC.begin() 挂载卡,挂载失败直接在串口打出 SD Card Mount Failed 并返回;再用 SD_MMC.cardType() 判断卡型,读到 CARD_NONE 就提示 No SD Card attached。也就是说卡没插好、卡槽接触不良这类硬件问题,在写照片之前就会被拦下来,串口里看得一清二楚。
/*********
Rui Santos
Complete project details at https://RandomNerdTutorials.com/esp32-cam-take-photo-save-microsd-card
IMPORTANT!!!
- Select Board "AI Thinker ESP32-CAM"
- GPIO 0 must be connected to GND to upload a sketch
- After connecting GPIO 0 to GND, press the ESP32-CAM on-board RESET button to put your board in flashing mode
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*********/
#include "esp_camera.h"
#include "Arduino.h"
#include "FS.h" // SD Card ESP32
#include "SD_MMC.h" // SD Card ESP32
#include "soc/soc.h" // Disable brownour problems
#include "soc/rtc_cntl_reg.h" // Disable brownour problems
#include "driver/rtc_io.h"
#include "EEPROM.h" // read and write from flash memory
// define the number of bytes you want to access
#define EEPROM_SIZE 1
// Pin definition for CAMERA_MODEL_AI_THINKER
#define PWDN_GPIO_NUM 32
#define RESET_GPIO_NUM -1
#define XCLK_GPIO_NUM 0
#define SIOD_GPIO_NUM 26
#define SIOC_GPIO_NUM 27
#define Y9_GPIO_NUM 35
#define Y8_GPIO_NUM 34
#define Y7_GPIO_NUM 39
#define Y6_GPIO_NUM 36
#define Y5_GPIO_NUM 21
#define Y4_GPIO_NUM 19
#define Y3_GPIO_NUM 18
#define Y2_GPIO_NUM 5
#define VSYNC_GPIO_NUM 25
#define HREF_GPIO_NUM 23
#define PCLK_GPIO_NUM 22
int pictureNumber = 0;
void setup() {
WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0); //disable brownout detector
Serial.begin(115200);
//Serial.setDebugOutput(true);
//Serial.println();
camera_config_t config;
config.ledc_channel = LEDC_CHANNEL_0;
config.ledc_timer = LEDC_TIMER_0;
config.pin_d0 = Y2_GPIO_NUM;
config.pin_d1 = Y3_GPIO_NUM;
config.pin_d2 = Y4_GPIO_NUM;
config.pin_d3 = Y5_GPIO_NUM;
config.pin_d4 = Y6_GPIO_NUM;
config.pin_d5 = Y7_GPIO_NUM;
config.pin_d6 = Y8_GPIO_NUM;
config.pin_d7 = Y9_GPIO_NUM;
config.pin_xclk = XCLK_GPIO_NUM;
config.pin_pclk = PCLK_GPIO_NUM;
config.pin_vsync = VSYNC_GPIO_NUM;
config.pin_href = HREF_GPIO_NUM;
config.pin_sccb_sda = SIOD_GPIO_NUM;
config.pin_sccb_scl = SIOC_GPIO_NUM;
config.pin_pwdn = PWDN_GPIO_NUM;
config.pin_reset = RESET_GPIO_NUM;
config.xclk_freq_hz = 20000000;
config.pixel_format = PIXFORMAT_JPEG;
if(psramFound()){
config.frame_size = FRAMESIZE_UXGA; // FRAMESIZE_ + QVGA|CIF|VGA|SVGA|XGA|SXGA|UXGA
config.jpeg_quality = 10;
config.fb_count = 2;
} else {
config.frame_size = FRAMESIZE_SVGA;
config.jpeg_quality = 12;
config.fb_count = 1;
}
// Init Camera
esp_err_t err = esp_camera_init(&config);
if (err != ESP_OK) {
Serial.printf("Camera init failed with error 0x%x", err);
return;
}
//Serial.println("Starting SD Card");
if(!SD_MMC.begin()){
Serial.println("SD Card Mount Failed");
return;
}
uint8_t cardType = SD_MMC.cardType();
if(cardType == CARD_NONE){
Serial.println("No SD Card attached");
return;
}
camera_fb_t * fb = NULL;
// Take Picture with Camera
fb = esp_camera_fb_get();
if(!fb) {
Serial.println("Camera capture failed");
return;
}
// initialize EEPROM with predefined size
EEPROM.begin(EEPROM_SIZE);
pictureNumber = EEPROM.read(0) + 1;
// Path where new picture will be saved in SD Card
String path = "/picture" + String(pictureNumber) +".jpg";
fs::FS &fs = SD_MMC;
Serial.printf("Picture file name: %s\n", path.c_str());
File file = fs.open(path.c_str(), FILE_WRITE);
if(!file){
Serial.println("Failed to open file in writing mode");
}
else {
file.write(fb->buf, fb->len); // payload (image), payload length
Serial.printf("Saved file to path: %s\n", path.c_str());
EEPROM.write(0, pictureNumber);
EEPROM.commit();
}
file.close();
esp_camera_fb_return(fb);
// Turns off the ESP32-CAM white on-board LED (flash) connected to GPIO 4
pinMode(4, OUTPUT);
digitalWrite(4, LOW);
rtc_gpio_hold_en(GPIO_NUM_4);
delay(2000);
Serial.println("Going to sleep now");
delay(2000);
esp_deep_sleep_start();
Serial.println("This will never be printed");
}
void loop() {
}
头文件说明:原帖代码里的尖括号写法 include EEPROM.h,因站点会剥掉尖括号内容,这里按编译等价规则改成了引号写法,Arduino 工具链下两种写法对库搜索路径等价。除此之外,包括引脚定义、注释和缩进在内,代码与原帖逐字符一致。
配置里还有一个分支值得留意:psramFound() 为真时走 FRAMESIZE_UXGA、jpeg_quality 10、双缓冲帧;检测不到 PSRAM 就退到 SVGA、质量 12、单缓冲。板型选对时一般走 UXGA 那条分支,XCLK 频率固定 20000000 Hz,像素格式 PIXFORMAT_JPEG。
烧录步骤照原帖走:Tools 菜单里选 Board 为 AI-Thinker ESP32-CAM,Port 选板子对应的 COM 口,点上传按钮;当调试窗口开始滚动一串点的时候,按一下板载 RST 键,几秒后烧录完成。之后拔掉 GPIO 0 到 GND 的连线,打开 115200 波特率的串口监视器,再按一次 RESET。

正常现象是:摄像头初始化,拍照瞬间 GPIO 4 上那颗白色补光灯会亮一下,串口打出 Saved file to path: /pictureN.jpg。看照片时把卡拔下来插到电脑上读即可。成像条件原帖也有提醒:光线太强会毁掉照片,太暗会大片黑点,画质取决于光照。
原帖排查指南里点名的高频报错,我照单收在这里,烧录或运行时报哪个就对哪个查:
- Failed to connect to ESP32: Timed out waiting for packet header
- Camera init failed with error 0x20001 或类似的错误码
- Brownout detector 或 Guru meditation error
- Sketch too big error——分区方案(partition scheme)选错了
- Board at COMX is not available——COM 口没选
- Psram error: GPIO isr service is not installed
四、代码二:MJPEG 网页视频流
第二份程序把板子变成一台局域网 IP 摄像头:连上 Wi-Fi 后在 80 端口起一个 httpd 服务,根路径用 multipart/x-mixed-replace 的 MJPEG 格式连续推帧,浏览器打开 IP 就能看到实时画面。原帖注释里写明这套代码在 AI-Thinker、M5STACK PSRAM 和 M5STACK 无 PSRAM 三种板型上测过,我们用的是第一种。
/*********
Rui Santos
Complete project details at https://RandomNerdTutorials.com/esp32-cam-video-streaming-web-server-camera-home-assistant/
IMPORTANT!!!
- Select Board "AI Thinker ESP32-CAM"
- GPIO 0 must be connected to GND to upload a sketch
- After connecting GPIO 0 to GND, press the ESP32-CAM on-board RESET button to put your board in flashing mode
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*********/
#include "esp_camera.h"
#include "WiFi.h"
#include "esp_timer.h"
#include "img_converters.h"
#include "Arduino.h"
#include "fb_gfx.h"
#include "soc/soc.h" //disable brownout problems
#include "soc/rtc_cntl_reg.h" //disable brownout problems
#include "esp_http_server.h"
//Replace with your network credentials
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
#define PART_BOUNDARY "123456789000000000000987654321"
// This project was tested with the AI Thinker Model, M5STACK PSRAM Model and M5STACK WITHOUT PSRAM
#define CAMERA_MODEL_AI_THINKER
//#define CAMERA_MODEL_M5STACK_PSRAM
//#define CAMERA_MODEL_M5STACK_WITHOUT_PSRAM
// Not tested with this model
//#define CAMERA_MODEL_WROVER_KIT
#if defined(CAMERA_MODEL_WROVER_KIT)
#define PWDN_GPIO_NUM -1
#define RESET_GPIO_NUM -1
#define XCLK_GPIO_NUM 21
#define SIOD_GPIO_NUM 26
#define SIOC_GPIO_NUM 27
#define Y9_GPIO_NUM 35
#define Y8_GPIO_NUM 34
#define Y7_GPIO_NUM 39
#define Y6_GPIO_NUM 36
#define Y5_GPIO_NUM 19
#define Y4_GPIO_NUM 18
#define Y3_GPIO_NUM 5
#define Y2_GPIO_NUM 4
#define VSYNC_GPIO_NUM 25
#define HREF_GPIO_NUM 23
#define PCLK_GPIO_NUM 22
#elif defined(CAMERA_MODEL_M5STACK_PSRAM)
#define PWDN_GPIO_NUM -1
#define RESET_GPIO_NUM 15
#define XCLK_GPIO_NUM 27
#define SIOD_GPIO_NUM 25
#define SIOC_GPIO_NUM 23
#define Y9_GPIO_NUM 19
#define Y8_GPIO_NUM 36
#define Y7_GPIO_NUM 18
#define Y6_GPIO_NUM 39
#define Y5_GPIO_NUM 5
#define Y4_GPIO_NUM 34
#define Y3_GPIO_NUM 35
#define Y2_GPIO_NUM 32
#define VSYNC_GPIO_NUM 22
#define HREF_GPIO_NUM 26
#define PCLK_GPIO_NUM 21
#elif defined(CAMERA_MODEL_M5STACK_WITHOUT_PSRAM)
#define PWDN_GPIO_NUM -1
#define RESET_GPIO_NUM 15
#define XCLK_GPIO_NUM 27
#define SIOD_GPIO_NUM 25
#define SIOC_GPIO_NUM 23
#define Y9_GPIO_NUM 19
#define Y8_GPIO_NUM 36
#define Y7_GPIO_NUM 18
#define Y6_GPIO_NUM 39
#define Y5_GPIO_NUM 5
#define Y4_GPIO_NUM 34
#define Y3_GPIO_NUM 35
#define Y2_GPIO_NUM 17
#define VSYNC_GPIO_NUM 22
#define HREF_GPIO_NUM 26
#define PCLK_GPIO_NUM 21
#elif defined(CAMERA_MODEL_AI_THINKER)
#define PWDN_GPIO_NUM 32
#define RESET_GPIO_NUM -1
#define XCLK_GPIO_NUM 0
#define SIOD_GPIO_NUM 26
#define SIOC_GPIO_NUM 27
#define Y9_GPIO_NUM 35
#define Y8_GPIO_NUM 34
#define Y7_GPIO_NUM 39
#define Y6_GPIO_NUM 36
#define Y5_GPIO_NUM 21
#define Y4_GPIO_NUM 19
#define Y3_GPIO_NUM 18
#define Y2_GPIO_NUM 5
#define VSYNC_GPIO_NUM 25
#define HREF_GPIO_NUM 23
#define PCLK_GPIO_NUM 22
#else
#error "Camera model not selected"
#endif
static const char* _STREAM_CONTENT_TYPE = "multipart/x-mixed-replace;boundary=" PART_BOUNDARY;
static const char* _STREAM_BOUNDARY = "\r\n--" PART_BOUNDARY "\r\n";
static const char* _STREAM_PART = "Content-Type: image/jpeg\r\nContent-Length: %u\r\n\r\n";
httpd_handle_t stream_httpd = NULL;
static esp_err_t stream_handler(httpd_req_t *req){
camera_fb_t * fb = NULL;
esp_err_t res = ESP_OK;
size_t _jpg_buf_len = 0;
uint8_t * _jpg_buf = NULL;
char * part_buf[64];
res = httpd_resp_set_type(req, _STREAM_CONTENT_TYPE);
if(res != ESP_OK){
return res;
}
while(true){
fb = esp_camera_fb_get();
if (!fb) {
Serial.println("Camera capture failed");
res = ESP_FAIL;
} else {
if(fb->width > 400){
if(fb->format != PIXFORMAT_JPEG){
bool jpeg_converted = frame2jpg(fb, 80, &_jpg_buf, &_jpg_buf_len);
esp_camera_fb_return(fb);
fb = NULL;
if(!jpeg_converted){
Serial.println("JPEG compression failed");
res = ESP_FAIL;
}
} else {
_jpg_buf_len = fb->len;
_jpg_buf = fb->buf;
}
}
}
if(res == ESP_OK){
size_t hlen = snprintf((char *)part_buf, 64, _STREAM_PART, _jpg_buf_len);
res = httpd_resp_send_chunk(req, (const char *)part_buf, hlen);
}
if(res == ESP_OK){
res = httpd_resp_send_chunk(req, (const char *)_jpg_buf, _jpg_buf_len);
}
if(res == ESP_OK){
res = httpd_resp_send_chunk(req, _STREAM_BOUNDARY, strlen(_STREAM_BOUNDARY));
}
if(fb){
esp_camera_fb_return(fb);
fb = NULL;
_jpg_buf = NULL;
} else if(_jpg_buf){
free(_jpg_buf);
_jpg_buf = NULL;
}
if(res != ESP_OK){
break;
}
//Serial.printf("MJPG: %uB\n",(uint32_t)(_jpg_buf_len));
}
return res;
}
void startCameraServer(){
httpd_config_t config = HTTPD_DEFAULT_CONFIG();
config.server_port = 80;
httpd_uri_t index_uri = {
.uri = "/",
.method = HTTP_GET,
.handler = stream_handler,
.user_ctx = NULL
};
//Serial.printf("Starting web server on port: '%d'\n", config.server_port);
if (httpd_start(&stream_httpd, &config) == ESP_OK) {
httpd_register_uri_handler(stream_httpd, &index_uri);
}
}
void setup() {
WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0); //disable brownout detector
Serial.begin(115200);
Serial.setDebugOutput(false);
camera_config_t config;
config.ledc_channel = LEDC_CHANNEL_0;
config.ledc_timer = LEDC_TIMER_0;
config.pin_d0 = Y2_GPIO_NUM;
config.pin_d1 = Y3_GPIO_NUM;
config.pin_d2 = Y4_GPIO_NUM;
config.pin_d3 = Y5_GPIO_NUM;
config.pin_d4 = Y6_GPIO_NUM;
config.pin_d5 = Y7_GPIO_NUM;
config.pin_d6 = Y8_GPIO_NUM;
config.pin_d7 = Y9_GPIO_NUM;
config.pin_xclk = XCLK_GPIO_NUM;
config.pin_pclk = PCLK_GPIO_NUM;
config.pin_vsync = VSYNC_GPIO_NUM;
config.pin_href = HREF_GPIO_NUM;
config.pin_sccb_sda = SIOD_GPIO_NUM;
config.pin_sccb_scl = SIOC_GPIO_NUM;
config.pin_pwdn = PWDN_GPIO_NUM;
config.pin_reset = RESET_GPIO_NUM;
config.xclk_freq_hz = 20000000;
config.pixel_format = PIXFORMAT_JPEG;
if(psramFound()){
config.frame_size = FRAMESIZE_UXGA;
config.jpeg_quality = 10;
config.fb_count = 2;
} else {
config.frame_size = FRAMESIZE_SVGA;
config.jpeg_quality = 12;
config.fb_count = 1;
}
// Camera init
esp_err_t err = esp_camera_init(&config);
if (err != ESP_OK) {
Serial.printf("Camera init failed with error 0x%x", err);
return;
}
// Wi-Fi connection
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi connected");
Serial.print("Camera Stream Ready! Go to: http://");
Serial.print(WiFi.localIP());
// Start streaming web server
startCameraServer();
}
void loop() {
delay(1);
}
推流的实现值得读一遍:stream_handler 里循环调用 esp_camera_fb_get() 取帧,帧宽超过 400 且格式不是 JPEG 时用 frame2jpg 按 80 的质量转一档,再用 httpd_resp_send_chunk 把 JPEG 数据按边界字符串切成一段段发出去,这就是 MJPEG over HTTP 的标准做法。URI 表里只注册了一个根路径,处理器直接指向推流函数,服务器端口在 HTTPD_DEFAULT_CONFIG 里定死为 80。
连 Wi-Fi 的部分是常规写法:WiFi.begin 之后 while 循环等 WL_CONNECTED,每 500 毫秒在串口打一个点。连上后串口打出 Camera Stream Ready! Go to: 加 IP,随后 startCameraServer 把服务拉起来。这一段没有任何依赖要装,全部走 ESP32 Arduino 核心自带的库。
上传前只需要改两处:ssid 和 password 换成自己的 Wi-Fi 账号密码;CAMERA_MODEL_AI_THINKER 这一行保持启用状态。如果用的就是同一块板,其他什么都不用动。
烧录动作和代码一完全一样:GPIO 0 接地、按 RESET 进烧录模式,Board 选 AI-Thinker ESP32-CAM,点上传,滚点时按 RST。烧完拔掉 GPIO 0 的接地线,这一步和之前没有任何区别,两份程序共用一条烧录链路。
五、拿到 IP,看流,再往前一步
打开 115200 波特率的串口监视器,按板载 RESET,等它连上 Wi-Fi。串口会先打出 WiFi connected,接着一行 Camera Stream Ready! Go to: 后面跟着 IP 地址,形如 http://192.168.1.91 这样的内网地址。

浏览器输入这个 IP,实时视频流页面就出来了,局域网里的手机和电脑都能开。原帖还给了两个进阶接法:Home Assistant 里加一张 Picture 类型的卡片,Image URL 填这个 IP,仪表盘上就能常驻画面;用配置文件的方式也能达到同样效果。另外它和 Node-RED、Node-RED Dashboard 也兼容,加个 template 节点就能接进去。
串流方案这边的高频问题,原帖清单里能对上号的有四类:Wi-Fi 信号弱、串口里打不出 IP、网页打不开、以及画面卡顿延迟大。前三个多半和供电与信号有关,第四个在原帖的排查指南里有专门章节。我复现时会把板子放在离路由器近的位置先验证,再挪到安装点。
想像模像样装进家里的话,原帖的做法是把板子塞进一个假监控罩,板子尺寸正好合适,再用 5V 电源适配器从 GND 和 5V 两个引脚独立供电,挂在合适的位置就是一个能用的监控位。原作者实拍的效果图就是他家玄关的实时画面。

两个程序、一条烧录链路,不到十美元的板子把离线存证和在线监控都覆盖了。复现建议按这篇的顺序来:先跑通存卡,确认摄像头和卡槽都正常,再烧串流程序——万一第二步卡住,至少能确定硬件本身没问题。两份完整代码都在上面,可逐字符对照原帖核验。











假监控罩塞板子这个主意可以,比裸板挂在墙上体面多了。
先存卡再串流这个顺序建议很实在,硬件好坏一下就能分清。
FAT32 那步别偷懒,我上次用 exFAT 直接 Mount Failed,格式化完就好了。
正好手头有块吃灰的 ESP32-CAM,周末照这个把串流跑起来。
这份整理把两条主线放一篇里挺合理的。我先跑的是存卡那份,几个容易踩的点补充下:GPIO 0 接地之后一定要按一下板载 RESET 才进烧录模式,光接线不动它 IDE 会一直等包;烧完那根线不拔,程序看起来烧进去了实际不跑。另外补光灯亮那下其实是 GPIO 4 在动作,代码里用 rtc_gpio_hold_en 把它按住在低电平,不然深度睡眠期间会微微亮着费电。报错那一栏我最常遇到的是 0x20001,十有八九是排线没压紧。