MIPI摄像头

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

---

本文档详细介绍了 Quectel Pi M2 智能主控板 MIPI CSI 摄像头接口的识别与连接方法，并提供了功能使用指导及常见问题解决方案。

支持配件

原始配件 FPC 排线并未连接相机，需要手动连接，注意连接时排线金手指朝向板内金属接触面（金手指面朝下），请避免接错排线导致相机损坏。连接排线后相机外观如下：

IMX 219：

相机IMX 219外观

IMX 477：

相机IMX 477外观

硬件接口

Quectel Pi M2 智能主控板共支持两路摄像头 MIPI CSI 接口，其接口位置与接口标号如下：

M2 camera 接口如下：

M2 camera0接口位置

M2 camera1接口位置

快速开始

1. 可按照下图连接摄像头，两款支持的相机配件可以根据需求任意连接在camera0/camera1。连接时向上拉开连接器的黑色锁扣部分，将 FPC 排线插入 CSI 卡槽，注意排线金手指朝向板内金属接触面（白色部分那一面），k扣紧锁扣卡住排线，确认 FPC 排线稳定没有松动。相机连接方式如图所示：

IMX 219连接M2 camera1的效果

IMX 477连接M2 camera0的效果

1. 参考 显示配置 连接显示屏

M2 功能使用

前提条件：

摄像头功能运行前需在终端输入以下命令

export GST_V4L2_FORCE_LIBV4L2=0 WAYLAND_DISPLAY=wayland-0 XDG_RUNTIME_DIR=/run/user/1000

预览

1. 在设备终端运行以下命令，这里以imx 219接入camera1为例

gst-launch-1.0 -e v4l2src device=/dev/video33 io-mode=4 ! "video/x-raw,format=NV12,width=1640,height=1232" ! waylandsink

2. 此命令以 1640*1232 30 FPS 配置启动相机，并将图像传到显示屏预览。如果 gst 管道状态更改为 “PLAYING”，则表示摄像头正在运行

3. 两个摄像头使用不同的video节点来区分，video33代表第一个 CSI 卡槽（camera0），video51代表第二个 CSI 卡槽（camera1）

4. 如果要停止摄像头流，请按下CTRL+C

gnome桌面摄像头界面

视频录制

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

gst-launch-1.0 -e v4l2src device=/dev/video51 io-mode=4 ! \
  "video/x-raw,format=NV12,width=1640,height=1232" ! \
  mpph264enc ! h264parse ! mp4mux ! filesink location=/tmp/rec.mp4

2. 此命令以 1640*1232 30 FPS 配置启动相机，并在 h264 视频编码后将其另存为视频文件。如果 gst 管道状态更改为 “PLAYING”，则表示摄像头正在运行

3. MP4文件保存在/tmp/目录下

4. 如果要停止摄像头录制，请按下CTRL+C

5. 可以输入以下命令播放视频文件

gst-launch-1.0 filesrc location=/tmp/rec.mp4 ! qtdemux ! h264parse ! mppvideodec ! waylandsink

拍照

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

gst-launch-1.0 v4l2src device=/dev/video51 io-mode=4 num-buffers=1 ! \
  "video/x-raw,format=NV12,width=1640,height=1232" ! \
  mppjpegenc ! filesink location=/tmp/photo_1640.jpg

2. 此命令以 1640*1232 30 FPS 配置启动相机拍摄，并在 JPEG 图像编码后将其另存为图像文件。如果 gst 管道状态更改为 “PLAYING”，则表示摄像头正在运行

3. 图像文件保存在/tmp/目录下

4. 可以输入以下命令查看图片文件

gst-launch-1.0 filesrc location=/tmp/photo_1640.jpg ! jpegparse ! \
  jpegdec ! imagefreeze ! videoconvert ! waylandsink