# MIPI摄像头

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

---

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

## 支持配件

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

**IMX 219：**

```{image} images/image_HbEobxOmLoTev9xXScecPhWTnQ8.webp
:width: 1053px
:height: 549px
:align: center
```

<div style="text-align: center">
相机IMX 219外观
</div>

**IMX 477：**

```{image} images/image_A9H4blMyqo7gZnx0MdQcPSvFnch.webp
:width: 1269px
:height: 648px
:align: center
```

<div style="text-align: center">
相机IMX 477外观
</div>

## 硬件接口

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

**M2 camera** 接口如下：

```{image} images/image_YxdTbcGmlo5bkqxsqIjcpnIznAs.webp
:width: 853px
:height: 570px
:align: center
```

<div style="text-align: center">
M2 camera0接口位置
</div>

```{image} images/image_RiUXbPXopoAlZ7xRZ6acYZugnsg.webp
:width: 872px
:height: 587px
:align: center
```

<div style="text-align: center">
M2 camera1接口位置
</div>

## 快速开始

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

```{image} images/image_AloYbLgiSol73VxnYF2cqirQnuh.webp
:width: 676px
:height: 317px
:align: center
```

<div style="text-align: center">
IMX 219连接M2 camera1的效果
</div>

```{image} images/image_LtDqb9kpZon7BRx8PR7cFv1znkf.webp
:width: 748px
:height: 402px
:align: center
```

<div style="text-align: center">
IMX 477连接M2 camera0的效果
</div>

1. 参考 [显示配置](<../../../操作系统/Debian(Gnome)/显示配置/显示配置.md>) 连接显示屏

## M2 功能使用

前提条件：

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

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

### 预览

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

```bash
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

```{image} images/image_OBDrbkaYEog6YNxxev8cNgk3nYe.webp
:width: 1280px
:height: 800px
:align: center
```

<div style="text-align: center">
gnome桌面摄像头界面
</div>

### 视频录制

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

```bash
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. 可以输入以下命令播放视频文件

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

### 拍照

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

```bash
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. 可以输入以下命令查看图片文件

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