支持的传感器

传感器列表与 esp32-camera 对齐（输出格式措辞已统一，如 YCbCr422 → YUV422、compression → JPEG），最后一列标注 PicoCamera 当前的支持进度：

型号	最大分辨率	色彩类型	输出格式	支持进度
OV2640	1600 x 1200	color	YUV422/420 RGB565/555 JPEG RAW RGB (8/10-bit)	✅ RGB565 + YUV422 + JPEG
OV3660	2048 x 1536	color	RAW RGB RGB565/555/444 CCIR656 YUV422 JPEG	✅ RGB565 + YUV422 + JPEG
OV5640	2592 x 1944	color	RAW RGB RGB565/555/444 CCIR656 YUV422/420 JPEG	✅ RGB565 + YUV422 + JPEG
OV7670	640 x 480	color	RAW Bayer Processed Bayer YUV422 GRB422 RGB565/555	✅ RGB565 + YUV422（无 JPEG 编码器）
OV7725	640 x 480	color	RAW RGB GRB422 RGB565/555/444 YUV422	RGB565（无 JPEG 编码器，未实测）
NT99141	1280 x 720	color	YUV422 RGB565/555/444 RAW CCIR656 JPEG	❌ 暂不支持
GC032A	640 x 480	color	YUV422 RAW Bayer RGB565	RGB565（无 JPEG 编码器，未实测）
GC0308	640 x 480	color	YUV422 RAW Bayer RGB565 Grayscale	✅ RGB565 + YUV422 + 灰度（无 JPEG 编码器）
GC2145	1600 x 1200	color	YUV422 RAW Bayer RGB565	✅ RGB565 + YUV422（无 JPEG 编码器）
BF3005	640 x 480	color	YUV422 RAW Bayer RGB565	❌ 暂不支持
BF20A6	640 x 480	color	YUV422 RAW Bayer Y-only	❌ 暂不支持
SC101IOT	1280 x 720	color	YUV422 RAW RGB	❌ 暂不支持
SC030IOT	640 x 480	color	YUV422 RAW Bayer	❌ 暂不支持
SC031GS	640 x 480	monochrome	RAW MONO Grayscale	❌ 暂不支持
HM0360	656 x 496	monochrome	RAW MONO Grayscale	❌ 暂不支持
HM1055	1280 x 720	color	RAW (8/10-bit) YUV422 RGB565/555/444	❌ 暂不支持

所有已支持的传感器还提供 set_reg/get_reg 原始寄存器读写；更多控制项按需移植。

对无 JPEG 编码器的传感器（如 OV7670、GC2145、GC0308、GC032A）请求 JPEG,pico_camera_init() 会返回 PICO_CAMERA_ERR_NOT_SUPPORTED——与 esp32-camera 行为一致。frame_size 超过传感器上限时不报错，告警并钳位到最大值。

安装

Arduino IDE

PicoCamera 已上架 Arduino 库管理器：打开 工具 → 管理库... （或速写 → 包含库 → 管理库），搜索 PicoCamera 点击安装即可。

Arduino 库管理器中的 PicoCamera

也可以手动安装：把本仓库放入 Arduino/libraries/，或打包为 zip 通过「添加 .ZIP 库」安装。

PlatformIO

PicoCamera 已上架 PlatformIO Registry：

lib_deps =

umeiko/PicoCamera@^0.4.1

也可以直接用 git 地址（lib_deps = https://github.com/umeiko/PicoCamera.git）或本地 file:// 路径。

Pico SDK（裸 CMake 工程）

本库是纯 Pico SDK 代码（不依赖 Arduino），裸 CMake 工程可以直接引入（要求 SDK ≥ 1.5.0）：

add_subdirectory(path/to/PicoCamera)

target_link_libraries(my_app pico_stdlib pico_camera)

完整工程见 examples/pico_sdk_capture，细节见使用指南。

Arduino / PlatformIO 两种方式需要 earlephilhower 的 arduino-pico 核心。

如果核心已经内置了 PicoCamera

较新的 arduino-pico 版本可能自带一份 PicoCamera。你自己安装的副本（Library Manager、PlatformIO lib_deps、git）始终优先于内置副本，因此无需等待核心发版就能用上最新版。可以用 pico_camera.h 里的宏确认当前编译进程序的是哪个版本：

Serial.println(PICO_CAMERA_VERSION_STRING);        // 例如 "0.3.0"
#if PICO_CAMERA_VERSION_HEX >= 0x00030000          // 特性开关
...
#endif

快速开始

RP2040 开发板连接摄像头模组
RP2040 开发板通过 FPC 排线连接 OV2640/OV3660 摄像头模组

#include <PicoCamera.h>
 
camera_config_t config = {
    .pin_pwdn = -1, .pin_reset = 29, .pin_xclk = 5,
    .pin_sccb_sda = 12, .pin_sccb_scl = 13,
    .pin_d0 = 14, .pin_d1 = 15, .pin_d2 = 16, .pin_d3 = 17,
    .pin_d4 = 18, .pin_d5 = 19, .pin_d6 = 20, .pin_d7 = 21,
    .pin_vsync = 2, .pin_href = 3, .pin_pclk = 4,
    .xclk_freq_hz = 10000000,
    .sccb_i2c_port = 0,
    .pixel_format = PIXFORMAT_RGB565,   // 或 PIXFORMAT_JPEG
    .frame_size = FRAMESIZE_QVGA,
    .jpeg_quality = 10,
    .fb_count = 1,
    .fb_location = PICO_CAMERA_FB_AUTO,
};
 
void setup() {
    pico_camera_init(&config);
}
 
void loop() {
    camera_fb_t *fb = pico_camera_fb_get();
    if (fb) {
        // fb->buf / fb->len / fb->width / fb->height
        // JPEG 模式下 buf 是完整 JPEG 文件（FFD8...FFD9）
        pico_camera_fb_return(fb);
    }
}

传感器控制：

sensor_t *s = pico_camera_sensor_get();
if (s) {
    if (s->set_vflip)   s->set_vflip(s, 1);
    if (s->set_quality) s->set_quality(s, 10);
}

与 esp32-camera 的差异

数据引脚 pin_d0..pin_d7 必须是 8 个连续 GPIO （PIO in pins 指令的硬件限制），初始化时会校验
SCCB 引脚是硬复用的（真 I2C，不像 ESP32 任意指派）：SDA 只能偶数脚、SCL 只能奇数脚，且两脚必须路由到 sccb_i2c_port 指定的外设——I2C0 为 SDA GP0/4/8...28、SCL GP1/5/9...29，I2C1 为 SDA GP2/6/10...26、SCL GP3/7/11...27（RP2350 延伸到 GP47）。初始化时校验
带 PSRAM 的 RP2350 板（在 core 的 PSRAM 菜单中启用后）可以把帧缓冲放进 PSRAM——设 fb_location = PICO_CAMERA_FB_IN_PSRAM 即可开更大的分辨率。默认 PICO_CAMERA_FB_AUTO 有 PSRAM 就用、分配失败**自动回退 SRAM** （与 esp32-camera 失败即 init 失败的语义不同）。RP2040 恒为 SRAM（264KB）：RGB565 建议 ≤ QVGA；JPEG 缓冲按宽×高/4 + 8KB 估算
SCCB 可以复用已初始化的 I2C 总线：pin_sccb_sda = -1，再用 sccb_i2c_port 指定总线（如 1 复用 Wire1，与 esp32-camera 一致）。需先自行 Wire1.begin()（或 i2c_init()）；库不会初始化也不会 deinit 共享总线
暂不支持 grab_mode：pico_camera_fb_get() 是阻塞单帧语义（等价 CAMERA_GRAB_WHEN_EMPTY），每次调用同步等下一帧

示例

CameraSerialInfo — 探测传感器并打印信息
CameraCaptureRGB565 — RGB565 抓帧
CameraCaptureJPEG — JPEG 抓帧（含 SOI/EOI 完整性检查）
camera_render_to_tft — 通过 TFT_eSPI 在 TFT 屏上实时预览（需先自行配置 TFT_eSPI）
push_image_to_python — 通过 USB 串口把帧推送给 Python（tkinter）上位机查看器

push_image_to_python 上位机截图
push_image_to_python：上位机实时渲染 OV2640 JPEG 图像流

文档

使用指南 — 配置项、取帧流程、camera_fb_t 与 sensor_t 详解（English）
完整 API 参考：https://umeiko.github.io/PicoCamera/zh/

许可证

MIT