瑞芯微RK平台摄像头排障全链路指南｜资深工程师排障笔记，干货收藏备用-上

本文基于触觉智能RK3576开发板Purple Pi OH2演示为大家整理一套摄像头异常排障全链路指南上篇主要讲解排查链路和录像花屏条纹常见问题环节。开篇相机问题的本质是数据流走到哪一段断了、或哪一段处理不对。本文把摄像头链路从头到尾讲透——链路五段定位、画面质量花屏/偏色、3A与tuning、帧率瓶颈、再到高频问题清单一套方法查到底。本文基于触觉智能linux sdk和真实链路整理。五段职责与“活着”的证据分别对应传感器→MIPI→CIF→ISP(3A)→VPSS→应用。无图查链路、花屏偏色查链路质量与 3A、帧率低查带宽与处理负载。下面五个问题域覆盖了相机排障的绝大部分场景。摄像头黑屏无图五段链路逐一排查相机无图不是驱动坏了一句话能概括的。从传感器到出流中间隔着MIPI物理链路、CIF 采集、ISP三A、应用取流五段每一段都有自己活着的证据。逐段确认就能把问题圈死在某一环。本SDKPurple Pi OH2的摄像头链路在板级dtskernel-6.1/arch/arm64/boot/dts/rockchip/ido-evb7609-v1a-cam.dtsi里是这么连的排查就从哪一段还活着入手工具链用 dmesg看驱动 probe、media-ctl看链路拓扑SDK 里rkisp_demo/setup_link.sh就是现成例子、media_enquiryexternal/camera_engine_rkaiq/media_enquiry/。1、逐段定位法环节活着的证据查什么 / 用什么工具① 传感器dmesg 出现 imx415 probe 成功读到 CHIP_ID 0x311Admesg | grep -i imx415i2c 地址/时钟/上电 GPIO 是否对见下文 dts 字段② MIPI 物理层csi2_dphy 状态正常lane 数对4-lanedts 里>③ MIPI CSI2mipi0_csi2 probe、端口接好dmesgmedia-ctl -p 看拓扑④ CIF 采集/dev/video 节点存在、能出原始图ls /dev/video* /dev/media*CIF 驱动 drivers/media/platform/rockchip/cif/⑤ ISP/3Arkaiq_3A_server 在跑、rkisp 出图pgrep rkaiq_3A3A 起没起直接影响出图见 04.032、第一段最容易出问题传感器没probe大部分黑屏无图卡在第①段——传感器根本没被驱动认出来。看 dmesg 里有没有 imx415 的 probe 报错再对着 dts 查这几项本板 ido-evb7609-v1a-cam.dtsi 的 imx415 节点dts 字段本板实际值对不上会怎样compatiblesony,imx415与 drivers/media/i2c/imx415.c 的 of_match 对不上 → 驱动不 proberegi2c 地址0x1a地址错 → i2c 读不到传感器 ID → probe 失败clocks / xvclkCLK_MIPI_CAMERAOUT_M0传感器主时钟没给 → 不工作reset/pwdn-gpiogpio3 RK_PB7 / RK_PC0上电时序/复位不对 → 传感器读不到 IDpower-domainsRK3576_PD_VIVI 电源域没上 → 采集全段不工作imx415驱动probe时会读芯片IDIMX415_REG_CHIP_ID 0x311A见drivers/media/i2c/imx415.c——读到表示probe 成功读不到就在dmesg 报错。所以dmesg是最快的分水岭。3、实操排查命令# 1. 传感器 probe 了吗dmesg | grep -iEimx415|camera|rkcif|rkisp|tail-30# 2. 设备节点在吗ls/dev/video* /dev/media*# 3. 链路拓扑media-ctl 打印参考 rkisp_demo/setup_link.sh 的连法media-ctl -d /dev/media0 -pmedia-ctl -d /dev/media1 -p# 4. 3A 服务在跑吗没跑可能黑屏pgrep -a rkaiq_3A || /etc/init.d/S40rkaiq_3A start五段问题定位里先确认第①段传感器有没有probedmesg见imx415成功/报错再沿MIPI → CIF → ISP 往上看节点与拓扑3A服务S40rkaiq_3A 启动 rkaiq_3A_server没跑也会直接导致无图。链路每一段都有 dmesg/节点/拓扑三层证据可查逐段排除就能定位。出图花屏/条纹/偏色问题在哪个环节有画面但花和没画面是两回事。花屏、条纹、偏色各有各的出身花屏多半是 MIPI/时钟/带宽条纹常是曝光/行场同步偏色基本是 3A/白平衡没干活。按现象 → 环节对号入座很快能圈定。相机出图链路从传感器 → MIPI → CIF → ISP/3A → VPSS 到应用。画面质量异常根因基本落在三处MIPI 物理/采集、ISP 处理、3A 是否在跑。下面把常见现象和它们对应的高概率环节列成一张表。现象 → 环节映射表现象高概率环节排查方向整屏花屏 / 横条纹乱闪MIPI 链路 / CIF 采集data-lanes 与传感器输出是否一致、时钟 lane/信号质量、CIF 时序与带宽见 04.04画面有规律横条纹明暗相间曝光 / 3A / 供电是否闪光/频闪市电 50Hz 频闪常见曝光时间与行频关系3A 的 AE 是否在收敛偏绿 / 偏红 / 整体偏色ISP 白平衡 / 3Arkaiq_3A_server 跑没跑、AWB 是否生效见 04.03画面半边暗/全黑半边亮传感器曝光/复位 / MIPI lane 部分丢失检查 4 条 lane 是否都通曝光模式花屏且伴随无图时有时无MIPI 信号不稳定信号完整性线缆/连接器/速率必要时降 lane 速率或降分辨率验证最容易踩的两个花屏坑坑1data-lanes 与传感器实际输出不一致dts 里传感器 port 的>传感器实际工作模式几 lane 输出对上。lane 数不匹配是花屏最常见原因之一。坑2xvclk / 主时钟频率不对传感器靠 dts 里 clocks cru CLK_MIPI_CAMERAOUT_M0本板 imx415提供主时钟。时钟频率不对驱动里通常按芯片要求配 24/27MHz 等传感器输出的帧时序就会乱表现就是条纹/花屏。用 /sys/kernel/debug/clk/clk_summary 看 xvclk 实际频率见 02.05。偏色先看 3A 跑没跑画面整体偏绿/偏红十有八九是白平衡AWB没生效。RK3576 的 3A 是用户态 rkaiq_3A_server启动脚本 S40rkaiq_3A日志走 logger -t rkaiq_3Apgrep -a rkaiq_3A# 3A 在不在/etc/init.d/S40rkaiq_3A start# 没跑就拉起logread | grep rkaiq_3A |tail# 3A 日志openwrt / journalctl -t rkaiq_3Asystemd3A 没跑时画面通常是原始直通状态白平衡、曝光都不收敛表现就是偏色/过曝/暗。这也解释了为什么 rkaiq_3A_server 是相机能正常出图的前置条件。画面质量类问题按现象对号入座花屏乱闪查 MIPIdata-lanes/时钟/信号、规律条纹查曝光与频闪、偏色查 3A/AWB。其中>下篇为大家带来3A调试、相机帧率、高频问题清单等排障