问题描述
各位 K230/K230D 开发者们，大家好！
前几期我们为大家介绍了 Sensor 的适配方法。Sensor 适配本身是一项复杂且细致的工作，参数繁多、逻辑环环相扣，稍不留神就会出现各类异常，让人十分头疼。
本期我们继续为大家带来一款实用的调试工具 ——sample_vicap_sensor。
它是一款专门面向 Sensor 的预览与调试工具，基于 K230/K230D 平台的 VICAP（Video Capture）子系统开发。用户无需手动编写测试代码，就能快速完成 Sensor 调试、预览与数据验证，大幅简化调试流程、提升开发效率。
一、sample_vicap_sensor功能
核心功能
| 功能 | 说明 |
|---|---|
| 实时预览 | 将 sensor 数据输出到显示屏 |
| 多格式 Dump | 支持 YUV/RGB/RAW 多种格式保存 |
| 参数调节 | 支持 AE/AWB/HDR/DNR3 等参数配置开关 |
| 手动控制 | 支持手动曝光、手动增益调节 |
| 交互命令 | 运行时可输入命令控制 |
流程框架
Sensor → VICAP DEV0
├─ CHN0 → Dump (支持 YUV/RGB/RAW 格式，无缩放)
└─ CHN1 → VO layer → Connector (预览，根据屏幕大小进行切割和缩放)
快速开始
1、编译 demo
cd ~/src/rtsmart/examples/mpp/sample_vicap_sensor
# 编译 SDK
make
2、运行 demo
# 基本用法（必须指定 connector 类型）
sample_vicap_sensor -c 101
# 完整参数示例
sample_vicap_sensor -c 101 -ae 1 -awb 1 -hdr 0 -width 1280 -height 720 -fps 60
3、交互命令
运行后，你可以输入以下命令：
| 命令 | 功能 |
|---|---|
d |
Dump 一帧 |
d 5 |
Dump 5 帧 |
q |
退出 |
二、参数详解
必需参数
| 参数 | 说明 | 示例 |
|---|---|---|
-c <type> |
Connector 类型（如 20） | -c 20 |
注意：可以通过list_connector查看connect type（-c参数）
可选参数
基础配置
| 参数 | 说明 | 默认值 | 示例 |
|---|---|---|---|
-r <degree> |
旋转角度（0/90/180/270） | 0 | -r 90 |
-s <csi> |
CSI 索引（0-2） | 2 | -s 0 |
-width <value> |
Sensor 宽度 | 1920 | -width 1280 |
-height <value> |
Sensor 高度 | 1080 | -height 720 |
-fps <value> |
Sensor 帧率 | 30 | -fps 60 |
ISP图像处理配置
| 参数 | 说明 | 默认值 | 示例 |
|---|---|---|---|
-ae <0|1> |
AE 状态（0: 禁用，1: 启用） | 1 | -ae 0 |
-awb <0|1> |
AWB 状态（0: 禁用，1: 启用） | 1 | -awb 0 |
-hdr <0|1> |
HDR 状态（0: 禁用，1: 启用） | 0 | -hdr 1 |
-dw <0|1> |
Dewarp 状态（0: 禁用，1: 启用） | 0 | -dw 1 |
-dnr3 <0|1> |
DNR3 状态（0: 禁用，1: 启用） | 1 | -dnr3 0 |
手动调节（需先禁用 AE）
| 参数 | 说明 | 示例 |
|---|---|---|
-exp <value> |
手动曝光时间（微秒） | -exp 10000（10ms） |
-again <value> |
手动模拟增益 | -again 4.0 |
输出格式
| 参数 | 说明 | 默认值 |
|---|---|---|
-ofmt <0|1|2|3> |
Channel 0 格式：0=YUV, 1=RGB888, 2=RGB888P, 3=RAW | 0 |
三、Dump 功能详解
支持的格式
| 格式 | 参数 | 文件后缀 | 说明 |
|---|---|---|---|
| YUV420SP | -ofmt 0 |
.yuv420sp | 默认格式，体积小 |
| RGB888 | -ofmt 1 |
.rgb888 | 真彩色 |
| RGB888P | -ofmt 2 |
.rgb888p | 分离 RGB |
| RAW10 | -ofmt 3 |
.raw10 | 原始数据 |
查看 Dump 文件
下载dump工具，地址：
https://www.kendryte.com/zh/resource/isp_tool,k230
赶快试试吧！ 让你的 sensor 调试效率翻倍！🎉