Difference between revisions of "MV Series MIPI Camera Register Map/zh"
Line 28: | Line 28: | ||
S: running状态下可读不可写。 | S: running状态下可读不可写。 | ||
− | - | + | -:任何时刻都只读。 |
=== 基础功能 === | === 基础功能 === | ||
{| class="wikitable" | {| class="wikitable" |
Revision as of 10:49, 7 April 2022
MV系列MIPI摄像机模组寄存器列表
1 概述
1.1 寄存器特征
寄存器地址的长度为4字节,值的长度为2字节。
寄存器读写属性分为RW,RO,WO三种。只有RW属性的可以保存到摄像机flash中。
寄存器值包括几种类型:int,bool,enum,ascii。
1.2 i2c通信协议
模组支持通过i2c协议进行参数配置。摄像机默认的i2c从地址是0x3b,这个地址是可以修改的。
i2c读写寄存器时采用大端字节序,即高字节在前的顺序。
为了方便客户使用,我们提供了linux下开源的shell脚本,帮助进行每个寄存器的读写。
下表中script function一列表示此寄存器对应的shell脚本的功能函数。
1.3 Update timing
摄像机有两种状态,standby和running。上电后进入standby状态,开始图像采集后进入running状态。
下表中,Update timing的类型有:
A:任何时刻都可以读写。
S: running状态下可读不可写。
-:任何时刻都只读。
2 基础功能
Address | Name | Description | Data Type | R/W | Update timing | script function |
---|---|---|---|---|---|---|
0x0000 | Manufacturer Name | String containing the self-describing name of the manufacturer. “VEYE” | ascii | RO | - | manufacturer |
0x0004 | Model Name | Product Model Code.
0x178 : MV-MIPI-IMX178M |
enum | RO | - | model |
0x0008 | Sensor Name | Sensor Model:
0x178 : IMX178LLJ |
enum | RO | - | |
0x000C | Serial Number | Unique product serial number | uint | RO | - | |
0x0010 | Device Version | Firmware version number. The high 16 bits are the Control version and the low 16 bits are the Logic version.
For example, 0x01020304 means Control version is 1.2 and Logic version is 3.4. |
uint | RO | - | version |
0x0014 | Factory Param | All parameters restored to factory default values. | bool | WO | A | factoryparam |
0x0018 | Param save to flash | Save all parameters to flash, and they will not be lost when power off. | bool | WO | A | paramsave |
0x001C | System reboot | Reboot the camera. | bool | WO | A | reboot |
0x0020 | Time stamp | Time after system startup in Milliseconds. | uint | RO | - | timestamp |
0x0024 | Error Code | System error code, each bit represents an error type.
bit0: sensor error. bit1: Logic module startup error. bit2: Logic module communication error. bit5: AA(AE&AG) regulation cannot reach the target brightness. bit6: Authorization failure. |
uint | RO | - | errcode |
0x0028 | Format Cap | Capbility of data formats supported by the camera.
bit0: Mono8 bit1: Mono10 bit2: Mono12 bit3: Mono14 bit4: UYVY |
uint | RO | - | fmtcap |
3 图像采集
Address | Name | Description | Data Type | R/W | Update timing | script function |
---|---|---|---|---|---|---|
0x0400 | Image Acquisition | Start/Stop acquisition
There is no image output after the camera is powered on, which means it is in the standby state. After writing 1 to this register, it enters the running state and starts outputting images or waiting for the trigger signal. |
bool | WO | A | imgacq |
0x0404 | Trigger Mode | 0:Video streaming mode
1:Normal trigger mode. 2:High-speed continuous trigger mode. See product manual for details. |
enum | RW | S | trgmode |
0x0408 | Trigger Source | 0: Software trigger mode.
1: Hardware trigger mode. |
enum | RW | S | trgsrc |
0x040C | Trigger Number | The number of image frames output by one trigger signal in trigger mode. Range:[1.255] | uint | RW | S | trgnum |
0x0410 | Trigger Interval | Trigger interval in normal trigger mode, in microseconds. Range:[0.0xFFFFFF] | uint | RW | S | trginterval |
0x0414 | Trigger Software | Software trigger command, write 1 for one trigger. | bool | WO | A | trgone |
0x0418 | Trigger Count | Trigger count statistics.
The high 16 bits indicate the number of trigger loss, and the low 16 bits indicate the total number of triggers. Write 1 to clear the count. |
uint | RW | A | trgcount |
0x041C | I2C ADDR | I2c address. Range[0x03,0x77]. | uint | RW | A | i2caddr |
4 图像参数
Address | Name | Description | Data Type | R/W | Update timing | script function |
---|---|---|---|---|---|---|
0x0800 | Test Image Selector | Switch between normal image or test image
0 : normal image 1 : Test image 1 2 : Test image 2 |
uint | RW | A | testimg |
0x0804 | Pixel Format | 0 : Mono8
1 : Mono10 2 : Mono12 3 : Mono14(reserved) 4 : UYVY |
enum | RW | A | pixelformat |
0x0808 | Sensor Width | The maximum width supported by the sensor | uint | RO | - | maxwh |
0x080C | Sensor Height | The maximum height supported by sensor | uint | RO | - | maxwh |
0x0810 | MaxFrame Rate | The maximum frame rate supported in the current mode.
The register value is 100 times the frame rate. |
uint | RO | - | maxfps |
0x0814 | Framerate | The current framerate.
The register value is 100 times the frame rate. |
uint | RW | S | fps |
0x0818 | ROI Width | ROI Width | uint | RW | S | roi |
0x081C | ROI Height | ROI Height
Of the four roi registers, please write this last. |
uint | RW | S | roi |
0x0820 | ROI Offset X | ROI Offset X | uint | RW | S | roi |
0x0824 | ROI Offset Y | ROI Offset Y | uint | RW | S | roi |
0x0828 | Image Direction | 0 : normal
1 : mirror 2 : flip 3 : flip&mirror |
enum | RW | A | imgdir |
0x0830 | Black Level | Black level | uint | RW | A | blacklevel |
5 图像处理(ISP)
Address | Name | Description | Data Type | R/W | Update timing | script function |
---|---|---|---|---|---|---|
0x0C00 | ISP module ctrl | The ISP module controls, each bit represents an isp function.
bit0: Exposure Statistics bit1: reserved bit2: WB Statistics bit3: Focus Statistics bit4: DPC bit5: gamma bit6: denoise bit7: sharpen bit8: LUT others: reserved |
uint | RW | A | gammaenable,
dpcenable, lutenable, |
0x0C04 | Exposure Mode | Exposure Type
0: Manual exposure 1: Run automatic exposure once 2: Automatic exposure |
enum | RW | A | expmode |
0x0C08 | Target Brightness | Target brightness for automatic exposure. Range[0,255] | uint | RW | A | aatarget |
0x0C10 | ME Time | Manual exposure time,effective in ME mode. Range[16,1000000]. Note1. | uint | RW | A | metime |
0x0C14 | AE MAX Time | Maximum exposure time in AE mode.Range[16,1000000]. Note1. | uint | RW | A | aemaxtime |
0x0C18 | Exp Time | Current exposure time. Note1. | uint | RO | - | exptime |
0x0C1C | Gain Mode | Gain Type
0: Manual gain 1: Run automatic gain once 2: Automatic gain |
enum | RW | A | gainmode |
0x0C20 | Manual Gain | Manual gain, ,effective in MG mode. Note2. | uint | RW | A | mgain |
0x0C24 | AG Max Gain | Maximum value of auto gain. Note2. | uint | RW | A | agmaxgain |
0x0C28 | Cur Gain | Current Gain. Note2. | uint | RO | - | curgain |
0x0C2C | AAROIOffsetX | AAROI offset X. Note4. | uint | RW | A | aaroi |
0x0C30 | AAROIOffsetY | AAROI offset Y. Note4. | uint | RW | A | aaroi |
0x0C34 | AAROIWidth | AAROI Width. Range: [16,ROI Width] | uint | RW | A | aaroi |
0x0C38 | AAROIHeight | AAROI Height. Range: [16,ROI Height] | uint | RW | A | aaroi |
0x0C60 | Gamma | gamma. The value is 100 times the actual gamma. 80 means gamma is 0.8. | uint | RW | A | gamma |
0x0C74 | LUT Count | The length of the lut curve 1024 or 4096. | uint | RO | - | lut |
0x0C78 | LUT Start | lut curve start transmission. | bool | WO | A | lut |
0x0C7C | LUT Done | lut curve writing finished. | bool | WO | A | lut |
0x0C80 | AAROI enable | Whether to enable AA statistics ROI function, not enable means full screen statistics. | bool | RW | A | aaroienable |
Note1: All parameters of exposure time are in microseconds. However, due to the properties of the sensor, the actual exposure time unit of the sensor is 1 line, can not be accurate to 1us.
Note2:For all gain-related parameters, the register value is 10 times the number of dB. For example, if the register is 101, it means 10.1dB. The range and step vary according to the model.
Note3: AE: Auto exposure; AG: Auto Gain; AA: AE and AG.
Note4: The AAROI coordinates are relative coordinates within the roi range.
6 IO控制
Address | Name | Description | Data Type | R/W | Update timing | script function |
---|---|---|---|---|---|---|
0x1000 | Trigger Delay | Trigger delay.
range: 0 to 1000000 (unit: microsecond) |
uint | RW | S | trgdelay |
0x1004 | Trigger Activation | 0: Rising edge
1: Falling edge |
uint | RW | S | trgedge |
0x1008 | Trigger Filter Enable | 0: No filtering
1: Low-level filtering (Filtering of interference signals on low levels) 2: High-level filtering (Filtering of interference signals on high levels) 3 :Both Low-level and High-level filtering |
uint | RW | S | trgfilter_enable |
0x100c | Trigger Filter Width | Trigger signal filtering window width
range: 1 to 1000000 (unit: microsecond) |
uint | RW | S | trgfilter_time |
0x1010 | Exposure Delay | Exposure delay, i.e. the time to turn on the Strobe signal in advance.
range: 1 to 1000000 (unit: microsecond) |
uint | RW | S | trgexp_delay |
0x1014 | TriggerIN IO status | trigger in IO pin status. | enum | RO | - | gpios_status |
0x1020 | GPIO1_OutSelect | 0: Strobe
1: UserOut |
uint | RW | A | outio1_mode |
0x1024 | GPIO1 UserOut | User-defined output signal. | enum | RW | A | outio1_usr |
0x1028 | GPIO1 Reverse | Output signal reversal. | bool | RW | A | outio1_rvs |
0x102C | GPIO1 OutStatus | GPIO1 IO pin status. | enum | RO | - | gpios_status |
0x1030 | GPIO2_OutSelect | 0: Strobe
1: UserOut 2: TriggerWait; trigger wait status. Indicate that the camera is waiting for the trigger, ready to respond to the trigger signal. 3: XVS 4: XHS |
uint | RW | A | outio2_mode |
0x1034 | GPIO2 UserOut | User-defined output signal. | enum | RW | A | outio2_usr |
0x1038 | GPIO2 Reverse | Output signal reversal. | bool | RW | A | outio2_rvs |
0x103C | GPIO2 OutStatus | GPIO2 IO pin status. | enum | RO | - | gpios_status |
7 特殊块存储区
0x1800-0x37FF : lut area.