LISA DVP Ping-Pong 模式捕获示例

功能说明

本示例演示如何使用 LISA DVP 驱动的 Ping-Pong 双缓冲模式实现高速连续图像捕获，两个缓冲区交替使用实现零拷贝连续采集。

硬件连接

PAD_A 10: HSYNC
PAD_A 11: VSYNC
PAD_A 12: PCLK
PAD_A 13-20: D0-D7（8位数据总线）
PAD_A 26: MCLK

连接支持 DVP 接口的摄像头模块（如 GC032A）。

示例步骤

获取 DVP 设备
配置 DVP 参数（分辨率 640x480、YUV422 格式、信号极性等）
启用时钟输出（为摄像头提供 25MHz MCLK）
清空两个缓冲区，启动 Ping-Pong 模式捕获
通过回调函数交替处理 Ping/Pong 缓冲区数据，重载对应缓冲区
捕获 20 帧后自动停止

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

-s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名
-b 3000000：烧录波特率（3Mbps）
0x0：烧录起始地址
build/arcs.bin：编译生成的固件路径
-C arcs：芯片类型

注意事项：

确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

==========================================
  LISA DVP Driver Sample - Ping-Pong Mode
==========================================
Frame format: YUV422
Resolution: 640x480
Max frames: 20
Mode: Ping-Pong (zero-copy continuous capture)

DVP device obtained
DVP setup completed (DMA channel: 2)
DVP clockout enabled (25MHz)
DVP Ping-Pong capture started
Frame size: 640x480, buffer size: 614400 bytes
Ping buffer: 0x60xxxxxx
Pong buffer: 0x60xxxxxx
Waiting for frames (Ping-Pong mode)...
[PING] Frame 1 captured, size=614400 bytes
[PING] Frame data: XX XX XX XX XX XX XX XX
[PONG] Frame 1 captured, size=614400 bytes
[PONG] Frame data: XX XX XX XX XX XX XX XX
[PING] Frame 2 captured, size=614400 bytes
...
[PONG] Frame 10 captured, size=614400 bytes
Reached maximum capture frames, stopping...
DVP stopped successfully

==========================================
Capture completed
Ping frames: 10
Pong frames: 10
Total frames: 20
==========================================

核心 API

API	说明
`lisa_dvp_setup()`	初始化并配置 DVP 设备
`lisa_dvp_enable_clockout()`	启用时钟输出
`lisa_dvp_start_pingpong()`	启动 Ping-Pong 模式捕获
`lisa_dvp_reload_pingpong()`	重载缓冲区（在回调中调用）
`lisa_dvp_stop()`	停止捕获

关键代码

/* 启动 Ping-Pong 模式捕获 */
lisa_dvp_start_pingpong(dvp_dev, ping_buffer, pong_buffer, buffer_size);

/* 回调中处理并重载对应缓冲区 */
static void dvp_callback(lisa_dvp_event_t event, void *user_data)
{
    if (event == LISA_DVP_EVENT_PING_DONE) {
        /* 处理 Ping 缓冲区数据 */
        lisa_dvp_reload_pingpong(dvp_dev, 0, ping_buffer, buffer_size);
    } else if (event == LISA_DVP_EVENT_PONG_DONE) {
        /* 处理 Pong 缓冲区数据 */
        lisa_dvp_reload_pingpong(dvp_dev, 1, pong_buffer, buffer_size);
    }
}

注意事项

双缓冲区：需要准备两个大小相同的缓冲区，都必须 4 字节对齐
内存需求：Ping-Pong 模式需要双倍内存（2 个缓冲区 x 614400 字节）
缓冲区位置：缓冲区放在 PSRAM 中以节省 SRAM 空间
重载时机：必须在对应的回调中及时重载缓冲区
处理时间：处理单帧的时间必须小于采集一帧的时间，否则会造成丢帧