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

# 摄像头概述

<iframe src="https://players.brightcove.net/1414329538001/4JiZQnWhg_default/index.html?videoId=6362726364112" width="640" height="360" allow="encrypted-media" allowFullScreen title="摄像头概述视频" />

本文档介绍通过 MIPI CSI 接口接收数据的摄像头子系统。

USB 摄像头数据通过 USB 接口传输，摄像头子系统不参与 USB 摄像头数据事务。有关 USB 摄像头的使用，请参阅 [USB 摄像头配置](https://dragonwingdocs.qualcomm.com/System/Interfaces/usb)。

网络摄像头数据通过网络接口传输，摄像头子系统不参与网络摄像头数据事务。设备可以通过 GStreamer 的 [rtspsrc](https://gstreamer.freedesktop.org/documentation/rtsp/rtspsrc.html?gi-language=c) 插件接收网络摄像头数据。

## **摄像头组件**

下图展示了 Qualcomm Camera 的组件。

<div className="flex flex-col items-center gap-2">
  <img src="https://mintcdn.com/qualcomm-prod/PyJ823JBh-_RDtS4/Technologies/Camera/images/camera_overview.png?fit=max&auto=format&n=PyJ823JBh-_RDtS4&q=85&s=39b7f1684de0236d362499c7bc350793" width="637" height="601" data-path="Technologies/Camera/images/camera_overview.png" />
</div>

以下组件由 Qualcomm 提供：

|         **组件**         |                        **说明**                       |
| :--------------------: | :-------------------------------------------------: |
| Gst 摄像头插件 (qtiqmmfsrc) |          适用于 Qualcomm 摄像头子系统的 GStreamer 插件          |
|  Camera Core Software  | Qualcomm 专有的摄像头软件，提供用于开发摄像头传感器驱动程序、摄像头调优和自定义软件节点的接口 |
|   Camera Core Driver   |          下游 Linux 内核中的 Qualcomm 摄像头子系统驱动程序          |
|     CamSS V4L2 驱动程序    |          上游 Linux 内核中的 Qualcomm 摄像头子系统驱动程序          |

Qualcomm 提供了一个 GStreamer 插件，使应用程序开发者能够与 Qualcomm 摄像头子系统进行交互。有关应用程序开发，请参阅 [GStreamer API](./stream-cameras#03-·-stream-camera-with-the-gstreamer-api)。

Qualcomm 为摄像头传感器驱动程序开发者和 IQ 调优工程师提供了接口，用于开发自己的传感器驱动程序并执行自定义 IQ 调优。请参阅摄像头补充文档中的摄像头传感器驱动程序开发与调优部分。

摄像头传感器驱动程序开发和自定义 IQ 调优需要访问 meta-qcom-extras 层。有关访问级别，请参阅[访问级别映射](https://dragonwingdocs.qualcomm.com/Key-Documents/Firmware-Guide/build-firmware)。

## **前提条件**

* 按照 [Qualcomm Linux 构建指南](https://dragonwingdocs.qualcomm.com/Key-Documents/Yocto-Guide/qualcomm-linux-yocto-overview)中所述设置您的基础设施

* 将最新的软件版本刷写到开发板

* 设置 SSH 连接：
  > 1. 按照[使用 SSH](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device#connect-over-ssh) 中提到的步骤在 Permissive 模式下启用 SSH。
  > 2. 运行以下命令连接到设备：
  >    ```text theme={null}
  >    ssh root@<device_IP_address>
  >    ```
  >    例如，如果设备的 IP 地址是 10.92.160.222，运行以下命令：
  >    ```text theme={null}
  >    ssh root@10.92.160.222
  >    ```

* 我们建议使用 Qualcomm Launcher 工具进行构建刷写，因为它在内部处理所有必需的配置。请参阅 [Qualcomm Launcher - 刷写步骤](https://dragonwingdocs.qualcomm.com/Tools/Qualcomm-Launcher/flash-os#flashing-steps)。

  如果使用其他刷写方法，请注意以下事项：

  * 下游摄像头驱动程序默认未启用。
  * 您必须按照 [Qualcomm Linux 迁移指南](https://dragonwingdocs.qualcomm.com/Key-Documents/Migration-Guide/migrate-features-to-qualcomm-linux-2-0#enable-camera-functionality)中的摄像头 overlay 配置步骤显式启用它。

  <Note>
    **警告：**<br />
    上游和下游 Qualcomm 摄像头子系统驱动程序互斥。
    每个系统配置只能启用其中一种实现。
    同时启用两者不受支持，并可能导致驱动程序冲突或未定义行为。
  </Note>