nvmedia_isc.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2020, NVIDIA CORPORATION.  All rights reserved.  All
 * information contained herein is proprietary and confidential to NVIDIA
 * Corporation.  Any use, reproduction, or disclosure without the written
 * permission of NVIDIA Corporation is prohibited.
 */
 
#ifndef _NVMEDIA_ISC_H
#define _NVMEDIA_ISC_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "nvmedia_core.h"
#include "nvmedia_icp.h"
 
#define NVMEDIA_ISC_VERSION_MAJOR   3
 
#define NVMEDIA_ISC_VERSION_MINOR   2
 
#define NVMEDIA_ISC_SIMULATOR_ADDRESS   0xFF1u
 
#define RDEV_CFG_I2C_BITS           8
 
#define RDEV_CFG_CSI_BITS           (RDEV_CFG_I2C_BITS + 8)
 
#define RDEV_CFG_SLV_BIT            (RDEV_CFG_CSI_BITS + 1)
 
#define ISC_RDEV_CFG(csi, i2c)   (((uint32_t)(csi) << RDEV_CFG_I2C_BITS) | (i2c))
 
#define ISC_RDEV_CFG_EX(csi, i2c, disPwrCtrl) \
         ((i2c & 0xffu) | \
          ((uint32_t)(csi & 0xffu) << RDEV_CFG_I2C_BITS) | \
          ((uint32_t)(disPwrCtrl & 1u) << RDEV_CFG_SLV_BIT))
 
#define ISC_SLV_RDEV_CFG(csi, i2c) \
        ((i2c) | ((uint32_t)(csi) << RDEV_CFG_I2C_BITS) | ((uint32_t)(1u) << RDEV_CFG_CSI_BITS))
 
#define ADV_CONFIG_INIT(cfg, ctx) \
        do { \
            memset(&cfg, 0, sizeof(cfg)); \
            cfg.clientContext = (void *)(ctx); \
        } while (0)
 
#define NVMEDIA_ISC_MAX_EXPOSURES           (8u)
 
#define NVM_ISC_MAX_COLOR_COMPONENT         (4u)
 
#define NVMEDIA_ISC_MAX_SENSOR_CONTEXTS     (4u)
 
#define NVMEDIA_ISC_MAX_PWL_KNEEPOINTS      (64u)
 
#define NVMEDIA_ISC_MAX_FRAME_REPORT_BYTES  (4u)
 
#define NVMEDIA_ISC_MAX_NUM_TEMPERATURES    (4u)
 
#define NVMEDIA_ISC_MAX_SENSOR_NAME_LENGTH  (32u)
 
#define NVMEDIA_ISC_MAX_FUSE_ID_LENGTH      (32u)
 
struct NvMediaISCSensorControl;
 
struct NvMediaISCEmbeddedDataChunk;
 
struct NvMediaISCEmbeddedDataInfo;
 
struct NvMediaISCSensorAttributes;
 
#if !NV_IS_SAFETY
struct NvMediaISCModuleConfig;
#endif
 /* Ends Basic ISC Types group */
 
NvMediaStatus
NvMediaISCGetVersion(
    NvMediaVersion *version
);
 /* Ends version_info_isc_api ISC Version Information sub-group. */
 
typedef struct {
    void *deviceDriverHandle;
} NvMediaISCDevice;
 
typedef enum {
    NVMEDIA_ISC_I2C_BUS_0 = 0, 
    NVMEDIA_ISC_I2C_BUS_1 = 1, 
    NVMEDIA_ISC_I2C_BUS_2 = 2, 
    NVMEDIA_ISC_I2C_BUS_3 = 3, 
    NVMEDIA_ISC_I2C_BUS_4 = 4, 
    NVMEDIA_ISC_I2C_BUS_5 = 5, 
    NVMEDIA_ISC_I2C_BUS_6 = 6, 
    NVMEDIA_ISC_I2C_BUS_7 = 7, 
    NVMEDIA_ISC_I2C_BUS_8 = 8, 
    NVMEDIA_ISC_I2C_BUS_9 = 9, 
    NVMEDIA_ISC_I2C_BUS_10 = 10, 
    NVMEDIA_ISC_I2C_BUS_11 = 11, 
    NVMEDIA_ISC_I2C_SIMULATOR = 255, 
} NvMediaISC_I2CPort;
 
typedef void NvMediaISCRootDevice;
 
NvMediaISCRootDevice *
NvMediaISCRootDeviceCreate(
    uint32_t portCfg
);
 
void
NvMediaISCRootDeviceDestroy(
    NvMediaISCRootDevice *device
);
 
NvMediaStatus
NvMediaISCRootDeviceWaitForError(
    NvMediaISCRootDevice *device
);
 
NvMediaStatus
NvMediaISCRootDeviceAbortWaitForError(
    NvMediaISCRootDevice *device
);
 
typedef struct {
    char *deviceName;
    int32_t regLength;
    int32_t dataLength;
 
    NvMediaStatus (* DriverCreate)(
        NvMediaISCDevice *handle,
        void *clientContext);
 
    NvMediaStatus (* DriverDestroy)(
        NvMediaISCDevice *handle);
 
    NvMediaStatus (* SetSensorControls)(
        NvMediaISCDevice *handle,
        const struct NvMediaISCSensorControl *sensorControl,
        const size_t sensrCtrlStructSize);
 
    NvMediaStatus (* ParseEmbedDataInfo)(
        NvMediaISCDevice *handle,
        const struct NvMediaISCEmbeddedDataChunk *embeddedTopDataChunk,
        const struct NvMediaISCEmbeddedDataChunk *embeddedBotDataChunk,
        const size_t dataChunkStructSize,
        struct NvMediaISCEmbeddedDataInfo *embeddedDataInfo,
        const size_t dataInfoStructSize);
 
    NvMediaStatus (* GetSensorAttributes)(
        NvMediaISCDevice *handle,
        struct NvMediaISCSensorAttributes *sensorAttr,
        const size_t sensorAttrStructSize);
 
#if !NV_IS_SAFETY
 
    NvMediaStatus (* GetModuleConfig)(
        NvMediaISCDevice *handle,
        struct NvMediaISCModuleConfig *moduleConfig);
 
    NvMediaStatus (* SetSensorCharMode)(
        NvMediaISCDevice *handle,
        uint8_t expNo);
#endif
} NvMediaISCDeviceDriver;
 
typedef struct {
    void *clientContext;
} NvMediaISCAdvancedConfig;
 
NvMediaISCDevice *
NvMediaISCDeviceCreate(
    NvMediaISCRootDevice *rootDevice,
    uint32_t *deviceAddressList,
    uint32_t numDevices,
    NvMediaISCDeviceDriver *deviceDriver,
    NvMediaISCAdvancedConfig *advancedConfig
);
 
void
NvMediaISCDeviceDestroy(
    NvMediaISCDevice *device
);
 
NvMediaStatus
NvMediaISCDeviceRead(
    NvMediaISCDevice *device,
    uint32_t deviceIndex,
    uint32_t regLength,
    uint8_t *regData,
    uint32_t dataLength,
    uint8_t *data
);
 
NvMediaStatus
NvMediaISCDeviceWrite(
    NvMediaISCDevice *device,
    uint32_t deviceIndex,
    uint32_t dataLength,
    const uint8_t *data
);
 
typedef struct NvMediaISCAttrRange {
    float_t  min;
 
    float_t  max;
 
} NvMediaISCAttrRange;
 
typedef struct NvMediaISCSensorAttributes {
    char  sensorName[NVMEDIA_ISC_MAX_SENSOR_NAME_LENGTH];
 
    uint32_t  sensorCFA;
 
    char sensorFuseId[NVMEDIA_ISC_MAX_FUSE_ID_LENGTH];
 
    uint8_t  numActiveExposures;
 
    NvMediaISCAttrRange sensorExpRange[NVMEDIA_ISC_MAX_EXPOSURES];
 
    NvMediaISCAttrRange sensorGainRange[NVMEDIA_ISC_MAX_EXPOSURES];
 
    NvMediaISCAttrRange sensorWhiteBalanceRange[NVMEDIA_ISC_MAX_EXPOSURES];
 
    float_t  sensorGainFactor[NVMEDIA_ISC_MAX_EXPOSURES];
 
    uint32_t  numFrameReportBytes;
 
} NvMediaISCSensorAttributes;
 
NvMediaStatus
NvMediaISCGetSensorAttributes(
    NvMediaISCDevice *device,
    NvMediaISCSensorAttributes *sensorAttr,
    const size_t sensorAttrStructSize);
 
typedef struct NvMediaISCExposure {
    NvMediaBool expTimeValid;
 
    float_t exposureTime[NVMEDIA_ISC_MAX_EXPOSURES];
 
    NvMediaBool gainValid;
 
    float_t sensorGain[NVMEDIA_ISC_MAX_EXPOSURES];
 
} NvMediaISCExposure;
 
 
typedef struct NvMediaISCWhiteBalance {
    NvMediaBool wbValid;
 
    struct {
        float_t value[NVM_ISC_MAX_COLOR_COMPONENT];
    } wbGain[NVMEDIA_ISC_MAX_EXPOSURES];
 
} NvMediaISCWhiteBalance;
 
typedef struct NvMediaISCFrameReport {
    NvMediaBool frameReportValid;
 
    uint8_t numBytes;
 
    uint8_t sensorframeReport[NVMEDIA_ISC_MAX_FRAME_REPORT_BYTES];
 
} NvMediaISCFrameReport;
 
typedef struct NvMediaISCPWL {
    NvMediaBool  pwlValid;
 
    uint8_t numKneePoints;
 
    NvMediaPointDouble kneePoints[NVMEDIA_ISC_MAX_PWL_KNEEPOINTS];
 
} NvMediaISCPWL;
 
typedef struct NvMediaISCTemperature {
    NvMediaBool  tempValid;
 
    uint8_t numTemperatures;
 
    float_t sensorTempCelsius[NVMEDIA_ISC_MAX_NUM_TEMPERATURES];
 
} NvMediaISCTemperature;
 
typedef struct NvMediaISCCRC {
    NvMediaBool  crcValid;
 
    uint32_t computedCRC;
 
    uint32_t embeddedCRC;
 
} NvMediaISCCRC;
 
typedef struct NvMediaISCFrameSeqNum {
    NvMediaBool  frameSeqNumValid;
 
    uint64_t frameSequenceNumber;
 
} NvMediaISCFrameSeqNum;
 
typedef struct NvMediaISCSensorControl {
    uint8_t                 numSensorContexts;
 
    NvMediaISCExposure       exposureControl[NVMEDIA_ISC_MAX_SENSOR_CONTEXTS];
 
    NvMediaISCWhiteBalance   wbControl[NVMEDIA_ISC_MAX_SENSOR_CONTEXTS];
 
    NvMediaISCFrameReport    frameReportControl;
 
} NvMediaISCSensorControl;
 
NvMediaStatus
NvMediaISCSetSensorControls(
    NvMediaISCDevice *device,
    const NvMediaISCSensorControl *sensorControl,
    const size_t sensrCtrlStructSize
);
 
typedef struct NvMediaISCEmbeddedDataInfo {
    uint32_t                     numExposures;
 
    NvMediaISCExposure           sensorExpInfo;
 
    NvMediaISCWhiteBalance       sensorWBInfo;
 
    NvMediaISCPWL                sensorPWLInfo;
 
    NvMediaISCCRC                sensorCRCInfo;
 
    NvMediaISCFrameReport        sensorReportInfo;
 
    NvMediaISCTemperature        sensorTempInfo;
 
    NvMediaISCFrameSeqNum        frameSeqNumInfo;
 
} NvMediaISCEmbeddedDataInfo;
 
/*
 * \brief  Holds the sensor embedded data chunk structure.
 */
typedef struct NvMediaISCEmbeddedDataChunk {
    uint32_t lineLength;
 
    const uint8_t *lineData;
} NvMediaISCEmbeddedDataChunk;
 
NvMediaStatus
NvMediaISCParseEmbedDataInfo(
    NvMediaISCDevice *device,
    const NvMediaISCEmbeddedDataChunk *embeddedTopDataChunk,
    const NvMediaISCEmbeddedDataChunk *embeddedBotDataChunk,
    const size_t embeddedDataChunkStructSize,
    NvMediaISCEmbeddedDataInfo *embeddedDataInfo,
    const size_t dataInfoStructSize);
 
#if !NV_IS_SAFETY
 
typedef enum {
    NVMEDIA_ISC_PWR_AGGREGATOR,
    NVMEDIA_ISC_PWR_LINK_0,
    NVMEDIA_ISC_PWR_LINK_1,
    NVMEDIA_ISC_PWR_LINK_2,
    NVMEDIA_ISC_PWR_LINK_3,
} NvMediaISCPowerItems;
 
typedef struct NvMediaISCModuleConfig {
    char cameraModuleCfgName[128];
    const char *cameraModuleConfigPass1;
    const char *cameraModuleConfigPass2;
} NvMediaISCModuleConfig;
 
NvMediaStatus
NvMediaISCRootDevicePowerControl(
    NvMediaISCRootDevice *device,
    NvMediaISCPowerItems  powerItem,
    NvMediaBool powerOn
);
 
NvMediaStatus
NvMediaISCRootDeviceGetPowerStatus(
    NvMediaISCRootDevice *device,
    NvMediaISCPowerItems  powerItem,
    NvMediaBool *powerStatus
);
 
NvMediaStatus
NvMediaISCRootDeviceEnableSync(
    NvMediaISCRootDevice *device,
    NvMediaBool enable
);
 
NvMediaStatus
NvMediaISCRootDeviceSetSyncConfig(
    NvMediaISCRootDevice *device,
    float_t freq,
    float_t dutyRatio
);
 
NvMediaStatus
NvMediaISCRootDeviceGetSyncConfig(
    NvMediaISCRootDevice *device,
    float_t *freq,
    float_t *dutyRatio
);
 
typedef enum {
    NVMEDIA_ISC_EXPOSURE_MODE_LONG,
    NVMEDIA_ISC_EXPOSURE_MODE_SHORT,
    NVMEDIA_ISC_EXPOSURE_MODE_VERY_SHORT,
    NVMEDIA_ISC_EXPOSURE_MODE_MAX
} NvMediaISCExposureMode;
 
typedef struct NvMediaISCExposureControl {
    struct {
        float_t value;
        NvMediaBool valid;
    } exposureTime[NVMEDIA_ISC_EXPOSURE_MODE_MAX];
    struct {
        float_t value;
        NvMediaBool valid;
    } sensorGain[NVMEDIA_ISC_EXPOSURE_MODE_MAX];
    uint8_t sensorFrameId;
} NvMediaISCExposureControl;
 
typedef struct NvMediaISCWBGainControl {
    struct {
        float_t value[4];
        NvMediaBool valid;
    } wbGain[NVMEDIA_ISC_EXPOSURE_MODE_MAX];
} NvMediaISCWBGainControl;
 
typedef struct {
    uint32_t baseRegAddress;
    uint32_t size;
    uint32_t bufferSize;
    uint8_t *data;
} NvMediaISCEmbeddedDataBuffer;
 
typedef struct NvMediaISCEmbeddedData {
    NvMediaISCEmbeddedDataBuffer top;
    NvMediaISCEmbeddedDataBuffer bottom;
    NvMediaISCExposureControl exposureControl;
    NvMediaISCWBGainControl wbControl;
    uint32_t frameSequenceNumber;
} NvMediaISCEmbeddedData;
 
typedef enum {
    NVMEDIA_ISC_SENSOR_ATTR_FUSE_ID,
    NVMEDIA_ISC_SENSOR_ATTR_GAIN_MIN,
    NVMEDIA_ISC_SENSOR_ATTR_GAIN_MAX,
    NVMEDIA_ISC_SENSOR_ATTR_ET_MIN,
    NVMEDIA_ISC_SENSOR_ATTR_ET_MAX,
    NVMEDIA_ISC_SENSOR_ATTR_ET_FINE,
    NVMEDIA_ISC_SENSOR_ATTR_ET_STEP,
    NVMEDIA_ISC_SENSOR_ATTR_HDR_MAX,
    NVMEDIA_ISC_SENSOR_ATTR_GAIN_FACTOR, NVMEDIA_ISC_SENSOR_ATTR_QE_PIXEL_RATIO,
    NVMEDIA_ISC_SENSOR_ATTR_FRAME_RATE,
    NVMEDIA_ISC_SENSOR_ATTR_NUM_EXPOSURES,
} NvMediaISCSensorAttrType;
 
NvMediaStatus
NvMediaISCSetSensorCharMode(
    NvMediaISCDevice *device,
    uint8_t expNo);
 
NvMediaStatus
NvMediaISCGetModuleConfig(
    NvMediaISCDevice *device,
    NvMediaISCModuleConfig *moduleConfig
);
#endif /* #if !NV_IS_SAFETY */
 
/*
 * \defgroup history_isc History
 * Provides change history for the NvMedia Image Sensor Control API.
 *
 * \section history_isc Version History
 *
 * <b> Version 1.0 </b> April 1, 2014
 * - Initial release
 *
 * <b> Version 1.1 </b> April 3, 2015
 * - Add mode in \ref NvMediaISCEmbeddedData
 *
 * <b> Version 1.2 </b> April 16, 2015
 * - Add new port config macro \ref ISC_ROOT_DEVICE_CFG
 * - The \a advancedConfig attribute is being used in \ref NvMediaISCDeviceCreate
 * - Add new callback function \ref NvMediaISCRootDeviceRegisterCallback to handle device errors
 *
 * <b> Version 1.3 </b> April 24, 2015
 * - Moved the \a regLength and \a dataLength attributes from \ref NvMediaISCAdvancedConfig
 *   in \ref NvMediaISCDeviceDriver.
 * - Add macro \ref ADV_CONFIG_INIT
 *
 * <b> Version 1.4 </b> April 28, 2015
 * - Add hdrRatio in \ref NvMediaISCExposureControl structure
 * - Add conversionGain in \ref NvMediaISCEmbeddedData structure
 *
 * <b> Version 1.5 </b> July 13, 2015
 * - Add exposureMidpointTime in \ref NvMediaISCEmbeddedData structure
 * - Add NVMEDIA_ISC_I2C_SIMULATOR in \ref NVMEDIA_ISC_I2C_SIMULATOR
 * - Add new function \ref NvMediaISCRootDevicePowerControl and \ref NvMediaISCPowerItems
 * - Modify the input parameter cbFunc of NvMediaISCRootDeviceRegisterCallback
 * - Add function \ref NvMediaISCGetErrorStatus to get error information from device
 * - Add \ref NvMediaISCSensorProperties structure
 * - Add \ref NvMediaISCGetSensorProperties to get sensor properties
 *
 * <b> Version 1.6 </b> September 9, 2015
 * - Add SensorMode in \ref NvMediaISCExposureControl structure
 *
 * <b> Version 1.7 </b> September 21, 2015
 * - Increase I2C ports to support 12 I2C busses
 *
 * <b> Version 1.8 </b> December 09, 2015
 * - Add channelGainRatio for sensors which only allow same or fixed ratio gain in exposure channels
 *
 * <b> Version 1.9 </b> January 22, 2016
 * - Add NvMediaISCRootDeviceGetPowerStatus function
 *
 * <b> Version 1.10 </b> May 5, 2016
 * - Add NvMediaISCModuleConfig structure and NvMediaISCGetModuleConfig function.
 *
 * <b> Version 1.11 </b> May 11, 2016
 * - Add \ref NvMediaISCCheckVersion API
 *
 * <b> Version 1.12 </b> June 7, 2016
 * - Add NVMEDIA_ISC_SIMULATOR_ADDRESS to use for ISC simulator devices
 *
 * <b> Version 1.13 </b> June 20, 2016
 * - Add frameSequenceNumber in \ref NvMediaISCEmbeddedData
 *
 * <b> Version 1.14 </b> July 6, 2016
 * - Add ISC_ROOT_DEVICE_CFG_EX macro
 *
 * <b> Version 1.15 </b> July 8, 2016
 * - Add \ref NvMediaISCSetBracketedExposure new API for settings bracketed exposure
 *
 * <b> Version 1.16 </b> Oct 10, 2016
 * - Add sensor attributes \ref NvMediaISCSensorAttrType & new API \ref NvMediaISCGetSensorAttr
 *
 * <b> Version 1.17 </b> November 21, 2016
 * - Add \ref NvMediaISCRootDeviceEnableSync new API for enabling/disabling PWM
 * - Add \ref NvMediaISCRootDeviceSetSyncConfig new API for setting PWM's frequency and duty
 * - Add \ref NvMediaISCRootDeviceGetSyncConfig new API for getting PWM's frequency and duty
 *
 * <b> Version 1.18 </b> Jan 5, 2017
 * - Add \ref NvMediaISCSetCompandingCurve API for setting companding curve
 *
 * <b> Version 1.19 </b> Jan 27, 2017
 * - Add \ref Add const modifier to data parameter in NvmediaISCSupportFuntion Write.
 *
 * <b> Version 2.00 </b> April 19, 2017
 * - Deprecated NvMediaISCDeviceType and EnableLink from \ref NvMediaISCDeviceDriver.
 * - Updated to use stdint.h
 * - Replaced float with float_t
 * - Removed unused input parameter from NvMediaISCRootDeviceCreate
 * - Deprecated queueElementsNumber and queueElementSize from \ref NvMediaISCRootDeviceCreate
 * - Deprecated unused or not supported APIs as below list.
 *     NvMediaISCRootDeviceDoTransaction
 *     NvMediaISCRootDeviceSync
 *     NvMediaISCUpdateDeviceAddress
 *     NvMediaISCSetDeviceLinkMode
 *     NvMediaISCGetLinkStatus
 *     NvMediaISCSetPriority
 * - NvMediaISCGetLinkStatus is replaced by \ref NvMediaISCCheckLink
 * - Updated NvMediaISCCheckLink to have one more argument to specify which link
 *   to enable as optional.
 * - Renamed ISC_ROOT_DEVICE_CFG_EX to ISC_SLV_RDEV_CFG
 * - Renamed ISC_ROOT_DEVICE_CFG to ISC_RDEV_CFG
 * - Deprecated parentDevice, instanceNumber from NvMediaISCDeviceCreate
 * - Deprecated NvMediaISCGetSensorProperties, replaced by \ref NvMediaISCGetSensorAttr
 *
 * <b> Version 2.1 </b> May 12, 2017
 * - Added \ref NvMediaISCGetVersion API to get the version of NvMedia ISC library
 * - NvMediaISCCheckVersion is deprecated. Use NvMediaISCGetVersion() instead
 *
 * <b> Version 2.2 </b> May 23, 2017
 * - Deprecated NvMediaISCSensorMode
 * - Deprecated mode & exposureMidpointTime from \ref NvMediaISCEmbeddedData
 * - Deprecated sensorMode & hdrRatio from \ref NvMediaISCExposureControl
 * - Replaced exposure in \ref NvMediaISCEmbeddedData with \ref NvMediaISCExposureControl
 * - Replaced wbGains in \ref NvMediaISCEmbeddedData with \ref NvMediaISCWBGainControl
 *
 * <b> Version 2.3 </b> May 26, 2017
 * - Add device list for ISC handle creation
 *
 * <b> Version 2.4 </b> Feb 26, 2018
 * - Add ISC_RDEV_CFG_EX to have an option to disable power control in \ref NvMediaISCRootDeviceCreate
 *
 * <b> Version 2.5 </b> April 30, 2018
 * - Add sensor characterization attributes \ref NvMediaISCSensorCharAttr
 * - Add new APIs \ref NvMediaISCSetCharacterizationAttr \ref NvMediaISCGetCharacterizationAttr
 *
 * <b> Version 2.6 </b> September 24, 2018
 * - Added \ref NvMediaISCExposure \ref NvMediaISCWhiteBalance
 *   \ref NvMediaISCCRC \ref NvMediaISCFrameSeqNum \ref NvMediaISCFrameReport
 *   \ref NvMediaISCPWL and \ref NvMediaISCTemperature
 * - Added \ref NvMediaISCSensorControl \ref NvMediaISCEmbeddedDataChunk
 *   \ref NvMediaISCEmbeddedDataInfo and \ref NvMediaISCSensorAttributes
 * - Add new APIs \ref NvMediaISCGetSensorAttributes \ref NvMediaISCParseEmbedDataInfo
 *   \ref NvMediaISCSetSensorControls \ref NvMediaISCSetSensorCharMode
 *
 * <b> Version 2.7 </b> Dec 29, 2018
 * - Add new APIs \r NvMediaISCWaitForError \ref NvMediaISCAbortWaitForError
 *
 * <b> Version 2.8 </b> Feb 25, 2019
 * - Remove NvMediaISCRootDeviceRegisterCallback API
 *
 * <b> Version 2.9 </b> March 25, 2019
 * - Remove NvMediaISCSetExposure, NvMediaISCSetBracketedExposure,
 *   NvMediaISCSetWBGain, NvMediaISCSetCompandingCurve,NvMediaISCGetSensorFrameId,
 *   NvMediaISCGetTemperature, NvMediaISCParseEmbeddedData, NvMediaISCGetSensorAttr,
 *   NvMediaISCSetCharacterizationAttr, NvMediaISCGetCharacterizationAttr
 *
 * <b> Version 3.0 </b> April 3, 2019
 * - Remove NvMediaISCTransactionHandle, NvMediaISCDriverHandle and NvMediaISCSupportFunctions
 * - Change all ISC APIs to use only NvMediaISCDevice handle
 * - Add NvMediaISCDeviceRead and NvMediaISCDeviceWrite
 * - Add support for per device simulator mode
 * - Change lineData member type in \ref NvMediaISCEmbeddedDataChunk to 'const uint8_t *'
 * - Change sensorCFA member type in \ref NvMediaISCSensorAttributes to 'uint32_t'
 * - Remove the following members from NvMediaISCDeviceDriver
 *    CheckPresence
 *    SetDeviceConfig
 *    ReadRegister
 *    WriteRegister
 *    WriteParameters
 *    ReadParameters
 *    DumpRegisters
 *    GetErrorStatus
 *    CheckLink
 * - Remove the following APIs
 *    NvMediaISCCheckPresence
 *    NvMediaISCCheckLink
 *    NvMediaISCSetDefaults
 *    NvMediaISCSetDeviceConfig
 *    NvMediaISCReadParameters
 *    NvMediaISCWriteParameters
 *    NvMediaISCGetErrorStatus
 *    NvMediaISCReadRegister
 *    NvMediaISCWriteRegister
 *    NvMediaISCDumpRegisters
 *
 * <b> Version 3.1 </b> April 22, 2019
 * - Move below structures to non-safety
 *    NvMediaISCVersionInfo
 *    NvMediaISCModuleConfig
 *    NvMediaISCExposureControl
 *    NvMediaISCWBGainControl
 *    NvMediaISCEmbeddedDataBuffer
 *    NvMediaISCEmbeddedData
 * - Move below enums to non-safety
 *    NvMediaISCPowerItems
 *    NvMediaISCExposureMode
 *    NvMediaISCSensorAttrType
 * - Move the following members of NvMediaISCDeviceDriver to non-safety
 *    GetModuleConfig
 *    SetSensorCharMode
 * - Move the following APIs to non-safety
 *    NvMediaISCGetVersionInfo
 *    NvMediaISCGetVersion
 *    NvMediaISCRootDevicePowerControl
 *    NvMediaISCRootDeviceGetPowerStatus
 *    NvMediaISCRootDeviceEnableSync
 *    NvMediaISCRootDeviceSetSyncConfig
 *    NvMediaISCRootDeviceGetSyncConfig
 *    NvMediaISCSetSensorCharMode
 *    NvMediaISCGetModuleConfig
 *
 * <b> Version 3.2 </b> July 22, 2019
 * - Remove NvMediaISCVersionInfo and NvMediaISCGetVersionInfo
 */
 
#ifdef __cplusplus
};     /* extern "C" */
#endif
 
#endif /* _NVMEDIA_ISC_H */