ESP32-CAM 视频流媒体实操:接线、烧录与避坑

2026-11-16 13:11:34 115阅读 所属项目:ESP32 开发板

ESP32-CAM 是几十块钱就能买到的带摄像头模块,OV2640 加 ESP32-S 芯片,自带 SD 卡槽,拿来当监控摄像头、拍照终端都够用。RandomNerdTutorials 的 CameraWebServer 视频流示例是这块板最经典的玩法,下面把接线、烧录、串口拿 IP 这条链路完整捋一遍,顺带把新手最容易翻车的几个点标出来。

ESP32-CAM 视频流媒体服务器实拍

板子先认清:AI-Thinker ESP32-CAM 和摄像头引脚

AI-Thinker ESP32-CAM 开发板

市面上绝大多数 ESP32-CAM 是 AI-Thinker 这家的板子,OV2640 摄像头插在板侧的 DVP 接口上。板载没有 USB 口,烧录必须靠 FTDI 这类 USB 转 TTL 下载器,这也是它和普通 ESP32 开发板最大的区别。

摄像头走的是 8 位并口 DVP 总线,代码里引脚映射写得很清楚:XCLK 用 GPIO0,SIOD/SIOC(I2C 配置线)是 GPIO26/GPIO27,数据线 Y2 到 Y9 分布在 GPIO5、18、19、21、36、39、34、35,VSYNC/HREF/PCLK 是 GPIO25/23/22。PWDN 接 GPIO32,RESET 引脚没用到(-1)。注意 XCLK 占了 GPIO0,这个引脚同时是 boot 引脚,后面烧录时会很关键。

另外这块板要开流媒体必须依赖 PSRAM,AI-Thinker 板载 4MB PSRAM,所以 frame_size 才能拉到 UXGA。买山寨板如果 PSRAM 检测失败,分辨率会自动降级,这是很多人怀疑“怎么只有 CIF 画质”的原因。

接线:FTDI 下载器 + GPIO0 接地进烧录模式

ESP32-CAM 用 FTDI 下载器接线

接线一共五根,母对母杜邦线对着插就行:

ESP32-CAMFTDI 下载器
GNDGND
5VVCC (5V)
U0RTX
U0TRX
GPIO 0GND

两个要点:一是很多 FTDI 板上有 3.3V/5V 跳线帽,一定要拨到 5V 挡,ESP32-CAM 的 VCC 是按 5V 供电设计的,3.3V 挡烧录经常莫名失败;二是 U0R 接 FTDI 的 TX、U0T 接 RX,交叉接,别照着字面同名相连。

GPIO 0 接 GND 这一步是进烧录模式的开关,不接地代码永远传不进去。代码注释里官方原话也写了:接好 GPIO 0 到 GND 之后,还要按一下板上的 RST 按键,板子才会以烧录模式复位。

流媒体完整代码:CameraWebServer 示例逐字贴

Arduino IDE 先装好 ESP32 板支持包,然后新建工程,把下面这段代码整段贴进去(头文件尖括号写法在网页端会被剥掉,等价的双引号写法不影响编译):

/*********
  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);
}

上传前只需要改两处:把 ssid 和 password 换成你自己的 WiFi 名称和密码;摄像头型号保持 CAMERA_MODEL_AI_THINKER 这一行打开即可,用同款模块不用动任何引脚定义。

代码里有两处专门压 Brownout 复位的写法:WRITE_PERI_REG(RTC_CNTL_BROWNOUT_REG, 0) 把欠压检测暂时关掉,这是官方示例自带的,就是针对这块板供电敏感的老毛病。

烧录与拿 IP:115200 串口看地址

烧录按这个顺序走:

  1. Tools > Board 里选 AI Thinker ESP32-CAM;
  2. Tools > Port 里选 FTDI 对应的 COM 口;
  3. 点上传按钮,等调试窗口开始刷一串小圆点时,按一下 ESP32-CAM 板上的 RST 按键,开始写入;
  4. 烧完之后,先把 GPIO 0 到 GND 的那根线断开,再按一次 RST,板子回到正常运行模式。

串口监视器打印 ESP32-CAM 的 IP 地址

打开串口监视器,波特率设 115200,复位后窗口里会打印 Camera Stream Ready 和 IP 地址,比如 192.168.1.91 这样一个局域网地址。浏览器直接访问这个 IP,就是一个内嵌实时画面的网页,Motion JPEG 流走的是 /stream 路径,帧率取决于网络和分辨率设置。

想拿它做监控的话,Home Assistant 之类的平台可以直接把这个 IP 配成 Picture 卡片嵌进仪表盘,不用额外写服务端。

常见坑:Brownout、供电和 PSRAM

这块板被人问得最多的三个问题,全和供电沾边:

  • Brownout 复位循环:串口不停刷 Brownout detector triggered。摄像头开流时电流尖峰大,USB 口供电经常扛不住。换个 5V 2A 以上的电源,或者像官方教程那样给板子单独配一个 5V 电源适配器,从 GND 和 5V 引脚直接供电,问题基本消失。
  • 烧录时也报错:FTDI 的 5V/3.3V 跳线帽拨错,或者 GPIO 0 忘了接地,上传会卡在 Connecting........_____ 重复打点。先查跳线帽,再查 GPIO 0,最后确认按过 RST。
  • PSRAM 检测失败:启动日志里 psram 相关字段为 0,流媒体画质被迫降到 CIF。这种情况多半是板子问题,买的时候认准带 PSRAM 的版本。

官方教程还有一个收尾玩法值得照抄:把板子塞进一个假监控摄像头的外壳里,板子尺寸刚好放得进去,5V 适配器供电,摆在门口就是一个完整的局域网监控。几十块钱的料,一晚上能跑通。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/1197bc58d0d85b.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
拆机党
1楼 · 2026-11-16 13:12:24

这块板我前前后后烧废过不下十次,最后总结出来就是文章里那两条:跳线帽拨5V、GPIO0接地之后必须按RST。以前不知道按RST,IDE一直卡在Connecting打点,差点把板子扔了。Brownout那个也是,换了个2A的电源适配器直接就稳了,USB口带摄像头真的很勉强。

调参到凌晨
2楼 · 2026-11-16 13:12:24

GPIO0占给XCLK这个细节好多人不知道,难怪烧录的时候摄像头会初始化失败,学到了。

隔壁工位的好奇宝
3楼 · 2026-11-16 13:12:24

新手问一下,串口监视器一直刷Brownout detector triggered重启循环,是不是换个电源就能解决?

默默点赞的路人
4楼 · 2026-11-16 13:12:24

塞进假监控壳那个思路太实用了,成本几十块搞定一个局域网摄像头,周末就去搞。