本文主要介绍如何在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模式等
<laneAssign>0x10</laneAssign>
<isComboMode>0</isComboMode>
</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，上下电时序
<slaveInfo>
<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>
<powerSetting>
<configType>RESET</configType>
<configValue>1</configValue>
<delayMs>500</delayMs>
</powerSetting>
</powerUpSequence>
<powerDownSequence> //下电时序
<powerSetting>
<configType>RESET</configType>
<configValue>0</configValue>
<delayMs>1</delayMs>
</powerSetting>
</powerDownSequence>
</slaveInfo>
寄存器信息节点包含各种传感器特征的配置寄存器地址，如
<regAddrInfo>
<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配置
<resolutionData>
<colorFilterArrangement>BAYER_RGGB</colorFilterArrangement> //色彩滤波阵列
<streamInfo>
<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 |
以下是按照上述分辨率的参数，如下寄存器配置：
如下是设置寄存器前，需要设置如下权限，才能访问其他寄存器
<resSettings>
<regSetting>
<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>
<regSetting>
<registerAddr>0x30EB</registerAddr>
<registerData>0x0C</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x300A</registerAddr>
<registerData>0xFF</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x300B</registerAddr>
<registerData>0xFF</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x30EB</registerAddr>
<registerData>0x05</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x30EB</registerAddr>
<registerData>0x09</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</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的寄存器，需要先设置如下寄存器
后续就开始设置对应寄存器参数，如：
<regSetting>
<registerAddr>0x0114</registerAddr> <!-- D-Phy, 2-lanes -->
<registerData>0x01</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x0128</registerAddr>
<registerData>0x00</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x012A</registerAddr> <!-- 24 MHz INCK -->
<registerData>0x18</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</regSetting>
<regSetting>
<registerAddr>0x012B</registerAddr>
<registerData>0x00</registerData>
<regAddrType range="[1,4]">2</regAddrType>
<regDataType range="[1,4]">1</regDataType>
<operation>WRITE</operation>
<delayUs>0x00</delayUs>
</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 |
以下为datasheet里面的寄存器列表：
以上就是camera xml参数的一个解析，如需要集成或者调试其他camera sensor，可以参照如上配置去参照datasheet调试camera。
作者：
戴忠忠（Zhongzhong Dai），高通工程师