/** ****************************************************************************** * @file stm32l496g_discovery_camera.c * @author MCD Application Team * @brief This file includes the driver for Camera modules mounted on * STM32L496G-Discovery board. @verbatim How to use this driver: ------------------------ - This driver is used to drive the camera. - The OV9655 component driver MUST be included with this driver. Driver description: ------------------- + Initialization steps: o Initialize the camera using the BSP_CAMERA_Init() function. o Start the camera capture/snapshot using the CAMERA_Start() function. o Suspend, resume or stop the camera capture using the following functions: - BSP_CAMERA_Suspend() - BSP_CAMERA_Resume() - BSP_CAMERA_Stop() + Options o Increase or decrease on the fly the brightness and/or contrast using the following function: - BSP_CAMERA_ContrastBrightnessConfig o Add a special effect on the fly using the following functions: - BSP_CAMERA_BlackWhiteConfig() - BSP_CAMERA_ColorEffectConfig() @endverbatim ****************************************************************************** * @attention * *

© Copyright (c) 2017 STMicroelectronics. * All rights reserved.

* * This software component is licensed by ST under BSD 3-Clause license, * the "License"; You may not use this file except in compliance with the * License. You may obtain a copy of the License at: * opensource.org/licenses/BSD-3-Clause * ****************************************************************************** */ /* Includes ------------------------------------------------------------------*/ #include "stm32l496g_discovery_camera.h" #include "stm32l496g_discovery.h" #include "stm32l496g_discovery_io.h" /** @addtogroup BSP * @{ */ /** @addtogroup STM32L496G_DISCOVERY * @{ */ /** @addtogroup STM32L496G_DISCOVERY_CAMERA * @{ */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Private_TypesDefinitions STM32L496G_DISCOVERY_CAMERA Private Types Definitions * @{ */ /** * @} */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Private_Defines STM32L496G_DISCOVERY_CAMERA Private Defines * @{ */ #define CAMERA_VGA_RES_X 640 #define CAMERA_VGA_RES_Y 480 #define CAMERA_480x272_RES_X 480 #define CAMERA_480x272_RES_Y 272 #define CAMERA_QVGA_RES_X 320 #define CAMERA_QVGA_RES_Y 240 #define CAMERA_QQVGA_RES_X 160 #define CAMERA_QQVGA_RES_Y 120 /** * @} */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Private_Macros STM32L496G_DISCOVERY_CAMERA Private Macros * @{ */ /** * @} */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Private_Variables STM32L496G_DISCOVERY_CAMERA Private Variables * @{ */ DCMI_HandleTypeDef hDcmiHandler; CAMERA_DrvTypeDef *camera_drv; /* Camera current resolution naming (QQVGA, VGA, ...) */ static uint32_t CameraCurrentResolution; /* Camera module I2C HW address */ static uint32_t CameraHwAddress; /** * @} */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Private_FunctionPrototypes STM32L496G_DISCOVERY_CAMERA Private Function Prototypes * @{ */ static uint32_t GetSize(uint32_t resolution); /** * @} */ /** @defgroup STM32L496G_DISCOVERY_CAMERA_Exported_Functions STM32L496G_DISCOVERY_CAMERA Exported Functions * @{ */ /** * @brief Initializes the camera. * @param Resolution : camera sensor requested resolution (x, y) : standard resolution * naming QQVGA, QVGA, VGA ... * @retval Camera status */ uint8_t BSP_CAMERA_Init(uint32_t Resolution) { DCMI_HandleTypeDef *phdcmi; uint8_t status = CAMERA_ERROR; /* Get the DCMI handle structure */ phdcmi = &hDcmiHandler; /* Initialize the IO functionalities */ BSP_IO_Init(); /*** Configures the DCMI to interface with the camera module ***/ /* DCMI configuration */ phdcmi->Init.CaptureRate = DCMI_CR_ALL_FRAME; phdcmi->Init.HSPolarity = DCMI_HSPOLARITY_HIGH; phdcmi->Init.SynchroMode = DCMI_SYNCHRO_HARDWARE; phdcmi->Init.VSPolarity = DCMI_VSPOLARITY_HIGH; phdcmi->Init.ExtendedDataMode = DCMI_EXTEND_DATA_8B; phdcmi->Init.PCKPolarity = DCMI_PCKPOLARITY_RISING; phdcmi->Init.ByteSelectMode = DCMI_BSM_ALL; phdcmi->Init.LineSelectMode = DCMI_LSM_ALL; phdcmi->Instance = DCMI; /* Camera initialization */ BSP_CAMERA_MspInit(&hDcmiHandler, NULL); /* Read ID of Camera module via I2C */ if (ov9655_ReadID(CAMERA_I2C_ADDRESS) == OV9655_ID) { /* Initialize the camera driver structure */ camera_drv = &ov9655_drv; CameraHwAddress = CAMERA_I2C_ADDRESS; /* DCMI Initialization */ HAL_DCMI_Init(phdcmi); /* Camera Module Initialization via I2C to the wanted 'Resolution' */ if (Resolution == CAMERA_R320x240) { /* For 240x240 resolution, the OV9655 sensor is set to QVGA resolution * as OV9655 doesn't supports 240x240 resolution, * then DCMI is configured to output a 240x240 cropped window */ camera_drv->Init(CameraHwAddress, CAMERA_R320x240); HAL_DCMI_ConfigCROP(phdcmi, 40, /* Crop in the middle of the VGA picture */ 0, /* Same height (same number of lines: no need to crop vertically) */ (240 * 2) - 1, /* 2 pixels clock needed to capture one pixel */ (240 * 1) - 1); /* All 240 lines are captured */ HAL_DCMI_EnableCROP(phdcmi); /* Set the RGB565 mode */ MFX_IO_Write(CameraHwAddress, 0x12 /*OV9655_COM7*/, 0x63); MFX_IO_Write(CameraHwAddress, 0x40 /*OV9655_COM15*/, 0x10); /* Invert the HRef signal */ MFX_IO_Write(CameraHwAddress, 0x15 /*OV9655_COM10*/, 0x08); HAL_Delay(500); } else { camera_drv->Init(CameraHwAddress, Resolution); HAL_DCMI_DisableCROP(phdcmi); } CameraCurrentResolution = Resolution; /* Return CAMERA_OK status */ status = CAMERA_OK; } else { /* Return CAMERA_NOT_SUPPORTED status */ status = CAMERA_NOT_SUPPORTED; } return status; } /** * @brief DeInitializes the camera. * @retval Camera status */ uint8_t BSP_CAMERA_DeInit(void) { hDcmiHandler.Instance = DCMI; HAL_DCMI_DeInit(&hDcmiHandler); BSP_CAMERA_MspDeInit(&hDcmiHandler, NULL); return CAMERA_OK; } /** * @brief Starts the camera capture in continuous mode. * @param buff: pointer to the camera output buffer * @retval None */ void BSP_CAMERA_ContinuousStart(uint8_t *buff) { /* Start the camera capture */ HAL_DCMI_Start_DMA(&hDcmiHandler, DCMI_MODE_CONTINUOUS, (uint32_t)buff, GetSize(CameraCurrentResolution)); } /** * @brief Starts the camera capture in snapshot mode. * @param buff: pointer to the camera output buffer * @retval None */ void BSP_CAMERA_SnapshotStart(uint8_t *buff) { /* Start the camera capture */ HAL_DCMI_Start_DMA(&hDcmiHandler, DCMI_MODE_SNAPSHOT, (uint32_t)buff, GetSize(CameraCurrentResolution)); } /** * @brief Suspend the CAMERA capture * @retval None */ void BSP_CAMERA_Suspend(void) { /* Suspend the Camera Capture */ HAL_DCMI_Suspend(&hDcmiHandler); } /** * @brief Resume the CAMERA capture * @retval None */ void BSP_CAMERA_Resume(void) { /* Start the Camera Capture */ HAL_DCMI_Resume(&hDcmiHandler); } /** * @brief Stop the CAMERA capture * @retval Camera status */ uint8_t BSP_CAMERA_Stop(void) { uint8_t status = CAMERA_ERROR; if (HAL_DCMI_Stop(&hDcmiHandler) == HAL_OK) { status = CAMERA_OK; } /* Set Camera in Power Down */ BSP_CAMERA_PwrDown(); return status; } /** * @brief CANERA power up * @retval None */ void BSP_CAMERA_PwrUp(void) { /* De-assert the camera POWER_DOWN pin (active high) */ BSP_IO_WritePin(CAMERA_PWR_EN_PIN, GPIO_PIN_RESET); HAL_Delay(3); /* POWER_DOWN de-asserted during 3ms */ } /** * @brief CAMERA power down * @retval None */ void BSP_CAMERA_PwrDown(void) { /* Assert the camera POWER_DOWN pin (active high) */ BSP_IO_WritePin(CAMERA_PWR_EN_PIN, GPIO_PIN_SET); } /** * @brief Configures the camera contrast and brightness. * @param contrast_level: Contrast level * This parameter can be one of the following values: * @arg CAMERA_CONTRAST_LEVEL4: for contrast +2 * @arg CAMERA_CONTRAST_LEVEL3: for contrast +1 * @arg CAMERA_CONTRAST_LEVEL2: for contrast 0 * @arg CAMERA_CONTRAST_LEVEL1: for contrast -1 * @arg CAMERA_CONTRAST_LEVEL0: for contrast -2 * @param brightness_level: Contrast level * This parameter can be one of the following values: * @arg CAMERA_BRIGHTNESS_LEVEL4: for brightness +2 * @arg CAMERA_BRIGHTNESS_LEVEL3: for brightness +1 * @arg CAMERA_BRIGHTNESS_LEVEL2: for brightness 0 * @arg CAMERA_BRIGHTNESS_LEVEL1: for brightness -1 * @arg CAMERA_BRIGHTNESS_LEVEL0: for brightness -2 * @retval None */ void BSP_CAMERA_ContrastBrightnessConfig(uint32_t contrast_level, uint32_t brightness_level) { if (camera_drv->Config != NULL) { camera_drv->Config(CameraHwAddress, CAMERA_CONTRAST_BRIGHTNESS, contrast_level, brightness_level); } } /** * @brief Configures the camera white balance. * @param Mode: black_white mode * This parameter can be one of the following values: * @arg CAMERA_BLACK_WHITE_BW * @arg CAMERA_BLACK_WHITE_NEGATIVE * @arg CAMERA_BLACK_WHITE_BW_NEGATIVE * @arg CAMERA_BLACK_WHITE_NORMAL * @retval None */ void BSP_CAMERA_BlackWhiteConfig(uint32_t Mode) { if (camera_drv->Config != NULL) { camera_drv->Config(CameraHwAddress, CAMERA_BLACK_WHITE, Mode, 0); } } /** * @brief Configures the camera color effect. * @param Effect: Color effect * This parameter can be one of the following values: * @arg CAMERA_COLOR_EFFECT_ANTIQUE * @arg CAMERA_COLOR_EFFECT_BLUE * @arg CAMERA_COLOR_EFFECT_GREEN * @arg CAMERA_COLOR_EFFECT_RED * @retval None */ void BSP_CAMERA_ColorEffectConfig(uint32_t Effect) { if (camera_drv->Config != NULL) { camera_drv->Config(CameraHwAddress, CAMERA_COLOR_EFFECT, Effect, 0); } } /** * @brief Get the capture size in pixels unit. * @param resolution: the current resolution. * @retval capture size in pixels unit. */ static uint32_t GetSize(uint32_t resolution) { uint32_t size = 0; /* Get capture size */ switch (resolution) { case CAMERA_R160x120: { size = 0x2580; } break; case CAMERA_R320x240: { size = 0x9600; } break; case CAMERA_R480x272: { size = 0xFF00; } break; case CAMERA_R640x480: { size = 0x25800; } break; default: { break; } } return size; } /** * @brief Initializes the DCMI MSP. * @param hdcmi: HDMI handle * @param Params * @retval None */ __weak void BSP_CAMERA_MspInit(DCMI_HandleTypeDef *hdcmi, void *Params) { static DMA_HandleTypeDef hdma_handler; GPIO_InitTypeDef gpio_init_structure; /*** Enable peripherals and GPIO clocks ***/ /* Enable DCMI clock */ __HAL_RCC_DCMI_CLK_ENABLE(); /* Enable DMA2 clock */ __HAL_RCC_DMA2_CLK_ENABLE(); /* Enable GPIO clocks */ __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_GPIOE_CLK_ENABLE(); __HAL_RCC_GPIOH_CLK_ENABLE(); __HAL_RCC_GPIOI_CLK_ENABLE(); HAL_RCC_MCOConfig(RCC_MCO1, RCC_MCO1SOURCE_SYSCLK, RCC_MCODIV_4); __HAL_RCC_HSI48_ENABLE(); HAL_Delay(10); // HSI48 should start in 10ms /*** Configure the GPIO ***/ /* Configure DCMI GPIO as alternate function */ gpio_init_structure.Pin = GPIO_PIN_5; gpio_init_structure.Mode = GPIO_MODE_AF_PP; gpio_init_structure.Pull = GPIO_NOPULL; gpio_init_structure.Speed = GPIO_SPEED_HIGH; gpio_init_structure.Alternate = GPIO_AF10_DCMI; HAL_GPIO_Init(GPIOE, &gpio_init_structure); gpio_init_structure.Pin = GPIO_PIN_5 | GPIO_PIN_8 | GPIO_PIN_9 | \ GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12 | GPIO_PIN_14; gpio_init_structure.Mode = GPIO_MODE_AF_PP; gpio_init_structure.Pull = GPIO_NOPULL; gpio_init_structure.Speed = GPIO_SPEED_HIGH; gpio_init_structure.Alternate = GPIO_AF10_DCMI; HAL_GPIO_Init(GPIOH, &gpio_init_structure); gpio_init_structure.Pin = GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_7; gpio_init_structure.Mode = GPIO_MODE_AF_PP; gpio_init_structure.Pull = GPIO_NOPULL; gpio_init_structure.Speed = GPIO_SPEED_HIGH; gpio_init_structure.Alternate = GPIO_AF10_DCMI; HAL_GPIO_Init(GPIOI, &gpio_init_structure); /*** Configure the DMA ***/ /* Set the parameters to be configured */ hdma_handler.Instance = BSP_CAMERA_DMA_INSTANCE; hdma_handler.Init.Request = DMA_REQUEST_0; hdma_handler.Init.Direction = DMA_PERIPH_TO_MEMORY; hdma_handler.Init.PeriphInc = DMA_PINC_DISABLE; hdma_handler.Init.MemInc = DMA_MINC_ENABLE; /* Image captured by the DCMI is stored in memory */ hdma_handler.Init.PeriphDataAlignment = DMA_PDATAALIGN_WORD; hdma_handler.Init.MemDataAlignment = DMA_MDATAALIGN_WORD; hdma_handler.Init.Mode = DMA_CIRCULAR; hdma_handler.Init.Priority = DMA_PRIORITY_HIGH; /* Associate the initialized DMA handle to the DCMI handle */ __HAL_LINKDMA(hdcmi, DMA_Handle, hdma_handler); /*** Configure the NVIC for DCMI and DMA ***/ /* NVIC configuration for DCMI transfer complete interrupt */ HAL_NVIC_SetPriority(DCMI_IRQn, 0x0F, 0); HAL_NVIC_EnableIRQ(DCMI_IRQn); /* NVIC configuration for DMA2D transfer complete interrupt */ HAL_NVIC_SetPriority(DMA2_Channel6_IRQn, 0x0F, 0); HAL_NVIC_EnableIRQ(DMA2_Channel6_IRQn); /* Configure the DMA stream */ HAL_DMA_Init(hdcmi->DMA_Handle); } /** * @brief DeInitializes the DCMI MSP. * @param hdcmi: HDMI handle * @param Params * @retval None */ __weak void BSP_CAMERA_MspDeInit(DCMI_HandleTypeDef *hdcmi, void *Params) { /* Disable NVIC for DCMI transfer complete interrupt */ HAL_NVIC_DisableIRQ(DCMI_IRQn); /* Disable NVIC for DMA2 transfer complete interrupt */ HAL_NVIC_DisableIRQ(DMA2_Channel6_IRQn); /* Configure the DMA stream */ HAL_DMA_DeInit(hdcmi->DMA_Handle); /* Disable DCMI clock */ __HAL_RCC_DCMI_CLK_DISABLE(); /* GPIO pins clock and DMA clock can be shut down in the application by surcharging this __weak function */ } /** * @brief Line event callback * @param hdcmi: pointer to the DCMI handle * @retval None */ void HAL_DCMI_LineEventCallback(DCMI_HandleTypeDef *hdcmi) { BSP_CAMERA_LineEventCallback(); } /** * @brief Line Event callback. * @retval None */ __weak void BSP_CAMERA_LineEventCallback(void) { /* NOTE : This function should not be modified; when the callback is needed, the BSP_CAMERA_LineEventCallback can be implemented in the user file */ } /** * @brief VSYNC event callback * @param hdcmi: pointer to the DCMI handle * @retval None */ void HAL_DCMI_VsyncEventCallback(DCMI_HandleTypeDef *hdcmi) { BSP_CAMERA_VsyncEventCallback(); } /** * @brief VSYNC Event callback. * @retval None */ __weak void BSP_CAMERA_VsyncEventCallback(void) { /* NOTE : This function should not be modified; when the callback is needed, the BSP_CAMERA_VsyncEventCallback can be implemented in the user file */ } /** * @brief Frame event callback * @param hdcmi: pointer to the DCMI handle * @retval None */ void HAL_DCMI_FrameEventCallback(DCMI_HandleTypeDef *hdcmi) { BSP_CAMERA_FrameEventCallback(); } /** * @brief Frame Event callback. * @retval None */ __weak void BSP_CAMERA_FrameEventCallback(void) { /* NOTE : This function should not be modified; when the callback is needed, the BSP_CAMERA_FrameEventCallback can be implemented in the user file */ } /** * @brief Error callback * @param hdcmi: pointer to the DCMI handle * @retval None */ void HAL_DCMI_ErrorCallback(DCMI_HandleTypeDef *hdcmi) { BSP_CAMERA_ErrorCallback(); } /** * @brief Error callback. * @retval None */ __weak void BSP_CAMERA_ErrorCallback(void) { /* NOTE : This function should not be modified; when the callback is needed, the BSP_CAMERA_ErrorCallback can be implemented in the user file */ } /** * @} */ /** * @} */ /** * @} */ /** * @} */ /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/