ESP32-cam快速入门

0 阅读4分钟

硬件

image-20260514140723242

ESP32-CAM

是一种带摄像头的小型 Wi-Fi/蓝牙开发板,本质上是:

  • ESP32 微控制器(MCU)
    • 摄像头模块(通常是 OV2640)
    • 无线通信
    • GPIO 扩展接口

它非常便宜、体积小,常用于:

  • 视频监控
  • AI视觉识别
  • 远程拍照
  • 物联网摄像头
  • 小车视觉
  • 人脸识别
  • RTSP/HTTP 视频流
  • 智能门铃
  • 工业设备图像采集

OV2640

是一颗经典的 CMOS 摄像头传感器,ESP32-CAM 上最常见。

它主打:

  • 低成本
  • 低功耗
  • 小体积
  • 内置 JPEG 压缩

很多 ESP32-CAM、Arduino 摄像头模块都在用它。

特点

ESP32-CAM 常用设置

ESP32-CAM 实际常用:

分辨率推荐用途
320×240AI检测
640×480视频流
800×600抓拍
1024×768静态图
1600×1200高质量照片

因为 ESP32 内存有限:

高分辨率会:

  • 掉帧
  • 卡顿
  • Wi-Fi 不稳定
  • 容易崩溃

OV2640 最大帧率

官方会因模式不同而变化。

大致:

分辨率FPS
QQVGA60fps+
QVGA30fps
VGA20fps 左右
UXGA很低

ESP32-CAM 实际:

一般:

  • VGA:10~20fps
  • UXGA:几 fps

因为瓶颈不只是传感器,还有:

  • ESP32 内存
  • JPEG编码
  • Wi-Fi传输

最大特点:硬件 JPEG

OV2640 最大优势之一:

内置 JPEG 压缩

这对 ESP32 非常重要。

否则 ESP32 根本扛不住原始 RGB 视频流。

因此:

ESP32-CAM 的 MJPEG 视频流其实很常见。


图像质量

属于:“能用型”

特点:

  • 白天效果还行
  • 夜晚一般
  • 动态范围差
  • 暗光噪点明显

不适合:

  • 工业精密视觉
  • 高质量摄影
  • OCR精度要求高

安装

Arduino IDE

注意:首次打开软件如果一直卡在下方的页面,请开魔法

image-20260514141252478


添加 ESP32 开发板

首先设置为中文界面

image-20260514141639021

然后

文件
→ 首选项
→ 其他开发板管理器网址

输入

https://espressif.github.io/arduino-esp32/package_esp32_index.json
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

然后:

工具
→ 开发板
→ 开发板管理器
→ 搜索 ESP32
→ 安装 Espressif Systems版的

image-20260514142448327

插上开发板后,新建一个项目,指定开发板和接口,拷贝下面测试代码后上传(修改其中的ssid和password即可)

#include <Arduino.h>

#include <WiFi.h>

#include "esp_camera.h"



// ===================== WiFi =====================

const char* ssid = "xxx";

const char* password = "xxx";



// ===================== 默认摄像头引脚=====================

#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



String cmd = "";



// ===================== WiFi测试 =====================

void testWiFi() {

  Serial.println("\n[WiFi] connecting...");



  WiFi.begin(ssid, password);



  int t = 20;

  while (WiFi.status() != WL_CONNECTED && t--) {

    delay(500);

    Serial.print(".");

  }



  if (WiFi.status() == WL_CONNECTED) {

    Serial.println("\n[WiFi] OK");

    Serial.print("IP: ");

    Serial.println(WiFi.localIP());

  } else {

    Serial.println("\n[WiFi] FAIL");

  }

}



// ===================== 摄像头测试 =====================

void testCamera() {

  Serial.println("\n[CAM] init start...");



  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;



  config.frame_size = FRAMESIZE_QVGA; // 重要:先用低分辨率

  config.fb_count = 1;



  esp_err_t err = esp_camera_init(&config);



  if (err != ESP_OK) {

    Serial.print("[CAM] init FAIL, error = ");

    Serial.println(err);

    return;

  }



  Serial.println("[CAM] init OK");



  camera_fb_t *fb = esp_camera_fb_get();



  if (!fb) {

    Serial.println("[CAM] capture FAIL");

    return;

  }



  Serial.print("[CAM] image size = ");

  Serial.println(fb->len);



  esp_camera_fb_return(fb);



  Serial.println("[CAM] capture OK");

}



// ===================== 命令处理 =====================

void handleCommand(String cmd) {

  cmd.trim();



  if (cmd == "help") {

    Serial.println("Commands:");

    Serial.println("wifi   -> test WiFi");

    Serial.println("camera -> test camera");

  }



  else if (cmd == "wifi") {

    testWiFi();

  }



  else if (cmd == "camera") {

    testCamera();

  }



  else {

    Serial.println("Unknown command");

  }

}



void setup() {

  Serial.begin(115200);

  delay(1000);



  Serial.println("\nESP32 Debug Ready");



  // ===================== 🔥 PSRAM检测 =====================

  if (psramFound()) {

    Serial.println("PSRAM: YES (有外部内存)");

  } else {

    Serial.println("PSRAM: NO (没有外部内存)");

  }



  Serial.println("Type: wifi / camera / help");

}



void loop() {

  while (Serial.available()) {

    char c = Serial.read();



    if (c == '\n') {

      handleCommand(cmd);

      cmd = "";

    } else {

      cmd += c;

    }

  }

}

验证

工具-》串口监视器

然后

按一下 RESET 或重新插拔电源

在输入框中输出wifi和camera进行测试,得到下面结果

image-20260514144314834

打开官方 CameraWebServer 示例

路径:

文件
→ 示例
→ ESP32
→ Camera
→ CameraWebServer

修改 Wi-Fi 信息

找到:

const char *ssid = "**********";
const char *password = "**********";

改成:

const char* ssid = "你的WiFi";
const char* password = "你的密码";

然后在board.config.h中注释掉#define CAMERA_MODEL_WROVER_KIT,打开\#define CAMERA_MODEL_AI_THINKER,保存后上传

image-20260514145009482

上传完成后reset重启一下 得到 image-20260514150806018

打开提供的网址后,开始视频流即可 image-20260514150931919