Difference between revisions of "Mv series camera appnotes 4 rpi/zh"

Revision as of 11:37, 12 April 2022

本文依然在撰写中，资料随时可能更改和调整。

1 概述

MV系列MIPI相机是为工业领域的AI应用推出的专用相机。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。它具备丰富的数据格式和触发特性，极低的延时，极高的带宽和可靠的稳定性。

1.1 支持的模组

系列	型号	状态
MV系列	MV-MIPI-IMX178M	完成

2 硬件准备及安装

MV系列相机需要ADP-MV1配合即可接入树莓派。下面以MV-MIPI-IMX178M为例，介绍硬件的安装方法。

2.1 MV-MIPI-IMX178M与ADP-MV1的连接

二者使用0.5mm间距*30P的FFC异面线连接，注意接触面向外。

（插入图片，注意FFC排线规格及方向）

2.2 ADP-MV1与树莓派的连接

2.2.1 供电

ADP-MV1需要独立的5V供电，可以使用杜邦线直接从树莓派主板取电。

（插入图片，突出5V供电杜邦线线序）

2.2.2 树莓派Model B和Model B+

二者使用1mm间距*15P的FFC异面线连接，注意接触面安装方向。

（插入图片，注意接触面方向）

2.2.3 树莓派Zero,Zero W和Computer Module

二者使用15P转22P的FFC同面线连接，注意接触面安装方向。

（插入图片，注意接触面方向）

3 piOS的配置

具体安装树莓派系统方法请参考官方文档，详见：Install raspberrypi guide。

接通电源后，树莓派系统启动，初始树莓派系统中Camera 和 I2C都处于未启用状态。开机后我们需要将其手动打开，执行命令

sudo raspi-config

raspi-config bullseye

进入Interface Options，启用I2C，然后重启树莓派。

建议启用树莓派系统的ssh服务及samba服务，这里不再赘述树莓派系统如何开启ssh和samba服务。

4 Legacy模式和V4L2模式介绍

4.1 Legacy模式

传统模式，依赖博通的GPU进行图像处理。传统的raspicam软件集即采用此模式。此模式缺点是封闭，GPU端是闭源的，无法自由接入sensor。树莓派组织已经全面转向libcamera camera stack。

但是此模式依然有存在的价值：

更多的使用GPU资源，降低CPU负载。这点对于性能比较差的早期版本树莓派很有用。
libcamera现在还缺乏一些功能支持。
可以简单直接的获取图像数据到应用层，无需驱动层的支持。这点对于不依赖树莓派做isp的相机尤其有用。

有两种方法可以使用Legacy模式：

使用Legacy版本的piOS。
对于bullseye版本piOS，raspi-config中打开Legacy Camera选项。

4.2 libcamera以及V4L2模式

现在piOS已全面切换为libcamera-stack模式。这个模式有很多的优点，在树莓派网站上有详细的介绍。

libcamera-stack本质上以实现isp功能为核心，这点是MV系列相机不需要的。因此，我们采用了V4L2模式，而不是使用libcamera-stack。

与libcamera-stack相同，我们的V4L2模式，也实现了linux驱动层标准的V4L2驱动。基于此驱动，应用层可以直接开发程序获取图像并进行进一步处理。

5 Legacy模式用法

6 V4L2模式用法

7 参数配置方法

8 参考资料

9 问题反馈

我们致力于为嵌入式平台的图像应用提供更丰富的可能性。因此，我们在嵌入式平台的软件基于开源的原则而进行。

如对我们现有软件有任何的问题、建议，欢迎提交到论坛:,或者给我们的技术人员发邮件xumm#csoneplus.com。

10 本文修改记录

2022-04-12

第一个版本

@@ Line 1: / Line 1: @@
 [[Mv series camera appnotes 4 rpi|English]]
+本文依然在撰写中，资料随时可能更改和调整。
 === 概述 ===
+MV系列MIPI相机是为工业领域的AI应用推出的专用相机。其使用MIPI CSI-2接口，尤其适合嵌入式运算平台使用。它具备丰富的数据格式和触发特性，极低的延时，极高的带宽和可靠的稳定性。
 ==== 支持的模组 ====
-<br />
+{| class="wikitable"
+!系列
+!型号
+!状态
+|-
+|MV系列
+|MV-MIPI-IMX178M
+|完成
+|}
+=== 硬件准备及安装 ===
+MV系列相机需要[[ADP-MV1 Adapter Board Data Sheet/zh|ADP-MV1]]配合即可接入树莓派。下面以MV-MIPI-IMX178M为例，介绍硬件的安装方法。
+==== MV-MIPI-IMX178M与ADP-MV1的连接 ====
+二者使用0.5mm间距*30P的FFC异面线连接，注意接触面向外。
+（插入图片，注意FFC排线规格及方向）
+==== ADP-MV1与树莓派的连接 ====
+===== 供电 =====
+ADP-MV1需要独立的5V供电，可以使用杜邦线直接从树莓派主板取电。
+（插入图片，突出5V供电杜邦线线序）
+===== 树莓派Model B和Model B+ =====
+二者使用1mm间距*15P的FFC异面线连接，注意接触面安装方向。
+（插入图片，注意接触面方向）
+===== 树莓派Zero,Zero W和Computer Module =====
+二者使用15P转22P的FFC同面线连接，注意接触面安装方向。
-=== 硬件准备及安装 ===
+（插入图片，注意接触面方向）
-<br />
 === piOS的配置 ===
-<br />
+具体安装树莓派系统方法请参考官方文档，详见：[https://www.raspberrypi.org/documentation/installation/ Install raspberrypi guide]。
+接通电源后，树莓派系统启动，初始树莓派系统中Camera 和 I2C都处于未启用状态。开机后我们需要将其手动打开，执行命令
+<code>sudo raspi-config</code>
+[[File:Raspi-config bullseye.png|alt=|center|thumb|608x608px|raspi-config bullseye]]
+进入Interface Options，启用I2C，然后重启树莓派。
+建议启用树莓派系统的ssh服务及samba服务，这里不再赘述树莓派系统如何开启ssh和samba服务。
+=== Legacy模式和V4L2模式介绍 ===
+==== Legacy模式 ====
+传统模式，依赖博通的GPU进行图像处理。传统的raspicam软件集即采用此模式。此模式缺点是封闭，GPU端是闭源的，无法自由接入sensor。树莓派组织已经全面转向libcamera camera stack。
+但是此模式依然有存在的价值：
+# 更多的使用GPU资源，降低CPU负载。这点对于性能比较差的早期版本树莓派很有用。
+# libcamera现在还缺乏一些功能支持。
+# 可以简单直接的获取图像数据到应用层，无需驱动层的支持。这点对于不依赖树莓派做isp的相机尤其有用。
+有两种方法可以使用Legacy模式：
+# 使用Legacy版本的piOS。
+# 对于bullseye版本piOS，<code>raspi-config</code>中打开Legacy Camera选项。
+==== libcamera以及V4L2模式 ====
+现在piOS已全面切换为libcamera-stack模式。这个模式有很多的优点，在树莓派网站上有详细的[https://www.raspberrypi.com/documentation/accessories/camera.html#libcamera-and-the-legacy-raspicam-camera-stack 介绍]。
+libcamera-stack本质上以实现isp功能为核心，这点是MV系列相机不需要的。因此，我们采用了'''V4L2模式'''，而不是使用libcamera-stack。
+与libcamera-stack相同，我们的'''V4L2模式'''，也实现了linux驱动层标准的V4L2驱动。基于此驱动，应用层可以直接开发程序获取图像并进行进一步处理。
-=== Lagcy模式和V4L2模式介绍 ===
+=== Legacy模式用法 ===
 <br />
-=== Lagcy模式 ===
+=== V4L2模式用法 ===
 <br />
-=== V4L2模式 ===
 === 参数配置方法 ===
 <br />
 === 参考资料 ===
-<br />
+* [https://www.raspberrypi.com/documentation/computers/getting-started.html 树莓派系统的安装]
+* [https://www.raspberrypi.com/documentation/accessories/camera.html#libcamera-and-the-legacy-raspicam-camera-stack 树莓派legacy camera stack和libcamera模式的区别]
+=== 问题反馈 ===
+我们致力于为嵌入式平台的图像应用提供更丰富的可能性。因此，我们在嵌入式平台的软件基于开源的原则而进行。
+如对我们现有软件有任何的问题、建议，欢迎提交到[http://forum.veye.cc 论坛:],或者给我们的技术人员发邮件xumm#csoneplus.com。
 === 本文修改记录 ===