编译环境中的driver文件的相关位置
slaveInfo: XML文件中的slaveInfo节点保存驱动程序在 probe sensor 时使用的信息,包括I2C地址 I2C频率 sensor寄存器地址 sensor寄存器值 上下电时序等,注意需要完全按照厂商提供的sensor spec填写。
Sensor slave information node
节点 | 描述 |
slaveInfo | Contains the sensor slave information and power settings. |
sensorName | Name of the sensor. Example: imx230 |
slaveAddress | 8 bit or 10 bit slave address Example: 32 For 0x20 slave address, the field value is 32. |
regAddrType | Register address/data size in bytes. Example:
|
regDataType | Register address/data size in bytes.
|
sensorIdRegAddr | Register address for sensor ID. Example: 22 |
sensorId | Sensor ID. Example: 560 |
sensorIDMask | Mask for sensor ID. Sensor ID may only be a few bits. Example: 4294967295 |
i2cFrequencyMode | I2C Frequency mode of slave. Example: FAST Supported modes are:
|
powerUpSequence | Contains the power-up configuration sequence required to control the power to the device while turning it on. Example: |
powerSetting | Contains power configuration type, value, and delay. |
configType | Power configuration type. Example: MCLK Supported types are:
|
configValue | Power configuration type. Example: 24000000 |
delayMs | Delay in milliseconds. Example: 1 |
powerDownSequence | Contains the power-down configuration sequence that is required to control the power to the device while closing it. Example: |
refAddrInfo : register information节点包含用于设置gain, frame length lines, and test pattern generation等各种传感器功能的配置寄存器地址。
节点 | 描述 |
regAddrInfo | Contains the information about the register addresses for various sensor settings. |
xOutput | Controls the program width. Example: 844 If the register address is 0x34C then the value of this field is 844 |
yOutput | Controls the program height. Example: 846 |
frameLengthLines | Programs the frame length lines. Example: 832 |
lineLengthPixelClock | Programs the line length pixel clock. Example: 834 |
globalGainAddr | Program the gain channel. Example: 516 |
digitalGainRedAddr | Programs digital gain for the red channel. This address is optional but is required if supported by sensor. Example: 528 |
digitalGainGreenRedAddr | Programs digital gain for the green-red channel. This address is optional but is required if supported by sensor. Example: 526 |
digitalGainBlueAddr | Register address to program digital gain for the blue channel. This address is optional but is required if supported by sensor. Example: 530 |
digitalGainGreenBlueAddr | Programs digital gain for the green-blue channel. The address is optional but is required when supported by sensor. Example: 532 |
testPatternRAddr | Programs manual test pattern value for the red channel. Example: 1538 |
testPatternGRAddr | Programs manual test pattern value for the red channel. Example: 1540 |
testPatternBAddr | Programs manual test pattern value for the red channel. Example: 1542 |
testPatternGBAddr | Programs manual test pattern value for the red channel. Example: 1544 |
resolutionInfo: The resolution information node 包含有关分辨率设置和配置的信息。
节点 | 描述 |
resolutionInfo | This node holds the configuration and settings for all the resolutions. |
resolutionData | Holds the configuration data for one resolution. The number of sensor supported resolutions is equal to the number of resolutionData nodes. NOTE: First node of the resolutionData should always point to the full resolution configuration of the sensor. |
colorFilterArrangement | Color filter arrangement of the sensor. Example: BAYER_RGGB Supported filter arrangements are:
|
streamInfo | Information related to the stream configuration. Example: |
streamConfiguration | Information related to the stream data. |
vc | Virtual channel of the data Example: 2 Each unique combination of virtual channel (VC) and DT should map to a unique channel identifier (CID) value. Possible CID values for a given VC are:
|
dt | DT of the stream. Example: 43 Default value is 0x2B (10 bit RAW) |
frameDimension | Frame dimension contains x and y start coordinates, and the total width and height of the image. |
xStart | X coordinate of start of image. |
yStart | Y coordinate of start of image. |
width | Width of the image. |
height | Height of the image |
bitWidth | Bit width of the data. |
type | Stream type
|
lineLengthPixelClock | Line length pixel clock of frame. Typically, this value is the active width + blanking width. |
frameLengthLines | Frame length lines of frame. Typically, this value is the active height + blanking height. |
minHorizontalBlanking | Minimum horizontal blanking interval in pixels. |
minVerticalBlanking | Minimum horizontal blanking interval in lines |
outputPixelClock | Represents how much data comes out of the camera over MIPI lanes to set the VFE clock. op_pixel_clk = (Total data rate from sensor)/(Bits per pixel) For example, if the MIPI DDR clock value (speed of the clock lane of the MIPI camera sensor) is 300 MHz and the sensor transmits on four lanes, each lane has a 600 MHz data rate. Thus, the total data rate is 2400 MHz. For 10 bits per pixel bayer data, the op_pixel_clk value is 2400/10 = 240 MHz. The values are filled in accordance with the sensor specifications. The values are calculated based on the register settings configured for the camera sensor. |
horizontalBinning | Horizontal binning value. |
verticalBinning | Vertical binning value. |
framerate | Maximum frame rate |
laneCount | The number of data lanes on which the sensor outputs data for a given mode of operation. The maximum data lane capability (given in the datasheet) of the sensor along with the sensor register settings configured in the driver determines the value |
settleTimeNs | Settle time in nanoseconds.
T(TIMER_CLK) is the duration of a clock cycle when the operating frequency is equal to TIMER_CLK, and is represented in nano second units. For example, T(TIMER_CLK) for TIMER_CLK 200
If the calculated value does not work as expected, try alternating the lower values between T(HS_SETTLE)_avg/T(TIMER_CLK) and T(HS_SETTLE)_min/T(TIMER_CLK) are tried. |
is3Phase | Flag to know if the sensor is a three-phase sensor (C-PHY) or one-phase sensor (D-PHY). |
resSettings | Sequence of register settings to configure the device with this resolution. NOTE: Do not add stream on settings for the sensor in the initialization settings, as this enables the sensor streaming before real software stream on and may cause PHY to miss LP sequence. Example: |
regSetting | This node holds one register configuration and forms a unit of large-resolution register settings sequence. |
registerAddr | Register address that is accessed. |
registerData | If the operation is WRITE, registerData is the data value to be written into the specified register address. If the operation is READ, registerData is the number of bytes to be read from the specified register address. |
regAddrType | Type of register address. |
regAddrType | Type of register address. |
regDataType | Type of register data. |
operation | Type of operation Supported values:
|
delayUs | Delay in microseconds. If not explicitly specified, the delay is zero. |
cropInfo | Crop information of the frame. Example: |
left | Left crop pixel information. |
right | Right crop pixel information. |
top | Top crop pixel information. |
bottom | Bottom crop pixel information. |
capability | List of features/capabilities supported by the sensor. Supported features are: HFR iHDR INSENSOR_HDR PDAF QUADRA_CFA RAW_HDR ZIGZAG_HDR |
exposureControlInfo: The exposure control information node 包含曝光细节,如 maximum gain, maximum line count, and conversion formulas for gain manipulation.
节点 | 描述 |
exposureControlInfo | This node holds the information about the exposure details such as maximum gain, maximum line count, and conversion formulas for gain manipulation. Example: |
maxAnalogGain | Maximum analog gain supported by the sensor. |
maxDigitalGain | Maximum digital gain supported by the sensor. |
verticalOffset | Minimum offset to be maintained between the line count and frame length lines. |
maxLineCount | Maximum line count supported by the sensor. |
realToRegGain | Real gain to register the gain equation. The equation must contain realGain in the equation. |
regToRealGain | Register gain to real gain equation. The equation must contain regGain in the equation. |
streamOnSettings: Register settings to start streaming.
节点 | 描述 |
streamOffSettings | Sequence of register settings to configure the device to stop streaming. Configure the following settings to match this guideline and take the clock and data lanes to LP11. Example: |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register DT, operation, and delay in micro seconds |
streamOffSettings | Sequence of register settings to configure the device to stop streaming. Configure the following settings to match this guideline and take the clock and data lanes to LP11. Example: |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register DT, operation, and delay in micro seconds |
groupHoldOnSettings: Register settings to configure the device in group hold settings.
节点 | 描述 |
groupHoldOnSettings | Sequence of register settings to configure the device in group hold settings. Example: |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register data type, operation, and delay in micro seconds. |
groupHoldOffSettings | Sequence of register settings to configure the device to stop group hold settings. Example: |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register data type, operation, and delay in micro seconds. |
initSettings: Sequence of register settings to initialize the sensor.
节点 | 描述 |
initSettings | Sequence of register settings to initialize the sensor. NOTE: Do not add stream on settings for the sensor in the initialization settings, as this enables the sensor streaming before real software stream on and may cause PHY to miss LP sequence. Example: |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register data type, operation, and delay in micro seconds. |
testPatternInfo: This node contains the information about the test pattern generation register settings.
节点 | 描述 |
testPatternInfo | Contains the information about the test pattern generation register settings. Example: |
testPatternData | This node holds the register and mode settings of a particular test pattern. |
Mode | Supported modes are: OFF SOLID_COLOR COLOR_BARS COLOR_BARS_FADE_TO_GRAY PN9 CUSTOM1 |
settings | Sequence of register settings to configure the test pattern on the sensor. |
regSetting | Register setting configuration. Contains: Register address, register data, register address type, register data type, operation, and delay in micro seconds. |
colorLevelInfo: The color level information node provides details about the various channels in complete dark light.
节点 | 描述 |
colorLevelInfo | Color level information. The default currents in various channels in complete dark light. Example: |
whiteLevel | White level value. |
rPedestal | Pedestal value for the red channel. |
grPedestal | Pedestal value for the green-red channel. |
bPedestal | Pedestal value for the blue channel. |
gbPedestal | Pedestal value for the green-blue channel. |
opticalBlackRegionInfo | Information about black regions. Multiple black regions are provided, if applicable. Example: |
dimension | Frame dimension: Contains xStart, yStart, width, and height |
xStart | X start coordinate of the region. |
yStart | Y start coordinate of the region. |
width | Width of the region. |
height | Height of the region. |
pixelArrayInfo | Information about the pixel array. Active dimension and dummy pixels width are provided. |
activeDimension | Width and height of the frame or subframe. Example: |
xStart | Start of the X output in the frame. |
yStart | Start of the Y output in the frame. |
width | Total width of the frame in pixels. |
height | Total height of the frame in pixels. |
dummyInfo | Dummy pixels surrounding the active pixel array. Example: |
left | Starting coordinate of the left dummy pixel. |
right | Starting coordinate of the right dummy pixel. |
top | Starting coordinate of the top dummy pixel. |
bottom | Starting coordinate of the bottom dummy pixel. |
appDelayInfo | Delay information. |
linecount | Number of frames required to apply the line count. |
gain | Number of frames required to apply the gain. |
maxPipeline | Maximum pipeline delay in number of frames. |
frameSkip | Number of initial bad frames to skip. |
sensorProperty | Sensor property information. Example: |
pixelSize | Pixel size in micro meters. |
cropFactor | Crop factor. |
sensingMethod | Sensing method of sensor. Supported sensing methods: UNDEFINED ONE_CHIP_COLOR_AREA TWO_CHIP_COLOR_AREA THREE_CHIP_COLOR_AREA COLOR_SEQUENCE_AREA TRILINEAR COLOR_SEQUENCE_LINEAR |