en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

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

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
19:112740acecfa
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 stm32f4xx_hal_dcmi.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.3.2
bogdanm 0:9b334a45a8ff 6 * @date 26-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 "stm32f4xx_hal.h"
bogdanm 0:9b334a45a8ff 95
bogdanm 0:9b334a45a8ff 96 /** @addtogroup STM32F4xx_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 #if defined(STM32F407xx) || defined(STM32F417xx) || defined(STM32F427xx) || defined(STM32F437xx) ||\
bogdanm 0:9b334a45a8ff 107 defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F446xx)
bogdanm 0:9b334a45a8ff 108 /* Private typedef -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 109 /* Private define ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 110 #define HAL_TIMEOUT_DCMI_STOP ((uint32_t)1000) /* 1s */
bogdanm 0:9b334a45a8ff 111 /* Private macro -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 112 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 113 /* Private function prototypes -----------------------------------------------*/
bogdanm 0:9b334a45a8ff 114 static void DCMI_DMAConvCplt(DMA_HandleTypeDef *hdma);
bogdanm 0:9b334a45a8ff 115 static void DCMI_DMAError(DMA_HandleTypeDef *hdma);
bogdanm 0:9b334a45a8ff 116
bogdanm 0:9b334a45a8ff 117 /* Exported functions --------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 118
bogdanm 0:9b334a45a8ff 119 /** @defgroup DCMI_Exported_Functions DCMI Exported Functions
bogdanm 0:9b334a45a8ff 120 * @{
bogdanm 0:9b334a45a8ff 121 */
bogdanm 0:9b334a45a8ff 122
bogdanm 0:9b334a45a8ff 123 /** @defgroup DCMI_Exported_Functions_Group1 Initialization and Configuration functions
bogdanm 0:9b334a45a8ff 124 * @brief Initialization and Configuration functions
bogdanm 0:9b334a45a8ff 125 *
bogdanm 0:9b334a45a8ff 126 @verbatim
bogdanm 0:9b334a45a8ff 127 ===============================================================================
bogdanm 0:9b334a45a8ff 128 ##### Initialization and Configuration functions #####
bogdanm 0:9b334a45a8ff 129 ===============================================================================
bogdanm 0:9b334a45a8ff 130 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 131 (+) Initialize and configure the DCMI
bogdanm 0:9b334a45a8ff 132 (+) De-initialize the DCMI
bogdanm 0:9b334a45a8ff 133
bogdanm 0:9b334a45a8ff 134 @endverbatim
bogdanm 0:9b334a45a8ff 135 * @{
bogdanm 0:9b334a45a8ff 136 */
bogdanm 0:9b334a45a8ff 137
bogdanm 0:9b334a45a8ff 138 /**
bogdanm 0:9b334a45a8ff 139 * @brief Initializes the DCMI according to the specified
bogdanm 0:9b334a45a8ff 140 * parameters in the DCMI_InitTypeDef and create the associated handle.
bogdanm 0:9b334a45a8ff 141 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 142 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 143 * @retval HAL status
bogdanm 0:9b334a45a8ff 144 */
bogdanm 0:9b334a45a8ff 145 __weak HAL_StatusTypeDef HAL_DCMI_Init(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 146 {
bogdanm 0:9b334a45a8ff 147 /* Check the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 148 if(hdcmi == NULL)
bogdanm 0:9b334a45a8ff 149 {
bogdanm 0:9b334a45a8ff 150 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 151 }
bogdanm 0:9b334a45a8ff 152
bogdanm 0:9b334a45a8ff 153 /* Check function parameters */
bogdanm 0:9b334a45a8ff 154 assert_param(IS_DCMI_ALL_INSTANCE(hdcmi->Instance));
bogdanm 0:9b334a45a8ff 155 assert_param(IS_DCMI_PCKPOLARITY(hdcmi->Init.PCKPolarity));
bogdanm 0:9b334a45a8ff 156 assert_param(IS_DCMI_VSPOLARITY(hdcmi->Init.VSPolarity));
bogdanm 0:9b334a45a8ff 157 assert_param(IS_DCMI_HSPOLARITY(hdcmi->Init.HSPolarity));
bogdanm 0:9b334a45a8ff 158 assert_param(IS_DCMI_SYNCHRO(hdcmi->Init.SynchroMode));
bogdanm 0:9b334a45a8ff 159 assert_param(IS_DCMI_CAPTURE_RATE(hdcmi->Init.CaptureRate));
bogdanm 0:9b334a45a8ff 160 assert_param(IS_DCMI_EXTENDED_DATA(hdcmi->Init.ExtendedDataMode));
bogdanm 0:9b334a45a8ff 161 assert_param(IS_DCMI_MODE_JPEG(hdcmi->Init.JPEGMode));
bogdanm 0:9b334a45a8ff 162
bogdanm 0:9b334a45a8ff 163 if(hdcmi->State == HAL_DCMI_STATE_RESET)
bogdanm 0:9b334a45a8ff 164 {
bogdanm 0:9b334a45a8ff 165 /* Allocate lock resource and initialize it */
bogdanm 0:9b334a45a8ff 166 hdcmi->Lock = HAL_UNLOCKED;
bogdanm 0:9b334a45a8ff 167 /* Init the low level hardware */
bogdanm 0:9b334a45a8ff 168 HAL_DCMI_MspInit(hdcmi);
bogdanm 0:9b334a45a8ff 169 }
bogdanm 0:9b334a45a8ff 170
bogdanm 0:9b334a45a8ff 171 /* Change the DCMI state */
bogdanm 0:9b334a45a8ff 172 hdcmi->State = HAL_DCMI_STATE_BUSY;
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
bogdanm 0:9b334a45a8ff 191 /* Enable the Line interrupt */
bogdanm 0:9b334a45a8ff 192 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_LINE);
bogdanm 0:9b334a45a8ff 193
bogdanm 0:9b334a45a8ff 194 /* Enable the VSYNC interrupt */
bogdanm 0:9b334a45a8ff 195 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_VSYNC);
bogdanm 0:9b334a45a8ff 196
bogdanm 0:9b334a45a8ff 197 /* Enable the Frame capture complete interrupt */
bogdanm 0:9b334a45a8ff 198 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_FRAME);
bogdanm 0:9b334a45a8ff 199
bogdanm 0:9b334a45a8ff 200 /* Enable the Synchronization error interrupt */
bogdanm 0:9b334a45a8ff 201 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_ERR);
bogdanm 0:9b334a45a8ff 202
bogdanm 0:9b334a45a8ff 203 /* Enable the Overflow interrupt */
bogdanm 0:9b334a45a8ff 204 __HAL_DCMI_ENABLE_IT(hdcmi, DCMI_IT_OVF);
bogdanm 0:9b334a45a8ff 205
bogdanm 0:9b334a45a8ff 206 /* Enable DCMI by setting DCMIEN bit */
bogdanm 0:9b334a45a8ff 207 __HAL_DCMI_ENABLE(hdcmi);
bogdanm 0:9b334a45a8ff 208
bogdanm 0:9b334a45a8ff 209 /* Update error code */
bogdanm 0:9b334a45a8ff 210 hdcmi->ErrorCode = HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 211
bogdanm 0:9b334a45a8ff 212 /* Initialize the DCMI state*/
bogdanm 0:9b334a45a8ff 213 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 214
bogdanm 0:9b334a45a8ff 215 return HAL_OK;
bogdanm 0:9b334a45a8ff 216 }
bogdanm 0:9b334a45a8ff 217
bogdanm 0:9b334a45a8ff 218 /**
bogdanm 0:9b334a45a8ff 219 * @brief Deinitializes the DCMI peripheral registers to their default reset
bogdanm 0:9b334a45a8ff 220 * values.
bogdanm 0:9b334a45a8ff 221 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 222 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 223 * @retval HAL status
bogdanm 0:9b334a45a8ff 224 */
bogdanm 0:9b334a45a8ff 225
bogdanm 0:9b334a45a8ff 226 HAL_StatusTypeDef HAL_DCMI_DeInit(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 227 {
bogdanm 0:9b334a45a8ff 228 /* DeInit the low level hardware */
bogdanm 0:9b334a45a8ff 229 HAL_DCMI_MspDeInit(hdcmi);
bogdanm 0:9b334a45a8ff 230
bogdanm 0:9b334a45a8ff 231 /* Update error code */
bogdanm 0:9b334a45a8ff 232 hdcmi->ErrorCode = HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 233
bogdanm 0:9b334a45a8ff 234 /* Initialize the DCMI state*/
bogdanm 0:9b334a45a8ff 235 hdcmi->State = HAL_DCMI_STATE_RESET;
bogdanm 0:9b334a45a8ff 236
bogdanm 0:9b334a45a8ff 237 /* Release Lock */
bogdanm 0:9b334a45a8ff 238 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 239
bogdanm 0:9b334a45a8ff 240 return HAL_OK;
bogdanm 0:9b334a45a8ff 241 }
bogdanm 0:9b334a45a8ff 242
bogdanm 0:9b334a45a8ff 243 /**
bogdanm 0:9b334a45a8ff 244 * @brief Initializes the DCMI MSP.
bogdanm 0:9b334a45a8ff 245 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 246 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 247 * @retval None
bogdanm 0:9b334a45a8ff 248 */
bogdanm 0:9b334a45a8ff 249 __weak void HAL_DCMI_MspInit(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 250 {
bogdanm 0:9b334a45a8ff 251 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 252 the HAL_DCMI_MspInit could be implemented in the user file
bogdanm 0:9b334a45a8ff 253 */
bogdanm 0:9b334a45a8ff 254 }
bogdanm 0:9b334a45a8ff 255
bogdanm 0:9b334a45a8ff 256 /**
bogdanm 0:9b334a45a8ff 257 * @brief DeInitializes the DCMI MSP.
bogdanm 0:9b334a45a8ff 258 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 259 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 260 * @retval None
bogdanm 0:9b334a45a8ff 261 */
bogdanm 0:9b334a45a8ff 262 __weak void HAL_DCMI_MspDeInit(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 263 {
bogdanm 0:9b334a45a8ff 264 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 265 the HAL_DCMI_MspDeInit could be implemented in the user file
bogdanm 0:9b334a45a8ff 266 */
bogdanm 0:9b334a45a8ff 267 }
bogdanm 0:9b334a45a8ff 268
bogdanm 0:9b334a45a8ff 269 /**
bogdanm 0:9b334a45a8ff 270 * @}
bogdanm 0:9b334a45a8ff 271 */
bogdanm 0:9b334a45a8ff 272 /** @defgroup DCMI_Exported_Functions_Group2 IO operation functions
bogdanm 0:9b334a45a8ff 273 * @brief IO operation functions
bogdanm 0:9b334a45a8ff 274 *
bogdanm 0:9b334a45a8ff 275 @verbatim
bogdanm 0:9b334a45a8ff 276 ===============================================================================
bogdanm 0:9b334a45a8ff 277 ##### IO operation functions #####
bogdanm 0:9b334a45a8ff 278 ===============================================================================
bogdanm 0:9b334a45a8ff 279 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 280 (+) Configure destination address and data length and
bogdanm 0:9b334a45a8ff 281 Enables DCMI DMA request and enables DCMI capture
bogdanm 0:9b334a45a8ff 282 (+) Stop the DCMI capture.
bogdanm 0:9b334a45a8ff 283 (+) Handles DCMI interrupt request.
bogdanm 0:9b334a45a8ff 284
bogdanm 0:9b334a45a8ff 285 @endverbatim
bogdanm 0:9b334a45a8ff 286 * @{
bogdanm 0:9b334a45a8ff 287 */
bogdanm 0:9b334a45a8ff 288
bogdanm 0:9b334a45a8ff 289 /**
bogdanm 0:9b334a45a8ff 290 * @brief Enables DCMI DMA request and enables DCMI capture
bogdanm 0:9b334a45a8ff 291 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 292 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 293 * @param DCMI_Mode: DCMI capture mode snapshot or continuous grab.
bogdanm 0:9b334a45a8ff 294 * @param pData: The destination memory Buffer address (LCD Frame buffer).
bogdanm 0:9b334a45a8ff 295 * @param Length: The length of capture to be transferred.
bogdanm 0:9b334a45a8ff 296 * @retval HAL status
bogdanm 0:9b334a45a8ff 297 */
bogdanm 0:9b334a45a8ff 298 HAL_StatusTypeDef HAL_DCMI_Start_DMA(DCMI_HandleTypeDef* hdcmi, uint32_t DCMI_Mode, uint32_t pData, uint32_t Length)
bogdanm 0:9b334a45a8ff 299 {
bogdanm 0:9b334a45a8ff 300 /* Initialize the second memory address */
bogdanm 0:9b334a45a8ff 301 uint32_t SecondMemAddress = 0;
bogdanm 0:9b334a45a8ff 302
bogdanm 0:9b334a45a8ff 303 /* Check function parameters */
bogdanm 0:9b334a45a8ff 304 assert_param(IS_DCMI_CAPTURE_MODE(DCMI_Mode));
bogdanm 0:9b334a45a8ff 305
bogdanm 0:9b334a45a8ff 306 /* Process Locked */
bogdanm 0:9b334a45a8ff 307 __HAL_LOCK(hdcmi);
bogdanm 0:9b334a45a8ff 308
bogdanm 0:9b334a45a8ff 309 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 310 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 311
bogdanm 0:9b334a45a8ff 312 /* Check the parameters */
bogdanm 0:9b334a45a8ff 313 assert_param(IS_DCMI_CAPTURE_MODE(DCMI_Mode));
bogdanm 0:9b334a45a8ff 314
bogdanm 0:9b334a45a8ff 315 /* Configure the DCMI Mode */
bogdanm 0:9b334a45a8ff 316 hdcmi->Instance->CR &= ~(DCMI_CR_CM);
bogdanm 0:9b334a45a8ff 317 hdcmi->Instance->CR |= (uint32_t)(DCMI_Mode);
bogdanm 0:9b334a45a8ff 318
bogdanm 0:9b334a45a8ff 319 /* Set the DMA memory0 conversion complete callback */
bogdanm 0:9b334a45a8ff 320 hdcmi->DMA_Handle->XferCpltCallback = DCMI_DMAConvCplt;
bogdanm 0:9b334a45a8ff 321
bogdanm 0:9b334a45a8ff 322 /* Set the DMA error callback */
bogdanm 0:9b334a45a8ff 323 hdcmi->DMA_Handle->XferErrorCallback = DCMI_DMAError;
bogdanm 0:9b334a45a8ff 324
bogdanm 0:9b334a45a8ff 325 if(Length <= 0xFFFF)
bogdanm 0:9b334a45a8ff 326 {
bogdanm 0:9b334a45a8ff 327 /* Enable the DMA Stream */
bogdanm 0:9b334a45a8ff 328 HAL_DMA_Start_IT(hdcmi->DMA_Handle, (uint32_t)&hdcmi->Instance->DR, (uint32_t)pData, Length);
bogdanm 0:9b334a45a8ff 329 }
bogdanm 0:9b334a45a8ff 330 else /* DCMI_DOUBLE_BUFFER Mode */
bogdanm 0:9b334a45a8ff 331 {
bogdanm 0:9b334a45a8ff 332 /* Set the DMA memory1 conversion complete callback */
bogdanm 0:9b334a45a8ff 333 hdcmi->DMA_Handle->XferM1CpltCallback = DCMI_DMAConvCplt;
bogdanm 0:9b334a45a8ff 334
bogdanm 0:9b334a45a8ff 335 /* Initialize transfer parameters */
bogdanm 0:9b334a45a8ff 336 hdcmi->XferCount = 1;
bogdanm 0:9b334a45a8ff 337 hdcmi->XferSize = Length;
bogdanm 0:9b334a45a8ff 338 hdcmi->pBuffPtr = pData;
bogdanm 0:9b334a45a8ff 339
bogdanm 0:9b334a45a8ff 340 /* Get the number of buffer */
bogdanm 0:9b334a45a8ff 341 while(hdcmi->XferSize > 0xFFFF)
bogdanm 0:9b334a45a8ff 342 {
bogdanm 0:9b334a45a8ff 343 hdcmi->XferSize = (hdcmi->XferSize/2);
bogdanm 0:9b334a45a8ff 344 hdcmi->XferCount = hdcmi->XferCount*2;
bogdanm 0:9b334a45a8ff 345 }
bogdanm 0:9b334a45a8ff 346
bogdanm 0:9b334a45a8ff 347 /* Update DCMI counter and transfer number*/
bogdanm 0:9b334a45a8ff 348 hdcmi->XferCount = (hdcmi->XferCount - 2);
bogdanm 0:9b334a45a8ff 349 hdcmi->XferTransferNumber = hdcmi->XferCount;
bogdanm 0:9b334a45a8ff 350
bogdanm 0:9b334a45a8ff 351 /* Update second memory address */
bogdanm 0:9b334a45a8ff 352 SecondMemAddress = (uint32_t)(pData + (4*hdcmi->XferSize));
bogdanm 0:9b334a45a8ff 353
bogdanm 0:9b334a45a8ff 354 /* Start DMA multi buffer transfer */
bogdanm 0:9b334a45a8ff 355 HAL_DMAEx_MultiBufferStart_IT(hdcmi->DMA_Handle, (uint32_t)&hdcmi->Instance->DR, (uint32_t)pData, SecondMemAddress, hdcmi->XferSize);
bogdanm 0:9b334a45a8ff 356 }
bogdanm 0:9b334a45a8ff 357
bogdanm 0:9b334a45a8ff 358 /* Enable Capture */
bogdanm 0:9b334a45a8ff 359 DCMI->CR |= DCMI_CR_CAPTURE;
bogdanm 0:9b334a45a8ff 360
bogdanm 0:9b334a45a8ff 361 /* Return function status */
bogdanm 0:9b334a45a8ff 362 return HAL_OK;
bogdanm 0:9b334a45a8ff 363 }
bogdanm 0:9b334a45a8ff 364
bogdanm 0:9b334a45a8ff 365 /**
bogdanm 0:9b334a45a8ff 366 * @brief Disable DCMI DMA request and Disable DCMI capture
bogdanm 0:9b334a45a8ff 367 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 368 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 369 * @retval HAL status
bogdanm 0:9b334a45a8ff 370 */
bogdanm 0:9b334a45a8ff 371 HAL_StatusTypeDef HAL_DCMI_Stop(DCMI_HandleTypeDef* hdcmi)
bogdanm 0:9b334a45a8ff 372 {
bogdanm 0:9b334a45a8ff 373 uint32_t tickstart = 0;
bogdanm 0:9b334a45a8ff 374
bogdanm 0:9b334a45a8ff 375 /* Lock the DCMI peripheral state */
bogdanm 0:9b334a45a8ff 376 hdcmi->State = HAL_DCMI_STATE_BUSY;
bogdanm 0:9b334a45a8ff 377
bogdanm 0:9b334a45a8ff 378 __HAL_DCMI_DISABLE(hdcmi);
bogdanm 0:9b334a45a8ff 379
bogdanm 0:9b334a45a8ff 380 /* Disable Capture */
bogdanm 0:9b334a45a8ff 381 DCMI->CR &= ~(DCMI_CR_CAPTURE);
bogdanm 0:9b334a45a8ff 382
bogdanm 0:9b334a45a8ff 383 /* Get tick */
bogdanm 0:9b334a45a8ff 384 tickstart = HAL_GetTick();
bogdanm 0:9b334a45a8ff 385
bogdanm 0:9b334a45a8ff 386 /* Check if the DCMI capture effectively disabled */
bogdanm 0:9b334a45a8ff 387 while((hdcmi->Instance->CR & DCMI_CR_CAPTURE) != 0)
bogdanm 0:9b334a45a8ff 388 {
bogdanm 0:9b334a45a8ff 389 if((HAL_GetTick() - tickstart ) > HAL_TIMEOUT_DCMI_STOP)
bogdanm 0:9b334a45a8ff 390 {
bogdanm 0:9b334a45a8ff 391 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 392 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 393
bogdanm 0:9b334a45a8ff 394 /* Update error code */
bogdanm 0:9b334a45a8ff 395 hdcmi->ErrorCode |= HAL_DCMI_ERROR_TIMEOUT;
bogdanm 0:9b334a45a8ff 396
bogdanm 0:9b334a45a8ff 397 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 398 hdcmi->State = HAL_DCMI_STATE_TIMEOUT;
bogdanm 0:9b334a45a8ff 399
bogdanm 0:9b334a45a8ff 400 return HAL_TIMEOUT;
bogdanm 0:9b334a45a8ff 401 }
bogdanm 0:9b334a45a8ff 402 }
bogdanm 0:9b334a45a8ff 403
bogdanm 0:9b334a45a8ff 404 /* Disable the DMA */
bogdanm 0:9b334a45a8ff 405 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 406
bogdanm 0:9b334a45a8ff 407 /* Update error code */
bogdanm 0:9b334a45a8ff 408 hdcmi->ErrorCode |= HAL_DCMI_ERROR_NONE;
bogdanm 0:9b334a45a8ff 409
bogdanm 0:9b334a45a8ff 410 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 411 hdcmi->State = HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 412
bogdanm 0:9b334a45a8ff 413 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 414 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 415
bogdanm 0:9b334a45a8ff 416 /* Return function status */
bogdanm 0:9b334a45a8ff 417 return HAL_OK;
bogdanm 0:9b334a45a8ff 418 }
bogdanm 0:9b334a45a8ff 419
bogdanm 0:9b334a45a8ff 420 /**
bogdanm 0:9b334a45a8ff 421 * @brief Handles DCMI interrupt request.
bogdanm 0:9b334a45a8ff 422 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 423 * the configuration information for the DCMI.
bogdanm 0:9b334a45a8ff 424 * @retval None
bogdanm 0:9b334a45a8ff 425 */
bogdanm 0:9b334a45a8ff 426 void HAL_DCMI_IRQHandler(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 427 {
bogdanm 0:9b334a45a8ff 428 /* Synchronization error interrupt management *******************************/
bogdanm 0:9b334a45a8ff 429 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_ERRRI) != RESET)
bogdanm 0:9b334a45a8ff 430 {
bogdanm 0:9b334a45a8ff 431 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_ERR) != RESET)
bogdanm 0:9b334a45a8ff 432 {
bogdanm 0:9b334a45a8ff 433 /* Disable the Synchronization error interrupt */
bogdanm 0:9b334a45a8ff 434 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_ERR);
bogdanm 0:9b334a45a8ff 435
bogdanm 0:9b334a45a8ff 436 /* Clear the Synchronization error flag */
bogdanm 0:9b334a45a8ff 437 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_ERRRI);
bogdanm 0:9b334a45a8ff 438
bogdanm 0:9b334a45a8ff 439 /* Update error code */
bogdanm 0:9b334a45a8ff 440 hdcmi->ErrorCode |= HAL_DCMI_ERROR_SYNC;
bogdanm 0:9b334a45a8ff 441
bogdanm 0:9b334a45a8ff 442 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 443 hdcmi->State = HAL_DCMI_STATE_ERROR;
bogdanm 0:9b334a45a8ff 444
bogdanm 0:9b334a45a8ff 445 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 446 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 447
bogdanm 0:9b334a45a8ff 448 /* Abort the DMA Transfer */
bogdanm 0:9b334a45a8ff 449 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 450
bogdanm 0:9b334a45a8ff 451 /* Synchronization error Callback */
bogdanm 0:9b334a45a8ff 452 HAL_DCMI_ErrorCallback(hdcmi);
bogdanm 0:9b334a45a8ff 453 }
bogdanm 0:9b334a45a8ff 454 }
bogdanm 0:9b334a45a8ff 455 /* Overflow interrupt management ********************************************/
bogdanm 0:9b334a45a8ff 456 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_OVFRI) != RESET)
bogdanm 0:9b334a45a8ff 457 {
bogdanm 0:9b334a45a8ff 458 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_OVF) != RESET)
bogdanm 0:9b334a45a8ff 459 {
bogdanm 0:9b334a45a8ff 460 /* Disable the Overflow interrupt */
bogdanm 0:9b334a45a8ff 461 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_OVF);
bogdanm 0:9b334a45a8ff 462
bogdanm 0:9b334a45a8ff 463 /* Clear the Overflow flag */
bogdanm 0:9b334a45a8ff 464 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_OVFRI);
bogdanm 0:9b334a45a8ff 465
bogdanm 0:9b334a45a8ff 466 /* Update error code */
bogdanm 0:9b334a45a8ff 467 hdcmi->ErrorCode |= HAL_DCMI_ERROR_OVF;
bogdanm 0:9b334a45a8ff 468
bogdanm 0:9b334a45a8ff 469 /* Change DCMI state */
bogdanm 0:9b334a45a8ff 470 hdcmi->State = HAL_DCMI_STATE_ERROR;
bogdanm 0:9b334a45a8ff 471
bogdanm 0:9b334a45a8ff 472 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 473 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 474
bogdanm 0:9b334a45a8ff 475 /* Abort the DMA Transfer */
bogdanm 0:9b334a45a8ff 476 HAL_DMA_Abort(hdcmi->DMA_Handle);
bogdanm 0:9b334a45a8ff 477
bogdanm 0:9b334a45a8ff 478 /* Overflow Callback */
bogdanm 0:9b334a45a8ff 479 HAL_DCMI_ErrorCallback(hdcmi);
bogdanm 0:9b334a45a8ff 480 }
bogdanm 0:9b334a45a8ff 481 }
bogdanm 0:9b334a45a8ff 482 /* Line Interrupt management ************************************************/
bogdanm 0:9b334a45a8ff 483 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_LINERI) != RESET)
bogdanm 0:9b334a45a8ff 484 {
bogdanm 0:9b334a45a8ff 485 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_LINE) != RESET)
bogdanm 0:9b334a45a8ff 486 {
bogdanm 0:9b334a45a8ff 487 /* Clear the Line interrupt flag */
bogdanm 0:9b334a45a8ff 488 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_LINERI);
bogdanm 0:9b334a45a8ff 489
bogdanm 0:9b334a45a8ff 490 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 491 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 492
bogdanm 0:9b334a45a8ff 493 /* Line interrupt Callback */
bogdanm 0:9b334a45a8ff 494 HAL_DCMI_LineEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 495 }
bogdanm 0:9b334a45a8ff 496 }
bogdanm 0:9b334a45a8ff 497 /* VSYNC interrupt management ***********************************************/
bogdanm 0:9b334a45a8ff 498 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_VSYNCRI) != RESET)
bogdanm 0:9b334a45a8ff 499 {
bogdanm 0:9b334a45a8ff 500 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_VSYNC) != RESET)
bogdanm 0:9b334a45a8ff 501 {
bogdanm 0:9b334a45a8ff 502 /* Disable the VSYNC interrupt */
bogdanm 0:9b334a45a8ff 503 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_VSYNC);
bogdanm 0:9b334a45a8ff 504
bogdanm 0:9b334a45a8ff 505 /* Clear the VSYNC flag */
bogdanm 0:9b334a45a8ff 506 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_VSYNCRI);
bogdanm 0:9b334a45a8ff 507
bogdanm 0:9b334a45a8ff 508 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 509 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 510
bogdanm 0:9b334a45a8ff 511 /* VSYNC Callback */
bogdanm 0:9b334a45a8ff 512 HAL_DCMI_VsyncEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 513 }
bogdanm 0:9b334a45a8ff 514 }
bogdanm 0:9b334a45a8ff 515 /* End of Frame interrupt management ****************************************/
bogdanm 0:9b334a45a8ff 516 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_FRAMERI) != RESET)
bogdanm 0:9b334a45a8ff 517 {
bogdanm 0:9b334a45a8ff 518 if(__HAL_DCMI_GET_IT_SOURCE(hdcmi, DCMI_IT_FRAME) != RESET)
bogdanm 0:9b334a45a8ff 519 {
bogdanm 0:9b334a45a8ff 520 /* Disable the End of Frame interrupt */
bogdanm 0:9b334a45a8ff 521 __HAL_DCMI_DISABLE_IT(hdcmi, DCMI_IT_FRAME);
bogdanm 0:9b334a45a8ff 522
bogdanm 0:9b334a45a8ff 523 /* Clear the End of Frame flag */
bogdanm 0:9b334a45a8ff 524 __HAL_DCMI_CLEAR_FLAG(hdcmi, DCMI_FLAG_FRAMERI);
bogdanm 0:9b334a45a8ff 525
bogdanm 0:9b334a45a8ff 526 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 527 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 528
bogdanm 0:9b334a45a8ff 529 /* End of Frame Callback */
bogdanm 0:9b334a45a8ff 530 HAL_DCMI_FrameEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 531 }
bogdanm 0:9b334a45a8ff 532 }
bogdanm 0:9b334a45a8ff 533 }
bogdanm 0:9b334a45a8ff 534
bogdanm 0:9b334a45a8ff 535 /**
bogdanm 0:9b334a45a8ff 536 * @brief Error DCMI callback.
bogdanm 0:9b334a45a8ff 537 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 538 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 539 * @retval None
bogdanm 0:9b334a45a8ff 540 */
bogdanm 0:9b334a45a8ff 541 __weak void HAL_DCMI_ErrorCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 542 {
bogdanm 0:9b334a45a8ff 543 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 544 the HAL_DCMI_ErrorCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 545 */
bogdanm 0:9b334a45a8ff 546 }
bogdanm 0:9b334a45a8ff 547
bogdanm 0:9b334a45a8ff 548 /**
bogdanm 0:9b334a45a8ff 549 * @brief Line Event callback.
bogdanm 0:9b334a45a8ff 550 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 551 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 552 * @retval None
bogdanm 0:9b334a45a8ff 553 */
bogdanm 0:9b334a45a8ff 554 __weak void HAL_DCMI_LineEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 555 {
bogdanm 0:9b334a45a8ff 556 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 557 the HAL_DCMI_LineEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 558 */
bogdanm 0:9b334a45a8ff 559 }
bogdanm 0:9b334a45a8ff 560
bogdanm 0:9b334a45a8ff 561 /**
bogdanm 0:9b334a45a8ff 562 * @brief VSYNC Event callback.
bogdanm 0:9b334a45a8ff 563 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 564 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 565 * @retval None
bogdanm 0:9b334a45a8ff 566 */
bogdanm 0:9b334a45a8ff 567 __weak void HAL_DCMI_VsyncEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 568 {
bogdanm 0:9b334a45a8ff 569 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 570 the HAL_DCMI_VsyncEventCallback could be implemented in the user file
bogdanm 0:9b334a45a8ff 571 */
bogdanm 0:9b334a45a8ff 572 }
bogdanm 0:9b334a45a8ff 573
bogdanm 0:9b334a45a8ff 574 /**
bogdanm 0:9b334a45a8ff 575 * @brief Frame Event callback.
bogdanm 0:9b334a45a8ff 576 * @param hdcmi: pointer to a DCMI_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 577 * the configuration information for DCMI.
bogdanm 0:9b334a45a8ff 578 * @retval None
bogdanm 0:9b334a45a8ff 579 */
bogdanm 0:9b334a45a8ff 580 __weak void HAL_DCMI_FrameEventCallback(DCMI_HandleTypeDef *hdcmi)
bogdanm 0:9b334a45a8ff 581 {
bogdanm 0:9b334a45a8ff 582 /* NOTE : This function Should not be modified, when the callback is needed,
bogdanm 0:9b334a45a8ff 583 the HAL_DCMI_FrameEventCallback could be implemented in the user file
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
bogdanm 0:9b334a45a8ff 591 /** @defgroup DCMI_Exported_Functions_Group3 Peripheral Control functions
bogdanm 0:9b334a45a8ff 592 * @brief Peripheral Control functions
bogdanm 0:9b334a45a8ff 593 *
bogdanm 0:9b334a45a8ff 594 @verbatim
bogdanm 0:9b334a45a8ff 595 ===============================================================================
bogdanm 0:9b334a45a8ff 596 ##### Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 597 ===============================================================================
bogdanm 0:9b334a45a8ff 598 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 599 (+) Configure the CROP feature.
bogdanm 0:9b334a45a8ff 600 (+) Enable/Disable the CROP 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_COORDINATE(YSize));
bogdanm 0:9b334a45a8ff 627 assert_param(IS_DCMI_WINDOW_COORDINATE(XSize));
bogdanm 0:9b334a45a8ff 628 assert_param(IS_DCMI_WINDOW_HEIGHT(Y0));
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 /**
bogdanm 0:9b334a45a8ff 746 * @brief DMA conversion complete callback.
bogdanm 0:9b334a45a8ff 747 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 748 * the configuration information for the specified DMA module.
bogdanm 0:9b334a45a8ff 749 * @retval None
bogdanm 0:9b334a45a8ff 750 */
bogdanm 0:9b334a45a8ff 751 static void DCMI_DMAConvCplt(DMA_HandleTypeDef *hdma)
bogdanm 0:9b334a45a8ff 752 {
bogdanm 0:9b334a45a8ff 753 uint32_t tmp = 0;
bogdanm 0:9b334a45a8ff 754
bogdanm 0:9b334a45a8ff 755 DCMI_HandleTypeDef* hdcmi = ( DCMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm 0:9b334a45a8ff 756 hdcmi->State= HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 757
bogdanm 0:9b334a45a8ff 758 if(hdcmi->XferCount != 0)
bogdanm 0:9b334a45a8ff 759 {
bogdanm 0:9b334a45a8ff 760 /* Update memory 0 address location */
bogdanm 0:9b334a45a8ff 761 tmp = ((hdcmi->DMA_Handle->Instance->CR) & DMA_SxCR_CT);
bogdanm 0:9b334a45a8ff 762 if(((hdcmi->XferCount % 2) == 0) && (tmp != 0))
bogdanm 0:9b334a45a8ff 763 {
bogdanm 0:9b334a45a8ff 764 tmp = hdcmi->DMA_Handle->Instance->M0AR;
bogdanm 0:9b334a45a8ff 765 HAL_DMAEx_ChangeMemory(hdcmi->DMA_Handle, (tmp + (8*hdcmi->XferSize)), MEMORY0);
bogdanm 0:9b334a45a8ff 766 hdcmi->XferCount--;
bogdanm 0:9b334a45a8ff 767 }
bogdanm 0:9b334a45a8ff 768 /* Update memory 1 address location */
bogdanm 0:9b334a45a8ff 769 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) == 0)
bogdanm 0:9b334a45a8ff 770 {
bogdanm 0:9b334a45a8ff 771 tmp = hdcmi->DMA_Handle->Instance->M1AR;
bogdanm 0:9b334a45a8ff 772 HAL_DMAEx_ChangeMemory(hdcmi->DMA_Handle, (tmp + (8*hdcmi->XferSize)), MEMORY1);
bogdanm 0:9b334a45a8ff 773 hdcmi->XferCount--;
bogdanm 0:9b334a45a8ff 774 }
bogdanm 0:9b334a45a8ff 775 }
bogdanm 0:9b334a45a8ff 776 /* Update memory 0 address location */
bogdanm 0:9b334a45a8ff 777 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) != 0)
bogdanm 0:9b334a45a8ff 778 {
bogdanm 0:9b334a45a8ff 779 hdcmi->DMA_Handle->Instance->M0AR = hdcmi->pBuffPtr;
bogdanm 0:9b334a45a8ff 780 }
bogdanm 0:9b334a45a8ff 781 /* Update memory 1 address location */
bogdanm 0:9b334a45a8ff 782 else if((hdcmi->DMA_Handle->Instance->CR & DMA_SxCR_CT) == 0)
bogdanm 0:9b334a45a8ff 783 {
bogdanm 0:9b334a45a8ff 784 tmp = hdcmi->pBuffPtr;
bogdanm 0:9b334a45a8ff 785 hdcmi->DMA_Handle->Instance->M1AR = (tmp + (4*hdcmi->XferSize));
bogdanm 0:9b334a45a8ff 786 hdcmi->XferCount = hdcmi->XferTransferNumber;
bogdanm 0:9b334a45a8ff 787 }
bogdanm 0:9b334a45a8ff 788
bogdanm 0:9b334a45a8ff 789 if(__HAL_DCMI_GET_FLAG(hdcmi, DCMI_FLAG_FRAMERI) != RESET)
bogdanm 0:9b334a45a8ff 790 {
bogdanm 0:9b334a45a8ff 791 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 792 __HAL_UNLOCK(hdcmi);
bogdanm 0:9b334a45a8ff 793
bogdanm 0:9b334a45a8ff 794 /* FRAME Callback */
bogdanm 0:9b334a45a8ff 795 HAL_DCMI_FrameEventCallback(hdcmi);
bogdanm 0:9b334a45a8ff 796 }
bogdanm 0:9b334a45a8ff 797 }
bogdanm 0:9b334a45a8ff 798
bogdanm 0:9b334a45a8ff 799 /**
bogdanm 0:9b334a45a8ff 800 * @brief DMA error callback
bogdanm 0:9b334a45a8ff 801 * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 802 * the configuration information for the specified DMA module.
bogdanm 0:9b334a45a8ff 803 * @retval None
bogdanm 0:9b334a45a8ff 804 */
bogdanm 0:9b334a45a8ff 805 static void DCMI_DMAError(DMA_HandleTypeDef *hdma)
bogdanm 0:9b334a45a8ff 806 {
bogdanm 0:9b334a45a8ff 807 DCMI_HandleTypeDef* hdcmi = ( DCMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
bogdanm 0:9b334a45a8ff 808 hdcmi->State= HAL_DCMI_STATE_READY;
bogdanm 0:9b334a45a8ff 809 HAL_DCMI_ErrorCallback(hdcmi);
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 */
bogdanm 0:9b334a45a8ff 819 #endif /* STM32F407xx || STM32F417xx || STM32F427xx || STM32F437xx ||\
bogdanm 0:9b334a45a8ff 820 STM32F429xx || STM32F439xx || STM32F446xx */
bogdanm 0:9b334a45a8ff 821 #endif /* HAL_DCMI_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 822 /**
bogdanm 0:9b334a45a8ff 823 * @}
bogdanm 0:9b334a45a8ff 824 */
bogdanm 0:9b334a45a8ff 825
bogdanm 0:9b334a45a8ff 826 /**
bogdanm 0:9b334a45a8ff 827 * @}
bogdanm 0:9b334a45a8ff 828 */
bogdanm 0:9b334a45a8ff 829
bogdanm 0:9b334a45a8ff 830 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/