简介：这是一份面向ESP32系列开发者的相机驱动源码包，托管了ESP32、ESP32-S2与ESP32-S3兼容的图像传感器驱动，并附带帧数据转BMP/JPEG格式的实用工具，适用于OV2640、OV3660、OV5640等主流摄像头的嵌入式视觉项目。压缩包共79个文件，以C语言头文件与源文件为主（36个h、23个c），另有少量C++、Makefile、Kconfig、txt说明及示例图片，整体273KB，结构清晰便于移植与二次开发。目前已有1185人学习/下载。源码覆盖传感器驱动、SCCB总线通信、摄像头缓存管理以及JPEG/BMP编码转换等模块，支持多种输出格式和分辨率，可直接集成到ESP-IDF工程中，适合入门智能家居、AI视觉或低功耗图像采集项目的中高级开发者。对于需要快速验证摄像头模组或搭建视觉采集链路的场景，这套代码提供了从底层初始化到帧数据输出的完整参考实现。 第一次玩 esp32-camera 这块板子的人，十个里有八个会卡在同一个地方：相机初始化失败，串口疯狂重启，或者好不容易出图了，画面上全是雪花点。网上资料其实不少，但大多只给你看结果，不讲为什么，缺了中间那条最关键的思考链路。这篇东西不打算复述官方 Wiki，我想把从选型、接线、环境搭建、代码逻辑到踩坑排除的完整过程，用我自己做过的项目经验重新讲一遍，保证你跟着走下来能少走几个星期的弯路。

如果你正准备做带图像采集的 ESP32 项目——不管是远程摄像头、拍照相册、扫码枪、人脸识别门禁，还是单纯想把摄像头画面传到一个网页上，这篇都适用。核心围绕 Arduin 开发环境下的 esp32-camera 驱动库展开，兼顾 ESP32 与 ESP32-S3 等常见芯片组合。

1. 在动手之前：这块芯片和这个库的边界在哪

先搞清楚一个概念。esp32-camera 是乐鑫官方维护的驱动程序库，它解决的问题非常聚焦：把挂在 DVP 或 MIPI 接口上的摄像头模组，以统一 API 的形式把图像帧拿回来。你不需要关心模组内部寄存器怎么配，不需要手动处理 FIFO 读写时序，调 esp_camera_fb_get() 就能拿到一帧完整数据。

但你要清楚它的能力边界。ESP32 主芯片本身不算强，尤其是经典款 ESP32 的 CPU 和内存都有限，能做的事基本被框在几个方向里：

  • 拍摄 JPEG 照片，存 SD 卡或上传服务器
  • 输出 MJPEG 视频流，局域网内做网页监控
  • 结合人脸检测、二维码识别库做图像识别前置采集
  • 低分辨率下的灰度/ RGB565 处理

这个库不负责推流协议，不负责 Web 服务器，也不负责图像识别。它只负责一件事：把摄像头的数据以帧为单位送到你的代码里，后续怎么用是你自己的事。理解这条边界很重要，能帮你避免很多不切实际的预期——比如用经典 ESP32 推 1080P 高帧率流，那基本没戏。

选芯片时注意区分。ESP32 和 ESP32-S3 都能用这个库，但 ESP32-S3 有更强 CPU 和更多内存，还支持二次开发时跑轻量级模型。如果你的项目需要做简单的图像处理，直接上 S3；如果只是拍个照传到服务器，经典 ESP32 加 PSRAM 就够用。

2. 硬件选型与接线：PSRAM 比像素重要得多

2.1 开发板怎么选

市面上最常见的 ESP32-CAM 是 AI-Thinker 出的那款，板载 OV2640，带一个 MicroSD 卡槽、一个 LED 灯、一根 PCB 天线，价格便宜，资料也多，适合入门。它的问题在于 IO 全部引出来了但很多都复用，GPIO 资源非常紧张，如果项目里还要接传感器，得仔细规划引脚。

想要更舒服的开发体验，可以考虑下面几个选择：

  • ESP32-S3-EYE：乐鑫官方生态板，带麦克风、LCD 和摄像头接口，适合做人机交互类项目
  • XIAO ESP32S3 + 摄像头扩展板：体积小，适合做穿戴或紧凑型设备
  • M5Stack 系列：带屏幕、电池管理，适合做手持拍照工具
  • 合宙 ESP32-S3 系列：性价比高，PSRAM 容量大

选型核心就一句话：确认板子带 PSRAM。这是 esp32-camera 跑高分辨率图像的硬性前提，不带 PSRAM 的 ESP32 只能跑 240x320 甚至更小分辨率，而且帧率很难看。

2.2 摄像头模组对位

模组型号 分辨率 优点 局限 适用场景
OV2640 200万像素 价格低、功耗低、资料最多 弱光表现一般 入门首选、普通监控
OV5640 500万像素 解析力强、支持对焦 贵、驱动复杂、帧率低 静态拍照、OCR
OV3660 300万像素 综合均衡 资料少 有一定经验后再试
OV7725 30万像素 灰度图像帧率高 分辨率低 帧率敏感的面部追踪

新手不需要纠结，直接选 OV2640。它跟 esp32-camera 库的适配度最高，示例代码基本都是围绕它写的。OV5640 我也用过，高分辨率时出图确实细腻，但帧率和内存开销都大，调试难度上一个台阶。

2.3 接线的几个关键点

排线连接是第一个坑。摄像头模组和主板之间通过 FPC 排线连接，排线上的金属触点非常脆弱。插的时候看好哪面朝上，有的板子触点朝下，有的朝上，硬怼容易弯针。插到位后用卡扣压紧，但别用蛮力。

供电是第二个坑。摄像头启动瞬间电流尖峰不小，ESP32-CAM 上 MicroUSB 供电在某些 USB Hub 口上可能压降严重。实测在推流模式下，电流能到 300mA 以上，如果带 SD 卡写入，瞬时峰值还会更高。建议用带屏蔽的短数据线，或者干脆外接 5V/2A 电源；用三节干电池或充电宝供电时，要确认线材内阻别太大。

ESD 保护也值得注意。摄像头排线露在外面时，手指静电可能直接打坏传感器。焊接或插拔前先摸一下接地金属放掉静电，这一个小动作能救下不少模组。

3. 环境准备：Arduino IDE 装板子，这个坑十个人八个踩

3.1 安装 ESP32 板卡

Arduino IDE 需要先装 ESP32 板卡支持。打开“开发板管理器”，在“附加开发板管理器网址”里填入乐鑫官方地址。填完后在开发板管理器里搜索“esp32”，安装 Espressif ESP32 系列。

国内用户最常遇到的问题就是包下载失败。第一次安装时，Arduino 要从 GitHub 拉一堆工具链，网络波动经常导致中途失败，报错信息大多是 net/http: request canceled 。这不是操作问题，纯粹是网络问题。

我的建议是：如果等了十几分钟还是卡住，直接把包下载链接复制到浏览器里，用加速下载工具先把文件拉下来，再放到 Arduino15 目录对应的 staging 文件夹里重新执行安装。或者找一下社区维护的离线安装包，解压到 Arduino15 目录也是一种省事办法，能保证工具链版本一致。

3.2 安装 esp32-camera 库

板卡装好之后，库本身分两种情况：

  • 如果你用的是 ESP32 官方板卡包里的适配版本，可以在 Arduino IDE 的库管理器里搜索“esp32-camera”，会自动安装一份可用版本
  • 如果你从 GitHub 拉最新源码，要手动把它复制到 Arduino/libraries 目录下，重启 IDE 才能识别

需要注意版本问题。esp32-camera 库有时会依赖板卡包里的头文件和相关配置项，因此库版本和板卡包版本要大致匹配。我自己踩过：板卡包升到 2.x 后，旧版库编译报了一堆类型错误。整理环境时最好把板卡包和库一起更新，别只更新其中一个。

3.3 用官方示例验证环境

装完先别急着写代码，编译一个现成示例来验证环境，能节省大量排查时间。打开 CameraWebServer 示例，参考注释选择开发板型号，比如使用 AI-Thinker ESP32-CAM 开发板就选 CAMERA_MODEL_AI_THINKER 。编译上传，波特率调到 115200，打开串口监视器，如果能看到 IP 地址输出，就说明环境完全没问题。

如果编译直接报头文件缺失，大概率是库没有正确安装；如果烧录后反复重启但串口没有任何打印，先检查芯片类型和波特率，再检查板子是否进入下载模式。

4. 核心 API 拆解：从配置结构体到帧缓冲

esp32-camera 的 API 设计得很集中，核心就是一套初始化和取帧流程。搞清楚这几个函数背后的内存逻辑，比背函数名有意义得多。

4.1 相机配置结构体指的是什么

初始化时所有关键参数都放在 camera_config_t 结构体里。以下是我常用的配置模板： 

#include "esp_camera.h"

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_sscb_sda = SIOD_GPIO_NUM;
config.pin_sscb_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_VGA;
config.jpeg_quality = 12;
config.fb_count     = 1;

字段太多容易看晕，核心就几个：

  • pin_xclk 是主芯片给摄像头提供时钟的引脚， xclk_freq_hz 是时钟频率。OV2640 上 20MHz 是稳定值，提高能稍微提帧率但会让信号变差
  • pixel_format 定义取图的输出格式，JPEG 压缩率高，RGB565 适合直接处理但数据量大
  • frame_size 定义输出分辨率，从 QQVGA 到 UXGA 可选，分辨率越高内存占用越大
  • jpeg_quality 只对 JPEG 输出有意义，值越低画质越高、体积越大
  • fb_count 是帧缓冲数量。帧缓冲数量越多，取帧时的等待越少，但内存消耗翻倍

4.2 初始化与反初始化

初始化很简单，调用一次： 

esp_err_t err = esp_camera_init(&config);
if (err != ESP_OK) {
    Serial.printf("Camera init failed with error 0x%x", err);
    return;
}

返回 ESP_OK 才算真正可用。错误码可以直接从串口读出来，后面排查部分我会给出常见错误码的解释。

反初始化用的频率不高，但在做低功耗项目时有用： 

esp_camera_deinit();

关闭后整个摄像头外设和 GPIO 状态会被释放，重新初始化时不要忘记重新设置引脚。

4.3 取帧与还帧必须成对出现

核心取帧代码就三行： 

camera_fb_t *fb = esp_camera_fb_get();
if (!fb) {
    Serial.println("Camera capture failed");
    return;
}
// 处理帧数据
esp_camera_fb_return(fb);

这里有个新手最容易犯的错误：拿到了 fb ，干完活一定要调用 esp_camera_fb_return 把缓冲区还回去。如果你只取不还，内部帧缓冲耗尽，后续再调用 esp_camera_fb_get 就会直接失败或阻塞，表现就是“用着用着突然不出图了”。养成 get 和 return 成对出现的习惯，这一点比任何优化都重要。

4.4 帧结构体里有什么

取到的 fb 是 camera_fb_t 结构体，包含以下关键字段：

  • buf ：指向图像数据的指针
  • len ：数据长度
  • width 、 height ：当前帧宽高
  • format ：像素格式（JPEG 或 RGB565 等）
  • timestamp ：帧采集时间

JPEG 模式下，你要做的就是把 buf 里的字节原样写出去或上传。RGB565 模式下则每个像素占 2 字节，处理逻辑完全不同。代码里判断 fb->format == PIXFORMAT_JPEG 再走分支，可以做到一套代码兼容两种输出。

5. 第一个实战：拍照上 SD 卡，做一个最小可用的相册

环境通了，API 理解了，就可以做一个真正能跑的最小项目：按一下按键拍一张照片，存到 SD 卡。这个项目不复杂，但能覆盖存储、取帧、文件操作的完整链路。

5.1 SD 卡相关的初始化

摄像头上面的 SD 卡槽在 AI-Thinker 板上和摄像头共用一部分引脚，初始化时需要先挂载文件系统： 

#include "SD_MMC.h"

if (!SD_MMC.begin("/sdcard", true)) {
    Serial.println("Card Mount Failed");
    return;
}

uint8_t cardType = SD_MMC.cardType();
if (cardType == CARD_NONE) {
    Serial.println("No SD card attached");
    return;
}

这里第二个参数 true 表示使用 1-bit 模式，只占一个引脚。4-bit 模式读写速度更快，但需要额外占用 3 个 IO 口，摄像头项目里引脚本来就紧张，通常没必要开。

5.2 拍照并落盘 

void capturePhotoToSD() {
    camera_fb_t *fb = esp_camera_fb_get();
    if (!fb) {
        Serial.println("Camera capture failed");
        return;
    }

    // 生成文件名
    static int fileNumber = 0;
    char filename[32];
    snprintf(filename, sizeof(filename), "/sdcard/photo_%04d.jpg", fileNumber++);

    File file = SD_MMC.open(filename, FILE_WRITE);
    if (!file) {
        Serial.println("Failed to open file");
        esp_camera_fb_return(fb);
        return;
    }

    file.write(fb->buf, fb->len);
    file.close();
    esp_camera_fb_return(fb);

    Serial.printf("Saved: %s, size: %zu bytes\n", filename, fb->len);
}

这段代码逻辑很简单，但有几个点值得注意：

  • 文件名用计数器递增，避免重复覆盖。重启后计数器归零是个问题，更稳的做法是读文件系统里已有的最大编号再往下走
  • 写入完先 file.close() ，再把帧缓冲还给摄像头，顺序不要反
  • 实际测试中，一张 VGA 分辨率、JPEG 质量 12 的照片大约 20~50KB，写入时间在几百毫秒，要留足等待时间

5.3 整理成可用的循环逻辑

主循环里检测按键按下就拍一张，按下 GPIO0 的 BOOT 键正好契合典型开发板的按钮位置： 

void loop() {
    if (digitalRead(0) == LOW) {
        delay(50); // 简单消抖
        if (digitalRead(0) == LOW) {
            capturePhotoToSD();
            while (digitalRead(0) == LOW) {
                delay(10);
            }
        }
    }
}

实测体验是：按一下 BOOT 键，串口打印保存路径，拔卡到电脑里能直接看照片。如果拍出来的照片是纯绿的或者整幅花屏，十有八九卡在 PSRAM 上，看下一章排查思路。

6. 进阶实战：局域网 Web 视频流，做出摄像头该有的样子

拍照存卡只是基础，真正让我觉得“这个项目活过来了”的时刻，是把画面推到浏览器里。实现方式不复杂：ESP32 起一个 HTTP Server，不断把 JPEG 帧以 multipart/x-mixed-replace 格式发给浏览器，浏览器就能实时显示。

6.1 流媒体传输思路

视频流本质是一串连续 JPEG 图片，通过 HTTP 响应头里的 Content-Type: multipart/x-mixed-replace; boundary=frame 告诉浏览器不断刷新图片。ESP32 端只需要在每次取帧后，把数据包按固定格式写到 HTTP 响应里。

官方示例 CameraWebServer 就是经典实现。它把网页 HTML 和 JavaScript 直接以字符串形式存在 Flash 里，通过 / 路径返回给浏览器，再通过 /stream 路径输出运动图像。如果你不完全依赖官方示例，手写一个简单版也不难。

考虑到摄像头开发者经常需要查看推流调试，官方示例里还实现了 httpd 的分块响应机制。注意浏览器在访问时不要刷新太快，否则 ESP32 的 WebServer 任务会被频繁打断，实测可能出现延迟和卡顿。

6.2 手动实现一个极简 Web 流

核心代码如下： 

static esp_err_t stream_handler(httpd_req_t *req) {
    esp_httpd_httpd_resp_set_type(req, "multipart/x-mixed-replace; boundary=frame");
    httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");

    camera_fb_t *fb = NULL;
    while (true) {
        fb = esp_camera_fb_get();
        if (!fb) {
            httpd_resp_send_500(req);
            return ESP_FAIL;
        }

        char part_header[64];
        int header_len = snprintf(part_header, sizeof(part_header),
            "--frame\r\nContent-Type: image/jpeg\r\nContent-Length: %u\r\n\r\n",
            fb->len);

        httpd_resp_send_chunk(req, part_header, header_len);
        httpd_resp_send_chunk(req, (const char *)fb->buf, fb->len);
        httpd_resp_send_chunk(req, "\r\n", 2);

        esp_camera_fb_return(fb);
    }
    return ESP_OK;
}

关键点是每一帧都拆成三段发送：分隔头、图像数据、结尾换行。浏览器靠 boundary=frame 区分每一张图。 httpd_resp_send_chunk 会自动处理分块传输编码，你只管按顺序把字节写进去就行。

延时控制也很有必要。不设延时的话，摄像头会以最高帧率输出，VGA 下能到 20FPS 左右，但这个速度对局域网监控未必有意义，反而增加功耗。如果只想做个“能看的画面”，在循环末尾加个 vTaskDelay(100 / portTICK_PERIOD_MS) 让它保持约 10FPS，就非常稳定了。

6.3 访问效果与调试

烧录运行后，浏览器直接访问 http://<esp32-ip>/ ，页面里会显示实时画面。如果画面不出但串口没报错，检查一下手机或电脑是否和 ESP32 在同一网段；如果画面卡顿，优先降低分辨率到 FRAMESIZE_VGA ，并把 jpeg_quality 提到 10 以上，体积小了传输速度自然提上来。

7. 踩坑实录：花屏、复位、一直重启的排查链路

这一章记录的每一条都是我自己或朋友实际踩过、并且花了不少时间才定位的问题。按排查顺序写出来，照着走能省下大量时间。

7.1 反复重启的根因通常不是代码

症状：烧录后串口一直重复打印初始化日志，到一半就重启。

排查链路：

  1. 先用串口监视器看到底停在哪一步。如果日志在挂载 SD 卡时卡住，先拔卡试试
  2. 如果日志打印到 Camera init failed 就重启，大概率是初始化过程中电流不足导致芯片掉电
  3. 断电，用万用表或功率计测板子瞬时电流。正常推流场景约 200~300mA，如果接近 500mA 还在重启，电源上限不够
  4. 换一个短而粗的 USB 线，或者直接外接 5V 稳压模块供电

这个坑看起来简单，但最容易误导人。我第一次遇到时反复改代码、改配置，折腾了两天，最后发现只是供电问题。建议出现重启类故障，先怀疑电源再怀疑代码。

7.2 花屏、绿屏、条纹，核心排查点在哪

症状：图片能看到轮廓但整体偏绿偏花，或画面出现大量水平条纹。

排查链路：

  1. 先检查 PSRAM。串口启动日志里会打印 PSRAM 相关字样，如果显示未启用或大小为 0，回去检查开发板选择。AI-Thinker 的配置需要确认是否开启了 CONFIG_SPIRAM_SUPPORT
  2. 检查 FPC 排线是不是松了。重新插拔一次，注意卡扣方向，排线接触不良的表现就是花屏和条纹
  3. 降低 xclk_freq_hz ，从 20MHz 降到 10MHz 试试。时钟频率太高会引入信号完整性问题，异常见效
  4. 如果用的是 ESP32-S3 主板，看看 IO 配置是不是和 pins_arduino.h 里的默认引脚一致，引脚定义错误会导致数据线错位

花屏问题里，接触不良和 PSRAM 未启用占掉七八成案例，基本轮不到改代码参数。

7.3 初始化失败的错误码怎么看

esp_camera_init 返回的错误码是有规律的。常见的几个：

错误码 含义 典型原因
0x20001 摄像头 ID 读取失败 排线接反、模组损坏、SCCB 引脚配置错误
0x20002 摄像头不支持该像素格式 把 RGB565 配置进了不支持该格式的模组
0x20003 不支持当前分辨率 换 FRAMESIZE 试试
0x20004 帧缓冲分配失败 PSRAM 没开或内存不足
0x20005 摄像头初始化超时 供电不足或复位时序有问题

第 0x20004 是我遇到最多的，尤其在没开 PSRAM 的板子上。看到这个错误码，优先排查内存配置。

7.4 IO 冲突导致的诡异现象

ESP32-CAM 上 IO 复用非常严重。板载 LED 和摄像头某些引脚共享，SD 卡用 1-bit 模式时也会占摄像头引脚。症状往往是：拍照片正常，但一读写 SD 卡画面就卡死。

此时不要盲目改驱动，先对照板子的原理图或引脚图，把使用的功能列一张表。比如 AI-Thinker ESP32-CAM 上 GPIO4 既是摄像头和 SD 卡共用引脚，也是 LED 控制引脚。如果你自己接了外部传感器又刚好用了这个脚，画面不出或者 SD 卡读写失败都算正常。

7.5 内存泄漏怎么定位

长期运行的摄像头项目最隐蔽的问题是内存慢慢变少，最终重启。最常见的原因就是 finish 后忘记 esp_camera_fb_return ，每次都泄漏一块帧缓冲。还有一个隐蔽点：HTTP 响应发送失败时直接 return 了，忘了归还帧缓冲。

我的习惯是在每个 return 之前检查是否已经 esp_camera_fb_return(fb) ，把归还逻辑放在函数出口统一处理。运行几天后，串口打印 ESP.getFreeHeap() 监控可用内存是否保持平稳，是排查内存问题最好用的手段。

8. 把性能再榨一榨：画质、帧率和内存的权衡

8.1 先看这组实测数据

下面是我在 AI-Thinker ESP32-CAM 上实测的大致数据，供你在项目启动时做参考：

分辨率 帧率（JPEG） 单帧大小 说明
QQVGA 160x120 25~30 FPS 5~10 KB 适合快速预览、简单识别
VGA 640x480 15~20 FPS 20~60 KB 综合平衡，推荐日常使用
SVGA 800x600 10~15 FPS 30~80 KB 画质尚可，但内存吃紧
UXGA 1600x1200 1~3 FPS 100~300 KB 适合静态拍照，不适合流畅预览

帧率和分辨率的取舍不是线性的，分辨率翻倍，内存占用和 JPEG 编码耗时都要大幅增长。经典 ESP32 跑 UXGA 基本只能拍静态照片，想流畅显示一定得降到 VGA 以下。

8.2 用控制接口调画质

除了改初始化参数，运行中也可以通过 esp_camera_set_control 调整亮度、对比度、饱和度等参数： 

camera_control_ctl_t ctrl;
ctrl.ctrl_id = BRIGHTNESS_CTRL;
ctrl.value = 2; // 范围 -2 到 2
esp_camera_set_control(&ctrl);

常用的控制项还包括 CONTRAST_CTRL 、 SATURATION_CTRL 、 GAIN_CTRL 、 WHITE_BALANCE_CTRL 等。比如室内偏暗的环境，适当提高增益和白平衡，画面观感能明显改善。但增益调太高会出现明显噪点，得不偿失。

8.3 帧缓冲数量选 1 还是 2

fb_count 设置成 1 时，取帧后如果想处理 time 很长，下一帧采集就会被阻塞，实际表现为帧率下降或卡顿；设置为 2 时，摄像头在后台持续采帧，你取的是最近一帧，吞吐量更高，但内存消耗也跟着翻倍。

带 PSRAM 的板子，内存宽松时可以设 2；不带 PSRAM 或内存紧张的，老老实实设 1，避免内存碎片导致初始化失败。

8.4 其他扩展方向

项目跑通后，你可以考虑这些方向：

  • 结合 OTA 功能，远程更新摄像头固件，省去每次拆机烧录的麻烦
  • 把帧推送到 MQTT 或 HTTP 上报接口，做个定时拍照上传的看护设备
  • 结合低功耗模式，平时休眠、PIR 触发后唤醒拍照，电池供电可以撑很久
  • 用 LVGL 加屏幕，做本地相册浏览界面，把 SD 卡里的照片直接刷到屏幕上

9. 最后分享一点我的个人惯例

项目第一次跑通、看到浏览器里出现实时画面的那一刻，确实很有成就感，但真正让这套方案变得可靠的，还是前面那些坑都填平之后的事情。我自己做 esp32-camera 项目时，现在已经养成一套固定动作：先查 PSRAM 日志，再测供电裕量，然后才看代码，最后长期运行时挂一个内存监控。这套顺序帮我避开过至少十次无效排错。

最后再分享一个非常小但很实用的技巧：调试阶段在串口日志里周期性打印 ESP.getFreeHeap() 和当前帧率。你不需要装任何监控工具，只需要通过串口观察一段时间，就能发现内存是否缓慢下降、帧率是否在某次操作后异常。很多莫名其妙的问题，一开始都是从这里看出端倪的。希望这篇东西能帮你少走点弯路，赶紧把画面跑出来。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

Logo
乐奇 Rokid 开放社区

更多推荐

cover

一期一会 | 什么是抬头显示器（HUD）？

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | AI眼镜周报｜Rokid四款硬件发布与Android XR工具转稳定版

avatar 乐奇 Rokid 开放社区
cover

极刻觅镜 | AI眼镜日报｜京东智能眼镜西安站活动与千问AI眼镜OTA升级

avatar 乐奇 Rokid 开放社区