在嵌入式视觉开发领域RAW图是算法调试与画质优化的黄金素材。它未经ISP加工真实还原了Sensor的原始数据。本期技术分享灵眸科技工程师将为您详解在Rockchip平台上抓取RAW图的完整流程助您快速获取高质量原始数据夯实项目开发基础。在嵌入式视觉项目中无论是进行3A算法AF/AE/AWB的底层调试还是针对特定场景进行画质调优获取纯净的RAW图都是至关重要的第一步。RAW数据保留了图像传感器最原始的Bayer阵列信息未经过白平衡、降噪及色彩增强等ISP处理能让开发者最直观地评估硬件性能与环境光线。针对ROCKCHIP平台开发板我们整理了这份详尽的RAW图抓取指南。本文将从环境准备到命令执行逐一拆解关键步骤助力企业研发团队提升开发效率。PART.01——抓取前的准备工作为确保抓取过程顺利请提前确认以下环境与权限配置1.硬件环境Rockchip开发板如我们的EASY-EAI-Nano-TB等型号已正常启动且MIPI摄像头模组连接稳固。2.软件工具系统已预装 v4l2-ctl视频设备控制工具及 systemctl服务管理工具。3.操作权限全程需使用 root 权限操作避免因权限不足导致命令执行失败。PART.02——核心操作流程1. 关闭 RKAIQ 3A 服务Rockchip平台默认运行 rkaiq_3A_server服务该服务会自动对Sensor数据进行处理。为了获取纯血RAW图必须先关闭此服务。systemctl stop rkaiq_3A验证状态systemctl status rkaiq_3A若反馈显示为AUTHENTICATION COMPLETE则表示服务已成功关闭。2. 使能非紧凑模式Non-compact Mode平台默认的紧凑模式可能会对输出数据进行压缩或裁剪。我们需要手动关闭它以确保获取完整的RAW数据。推荐方式环境变量配置export normal_no_read_back0备选方式Sysfs节点配置若环境变量不生效可根据摄像头接口向对应节点写入数值echo 0 0 0 0 /sys/devices/platform/rkcif-mipi-lvds/compact_test # 若为lvds2接口则执行 # echo 0 0 0 0 /sys/devices/platform/rkcif-mipi-lvds2/compa3. 确认 Video 设备节点Rockchip平台通过/dev/video*节点管理摄像头设备。不同的stream_cif_mipi_id对应不同的功能如线性模式或HDR模式。我们需要找到正确的节点路径。执行命令查找grep stream_cif_mipi_id /sys/class/video4linux/*/name输出示例解读注示例中stream_cif_mipi_id0对应/dev/video0。通常情况下线性模式抓取RAW图优先选用id0对应的节点。/sys/class/video4linux/video0/name:stream_cif_mipi_id0 /sys/class/video4linux/video1/name:stream_cif_mipi_id14. 执行 RAW 图抓取使用v4l2-ctl工具进行抓图。以下命令以抓取BG10格式、1920x1080分辨率的单帧RAW图为例v4l2-ctl -d /dev/video0 --set-fmt-videowidth1920,height1080,pixelformatBG10 --stream-mmap3 --stream-skip3 --stream-poll --verbose --stream-count1 --stream-to/tmp/cam0.raw关键参数解析-d /dev/video0指定视频节点请根据上一步查询结果替换。--set-fmt-video设定视频格式。BG10代表10位深度的Bayer RAW数据BGBG排列。--stream-skip3跳过前3帧排除Sensor启动阶段的不稳定数据。--stream-to/tmp/cam0.raw指定RAW图的存储路径。抓取完成后可通过ls /tmp/ | grep cam0.raw确认文件是否生成。PART.03——避坑指南与注意事项权限报错若出现 Permission denied请执行 su root切换至超级用户。参数校验若出现 Invalid argument通常是分辨率或像素格式不被支持。建议使用 v4l2-ctl -d /dev/video0 --list-formats-ext查看Sensor支持的具体参数。RAW图查看BG10等RAW格式无法直接用普通看图软件打开建议使用ImageMagick、RawDigger等专业工具或通过自研代码进行解析。HDR模式HDR RAW图的抓取涉及不同的ID映射关系建议结合具体的Rockchip芯片手册及摄像头模组Datasheet进行确认。写在最后把整套流程串起来看Rockchip平台抓RAW图其实就四件事关3A → 开非紧凑 → 对节点 → v4l2-ctl落帧。步骤不复杂但每一步都有踩坑点——3A没关干净拿到的是ISP后的数据、紧凑模式没解开会丢行、节点对错了HDR和线性会串流。把这些细节捋顺后面做IQ tuning、做3A对标、甚至做Sensor选型评估素材才站得住脚这篇帖子是我们工程师在 EASY-EAI-Nano-TB 实板上跑通后整理出来的原版记录社区里还有同系列的Netplan、MIPI出图排查路径、AI-ISP的几篇都是先踩完坑再写出来的经验之谈。做嵌入式项目的同学欢迎来社区蹲一蹲。
Rockchip平台RAW图抓取全攻略，助力嵌入式视觉高效开发
在嵌入式视觉开发领域RAW图是算法调试与画质优化的黄金素材。它未经ISP加工真实还原了Sensor的原始数据。本期技术分享灵眸科技工程师将为您详解在Rockchip平台上抓取RAW图的完整流程助您快速获取高质量原始数据夯实项目开发基础。在嵌入式视觉项目中无论是进行3A算法AF/AE/AWB的底层调试还是针对特定场景进行画质调优获取纯净的RAW图都是至关重要的第一步。RAW数据保留了图像传感器最原始的Bayer阵列信息未经过白平衡、降噪及色彩增强等ISP处理能让开发者最直观地评估硬件性能与环境光线。针对ROCKCHIP平台开发板我们整理了这份详尽的RAW图抓取指南。本文将从环境准备到命令执行逐一拆解关键步骤助力企业研发团队提升开发效率。PART.01——抓取前的准备工作为确保抓取过程顺利请提前确认以下环境与权限配置1.硬件环境Rockchip开发板如我们的EASY-EAI-Nano-TB等型号已正常启动且MIPI摄像头模组连接稳固。2.软件工具系统已预装 v4l2-ctl视频设备控制工具及 systemctl服务管理工具。3.操作权限全程需使用 root 权限操作避免因权限不足导致命令执行失败。PART.02——核心操作流程1. 关闭 RKAIQ 3A 服务Rockchip平台默认运行 rkaiq_3A_server服务该服务会自动对Sensor数据进行处理。为了获取纯血RAW图必须先关闭此服务。systemctl stop rkaiq_3A验证状态systemctl status rkaiq_3A若反馈显示为AUTHENTICATION COMPLETE则表示服务已成功关闭。2. 使能非紧凑模式Non-compact Mode平台默认的紧凑模式可能会对输出数据进行压缩或裁剪。我们需要手动关闭它以确保获取完整的RAW数据。推荐方式环境变量配置export normal_no_read_back0备选方式Sysfs节点配置若环境变量不生效可根据摄像头接口向对应节点写入数值echo 0 0 0 0 /sys/devices/platform/rkcif-mipi-lvds/compact_test # 若为lvds2接口则执行 # echo 0 0 0 0 /sys/devices/platform/rkcif-mipi-lvds2/compa3. 确认 Video 设备节点Rockchip平台通过/dev/video*节点管理摄像头设备。不同的stream_cif_mipi_id对应不同的功能如线性模式或HDR模式。我们需要找到正确的节点路径。执行命令查找grep stream_cif_mipi_id /sys/class/video4linux/*/name输出示例解读注示例中stream_cif_mipi_id0对应/dev/video0。通常情况下线性模式抓取RAW图优先选用id0对应的节点。/sys/class/video4linux/video0/name:stream_cif_mipi_id0 /sys/class/video4linux/video1/name:stream_cif_mipi_id14. 执行 RAW 图抓取使用v4l2-ctl工具进行抓图。以下命令以抓取BG10格式、1920x1080分辨率的单帧RAW图为例v4l2-ctl -d /dev/video0 --set-fmt-videowidth1920,height1080,pixelformatBG10 --stream-mmap3 --stream-skip3 --stream-poll --verbose --stream-count1 --stream-to/tmp/cam0.raw关键参数解析-d /dev/video0指定视频节点请根据上一步查询结果替换。--set-fmt-video设定视频格式。BG10代表10位深度的Bayer RAW数据BGBG排列。--stream-skip3跳过前3帧排除Sensor启动阶段的不稳定数据。--stream-to/tmp/cam0.raw指定RAW图的存储路径。抓取完成后可通过ls /tmp/ | grep cam0.raw确认文件是否生成。PART.03——避坑指南与注意事项权限报错若出现 Permission denied请执行 su root切换至超级用户。参数校验若出现 Invalid argument通常是分辨率或像素格式不被支持。建议使用 v4l2-ctl -d /dev/video0 --list-formats-ext查看Sensor支持的具体参数。RAW图查看BG10等RAW格式无法直接用普通看图软件打开建议使用ImageMagick、RawDigger等专业工具或通过自研代码进行解析。HDR模式HDR RAW图的抓取涉及不同的ID映射关系建议结合具体的Rockchip芯片手册及摄像头模组Datasheet进行确认。写在最后把整套流程串起来看Rockchip平台抓RAW图其实就四件事关3A → 开非紧凑 → 对节点 → v4l2-ctl落帧。步骤不复杂但每一步都有踩坑点——3A没关干净拿到的是ISP后的数据、紧凑模式没解开会丢行、节点对错了HDR和线性会串流。把这些细节捋顺后面做IQ tuning、做3A对标、甚至做Sensor选型评估素材才站得住脚这篇帖子是我们工程师在 EASY-EAI-Nano-TB 实板上跑通后整理出来的原版记录社区里还有同系列的Netplan、MIPI出图排查路径、AI-ISP的几篇都是先踩完坑再写出来的经验之谈。做嵌入式项目的同学欢迎来社区蹲一蹲。
