nvmedia_isc.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2019, 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 */