This document provides an overview of the Camera Middleware.
The Camera Middleware serves as an intermediary layer between camera sensor drivers and user applications. It provides a streamlined interface for initializing sensors, configuring camera pipelines, and managing data streaming. This middleware simplifies the development process for applications that require camera functionality by abstracting hardware-specific details.
cmw_camera_conf_template.h must be copied in user application as cmw_camera_conf.h with optional configuration update.
- Sensor Initialization: Developers can initialize a sensor with a single API call, simplifying the setup process.
- Camera Characteristic Configuration: Allows for the configuration of camera parameters such as brightness and saturation.
- Dynamic Configuration: The middleware supports on-the-fly reconfiguration of the DCMIPP to change settings without restarting the application.
- Automatic Sensor Detection: Proposes a mechanism for dynamic sensor detection, potentially with a default streaming configuration.
- Camera Pipeline Helpers: Provides simple APIs to assist in configuring the DCMIPP pipeline, such as setting resolution.
- Multiple Camera Support: Addresses the possibility of supporting multiple cameras, detailing configurations for different scenarios.
- Sensor Capabilities Retrieval: Enables applications to query the capabilities of the connected sensor.
- ISP Configuration Management: The middleware assumes control of ISP
Sensor drivers facilitate communication between the Camera Middleware and the physical camera sensors. The following camera modules are currently supported:
- MB1854B IMX335 (Default)
- ST VD66GY Camera module
- ST VD55G1 Camera module
typedef struct {
/* Camera settings */
uint32_t width;
uint32_t height;
int fps;
uint32_t pixel_format;
int anti_flicker;
int mirror_flip;
} CMW_CameraInit_t;int32_t CMW_CAMERA_Init( CMW_InitConf_t init_conf );
int32_t CMW_CAMERA_DeInit();int32_t CMW_CAMERA_GetSensorName(CMW_Sensor_Name_t *sensorName);The framework enables an easy to use API to configure the resizing of your camera images
typedef struct {
/* pipe output settings */
uint32_t output_width;
uint32_t output_height;
int output_format;
int output_bpp;
int enable_swap;
int enable_gamma_conversion;
/*Output buffer of the pipe*/
int mode;
/* You must fill manual_conf when mode is CMW_Aspect_ratio_manual_roi */
CMW_Manual_roi_area_t manual_conf;
} CMW_DCMIPP_Conf_t;int32_t CMW_CAMERA_SetPipeConfig(uint32_t Pipe, DCMIPP_Conf_t *p_conf)int32_t CMW_CAMERA_GetdcmippInstance(handler *)/**
* @brief Starts the camera capture in the selected mode.
* @param pipe DCMIPP Pipe
* @param pbuff pointer to the camera output buffer
* @param mode CMW_MODE_CONTINUOUS or CMW_MODE_SNAPSHOT
* @retval CMW status
*/
int32_t CMW_CAMERA_Start(uint32_t pipe, uint8_t *pbuff, uint32_t Mode);
int32_t CMW_CAMERA_DoubleBufferStart(uint32_t pipe, uint8_t *pbuff1, uint8_t *pbuff2, uint32_t Mode);/**
* @brief Suspend the CAMERA capture on selected pipe
* @param pipe Dcmipp pipe.
* @retval CMW status
*/
int32_t CMW_CAMERA_Suspend(uint32_t pipe);/**
* @brief Resume the CAMERA capture on selected pipe
* @param pipe Dcmipp pipe.
* @retval CMW status
*/
int32_t CMW_CAMERA_Resume(uint32_t pipe);Those APIs is not available for every sensors
int CMW_CAMERA_SetAntiFlickerMode(int flicker_mode);
int CMW_CAMERA_GetAntiFlickerMode(int *flicker_mode);
int CMW_CAMERA_SetBrightness(int Brightness);
int CMW_CAMERA_GetBrightness(int *Brightness);
int CMW_CAMERA_SetContrast(int Contrast);
int CMW_CAMERA_GetContrast(int *Contrast);
int CMW_CAMERA_SetGain(int32_t Gain);
int CMW_CAMERA_GetGain(int32_t *Gain);
int CMW_CAMERA_SetExposure(int32_t exposure);
int CMW_CAMERA_GetExposure(int32_t *exposure);
int CMW_CAMERA_SetMirrorFlip(int MirrorFlip);
int CMW_CAMERA_GetMirrorFlip(int *MirrorFlip);HAL_StatusTypeDef MX_DCMIPP_Init(DCMIPP_HandleTypeDef *hdcmipp, uint32_t Instance); int CMW_CAMERA_PIPE_FrameEventCallback(uint32_t pipe);
int CMW_CAMERA_PIPE_VsyncEventCallback(uint32_t pipe);#define CAMERA_SENSOR_INFO_MAX_LENGTH (32U)
typedef struct
{
char name[CAMERA_SENSOR_INFO_MAX_LENGTH];
uint8_t bayer_pattern;
uint8_t color_depth;
uint32_t width;
uint32_t height;
uint32_t gain_min; /* in mdB*/
uint32_t gain_max; /* in mdB*/
uint32_t exposure_min; /* in us */
uint32_t exposure_max; /* in us */
} CAMERA_SensorInfo_t;
typedef struct
{
uint32_t width;
uint32_t height;
int fps;
uint32_t pixel_format;
uint32_t mirrorFlip;
} CMW_Sensor_Init_t;
typedef struct
{
int32_t (*Init)(void *, CMW_Sensor_Init_t *);
int32_t (*DeInit)(void *);
int32_t (*Start)(void *);
int32_t (*Run)(void *);
void (*VsyncEventCallback)(void *, uint32_t);
void (*FrameEventCallback)(void *, uint32_t);
int32_t (*Stop)(void *);
int32_t (*ReadID)(void *, uint32_t *);
int32_t (*SetBrightness)(void *, int32_t);
int32_t (*SetSaturation)(void *, int32_t);
int32_t (*SetContrast)(void *, int32_t);
int32_t (*SetMirrorFlip)(void *, uint32_t);
int32_t (*SetResolution)(void *, uint32_t);
int32_t (*GetResolution)(void *, uint32_t *);
int32_t (*SetPixelFormat)(void *, uint32_t);
int32_t (*GetPixelFormat)(void *, uint32_t *);
int32_t (*SetFrequency)(void *, int32_t);
int32_t (*SetFramerate)(void*, int32_t);
int32_t (*SetGain)(void *, int32_t);
int32_t (*SetExposure)(void *, int32_t);
int32_t (*SetExposureMode)(void *, int32_t);
int32_t (*SetFlickerMode)(void *, int32_t);
int32_t (*GetSensorInfo)(void *, ISP_SensorInfoTypeDef *);
int32_t (*SetTestPattern)(void *, int32_t);
} CMW_Sensor_if_t;