en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_dcmi.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
83:a036322b8637
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32f7xx_hal_dcmi.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.0.1
bogdanm 0:9b334a45a8ff 6 * @date 25-June-2015
bogdanm 0:9b334a45a8ff 7 * @brief DCMI HAL module driver
bogdanm 0:9b334a45a8ff 8 * This file provides firmware functions to manage the following
bogdanm 0:9b334a45a8ff 9 * functionalities of the Digital Camera Interface (DCMI) peripheral:
bogdanm 0:9b334a45a8ff 10 * + Initialization and de-initialization functions
bogdanm 0:9b334a45a8ff 11 * + IO operation functions
bogdanm 0:9b334a45a8ff 12 * + Peripheral Control functions
bogdanm 0:9b334a45a8ff 13 * + Peripheral State and Error functions
bogdanm 0:9b334a45a8ff 14 *
bogdanm 0:9b334a45a8ff 15 @verbatim
bogdanm 0:9b334a45a8ff 16 ==============================================================================
bogdanm 0:9b334a45a8ff 17 ##### How to use this driver #####
bogdanm 0:9b334a45a8ff 18 ==============================================================================
bogdanm 0:9b334a45a8ff 19 [..]
bogdanm 0:9b334a45a8ff 20 The sequence below describes how to use this driver to capture image
bogdanm 0:9b334a45a8ff 21 from a camera module connected to the DCMI Interface.
bogdanm 0:9b334a45a8ff 22 This sequence does not take into account the configuration of the
bogdanm 0:9b334a45a8ff 23 camera module, which should be made before to configure and enable
bogdanm 0:9b334a45a8ff 24 the DCMI to capture images.
bogdanm 0:9b334a45a8ff 25
bogdanm 0:9b334a45a8ff 26 (#) Program the required configuration through following parameters:
bogdanm 0:9b334a45a8ff 27 horizontal and vertical polarity, pixel clock polarity, Capture Rate,
bogdanm 0:9b334a45a8ff 28 Synchronization Mode, code of the frame delimiter and data width
bogdanm 0:9b334a45a8ff 29 using HAL_DCMI_Init() function.
bogdanm 0:9b334a45a8ff 30
bogdanm 0:9b334a45a8ff 31 (#) Configure the DMA2_Stream1 channel1 to transfer Data from DCMI DR
bogdanm 0:9b334a45a8ff 32 register to the destination memory buffer.
bogdanm 0:9b334a45a8ff 33
bogdanm 0:9b334a45a8ff 34 (#) Program the required configuration through following parameters:
bogdanm 0:9b334a45a8ff 35 DCMI mode, destination memory Buffer address and the data length
bogdanm 0:9b334a45a8ff 36 and enable capture using HAL_DCMI_Start_DMA() function.
bogdanm 0:9b334a45a8ff 37
bogdanm 0:9b334a45a8ff 38 (#) Optionally, configure and Enable the CROP feature to select a rectangular
bogdanm 0:9b334a45a8ff 39 window from the received image using HAL_DCMI_ConfigCrop()
bogdanm 0:9b334a45a8ff 40 and HAL_DCMI_EnableCROP() functions
bogdanm 0:9b334a45a8ff 41
bogdanm 0:9b334a45a8ff 42 (#) The capture can be stopped using HAL_DCMI_Stop() function.
bogdanm 0:9b334a45a8ff 43
bogdanm 0:9b334a45a8ff 44 (#) To control DCMI state you can use the function HAL_DCMI_GetState().
bogdanm 0:9b334a45a8ff 45
bogdanm 0:9b334a45a8ff 46 *** DCMI HAL driver macros list ***
bogdanm 0:9b334a45a8ff 47 =============================================
bogdanm 0:9b334a45a8ff 48 [..]
bogdanm 0:9b334a45a8ff 49 Below the list of most used macros in DCMI HAL driver.
bogdanm 0:9b334a45a8ff 50
bogdanm 0:9b334a45a8ff 51 (+) __HAL_DCMI_ENABLE: Enable the DCMI peripheral.
bogdanm 0:9b334a45a8ff 52 (+) __HAL_DCMI_DISABLE: Disable the DCMI peripheral.
bogdanm 0:9b334a45a8ff 53 (+) __HAL_DCMI_GET_FLAG: Get the DCMI pending flags.
bogdanm 0:9b334a45a8ff 54 (+) __HAL_DCMI_CLEAR_FLAG: Clear the DCMI pending flags.
bogdanm 0:9b334a45a8ff 55 (+) __HAL_DCMI_ENABLE_IT: Enable the specified DCMI interrupts.
bogdanm 0:9b334a45a8ff 56 (+) __HAL_DCMI_DISABLE_IT: Disable the specified DCMI interrupts.
bogdanm 0:9b334a45a8ff 57 (+) __HAL_DCMI_GET_IT_SOURCE: Check whether the specified DCMI interrupt has occurred or not.
bogdanm 0:9b334a45a8ff 58
bogdanm 0:9b334a45a8ff 59 [..]
bogdanm 0:9b334a45a8ff 60 (@) You can refer to the DCMI HAL driver header file for more useful macros
bogdanm 0:9b334a45a8ff 61
bogdanm 0:9b334a45a8ff 62 @endverbatim
bogdanm 0:9b334a45a8ff 63 ******************************************************************************
bogdanm 0:9b334a45a8ff 64 * @attention
bogdanm 0:9b334a45a8ff 65 *
bogdanm 0:9b334a45a8ff 66 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bogdanm 0:9b334a45a8ff 67 *
bogdanm 0:9b334a45a8ff 68 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 0:9b334a45a8ff 69 * are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 70 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 71 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 72 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 73 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 74 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 75 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 76 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 77 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 78 *
bogdanm 0:9b334a45a8ff 79 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 80 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 81 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 82 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 83 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 84 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 85 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 86 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 87 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 88 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 89 *
bogdanm 0:9b334a45a8ff 90 ******************************************************************************
bogdanm 0:9b334a45a8ff 91 */
bogdanm 0:9b334a45a8ff 92
bogdanm 0:9b334a45a8ff 93 /* Includes ------------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 94 #include "stm32f7xx_hal.h"
bogdanm 0:9b334a45a8ff 95
bogdanm 0:9b334a45a8ff 96 /** @addtogroup STM32F7xx_HAL_Driver
bogdanm 0:9b334a45a8ff 97 * @{
bogdanm 0:9b334a45a8ff 98 */
bogdanm 0:9b334a45a8ff 99 /** @defgroup DCMI DCMI
bogdanm 0:9b334a45a8ff 100 * @brief DCMI HAL module driver
bogdanm 0:9b334a45a8ff 101 * @{
bogdanm 0:9b334a45a8ff 102 */
bogdanm 0:9b334a45a8ff 103
bogdanm 0:9b334a45a8ff 104 #ifdef HAL_DCMI_MODULE_ENABLED
bogdanm 0:9b334a45a8ff 105
bogdanm 0:9b334a45a8ff 106 /* Private typedef -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 107 /* Private define ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 108 #define HAL_TIMEOUT_DCMI_STOP ((uint32_t)1000) /* 1s */
bogdanm 0:9b334a45a8ff 109 /* Private macro -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 110 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 111 /* Private function prototypes -----------------------------------------------*/
bogdanm 0:9b334a45a8ff 112 static void DCMI_DMAConvCplt(DMA_HandleTypeDef *hdma);
bogdanm 0:9b334a45a8ff 113 static void DCMI_DMAError(DMA_HandleTypeDef *hdma);
bogdanm 0:9b334a45a8ff 114
bogdanm 0:9b334a45a8ff 115 /* Exported functions --------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 116
bogdanm 0:9b334a45a8ff 117 /** @defgroup DCMI_Exported_Functions DCMI Exported Functions
bogdanm 0:9b334a45a8ff 118 * @{
bogdanm 0:9b334a45a8ff 119 */
bogdanm 0:9b334a45a8ff 120
bogdanm 0:9b334a45a8ff 121 /** @defgroup DCMI_Exported_Functions_Group1 Initialization and Configuration functions
bogdanm 0:9b334a45a8ff 122 * @brief Initialization and Configuration functions
bogdanm 0:9b334a45a8ff 123 *
bogdanm 0:9b334a45a8ff 124 @verbatim
bogdanm 0:9b334a45a8ff 125 ===============================================================================
bogdanm 0:9b334a45a8ff 126 ##### Initialization and Configuration functions #####
bogdanm 0:9b334a45a8ff 127 ===============================================================================
bogdanm 0:9b334a45a8ff 128 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 129 (+) Initialize and configure the DCMI
bogdanm 0:9b334a45a8ff 130 (+) De-initialize the DCMI
bogdanm 0:9b334a45a8ff 131
bogdanm 0:9b334a45a8ff 132 @endverbatim
bogdanm 0:9b334a45a8ff 133 * @{
bogdanm 0:9b334a45a8ff 134 */
bogdanm 0:9b334a45a8ff 135
bogdanm 0:9b334a45a8ff 136 /**
bogdanm 0:9b334a45a8ff 137 * @brief Initializes the DCMI according to the specified
bogdanm 0:9b334a45a8ff 138 * parameters in the DCMI_InitTypeDef and create the associated handle.
bogdanm 0:9b334a45a8ff 139 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 140 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 141 * @retval HAL status
bogdanm 0:9b334a45a8ff 142 */
bogdanm 0:9b334a45a8ff 143 __weak HAL_StatusTypeDef HAL_DCMI_Init(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 144 {
bogdanm 0:9b334a45a8ff 145 /* Check the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 146 if(hdcmi == NULL)
bogdanm 0:9b334a45a8ff 147 {
bogdanm 0:9b334a45a8ff 148 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 149 }
bogdanm 0:9b334a45a8ff 150
bogdanm 0:9b334a45a8ff 151 /* Check function parameters */
bogdanm 0:9b334a45a8ff 152 assert_param(IS_DCMI_ALL_INSTANCE(hdcmi->Instance));
bogdanm 0:9b334a45a8ff 153 assert_param(IS_DCMI_SYNCHRO(hdcmi->Init.SynchroMode));
bogdanm 0:9b334a45a8ff 154 assert_param(IS_DCMI_PCKPOLARITY(hdcmi->Init.PCKPolarity));
bogdanm 0:9b334a45a8ff 155 assert_param(IS_DCMI_VSPOLARITY(hdcmi->Init.VSPolarity));
bogdanm 0:9b334a45a8ff 156 assert_param(IS_DCMI_HSPOLARITY(hdcmi->Init.HSPolarity));
bogdanm 0:9b334a45a8ff 157 assert_param(IS_DCMI_CAPTURE_RATE(hdcmi->Init.CaptureRate));
bogdanm 0:9b334a45a8ff 158 assert_param(IS_DCMI_EXTENDED_DATA(hdcmi->Init.ExtendedDataMode));
bogdanm 0:9b334a45a8ff 159 assert_param(IS_DCMI_MODE_JPEG(hdcmi->Init.JPEGMode));
bogdanm 0:9b334a45a8ff 160
bogdanm 0:9b334a45a8ff 161 if(hdcmi->State == HAL_DCMI_STATE_RESET)
bogdanm 0:9b334a45a8ff 162 {
bogdanm 0:9b334a45a8ff 163 /* Allocate lock resource and initialize it */
bogdanm 0:9b334a45a8ff 164 hdcmi->Lock = HAL_UNLOCKED;
bogdanm 0:9b334a45a8ff 165 /* Init the low level hardware */
bogdanm 0:9b334a45a8ff 166 HAL_DCMI_MspInit(hdcmi);
bogdanm 0:9b334a45a8ff 167 }
bogdanm 0:9b334a45a8ff 168
bogdanm 0:9b334a45a8ff 169 /* Change the DCMI state */
bogdanm 0:9b334a45a8ff 170 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 /* Set DCMI parameters */
bogdanm 0:9b334a45a8ff 173 /* Configures the HS, VS, DE and PC polarity */
bogdanm 0:9b334a45a8ff 174 hdcmi->Instance->CR &= ~(DCMI_CR_PCKPOL | DCMI_CR_HSPOL | DCMI_CR_VSPOL | DCMI_CR_EDM_0 |
bogdanm 0:9b334a45a8ff 175 DCMI_CR_EDM_1 | DCMI_CR_FCRC_0 | DCMI_CR_FCRC_1 | DCMI_CR_JPEG |
bogdanm 0:9b334a45a8ff 176 DCMI_CR_ESS);
bogdanm 0:9b334a45a8ff 177 hdcmi->Instance->CR |= (uint32_t)(hdcmi->Init.SynchroMode | hdcmi->Init.CaptureRate | \
bogdanm 0:9b334a45a8ff 178 hdcmi->Init.VSPolarity | hdcmi->Init.HSPolarity | \
bogdanm 0:9b334a45a8ff 179 hdcmi->Init.PCKPolarity | hdcmi->Init.ExtendedDataMode | \
bogdanm 0:9b334a45a8ff 180 hdcmi->Init.JPEGMode);
bogdanm 0:9b334a45a8ff 181
bogdanm 0:9b334a45a8ff 182 if(hdcmi->Init.SynchroMode == DCMI_SYNCHRO_EMBEDDED)
bogdanm 0:9b334a45a8ff 183 {
bogdanm 0:9b334a45a8ff 184 DCMI->ESCR = (((uint32_t)hdcmi->Init.SyncroCode.FrameStartCode) |
bogdanm 0:9b334a45a8ff 185 ((uint32_t)hdcmi->Init.SyncroCode.LineStartCode << 8)|
bogdanm 0:9b334a45a8ff 186 ((uint32_t)hdcmi->Init.SyncroCode.LineEndCode << 16) |
bogdanm 0:9b334a45a8ff 187 ((uint32_t)hdcmi->Init.SyncroCode.FrameEndCode << 24));
bogdanm 0:9b334a45a8ff 188 }
bogdanm 0:9b334a45a8ff 189
bogdanm 0:9b334a45a8ff 190 /* Enable the Line interrupt */
bogdanm 0:9b334a45a8ff 191 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_LINE);
bogdanm 0:9b334a45a8ff 192
bogdanm 0:9b334a45a8ff 193 /* Enable the VSYNC interrupt */
bogdanm 0:9b334a45a8ff 194 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_VSYNC);
bogdanm 0:9b334a45a8ff 195
bogdanm 0:9b334a45a8ff 196 /* Enable the Frame capture complete interrupt */
bogdanm 0:9b334a45a8ff 197 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_FRAME);
bogdanm 0:9b334a45a8ff 198
bogdanm 0:9b334a45a8ff 199 /* Enable the Synchronization error interrupt */
bogdanm 0:9b334a45a8ff 200 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_ERR);
bogdanm 0:9b334a45a8ff 201
bogdanm 0:9b334a45a8ff 202 /* Enable the Overflow interrupt */
bogdanm 0:9b334a45a8ff 203 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_OVF);
bogdanm 0:9b334a45a8ff 204
bogdanm 0:9b334a45a8ff 205 /* Enable DCMI by setting DCMIEN bit */
bogdanm 0:9b334a45a8ff 206 __HAL_DCMI_ENABLE(hdcmi);
bogdanm 0:9b334a45a8ff 207
bogdanm 0:9b334a45a8ff 208 /* Update error code */
bogdanm 0:9b334a45a8ff 209 hdcmi->ErrorCode = HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 210
bogdanm 0:9b334a45a8ff 211 /* Initialize the DCMI state*/
bogdanm 0:9b334a45a8ff 212 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 213
bogdanm 0:9b334a45a8ff 214 return HAL_OK;
bogdanm 0:9b334a45a8ff 215 }
bogdanm 0:9b334a45a8ff 216
bogdanm 0:9b334a45a8ff 217 /**
bogdanm 0:9b334a45a8ff 218 * @brief Deinitializes the DCMI peripheral registers to their default reset
bogdanm 0:9b334a45a8ff 219 * values.
bogdanm 0:9b334a45a8ff 220 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 221 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 222 * @retval HAL status
bogdanm 0:9b334a45a8ff 223 */
bogdanm 0:9b334a45a8ff 224
bogdanm 0:9b334a45a8ff 225 HAL_StatusTypeDef HAL_DCMI_DeInit(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 226 {
bogdanm 0:9b334a45a8ff 227 /* DeInit the low level hardware */
bogdanm 0:9b334a45a8ff 228 HAL_DCMI_MspDeInit(hdcmi);
bogdanm 0:9b334a45a8ff 229
bogdanm 0:9b334a45a8ff 230 /* Update error code */
bogdanm 0:9b334a45a8ff 231 hdcmi->ErrorCode = HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 232
bogdanm 0:9b334a45a8ff 233 /* Initialize the DCMI state*/
bogdanm 0:9b334a45a8ff 234 hdcmi->State = HAL_DCMI_STATE_RESET;
bogdanm 0:9b334a45a8ff 235
bogdanm 0:9b334a45a8ff 236 /* Release Lock */
bogdanm 0:9b334a45a8ff 237 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 238
bogdanm 0:9b334a45a8ff 239 return HAL_OK;
bogdanm 0:9b334a45a8ff 240 }
bogdanm 0:9b334a45a8ff 241
bogdanm 0:9b334a45a8ff 242 /**
bogdanm 0:9b334a45a8ff 243 * @brief Initializes the DCMI MSP.
bogdanm 0:9b334a45a8ff 244 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 245 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 246 * @retval None
bogdanm 0:9b334a45a8ff 247 */
bogdanm 0:9b334a45a8ff 248 __weak void HAL_DCMI_MspInit(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 249 {
bogdanm 0:9b334a45a8ff 250 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 251 the HAL_DCMI_MspInit could be implemented in the user file
bogdanm 0:9b334a45a8ff 252 */
bogdanm 0:9b334a45a8ff 253 }
bogdanm 0:9b334a45a8ff 254
bogdanm 0:9b334a45a8ff 255 /**
bogdanm 0:9b334a45a8ff 256 * @brief DeInitializes the DCMI MSP.
bogdanm 0:9b334a45a8ff 257 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 258 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 259 * @retval None
bogdanm 0:9b334a45a8ff 260 */
bogdanm 0:9b334a45a8ff 261 __weak void HAL_DCMI_MspDeInit(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 262 {
bogdanm 0:9b334a45a8ff 263 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 264 the HAL_DCMI_MspDeInit could be implemented in the user file
bogdanm 0:9b334a45a8ff 265 */
bogdanm 0:9b334a45a8ff 266 }
bogdanm 0:9b334a45a8ff 267
bogdanm 0:9b334a45a8ff 268 /**
bogdanm 0:9b334a45a8ff 269 * @}
bogdanm 0:9b334a45a8ff 270 */
bogdanm 0:9b334a45a8ff 271 /** @defgroup DCMI_Exported_Functions_Group2 IO operation functions
bogdanm 0:9b334a45a8ff 272 * @brief IO operation functions
bogdanm 0:9b334a45a8ff 273 *
bogdanm 0:9b334a45a8ff 274 @verbatim
bogdanm 0:9b334a45a8ff 275 ===============================================================================
bogdanm 0:9b334a45a8ff 276 ##### IO operation functions #####
bogdanm 0:9b334a45a8ff 277 ===============================================================================
bogdanm 0:9b334a45a8ff 278 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 279 (+) Configure destination address and data length and
bogdanm 0:9b334a45a8ff 280 Enables DCMI DMA request and enables DCMI capture
bogdanm 0:9b334a45a8ff 281 (+) Stop the DCMI capture.
bogdanm 0:9b334a45a8ff 282 (+) Handles DCMI interrupt request.
bogdanm 0:9b334a45a8ff 283
bogdanm 0:9b334a45a8ff 284 @endverbatim
bogdanm 0:9b334a45a8ff 285 * @{
bogdanm 0:9b334a45a8ff 286 */
bogdanm 0:9b334a45a8ff 287
bogdanm 0:9b334a45a8ff 288 /**
bogdanm 0:9b334a45a8ff 289 * @brief Enables DCMI DMA request and enables DCMI capture
bogdanm 0:9b334a45a8ff 290 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 291 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 292 * @param DCMI_Mode: DCMI capture mode snapshot or continuous grab.
bogdanm 0:9b334a45a8ff 293 * @param pData: The destination memory Buffer address (LCD Frame buffer).
bogdanm 0:9b334a45a8ff 294 * @param Length: The length of capture to be transferred.
bogdanm 0:9b334a45a8ff 295 * @retval HAL status
bogdanm 0:9b334a45a8ff 296 */
bogdanm 0:9b334a45a8ff 297 HAL_StatusTypeDef HAL_DCMI_Start_DMA(DCMI_HandleTypeDef* hdcmi, uint32_t DCMI_Mode, uint32_t pData, uint32_t Length)
bogdanm 0:9b334a45a8ff 298 {
bogdanm 0:9b334a45a8ff 299 /* Initialize the second memory address */
bogdanm 0:9b334a45a8ff 300 uint32_t SecondMemAddress = 0;
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 /* Check function parameters */
bogdanm 0:9b334a45a8ff 303 assert_param(IS_DCMI_CAPTURE_MODE(DCMI_Mode));
bogdanm 0:9b334a45a8ff 304
bogdanm 0:9b334a45a8ff 305 /* Process Locked */
bogdanm 0:9b334a45a8ff 306 __HAL_LOCK(hdcmi);
bogdanm 0:9b334a45a8ff 307
bogdanm 0:9b334a45a8ff 308 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 309 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 310
bogdanm 0:9b334a45a8ff 311 /* Check the parameters */
bogdanm 0:9b334a45a8ff 312 assert_param(IS_DCMI_CAPTURE_MODE(DCMI_Mode));
bogdanm 0:9b334a45a8ff 313
bogdanm 0:9b334a45a8ff 314 /* Configure the DCMI Mode */
bogdanm 0:9b334a45a8ff 315 hdcmi->Instance->CR &= ~(DCMI_CR_CM);
bogdanm 0:9b334a45a8ff 316 hdcmi->Instance->CR |= (uint32_t)(DCMI_Mode);
bogdanm 0:9b334a45a8ff 317
bogdanm 0:9b334a45a8ff 318 /* Set the DMA memory0 conversion complete callback */
bogdanm 0:9b334a45a8ff 319 hdcmi->DMA_Handle->XferCpltCallback = DCMI_DMAConvCplt;
bogdanm 0:9b334a45a8ff 320
bogdanm 0:9b334a45a8ff 321 /* Set the DMA error callback */
bogdanm 0:9b334a45a8ff 322 hdcmi->DMA_Handle->XferErrorCallback = DCMI_DMAError;
bogdanm 0:9b334a45a8ff 323
bogdanm 0:9b334a45a8ff 324 if(Length <= 0xFFFF)
bogdanm 0:9b334a45a8ff 325 {
bogdanm 0:9b334a45a8ff 326 /* Enable the DMA Stream */
bogdanm 0:9b334a45a8ff 327 HAL_DMA_Start_IT(hdcmi->DMA_Handle, (uint32_t)&hdcmi->Instance->DR, (uint32_t)pData, Length);
bogdanm 0:9b334a45a8ff 328 }
bogdanm 0:9b334a45a8ff 329 else /* DCMI_DOUBLE_BUFFER Mode */
bogdanm 0:9b334a45a8ff 330 {
bogdanm 0:9b334a45a8ff 331 /* Set the DMA memory1 conversion complete callback */
bogdanm 0:9b334a45a8ff 332 hdcmi->DMA_Handle->XferM1CpltCallback = DCMI_DMAConvCplt;
bogdanm 0:9b334a45a8ff 333
bogdanm 0:9b334a45a8ff 334 /* Initialize transfer parameters */
bogdanm 0:9b334a45a8ff 335 hdcmi->XferCount = 1;
bogdanm 0:9b334a45a8ff 336 hdcmi->XferSize = Length;
bogdanm 0:9b334a45a8ff 337 hdcmi->pBuffPtr = pData;
bogdanm 0:9b334a45a8ff 338
bogdanm 0:9b334a45a8ff 339 /* Get the number of buffer */
bogdanm 0:9b334a45a8ff 340 while(hdcmi->XferSize > 0xFFFF)
bogdanm 0:9b334a45a8ff 341 {
bogdanm 0:9b334a45a8ff 342 hdcmi->XferSize = (hdcmi->XferSize/2);
bogdanm 0:9b334a45a8ff 343 hdcmi->XferCount = hdcmi->XferCount*2;
bogdanm 0:9b334a45a8ff 344 }
bogdanm 0:9b334a45a8ff 345
bogdanm 0:9b334a45a8ff 346 /* Update DCMI counter and transfer number*/
bogdanm 0:9b334a45a8ff 347 hdcmi->XferCount = (hdcmi->XferCount - 2);
bogdanm 0:9b334a45a8ff 348 hdcmi->XferTransferNumber = hdcmi->XferCount;
bogdanm 0:9b334a45a8ff 349
bogdanm 0:9b334a45a8ff 350 /* Update second memory address */
bogdanm 0:9b334a45a8ff 351 SecondMemAddress = (uint32_t)(pData + (4*hdcmi->XferSize));
bogdanm 0:9b334a45a8ff 352
bogdanm 0:9b334a45a8ff 353 /* Start DMA multi buffer transfer */
bogdanm 0:9b334a45a8ff 354 HAL_DMAEx_MultiBufferStart_IT(hdcmi->DMA_Handle, (uint32_t)&hdcmi->Instance->DR, (uint32_t)pData, SecondMemAddress, hdcmi->XferSize);
bogdanm 0:9b334a45a8ff 355 }
bogdanm 0:9b334a45a8ff 356
bogdanm 0:9b334a45a8ff 357 /* Enable Capture */
bogdanm 0:9b334a45a8ff 358 DCMI->CR |= DCMI_CR_CAPTURE;
bogdanm 0:9b334a45a8ff 359
bogdanm 0:9b334a45a8ff 360 /* Return function status */
bogdanm 0:9b334a45a8ff 361 return HAL_OK;
bogdanm 0:9b334a45a8ff 362 }
bogdanm 0:9b334a45a8ff 363
bogdanm 0:9b334a45a8ff 364 /**
bogdanm 0:9b334a45a8ff 365 * @brief Disable DCMI DMA request and Disable DCMI capture
bogdanm 0:9b334a45a8ff 366 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 367 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 368 * @retval HAL status
bogdanm 0:9b334a45a8ff 369 */
bogdanm 0:9b334a45a8ff 370 HAL_StatusTypeDef HAL_DCMI_Stop(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 371 {
bogdanm 0:9b334a45a8ff 372 uint32_t tickstart = 0;
bogdanm 0:9b334a45a8ff 373
bogdanm 0:9b334a45a8ff 374 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 375 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 376
bogdanm 0:9b334a45a8ff 377 __HAL_DCMI_DISABLE(hdcmi);
bogdanm 0:9b334a45a8ff 378
bogdanm 0:9b334a45a8ff 379 /* Disable Capture */
bogdanm 0:9b334a45a8ff 380 DCMI->CR &= ~(DCMI_CR_CAPTURE);
bogdanm 0:9b334a45a8ff 381
bogdanm 0:9b334a45a8ff 382 /* Get tick */
bogdanm 0:9b334a45a8ff 383 tickstart = HAL_GetTick();
bogdanm 0:9b334a45a8ff 384
bogdanm 0:9b334a45a8ff 385 /* Check if the DCMI capture effectively disabled */
bogdanm 0:9b334a45a8ff 386 while((hdcmi->Instance->CR & DCMI_CR_CAPTURE) != 0)
bogdanm 0:9b334a45a8ff 387 {
bogdanm 0:9b334a45a8ff 388 if((HAL_GetTick() - tickstart ) > HAL_TIMEOUT_DCMI_STOP)
bogdanm 0:9b334a45a8ff 389 {
bogdanm 0:9b334a45a8ff 390 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 391 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 392
bogdanm 0:9b334a45a8ff 393 /* Update error code */
bogdanm 0:9b334a45a8ff 394 hdcmi->ErrorCode |= HAL_DCMI_ERROR_TIMEOUT;
bogdanm 0:9b334a45a8ff 395
bogdanm 0:9b334a45a8ff 396 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 397 hdcmi->State = HAL_DCMI_STATE_TIMEOUT;
bogdanm 0:9b334a45a8ff 398
bogdanm 0:9b334a45a8ff 399 return HAL_TIMEOUT;
bogdanm 0:9b334a45a8ff 400 }
bogdanm 0:9b334a45a8ff 401 }
bogdanm 0:9b334a45a8ff 402
bogdanm 0:9b334a45a8ff 403 /* Disable the DMA */
bogdanm 0:9b334a45a8ff 404 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 405
bogdanm 0:9b334a45a8ff 406 /* Update error code */
bogdanm 0:9b334a45a8ff 407 hdcmi->ErrorCode |= HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 408
bogdanm 0:9b334a45a8ff 409 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 410 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 411
bogdanm 0:9b334a45a8ff 412 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 413 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 414
bogdanm 0:9b334a45a8ff 415 /* Return function status */
bogdanm 0:9b334a45a8ff 416 return HAL_OK;
bogdanm 0:9b334a45a8ff 417 }
bogdanm 0:9b334a45a8ff 418
bogdanm 0:9b334a45a8ff 419 /**
bogdanm 0:9b334a45a8ff 420 * @brief Handles DCMI interrupt request.
bogdanm 0:9b334a45a8ff 421 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 422 * the configuration information for the DCMI.
bogdanm 0:9b334a45a8ff 423 * @retval None
bogdanm 0:9b334a45a8ff 424 */
bogdanm 0:9b334a45a8ff 425 void HAL_DCMI_IRQHandler(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 426 {
bogdanm 0:9b334a45a8ff 427 /* Synchronization error interrupt management *******************************/
bogdanm 0:9b334a45a8ff 428 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_ERRRI) != RESET)
bogdanm 0:9b334a45a8ff 429 {
bogdanm 0:9b334a45a8ff 430 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_ERR) != RESET)
bogdanm 0:9b334a45a8ff 431 {
bogdanm 0:9b334a45a8ff 432 /* Disable the Synchronization error interrupt */
bogdanm 0:9b334a45a8ff 433 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_ERR);
bogdanm 0:9b334a45a8ff 434
bogdanm 0:9b334a45a8ff 435 /* Clear the Synchronization error flag */
bogdanm 0:9b334a45a8ff 436 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_ERRRI);
bogdanm 0:9b334a45a8ff 437
bogdanm 0:9b334a45a8ff 438 /* Update error code */
bogdanm 0:9b334a45a8ff 439 hdcmi->ErrorCode |= HAL_DCMI_ERROR_SYNC;
bogdanm 0:9b334a45a8ff 440
bogdanm 0:9b334a45a8ff 441 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 442 hdcmi->State = HAL_DCMI_STATE_ERROR;
bogdanm 0:9b334a45a8ff 443
bogdanm 0:9b334a45a8ff 444 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 445 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 446
bogdanm 0:9b334a45a8ff 447 /* Abort the DMA Transfer */
bogdanm 0:9b334a45a8ff 448 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 449
bogdanm 0:9b334a45a8ff 450 /* Synchronization error Callback */
bogdanm 0:9b334a45a8ff 451 HAL_DCMI_ErrorCallback(hdcmi);
bogdanm 0:9b334a45a8ff 452 }
bogdanm 0:9b334a45a8ff 453 }
bogdanm 0:9b334a45a8ff 454 /* Overflow interrupt management ********************************************/
bogdanm 0:9b334a45a8ff 455 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_OVFRI) != RESET)
bogdanm 0:9b334a45a8ff 456 {
bogdanm 0:9b334a45a8ff 457 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_OVF) != RESET)
bogdanm 0:9b334a45a8ff 458 {
bogdanm 0:9b334a45a8ff 459 /* Disable the Overflow interrupt */
bogdanm 0:9b334a45a8ff 460 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_OVF);
bogdanm 0:9b334a45a8ff 461
bogdanm 0:9b334a45a8ff 462 /* Clear the Overflow flag */
bogdanm 0:9b334a45a8ff 463 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_OVFRI);
bogdanm 0:9b334a45a8ff 464
bogdanm 0:9b334a45a8ff 465 /* Update error code */
bogdanm 0:9b334a45a8ff 466 hdcmi->ErrorCode |= HAL_DCMI_ERROR_OVF;
bogdanm 0:9b334a45a8ff 467
bogdanm 0:9b334a45a8ff 468 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 469 hdcmi->State = HAL_DCMI_STATE_ERROR;
bogdanm 0:9b334a45a8ff 470
bogdanm 0:9b334a45a8ff 471 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 472 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 473
bogdanm 0:9b334a45a8ff 474 /* Abort the DMA Transfer */
bogdanm 0:9b334a45a8ff 475 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 476
bogdanm 0:9b334a45a8ff 477 /* Overflow Callback */
bogdanm 0:9b334a45a8ff 478 HAL_DCMI_ErrorCallback(hdcmi);
bogdanm 0:9b334a45a8ff 479 }
bogdanm 0:9b334a45a8ff 480 }
bogdanm 0:9b334a45a8ff 481 /* Line Interrupt management ************************************************/
bogdanm 0:9b334a45a8ff 482 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_LINERI) != RESET)
bogdanm 0:9b334a45a8ff 483 {
bogdanm 0:9b334a45a8ff 484 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_LINE) != RESET)
bogdanm 0:9b334a45a8ff 485 {
bogdanm 0:9b334a45a8ff 486 /* Clear the Line interrupt flag */
bogdanm 0:9b334a45a8ff 487 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_LINERI);
bogdanm 0:9b334a45a8ff 488
bogdanm 0:9b334a45a8ff 489 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 490 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 491
bogdanm 0:9b334a45a8ff 492 /* Line interrupt Callback */
bogdanm 0:9b334a45a8ff 493 HAL_DCMI_LineEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 494 }
bogdanm 0:9b334a45a8ff 495 }
bogdanm 0:9b334a45a8ff 496 /* VSYNC interrupt management ***********************************************/
bogdanm 0:9b334a45a8ff 497 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_VSYNCRI) != RESET)
bogdanm 0:9b334a45a8ff 498 {
bogdanm 0:9b334a45a8ff 499 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_VSYNC) != RESET)
bogdanm 0:9b334a45a8ff 500 {
bogdanm 0:9b334a45a8ff 501 /* Disable the VSYNC interrupt */
bogdanm 0:9b334a45a8ff 502 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_VSYNC);
bogdanm 0:9b334a45a8ff 503
bogdanm 0:9b334a45a8ff 504 /* Clear the VSYNC flag */
bogdanm 0:9b334a45a8ff 505 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_VSYNCRI);
bogdanm 0:9b334a45a8ff 506
bogdanm 0:9b334a45a8ff 507 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 508 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 509
bogdanm 0:9b334a45a8ff 510 /* VSYNC Callback */
bogdanm 0:9b334a45a8ff 511 HAL_DCMI_VsyncEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 512 }
bogdanm 0:9b334a45a8ff 513 }
bogdanm 0:9b334a45a8ff 514 /* End of Frame interrupt management ****************************************/
bogdanm 0:9b334a45a8ff 515 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_FRAMERI) != RESET)
bogdanm 0:9b334a45a8ff 516 {
bogdanm 0:9b334a45a8ff 517 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_FRAME) != RESET)
bogdanm 0:9b334a45a8ff 518 {
bogdanm 0:9b334a45a8ff 519 /* Disable the End of Frame interrupt */
bogdanm 0:9b334a45a8ff 520 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_FRAME);
bogdanm 0:9b334a45a8ff 521
bogdanm 0:9b334a45a8ff 522 /* Clear the End of Frame flag */
bogdanm 0:9b334a45a8ff 523 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_FRAMERI);
bogdanm 0:9b334a45a8ff 524
bogdanm 0:9b334a45a8ff 525 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 526 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 527
bogdanm 0:9b334a45a8ff 528 /* End of Frame Callback */
bogdanm 0:9b334a45a8ff 529 HAL_DCMI_FrameEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 530 }
bogdanm 0:9b334a45a8ff 531 }
bogdanm 0:9b334a45a8ff 532 }
bogdanm 0:9b334a45a8ff 533
bogdanm 0:9b334a45a8ff 534 /**
bogdanm 0:9b334a45a8ff 535 * @brief Error DCMI callback.
bogdanm 0:9b334a45a8ff 536 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 537 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 538 * @retval None
bogdanm 0:9b334a45a8ff 539 */
bogdanm 0:9b334a45a8ff 540 __weak void HAL_DCMI_ErrorCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 541 {
bogdanm 0:9b334a45a8ff 542 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 543 the HAL_DCMI_ErrorCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 544 */
bogdanm 0:9b334a45a8ff 545 }
bogdanm 0:9b334a45a8ff 546
bogdanm 0:9b334a45a8ff 547 /**
bogdanm 0:9b334a45a8ff 548 * @brief Line Event callback.
bogdanm 0:9b334a45a8ff 549 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 550 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 551 * @retval None
bogdanm 0:9b334a45a8ff 552 */
bogdanm 0:9b334a45a8ff 553 __weak void HAL_DCMI_LineEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 554 {
bogdanm 0:9b334a45a8ff 555 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 556 the HAL_DCMI_LineEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 557 */
bogdanm 0:9b334a45a8ff 558 }
bogdanm 0:9b334a45a8ff 559
bogdanm 0:9b334a45a8ff 560 /**
bogdanm 0:9b334a45a8ff 561 * @brief VSYNC Event callback.
bogdanm 0:9b334a45a8ff 562 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 563 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 564 * @retval None
bogdanm 0:9b334a45a8ff 565 */
bogdanm 0:9b334a45a8ff 566 __weak void HAL_DCMI_VsyncEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 567 {
bogdanm 0:9b334a45a8ff 568 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 569 the HAL_DCMI_VsyncEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 570 */
bogdanm 0:9b334a45a8ff 571 }
bogdanm 0:9b334a45a8ff 572
bogdanm 0:9b334a45a8ff 573 /**
bogdanm 0:9b334a45a8ff 574 * @brief Frame Event callback.
bogdanm 0:9b334a45a8ff 575 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 576 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 577 * @retval None
bogdanm 0:9b334a45a8ff 578 */
bogdanm 0:9b334a45a8ff 579 __weak void HAL_DCMI_FrameEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 580 {
bogdanm 0:9b334a45a8ff 581 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 582 the HAL_DCMI_FrameEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 583 */
bogdanm 0:9b334a45a8ff 584 }
bogdanm 0:9b334a45a8ff 585
bogdanm 0:9b334a45a8ff 586 /**
bogdanm 0:9b334a45a8ff 587 * @}
bogdanm 0:9b334a45a8ff 588 */
bogdanm 0:9b334a45a8ff 589
bogdanm 0:9b334a45a8ff 590 /** @defgroup DCMI_Exported_Functions_Group3 Peripheral Control functions
bogdanm 0:9b334a45a8ff 591 * @brief Peripheral Control functions
bogdanm 0:9b334a45a8ff 592 *
bogdanm 0:9b334a45a8ff 593 @verbatim
bogdanm 0:9b334a45a8ff 594 ===============================================================================
bogdanm 0:9b334a45a8ff 595 ##### Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 596 ===============================================================================
bogdanm 0:9b334a45a8ff 597 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 598 (+) Configure the CROP feature.
bogdanm 0:9b334a45a8ff 599 (+) Enable/Disable the CROP feature.
bogdanm 0:9b334a45a8ff 600 (+) Enable/Disable the JPEG feature.
bogdanm 0:9b334a45a8ff 601
bogdanm 0:9b334a45a8ff 602 @endverbatim
bogdanm 0:9b334a45a8ff 603 * @{
bogdanm 0:9b334a45a8ff 604 */
bogdanm 0:9b334a45a8ff 605
bogdanm 0:9b334a45a8ff 606 /**
bogdanm 0:9b334a45a8ff 607 * @brief Configure the DCMI CROP coordinate.
bogdanm 0:9b334a45a8ff 608 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 609 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 610 * @param YSize: DCMI Line number
bogdanm 0:9b334a45a8ff 611 * @param XSize: DCMI Pixel per line
bogdanm 0:9b334a45a8ff 612 * @param X0: DCMI window X offset
bogdanm 0:9b334a45a8ff 613 * @param Y0: DCMI window Y offset
bogdanm 0:9b334a45a8ff 614 * @retval HAL status
bogdanm 0:9b334a45a8ff 615 */
bogdanm 0:9b334a45a8ff 616 HAL_StatusTypeDef HAL_DCMI_ConfigCROP(DCMI_HandleTypeDef *hdcmi, uint32_t X0, uint32_t Y0, uint32_t XSize, uint32_t YSize)
bogdanm 0:9b334a45a8ff 617 {
bogdanm 0:9b334a45a8ff 618 /* Process Locked */
bogdanm 0:9b334a45a8ff 619 __HAL_LOCK(hdcmi);
bogdanm 0:9b334a45a8ff 620
bogdanm 0:9b334a45a8ff 621 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 622 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 623
bogdanm 0:9b334a45a8ff 624 /* Check the parameters */
bogdanm 0:9b334a45a8ff 625 assert_param(IS_DCMI_WINDOW_COORDINATE(X0));
bogdanm 0:9b334a45a8ff 626 assert_param(IS_DCMI_WINDOW_HEIGHT(Y0));
bogdanm 0:9b334a45a8ff 627 assert_param(IS_DCMI_WINDOW_COORDINATE(XSize));
bogdanm 0:9b334a45a8ff 628 assert_param(IS_DCMI_WINDOW_COORDINATE(YSize));
bogdanm 0:9b334a45a8ff 629
bogdanm 0:9b334a45a8ff 630 /* Configure CROP */
bogdanm 0:9b334a45a8ff 631 DCMI->CWSIZER = (XSize | (YSize << 16));
bogdanm 0:9b334a45a8ff 632 DCMI->CWSTRTR = (X0 | (Y0 << 16));
bogdanm 0:9b334a45a8ff 633
bogdanm 0:9b334a45a8ff 634 /* Initialize the DCMI state*/
bogdanm 0:9b334a45a8ff 635 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 636
bogdanm 0:9b334a45a8ff 637 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 638 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 639
bogdanm 0:9b334a45a8ff 640 return HAL_OK;
bogdanm 0:9b334a45a8ff 641 }
bogdanm 0:9b334a45a8ff 642
bogdanm 0:9b334a45a8ff 643 /**
bogdanm 0:9b334a45a8ff 644 * @brief Disable the Crop feature.
bogdanm 0:9b334a45a8ff 645 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 646 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 647 * @retval HAL status
bogdanm 0:9b334a45a8ff 648 */
bogdanm 0:9b334a45a8ff 649 HAL_StatusTypeDef HAL_DCMI_DisableCROP(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 650 {
bogdanm 0:9b334a45a8ff 651 /* Process Locked */
bogdanm 0:9b334a45a8ff 652 __HAL_LOCK(hdcmi);
bogdanm 0:9b334a45a8ff 653
bogdanm 0:9b334a45a8ff 654 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 655 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 656
bogdanm 0:9b334a45a8ff 657 /* Disable DCMI Crop feature */
bogdanm 0:9b334a45a8ff 658 DCMI->CR &= ~(uint32_t)DCMI_CR_CROP;
bogdanm 0:9b334a45a8ff 659
bogdanm 0:9b334a45a8ff 660 /* Change the DCMI state*/
bogdanm 0:9b334a45a8ff 661 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 662
bogdanm 0:9b334a45a8ff 663 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 664 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 665
bogdanm 0:9b334a45a8ff 666 return HAL_OK;
bogdanm 0:9b334a45a8ff 667 }
bogdanm 0:9b334a45a8ff 668
bogdanm 0:9b334a45a8ff 669 /**
bogdanm 0:9b334a45a8ff 670 * @brief Enable the Crop feature.
bogdanm 0:9b334a45a8ff 671 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 672 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 673 * @retval HAL status
bogdanm 0:9b334a45a8ff 674 */
bogdanm 0:9b334a45a8ff 675 HAL_StatusTypeDef HAL_DCMI_EnableCROP(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 676 {
bogdanm 0:9b334a45a8ff 677 /* Process Locked */
bogdanm 0:9b334a45a8ff 678 __HAL_LOCK(hdcmi);
bogdanm 0:9b334a45a8ff 679
bogdanm 0:9b334a45a8ff 680 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 681 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 682
bogdanm 0:9b334a45a8ff 683 /* Enable DCMI Crop feature */
bogdanm 0:9b334a45a8ff 684 DCMI->CR |= (uint32_t)DCMI_CR_CROP;
bogdanm 0:9b334a45a8ff 685
bogdanm 0:9b334a45a8ff 686 /* Change the DCMI state*/
bogdanm 0:9b334a45a8ff 687 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 688
bogdanm 0:9b334a45a8ff 689 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 690 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 691
bogdanm 0:9b334a45a8ff 692 return HAL_OK;
bogdanm 0:9b334a45a8ff 693 }
bogdanm 0:9b334a45a8ff 694
bogdanm 0:9b334a45a8ff 695 /**
bogdanm 0:9b334a45a8ff 696 * @}
bogdanm 0:9b334a45a8ff 697 */
bogdanm 0:9b334a45a8ff 698
bogdanm 0:9b334a45a8ff 699 /** @defgroup DCMI_Exported_Functions_Group4 Peripheral State functions
bogdanm 0:9b334a45a8ff 700 * @brief Peripheral State functions
bogdanm 0:9b334a45a8ff 701 *
bogdanm 0:9b334a45a8ff 702 @verbatim
bogdanm 0:9b334a45a8ff 703 ===============================================================================
bogdanm 0:9b334a45a8ff 704 ##### Peripheral State and Errors functions #####
bogdanm 0:9b334a45a8ff 705 ===============================================================================
bogdanm 0:9b334a45a8ff 706 [..]
bogdanm 0:9b334a45a8ff 707 This subsection provides functions allowing to
bogdanm 0:9b334a45a8ff 708 (+) Check the DCMI state.
bogdanm 0:9b334a45a8ff 709 (+) Get the specific DCMI error flag.
bogdanm 0:9b334a45a8ff 710
bogdanm 0:9b334a45a8ff 711 @endverbatim
bogdanm 0:9b334a45a8ff 712 * @{
bogdanm 0:9b334a45a8ff 713 */
bogdanm 0:9b334a45a8ff 714
bogdanm 0:9b334a45a8ff 715 /**
bogdanm 0:9b334a45a8ff 716 * @brief Return the DCMI state
bogdanm 0:9b334a45a8ff 717 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 718 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 719 * @retval HAL state
bogdanm 0:9b334a45a8ff 720 */
bogdanm 0:9b334a45a8ff 721 HAL_DCMI_StateTypeDef HAL_DCMI_GetState(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 722 {
bogdanm 0:9b334a45a8ff 723 return hdcmi->State;
bogdanm 0:9b334a45a8ff 724 }
bogdanm 0:9b334a45a8ff 725
bogdanm 0:9b334a45a8ff 726 /**
bogdanm 0:9b334a45a8ff 727 * @brief Return the DCMI error code
bogdanm 0:9b334a45a8ff 728 * @param hdcmi : pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 729 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 730 * @retval DCMI Error Code
bogdanm 0:9b334a45a8ff 731 */
bogdanm 0:9b334a45a8ff 732 uint32_t HAL_DCMI_GetError(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 733 {
bogdanm 0:9b334a45a8ff 734 return hdcmi->ErrorCode;
bogdanm 0:9b334a45a8ff 735 }
bogdanm 0:9b334a45a8ff 736
bogdanm 0:9b334a45a8ff 737 /**
bogdanm 0:9b334a45a8ff 738 * @}
bogdanm 0:9b334a45a8ff 739 */
bogdanm 0:9b334a45a8ff 740 /* Private functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 741 /** @defgroup DCMI_Private_Functions DCMI Private Functions
bogdanm 0:9b334a45a8ff 742 * @{
bogdanm 0:9b334a45a8ff 743 */
bogdanm 0:9b334a45a8ff 744 /**
bogdanm 0:9b334a45a8ff 745 * @brief DMA conversion complete callback.
bogdanm 0:9b334a45a8ff 746 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 747 * the configuration information for the specified DMA module.
bogdanm 0:9b334a45a8ff 748 * @retval None
bogdanm 0:9b334a45a8ff 749 */
bogdanm 0:9b334a45a8ff 750 static void DCMI_DMAConvCplt(DMA_HandleTypeDef *hdma)
bogdanm 0:9b334a45a8ff 751 {
bogdanm 0:9b334a45a8ff 752 uint32_t tmp = 0;
bogdanm 0:9b334a45a8ff 753
bogdanm 0:9b334a45a8ff 754 DCMI_HandleTypeDef* hdcmi = ( DCMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm 0:9b334a45a8ff 755 hdcmi->State= HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 756
bogdanm 0:9b334a45a8ff 757 if(hdcmi->XferCount != 0)
bogdanm 0:9b334a45a8ff 758 {
bogdanm 0:9b334a45a8ff 759 /* Update memory 0 address location */
bogdanm 0:9b334a45a8ff 760 tmp = ((hdcmi->DMA_Handle->Instance->CR) & DMA_SxCR_CT);
bogdanm 0:9b334a45a8ff 761 if(((hdcmi->XferCount % 2) == 0) && (tmp != 0))
bogdanm 0:9b334a45a8ff 762 {
bogdanm 0:9b334a45a8ff 763 tmp = hdcmi->DMA_Handle->Instance->M0AR;
bogdanm 0:9b334a45a8ff 764 HAL_DMAEx_ChangeMemory(hdcmi->DMA_Handle, (tmp + (8*hdcmi->XferSize)), MEMORY0);
bogdanm 0:9b334a45a8ff 765 hdcmi->XferCount--;
bogdanm 0:9b334a45a8ff 766 }
bogdanm 0:9b334a45a8ff 767 /* Update memory 1 address location */
bogdanm 0:9b334a45a8ff 768 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) == 0)
bogdanm 0:9b334a45a8ff 769 {
bogdanm 0:9b334a45a8ff 770 tmp = hdcmi->DMA_Handle->Instance->M1AR;
bogdanm 0:9b334a45a8ff 771 HAL_DMAEx_ChangeMemory(hdcmi->DMA_Handle, (tmp + (8*hdcmi->XferSize)), MEMORY1);
bogdanm 0:9b334a45a8ff 772 hdcmi->XferCount--;
bogdanm 0:9b334a45a8ff 773 }
bogdanm 0:9b334a45a8ff 774 }
bogdanm 0:9b334a45a8ff 775 /* Update memory 0 address location */
bogdanm 0:9b334a45a8ff 776 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) != 0)
bogdanm 0:9b334a45a8ff 777 {
bogdanm 0:9b334a45a8ff 778 hdcmi->DMA_Handle->Instance->M0AR = hdcmi->pBuffPtr;
bogdanm 0:9b334a45a8ff 779 }
bogdanm 0:9b334a45a8ff 780 /* Update memory 1 address location */
bogdanm 0:9b334a45a8ff 781 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) == 0)
bogdanm 0:9b334a45a8ff 782 {
bogdanm 0:9b334a45a8ff 783 tmp = hdcmi->pBuffPtr;
bogdanm 0:9b334a45a8ff 784 hdcmi->DMA_Handle->Instance->M1AR = (tmp + (4*hdcmi->XferSize));
bogdanm 0:9b334a45a8ff 785 hdcmi->XferCount = hdcmi->XferTransferNumber;
bogdanm 0:9b334a45a8ff 786 }
bogdanm 0:9b334a45a8ff 787
bogdanm 0:9b334a45a8ff 788 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_FRAMERI) != RESET)
bogdanm 0:9b334a45a8ff 789 {
bogdanm 0:9b334a45a8ff 790 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 791 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 792
bogdanm 0:9b334a45a8ff 793 /* FRAME Callback */
bogdanm 0:9b334a45a8ff 794 HAL_DCMI_FrameEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 795 }
bogdanm 0:9b334a45a8ff 796 }
bogdanm 0:9b334a45a8ff 797
bogdanm 0:9b334a45a8ff 798 /**
bogdanm 0:9b334a45a8ff 799 * @brief DMA error callback
bogdanm 0:9b334a45a8ff 800 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 801 * the configuration information for the specified DMA module.
bogdanm 0:9b334a45a8ff 802 * @retval None
bogdanm 0:9b334a45a8ff 803 */
bogdanm 0:9b334a45a8ff 804 static void DCMI_DMAError(DMA_HandleTypeDef *hdma)
bogdanm 0:9b334a45a8ff 805 {
bogdanm 0:9b334a45a8ff 806 DCMI_HandleTypeDef* hdcmi = ( DCMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm 0:9b334a45a8ff 807 hdcmi->State= HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 808 HAL_DCMI_ErrorCallback(hdcmi);
bogdanm 0:9b334a45a8ff 809 }
bogdanm 0:9b334a45a8ff 810
bogdanm 0:9b334a45a8ff 811 /**
bogdanm 0:9b334a45a8ff 812 * @}
bogdanm 0:9b334a45a8ff 813 */
bogdanm 0:9b334a45a8ff 814
bogdanm 0:9b334a45a8ff 815 /**
bogdanm 0:9b334a45a8ff 816 * @}
bogdanm 0:9b334a45a8ff 817 */
bogdanm 0:9b334a45a8ff 818 #endif /* HAL_DCMI_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 819 /**
bogdanm 0:9b334a45a8ff 820 * @}
bogdanm 0:9b334a45a8ff 821 */
bogdanm 0:9b334a45a8ff 822
bogdanm 0:9b334a45a8ff 823 /**
bogdanm 0:9b334a45a8ff 824 * @}
bogdanm 0:9b334a45a8ff 825 */
bogdanm 0:9b334a45a8ff 826
bogdanm 0:9b334a45a8ff 827 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/