v1.4.2

- Update Isp library to v1.1.0
- Add support for white balance mode listing
- Add support for manual white balance ref mod
- Fix bug CMW_CAMERA_DeInit

Author: GHORTESSTM

Release_Notes.html

@@ -0,0 +1,44 @@
+# Release Notes for STM32 Camera Middleware
+
+## Purpose
+
+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.
+
+## Key Features
+
+- Support for the STM32N6570-DK board only
+- Support for the following cameras:
+  - MB1854B IMX335 Camera module
+  - ST VD66GY Camera module
+  - ST VD55G1 Camera module
+- Use ISP Library for ST VD66GY.
+- Use ISP Library for IMX335.
+- Enable APIs to Init and Start camera pipelines with CSI-DCMIPP.
+
+## Software components
+
+| Name           | Version                  | Release notes
+|-----           | -------                  | -------------
+| Isp Library    | v1.1.0                   | [release notes](ISP_Library/README.md)
+| imx335 driver  | v1.3.1-cmw-custom        | [release notes](sensors/imx335/Release_Notes.html)
+| vd6g driver    | v1.0.0                   |
+| vd55g1 driver  | v1.0.0                   |
+
+## Supported Devices and Boards
+
+- STM32N6xx devices
+- MB1939 STM32N6570-DK revC
+
+## Update history
+
+### V1.4.2 / April 2025
+
+- Update Isp library to v1.1.0
+- Add support for white balance mode listing
+- Add support for manual white balance ref mod
+
+### V1.4.1 / December 2024
+
+Initial Version

Release_Notes.md

@@ -39,13 +39,6 @@ html, * {
 * {
   font-size: 1rem; }
 
-body {
-  margin: 0;
-  color: var(--fore-color);
-  @background: var(--back-color);
-  background: var(--back-color) linear-gradient(#ffd200, #ffd200) repeat-y left top;
-  background-size: var(--background-margin);
-  }
 
 details {
   display: block; }

_htmresc/mini-st_2020.css renamed to _htmresc/mini-st_2020-AIS.css

@@ -152,6 +152,53 @@ int32_t CMW_CAMERA_GetSensorName(CMW_Sensor_Name_t *sensorName)
   return CMW_ERROR_NONE;
 }
 
+/**
+  * @brief  Set White Balance mode.
+  * @param  Automatic  If not null, set automatic white balance mode
+  * @param  RefColorTemp  If automatic is null, set white balance mode
+  * @retval CMW status
+  */
+int32_t CMW_CAMERA_SetWBRefMode(uint8_t Automatic, uint32_t RefColorTemp)
+{
+  int ret;
+
+  ret = Camera_Drv.SetWBRefMode(&camera_bsp, Automatic, RefColorTemp);
+  if (ret != CMW_ERROR_NONE)
+  {
+    return CMW_ERROR_COMPONENT_FAILURE;
+  }
+
+  ret = CMW_ERROR_NONE;
+  /* Return CMW status */
+  return ret;
+}
+
+/**
+  * @brief  Get White Balance reference modes list.
+  * @param  RefColorTemp  White Balance reference modes
+  * @retval CMW status
+  */
+int32_t CMW_CAMERA_ListWBRefModes(uint32_t RefColorTemp[])
+{
+  int ret;
+
+  ret = Camera_Drv.ListWBRefModes(&camera_bsp, RefColorTemp);
+  if (ret != CMW_ERROR_NONE)
+  {
+    return CMW_ERROR_COMPONENT_FAILURE;
+  }
+
+  ret = CMW_ERROR_NONE;
+  /* Return CMW status */
+  return ret;
+}
+
+/**
+  * @brief  Probe camera sensor.
+  * @param  initValues  Initialization values for the sensor
+  * @param  sensorName  Camera sensor name
+  * @retval CMW status
+  */
 static int CMW_CAMERA_Probe_Sensor(CMW_Sensor_Init_t *initValues, CMW_Sensor_Name_t *sensorName)
 {
   int ret;
@@ -398,17 +445,22 @@ int32_t CMW_CAMERA_DeInit(void)
 {
   int32_t ret = CMW_ERROR_NONE;
 
-
-  ret = HAL_DCMIPP_CSI_PIPE_Stop(&hcamera_dcmipp, DCMIPP_PIPE1, DCMIPP_VIRTUAL_CHANNEL0);
-  if (ret != HAL_OK)
+  if (HAL_DCMIPP_PIPE_GetState(&hcamera_dcmipp, DCMIPP_PIPE1) != HAL_DCMIPP_PIPE_STATE_RESET)
   {
-    return CMW_ERROR_PERIPH_FAILURE;
+    ret = HAL_DCMIPP_CSI_PIPE_Stop(&hcamera_dcmipp, DCMIPP_PIPE1, DCMIPP_VIRTUAL_CHANNEL0);
+    if (ret != HAL_OK)
+    {
+      return CMW_ERROR_PERIPH_FAILURE;
+    }
   }
 
-  ret = HAL_DCMIPP_CSI_PIPE_Stop(&hcamera_dcmipp, DCMIPP_PIPE2, DCMIPP_VIRTUAL_CHANNEL0);
-  if (ret != HAL_OK)
+  if (HAL_DCMIPP_PIPE_GetState(&hcamera_dcmipp, DCMIPP_PIPE2) != HAL_DCMIPP_PIPE_STATE_RESET)
   {
-    return CMW_ERROR_PERIPH_FAILURE;
+    ret = HAL_DCMIPP_CSI_PIPE_Stop(&hcamera_dcmipp, DCMIPP_PIPE2, DCMIPP_VIRTUAL_CHANNEL0);
+    if (ret != HAL_OK)
+    {
+      return CMW_ERROR_PERIPH_FAILURE;
+    }
   }
 
   ret = HAL_DCMIPP_DeInit(&hcamera_dcmipp);
@@ -1031,7 +1083,7 @@ static int32_t CMW_CAMERA_VD66GY_Init( CMW_Sensor_Init_t *initSensors_params)
 #endif
 
 #if defined(USE_IMX335_SENSOR)
-static int32_t CMW_CAMERA_IMX335_Init( CMW_Sensor_Init_t *initSensors_params)
+static int32_t CMW_CAMERA_IMX335_Init(CMW_Sensor_Init_t *initSensors_params)
 {
   int32_t ret = CMW_ERROR_NONE;
   DCMIPP_CSI_ConfTypeDef csi_conf = { 0 };
@@ -1081,6 +1133,12 @@ static int32_t CMW_CAMERA_IMX335_Init( CMW_Sensor_Init_t *initSensors_params)
     return CMW_ERROR_COMPONENT_FAILURE;
   }
 
+  ret = Camera_Drv.SetFramerate(&camera_bsp, initSensors_params->fps);
+  if (ret != CMW_ERROR_NONE)
+  {
+    return CMW_ERROR_COMPONENT_FAILURE;
+  }
+
   csi_conf.NumberOfLanes = DCMIPP_CSI_TWO_DATA_LANES;
   csi_conf.DataLaneMapping = DCMIPP_CSI_PHYSICAL_DATA_LANES;
   csi_conf.PHYBitrate = DCMIPP_CSI_PHY_BT_1600;

cmw_camera.c

@@ -101,6 +101,8 @@ int32_t CMW_CAMERA_DeInit();
 int32_t CMW_CAMERA_Run();
 int32_t CMW_CAMERA_SetPipeConfig(uint32_t pipe, CMW_DCMIPP_Conf_t *p_conf, uint32_t *pitch);
 int32_t CMW_CAMERA_GetSensorName(CMW_Sensor_Name_t *sensorName);
+int32_t CMW_CAMERA_SetWBRefMode(uint8_t Automatic, uint32_t RefColorTemp);
+int32_t CMW_CAMERA_ListWBRefModes(uint32_t RefColorTemp[]);
 
 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);

cmw_camera.h

@@ -28,6 +28,8 @@
 #include "isp_param_conf.h"
 #endif
 
+#define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0]))
+
 
 static int CMW_IMX335_GetResType(uint32_t width, uint32_t height, uint32_t*res)
 {
@@ -98,14 +100,59 @@ static int32_t CMW_IMX335_SetExposure(void *io_ctx, int32_t exposure)
   return IMX335_SetExposure(&((CMW_IMX335_t *)io_ctx)->ctx_driver, exposure);
 }
 
+/**
+  * @brief  Set the sensor white balance mode
+  * @param  io_ctx  pointer to component object
+  * @param  Automatic automatic mode enable/disable
+  * @param  RefColorTemp color temperature if automatic mode is disabled
+  * @retval Component status
+  */
+int32_t CMW_IMX335_SetWBRefMode(void *io_ctx, uint8_t Automatic, uint32_t RefColorTemp)
+{
+  int ret = CMW_ERROR_NONE;
+
+  ret = ISP_SetWBRefMode(&((CMW_IMX335_t *)io_ctx)->hIsp, Automatic, RefColorTemp);
+  if (ret)
+  {
+    return CMW_ERROR_PERIPH_FAILURE;
+  }
+
+  return CMW_ERROR_NONE;
+}
+
+/**
+  * @brief  List the sensor white balance modes
+  * @param  io_ctx  pointer to component object
+  * @param  RefColorTemp color temperature list
+  * @retval Component status
+  */
+int32_t CMW_IMX335_ListWBRefModes(void *io_ctx, uint32_t RefColorTemp[])
+{
+  int ret = CMW_ERROR_NONE;
+
+  ret = ISP_ListWBRefModes(&((CMW_IMX335_t *)io_ctx)->hIsp, RefColorTemp);
+  if (ret)
+  {
+    return CMW_ERROR_PERIPH_FAILURE;
+  }
+
+  return CMW_ERROR_NONE;
+}
+
 static int32_t CMW_IMX335_SetFrequency(void *io_ctx, int32_t frequency)
 {
   return IMX335_SetFrequency(&((CMW_IMX335_t *)io_ctx)->ctx_driver, frequency);
 }
 
 static int32_t CMW_IMX335_SetFramerate(void *io_ctx, int32_t framerate)
 {
-  return IMX335_SetFramerate(&((CMW_IMX335_t *)io_ctx)->ctx_driver, framerate);
+  const int32_t available_imx335_fps[] = {10, 15, 20, 25, 30};
+
+  for (int i = 0; i < ARRAY_SIZE(available_imx335_fps); i++)
+    if (framerate == available_imx335_fps[i])
+      return IMX335_SetFramerate(&((CMW_IMX335_t *)io_ctx)->ctx_driver, framerate);
+
+  return CMW_ERROR_WRONG_PARAM;
 }
 
 static int32_t CMW_IMX335_SetMirrorFlip(void *io_ctx, uint32_t config)
@@ -180,9 +227,8 @@ static int32_t CMW_IMX335_Start(void *io_ctx)
   /* Statistic area is provided with null value so that it force the ISP Library to get the statistic
    * area information from the tuning file.
    */
-  ISP_StatAreaTypeDef isp_stat_area = {0};
   (void) ISP_IQParamCacheInit; /* unused */
-  ret = ISP_Init(&((CMW_IMX335_t *)io_ctx)->hIsp, ((CMW_IMX335_t *)io_ctx)->hdcmipp, 0, &((CMW_IMX335_t *)io_ctx)->appliHelpers, &isp_stat_area, &ISP_IQParamCacheInit_IMX335);
+  ret = ISP_Init(&((CMW_IMX335_t *)io_ctx)->hIsp, ((CMW_IMX335_t *)io_ctx)->hdcmipp, 0, &((CMW_IMX335_t *)io_ctx)->appliHelpers, &ISP_IQParamCacheInit_IMX335);
   if (ret != ISP_OK)
   {
     return CMW_ERROR_COMPONENT_FAILURE;
@@ -285,6 +331,8 @@ int CMW_IMX335_Probe(CMW_IMX335_t *io_ctx, CMW_Sensor_if_t *imx335_if)
   imx335_if->ReadID = CMW_IMX335_ReadID;
   imx335_if->SetGain = CMW_IMX335_SetGain;
   imx335_if->SetExposure = CMW_IMX335_SetExposure;
+  imx335_if->SetWBRefMode = CMW_IMX335_SetWBRefMode;
+  imx335_if->ListWBRefModes = CMW_IMX335_ListWBRefModes;
   imx335_if->SetFrequency = CMW_IMX335_SetFrequency;
   imx335_if->SetFramerate = CMW_IMX335_SetFramerate;
   imx335_if->SetMirrorFlip = CMW_IMX335_SetMirrorFlip;

sensors/cmw_imx335.c

@@ -60,6 +60,8 @@ typedef struct
   int32_t (*SetGain)(void *, int32_t);
   int32_t (*SetExposure)(void *, int32_t);
   int32_t (*SetExposureMode)(void *, int32_t);
+  int32_t (*SetWBRefMode)(void *, uint8_t, uint32_t);
+  int32_t (*ListWBRefModes)(void *, uint32_t[]);
   int32_t (*SetFlickerMode)(void *, int32_t);
   int32_t (*GetSensorInfo)(void *, ISP_SensorInfoTypeDef *);
   int32_t (*SetTestPattern)(void *, int32_t);

sensors/cmw_sensors_if.h

@@ -285,9 +285,8 @@ static int32_t CMW_VD66GY_Start(void *io_ctx)
   /* Statistic area is provided with null value so that it force the ISP Library to get the statistic
    * area information from the tuning file.
    */
-  ISP_StatAreaTypeDef isp_stat_area = {0};
   (void) ISP_IQParamCacheInit; /* unused */
-  ret = ISP_Init(&((CMW_VD66GY_t *)io_ctx)->hIsp, ((CMW_VD66GY_t *)io_ctx)->hdcmipp, 0, &((CMW_VD66GY_t *)io_ctx)->appliHelpers, &isp_stat_area, &ISP_IQParamCacheInit_VD66GY);
+  ret = ISP_Init(&((CMW_VD66GY_t *)io_ctx)->hIsp, ((CMW_VD66GY_t *)io_ctx)->hdcmipp, 0, &((CMW_VD66GY_t *)io_ctx)->appliHelpers, &ISP_IQParamCacheInit_VD66GY);
   if (ret != ISP_OK)
   {
     return CMW_ERROR_COMPONENT_FAILURE;
@@ -446,6 +445,45 @@ int32_t CMW_VD66GY_SetExposureMode(void *io_ctx, int32_t mode)
   return (ret == 0) ? CMW_ERROR_NONE : CMW_ERROR_UNKNOWN_FAILURE;
 }
 
+/**
+  * @brief  Set the sensor white balance mode
+  * @param  io_ctx  pointer to component object
+  * @param  Automatic automatic mode enable/disable
+  * @param  RefColorTemp color temperature if automatic mode is disabled
+  * @retval Component status
+  */
+int32_t CMW_VD66GY_SetWBRefMode(void *io_ctx, uint8_t Automatic, uint32_t RefColorTemp)
+{
+  int ret = CMW_ERROR_NONE;
+
+  ret = ISP_SetWBRefMode(&((CMW_VD66GY_t *)io_ctx)->hIsp, Automatic, RefColorTemp);
+  if (ret)
+  {
+    return CMW_ERROR_PERIPH_FAILURE;
+  }
+
+  return CMW_ERROR_NONE;
+}
+
+/**
+  * @brief  List the sensor white balance modes
+  * @param  io_ctx  pointer to component object
+  * @param  RefColorTemp color temperature list
+  * @retval Component status
+  */
+int32_t CMW_VD66GY_ListWBRefModes(void *io_ctx, uint32_t RefColorTemp[])
+{
+  int ret = CMW_ERROR_NONE;
+
+  ret = ISP_ListWBRefModes(&((CMW_VD66GY_t *)io_ctx)->hIsp, RefColorTemp);
+  if (ret)
+  {
+    return CMW_ERROR_PERIPH_FAILURE;
+  }
+
+  return CMW_ERROR_NONE;
+}
+
 /**
   * @brief  Get the sensor info
   * @param  pObj  pointer to component object
@@ -581,7 +619,7 @@ int CMW_VD66GY_Probe(CMW_VD66GY_t *io_ctx, CMW_Sensor_if_t *vd6g_if)
 
   io_ctx->ctx_driver.shutdown_pin = VD6G_ShutdownPin;
   io_ctx->ctx_driver.read8 = VD6G_Read8;
-  io_ctx->ctx_driver.read16 =VD6G_Read16;
+  io_ctx->ctx_driver.read16 = VD6G_Read16;
   io_ctx->ctx_driver.read32 = VD6G_Read32;
   io_ctx->ctx_driver.write8 = VD6G_Write8;
   io_ctx->ctx_driver.write16 = VD6G_Write16;
@@ -619,6 +657,8 @@ int CMW_VD66GY_Probe(CMW_VD66GY_t *io_ctx, CMW_Sensor_if_t *vd6g_if)
   vd6g_if->SetGain = CMW_VD66GY_SetGain;
   vd6g_if->SetExposure = CMW_VD66GY_SetExposure;
   vd6g_if->SetExposureMode = CMW_VD66GY_SetExposureMode;
+  vd6g_if->SetWBRefMode = CMW_VD66GY_SetWBRefMode;
+  vd6g_if->ListWBRefModes = CMW_VD66GY_ListWBRefModes;
   vd6g_if->GetSensorInfo = CMW_VD66GY_GetSensorInfo;
   return ret;
 }