i.MX 8M Plus Camera and Display Guide - ISP Independent Sensor Interface API

1.1 Overview

이 문서는 i.MX 8M Plus ISP Independent Sensor Interface (ISI) 모듈의 Application Programming Interface (API)에 대해 설명한다.

 

i.MX 8M Plus ISP Independent Sensor Interface API에 대한 자세한 내용은 이 문서에 설명되어 있다.

• 데이터 유형, 열거형, 관련 구조체와 반환 코드 같은 컴포넌트가 먼저 설명된다.
• 그런 다음 함수 구문과 설명이 제공된다.

이 문서에서 설명하는 API는 BSP release LF5.15.5_1.0.0에 적용된다.

 

코드는 C 언어로 작성되었으며, 파라미터 유형은 표준 C 언어 규칙을 따른다. 이 문서는 사용자가 C 언어의 기초를 이해하고 있다고 가정한다.

 

현재 이 API에는 더 이상 사용되지 않는 함수가 없다.

 

1.1.1 Acronyms and conventions (약어와 규칙)

Table 1.  Acronyms

AE	Auto Exposure
AEC	Auto Exposure Control
AF	Auto Focus
AFM	Auto Focus Measurement
AHB	Advance High-Performance Bus
AWB	Auto White Balance
AXI	Advanced eXtensible Interface
BPT	Bad Pixel Table
CAC	Chromatic Aberration Correction
CPROC	Color Processing Module
CTRL	Control Logic Module
DPCC	Defect Pixel Cluster Correction
DPF	De-noising Pre-Filter
FMF	Focus Measure Function
HVS	Human Visual System
IE	Image Effects Module
ISP	Image Signal Processor
ISR	Interrupt Set/Enable Register
LSC	Lens Shade Correction
MI	Memory Interface
MIPI	Mobile Industry Processor Interface (MIPI) Alliance Standard for camera serial interface 2 (CSI-2)
MRZE	Main Resize Module
SIMP	Super Impose Module
SMIA	Standard Mobile Imaging Architecture
SoC	System on Chip
SRZE	Self
VSM	Video Stabilization Measurement
WDR	Wide Dynamic Range
YCbCr	Color space with one luma and two chroma components used for digital encoding

규약

• 접두사 "0x"는 16진수를 나타낸다. 예로 0x32CF.
• 접두사 "0b"는 이진수를 나타낸다. 예로 "0b0011.0010.1100.1111".
• 코드 조각은 Consolas나 Courier 글씨체로 제공된다.

 

1.2 Independent Sensor Interface API Components

이 섹션에서는 isi/include 디렉토리에 선언된 API에 대해 설명한다. 이 문서에는 열거형과 구조체가 알파벳순으로 나열되어 있다.

 

1.2.1 Numeric Data Types (숫자 데이터 유형)

다음과 같은 일반적인 숫자 데이터 유형이 사용된다.

Name	Data Type
uint8_t	Unsigned 8-bit integer
int8_t	Signed 8-bit integer
uint16_t	Unsigned 16-bit integer
int16_t	Signed 16-bit integer
uint32_t	Unsigned 32-bit integer
int32_t	Signed 32-bit integer
uint64_t	Unsigned 64-bit integer
int64_t	Signed 64-bit integer
float	Float

 

1.2.2 RESULT Return Codes (RESULT 반환 코드)

이 테이블은 API 함수에 대한 반환 값을 지정한다.

RESULT String Values	Description
RET_FAILURE	General failure
RET_INVALID_PARM	Invalid parameter
RET_NOTSUPP	Feature not supported
RET_NULL_POINTER	Callback is a NULL pointer
RET_OUTOFMEM	Not enough memory available
RET_OUTOFRANGE	A configuration parameter is out of range
RET_PENDING	Command pending
RET_SUCCESS	Function successful
RET_WRONG_CONFIG	Given configuration is invalid
RET_WRONG_HANDLE	Invalid instance/HAL handle
RET_WRONG_STATE	Instance is in the wrong state to shut down

 

1.2.3 Enumerations

이 섹션에서는 열거형 정의에 대해 설명한다.

 

1.2.3.1 IsiBayerPattern_e

Bayer 센서의 패턴 모드를 지정한다. 

Enumeration Values	Value	Description
ISI_BAYER_RGGB	0	RGGB Bayer pattern
ISI_BAYER_GRBG	1	GRBG Bayer pattern
ISI_BAYER_GBRG	2	GBRG Bayer pattern
ISI_BAYER_BGGR	3	BGGR Bayer pattern
ISI_BAYER_MAX	4	Maximum number of sensor Bayer pattern components

 

1.2.3.2 IsiColorComponent_e

칼라 컴포넌트를 지정한다.

Enumeration Values	Value	Description
ISI_COLOR_COMPONENT_RED	0	Red color component
ISI_COLOR_COMPONENT_GREENR	1	GreenR color component
ISI_COLOR_COMPONENT_GREENB	2	GreenB color component
ISI_COLOR_COMPONENT_BLUE	3	Blue color component
ISI_COLOR_COMPONENT_MAX	4	Maximum number of color components.

 

1.2.3.3 IsiExpoFrmType_e

센서의 노출 시간을 지정한다.

Enumeration Values	Value	Description
ISI_EXPO_FRAME_TYPE_1FRAME	0	1 frame exposure type
ISI_EXPO_FRAME_TYPE_2FRAMES	1	2 frame exposure type
ISI_EXPO_FRAME_TYPE_3FRAMES	2	3 frame exposure type
ISI_EXPO_FRAME_TYPE_4FRAMES	3	4 frame exposure type

 

1.2.3.4 IsiFocus_e

초점의 위치 유형을 지정한다.

Enumeration Values	Value	Description
ISI_FOCUS_MODE_ABSOLUTE	0	Absolute position type
ISI_FOCUS_MODE_RELATIVE	1	Relative position type
ISI_FOCUS_MODE_MAX	2	Maximum number of focus position types.

 

1.2.3.5 IsiHdrMode_e

센서의 HDR 모드를 지정한다.

Enumeration Values	Value	Description
ISI_MODE_LINEAR	0	Linear HDR mode
ISI_MODE_HDR_STITCH	1	Stitch HDR mode
ISI_MODE_HDR_NATIVE	2	Native HDR mode
ISI_MODE_HDR_MAX	3	Maximum number of HDR modes.

 

1.2.3.6 IsiSensorTpgMode_e

센서의 테스트 패턴 모드를 지정한다.

Enumeration Values	Value	Description
ISI_TPG_DISABLE	0	Disable mode
ISI_TPG_MODE_0	1	Mode 0
ISI_TPG_MODE_1	2	Mode 1
ISI_TPG_MODE_2	3	Mode 2
ISI_TPG_MODE_3	4	Mode 3
ISI_TPG_MODE_4	5	Mode 4
ISI_TPG_MODE_5	6	Mode 5
ISI_TPG_MAX	7	Maximum number of sensor test pattern modes

 

1.2.3.7 IsiStitchingMode_e

선서의 HDR stitching 모드를 지정한다.

Enumeration Values	Value	Description
ISI_STITCHING_DUAL_DCG	0	Dual DCG mode 3x12-bit
ISI_STITCHING_3DOL	1	DOL3 frame 3x12-bit
ISI_STITCHING_LINEBYLINE	2	3x12-bit line by line without waiting
ISI_STITCHING_16BIT_COMPRESS	3	16-bit compressed data + 12-bit RAW
ISI_STITCHING_DUAL_DCG_NOWAIT	4	2x12-bit dual DCG without waiting
ISI_STITCHING_2DOL	5	DOL2 frame or 1 CG+VS sx12-bit RAW
ISI_STITCHING_L_AND_S	6	L+S 2x12-bit RAW
ISI_STITCHING_MAX	7	Maximum number of stitching modes

 

1.2.4 Structures

이 섹션에서는 구조체 정의에 대해 설명한다.

 

IsiCamDrvConfig_t

이 구조체는 카메라 센서 드라이버별 데이터를 정의한다.

Structure Members	Type	Description
CameraDriverID	uint32_t	카메라 센서 드라이버 ID.
*pIsiHalQuerySensor	IsiHalQuerySensor_t	HAL 핸들이 있는 쿼리 센서 모드.
*pfIsiGetSensorIss	IsiGetSensorIss_t	현재 구조체에서 멤버 IsiSensor를 초기화하기 위한 함수 포인터이다.
IsiSensor	IsiSensor_t	구조체는 ISI 레이어에서 센서를 컨트롤하기 위한 센서 이름과 함수 포인터를 포함한다.

 

IsidualGain_t

이 구조체는 듀얼 프레임 노출 HDR에 대한 센서 게인을 정의한다.

Structure Members	Type	Description
dualSGain	uint32_t	짧은 노출 프레임에 대한 게인 (고정 소수점, q10)
dualGain	uint32_t	일반 노출 프레임에 대한 게인 (고정 소수점, q10)

 

IsidualInt_t

이 구조체는 듀얼 프레임 노출 HDR에 대한 센서 적분 시간을 정의한다.

Structure Members	Type	Description
dualSIntTime	uint32_t	마이크로초 단위의 짧은 노출 프레임에 대한 적분 시간 (고정 소수점, q10)
dualIntTime	uint32_t	마이크로초 단위의 일반 노출 프레임에 대한 적분 시간 (고정 소수점, q10)

 

IsiFocusCalibAttr_t

이 구조체는 초점 보정 정보를 정의한다.

Structure Members	Type	Description
minPos	int32_t	최소 위치
maxPos	int32_t	최대 위치
minStep	int32_t	최소 단계 크기

 

IsiFocusPos_t

이 구조체는 초점 위치를 정의한다.

Structure Members	Type	Description
mode	IsiFocus_e	초점 위치 모드
Pos	int32_t	초점 위치

 

IsiLinearGain_t

이 구조체는 선형 모드에 대한 센서 게인(고정 소수점, q10)을 정의한다.

Typedef IsiLinearGain_t to uint32_t

 

IsiLinearInt_t

이 구조체는 선형 모드에 대한 마이크로초 단위의 센서 적분 시간(고정 소수점, q10)을 정의한다.

Typedef IsiLinearInt_t to uint32_t

 

IsiQuadGain_t

이 구조체는 쿼드 프레임 노출 HDR에 대한 센서 게인을 정의한다.

Structure Members	Type	Description
quadVSGain	uint32_t	매우 짧은 노출 프레임에 대한 게인 (고정 소수점, q10)
quadSGain	uint32_t	짧은 노출 프레임에 대한 게인 (고정 소수점, q10)
quadGain	uint32_t	일반 노출 프레임에 대한 게인 (고정 소수점, q10)
quadLGain	uint32_t	긴 노출 프레임에 대한 게인 (고정 소수점, q10)

 

IsiQuadInt_t

이 구조체는 쿼드 프레임 노출 HDR의 적분 시간을 정의한다.

Structure Members	Type	Description
quadVSIntTime	uint32_t	마이크로초 단위의 매우 짧은 노출 프레임을 위한 적분 시간 (고정 소수점, q10)
quadSIntSTime	uint32_t	마이크로초 단위의 짧은 노출 프레임을 위한 적분 시간 (고정 소수점, q10)
quadIntTime	uint32_t	마이크로초 단위의 일반 노출 프레임을 위한 적분 시간 (고정 소수점, q10)
quadLIntTime	uint32_t	마이크로초 단위의 긴 노출 프레임을 위한 적분 시간 (고정 소수점, q10)

 

IsiSensor_t

이 구조체는 센서의 속성을 정의한다.

 

Structure Members	Type	Description
*pszName	const char	카메라 센서의 이름
*pIsiSensorSetPowerIss	IsiSensorSetPowerIss_t	센서 전원 함수 설정
*pIsiCreateSensorIss_t	IsiCreateSensorIss_t	센서 핸들 생성
*pIsiReleaseSensorIss	IsiReleaseSensorIss_t	센서 핸들 해제
*pIsiRegisterReadIss	IsiRegisterReadIss_t	센서 레지스터 읽기
*pIsiRegisterWriteIss	IsiRegisterWriteIss_t	센서 레지스터 쓰기
*pIsiGetSensorModeIss	IsiGetSensorModeIss_t	센서 모드 정보 가져오기
*pIsiSetSensorModeIss	IsiSetSensorModeIss_t	센서 모드 인덱스 설정
*pIsiQuerySensorIss	IsiQuerySensorIss_t	지원하는 센서 모드 쿼리
*pIsiGetCapsIss	IsiGetCapsIss_t	센서 기능 가져오기
*pIsiSetupSensorIss	IsiSetupSensorIss_t	센서 포맷 설정과 센서 초기화
*pIsiGetSensorRevisionIss	IsiGetSensorRevisionIss_t	센서 리비전 ID 가져오기
*pIsiCheckSensorConnectionIss	IsiCheckSensorConnectionIss_t	센서 연결 상태 검사
*pIsiSensorSetStreamingIss	IsiSensorSetStreamingIss_t	스트리밍 설정
*pIsiGetAeInfoIss_t	IsiGetAeInfoIss_t	AE 정보 가져오기
*pIsiSetHdrRatioIss	IsiSetHdrRatioIss_t	HDR 비율 설정
*pIsiGetIntegrationTimeIss	IsiGetIntegrationTimeIss_t	적분 시간 가져오기
*pIsiSetIntegrationTimeIss	IsiSetIntegrationTimeIss_t	적분 시간 설정
*pIsiGetGainIss	IsiGetGainIss_t	현재 센서 게인 가져오기
*pIsiSetGainIss	IsiSetGainIss_t	센서 게인 설정
*pIsiGetSensorFpsIss	IsiGetSensorFpsIss_t	현재 프레임 속도 가져오기
*pIsiSetSensorFpsIss_t	IsiSetSensorFpsIss	센서 프레임 속도 설정
*pIsiSetSensorAfpsLimitsIss	IsiSetSensorAfpsLimitsIss_t	자동 FPS 제한 가져오기
*pIsiGetSensorIspStatusIss	IsiGetSensorIspStatusIss_t	ISP 상태(BLC와 WB는 센서 WB나 ISP WB 사용) 가져오기
*pIsiGetAeStartExposureIss	IsiGetAeStartExposureIss_t	AE 시작 노출 가져오기
*pIsiSetAeStartExposureIss	IsiSetAeStartExposureIss_t	AE 시작 노출 설정
*pIsiSensorSetBlcIss	IsiSensorSetBlcIss_t	센서 BLC를 사용하는 경우, 센서 BLC 설정
*pIsiSensorSetWBIss	IsiSensorSetWBIss_t	센서 WB를 사용하는 경우, 센서 WB 설정
*pIsiSensorGetExpandCurveIss	IsiSensorGetExpandCurveIss_t	센서 데이터가 압축된 경우, 확장 커브 가져오기
*pIsiActivateTestPatternIss_t	IsiActivateTestPatternIss	센서 테스트 패턴 설정
*pIsiFocusSetupIss	IsiFocusSetupIss	AF 핸들 생성
*pIsiFocusReleaseIss	IsiFocusReleaseIss_t	AF 핸들 해제
pIsiFocusSetIss_t	IsiFocusSetIss_t	초점 위치 설정
pIsiFocusGetIss_t	IsiFocusGetIss_t	초점 위치 가져오기
pIsiGetFocusCalibrateIss	IsiGetFocusCalibrateIss_t	초점 보정 정보 가져오기

 

IsiSensorAeInfo_t

이 구조체는 ISI 레이어의 AE 정보를 정의한다.

Structure Members	Type	Description
oneLineExpTime	uint32_t	마이크로초 단위의 센서 한 라인 노출 시간 (고정 소수점, q10)
maxIntTime	IsiSensorIntTime_u	마이크로초 단위의 최대 적분 시간
minIntTime	IsiSensorIntTime_u	마이크로초 단위의 최소 적분 시간
maxAGain	IsiSensorGain_u	최대 아날로그 게인
minAGain	IsiSensorGain_u	최소 아날로그 게인
maxDGain	IsiSensorGain_u	최대 디지털 게인
minDGain	IsiSensorGain_u	최소 디지털 게인
gainStep	uint32_t	센서 게인 단계 (고정 소수점, q10)
currFps	uint32_t	현재 센서 FPS (고정 소수점, q10)
maxFps	uint32_t	최대 센서 FPS (고정 소스점, q10)
minFps	uint32_t	최소 센서 FPS (고정 소수점, q10)
minAfps	uint32_t	최소 자동 센서 FPS (고정 소수점, q10)
hdrRatio [ISI_EXPO_FRAME_TYPE_MAX-1]	uint32_t	센서 HDR 비율 (고정 소수점, q10) q10 ISI_EXPO_PARAS_FIX_FRACBITS ISI_EXPO_FRAME_TYPE_1FRAME: no ratio ISI_EXPO_FRAME_TYPE_2FRAMES: hdrRatio[0]= Normal/Short ISI_EXPO_FRAME_TYPE_3FRAMES: hdrRatio[0]= Long/Normal hdrRatio[1]=Normal/Short
intUpdateDlyFrm	uint8_t	적분 업데이트 지연 프레임
gainUpdateDlyFrm	uint8_t	게인 업데이트 지연 프레임

 

IsiSensorBlc_t

이 구조체는 센서의 블랙 레벨을 설정하는 데 사용되는 구성 구조체를 정의한다.

Typedef IsiSensorBlc_t to sensor_blc_t

 

IsiSensorCaps_t

이 구조체는 센서의 기능을 정의한다.

Structure Members	Type	Description
FieldSelection	uint32_t	샘플링 필드 선택: 0x01: 모든 필드 샘플링 0x02: EVEN 필드 샘플링 0x04: ODD 필드 샘플링
YCSequence	uint32_t	YUV 데이터 출력 순서
Conv422	uint32_t	서브샘플링 칼라 모드
HPol	uint32_t	Horizontal 극성
VPol	uint32_t	Vertical 극성
Edge	uint32_t	샘플링 에지
supportModeNum	uint32_t	지원 모드 수
currentMode	uint32_t	현재 모드

 

IsiSensorContext_t

이 구조체는 센서 컨텍스트를 정의한다.

Structure Members	Type	Description
SensorId	uint8_t	센서 ID
I2cBusNum	uint8_t	센서가 연결된 I2C 버스.
SlaveAddress	uint16_t	센서가 구성된 I2C 슬레이브 주소.
SensorInitAddr	uint32_t	센서 초기화 주소
SensorInitSize	uint16_t	센서 초기화 크기
NrOfAddressBytes	uint8_t	주소 바이트 수
NrOfDataBytes	uint8_t	데이터 바이트 수
fd	int	/dev/v4l-subdev 파일 디스크립션
HalHandle	HalHandle_t	HAL 세션에서 사용되는 핸들 HalHandle_t is typedef void *
*pSensor	IsiSensor_t	센서 디바이스에 대한 포인터 IsiSensor_t is typedef IsiSensor_s

 

IsiSensorExpandCurve_t

이 구조체는 센서 확장 커브를 설정하는 데 사용되는 구성 구조체를 정의한다.

Typedef IsiSensorExpandCurve_t to sensor_expand_curve_t

 

IsiSensorGain_t

이 구초체는 센서 게인을 정의한다.

Structure Members	Type	Description
expoFrmType	IsiExpoFrmType_e	센서 노출 프레임 유형
gain	IsiSensorGain_u	센서 게인

 

IsiSensorGain_u

이 공용체는 센서 게인을 정의한다.

Structure Members	Type	Description
linearGainParas	IsiLinearGain_t	선형 게인 파라미터
dualGainParas	IsidualGain_t	듀얼 노출 HDR에 대한 게인 파라미터
triGainParas	IsiTriGain_t	삼중 노출 HDR에 대한 게인 파라미터
quadGainParas	IsiQuadGain_t	쿼드 노출 HDR에 대한 게인 파라미터

 

IsiSensorInstanceConfig_t

이 구조체는 새로운 센서 인스턴스를 생성하는 데 사용되는 구성 구조체를 정의한다.

Structure Members	Type	Description
SensorId	uint8_t	센서 ID
SensorInitAddr	uint32_t	센서 초기화 주소
SensorInitSize	uint16_t	센서 초기화 크기
HalHandle	HalHandle_t	HAL 세션에서 사용되는 핸들
HalDevID	uint32_t	이 센서의 HAL 디바이스 ID
I2cBusNum	uint8_t	센서가 연결된 I2C 버스.
SlaveAddr	uint16_t	센서가 구성된 I2C 슬레이브 주소.
I2cAfBusNum	uint8_t	AF 모듈이 연결된 I2C 버스.
SlaveAfAddr	uint16_t	AF 모듈이 구성된 I2C 슬레이브 주소.
SensorModeIndex	uint32_t	현재 센서의 모드 인덱스
*pSensor	IsiSensor_t	센서 드라이버 인터페이스에 대한 포인터
hSensor	IsiSensorHandle_t	IsiCreateSensorIss에서 반환된 센서 핸들 IsiSensorHandle_t is typedef void *
szSensorNodeName[32]	char	센서 노드 이름

 

IsiSensorIntTime_t

이 구조체는 센서 적분 시간을 정의한다.

Structure Members	Type	Description
expoFrmType	IsiExpoFrmType_e	센서 노출 프레임 유형
IntegrationTime	IsiSensorIntTime_u	센서 적분 시간

 

IsiSensorIntTime_u

이 공용체는 센서 적분 시간을 정의한다.

Structure Members	Type	Description
linearInt	IsiLinearGain_t	선형 적분 시간
dualInt	IsidualGain_t	듀얼 노출 HDR에 대한 적분 시간
triInt	IsiTriGain_t	삼중 노출 HDR에 대한 적분 시간
quadInt	IsiQuadGain_t	쿼드 노출 HDR에 대한 적분 시간

 

IsiSensorIspStatus_t

이 구조체는 센서의 ISP 상태를 정의한다.

Structure Members	Type	Description
useSensorAWB	bool_t	0: ISP의 WB 사용 1: 센서의 WB 사용
useSensorBLC	bool_t	0: ISP의 BLC 사용 1: ISP의 BLC 사용

 

IsiSensorMipiInfo

이 구조체는 MIPI에 대한 센서별 정보를 정의한다.

Structure Members	Type	Description
ucMipiLanes	uint8_t	센서에서 사용되는 MIPI 레인의 수

 

IsiSensorMode_t

Typedef IsiSensorMode_t to vvcam_mode_info_t

 

IsiSensorModeInfoArray_t

Typedef IsiSensorModeInfoArray _t to vvcam_mode_info_array_t

 

IsiSensorWB_t

이 구조체는 센서의 WB를 설정하는 데 사용되는 구성 구조체를 정의한다.

Typedef IsiSensorWB_t_t to sensor_white_balance_t

 

IsiTriGain_t

이 구조체는 삼중 노출 HDR에 대한 센서 게인을 정의한다.

Structure Members	Type	Description
triSGain	uint32_t	짧은 노출 프레임에 대한 게인 (고정 소수점, q10)
triGain	uint32_t	일반 노출 프레임에 대한 게인 (고정 소수점, q10)
triLGain	uint32_t	긴 노출 프레임에 대한 게인 (고정 소수점, q10)

 

IsiTriInt_t

이 구조체는 삼중 노출 HDR에 대한 적분 시간을 정의한다.

Structure Members	Type	Description
triSIntTime	uint32_t	마이크로초 단위의 매우 짧은 노출 프레임을 위한 적분 시간 (고정 소수점, q10)
triIntTime	uint32_t	마이크로초 단위의 일반 노출 프레임을 위한 적분 시간 (고정 소수점, q10)
triLIntTime	uint32_t	마이크로초 단위의 긴 노출 프레임을 위한 적분 시간 (고정 소수점, q10)

 

sensor_blc_t

Structure Members	Type	Description
red	uint32_t	Red BLC 레벨
gr	uint32_t	'Gr' BLC 레벨
gb	uint32_t	'Gb' BLC 레벨
blue	uint32_t	Blue BLC 레벨

 

sensor_data_compress_t

Structure Members	Type	Description
enable	uint32_t	0: 센서 데이터가 압축되지 않음 1: 센서 데이터가 압축됨
x_bit	uint32_t	센서 데이터가 압축된 경우, x_bit는 압축 전 데이터 비트 너비를 나타낸다.
y_bit	uint32_t	센서 데이터가 압축된 경우, y_bit는 압축 후 데이터 비트 너비를 나타낸다.

 

sensor_expand_curve_t

Structure Members	Type	Description
x_bit	uint32_t	데이터 압축 해제 커브의 입력 비트 너비
y_bit	uint32_t	데이터 압축 해제 커브의 출력 비트 너비
expand_px[64]	uint8_t	데이터 압축 해제 커브의 입력 간격 index.exp: 1<<expand_px[i] = expand_x_data[i+1] - expand_x_data[i]
expand_x_data[65]	uint32_t	데이터 압축 해제 커브 입력의 65개 포인트
expand_y_data[65]	uint32_t	데이터 압축 해제 커브 출력의 65개 포인트

 

sensor_hdr_artio_t

Structure Members	Type	Description
ratio_l_s	uint32_t	긴 노출과 짧은 노출의 센서 HDR 노출 비율 (고정 소수점, q10)
ratio_s_vs	uint32_t	짧은 노출과 매우 짧은 노출의 센서 HDR 노출 비율 (고정 소수점, q10)
accuracy	uint32_t	센서 HDR 정확도 (고정 소수점, q10)

 

sensor_mipi_info_s

Structure Members	Type	Description
mipi_lane	uint32_t	MIPI 레인

 

sensor_test_pattern_t

Structure Members	Type	Description
enable	uint8_t	센서 테스트 패턴 활성화/비활성화
pattern	uint32_t	센서 테스트 패턴

 

sensor_white_balance_t

Structure Members	Type	Description
r_gain	uint32_t	화이트 발란스 (WB) R 게인
gr_gain	uint32_t	'WB Gr' 게인
gb_gain	uint32_t	'WB Gb' 게인
b_gain	uint32_t	'WB B' 게인

 

vvcam_ae_info_t

Structure Members	Type	Description
def_frm_len_lines	uint32_t	센서의 기본 프레임 라인 길이 (항상 센서의 기본 모드 VTS로 설정됨)
curr_frm_len_lines	uint32_t	현재 프레임 라인 길이
one_line_exp_time_ns	uint32_t	한 라인의 노출 시간 (ns 단위) (always = sensor PCLK * HTS)
max_longintegration_line	uint32_t	최대 긴 적분 라인
min_longintegration_line	uint32_t	최소 긴 적분 라인
max_integration_line	uint32_t	최대 노출 라인
min_integration_line	uint32_t	최소 노출 라인
max_vsintegration_line	uint32_t	최대 마이크로초 단위의 매우 짧은 적분 시간
min_vsintegration_line	uint32_t	최소 마이크로초 단위의 매우 짧은 적분 시간
max_long_again	uint32_t	최대 긴 아날로그 게인 (고정 소수점, q10)
min_long_again	uint32_t	최소 긴 아날로그 게인 (고정 소수점, q10)
max_long_dgain	uint32_t	최대 긴 디지털 게인 (고정 소수점, q10)
min_long_dgain	uint32_t	최소 긴 디지털 게인 (고정 수수점, q10)
max_again	uint32_t	최대 아날로그 게인 (고정 소수점, q10)
min_again	uint32_t	최소 아날로그 게인 (고정 소수점, q10)
max_dgain	uint32_t	최대 디지털 게인 (고정 소수점, q10)
min_dgain	uint32_t	최소 디지털 게인 (고정 소수점, q10)
max_short_again	uint32_t	최대 짧은 아날로그 게인 (고정 소수점, q10)
min_short_again	uint32_t	최소 짧은 아날로그 게인 (고정 소수점, q10)
max_short_dgain	uint32_t	최대 짧은 디지털 게인 (고정 소수점, q10)
min_short_dgain	uint32_t	최소 짧은 디지털 게인 (고정 소수점, q10)
start_exposure	uint32_t	노출 시작 (exposure lines*gain (고정 소수점, q10))
gain_step	uint32_t	게인 스텝 (고정 소수점, q10)
cur_fps	uint32_t	현재 프레임 속도 (고정 소수점, q10)
max_fps	uint32_t	최대 프레임 속도 (고정 소수점, q10)
min_fps	uint32_t	최소 프레임 속도 (고정 소수점, q10)
min_afps	uint32_t	최소 아날로그 프레임 속도 (고정 소수점, q10)
int_update_delay_frm	uint8_t	적분 업데이트 지연 프레임
gain_update_delay_frm	uint8_t	게인 업데이트 지연 프레임
hdr_radio	sensor_hdr_artio_s	HDR radio
status	uint32_t	CLK 활성화 상태
sensor_mclk	unsigned long	센서 MIPI clock
csi_max_pixel_clk	unsigned long	센서 최대 픽셀 clock

* VTS: Vertical Total Size

* HTS: Horizontal Total Size

 

vvcam_mode_info_array_t

이 구조체는 vvcam_mode_info의 추상화이다.

Structure Members	Type	Description
count	uint32_t	지원되는 모드의 수
modes[VVCAM_SUPPORT_ MAX_MODE_COUNT]	vvcam_mode_info	센서 기능의 구조체

 

vvcam_mode_info_t

Structure Members	Type	Description
index	uint32_t	모드 인덱스
width	uint32_t	이미지 너비
height	uint32_t	이미지 높이
hdr_mode	uint32_t	HDR 모드
stitching_mode	uint32_t	HDR stitching 모드
bit_width	uint32_t	센서 비트 너비
data_compress	sensor_data_compress_t	센서 데이터 압축
bayer_pattern	uint32_t	Bayer 모드
ae_info	vvcam_ae_info_t	AE 정보
mipi_info	sensor_mipi_info_s	센서 MIPI 정보
preg_data	void *	센서 레지스터 구성 포인트
reg_data_count	uint32_t	센서 레지스터 구성 크기

 

vvcam_sccb_array_s

Structure Members	Type	Description
count	uint32_t	SCCB 레지스터의 수
*sccb_data	vvcam_sccb_data_s	SCCB 레지스터 데이터

 

vvcam_sccb_cfg_s

Structure Members	Type	Description
slave_addr	uint8_t	슬레이브 주소 등록
addr_byte	uint8_t	주소 바이트 등록
data_byte	uint8_t	데이터 유형 등록

 

vvcam_sccb_data_s

Structure Members	Type	Description
addr	uint32_t	레지스터 주소
data	uint32_t	레지스터 데이터

 

1.3 Independent Sensor Interface Functions (독립 센서 인터페이스 함수)

이 섹션에서는 독립 센서 인터페이스의 함수에 대한 개요를 제공한다.

 

1.3.1 General API Functions

IsiSensorSetPowerIss

설명:

이 함수는 센서의 전원을 컨트롤한다.

 

구문:

RESULT IsiSensorSetPowerIss (
bool_t_t        on
);

파라미터:

on

센서 전원 상태

반환:

RESULT Return Code: RET_SUCCESS, RET_FAILURE, RET_NOTSUPP

 

IsiReadRegister

설명:

이 함수는 이미지 센서 디바이스의 지정된 레지스터에서 값을 읽는다.

 

구문:

RESULT IsiReadRegister (
IsiSensorHandle_t           handle,
const uint32_t              RegAddress,
uint32_t                   *pRegValue
);

파라미터:

handle	센서 인스턴스 핸들
RegAddress	레지스터 주소
*pRegValue	레지스터에서 읽은 값

반환:

RESULT Return Code: RET_SUCCESS, RET_FAILURE, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiWriteRegister

설명:

이 함수는 해당 센서 함수를 호출하여 이미지 센서 디바이스에 주어진 바이트 수를 쓴다.

 

구문:

RESULT IsiWriteRegister (
IsiSensorHandle_t            handle,
const uint32_t               RegAddress,
const uint32_t               RegValue
);

파라미터:

handle	센서 인스턴스 핸들
RegAddress	레지스터 주소
RegValue	레지스터에 쓸 값

반환:

RESULT Return Code: RET_SUCCESS, RET_FAILURE, RET_WRONG_HANDLE, RET_NOTSUPP, RET_NULL_POINTER

 

IsiCreateSensorIss

설명:

이 함수는 센서 인스턴스를 생성한다.

 

구문:

RESULT IsiCreateSensorIss (
IsiSensorInstanceConfig_t  *pConfig
);

파라미터:

*pConfig

새로운 센서 인스턴스의 구성에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_OUTOFMEM

 

IsiGetSensorModeIss

설명:

이 함수는 센서 모드 인덱스에서 센서 모드 정보를 가져오는 데 사용된다.

 

구문:

RESULT IsiGetSensorModeIss (
IsiSensorHandle_t  *handle,
void               *pmode
);

파라미터:

*handle	센서 인스턴스 핸들
*pmode	vvcam_mode_info 데이터 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_OUTOFMEM

 

IsiSetSensorModeIss

설명:

이 함수는 센서 모드 인덱스에서 센서 모드 정보를 설정한다.

 

구문:

RESULT IsiSetSensorModeIss (
IsiSensorHandle_t        handle,
IsiSensorMode_t         *pmode
);

파라미터:

*handle	센서 인스턴스 핸들
*pmode	IsiSensorMode_t 데이터 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NOTSUPP

 

IsiQuerySensorIss

설명:

이 함수는 센서 지원 모드 정보를 쿼리하는 데 사용된다.

 

구문:

RESULT IsiQuerySensorIss (
IsiSensorHandle_t        *handle,
vvcam_mode_info_array_t  *pSensorInfo
);

파라미터:

*handle	센서 인스턴스 핸들
*pSensorInfo	vcam_mode_info_array_s 데이터 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_OUTOFMEM

 

IsiReleaseSensorIss

설명:

이 함수는 센서 인스턴스를 소멸/해제 한다.

 

구문:

RESULT IsiReleaseSensorIss (
IsiSensorHandle_t   handle
);

파라미터:

handle

센서 인스턴스 핸들

반환:

RESULT Return Code: RET_SUCCESS, RET_NOTSUPP

 

IsiGetCapsIss

설명:

이 함수는 센서 디스크립션 구초제에 대한 올바른 포인터를 채운다.

 

구문:

RESULT IsiGetCapsIss (
IsiSensorHandle_t   handle,
IsiSensorCaps_t    *pIsiSensorCaps
);

파라미터:

handle	센서 인스턴스 핸들
*pIsiSensorCaps	IsiSensorCaps_t 데이터 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER

 

IsiSetupSensorIss

설명:

이 함수는 지정된 구성으로 이미지 센서를 설정한다.

 

구문:

RESULT IsiSetupSensorIss (
IsiSensorHandle_t    handle,
IsiSensorConfig_t   *pConfig
);

파라미터:

handle	센서 인스턴스 핸들
*pConfig	IsiSensorCaps_t 데이터 구조체에 대한 포인터 (typedef IsiSensorCaps_t IsiSensorConfig_t)

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER

 

IsiSensorSetStreamingIss

설명:

가능한 경우, 이 함수는 센서 데이터의 스트리밍을 활성화/비활성화 한다.

 

구문:

RESULT IsiSensorSetStreamingIss (
IsiSensorHandle_t   handle,
bool_t              on
);

파라미터:

handle	센서 인스턴스 핸들
on	새로운 스트리밍 상태 BOOL_TRUE = on; BOOL_FALSE = off

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_WRONG_STATE

 

IsiCheckSensorConnectionIss

설명:

가능한 경우, 이 함수는 카메라 센서가 연결되었는지 확인한다.

 

구문:

RESULT IsiCheckSensorConnectionIss (
IsiSensorHandle_t   handle
);

파라미터:

handle

센서 인스턴스 핸들

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER

 

IsiGetSensorRevisionIss

설명:

이 함수는 센서 리비전 레지스터를 읽어서 반환한다.

 

구문:

RESULT IsiGetSensorRevisionIss (
IsiSensorHandle_t   handle,
uint32_t           *p_value
);

파라미터:

handle	센서 인스턴스 핸들
*p_value	센서 리비전 레지스터 값에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiRegisterWriteIss

설명:

이 함수는 해당 센서 함수를 호출하여 이미지 센서 디바이스에 주어진 바이트의 수를 쓴다.

 

구문:

RESULT IsiRegisterWriteIss (
IsiSensorHandle_t   handle,
const uint32_t      address,
const uint32_t     *p_value
);

파라미터:

handle	센서 인스턴스 핸들
address	레지스터 주소
*p_value	쓰려는 레지스터 값

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NOTSUPP

 

IsiRegisterReadIss

설명:

이 함수는 이미지 센서 디바이스의 주어진 레지스터에서 값을 읽는다.

 

구문:

RESULT IsiRegisterReadIss (
IsiSensorHandle_t   handle,
const uint32_t      address,
uint32_t            value
);

파라미터:

handle	센서 인스턴스 핸들
address	레지스터 주소
*p_value	레지스터에서 읽은 값

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

1.3.2 AEC API Functions

IsiGetAeInfoIss

설명:

이 함수는 AE 기본 정보를 반환한다.

 

구문:

RESULT IsiGetAeInfoIss(
IsiSensorHandle_t            handle,
IsiSensorAeInfo_t           *pAeInfo
);

파라미터:

handle	센서 인스턴스 핸들
*pAeInfo	IsiSensorAeInfo_t 구조체의 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_NOTSUPP, RET_WRONG_HANDLE

 

IsiSetHdrRatioIss

설명:

이 함수는 HDR 비율을 설정한다.

 

구문:

RESULT IsiSetHdrRatioIss (
IsiSensorHandle_t         handle,
uint8_t                   hdrRatioNum ,
uint32_t*                 HdrRatio
);

파라미터:

handle	센서 인스턴스 핸들
hdrRatioNum	HDR 비율 수
*HdrRatio	HDR 비율 값에 대한 포인터 (고정 소수점, q10)

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_NOTSUPP, RET_WRONG_HANDLE

 

IsiGetGainIss

설명:

이 함수는 이미지 센서 모듈에서 게인 값을 읽는다.

 

구문:

RESULT IsiGetGainIss (
IsiSensorHandle_t   handle,
float              *pGain
);

파라미터:

handle	센서 인스턴스 핸들
*pGain	게인 값의 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

IsiSetGainIss

설명:

이 함수는 이미지 센서 모듈에 게인 값을 쓴다.

 

구문:

RESULT IsiSetGainIss (
IsiSensorHandle_t   handle,
float               NewGain,
float              *pSetGain,
float              *hdr_ratio
);

파라미터:

handle	센서 인스턴스 핸들
NewGain	설정할 게인
*pSetGain	게인 값에 대한 포인터
&hdr_ratio	HDR 비율에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

IsiGetSensorFpsIss

설명:

이 함수는 센서의 프레임 속도를 반환한다.

 

구문:

RESULT IsiGetSensorFpsIss (
IsiSensorHandle_t         handle,
uint32_t                 *pFps,
);

파라미터:

handle	센서 인스턴스 핸들
*pFps	프레임률에 대한 포인터 (고정 소수점, q10)

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiSetSensorFpsIss

설명:

이 함수는 프레임 속도를 설정한다.

 

구문:

RESULT IsiSetSensorFpsIss (
IsiSensorHandle_t        handle,
uint32_t                 Fps,
);

파라미터:

handle	센서 인스턴스 핸들
Fps	프레임률 (고정 소수점, q10)

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP, RET_FAILURE

 

IsiSetSensorAfpsLimitsIss

설명:

이 함수는 자동 FPS 컨트롤를 위한 최소 FPS를 설정한다.

 

구문:

RESULT IsiSetSensorAfpsLimitsIss (
IsiSensorHandle_t        handle,
uint32_t                 minAfps
);

파라미터:

handle	센서 인스턴스 핸들
minAfps	자동 FPS를 위한 최소 FPS (고정 소수점, q10)

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiGetAeStartExposureIss

설명:

이 함수는 AE 시작 노출(IntegrationTime(μs) x Gain) (고정 소수점, q10)을 반환한다. 

 

구문:

RESULT IsiSensorGetStartExposure (
IsiSensorHandle_t         handle,
uint64_t                 *pExposure
);

파라미터:

handle	센서 인스턴스 핸들
*pExposure	AE 시작 노출(IntegrationTime(μs) x Gain)에 대한 포인터 (고정 소수점, q10)

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiSensorAeSetStartExposure

설명:

이 함수는 AE 시작 노출(IntegrationTime x Gain)을 설정한다.

 

구문:

RESULT IsiSensorAeSetStartExposure (
IsiSensorHandle_t        handle,
uint64_t                 fExposure
);

파라미터:

handle	센서 인스턴스 핸들
fExposure	설정할 AE 시작 노출(IntegrationTime(μs) x Gain), 값은 고정 소수점, q10

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiGetIntegrationTimeIss

설명:

이 함수는 현재 적분 시간을 가져온다.

 

구문:

RESULT IsiGetIntegrationTimeIss (
IsiSensorHandle_t            handle,
IsiSensorIntTime_t          *pIntegrationTime
);

파라미터:

handle	센서 인스턴스 핸들
*pIntegrationTime	IsiSensorIntTime_t 데이터 구조체의 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiSetIntegrationTimeIss

설명:

이 함수는 적분 시간을 설정한다.

 

구문:

RESULT IsiSetIntegrationTimeIss (
IsiSensorHandle_t            handle,
IsiSensorIntTime_t          *pIntegrationTime,
);

파라미터:

handle	센서 인스턴스 핸들
*pIntegrationTime	IsiSensorIntTime_t 데이터 구조체의 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_NULL_POINTER, RET_NOTSUPP, RET_WRONG_HANDLE

 

IsiGetSensorFpsIss

설명:

이 함수는 센서의 현재 프레임 속도를 가져오는 데 사용된다.

 

구문:

RESULT IsiGetSensorFpsIss (
IsiSensorHandle_t   handle,
uint32_t           *pFps,
);

파라미터:

handle	센서 인스턴스 핸들
*pFps	프레임률에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

IsiSetSensorFpsIss

설명:

이 함수는 센서의 프레임 속도를 설정하는 데 사용된다.

 

구문:

RESULT IsiSetSensorFpsIss(
IsiSensorHandle_t   handle,
uint32_t            Fps,
);

파라미터:

handle	센서 인스턴스 핸들
Fps	프레임률

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

IsiGetIntegrationTimeIncrementIss

설명:

이 함수는 가능한 작은 증분 적분 시간을 반환한다.

 

구문:

RESULT IsiGetIntegrationTimeIncrementIss(
IsiSensorHandle_t   handle,
float              *pIncr
);

파라미터:

handle	센서 인스턴스 핸들
*pIncr	가증한 작은 증분 적분 시간에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

1.3.3 AWB API Functions

IsiGetSensorIspStatusIss

설명:

이 함수는 센서 ISP 상태를 가져온다.

 

구문:

RESULT IsiGetSensorIspStatusIss (
IsiSensorHandle_t             handle,
IsiSensorIspStatus_t         *pSensorIspStatus
);

파라미터:

handle	센서 인스턴스 핸들
*pSensorIspStatus	센서 ISP 상태 구조체 IsiSensorIspStatus_t에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiSensorSetBlcIss

설명:

이 함수는 센서의 블랙 레벨 설정에 사용된다.

 

구문:

RESULT IsiSensorSetBlcIss(
IsiSensorHandle_t           handle,
sensor_blc_t               *pblc
);

 

파라미터:

handle	센서 인스턴스 핸들
*pblc	sensor_blc_t 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

IsiSensorSetWB

설명:

이 함수는 센서의 화이트 밸런스 설정에 사용된다.

 

구문:

RESULT IsiSensorSetWB (
IsiSensorHandle_t         handle,
IsiSensorWB_t            *pWb
);

파라미터:

handle	센서 인스턴스 핸들
*pWb	IsiSensorWB_t 데이터 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

1.3.4 Expand API Functions

IsiSensorGetExpandCurveIss

설명:

이 함수는 센서 확장 커브를 가져오는 데 사용된다.

 

구문:

RESULT IsiSensorGetExpandCurveIss(
IsiSensorHandle_t       handle,
sensor_expand_curve_t  *pexpand_curve
);

파라미터:

handle	센서 인스턴스 핸들
*pexpand_curve	sensor_expand_curve_t 구조체에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER

 

1.3.5 AF API Functions

IsiFocusSetupIss

설명:

이 함수는 포커스 모듈을 설정한다.

 

구문:

RESULT IsiFocusSetupIss(
IsiSensorHandle_t    handle
);

파라미터:

handle

센서 인스턴스 핸들

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NOTSUPP

 

IsiFocusReleaseIss

설명:

이 함수는 포커스 모듈을 해제한다.

 

구문:

RESULT IsiFocusReleaseIss (
IsiSensorHandle_t      handle
);

파라미터:

handle

센서 인스턴스 핸들

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiFocusSetIss

설명:

이 함수는 포커스 위치를 설정한다.

 

구문:

RESULT IsiFocusSetIss (
IsiSensorHandle_t      handle,
IsiFocusPos_t         *pPos
);

파라미터:

handle	센서 인스턴스 핸들
*pPos	포커스 위치 데이터 구조체 IsiFocusPos_t에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NOTSUPP

 

IsiFocusGetIss

설명:

이 함수는 포커스 위치를 가져온다.

 

구문:

RESULT IsiFocusGetIss (
IsiSensorHandle_t     handle,
IsiFocusPos_t        *pPos
);

파라미터:

handle	센서 인스턴스 핸들
*pPos	포커스 위치 데이터 구조체 IsiFocusPos_t에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER, RET_NOTSUPP

 

IsiFocusCalibrateIss

설명:

이 함수는 포커스 보정 정보를 가져온다.

 

구문:

RESULT IsiFocusCalibrateIss (
IsiSensorHandle_t        handle,
IsiFoucsCalibAttr_t     *pFocusCalib
);

파라미터:

handle	센서 인스턴스 핸들
*pFocusCalib	포커스 보정 데이터 구조체 IsiFocusCalibAttr_t에 대한 포인터

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NOTSUPP

 

1.3.6 Test Pattern API Functions

IsiActivateTestPattern

설명:

이 함수는 센서의 테스트 패턴(기본 값: 칼라바)을 활성화나 비활성화 한다.

 

구문:

RESULT IsiActivateTestPattern (
IsiSensorHandle_t       handle,
IsiSensorTpgMode_e      tpgMode
);

파라미터:

handle	센서 인스턴스 핸들
tpgMode	TPG 모드

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_WRONGSTATE, RET_NULL_POINTER, RET_NOTSUPP

 

1.3.7 Miscellaneous API Functions

IsiDumpAllRegisters

설명:

이 함수는 모든 레지스터를 지정된 파일에 덤프한다.

 

구문:

RESULT IsiDumpAllRegisters(
IsiSensorHandle_t    handle,
const uint8_t       *filename
);

파라미터:

handle	센서 인스턴스 핸들
*filename	모든 레지스터를 덤프할 파일 이름

반환:

RESULT Return Code: RET_SUCCESS, RET_WRONG_HANDLE, RET_NULL_POINTER