41. Query internal status messages¶

41.1. Funtion Overview¶

This section describes the interfaces associated with Inner State Information.The purpose of this interface is to provide users with the true values currently set for querying the internal state of the system and for several ISO-related parameter.

Users can use this interface during debugging to obtain the actual values currently filled in by ISO-related parameter to verify that they are configured correctly.Only numeric values can be obtained through this interface, and related parameter cannot be changed.

41.2. API Reference¶

CVI_ISP_QueryInnerStateInfo : Get the internal information of the system and the real values currently set for ISO-related parameter.

41.2.1. CVI_ISP_QueryInnerStateInfo¶

【Description】

Get internal information about the system and the real values currently set for ISO-related parameter

【Syntax】

CVI_S32 CVI_ISP_QueryInnerStateInfo(VI_PIPE ViPipe, ISP_INNER_STATE_INFO_S *pstInnerStateInfo);

【Parameter】

Parameter	Description	Input/Output
ViPipe	VI_PIPE number	Input
pstInnerStateInfo	Internal Information and Current Actual Parameter Settings	Output

【Return Value】

return value	Description
0	Success
Non 0	Failure. An error code is returned. For details, see chapter Error Codes.

【Requirement】

Header files: cvi_isp.h, cvi_comm_isp.h
Library files: libisp.so

【Note】

None.

【Example】

None.

【Related Topic】

None.

41.3. Data Types¶

ISP_INNER_STATE_INFO_S : Define internal information and current actual parameter settings

41.3.1. ISP_INNER_STATE_INFO_S¶

【Description】

Define internal information and current actual parameter settings

【Syntax】

  #define MAX_HIST_BINS 256
  #define MAX_EXPOSURE_RATIO 256
  #define LTM_DARK_CURVE_NODE_NUM 257
  #define LTM_BRIGHT_CURVE_NODE_NUM 513

  typedef struct _ISP_INNER_STATE_INFO_S {
    CVI_U32 blcOffsetR;
    CVI_U32 blcOffsetGr;
    CVI_U32 blcOffsetGb;
    CVI_U32 blcOffsetB;
    CVI_U32 blcGainR;
    CVI_U32 blcGainGr;
    CVI_U32 blcGainGb;
    CVI_U32 blcGainB;
    CVI_S32 ccm[9];
    CVI_U16 drcGlobalToneBinNum;
    CVI_U16 drcGlobalToneBinSEStep;
    CVI_U32 drcGlobalTone[LTM_GLOBAL_CURVE_NODE_NUM];
    CVI_U32 drcDarkTone[LTM_DARK_CURVE_NODE_NUM];
    CVI_U32 drcBrightTone[LTM_BRIGHT_CURVE_NODE_NUM];
    CVI_BOOL bWDRSwitchFinish;
    // For 2TO1/3TO1/4TO1 use.
    CVI_U32 u32WDRExpRatioActual[ISP_WDR_FRAME_IDX_SIZE];
    ISP_MESH_SHADING_GAIN_LUT_S mlscGainTable;
} ISP_INNER_STATE_INFO_S;

【Member】

Member	Description
wdrHistBinNum	Number of array in the current wdr distribution histogram of the picture
blcOffsetR	Current value of black level subtracted from component R
blcOffsetGr	Current value of black level subtracted from component Gr
blcOffsetGb	Current value of black level subtracted from component Gb
blcOffsetB	Current value of black level subtracted from component B
blcGainR	Digital gain of current ISP in R component
blcGainGr	Digital gain of current ISP in Gr component
blcGainGb	Digital gain of current ISP in Gb component
blcGainB	Digital gain of current ISP in B component
Ccm[9]	True values of the color restore matrix currently used by ISP
wdrHistogramBefore[MAX_HIST_BINS * MAX_EXPOSURE_RATIO]	Distribution histogram of current wdr
wdrHistogramAfter[MAX_HIST_BINS * MAX_EXPOSURE_RATIO]	Hue mapping curves from the current wdr distribution histogram
drcDarkTone[LTM_DARK_CURVE_NODE_NUM]	Dark area hue mapping curve currently used by ISP
drcBrightTone[LTM_BRIGHT_CURVE_NODE_NUM]	Bright area hue mapping curve currently used by ISP
bWDRSwitchFinish	Indicate if sensor mode switch is complete

【Note】

None.

【Related Data Type and Interface】

None.