psramInit : PSRAM init failed:PSRAM 没有启用或初始化失败
ESP32-CAM 常见问题 · 排查从第 L3 层开始
日志里常见的字样
psramInit : PSRAM init failedPSRAM not foundinit failedID read errorpsram fail这条报错说明什么
摄像头的帧缓冲放在 PSRAM 里;开发板选错或没有启用 PSRAM,高分辨率拍照会失败或内存不足。
先做这一步
Arduino IDE 开发板选「AI Thinker ESP32-CAM」(会自动启用 PSRAM);PlatformIO 用 board = esp32cam。仍然失败时降低分辨率(如 FRAMESIZE_VGA)再试。
按顺序排查,别跳步
- L0供电:核对供电与指示灯
- L1连接:确认 USB、驱动与端口
- L2烧录:检查模式、工具与配置
- L3最小程序:建立独立运行基线
断开外设,运行与板型匹配的 LED 或串口最小程序。 - L4串口:确认运行日志
- L5外设:逐个验证接线和通信
ESP32-CAM(AI-Thinker) 的注意事项
- GPIO 不耐受 5V。供电是最大的坑:用 5V 2A 的电源接 5V 引脚;电脑 USB 口或 USB 转串口模块的 3.3V 经常带不动摄像头和 Wi-Fi,表现为反复重启(Brownout)。
- 没有 USB 口:烧录要用 USB 转串口模块(TX→U0R,RX→U0T,GND 共地,5V 供电),并把 GPIO0 接 GND 后按 RST 进入下载模式。用 ESP32-CAM-MB 底板可以省去接线。
- 板背面的红色 LED 在 GPIO33(低电平点亮,没有引到排针);正面的白色大闪光灯在 GPIO4,非常亮,SD 卡 4 线模式也会用到它。
- GPIO2、4、12、13、14、15 被 microSD 卡共用:用 SD 卡时这些引脚就不能接别的东西。
- GPIO16 被 PSRAM 占用,不要接任何东西;GPIO12 上电时必须是低电平,否则 Flash 电压设置出错、无法启动。
- 排针上只有 ADC2 引脚,Wi-Fi 打开时 ADC2 不能用,所以这块板基本做不了模拟采样。
- 摄像头初始化失败(0x105 / 0x20001)通常是排线没插好,或代码里没选 CAMERA_MODEL_AI_THINKER。
相关问题
板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理,尚未逐条经过实物验证,请以实际测量为准。