> ## 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.

# 摄像头快速入门指南

> 将摄像头传感器连接到您的参考硬件平台，并使用 GStreamer 和 V4L2 API 进行流传输 — QCS6490、IQ-9075-EVK、IQ-8275-EVK 和 IQ615。

<div style={{display:'flex',gap:'8px',flexWrap:'wrap',marginBottom:'16px'}}>
  <span style={{background:'#ede9fe',color:'#5b21b6',padding:'2px 10px',borderRadius:'999px',fontSize:'12px',fontWeight:600}}>QCS6490</span>
  <span style={{background:'#ede9fe',color:'#5b21b6',padding:'2px 10px',borderRadius:'999px',fontSize:'12px',fontWeight:600}}>IQ-9075-EVK</span>
  <span style={{background:'#ede9fe',color:'#5b21b6',padding:'2px 10px',borderRadius:'999px',fontSize:'12px',fontWeight:600}}>IQ-8275-EVK</span>
  <span style={{background:'#ede9fe',color:'#5b21b6',padding:'2px 10px',borderRadius:'999px',fontSize:'12px',fontWeight:600}}>IQ615</span>
  <span style={{background:'#f0fdf4',color:'#166534',padding:'2px 10px',borderRadius:'999px',fontSize:'12px',fontWeight:600}}>稳定</span>
</div>

<CardGroup cols={4}>
  <Card title="MIPI CSI" icon="camera">多平台支持</Card>
  <Card title="GStreamer" icon="microchip">主要 API</Card>
</CardGroup>

***

本页介绍如何将摄像头传感器连接到您的参考硬件平台，并通过 3 个简单步骤使其启动并运行。

***

<Tabs>
  <Tab title="QCS6490">
    ### 📸 通过 3 个简单步骤启动并运行 QCS6490 摄像头

    <Steps>
      <Step title="🔌 即插即用：摄像头硬件设置">
        <Accordion title="摄像头设置">
          QCS6490 出厂时已预先连接 IMX577 和 OV9282，如下图所示。

          <div className="flex flex-col items-center gap-2">
            <img src="https://mintcdn.com/qualcomm-prod/PyJ823JBh-_RDtS4/Technologies/Camera/images/camera_module_connection_2.png?fit=max&auto=format&n=PyJ823JBh-_RDtS4&q=85&s=4caacb8995de6f68bb6fa0028f903e16" width="411" height="297" data-path="Technologies/Camera/images/camera_module_connection_2.png" />
          </div>
        </Accordion>
      </Step>

      <Step title="🧰 就绪检查：前提条件">
        <Accordion title="前提条件">
          <Note>
            使用 SSH 连接到设备控制台。<br />
            有关说明，请参阅[如何使用 SSH？](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#connect-over-ssh)。
          </Note>

          <Steps>
            <Step title="启用摄像头功能">
              <Tip>
                我们建议使用 [Qualcomm Launcher](https://dragonwingdocs.qualcomm.com/Tools/Qualcomm-Launcher/flash-os#flashing-steps) 工具进行构建刷写，因为它在内部处理所有必需的配置。如果您不使用 Qualcomm Launcher，请按照以下手动步骤启用摄像头功能。
              </Tip>

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

              ```bash Terminal 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
              ```
            </Step>

            <Step title="清除 GStreamer 注册表（如需要）">
              如果在启用摄像头 overlay 之前执行过 GStreamer 命令，则必须在启用摄像头 overlay 后清除 GStreamer 注册表。运行以下命令清除注册表：

              ```bash Terminal theme={null}
              rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
              ```
            </Step>

            <Step title="日志级别调整（如需要）">
              为获得最佳效果，摄像头用例应在性能 (perf) 构建上运行。在默认构建上，按如下方式降低内核控制台日志级别：

              ```bash Terminal theme={null}
              echo 4 > /proc/sys/kernel/printk
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>

      <Step title="🎥 开拍！开始视频捕获">
        <Accordion title="捕获视频">
          #### 视频编码

          <Steps>
            <Step title="运行管线">
              在设备终端中运行以下命令：

              ```bash GStreamer (MP4 Record) 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**。
            </Step>

            <Step title="拉取录制的内容">
              设备上会生成 `/opt/mux_avc.mp4`。可以通过在主机 PC 上运行以下 scp 命令从设备中拉取录制的内容：

              ```bash SCP (SSH) theme={null}
              $ scp -r root@[ip-addr]:/opt/mux_avc.mp4 .
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>
    </Steps>
  </Tab>

  <Tab title="IQ-8275-EVK">
    ### 📸 通过 3 个简单步骤启动并运行 IQ-8275-EVK 摄像头。

    <Steps>
      <Step title="🔌 即插即用：摄像头硬件设置">
        <Accordion title="摄像头设置">
          将 IMX577 MIPI 摄像头传感器连接到 IQ-8275-EVK 设备的任意 MIPI CSI 插槽。

          <div className="flex flex-col items-center gap-2">
            <img src="https://mintcdn.com/qualcomm-prod/mGpYCfBsZaJSFIEo/Technologies/Camera/images/rb4_core_kit_mipi_connectors.png?fit=max&auto=format&n=mGpYCfBsZaJSFIEo&q=85&s=ac20d4ecda703883b2fce9854222cda4" width="409" height="284" data-path="Technologies/Camera/images/rb4_core_kit_mipi_connectors.png" />
          </div>
        </Accordion>
      </Step>

      <Step title="🧰 就绪检查：前提条件">
        <Accordion title="前提条件">
          <Note>
            使用 SSH 连接到设备控制台。<br />
            有关说明，请参阅[如何使用 SSH？](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#connect-over-ssh)。
          </Note>

          <Steps>
            <Step title="启用摄像头功能">
              <Tip>
                我们建议使用 [Qualcomm Launcher](https://dragonwingdocs.qualcomm.com/Tools/Qualcomm-Launcher/flash-os#flashing-steps) 工具进行构建刷写，因为它在内部处理所有必需的配置。如果您不使用 Qualcomm Launcher，请按照以下手动步骤启用摄像头功能。
              </Tip>

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

              ```bash Terminal 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
              ```
            </Step>

            <Step title="清除 GStreamer 注册表（如需要）">
              如果在启用摄像头 overlay 之前执行过 GStreamer 命令，则必须在启用摄像头 overlay 后清除 GStreamer 注册表。运行以下命令清除注册表：

              ```bash Terminal theme={null}
              rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
              ```
            </Step>

            <Step title="已知问题：IQ8 上的摄像头基本用例">
              <Warning>
                摄像头基本用例在 IQ8 上无法工作。请参阅 IQ8 限制部分中的已知[摄像头问题](https://dragonwingdocs.qualcomm.com/Key-Documents/Software-Release-Notes/limitations#iq8)。
              </Warning>

              **要解决此问题，请应用以下修复：**

              **对于构建用户：** 运行以下命令：

              ```bash Terminal theme={null}
              git clone https://github.com/qualcomm-linux/meta-qcom -b qli-2.0
              cd meta-qcom
              git fetch origin pull/2619/head
              git cherry-pick 1e885404be0191a7b89bd853aba4ef6c28b9295f^..2a1a38963d40b8da079a7b640b363070d9eee18f
              cd ..
              kas build meta-qcom/ci/iq-8275-evk.yml:meta-qcom/ci/qcom-distro.yml
              ```

              **对于预构建用户：** 在运行摄像头用例之前运行以下命令：

              ```bash Terminal 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/.
              ```
            </Step>

            <Step title="日志级别调整（如需要）">
              为获得最佳效果，摄像头用例应在性能 (perf) 构建上运行。在默认构建上，按如下方式降低内核控制台日志级别：

              ```bash Terminal theme={null}
              echo 4 > /proc/sys/kernel/printk
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>

      <Step title="🎥 开拍！开始视频捕获">
        <Accordion title="捕获视频">
          #### 视频编码

          <Steps>
            <Step title="运行管线">
              在设备终端中运行以下命令：

              ```bash GStreamer (MP4 Record) 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**。
            </Step>

            <Step title="拉取录制的内容">
              设备上会生成 `/opt/mux_avc.mp4`。可以通过在主机 PC 上运行以下 scp 命令从设备中拉取录制的内容：

              ```bash SCP (SSH) theme={null}
              $ scp -r root@[ip-addr]:/opt/mux_avc.mp4 .
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>
    </Steps>
  </Tab>

  <Tab title="IQ-9075-EVK">
    ### 📸 通过 3 个简单步骤启动并运行 IQ-9075-EVK 摄像头。

    <Steps>
      <Step title="🔌 即插即用：摄像头硬件设置">
        <Accordion title="摄像头设置">
          将 IMX577 MIPI 摄像头传感器连接到 IQ-9075-EVK 设备的任意 MIPI CSI 插槽。

          <div className="flex flex-col items-center gap-2">
            <img src="https://mintcdn.com/qualcomm-prod/mGpYCfBsZaJSFIEo/Technologies/Camera/images/mipi_hardware_connectivity.png?fit=max&auto=format&n=mGpYCfBsZaJSFIEo&q=85&s=5c2d8b2dc97512cbcd666c7aa93bad52" width="424" height="324" data-path="Technologies/Camera/images/mipi_hardware_connectivity.png" />
          </div>
        </Accordion>
      </Step>

      <Step title="🧰 就绪检查：前提条件">
        <Accordion title="前提条件">
          <Note>
            使用 SSH 连接到设备控制台。<br />
            有关说明，请参阅[如何使用 SSH？](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#connect-over-ssh)。
          </Note>

          <Steps>
            <Step title="启用摄像头功能">
              <Tip>
                我们建议使用 [Qualcomm Launcher](https://dragonwingdocs.qualcomm.com/Tools/Qualcomm-Launcher/flash-os#flashing-steps) 工具进行构建刷写，因为它在内部处理所有必需的配置。如果您不使用 Qualcomm Launcher，请按照以下手动步骤启用摄像头功能。
              </Tip>

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

              ```bash Terminal 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
              ```
            </Step>

            <Step title="清除 GStreamer 注册表（如需要）">
              如果在启用摄像头 overlay 之前执行过 GStreamer 命令，则必须在启用摄像头 overlay 后清除 GStreamer 注册表。运行以下命令清除注册表：

              ```bash Terminal theme={null}
              rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
              ```
            </Step>

            <Step title="日志级别调整（如需要）">
              为获得最佳效果，摄像头用例应在性能 (perf) 构建上运行。在默认构建上，按如下方式降低内核控制台日志级别：

              ```bash Terminal theme={null}
              echo 4 > /proc/sys/kernel/printk
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>

      <Step title="🎥 开拍！开始视频捕获">
        <Accordion title="捕获视频">
          #### 视频编码

          <Steps>
            <Step title="运行管线">
              在设备终端中运行以下命令：

              ```bash GStreamer (MP4 Record) 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**。
            </Step>

            <Step title="拉取录制的内容">
              设备上会生成 `/opt/mux_avc.mp4`。可以通过在主机 PC 上运行以下 scp 命令从设备中拉取录制的内容：

              ```bash SCP (SSH) theme={null}
              $ scp -r root@[ip-addr]:/opt/mux_avc.mp4 .
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>
    </Steps>
  </Tab>

  <Tab title="IQ615">
    ### 📸 通过 3 个简单步骤启动并运行 IQ615 摄像头。

    <Steps>
      <Step title="🔌 即插即用：摄像头硬件设置">
        <Accordion title="摄像头设置">
          将 IMX577 MIPI 摄像头传感器连接到 IQ615 设备的 CAM1 插槽。

          <div className="flex flex-col items-center gap-2">
            <img src="https://mintcdn.com/qualcomm-prod/PyJ823JBh-_RDtS4/Technologies/Camera/images/615-board-connectors.png?fit=max&auto=format&n=PyJ823JBh-_RDtS4&q=85&s=4614ca26870a941b06f7f1ef2a9a150b" width="681" height="358" data-path="Technologies/Camera/images/615-board-connectors.png" />
          </div>
        </Accordion>
      </Step>

      <Step title="🧰 就绪检查：前提条件">
        <Accordion title="前提条件">
          <Note>
            使用 SSH 连接到设备控制台。<br />
            有关说明，请参阅[如何使用 SSH？](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#connect-over-ssh)。
          </Note>

          <Steps>
            <Step title="启用摄像头功能">
              <Tip>
                我们建议使用 [Qualcomm Launcher](https://dragonwingdocs.qualcomm.com/Tools/Qualcomm-Launcher/flash-os#flashing-steps) 工具进行构建刷写，因为它在内部处理所有必需的配置。如果您不使用 Qualcomm Launcher，请按照以下手动步骤启用摄像头功能。
              </Tip>

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

              ```bash Terminal 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
              ```
            </Step>

            <Step title="清除 GStreamer 注册表（如需要）">
              如果在启用摄像头 overlay 之前执行过 GStreamer 命令，则必须在启用摄像头 overlay 后清除 GStreamer 注册表。运行以下命令清除注册表：

              ```bash Terminal theme={null}
              rm ~/.cache/gstreamer-1.0/registry.aarch64.bin
              ```
            </Step>

            <Step title="日志级别调整（如需要）">
              为获得最佳效果，摄像头用例应在性能 (perf) 构建上运行。在默认构建上，按如下方式降低内核控制台日志级别：

              ```bash Terminal theme={null}
              echo 4 > /proc/sys/kernel/printk
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>

      <Step title="🎥 开拍！开始视频捕获">
        <Accordion title="捕获视频">
          #### 视频编码

          <Steps>
            <Step title="运行管线">
              在设备终端中运行以下命令：

              ```bash GStreamer (MP4 Record) 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**。
            </Step>

            <Step title="拉取录制的内容">
              设备上会生成 `/opt/mux_avc.mp4`。可以通过在主机 PC 上运行以下 scp 命令从设备中拉取录制的内容：

              ```bash SCP (SSH) theme={null}
              $ scp -r root@[ip-addr]:/opt/mux_avc.mp4 .
              ```
            </Step>
          </Steps>
        </Accordion>
      </Step>
    </Steps>
  </Tab>
</Tabs>