相机快速入门指南 - Qualcomm Dragonwing Documentation

QCS6490IQ-9075-EVKIQ-8275-EVKIQ615稳定版

MIPI CSI

多平台支持

GStreamer

主要 API

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

QCS6490
IQ-8275-EVK
IQ-9075-EVK
IQ615
IQx7181

📸 通过 3 个简单步骤让 QCS6490 相机运行起来

🔌 即插即用：相机硬件设置

相机设置

QCS6490 出厂时已预先连接 IMX577 和 OV9282，如下所示。

🧰 准备检查：前提条件

前提条件

使用 SSH 连接到设备控制台。
有关说明，请参见如何使用 SSH？。

启用相机功能

我们建议使用 Qualcomm Launcher 工具进行构建刷写，因为它会在内部处理所有必需的配置。如果您不使用 Qualcomm Launcher，请按照下面的手动步骤启用相机功能。

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

Terminal

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

要从 Config2 镜像切换回 Config1 镜像，请向 efivar overlay 传入 null 字符串（而不是 camx），然后重启设备：

Terminal

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

清除 GStreamer 注册表（如需要）

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

Terminal

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

日志级别调整（如需要）

相机用例应在性能（perf）构建上运行以获得最佳效果。在默认构建上，请按如下方式降低内核控制台日志级别：

Terminal

echo 4 > /proc/sys/kernel/printk

🎥 开拍！开始视频捕获

捕获视频

视频编码

运行管线

在设备终端中运行以下命令：

GStreamer (MP4 Record)

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 (SSH)

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

📸 通过 3 个简单步骤让 IQ-8275-EVK 相机运行起来。

🔌 即插即用：相机硬件设置

相机设置

将 IMX577 MIPI 相机传感器连接到 IQ-8275-EVK 设备的任意 MIPI CSI 插槽。

🧰 准备检查：前提条件

前提条件

使用 SSH 连接到设备控制台。
有关说明，请参见如何使用 SSH？。

启用相机功能

Terminal

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

要从 Config2 镜像切换回 Config1 镜像，请向 efivar overlay 传入 null 字符串（而不是 camx），然后重启设备：

Terminal

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

清除 GStreamer 注册表（如需要）

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

Terminal

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

日志级别调整（如需要）

相机用例应在性能（perf）构建上运行以获得最佳效果。在默认构建上，请按如下方式降低内核控制台日志级别：

Terminal

echo 4 > /proc/sys/kernel/printk

🎥 开拍！开始视频捕获

捕获视频

视频编码

运行管线

在设备终端中运行以下命令：

GStreamer (MP4 Record)

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

拉取录制内容

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

SCP (SSH)

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

📸 通过 3 个简单步骤让 IQ-9075-EVK 相机运行起来。

🔌 即插即用：相机硬件设置

相机设置

将 IMX577 MIPI 相机传感器连接到 IQ-9075-EVK 设备的任意 MIPI CSI 插槽。

🧰 准备检查：前提条件

前提条件

使用 SSH 连接到设备控制台。
有关说明，请参见如何使用 SSH？。

启用相机功能

Terminal

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

要从 Config2 镜像切换回 Config1 镜像，请向 efivar overlay 传入 null 字符串（而不是 camx），然后重启设备：

Terminal

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

清除 GStreamer 注册表（如需要）

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

Terminal

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

日志级别调整（如需要）

相机用例应在性能（perf）构建上运行以获得最佳效果。在默认构建上，请按如下方式降低内核控制台日志级别：

Terminal

echo 4 > /proc/sys/kernel/printk

🎥 开拍！开始视频捕获

捕获视频

视频编码

运行管线

在设备终端中运行以下命令：

GStreamer (MP4 Record)

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

拉取录制内容

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

SCP (SSH)

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

📸 通过 3 个简单步骤让 IQ615 相机运行起来。

🔌 即插即用：相机硬件设置

相机设置

将 IMX577 MIPI 相机传感器连接到 IQ615 设备的 CAM1 插槽。

🧰 准备检查：前提条件

前提条件

使用 SSH 连接到设备控制台。
有关说明，请参见如何使用 SSH？。

启用相机功能

Terminal

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

要从 Config2 镜像切换回 Config1 镜像，请向 efivar overlay 传入 null 字符串（而不是 camx），然后重启设备：

Terminal

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

清除 GStreamer 注册表（如需要）

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

Terminal

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

日志级别调整（如需要）

相机用例应在性能（perf）构建上运行以获得最佳效果。在默认构建上，请按如下方式降低内核控制台日志级别：

Terminal

echo 4 > /proc/sys/kernel/printk

🎥 开拍！开始视频捕获

捕获视频

视频编码

运行管线

在设备终端中运行以下命令：

GStreamer (MP4 Record)

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

拉取录制内容

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

SCP (SSH)

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

📸 通过 3 个简单步骤让 IQx7181 相机运行起来。

🔌 即插即用：相机硬件设置

相机设置

将 IMX577 MIPI 相机传感器连接到 IQx7181 设备的 CAM1（CSI1 22 针）插槽。

🧰 准备检查：前提条件

前提条件

使用 SSH 连接到设备控制台。
有关说明，请参见如何使用 SSH？。

启用相机功能

Terminal

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

要从 Config2 镜像切换回 Config1 镜像，请向 efivar overlay 传入 null 字符串（而不是 camx），然后重启设备：

Terminal

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

清除 GStreamer 注册表（如需要）

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

Terminal

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

日志级别调整（如需要）

相机用例应在性能（perf）构建上运行以获得最佳效果。在默认构建上，请按如下方式降低内核控制台日志级别：

Terminal

echo 4 > /proc/sys/kernel/printk

🎥 开拍！开始视频捕获

捕获视频

视频编码

运行管线

在设备终端中运行以下命令：

GStreamer (MP4 Record)

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

拉取录制内容

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

SCP (SSH)

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

MIPI CSI

GStreamer

​📸 通过 3 个简单步骤让 QCS6490 相机运行起来

​视频编码

​📸 通过 3 个简单步骤让 IQ-8275-EVK 相机运行起来。

​视频编码

​📸 通过 3 个简单步骤让 IQ-9075-EVK 相机运行起来。

​视频编码

​📸 通过 3 个简单步骤让 IQ615 相机运行起来。

​视频编码

​📸 通过 3 个简单步骤让 IQx7181 相机运行起来。

​视频编码

📸 通过 3 个简单步骤让 QCS6490 相机运行起来

视频编码

📸 通过 3 个简单步骤让 IQ-8275-EVK 相机运行起来。

视频编码

📸 通过 3 个简单步骤让 IQ-9075-EVK 相机运行起来。

视频编码

📸 通过 3 个简单步骤让 IQ615 相机运行起来。

视频编码

📸 通过 3 个简单步骤让 IQx7181 相机运行起来。

视频编码