nvmedia_icp.h

Go to the documentation of this file.

/*
 * Copyright (c) 2014-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_ICP_H
#define NVMEDIA_ICP_H
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
#include "nvmedia_core.h"
#include "nvmedia_surface.h"
#include "nvmedia_image.h"
 
#define NVMEDIA_ICP_VERSION_MAJOR   4
 
#define NVMEDIA_ICP_VERSION_MINOR   22
 
#define NVMEDIA_IMAGE_CAPTURE_TIMEOUT_INFINITE  0xFFFFFFFFu
 
#define NVMEDIA_ICP_MAX_VIRTUAL_GROUPS     4u
 
#define NVMEDIA_ICP_MAX_VIRTUAL_CHANNELS   3u
 
#define NVMEDIA_ICP_HANDLER(icpEx, groupIdx) (icpEx->icp[groupIdx].hIcp)
 
#define NVMEDIA_ICP_SETTINGS_HANDLER(icpSettingsEx, groupIdx, vcIdx) \
        (&icpSettingsEx.virtualGroups[groupIdx].virtualChannels[vcIdx].icpSettings)
 
#define NVMEDIA_ICP_ERROR(_type_, _error_, _value_, _desc_)   \
        NVMEDIA_ICP_##_type_##_ERROR_##_error_ = _value_##u,
 
#define NVMEDIA_MAX_ICP_FRAME_BUFFERS   32u
 
#define NVMEDIA_ICP_MIN_IMAGE_WIDTH       640u
 
#define NVMEDIA_ICP_MAX_IMAGE_WIDTH       3848u
 
#define NVMEDIA_ICP_MIN_IMAGE_HEIGHT      480u
 
#define NVMEDIA_ICP_MAX_IMAGE_HEIGHT      2168u
 
#define NVMEDIA_ICP_MIN_FRAME_RATE        10U
 
#define NVMEDIA_ICP_MAX_FRAME_RATE        60U
 
#if (NV_IS_SAFETY == 1)
 
#define NVMEDIA_ICP_MAX_EMBEDDED_LINES    28u
 
#define NVMEDIA_ICP_PIXEL_FREQUENCY        0U
 
#define NVMEDIA_ICP_THS_SETTLE_TIME        0U
#else
 
#define NVMEDIA_ICP_MAX_EMBEDDED_LINES    256u
 
#endif /* NV_IS_SAFETY */
 
typedef enum {
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_A,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_B,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_AB,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_C,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_D,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_CD,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_E,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_F,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_EF,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_G,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_H,
    NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_CSI_GH,
} NvMediaICPInterfaceType;
 
typedef enum {
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_YUV422,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_YUV422_10,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_YUV444,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RGB888,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW6,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW7,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW8,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW10,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW12,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW14,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW16,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW20,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_1,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_2,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_3,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_4,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_5,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_6,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_7,
    NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER_DEFINED_8
} NvMediaICPInputFormatType;
 
typedef enum {
    NVMEDIA_BITS_PER_PIXEL_8 = 0,
    NVMEDIA_BITS_PER_PIXEL_10,
    NVMEDIA_BITS_PER_PIXEL_12,
    NVMEDIA_BITS_PER_PIXEL_14,
    NVMEDIA_BITS_PER_PIXEL_16,
    NVMEDIA_BITS_PER_PIXEL_20
} NvMediaBitsPerPixel;
 
typedef struct {
    NvMediaICPInputFormatType inputFormatType;
    NvMediaBitsPerPixel bitsPerPixel;
} NvMediaICPInputFormat;
 
#if (NV_IS_SAFETY == 1)
 
typedef enum {
    NVMEDIA_ICP_CSI_MIPISPEED_297000 = 297000,
    NVMEDIA_ICP_CSI_MIPISPEED_633000 = 633000,
    NVMEDIA_ICP_CSI_MIPISPEED_800000 = 800000,
    NVMEDIA_ICP_CSI_MIPISPEED_1700000 = 1700000
} NvMediaICPCsiMipiSpeed;
#endif /* NV_IS_SAFETY */
 
typedef enum {
    NVMEDIA_ICP_CSI_DPHY_MODE = 0,
    NVMEDIA_ICP_CSI_CPHY_MODE
} NvMediaICPCsiPhyMode;
 
typedef struct {
    NvMediaICPInterfaceType interfaceType;
    NvMediaICPInputFormat inputFormat;
    NvMediaSurfaceType surfaceType;
    uint16_t width;
    uint16_t height;
    uint16_t startX;
    uint16_t startY;
    uint16_t embeddedDataLines;
    uint32_t interfaceLanes;
    uint32_t pixelFrequency;
    uint32_t mipiSpeed;
    uint16_t thsSettle;
    NvMediaBool embeddedDataType;
    uint8_t tpgEnable;
    NvMediaICPCsiPhyMode phyMode;
    uint32_t frameRate;
} NvMediaICPSettings;
 
typedef struct {
    NvMediaICPInterfaceType interfaceType;
    uint32_t interfaceLanes;
    struct {
        struct {
            /* Holds the virtual Channel Index from CSI TX. */
            uint16_t virtualChannelIndex;
            /* Holds the image capture settings for CSI format. */
            NvMediaICPSettings icpSettings;
            NvMediaRect clipRect;
            NvMediaBool disablePFSD;
        } virtualChannels[NVMEDIA_ICP_MAX_VIRTUAL_CHANNELS];
        uint16_t numVirtualChannels;
    } virtualGroups[NVMEDIA_ICP_MAX_VIRTUAL_GROUPS];
    uint16_t numVirtualGroups;
    NvMediaICPCsiPhyMode phyMode;
} NvMediaICPSettingsEx;
 
typedef struct NvMediaICP NvMediaICP;
 
typedef struct {
    uint16_t numVirtualGroups;
    struct {
        uint16_t virtualGroupId;
        NvMediaICP *hIcp;
    } icp[NVMEDIA_ICP_MAX_VIRTUAL_GROUPS];
} NvMediaICPEx;
 
typedef enum {
    NVMEDIA_ICP_ERROR_STATUS_NONE,
    NVMEDIA_ICP_ERROR_STATUS_CSI_INPUTFRAME,
    NVMEDIA_ICP_ERROR_STATUS_CSI_INPUTSTREAM,
    NVMEDIA_ICP_ERROR_STATUS_PIXEL_FAULT,
    NVMEDIA_ICP_ERROR_STATUS_FRAME_FAULT,
    NVMEDIA_ICP_ERROR_STATUS_MEMORYWRITE
} NvMediaICPErrorStatus;
 
typedef enum {
    /* Multiple Error Bits may be set accompanying a CsiInputFrameError */
    NVMEDIA_ICP_ERROR(CSI, FE_CSI_FAULT,          6,  "A NVCSI fault received at frame end")
    NVMEDIA_ICP_ERROR(CSI, FS_FAULT,              7,  "A frame start occurred before previous frame end")
    NVMEDIA_ICP_ERROR(CSI, FE_FORCED_FAULT,       8,  "A frame end was injected by the CSI hardware")
    NVMEDIA_ICP_ERROR(CSI, FE_FRAMEID_FAULT,      9,  "Frame ID for FE packet does not match that of FS packet")
    NVMEDIA_ICP_ERROR(CSI, PXL_ENABLE_FAULT ,     10, "An illegal pixel encoding has been detected")
    NVMEDIA_ICP_ERROR(CSI, PP_FSM_TIMEOUT,        20, "Pixel Parser FSM timeout")
    NVMEDIA_ICP_ERROR(CSI, PH_ECC_DPHY,           21, "Single bit error correction code in DPHY packet header")
    NVMEDIA_ICP_ERROR(CSI, PAYLOAD_CRC,           22, "Packet Payload CRC check fail error")
    NVMEDIA_ICP_ERROR(CSI, LINE_SHORT,            23, "Packet Payload is less than word count in packet header")
    NVMEDIA_ICP_ERROR(CSI, PH_CRC_CPHY,           24, "One of the CPHY packet headers CRC error")
    NVMEDIA_ICP_ERROR(CSI, EMB_CRC,               25, "Embedded line CRC error")
} NvMediaICPCsiInputFrameError;
 
typedef enum {
    /* CSI Stream Errors */
    NVMEDIA_ICP_ERROR(CSI, SPURIOUS_DATA,         0,  "FIFO data was found in the gap between frame start and frame end")
    NVMEDIA_ICP_ERROR(CSI, FIFO_OVERFLOW,         1,  "An overflow occurred in a stream FIFO")
    NVMEDIA_ICP_ERROR(CSI, FIFO_LOF,              2,  "A loss of frame overflow occurred")
    NVMEDIA_ICP_ERROR(CSI, FIFO_BADPKT,           3,  "An unknown packet type has been received on a stream")
} NvMediaICPCsiInputStreamError;
 
typedef enum {
    /* VI Channel Sel faults from engine status */
    NVMEDIA_ICP_ERROR(VI, FS_TIMEOUT,             0,  "Frame Start Timeout Error")
    NVMEDIA_ICP_ERROR(VI, FE_TIMEOUT,             1,  "Frame End Timeout Error")
    NVMEDIA_ICP_ERROR(VI, PXL_MISSING_LE,         5,  "Two LS packets were detected without a LE packet between them")
    NVMEDIA_ICP_ERROR(VI, PXL_RUNAWAY,            6,  "More lines were received than expected")
    NVMEDIA_ICP_ERROR(VI, PXL_SPURIOUS,           7,  "A pixel data packet was received without a LS packet first")
    NVMEDIA_ICP_ERROR(VI, PXL_LONG_LINE,          8,  "More pixels were received than expected in a line")
    NVMEDIA_ICP_ERROR(VI, PXL_SHORT_LINE,         9,  "Fewer pixels were received than expected in a line")
    NVMEDIA_ICP_ERROR(VI, EMB_MISSING_LE,         10, "Two LS packets were detected without a LE packet between them in emb data")
    NVMEDIA_ICP_ERROR(VI, EMB_RUNAWAY,            11, "More lines were received than expected in emb data")
    NVMEDIA_ICP_ERROR(VI, EMB_SPURIOUS,           12, "A pixel data packet was received without a LS packet first in emb data")
    NVMEDIA_ICP_ERROR(VI, EMB_LONG_LINE,          13, "More pixels were received than expected in a line in emb data")
    NVMEDIA_ICP_ERROR(VI, EMB_INFRINGE,           14, "Embedded data was received on a frame where no embedded data was expected")
    NVMEDIA_ICP_ERROR(VI, DTYPE_MISMATCH,         15, "The pixel datatype changed in the middle of the line")
    NVMEDIA_ICP_ERROR(VI, FORCED_FE,              16, "FE didn't arrive within expected frame duration, capture engine injected FE")
    NVMEDIA_ICP_ERROR(VI, PXL_INCOMPLETE,         17, "Fewer lines of pixels in a frame were received than expected")
    NVMEDIA_ICP_ERROR(VI, EMB_INCOMPLETE,         18, "Fewer lines of emb data in a frame were received than expected")
    NVMEDIA_ICP_ERROR(VI, PFSD_FAULT,             19, "Permanent Fault Software Diagnostic is detected from engine status")
} NvMediaICPPixelFaultError;
 
typedef enum {
    /* VI Channel Frame faults */
    NVMEDIA_ICP_ERROR(VI, SHORT_FRAME,            0, "FE packet arrived before the normal number of pixels has appeared ")
    NVMEDIA_ICP_ERROR(VI, SHORT_EMB,              1, "FE of EMB Data packet arrived before the normal number of pixels has appeared ")
    NVMEDIA_ICP_ERROR(VI, PFSD_FAULT_NOTIFED,     2, "Permanent Fault Software Diagnostic is detected between frames")
    NVMEDIA_ICP_ERROR(VI, FAULT_FE,               3, "FE is inserted due to a stream reset or early abort")
    NVMEDIA_ICP_ERROR(VI, NOMATCH,                4, "CSI packets are discarded due to no matched capture channels")
    NVMEDIA_ICP_ERROR(VI, COLLISION,              5, "An FS packet matches a channel which is not done processing a previously matching frame")
    NVMEDIA_ICP_ERROR(VI, LOAD_FRAMED,            6, "A LOAD command is received for a channel while that channel is currently in a frame")
} NvMediaICPFrameFaultError;
 
typedef enum {
    /* Errors while outputing data to memory */
    NVMEDIA_ICP_ERROR(VI, PACKET_OVERFLOW,        0, "The FIFO for a surface packer has overflowed")
    NVMEDIA_ICP_ERROR(VI, FRAME_TRUNCATED,        1, "A packer has dropped a partial frame")
    NVMEDIA_ICP_ERROR(VI, FRAME_TOSSED,           2, "A packer has dropped an entire frame")
} NvMediaICPMemoryWriteError;
 
typedef struct {
    uint32_t csiStreamId;
    uint32_t csiFrameId;
    uint32_t virtualChannelId;
    NvMediaICPErrorStatus errorStatus;
    uint32_t errorData;
    uint32_t notifiedErrors[NVMEDIA_ICP_ERROR_STATUS_MEMORYWRITE + 1u];
} NvMediaICPErrorInfo;
 
NvMediaStatus
NvMediaICPGetVersion(
    NvMediaVersion *version
);
 
NvMediaICPEx *
NvMediaICPCreateEx(
    NvMediaICPSettingsEx *settings
);
 
void
NvMediaICPDestroyEx(
    NvMediaICPEx *icpEx
);
 
NvMediaStatus
NvMediaICPRegisterImageGroup(
    const NvMediaICP            *icp,
    const NvMediaImageGroup     *imageGrp
);
 
NvMediaStatus
NvMediaICPFeedImageGroup(
    const NvMediaICP     *icp,
    NvMediaImageGroup    *imageGrp,
    uint32_t             millisecondTimeout
);
 
NvMediaStatus
NvMediaICPGetImageGroup(
    const NvMediaICP    *icp,
    uint32_t            millisecondTimeout,
    NvMediaImageGroup   **imageGrp
);
 
NvMediaStatus
NvMediaICPUnregisterImageGroup(
    const NvMediaICP          *icp,
    const NvMediaImageGroup   *imageGrp
);
 
NvMediaStatus
NvMediaICPGetErrorInfo(
    const NvMediaICP        *icp,
    NvMediaICPErrorInfo     *icpErrorInfo
);
 
#if (NV_IS_SAFETY == 0)
 
NvMediaStatus
NvMediaICPReleaseImageGroup(
    const NvMediaICP    *icp,
    NvMediaImageGroup   **imageGrp
)NVM_DEPRECATED_MSG("Use NvMediaICPGetImageGroup");;
#endif /* NV_IS_SAFETY */
 
/*
 * \defgroup history_nvmedia_icp History
 * Provides change history for the NvMedia ICP API.
 *
 * \section history_nvmedia_icp Version History
 *
 * <b> Version 2.0 </b> April 4, 2016
 * - Initial release
 *
 * <b> Version 2.1 </b> May 11, 2016
 * - Added \ref NvMediaICPCheckVersion API
 *
 * <b> Version 2.2 </b> August 17, 2016
 * - Added \ref NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_UYVY image capture input
 * format type
 *
 * <b> Version 2.3 </b> August 31, 2016
 * - Added option for enabling embeddedDataType in \ref NvMediaICPSettings
 *
 * <b> Version 2.4 </b> Jan 23, 2017
 * - Added \ref NvMediaICPErrorInfo and \ref NvMediaICPGetErrorInfo
 *
 * <b> Version 2.5 </b> March 16, 2017
 * - Added \ref NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_USER ,
 * \ref NvMediaICPUserFormatType and option for enabling userFormatType in
 * \ref NvMediaICPInputFormat
 *
 * <b> Version 3.0 </b> April 19, 2017
 * Updated to use stdint.h instead of "unsigned int",
 *   "int", "unsigned short" and "char".
 * NvMediaICPCreate and NvMediaICPDestroy are now deprecated.
 * NvMediaICPGetFrame is now deprecated.
 * NvMediaICPInterfaceFormat is now deprecated, it will be always CSI.
 *
 * <b> Version 3.1 </b> May 12, 2017
 * - Added \ref NvMediaICPGetVersion API to get the version of NvMedia ICP library
 * - NvMediaICPCheckVersion is deprecated. Use NvMediaICPGetVersion() instead
 *
 * <b> Version 3.2 </b> May 19, 2017
 * Removed \ref NvMediaICPSurfaceFormatType
 * NvMediaICPSettings now takes NvMediaSurfaceType to indicate capture surface format
 * Removed NVMEDIA_IMAGE_CAPTURE_CSI_INTERFACE_TYPE_TPG0
 * Combined NvMediaICPUserFormatType with NvMediaICPInputFormatType
 * Removed NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_YUV420
 *   from \ref NvMediaICPInputFormatType
 * Added RAW6/RAW7/RAW8/RAW10/RAW12/RAW14 in NvMediaICPInputFormatType
 * Removed pixelOrder from \ref NvMediaICPInputFormat
 * Added tpgEnagle in \ref NvMediaICPSettings
 *
 * <b> Version 4.2 </b> June 12, 2017
 * Added virtualGroupIndex inside \ref NvMediaICPSettingsEx
 * Renamed virtualChannel to virtualGroup inside \ref NvMediaICPEx
 * Added \ref NvMediaICPFeedImageGroup and \ref NvMediaICPGetImageGroup APIs
 *
 * <b> Version 4.3 </b> October 5, 2017
 * - Added \ref NvMediaICPResume API
 *
 * <b> Version 4.4 </b> October 11, 2017
 * Changed the prototypes for \ref NvMediaICPGetImageGroup and
 * \ref NvMediaICPReleaseImageGroup to accept double pointer to imageGrp
 *
 * <b> Version 4.5 </b> November 10, 2017
 * Added YUV422_10, RAW16, RAW20 support in \ref NvMediaICPInputFormatType
 * \ref NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_YUV422_10,
 * \ref NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW16,
 * \ref NVMEDIA_IMAGE_CAPTURE_INPUT_FORMAT_TYPE_RAW20
 *
 * <b> Version 4.6 </b> November 18, 2017
 * Added additional CSI interfaces, CSI phy mode parameter to \ref NvMediaICPSettingsEX
 *
 * <b> Version 4.7 </b> March 16, 2018
 * Added mipiSpeed in \ref NvMediaICPSettings
 *
 * <b> Version 4.8 </b> September 12, 2018
 * Added NvMediaICPWaitForSoF in \ref NvMediaICPWaitForSoF
 *
 * <b> Version 4.9 </b> March 7, 2019
 * Added detailed capture error errorData in \ref NvMediaICPErrorInfo
 * Refactor \ref NvMediaICPErrorStatus to group capture errors
 *
 * <b> Version 4.10 </b> March 10, 2019
 * Added NvMediaICPRegisterImageGroup in \ref NvMediaICPRegisterImageGroup
 * Added NvMediaICPUnregisterImageGroup in \ref NvMediaICPUnregisterImageGroup
 *
 * <b> Version 4.11 </b> March 18, 2019
 * Deprecated API's- NvMediaICPFeedFrame, NvMediaICPGetFrameEx and NvMediaICPReleaseFrame
 * Instead NvMediaICPFeedImageGroup,NvMediaICPGetImageGroup and NvMediaICPReleaseImageGroup
 * should be used
 *
 * <b> Version 4.12 </b> March 25, 2019
 * Added \ref NvMediaICPCSIErrorType Enum
 * Added csiErrorMask, csiErrorType to \ref NvMediaICPSettings
 *
 * <b> Version 4.13 </b> March 27, 2019
 * Added notifiedErrors in \ref NvMediaICPErrorInfo and disablePFSD \ref NvMediaICPSettingsEx.
 *
 * <b> Version 4.14 </b> April 2, 2019
 * Changed \ref NvMediaICP type from void to struct.
 *
 * <b> Version 4.15 </b> April 4, 2019
 * Add \ref NvMediaBitsPerPixel, NVMEDIA_MAX_ICP_FRAME_BUFFERS
 *
 * <b> Version 4.16 </b> April 10, 2019
 * Added deprecated warning message for \ref NvMediaICPWaitForSoF.
 *
 * <b> Version 4.17 </b> May 22, 2019
 * Remove deprecated NvMediaICPWaitForSoF
 *
 * <b> Version 4.18 </b> July 12, 2019
 * removed NvMediaICPCSIErrorType Enum
 * removed csiErrorMask, csiErrorType from \ref NvMediaICPSettings
 * removed NVMEDIA_ICP_ERROR_STATUS_FATAL from \ref NvMediaICPErrorStatus
 *
 * <b> Version 4.19 </b> July 18, 2019
 * Remove NvMediaICPStop and NvMediaICPResume
 *
 * <b> Version 4.20 </b> October 21, 2019
 * Added the const keyword to appropriate pointer parameters for the following:
 * - \ref NvMediaICPRegisterImageGroup
 * - \ref NvMediaICPFeedImageGroup
 * - \ref NvMediaICPGetImageGroup
 * - \ref NvMediaICPUnregisterImageGroup
 * - \ref NvMediaICPReleaseImageGroup
 * - \ref NvMediaICPGetErrorInfo
 * Added comments for the following values of \ref NvMediaStatus:
 * - \ref NVMEDIA_STATUS_NOT_SUPPORTED
 * - \ref NVMEDIA_STATUS_NOT_INITIALIZED
 *
 * <b> Version 4.21 </b> November 20, 2019
 * NvMediaICPReleaseImageGroup() is removed from safety build and deprecated in non-safety build.
 * Use NvMediaICPGetImageGroup() instead
 *
 * <b> Version 4.22 </b> January 22, 2020
 * Add NVMEDIA_ICP_MIN_FRAME_RATE and NVMEDIA_ICP_MAX_FRAME_RATE in safety build.
 * Remove the return value NVMEDIA_STATUS_NOT_INITIALIZED for some functions
 *
 */
#ifdef __cplusplus
};     /* extern "C" */
#endif /* __cplusplus */
 
#endif /* NVMEDIA_ICP_H */