> ## Documentation Index > Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt > Use this file to discover all available pages before exploring further. # 摄像头 IQ8-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 | ### DIP 开关配置 | 开关 | ON | OFF(默认) | | ----- | --------------------- | --------- | | SW1-5 | CSI0 → GMSL mezzanine | CSI0 → 主板 | | SW1-6 | CSI1 → GMSL mezzanine | CSI1 → 主板 | | SW1-7 | CSI2 → GMSL mezzanine | CSI2 → 主板 | ## 支持的 MIPI CSI 摄像头传感器 ### ov9282 摄像头传感器 ### Arducam imx577 摄像头传感器 **Arducam 传感器需要额外的转接板(Arducam 22 针转 Qualcomm 30 针 CSI 适配器)** **Arducam imx577 传感器 + 22 针排线 + 转接板** ### Arducam imx577 摄像头传感器连接到 iq8275 ### ov9282 摄像头传感器连接到 iq8275 ## 支持的分辨率 | 分辨率 | 宽高比 | 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-8275 不支持 SHDR、LDC 和 EIS 等高级功能。 * 没有硬件 JPEG 编码器 — 快照使用在 CPU 上运行的软件编码器。 ## 摄像头流传输 ### 运行摄像头的前提条件 * 启用摄像头功能 在 Qualcomm Linux 2.0 上,qcom-multimedia-proprietary-image 默认包含下游摄像头软件包,但摄像头功能不会自动启用。 在设备 shell 中运行以下命令,在 qcom-multimedia-proprietary-image 上启用摄像头支持: ```bash theme={null} 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 注册表。 运行以下命令清除注册表: ```bash theme={null} rm ~/.cache/gstreamer-1.0/registry.aarch64.bin ``` * 已知问题: 由于一个已知问题,IQ8 上的摄像头基本用例无法工作 要解决此问题,请应用以下临时解决方案: 在运行摄像头用例之前,先运行以下命令: ```bash theme={null} cp /usr/share/qcom/sa8775p/Qualcomm/SA8775P-RIDE/dsp/cdsp/libbitml_nsp_73nb_skel.so /usr/share/qcom/qcs8300/Qualcomm/IQ8275-EVK/dsp/cdsp/. ``` ### 单摄像头流 ```bash theme={null} 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` 停止。 ```bash theme={null} 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 ``` ### 视频编码 ```bash theme={null} 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 命令从设备拉取录制的内容: ```bash theme={null} scp -r root@[ip-addr]:/opt/mux_avc. mp4 . ``` ### 视频编码 + 快照 ```bash theme={null} 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`(退出)。 ```bash theme={null} scp -r root@[ip-addr]:/opt/ . ``` ## 使用离线 IFE 的多摄像头 IQ-8275 有两个用于实时 bayer 到 YUV 处理的 IFE。最多两个摄像头可以通过实时 IFE 并发工作。 **离线 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) 为每个摄像头运行带 **multicamera-hint=true** 的 GST 命令以启用此功能。例如: ```bash theme={null} 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 ``` ## 故障排除 ```bash theme={null} systemctl restart cam-server # or pkill cam-server ``` ```bash theme={null} gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! 'video/x-raw,format=NV12,\ width=1280,height=720,framerate=30/1' ! fakesink ``` 收集日志并搜索 `probe success`: ```bash theme={null} journalctl -f > /opt/user_log.txt ``` **预期的探测成功日志:** ``` CAM_INFO: CAM-SENSOR: Probe success, slot:0, slave_addr: 0x34, sensor_id:0x577 ``` 如果没有出现探测成功日志,请检查排线连接或摄像头模块。 启用 CSI 调试日志并收集 dmesg: ```bash theme={null} 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 ``` ### 收集调试日志 ```bash theme={null} journalctl -f > /opt/user_log.txt # User space logs dmesg -w > /opt/kernel_log.txt # Kernel logs ``` ## 资源 | 主题 | 链接 | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------- | | 摄像头架构 | [Camera Architecture](https://docs.qualcomm.com/doc/80-70023-17A/topic/camera-architecture.html) | | 摄像头传感器驱动开发 | [Camera Sensor Driver Development](https://docs.qualcomm.com/doc/80-70023-17A/topic/camera-sensor-driver-development.html) | | 自定义摄像头用例和流水线 | [Customize Camera Use Case and Pipeline](https://docs.qualcomm.com/doc/80-70023-17A/topic/customize-camera-use-case-and-pipelines.html) | | 自定义高级摄像头功能 | [Customize Advanced Camera Features](https://docs.qualcomm.com/doc/80-70023-17A/topic/customize-advanced-camera-features.html) |