各位 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# 编译 SDKmake
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_connect查看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 调试效率翻倍！🎉
