摄像头 - Qualcomm Dragonwing Documentation

IQ9-EVK 通过四个 MIPI CSI 接口支持摄像头传感器连接，同时支持 C-PHY 和 D-PHY 模式。

硬件架构

CSI 接口映射

CSI 接口	模拟开关	摄像头连接器	B2B 连接器
CSI0	U45 (TMUX646ZECR)	JCAM0	JEXP4，引脚 111–120
CSI1	U42 (TMUX646ZECR)	JCAM1	JEXP4，引脚 51–60
CSI2	U44 (TMUX646ZECR)	JCAM2	JEXP4，引脚 40–49
CSI3	U43 (TMUX646ZECR)	JCAM3	JEXP4，引脚 29–38

DIP 开关配置

通过 DIP 开关，四个 CSI PHY 可路由到 MIPI 摄像头端口或 GMSL 摄像头端口（通过 mezzanine 扩展板）。

开关	ON	OFF（默认）
SW1-5	CSI0 → GMSL mezzanine	CSI0 → 主板
SW1-6	CSI1 → GMSL mezzanine	CSI1 → 主板
SW1-7	CSI2 → GMSL mezzanine	CSI2 → 主板
SW1-8	CSI3 → GMSL mezzanine	CSI3 → 主板

支持的 MIPI CSI 摄像头传感器

ov9282 摄像头传感器

Arducam imx577 摄像头传感器

Arducam 传感器需要额外的转接板（Arducam 22 针转 Qualcomm 30 针 CSI 适配器）

Arducam imx577 传感器 + 22 针排线 + 转接板

Arducam imx577 摄像头传感器连接到 iq9075

ov9282 摄像头传感器连接到 iq9075

支持的分辨率

分辨率	宽高比	IMX577	OV9282
4000 × 3000	4:3	是	否
3840 × 2160	16:9	是	否
1920 × 1080	16:9	是	否
1280 × 720	16:9	是	是
1024 × 768	4:3	是	是
800 × 600	4:3	是	是
640 × 480	4:3	是	是
320 × 240	4:3	是	是

IQ-9075 不支持 SHDR、LDC 和 EIS 等高级功能。
没有硬件 JPEG 编码器——快照使用在 CPU 上运行的软件编码器。

摄像头流媒体

运行摄像头的前提条件

启用摄像头功能

在 Qualcomm Linux 2.0 上，qcom-multimedia-proprietary-image 默认包含下游摄像头软件包，但摄像头功能不会自动启用。在设备 shell 中运行以下命令，在 qcom-multimedia-proprietary-image 上启用摄像头支持：

echo -n "camx" > /var/data
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -p
sync
reboot

清除 GStreamer 注册表（如需要）

如果在启用摄像头 overlay 之前执行过 GStreamer 命令，则在启用摄像头 overlay 后必须清除 GStreamer 注册表。运行以下命令清除注册表：

rm ~/.cache/gstreamer-1.0/registry.aarch64.bin

单摄像头流

gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! 'video/x-raw,format=NV12,\
width=1280,height=720,framerate=30/1' ! fakesink

上述命令以 720p、30 FPS 的配置启动摄像头。来自摄像头传感器的帧会被 fakesink 丢弃。如果 gst 管道状态变为如下所示的 “PLAYING”，则表示摄像头正在运行。由于此命令将摄像头帧输出到 fakesink，设备上不会保存任何内容。如果管道状态变为 PLAYING，则摄像头正在运行。按 Ctrl+C 停止。

gbm_create_device(187): Info: backend name is: msm_drm
Setting pipeline to PAUSED ...
Pipeline is live and does not need PREROLL ...
Setting pipeline to PLAYING ...
New clock: GstSystemClock

视频编码

gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! \
video/x-raw,format=NV12,width=1280,height=720,framerate=30/1,\
interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc \
capture-io-mode=4 output-io-mode=5 extra-controls="controls,video_bitrate=6000000,\
video_bitrate_mode=0;" ! h264parse ! mp4mux ! filesink location=/opt/mux_avc.mp4

此命令以 720p、30 FPS 的配置启动摄像头，并在 h264 视频编码后将其保存为视频文件。如果 gst 管道状态变为 “PLAYING”，则表示摄像头正在运行。要停止摄像头，请按 CTRL+C。设备上会生成 /opt/mux_avc.mp4。可以在主机 PC 上运行以下 scp 命令从设备拉取录制的内容：

scp -r root@[ip-addr]:/opt/mux_avc. mp4 .

视频编码 + 快照

启动管道

gst-pipeline-app -e qtiqmmfsrc name=camsrc camera=0 ! video/x-raw,format=NV12,width=1280,height=720,\
framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! queue ! v4l2h264enc capture-io-mode=4 \
output-io-mode=5 extra-controls="controls,video_bitrate_mode=0,video_bitrate=6000000;" ! queue ! \
h264parse ! mp4mux ! queue ! filesink location="/opt/mux_720_avc.mp4" camsrc.image_1 ! "image/jpeg,\
width=1280,height=720,framerate=30/1" ! multifilesink location=/opt/frame%d.jpg async=false sync=true \
enable-last-sample=false

拍摄快照

在交互式菜单中：(1) Ready → (3) Playing → (p) Plugin Mode → (11) camerasrc → (37) capture-image → (1) Snapshot → 输入数量

停止并获取文件

按 Enter → b（返回）→ q（退出）。

scp -r root@[ip-addr]:/opt/<file name> .

使用离线 IFE 的多摄像头

IQ-9075 具有两个用于实时 bayer 转 YUV 处理的 IFE。使用实时 IFE 最多可同时运行两路摄像头。 离线 IFE（Offline IFE） 功能允许单个 IFE 以离线模式处理两路摄像头，从而实现最多四路摄像头的并发流。

每个传感器连接到一个 IFE-Lite 硬件实例，数据通过 RDI 端口转储到 DDR。使用单个 IFE 硬件，通过总线取数引擎 SFE Lite 从两个 IFE-Lite 读取数据，并以离线模式处理数据。采用这种方法时，摄像头帧不会直接送入 IFE，而是从 IFE_LITE 路由并转储到 DDR 中。然后通过取数引擎 SFE Lite 提供给 IFE 进行 bayer 转 YUV 处理。

验证多摄像头运行

将四个 OV9292 MIPI 摄像头连接到四个 MIPI CSI 插槽（0、1、2 和 3）为每路摄像头运行带 multicamera-hint=true 的 GST 命令以启用此功能。例如：

gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 multicamera-hint=true ! \
video/x-raw,format=NV12,width=1280,height=720,framerate=30/1,\
interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc \
capture-io-mode=4 output-io-mode=5 extra-controls="controls,video_bitrate=6000000,\
video_bitrate_mode=0;" ! h264parse ! mp4mux ! filesink location=/opt/mux_avc.mp4

在用户日志中查看以下打印以确认离线 IFE 功能已启用

CamX: [CORE_CFG]3509 3556 [CORE   ] camxpipeline.h:4222 SetPipelineStatus() RealTimeFeatureZSLPreviewRawOfflineIFE_0_cam_0 status is now PipelineStatus::STREAM_ON

故障排查

摄像头应用无法工作

检查摄像头模块连接和 DIP 开关设置

重启 cam-server

systemctl restart cam-server
# or
pkill cam-server

运行单流测试

gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! 'video/x-raw,format=NV12,\
width=1280,height=720,framerate=30/1' ! fakesink

摄像头传感器无法探测（Probe）

收集日志并搜索 probe success：

journalctl -f > /opt/user_log.txt

预期的探测成功日志：

CAM_INFO: CAM-SENSOR: Probe success, slot:0, slave_addr: 0x34, sensor_id:0x577

如果没有出现探测成功日志，请检查排线连接或摄像头模块。

摄像头无法出流

启用 CSI 调试日志并收集 dmesg：

echo 3 > /sys/kernel/debug/camera/ife/ife_csid_debug
dmesg -w > /opt/kernel_log.txt

启动摄像头，并在日志中检查 SOF/EOF IRQ 消息。 预期日志：

CAM_INFO: CAM-ISP: cam_ife_csid_irq: 5288 CSID:1 IPP SOF received
CAM_INFO: CAM-ISP: cam_ife_csid_irq: 5300 CSID:1 IPP EOF received
CAM_INFO: CAM-ISP: cam_ife_csid_irq: 5288 CSID:1 IPP SOF received
CAM_INFO: CAM-ISP: cam_ife_csid_irq: 5300 CSID:1 IPP EOF received

收集调试日志

journalctl -f > /opt/user_log.txt   # User space logs
dmesg -w > /opt/kernel_log.txt      # Kernel logs

资源

主题	链接
摄像头架构	Camera Architecture
摄像头传感器驱动开发	Camera Sensor Driver Development
自定义摄像头用例和管道	Customize Camera Use Case and Pipeline
自定义高级摄像头功能	Customize Advanced Camera Features

​硬件架构

​CSI 接口映射

​DIP 开关配置

​支持的 MIPI CSI 摄像头传感器

​ov9282 摄像头传感器

​Arducam imx577 摄像头传感器

​Arducam imx577 摄像头传感器连接到 iq9075

​ov9282 摄像头传感器连接到 iq9075

​支持的分辨率

​摄像头流媒体

​运行摄像头的前提条件

​单摄像头流

​视频编码

​视频编码 + 快照

​使用离线 IFE 的多摄像头

​验证多摄像头运行

​故障排查

​收集调试日志

​资源

硬件架构

CSI 接口映射

DIP 开关配置

支持的 MIPI CSI 摄像头传感器

ov9282 摄像头传感器

Arducam imx577 摄像头传感器

Arducam imx577 摄像头传感器连接到 iq9075

ov9282 摄像头传感器连接到 iq9075

支持的分辨率

摄像头流媒体

运行摄像头的前提条件

单摄像头流

视频编码

视频编码 + 快照

使用离线 IFE 的多摄像头

验证多摄像头运行

故障排查

收集调试日志

资源