View source for VEYE MIPI 290/327 for Raspberry Pi/zh

'''<big>VEYE-MIPI-290/327 摄像头模组接入树莓派使用说明</big>'''

===概述===
VEYE-MIPI-290/327 摄像头模组理论上支持树莓派的所有型号，出于性能最优考虑，建议使用树莓派3以后的版本。本篇文章以树莓派3B为例讲解VEYE-MIPI-290/327 摄像头模组接入树莓派经典版型以及树莓派Computer Module与树莓派Zero的步骤及使用说明。

===硬件准备及安装===
原材料：树莓派3B，网线，Micro SD卡，树莓派电源线，HDMI显示器，FFC线，杜邦线，镜头，摄像头主板，转接板。（转接板包括mini转接板与增强版转接板，其中mini转接板用来对接树莓派标准版型，增强版转接板可以额外用来对接Computer Module系列和Zero系列版型，两种版本详情请见[[链接]]）

*如图所示，摄像头主板连接mini转接板，mini转接板通过FFC及图中的杜邦黑红线连接到树莓派上，黑线连接GND接口，红线连接5V接口（因为摄像头板功耗较大，需要额外的5V供电）。

*树莓派接好摄像头模组后，将烧录好树莓派系统的Micro SD卡插入卡槽，网线插入网线接口，HDMI显示器接入树莓派，电源线插入power接口，为树莓派接通电源。

[[File:Veye-raspberry 3m.jpg|center|thumb|602x602px|树莓派与摄像头模组连接示意图]]
[[File:Veye-Wiring scheme01.jpg|center|thumb|602x602px|树莓派插接示意图]]
[[File:Veye 290-327Wiring scheme00.jpg|center|thumb|603x603px|摄像头模组插接示意图]]

===树莓派系统安装及配置===
具体安装树莓派系统方法请参考官方文档，详见：[https://www.raspberrypi.org/documentation/installation/ Install raspberrypi guide]

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

<code>sudo raspi-config</code>  
[[File:Veye-Raspi-config.png|thumb|如图所示|alt=|center|608x608px]]

进入选项5，启用Camera 和 I2C，然后重启。

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

===软件包下载与介绍===

====下载及传输软件包====

*执行命令行

<code>git clone <nowiki>https://github.com/veyeimaging/raspberrypi</nowiki></code>

直接将文件复制到树莓派系统中。

*点击[https://github.com/veyeimaging/raspberrypi 链接]下载软件包

[[File:Veye 123.png|center|thumb|626x626px|i2c_cmd为视频控制接口软件包，veye_raspcam为视频流接口软件包]]


利用samba将软件包文件传输至树莓派系统中，也可用U盘将软件包文件拷贝至树莓派系统中。

====软件包介绍====

*软件包包括视频流接口软件包和视频控制接口软件包。其中i2c_cmd为视频控制接口软件包，veye_raspcam为视频流接口软件包。

*视频流接口软件包提供实时显示、抓拍、录像等功能，视频控制接口软件包通过I2C协议控制摄像机模组，提供主要的ISP参数配置等功能。

这两部分都是开源的。

===视频流接口软件包使用===
视频流接口软件包各种指示命令使用方法及示例：

*veye_raspipreview

<code>./veye_raspipreview -t 20000</code>

实现20s（即20000毫秒）的视频实时显示到HDMI输出，可以自行调节t的大小。

<code>./veye_raspipreview -t -1</code>

将t调节成 -1   ，可以实现视频持续输出显示到HDMI输出。

*veye_raspivid

<code>./veye_raspivid -t 5000 -o ~/test.h264</code> 

实现录像5s，录像文件保存到~/test.h264。可以自行调节t的大小来选择录制时间的长短。

*veye_raspividyuv

<code>./veye_raspividyuv -t 200 -o /dev/shm/test.yuv</code> 

实现录像yuv格式数据200ms，录像文件保存到/dev/shm/test.yuv，存储格式为yuv420 I420 格式。可以自行调节t的大小来选择录制时间的长短。

*veye_raspiraw

<code>./veye_raspiraw -md 2 -t 200 -o /dev/shm/out.%04d.yuv</code> 

实现抓拍200ms的图片存储到/dev/shm目录（内存文件系统），然后客户可以导出并查看。文件格式为1920*1080大小的yuv数据。UYVY格式。

*veye_raspistill

抓拍一张并压缩为jpeg，开发中。

===视频控制接口软件包使用===
由于树莓派的I2C-0作为GPU所用，为了避免冲突，我们使用I2C-1作为控制总线。我们提供了一个脚本camera_i2c_config进行总线的管脚复用配置。在树莓派3b/3b+，树莓派CM3b/3b+等设备上，使用I2C总线1控制VEYE模组的参数。

具体使用说明请见：[http://wiki.veye.cc/index.php/VEYE-MIPI-290/327/zh/i2c I2C脚本使用说明]
===关于树莓派Computer Module 和树莓派Zero使用说明===

====概述====
树莓派Computer Module 和树莓派Zero与树莓派经典版型有所不同，故需要使用增强版转接板来连接摄像头主板。下面以树莓派Computer Module与VEYE-MIPI-290/327 摄像头模组的连接使用来进行说明。

注：我们使用的是深圳市微雪电子有限公司生产的Computer Module IO Board Plus for raspberry pi 底板。
====硬件连接====

===== 主要连接 =====
摄像头主板加增强版转接板构成摄像头模组，摄像头模组通过FFC线及杜邦黑红线连接到Computer Module（黑线连接GND接口，红线连接5V接口），Computer Module可同时连接两个摄像头模组，CAM1和CAM0分别连接一个摄像头模组。

=====连接camera模组到CMIO底板。=====

*当使用CAM1时：

连接 CD1_SDA (J6 pin 37)到 GPIO2 (J5 pin 5).  

连接 CD1_SCL (J6 pin 39) 到 GPIO3 (J5 pin 7).  

*当使用CAM0时：

连接 CD0_SDA (J6 pin 45)到 GPIO44 .

连接 CD0_SCL (J6 pin 47) 到 GPIO45 .如图所示。
[[File:Veye-computer module.jpg|center|thumb|603x603px|树莓派Computer Module与摄像头模组连接示意图]]
[[File:Veye computermodule Wiring scheme00.jpg|center|thumb|603x603px|摄像头模组插接示意图]]
<br />
[[File:Veye computer moduleWiring scheme01.jpg|center|thumb|603x603px|树莓派Computer Module 主板插接示意图]]
利用USB网线转换器帮助Computer Module 连接网络，HDMI接口接入显示器，电源线连接power接口提供电源。

====树莓派Computer Module系统安装====
具体方法请参见官方说明[http://www.waveshare.net/w/upload/4/46/Compute_Module_IO_Board_PLUS_User_Manual.pdf 用户手册]第七页。

====视频流接口软件包使用说明====
选项 -cs 0/1 可以支持同时连接两路camera到CM3，0 表示接到CAM0,1表示接到CAM1，其余选项见[http://wiki.veye.cc/index.php/Veye_290_rapberry#.E8.A7.86.E9.A2.91.E6.B5.81.E6.8E.A5.E5.8F.A3.E8.BD.AF.E4.BB.B6.E5.8C.85.E5.90.84.E7.A7.8D.E6.8C.87.E7.A4.BA.E5.91.BD.E4.BB.A4.E4.BD.BF.E7.94.A8.E6.96.B9.E6.B3.95.E5.8F.8A.E7.A4.BA.E4.BE.8B.EF.BC.9A 4.2]。示例如下：

*veye_raspipreview

<code>./veye_raspipreview -cs 0 -t 20000</code>

利用CAM0所连接的摄像头实现20s（即20000毫秒）的视频实时显示到HDMI输出，可以自行调节t的大小。

*veye_raspivid

<code>./veye_raspivid -cs 1 -t 5000 -o ~/test.h264</code> 

利用CAM1所连接的摄像头实现录像5s，录像文件保存到~/test.h264。可以自行调节t的大小来选择录制时间的长短。

====视频控制接口软件包使用====
点击[https://www.raspberrypi.org/documentation/hardware/computemodule/dt-blob-dualcam.bin 链接]下载dt-blob.bin文件，将文件放在/Root下，然后执行命令

<code>./camera_i2c_config [cameranum]</code>
{| class="wikitable"
!cameranum
!description
|-
|0
|CAM0
|-
|1
|CAM1
|}
<code>./veye_mipi_i2c.sh</code>

其余选项具体使用说明详见：[http://wiki.veye.cc/index.php/VEYE-MIPI-290/327/zh/i2c I2C脚本使用说明]<br />