NXP i.MX SoC Family/i.MX 8M Plus Camera and Display Guide
i.MX 8M Plus Camera and Display Guide - ISP Independent Sensor Interface API
까마귀75
2022. 9. 2. 16:29
728x90
반응형
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
728x90
반응형