QUICK 调试camera-xml解析

本文主要介绍如何在QUICK QCS6490使能相机模组。QCS6490的相机基于CameraX的框架，只需通过配置XML文件，设置相机模组的相关参数，就可以点亮相机。本文主要介绍Camera Sensor Module XML和Camera Sensor XML配置的解析，这中间需要camera的datasheet，查看对应的一些规格和参数。

Camera Sensor Module XML解析：

如下是调试imx219的module XML

<cameraId>0</cameraId> // cameraId与slot id一致，或者说与dts中的cell-index一致

<moduleName>sunny</moduleName> //模组厂商名字

<sensorName>imx219</sensorName> //sensor名称

<eepromName></eepromName> //eeprom名称

<actuatorName></actuatorName> //马达名称

<flashName>pmic</flashName> //flash名称

<chromatixName>default_c7project</chromatixName> //bin文件名称

<position>REAR</position> //模组位置，如前摄后摄

<CSIInfo description="CSI Information"> //CSI 信息，如lane分配，combo模式等

</CSIInfo>

<lensInfo description="Lens Information"> //镜头的参数设置

<focalLength>4.28</focalLength> //焦距

<fNumber>1.79</fNumber> //光圈

<minFocusDistance>0.08</minFocusDistance> //最小焦距

<maxFocusDistance>2.0</maxFocusDistance> //最大焦距

<horizontalViewAngle>66.3</horizontalViewAngle> //水平视角

<verticalViewAngle>52.4</verticalViewAngle> //垂直视角

<maxRollDegree>360</maxRollDegree> //翻滚角

<maxPitchDegree>360</maxPitchDegree> //俯仰角

<maxYawDegree>360</maxYawDegree> //偏航角

参数名称	值	说明
cameraId	0	cameraId与slot id一致，或者说与dts中的cell-index一致
moduleName	sunny	模组厂商名字
sensorName	imx219	sensor名称
eepromName		eeprom名称
actuatorName		马达名称
flashName	pmic	flash名称
chromatixName	default_c7project	bin文件名称
position	REAR	模组位置，如前摄后摄
CSIInfo		CSI 信息，如lane分配，combo模式等
- laneAssign	0x10	lane分配
- isComboMode	0	是否为combo模式，0表示否
lensInfo		镜头的参数设置
- focalLength	4.28	焦距
- fNumber	1.79	光圈
- minFocusDistance	0.08	最小焦距
- maxFocusDistance	2.0	最大焦距
- horizontalViewAngle	66.3	水平视角
- verticalViewAngle	52.4	垂直视角
- maxRollDegree	360	翻滚角
- maxPitchDegree	360	俯仰角
- maxYawDegree	360	偏航角

Camera Sensor XML解析：

以下是从设备配置，包含型号，I2C，sensorID，上下电时序

<sensorName>imx219</sensorName> //sensor型号

<slaveAddress>0x20</slaveAddress> //i2c地址

<regAddrType range="[1,4]">2</regAddrType> //地址类型

1 = Byte address 2 = Word address 3 = 3 byte address 4 = Address type max

<regDataType range="[1,4]">2</regDataType>//地址数据

1 = Byte data 2 = Word data 3 = Double word data 4 = Data type max

<sensorIdRegAddr>0x0000</sensorIdRegAddr> // sensor id 寄存器地址

<sensorId>0x0219</sensorId> // sensor id

<sensorIdMask>0xFFFFFFFF</sensorIdMask> //sensor id的掩码，如：0xFFFFFFFF <i2cFrequencyMode>FAST</i2cFrequencyMode> //I2C的操作模式，FAST

<powerUpSequence> //上电时序

<powerSetting> //电源配置

<configType>RESET</configType> //电源配置属性，如RESET,MCLK,VANA,VDIG等

<configValue>0</configValue> //电源配置数值

<delayMs>1</delayMs> //延时

</powerSetting>

<configType>RESET</configType>

</powerSetting>

</powerUpSequence>

<powerDownSequence> //下电时序

<configType>RESET</configType>

</powerSetting>

</powerDownSequence>

</slaveInfo>

寄存器信息节点包含各种传感器特征的配置寄存器地址，如

<xOutput>0x016C</xOutput> //sensor x寄存器

<yOutput>0x016E</yOutput>//sensor y寄存器

<frameLengthLines>0x0160</frameLengthLines> //height + VBlank寄存器

<lineLengthPixelClock>0x0162</lineLengthPixelClock>// width + HBlank寄存器

<coarseIntgTimeAddr>0x015A</coarseIntgTimeAddr> //sensor 曝光寄存器

<shortCoarseIntgTimeAddr>0x015A</shortCoarseIntgTimeAddr>// sensor 短曝光寄存器

<globalGainAddr>0x0157</globalGainAddr> // gain寄存器

<shortGlobalGainAddr>0x0157</shortGlobalGainAddr>//短gain寄存器

<digitalGlobalGainAddr>0x0158</digitalGlobalGainAddr> //数字gain寄存器

<testPatternRAddr>0x0602</testPatternRAddr> // R通道测试寄存器

<testPatternGRAddr>0x0604</testPatternGRAddr>// G通道测试寄存器

<testPatternBAddr>0x0608</testPatternBAddr> // B通道测试寄存器

<testPatternGBAddr>0x0606</testPatternGBAddr> // Gb通道测试寄存器

</regAddrInfo>

参数名称	值	说明
sensorName	imx219	sensor型号
slaveAddress	0x20	i2c地址
regAddrType	2	地址类型
	1 = Byte address
	2 = Word address
	3 = 3 byte address
	4 = Address type max
regDataType	2	地址数据
	1 = Byte data
	2 = Word data
	3 = Double word data
	4 = Data type max
sensorIdRegAddr	0x0000	sensor id 寄存器地址
sensorId	0x0219	sensor id
sensorIdMask	0xFFFFFFFF	sensor id的掩码
i2cFrequencyMode	FAST	I2C的操作模式
powerUpSequence		上电时序
- powerSetting		电源配置
- configType	RESET	电源配置属性
- configValue	0	电源配置数值
- delayMs	1	延时
- powerSetting
- configType	RESET
- configValue	1
- delayMs	500
powerDownSequence		下电时序
- powerSetting		电源配置
- configType	RESET	电源配置属性
- configValue	0	电源配置数值
- delayMs	1	延时

从sensor的datasheet中可以找到以下对应的寄存器

以下为分辨率设置的一些参数，可以设置为多种配置，下面为HD 30fps配置

<colorFilterArrangement>BAYER_RGGB</colorFilterArrangement> //色彩滤波阵列

<streamConfiguration> //stream配置

<vc range="[0,3]">0</vc> //虚拟通道

<dt>0X2b</dt> //数据类型默认为0x2B (10 bit RAW)

<frameDimension> //指定框架尺寸

<xStart>681</xStart> //x坐标

<yStart>693</yStart> //y 坐标

<width>1920</width> //宽

<height>1080</height> //高

</frameDimension>

<bitWidth>10</bitWidth> //位宽

<type>IMAGE</type> //数据类型

</streamConfiguration>

</streamInfo>

<lineLengthPixelClock>2599</lineLengthPixelClock> //指定帧的像素时钟width + HBlank

<frameLengthLines>1771</frameLengthLines> //帧长height + VBlank

<minHorizontalBlanking>0</minHorizontalBlanking> //像素的最小水平间隔

<minVerticalBlanking>0</minVerticalBlanking> //像素的最小垂直间隔

<outputPixelClock>182400000</outputPixelClock> //输出像素clock

<horizontalBinning>1</horizontalBinning> //水平合并值

<verticalBinning>1</verticalBinning> //垂直合并值

<frameRate>30.01</frameRate> //帧率

<laneCount>2</laneCount> //lane 数量

<downScaleFactor>1.0</downScaleFactor> //缩小系数，理论上设置为1或者更大

<settleTimeNs>14</settleTimeNs> //稳定时间，camera与板子传输时间，接收端能稳定接收数据

<is3Phase>0</is3Phase> //1为CPHY, 0为DPHY

参数名称	值	说明
colorFilterArrangement	BAYER_RGGB	色彩滤波阵列
streamInfo
- streamConfiguration		stream配置
- vc	0	虚拟通道
- dt	0X2b	数据类型，默认为0x2B (10 bit RAW)
- frameDimension		指定框架尺寸
- xStart	681	x坐标
- yStart	693	y坐标
- width	1920	宽
- height	1080	高
- bitWidth	10	位宽
- type	IMAGE	数据类型
lineLengthPixelClock	2599	指定帧的像素时钟 (width + HBlank)
frameLengthLines	1771	帧长 (height + VBlank)
minHorizontalBlanking	0	像素的最小水平间隔
minVerticalBlanking	0	像素的最小垂直间隔
outputPixelClock	182400000	输出像素时钟
horizontalBinning	1	水平合并值
verticalBinning	1	垂直合并值
frameRate	30.01	帧率
laneCount	2	lane数量
downScaleFactor	1.0	缩小系数，理论上设置为1或者更大
settleTimeNs	14	稳定时间，camera与板子传输时间，接收端能稳定接收数据
is3Phase	0	1为CPHY, 0为DPHY

以下是按照上述分辨率的参数，如下寄存器配置：

如下是设置寄存器前，需要设置如下权限，才能访问其他寄存器

<registerAddr>0x30EB</registerAddr> //sensor寄存器地址

<registerData>0x05</registerData> //sensor寄存器值

<regAddrType range="[1,4]">2</regAddrType> //地址类型

<regDataType range="[1,4]">1</regDataType> //数据类型

<operation>WRITE</operation> //读写操作

<delayUs>0x00</delayUs> //延时

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

sensor寄存器值	Register Data	地址类型	数据类型	读写操作	延时(us)
0x30EB	0x05	2	1	WRITE	0x00
0x30EB	0x0C	2	1	WRITE	0x00
0x300A	0xFF	2	1	WRITE	0x00
0x300B	0xFF	2	1	WRITE	0x00
0x30EB	0x05	2	1	WRITE	0x00
0x30EB	0x09	2	1	WRITE	0x00

可以从datasheet上找到对应的信息，要操作0x3000-0x5FFF的寄存器，需要先设置如下寄存器

后续就开始设置对应寄存器参数，如：

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

<operation>WRITE</operation>

</regSetting>

Register Address	Register Data	Address Type	Data Type	Operation	Delay (us)
0x0114	0x01	2	1	WRITE	0x00
0x0128	0x00	2	1	WRITE	0x00
0x012A	0x18	2	1	WRITE	0x00
0x012B	0x00	2	1	WRITE	0x00