Camera.h

Go to the documentation of this file.

//
// Notice
// ALL NVIDIA DESIGN SPECIFICATIONS AND CODE ("MATERIALS") ARE PROVIDED "AS IS" NVIDIA MAKES
// NO REPRESENTATIONS, WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
// THE MATERIALS, AND EXPRESSLY DISCLAIMS ANY IMPLIED WARRANTIES OF NONINFRINGEMENT,
// MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
//
// NVIDIA CORPORATION & AFFILIATES assumes no responsibility for the consequences of use of such
// information or for any infringement of patents or other rights of third parties that may
// result from its use. No license is granted by implication or otherwise under any patent
// or patent rights of NVIDIA CORPORATION & AFFILIATES. No third party distribution is allowed unless
// expressly authorized by NVIDIA. Details are subject to change without notice.
// This code supersedes and replaces all information previously supplied.
// NVIDIA CORPORATION & AFFILIATES products are not authorized for use as critical
// components in life support devices or systems without express written approval of
// NVIDIA CORPORATION & AFFILIATES.
//
// SPDX-FileCopyrightText: Copyright (c) 2016-2021 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: LicenseRef-NvidiaProprietary
//
// NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
// property and proprietary rights in and to this material, related
// documentation and any modifications thereto. Any use, reproduction,
// disclosure or distribution of this material and related documentation
// without an express license agreement from NVIDIA CORPORATION or
// its affiliates is strictly prohibited.
//

#ifndef DW_SENSORS_CAMERA_CAMERA_H_
#define DW_SENSORS_CAMERA_CAMERA_H_

#include <dw/core/Config.h>
#include <dw/core/base/Types.h>
#include <dw/sensors/Sensors.h>
#include <dw/image/Image.h>

#include <nvscisync.h>
#include <nvscibuf.h>

// Forward declares from NvMedia
typedef void NvMediaIPPManager;

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dwCameraFrame* dwCameraFrameHandle_t;

typedef enum dwCameraOutputType {
    DW_CAMERA_OUTPUT_NATIVE_PROCESSED = 1 << 0,
    DW_CAMERA_OUTPUT_NATIVE_RAW = 1 << 1,
    DW_CAMERA_OUTPUT_CUDA_RGBA_UINT8 = 1 << 2,
    DW_CAMERA_OUTPUT_CUDA_YUV420_UINT8_PLANAR = 1 << 3,
    DW_CAMERA_OUTPUT_CUDA_RAW_UINT16 = 1 << 4,
    DW_CAMERA_OUTPUT_CUDA_YUV420_UINT16_SEMIPLANAR = 1 << 5,
    DW_CAMERA_OUTPUT_CUDA_YUV444_UINT8_PLANAR = 1 << 6,
    DW_CAMERA_OUTPUT_CUDA_YUV444_UINT16_PLANAR = 1 << 7,
    DW_CAMERA_OUTPUT_CUDA_YUV420_UINT8_SEMIPLANAR = 1 << 8,
} dwCameraOutputType;

typedef enum dwCameraRawFormat {
    DW_CAMERA_RAW_FORMAT_UNKNOWN = 0,

    DW_CAMERA_RAW_FORMAT_RGGB = 7000,
    DW_CAMERA_RAW_FORMAT_BGGR = 7100,
    DW_CAMERA_RAW_FORMAT_GRBG = 7200,
    DW_CAMERA_RAW_FORMAT_GBRG = 7300,

    DW_CAMERA_RAW_FORMAT_RCCB = 8000,
    DW_CAMERA_RAW_FORMAT_BCCR = 8100,
    DW_CAMERA_RAW_FORMAT_CRBC = 8200,
    DW_CAMERA_RAW_FORMAT_CBRC = 8300,

    DW_CAMERA_RAW_FORMAT_RCCC = 9000,
    DW_CAMERA_RAW_FORMAT_CRCC = 9100,
    DW_CAMERA_RAW_FORMAT_CCRC = 9200,
    DW_CAMERA_RAW_FORMAT_CCCR = 9300,

    DW_CAMERA_RAW_FORMAT_CCCC = 10000,

    DW_CAMERA_RAW_FORMAT_TOF = 20000
} dwCameraRawFormat;

typedef enum dwCameraType {
    DW_CAMERA_GENERIC      = 0,  
    DW_CAMERA_GMSL_AR0231  = 3,  
    DW_CAMERA_USB_GENERIC  = 4,  
    DW_CAMERA_GMSL_AR0144  = 5,  
    DW_CAMERA_GMSL_AR0138  = 6,  
    DW_CAMERA_GMSL_AR0220  = 7,  
    DW_CAMERA_GMSL_AR0820  = 8,  
    DW_CAMERA_GMSL_MN34906 = 9,  
    DW_CAMERA_GMSL_OV2311  = 10, 
    DW_CAMERA_GMSL_IMX390  = 11, 
    DW_CAMERA_GMSL_CUSTOM  = 99  
} dwCameraType;

typedef enum dwCameraExposureControl {
    DW_CAMERA_EXPOSURE_NONE,
    DW_CAMERA_EXPOSURE_UNKNOWN,
    DW_CAMERA_EXPOSURE_AE,
    DW_CAMERA_EXPOSURE_BAE,
    DW_CAMERA_EXPOSURE_CUSTOM
} dwCameraExposureControl;

typedef enum dwCameraFOV {
    DW_CAMERA_FOV_UNKNOWN = 0,
    DW_CAMERA_FOV_30      = 30,
    DW_CAMERA_FOV_48      = 48,
    DW_CAMERA_FOV_50      = 50,
    DW_CAMERA_FOV_55      = 55,
    DW_CAMERA_FOV_60      = 60,
    DW_CAMERA_FOV_65      = 65,
    DW_CAMERA_FOV_90      = 90,
    DW_CAMERA_FOV_100     = 100,
    DW_CAMERA_FOV_110     = 110,
    DW_CAMERA_FOV_120     = 120,
    DW_CAMERA_FOV_185     = 185
} dwCameraFOV;

typedef enum dwCameraSIPLInterfaceProviderType {
    DW_SIPL_CAMERA_INTERFACE_PROVIDER_TYPE_DESERIALIZER,
    DW_SIPL_CAMERA_INTERFACE_PROVIDER_TYPE_MODULE,
    DW_SIPL_CAMERA_INTERFACE_PROVIDER_TYPE_COUNT
} dwSIPLCameraInterfaceProviderType;

typedef struct dwCameraProperties
{
    dwCameraType cameraType;          
    dwCameraRawFormat rawFormat;      
    dwCameraExposureControl exposure; 
    float32_t framerate;              
    dwCameraFOV fov;                  
    dwVector2ui resolution;           
    int32_t outputTypes;              
    uint32_t siblings;                
    uint32_t revision;                
    uint32_t imageBitDepth;           
    bool isSimulated;                 
} dwCameraProperties;

typedef enum dwCameraSIPLNotificationData {
    DW_NOTIF_INFO_ICP_PROCESSING_DONE = 0,
    DW_NOTIF_INFO_ISP_PROCESSING_DONE = 1,
    DW_NOTIF_INFO_ACP_PROCESSING_DONE = 2,
    DW_NOTIF_INFO_CDI_PROCESSING_DONE = 3,
    DW_NOTIF_WARN_ICP_FRAME_DROP = 100,
    DW_NOTIF_WARN_ICP_FRAME_DISCONTINUITY = 101,
    DW_NOTIF_WARN_ICP_CAPTURE_TIMEOUT = 102,
    DW_NOTIF_ERROR_ICP_BAD_INPUT_STREAM = 200,
    DW_NOTIF_ERROR_ICP_CAPTURE_FAILURE = 201,
    DW_NOTIF_ERROR_ICP_EMB_DATA_PARSE_FAILURE = 202,
    DW_NOTIF_ERROR_ISP_PROCESSING_FAILURE = 203,
    DW_NOTIF_ERROR_ACP_PROCESSING_FAILURE = 204,
    DW_NOTIF_ERROR_CDI_SET_SENSOR_CTRL_FAILURE = 205,
    DW_NOTIF_ERROR_DESER_LINK_FAILURE = 206,
    DW_NOTIF_ERROR_DESERIALIZER_FAILURE = 207,
    DW_NOTIF_ERROR_SERIALIZER_FAILURE = 208,
    DW_NOTIF_ERROR_SENSOR_FAILURE = 209,
    DW_NOTIF_ERROR_INTERNAL_FAILURE = 300,
} dwCameraSIPLNotificationData;

#define DW_CAMERA_MAX_DEVICE_GPIOS 8U

typedef struct dwCameraNotificationData
{
    dwCameraSIPLNotificationData eNotifyType;
    uint32_t uIndex;
    uint8_t uLinkMask;
    uint64_t frameCaptureTSC;
    uint32_t gpioIdxs[DW_CAMERA_MAX_DEVICE_GPIOS];
    uint32_t numGpioIdxs;
} dwCameraNotificationData;

typedef struct dwCameraSIPLEErrorDetails
{
    uint8_t const* errorBuffer;
    size_t sizeWritten;
} dwCameraSIPLEErrorDetails;

#define DW_CAMERA_MAX_CAMERAMODULES_PER_BLOCK 4U

typedef struct dwCameraSIPLNotification
{
    dwCameraNotificationData data;

    dwCameraSIPLEErrorDetails deserializerErrorInfo;
    bool isRemoteError;
    uint8_t linkErrorMask;

    uint32_t numCameraModules;
    dwCameraSIPLEErrorDetails serializerErrorInfoList[DW_CAMERA_MAX_CAMERAMODULES_PER_BLOCK];
    dwCameraSIPLEErrorDetails sensorErrorInfoList[DW_CAMERA_MAX_CAMERAMODULES_PER_BLOCK];
} dwCameraSIPLNotification;

typedef void (*dwCameraCallback)(dwCameraSIPLNotification* notification, dwSensorHandle_t sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_readFrame(dwCameraFrameHandle_t* const frameHandle,
                                  dwTime_t const timeoutUs, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_returnFrame(dwCameraFrameHandle_t* const frameHandle);

DW_API_PUBLIC
dwStatus dwSensorCamera_getImage(dwImageHandle_t* const image, dwCameraOutputType const type,
                                 dwCameraFrameHandle_t const frame);

DW_API_PUBLIC
dwStatus dwSensorCamera_getImageAsync(dwImageHandle_t* const image, dwCameraOutputType const type,
                                      dwCameraFrameHandle_t const frame);

dwStatus dwSensorCamera_setImagePool(dwImagePool imagePool, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getNvMediaIPPManager(NvMediaIPPManager** const manager, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_appendAllocationAttributes(dwImageProperties* const imgProps,
                                                   dwCameraOutputType const outputType,
                                                   dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getSensorProperties(dwCameraProperties* const properties,
                                            dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getNumSupportedCaptureModes(uint32_t* const numModes,
                                                    dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getSupportedCaptureMode(dwCameraProperties* const captureMode,
                                                uint32_t const modeIdx,
                                                dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getImageProperties(dwImageProperties* const imageProperties,
                                           dwCameraOutputType const outputType,
                                           dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_setCUDAStream(cudaStream_t const stream, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getCUDAStream(cudaStream_t* const stream, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getTimestamp(dwTime_t* const timestamp, dwCameraFrameHandle_t const frameHandle);

DW_API_PUBLIC
dwStatus dwSensorCamera_getSIPLInterfaceProvider(void** const interfaceProvider, dwSensorHandle_t const sensor, dwSIPLCameraInterfaceProviderType const type);

DW_API_PUBLIC
dwStatus dwSensorCamera_readEEPROM(uint32_t const paramId, void* const buffer, uint32_t const size, dwSensorHandle_t const sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_getEOFFence(NvSciSyncFence* syncFence, dwCameraOutputType outputType, dwCameraFrameHandle_t const frameHandle);

DW_API_PUBLIC
dwStatus dwSensorCamera_fillSyncAttributes(NvSciSyncAttrList syncAttrList, dwCameraOutputType outputType, dwSensorHandle_t sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_setSyncObject(NvSciSyncObj syncObj, dwCameraOutputType outputType, dwSensorHandle_t sensor);

DW_API_PUBLIC
dwStatus dwSensorCamera_setEventCallback(dwCameraCallback blkCallback, dwCameraCallback lineCallback, dwSensorHandle_t sensor);

DW_API_PUBLIC
DW_DEPRECATED("This API is deprecated and will be removed in the next major release, please use dwSensor_stop/dwSensor_reset per use case")
dwStatus dwSensorCamera_disableLink(dwSensorHandle_t const sensor);

DW_API_PUBLIC
DW_DEPRECATED("This API is deprecated and will be removed in the next major release, please use dwSensor_start/dwSensor_reset per use case")
dwStatus dwSensorCamera_enableLink(dwSensorHandle_t const sensor, bool const resetModule);

#ifdef __cplusplus
}
#endif

#endif // DW_SENSORS_CAMERA_CAMERA_H_