VEYE-MIPI-290/327 i2c/

查看中文

VEYE-MIPI-X I2C.sh user guide

1 Overview

There are 4 files: camera_i2c_config、i2c_read、i2c_write、veye_mipi_i2c.sh

2 RaspberryPi Only, Set IO config

Running

./enable_i2c_vc.sh

./camera_i2c_config

first，it will config IO pin.

Then you can run veye_mipi_i2c.sh.

2.1 camera_i2c_config USAGE

• for standard RPI, just run

./camera_i2c_config

• for RPI Computer Module

./camera_i2c_config [cameranum]

cameranum	description
0	CAM0
1	CAM1

3 veye_mipi_i2c.sh USAGE

./veye_mipi_i2c.sh

Usage: ./veye_mipi_i2c.sh [-r/w] [-f] function name -p1 param1 -p2 param2 -b bus

options:

-r read

-w write

-f [function name] function name

-p1 [param1] param1 of each function

-p2 [param1] param2 of each function

-b [i2c bus num] i2c bus number

support functions: devid,hdver,sensorid,wdrmode,videoformat,mirrormode,denoise,agc,lowlight,daynightmode,ircutdir,irtriggerhutter

cameramode, nodf, capture, csienable,saturation,wdrbtargetbr,wdrtargetbr, brightness ,contrast , sharppen, aespeed,lsc,boardmodel,yuvseq,i2cauxenable,i2cwen

Pi3B / Pi3B+ / 3A / 4B(1G/2G/4G)，we use i2c0

Compute Module/ CM3，we use i2c1,please add -b 1 option.

3.1 devid

./veye_mipi_i2c.sh -r -f devid

value	description
0x06	VEYE-MIPI-X series，IMX327 IMX462 IMX385

3.2 hdver

./veye_mipi_i2c.sh -r -f hdver

value	description
0xXX	Version

3.3 sensorid

./veye_mipi_i2c.sh -r -f sensorid

Print sensor type and board information.

3.4 wdrmode

./veye_mipi_i2c.sh -r -f wdrmode
./veye_mipi_i2c.sh -w -f wdrmode -p1 [value]

value	description
0x00	Back Light Mode OFF
0x01	Back Light Mode ON, LOW
0x02	Back Light Mode ON, HIGH
0x03	DOL WDR Enable

3.5 videoformat

./veye_mipi_i2c.sh -r -f videoformat
./veye_mipi_i2c.sh -w -f videoformat -p1 [value]

WARNING:THIS FUNCTION MUST BE CALLED BEFORE ANY video applications

value	description	frame rate
PAL	PAL(50Hz)	25fps
NTSC	NTSC(60Hz)	30fps

3.6 mirrormode

./veye_mipi_i2c.sh -r -f mirrormode
./veye_mipi_i2c.sh -w -f mirrormode -p1 [value]

value	description
0x00	Normal
0x01	Mirror
0x02	V-Flip
0x03	Mirror And V-Flip(180 Degree Rotate)

3.7 denoise

./veye_mipi_i2c.sh -r -f denoise
./veye_mipi_i2c.sh -w -f denoise -p1 [value]

value	description
0x00	NR 2D Mode = OFF; NR 3D Mode = OFF
0x01	NR 2D Mode = OFF; NR 3D Mode = LOW
0x02	NR 2D Mode = OFF; NR 3D Mode = MIDDLE
0x03	NR 2D Mode = OFF; NR 3D Mode = HIGH
0x04	NR 2D Mode = LOW; NR 3D Mode = OFF
0x05	NR 2D Mode = LOW; NR 3D Mode = LOW
0x06	NR 2D Mode = LOW; NR 3D Mode = MIDDLE
0x07	NR 2D Mode = LOW; NR 3D Mode = HIGH
0x08	NR 2D Mode =MIDDLE; NR 3D Mode = OFF
0x09	NR 2D Mode =MIDDLE; NR 3D Mode = LOW
0x0A	NR 2D Mode = MIDDLE; NR 3D Mode = MIDDLE
0x0B	NR 2D Mode = MIDDLE; NR 3D Mode = HIGH
0x0C	NR 2D Mode =HIGH; NR 3D Mode = OFF
0x0D	NR 2D Mode =HIGH; NR 3D Mode = LOW
0x0E	NR 2D Mode = HIGH; NR 3D Mode = MIDDLE
0x0F	NR 2D Mode = HIGH; NR 3D Mode = HIGH

3.8 agc

./veye_mipi_i2c.sh -r -f agc
./veye_mipi_i2c.sh -w -f agc -p1 [value]

agc indicated max gain of AE mode.

Agc stands for auto gain control. It is a part of auto exposure, in different light intensity, will try to adjust the gain of sensor to achieve the same image brightness.

value	description
0x00~0x0F	AGC intensity

3.9 lowlight

./veye_mipi_i2c.sh -r -f lowlight
./veye_mipi_i2c.sh -w -f lowlight -p1 [value]

In the case of low illuminance, the camera module can prolong the exposure time and reduce the frame rate by configuring this parameter to achieve a better effect of low illuminance.

Note that it is not suitable for use in a sports scene.

value	description
0x01	1/2*(FRAME RATE)
0x03	1/4*(FRAME RATE)
0x05	1/6*(FRAME RATE)
0x07	1/8*(FRAME RATE)
0x09	1/10*(FRAME RATE)
0x0B	1/15*(FRAME RATE)
0x0D	1/20*(FRAME RATE)
0x0F	1/25*(FRAME RATE)
0x11	1/30*(FRAME RATE)
0x00	Fixed frame rate (25/30)

3.10 daynightmode

./veye_mipi_i2c.sh -r -f daynightmode
./veye_mipi_i2c.sh -w -f daynightmode -p1 [value]

value	description
0xFF	Color Mode
0xFE	Black&White Mode
0xFC	Trigger Mode

IR-CUT (Infrared cut-off filter) is a mechanical shutter design. It is placed between the lens and the image sensor, and is controlled by a motor or an electromagnet.

IR-CUT has two status: Block or Deliver the infrared.

• Color Mode

Image is Color Mode and IR_CUT status Block infrared.

• Black&White Mode

Image is Black&White Mode and IR_CUT status Deliver infrared.

• Trigger Mode

Trigger pin : J3 pin1 of VEYE-MIPI-327 or J2 pin1 of VEYE-MIPI-IMX327S.

Trigger pin High(3.3~12V),Image is Black&White Mode and IR-CUT status Deliver infrared.

Trigger pin Low(GND),Image is Color Mode and IR-CUT status Bolck infrared.

3.11 ircutdir

./veye_mipi_i2c.sh -r -f ircutdir

./veye_mipi_i2c.sh -w -f ircutdir -p1 [value]

IR_CUT pins control direction. value could be 0 or 1.

3.12 irtrigger

./veye_mipi_i2c.sh -r -f irtrigger

./veye_mipi_i2c.sh -w -f irtrigger -p1 [value]

Polarity setting of the day/night switching external trigger mode pin.

value	description
0x0	default value，refer to datasheet of different boards.
0x1	Reversed.

3.13 mshutter

close AE, use manual shutter

./veye_mipi_i2c.sh -r -f mshutter

./veye_mipi_i2c.sh -w -f mshutter -p1 [value]

value is exposure time（seconds）

If value is greater than or equal to 0x4B, it will reduce framerate.

value	description
	NTSC(PAL)
0x40	auto mode
0x41	1/30 (25)
0x42	1/60(50)
0x43	1/120(100)
0x44	1/240(200)
0x45	1/480(400)
0x46	1/1000
0x47	1/2000
0x48	1/5000
0x49	1/10000
0x4A	1/50000
0x4B	1/30 (25) *2
0x4C	1/30 (25) *4
0x4D	1/30 (25) *6
0x4E	1/30 (25) *8
0x4F	1/30 (25) *10
0x50	1/30 (25) *15
0x51	1/30 (25) *20
0x52	1/30 (25) *25
0x53	1/30 (25) *30

3.14 cameramode

Requirements：hdver >= 0x3

./veye_mipi_i2c.sh -r -f cameramode

./veye_mipi_i2c.sh -w -f cameramode -p1 [value]

value	description
0x0	Stream mode
0x1	Capture mode

Stream mode: stream output

Caputre mode: output the next frame each capture cmd.

3.15 nodf

Requirements：hdver >= 0x3, effective in Stream mode

Number of dropped frames

It is a method of framerate control, output one frame,discard nodf frames,output next frame, and so on.

actual framerate = original framerate /（1+nodf）

For example，if the original framerate is 30fps, set nodf to 2, then actual framerate is 10fps.

./veye_mipi_i2c.sh -r -f nodf

./veye_mipi_i2c.sh -w -f nodf -p1 [value]

ntof range is [0-0xFF]， default 0.

3.16 capture

Requirements：hdver >= 0x3, effective in Capture mode

./veye_mipi_i2c.sh -w -f capture

Output the next frame. This cmd does not interfere the sensor, it just output the next frame (the newest frame).

So it is not trigger mode, there will be a delay[0,1/framerate] between the cmd and the frame exposure.

It is applicable to those that do not require a high level of real-time performance.

3.17 csienable

Requirements：hdver >= 0x3

./veye_mipi_i2c.sh -r -f csienable

./veye_mipi_i2c.sh -w -f csienable -p1 [value]

value	description
0x0	suspend csi output
0x1	enable csi output

default: 0x1

Note: This is not low power mode, the camera is still working.

3.18 brightness

./veye_mipi_i2c.sh -r -f brightness

./veye_mipi_i2c.sh -w -f brightness -p1 0x32

AE Target Brightness，rang: [0,0x64]

3.19 aespeed

./veye_mipi_i2c.sh -r -f aespeed

./veye_mipi_i2c.sh -w -f aespeed -p1 0x32 -p2 0x32

AE adjust speed,p1 is agc speed, p2 is shutter speed，Slow to Fast: [0,0x64]

3.20 contrast

./veye_mipi_i2c.sh -r -f contrast

./veye_mipi_i2c.sh -w -f contrast -p1 0x32

Contrast，range: [0,0xFF],default: 0x80.

3.21 saturation

./veye_mipi_i2c.sh -r -f saturation

./veye_mipi_i2c.sh -w -f saturation -p1 0x32

Saturation, range: [0,0x64].

3.22 sharppen

./veye_mipi_i2c.sh -r -f sharppen

./veye_mipi_i2c.sh -w -f sharppen -p1 [val1] -p2 [value]

param1 value	description
0x0	sharppen disable
0x1	sharppen enable

default: 0x1

param2: sharppen strength, range [0x0-0xA]

3.23 wdrtargetbr

./veye_mipi_i2c.sh -r -f wdrtargetbr

./veye_mipi_i2c.sh -w -f wdrtargetbr -p1 0x80

The overall AE target value in WDR mode.

Takes effect in WDR mode. range: [0-0xFF], default : 0x80.

3.24 wdrbtargetbr

./veye_mipi_i2c.sh -r -f wdrbtargetbr

./veye_mipi_i2c.sh -w -f wdrbtargetbr -p1 0x80

The AE target value of the bright area in WDR mode.

Takes effect in WDR mode. range: [0-0xFF], default : 0x80.

3.25 boardmodel

./veye_mipi_i2c.sh -r -f boardmodel

Requirment: hdver >=4.

Read the board number of the board, which can be used to distinguish between VEYE-MIPI-327 and VEYE-MIPI-IMX327S.

3.26 i2cwen

./veye_mipi_i2c.sh -r -f i2cwen

./veye_mipi_i2c.sh -w -f i2cwen -p1 [0/1]

Requirment: hdver >=4.

Whether to enable the i2C write register function of the camera, enabled by default. It is used for register write protection in special cases.

3.27 i2cauxenable

./veye_mipi_i2c.sh -r -f i2cauxenable

./veye_mipi_i2c.sh -w -f i2cauxenable -p1 [0/1]

Requirment: hdver >=4.

Whether to enable auxiliary i2C. If enable auxiliary i2C, the primary i2C on the FFC cable cannot be used. Used for bus conflict resolution in special cases.

3.28 awbgain

./veye_mipi_i2c.sh -r -f awbgain

Read the Rgain and Bgain of the current white balance status , parameter range [0,0xFF].

3.29 wbmode

./veye_mipi_i2c.sh -r -f wbmode

./veye_mipi_i2c.sh -w -f wbmode -p1 [value]

White balance mode setting.

value	description
0x18	Auto white balance
0x1B	Manual white balance

3.30 mwbgain

./veye_mipi_i2c.sh -r -f mwbgain

./veye_mipi_i2c.sh -w -f wbmode -p1 [rgain] -p2 [bgain]

Rgain and Bgain setting in manual white balance mode.arameter range [0,0xFF].

3.31 yuvseq

./veye_mipi_i2c.sh -w -f yuvseq -p1 YUYV

./veye_mipi_i2c.sh -w -f yuvseq -p1 UYVY

./veye_mipi_i2c.sh -r -f yuvseq

Set yuv seq of camera.

Note: only supported on hdver >= 0x4