Gan likun / mbed1-dev

001

targets/TARGET_STM/TARGET_STM32F4/device/stm32f4xx_hal_dcmi.h@0:13413ea9a877, 2022-06-12 (annotated)

Committer:
ganlikun
Date:
Sun Jun 12 14:02:44 2022 +0000
Revision:
0:13413ea9a877
00

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ganlikun 0:13413ea9a877 1 /**
ganlikun 0:13413ea9a877 2 ******************************************************************************
ganlikun 0:13413ea9a877 3 * @file stm32f4xx_hal_dcmi.h
ganlikun 0:13413ea9a877 4 * @author MCD Application Team
ganlikun 0:13413ea9a877 5 * @version V1.7.1
ganlikun 0:13413ea9a877 6 * @date 14-April-2017
ganlikun 0:13413ea9a877 7 * @brief Header file of DCMI HAL module.
ganlikun 0:13413ea9a877 8 ******************************************************************************
ganlikun 0:13413ea9a877 9 * @attention
ganlikun 0:13413ea9a877 10 *
ganlikun 0:13413ea9a877 11 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
ganlikun 0:13413ea9a877 12 *
ganlikun 0:13413ea9a877 13 * Redistribution and use in source and binary forms, with or without modification,
ganlikun 0:13413ea9a877 14 * are permitted provided that the following conditions are met:
ganlikun 0:13413ea9a877 15 * 1. Redistributions of source code must retain the above copyright notice,
ganlikun 0:13413ea9a877 16 * this list of conditions and the following disclaimer.
ganlikun 0:13413ea9a877 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
ganlikun 0:13413ea9a877 18 * this list of conditions and the following disclaimer in the documentation
ganlikun 0:13413ea9a877 19 * and/or other materials provided with the distribution.
ganlikun 0:13413ea9a877 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
ganlikun 0:13413ea9a877 21 * may be used to endorse or promote products derived from this software
ganlikun 0:13413ea9a877 22 * without specific prior written permission.
ganlikun 0:13413ea9a877 23 *
ganlikun 0:13413ea9a877 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
ganlikun 0:13413ea9a877 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
ganlikun 0:13413ea9a877 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
ganlikun 0:13413ea9a877 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
ganlikun 0:13413ea9a877 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
ganlikun 0:13413ea9a877 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
ganlikun 0:13413ea9a877 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
ganlikun 0:13413ea9a877 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
ganlikun 0:13413ea9a877 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
ganlikun 0:13413ea9a877 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
ganlikun 0:13413ea9a877 34 *
ganlikun 0:13413ea9a877 35 ******************************************************************************
ganlikun 0:13413ea9a877 36 */
ganlikun 0:13413ea9a877 37
ganlikun 0:13413ea9a877 38 /* Define to prevent recursive inclusion -------------------------------------*/
ganlikun 0:13413ea9a877 39 #ifndef __STM32F4xx_HAL_DCMI_H
ganlikun 0:13413ea9a877 40 #define __STM32F4xx_HAL_DCMI_H
ganlikun 0:13413ea9a877 41
ganlikun 0:13413ea9a877 42 #ifdef __cplusplus
ganlikun 0:13413ea9a877 43 extern "C" {
ganlikun 0:13413ea9a877 44 #endif
ganlikun 0:13413ea9a877 45
ganlikun 0:13413ea9a877 46 #if defined(STM32F407xx) || defined(STM32F417xx) || defined(STM32F427xx) || defined(STM32F437xx) ||\
ganlikun 0:13413ea9a877 47 defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F446xx) || defined(STM32F469xx) ||\
ganlikun 0:13413ea9a877 48 defined(STM32F479xx)
ganlikun 0:13413ea9a877 49 /* Includes ------------------------------------------------------------------*/
ganlikun 0:13413ea9a877 50 #include "stm32f4xx_hal_def.h"
ganlikun 0:13413ea9a877 51
ganlikun 0:13413ea9a877 52 /* Include DCMI HAL Extended module */
ganlikun 0:13413ea9a877 53 /* (include on top of file since DCMI structures are defined in extended file) */
ganlikun 0:13413ea9a877 54 #include "stm32f4xx_hal_dcmi_ex.h"
ganlikun 0:13413ea9a877 55
ganlikun 0:13413ea9a877 56 /** @addtogroup STM32F4xx_HAL_Driver
ganlikun 0:13413ea9a877 57 * @{
ganlikun 0:13413ea9a877 58 */
ganlikun 0:13413ea9a877 59
ganlikun 0:13413ea9a877 60 /** @addtogroup DCMI DCMI
ganlikun 0:13413ea9a877 61 * @brief DCMI HAL module driver
ganlikun 0:13413ea9a877 62 * @{
ganlikun 0:13413ea9a877 63 */
ganlikun 0:13413ea9a877 64
ganlikun 0:13413ea9a877 65 /* Exported types ------------------------------------------------------------*/
ganlikun 0:13413ea9a877 66 /** @defgroup DCMI_Exported_Types DCMI Exported Types
ganlikun 0:13413ea9a877 67 * @{
ganlikun 0:13413ea9a877 68 */
ganlikun 0:13413ea9a877 69 /**
ganlikun 0:13413ea9a877 70 * @brief HAL DCMI State structures definition
ganlikun 0:13413ea9a877 71 */
ganlikun 0:13413ea9a877 72 typedef enum
ganlikun 0:13413ea9a877 73 {
ganlikun 0:13413ea9a877 74 HAL_DCMI_STATE_RESET = 0x00U, /*!< DCMI not yet initialized or disabled */
ganlikun 0:13413ea9a877 75 HAL_DCMI_STATE_READY = 0x01U, /*!< DCMI initialized and ready for use */
ganlikun 0:13413ea9a877 76 HAL_DCMI_STATE_BUSY = 0x02U, /*!< DCMI internal processing is ongoing */
ganlikun 0:13413ea9a877 77 HAL_DCMI_STATE_TIMEOUT = 0x03U, /*!< DCMI timeout state */
ganlikun 0:13413ea9a877 78 HAL_DCMI_STATE_ERROR = 0x04U, /*!< DCMI error state */
ganlikun 0:13413ea9a877 79 HAL_DCMI_STATE_SUSPENDED = 0x05U /*!< DCMI suspend state */
ganlikun 0:13413ea9a877 80 }HAL_DCMI_StateTypeDef;
ganlikun 0:13413ea9a877 81
ganlikun 0:13413ea9a877 82 /**
ganlikun 0:13413ea9a877 83 * @brief DCMI handle Structure definition
ganlikun 0:13413ea9a877 84 */
ganlikun 0:13413ea9a877 85 typedef struct
ganlikun 0:13413ea9a877 86 {
ganlikun 0:13413ea9a877 87 DCMI_TypeDef *Instance; /*!< DCMI Register base address */
ganlikun 0:13413ea9a877 88
ganlikun 0:13413ea9a877 89 DCMI_InitTypeDef Init; /*!< DCMI parameters */
ganlikun 0:13413ea9a877 90
ganlikun 0:13413ea9a877 91 HAL_LockTypeDef Lock; /*!< DCMI locking object */
ganlikun 0:13413ea9a877 92
ganlikun 0:13413ea9a877 93 __IO HAL_DCMI_StateTypeDef State; /*!< DCMI state */
ganlikun 0:13413ea9a877 94
ganlikun 0:13413ea9a877 95 __IO uint32_t XferCount; /*!< DMA transfer counter */
ganlikun 0:13413ea9a877 96
ganlikun 0:13413ea9a877 97 __IO uint32_t XferSize; /*!< DMA transfer size */
ganlikun 0:13413ea9a877 98
ganlikun 0:13413ea9a877 99 uint32_t XferTransferNumber; /*!< DMA transfer number */
ganlikun 0:13413ea9a877 100
ganlikun 0:13413ea9a877 101 uint32_t pBuffPtr; /*!< Pointer to DMA output buffer */
ganlikun 0:13413ea9a877 102
ganlikun 0:13413ea9a877 103 DMA_HandleTypeDef *DMA_Handle; /*!< Pointer to the DMA handler */
ganlikun 0:13413ea9a877 104
ganlikun 0:13413ea9a877 105 __IO uint32_t ErrorCode; /*!< DCMI Error code */
ganlikun 0:13413ea9a877 106
ganlikun 0:13413ea9a877 107 }DCMI_HandleTypeDef;
ganlikun 0:13413ea9a877 108 /**
ganlikun 0:13413ea9a877 109 * @}
ganlikun 0:13413ea9a877 110 */
ganlikun 0:13413ea9a877 111
ganlikun 0:13413ea9a877 112 /* Exported constants --------------------------------------------------------*/
ganlikun 0:13413ea9a877 113 /** @defgroup DCMI_Exported_Constants DCMI Exported Constants
ganlikun 0:13413ea9a877 114 * @{
ganlikun 0:13413ea9a877 115 */
ganlikun 0:13413ea9a877 116
ganlikun 0:13413ea9a877 117 /** @defgroup DCMI_Error_Code DCMI Error Code
ganlikun 0:13413ea9a877 118 * @{
ganlikun 0:13413ea9a877 119 */
ganlikun 0:13413ea9a877 120 #define HAL_DCMI_ERROR_NONE 0x00000000U /*!< No error */
ganlikun 0:13413ea9a877 121 #define HAL_DCMI_ERROR_OVR 0x00000001U /*!< Overrun error */
ganlikun 0:13413ea9a877 122 #define HAL_DCMI_ERROR_SYNC 0x00000002U /*!< Synchronization error */
ganlikun 0:13413ea9a877 123 #define HAL_DCMI_ERROR_TIMEOUT 0x00000020U /*!< Timeout error */
ganlikun 0:13413ea9a877 124 #define HAL_DCMI_ERROR_DMA 0x00000040U /*!< DMA error */
ganlikun 0:13413ea9a877 125 /**
ganlikun 0:13413ea9a877 126 * @}
ganlikun 0:13413ea9a877 127 */
ganlikun 0:13413ea9a877 128
ganlikun 0:13413ea9a877 129 /** @defgroup DCMI_Capture_Mode DCMI Capture Mode
ganlikun 0:13413ea9a877 130 * @{
ganlikun 0:13413ea9a877 131 */
ganlikun 0:13413ea9a877 132 #define DCMI_MODE_CONTINUOUS 0x00000000U /*!< The received data are transferred continuously
ganlikun 0:13413ea9a877 133 into the destination memory through the DMA */
ganlikun 0:13413ea9a877 134 #define DCMI_MODE_SNAPSHOT ((uint32_t)DCMI_CR_CM) /*!< Once activated, the interface waits for the start of
ganlikun 0:13413ea9a877 135 frame and then transfers a single frame through the DMA */
ganlikun 0:13413ea9a877 136 /**
ganlikun 0:13413ea9a877 137 * @}
ganlikun 0:13413ea9a877 138 */
ganlikun 0:13413ea9a877 139
ganlikun 0:13413ea9a877 140 /** @defgroup DCMI_Synchronization_Mode DCMI Synchronization Mode
ganlikun 0:13413ea9a877 141 * @{
ganlikun 0:13413ea9a877 142 */
ganlikun 0:13413ea9a877 143 #define DCMI_SYNCHRO_HARDWARE 0x00000000U /*!< Hardware synchronization data capture (frame/line start/stop)
ganlikun 0:13413ea9a877 144 is synchronized with the HSYNC/VSYNC signals */
ganlikun 0:13413ea9a877 145 #define DCMI_SYNCHRO_EMBEDDED ((uint32_t)DCMI_CR_ESS) /*!< Embedded synchronization data capture is synchronized with
ganlikun 0:13413ea9a877 146 synchronization codes embedded in the data flow */
ganlikun 0:13413ea9a877 147
ganlikun 0:13413ea9a877 148 /**
ganlikun 0:13413ea9a877 149 * @}
ganlikun 0:13413ea9a877 150 */
ganlikun 0:13413ea9a877 151
ganlikun 0:13413ea9a877 152 /** @defgroup DCMI_PIXCK_Polarity DCMI PIXCK Polarity
ganlikun 0:13413ea9a877 153 * @{
ganlikun 0:13413ea9a877 154 */
ganlikun 0:13413ea9a877 155 #define DCMI_PCKPOLARITY_FALLING 0x00000000U /*!< Pixel clock active on Falling edge */
ganlikun 0:13413ea9a877 156 #define DCMI_PCKPOLARITY_RISING ((uint32_t)DCMI_CR_PCKPOL) /*!< Pixel clock active on Rising edge */
ganlikun 0:13413ea9a877 157
ganlikun 0:13413ea9a877 158 /**
ganlikun 0:13413ea9a877 159 * @}
ganlikun 0:13413ea9a877 160 */
ganlikun 0:13413ea9a877 161
ganlikun 0:13413ea9a877 162 /** @defgroup DCMI_VSYNC_Polarity DCMI VSYNC Polarity
ganlikun 0:13413ea9a877 163 * @{
ganlikun 0:13413ea9a877 164 */
ganlikun 0:13413ea9a877 165 #define DCMI_VSPOLARITY_LOW 0x00000000U /*!< Vertical synchronization active Low */
ganlikun 0:13413ea9a877 166 #define DCMI_VSPOLARITY_HIGH ((uint32_t)DCMI_CR_VSPOL) /*!< Vertical synchronization active High */
ganlikun 0:13413ea9a877 167
ganlikun 0:13413ea9a877 168 /**
ganlikun 0:13413ea9a877 169 * @}
ganlikun 0:13413ea9a877 170 */
ganlikun 0:13413ea9a877 171
ganlikun 0:13413ea9a877 172 /** @defgroup DCMI_HSYNC_Polarity DCMI HSYNC Polarity
ganlikun 0:13413ea9a877 173 * @{
ganlikun 0:13413ea9a877 174 */
ganlikun 0:13413ea9a877 175 #define DCMI_HSPOLARITY_LOW 0x00000000U /*!< Horizontal synchronization active Low */
ganlikun 0:13413ea9a877 176 #define DCMI_HSPOLARITY_HIGH ((uint32_t)DCMI_CR_HSPOL) /*!< Horizontal synchronization active High */
ganlikun 0:13413ea9a877 177
ganlikun 0:13413ea9a877 178 /**
ganlikun 0:13413ea9a877 179 * @}
ganlikun 0:13413ea9a877 180 */
ganlikun 0:13413ea9a877 181
ganlikun 0:13413ea9a877 182 /** @defgroup DCMI_MODE_JPEG DCMI MODE JPEG
ganlikun 0:13413ea9a877 183 * @{
ganlikun 0:13413ea9a877 184 */
ganlikun 0:13413ea9a877 185 #define DCMI_JPEG_DISABLE 0x00000000U /*!< Mode JPEG Disabled */
ganlikun 0:13413ea9a877 186 #define DCMI_JPEG_ENABLE ((uint32_t)DCMI_CR_JPEG) /*!< Mode JPEG Enabled */
ganlikun 0:13413ea9a877 187
ganlikun 0:13413ea9a877 188 /**
ganlikun 0:13413ea9a877 189 * @}
ganlikun 0:13413ea9a877 190 */
ganlikun 0:13413ea9a877 191
ganlikun 0:13413ea9a877 192 /** @defgroup DCMI_Capture_Rate DCMI Capture Rate
ganlikun 0:13413ea9a877 193 * @{
ganlikun 0:13413ea9a877 194 */
ganlikun 0:13413ea9a877 195 #define DCMI_CR_ALL_FRAME 0x00000000U /*!< All frames are captured */
ganlikun 0:13413ea9a877 196 #define DCMI_CR_ALTERNATE_2_FRAME ((uint32_t)DCMI_CR_FCRC_0) /*!< Every alternate frame captured */
ganlikun 0:13413ea9a877 197 #define DCMI_CR_ALTERNATE_4_FRAME ((uint32_t)DCMI_CR_FCRC_1) /*!< One frame in 4 frames captured */
ganlikun 0:13413ea9a877 198
ganlikun 0:13413ea9a877 199 /**
ganlikun 0:13413ea9a877 200 * @}
ganlikun 0:13413ea9a877 201 */
ganlikun 0:13413ea9a877 202
ganlikun 0:13413ea9a877 203 /** @defgroup DCMI_Extended_Data_Mode DCMI Extended Data Mode
ganlikun 0:13413ea9a877 204 * @{
ganlikun 0:13413ea9a877 205 */
ganlikun 0:13413ea9a877 206 #define DCMI_EXTEND_DATA_8B 0x00000000U /*!< Interface captures 8-bit data on every pixel clock */
ganlikun 0:13413ea9a877 207 #define DCMI_EXTEND_DATA_10B ((uint32_t)DCMI_CR_EDM_0) /*!< Interface captures 10-bit data on every pixel clock */
ganlikun 0:13413ea9a877 208 #define DCMI_EXTEND_DATA_12B ((uint32_t)DCMI_CR_EDM_1) /*!< Interface captures 12-bit data on every pixel clock */
ganlikun 0:13413ea9a877 209 #define DCMI_EXTEND_DATA_14B ((uint32_t)(DCMI_CR_EDM_0 | DCMI_CR_EDM_1)) /*!< Interface captures 14-bit data on every pixel clock */
ganlikun 0:13413ea9a877 210
ganlikun 0:13413ea9a877 211 /**
ganlikun 0:13413ea9a877 212 * @}
ganlikun 0:13413ea9a877 213 */
ganlikun 0:13413ea9a877 214
ganlikun 0:13413ea9a877 215 /** @defgroup DCMI_Window_Coordinate DCMI Window Coordinate
ganlikun 0:13413ea9a877 216 * @{
ganlikun 0:13413ea9a877 217 */
ganlikun 0:13413ea9a877 218 #define DCMI_WINDOW_COORDINATE 0x3FFFU /*!< Window coordinate */
ganlikun 0:13413ea9a877 219
ganlikun 0:13413ea9a877 220 /**
ganlikun 0:13413ea9a877 221 * @}
ganlikun 0:13413ea9a877 222 */
ganlikun 0:13413ea9a877 223
ganlikun 0:13413ea9a877 224 /** @defgroup DCMI_Window_Height DCMI Window Height
ganlikun 0:13413ea9a877 225 * @{
ganlikun 0:13413ea9a877 226 */
ganlikun 0:13413ea9a877 227 #define DCMI_WINDOW_HEIGHT 0x1FFFU /*!< Window Height */
ganlikun 0:13413ea9a877 228
ganlikun 0:13413ea9a877 229 /**
ganlikun 0:13413ea9a877 230 * @}
ganlikun 0:13413ea9a877 231 */
ganlikun 0:13413ea9a877 232
ganlikun 0:13413ea9a877 233 /** @defgroup DCMI_Window_Vertical_Line DCMI Window Vertical Line
ganlikun 0:13413ea9a877 234 * @{
ganlikun 0:13413ea9a877 235 */
ganlikun 0:13413ea9a877 236 #define DCMI_POSITION_CWSIZE_VLINE (uint32_t)POSITION_VAL(DCMI_CWSIZE_VLINE) /*!< Required left shift to set crop window vertical line count */
ganlikun 0:13413ea9a877 237 #define DCMI_POSITION_CWSTRT_VST (uint32_t)POSITION_VAL(DCMI_CWSTRT_VST) /*!< Required left shift to set crop window vertical start line count */
ganlikun 0:13413ea9a877 238
ganlikun 0:13413ea9a877 239 /**
ganlikun 0:13413ea9a877 240 * @}
ganlikun 0:13413ea9a877 241 */
ganlikun 0:13413ea9a877 242
ganlikun 0:13413ea9a877 243 /** @defgroup DCMI_interrupt_sources DCMI interrupt sources
ganlikun 0:13413ea9a877 244 * @{
ganlikun 0:13413ea9a877 245 */
ganlikun 0:13413ea9a877 246 #define DCMI_IT_FRAME ((uint32_t)DCMI_IER_FRAME_IE) /*!< Capture complete interrupt */
ganlikun 0:13413ea9a877 247 #define DCMI_IT_OVR ((uint32_t)DCMI_IER_OVR_IE) /*!< Overrun interrupt */
ganlikun 0:13413ea9a877 248 #define DCMI_IT_ERR ((uint32_t)DCMI_IER_ERR_IE) /*!< Synchronization error interrupt */
ganlikun 0:13413ea9a877 249 #define DCMI_IT_VSYNC ((uint32_t)DCMI_IER_VSYNC_IE) /*!< VSYNC interrupt */
ganlikun 0:13413ea9a877 250 #define DCMI_IT_LINE ((uint32_t)DCMI_IER_LINE_IE) /*!< Line interrupt */
ganlikun 0:13413ea9a877 251 /**
ganlikun 0:13413ea9a877 252 * @}
ganlikun 0:13413ea9a877 253 */
ganlikun 0:13413ea9a877 254
ganlikun 0:13413ea9a877 255 /** @defgroup DCMI_Flags DCMI Flags
ganlikun 0:13413ea9a877 256 * @{
ganlikun 0:13413ea9a877 257 */
ganlikun 0:13413ea9a877 258
ganlikun 0:13413ea9a877 259 /**
ganlikun 0:13413ea9a877 260 * @brief DCMI SR register
ganlikun 0:13413ea9a877 261 */
ganlikun 0:13413ea9a877 262 #define DCMI_FLAG_HSYNC ((uint32_t)DCMI_SR_INDEX|DCMI_SR_HSYNC) /*!< HSYNC pin state (active line / synchronization between lines) */
ganlikun 0:13413ea9a877 263 #define DCMI_FLAG_VSYNC ((uint32_t)DCMI_SR_INDEX|DCMI_SR_VSYNC) /*!< VSYNC pin state (active frame / synchronization between frames) */
ganlikun 0:13413ea9a877 264 #define DCMI_FLAG_FNE ((uint32_t)DCMI_SR_INDEX|DCMI_SR_FNE) /*!< FIFO not empty flag */
ganlikun 0:13413ea9a877 265 /**
ganlikun 0:13413ea9a877 266 * @brief DCMI RIS register
ganlikun 0:13413ea9a877 267 */
ganlikun 0:13413ea9a877 268 #define DCMI_FLAG_FRAMERI ((uint32_t)DCMI_RISR_FRAME_RIS) /*!< Frame capture complete interrupt flag */
ganlikun 0:13413ea9a877 269 #define DCMI_FLAG_OVRRI ((uint32_t)DCMI_RISR_OVR_RIS) /*!< Overrun interrupt flag */
ganlikun 0:13413ea9a877 270 #define DCMI_FLAG_ERRRI ((uint32_t)DCMI_RISR_ERR_RIS) /*!< Synchronization error interrupt flag */
ganlikun 0:13413ea9a877 271 #define DCMI_FLAG_VSYNCRI ((uint32_t)DCMI_RISR_VSYNC_RIS) /*!< VSYNC interrupt flag */
ganlikun 0:13413ea9a877 272 #define DCMI_FLAG_LINERI ((uint32_t)DCMI_RISR_LINE_RIS) /*!< Line interrupt flag */
ganlikun 0:13413ea9a877 273 /**
ganlikun 0:13413ea9a877 274 * @brief DCMI MIS register
ganlikun 0:13413ea9a877 275 */
ganlikun 0:13413ea9a877 276 #define DCMI_FLAG_FRAMEMI ((uint32_t)DCMI_MIS_INDEX|DCMI_MIS_FRAME_MIS) /*!< DCMI Frame capture complete masked interrupt status */
ganlikun 0:13413ea9a877 277 #define DCMI_FLAG_OVRMI ((uint32_t)DCMI_MIS_INDEX|DCMI_MIS_OVR_MIS ) /*!< DCMI Overrun masked interrupt status */
ganlikun 0:13413ea9a877 278 #define DCMI_FLAG_ERRMI ((uint32_t)DCMI_MIS_INDEX|DCMI_MIS_ERR_MIS ) /*!< DCMI Synchronization error masked interrupt status */
ganlikun 0:13413ea9a877 279 #define DCMI_FLAG_VSYNCMI ((uint32_t)DCMI_MIS_INDEX|DCMI_MIS_VSYNC_MIS) /*!< DCMI VSYNC masked interrupt status */
ganlikun 0:13413ea9a877 280 #define DCMI_FLAG_LINEMI ((uint32_t)DCMI_MIS_INDEX|DCMI_MIS_LINE_MIS ) /*!< DCMI Line masked interrupt status */
ganlikun 0:13413ea9a877 281 /**
ganlikun 0:13413ea9a877 282 * @}
ganlikun 0:13413ea9a877 283 */
ganlikun 0:13413ea9a877 284
ganlikun 0:13413ea9a877 285 /**
ganlikun 0:13413ea9a877 286 * @}
ganlikun 0:13413ea9a877 287 */
ganlikun 0:13413ea9a877 288
ganlikun 0:13413ea9a877 289 /* Exported macro ------------------------------------------------------------*/
ganlikun 0:13413ea9a877 290 /** @defgroup DCMI_Exported_Macros DCMI Exported Macros
ganlikun 0:13413ea9a877 291 * @{
ganlikun 0:13413ea9a877 292 */
ganlikun 0:13413ea9a877 293
ganlikun 0:13413ea9a877 294 /** @brief Reset DCMI handle state
ganlikun 0:13413ea9a877 295 * @param __HANDLE__: specifies the DCMI handle.
ganlikun 0:13413ea9a877 296 * @retval None
ganlikun 0:13413ea9a877 297 */
ganlikun 0:13413ea9a877 298 #define __HAL_DCMI_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_DCMI_STATE_RESET)
ganlikun 0:13413ea9a877 299
ganlikun 0:13413ea9a877 300 /**
ganlikun 0:13413ea9a877 301 * @brief Enable the DCMI.
ganlikun 0:13413ea9a877 302 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 303 * @retval None
ganlikun 0:13413ea9a877 304 */
ganlikun 0:13413ea9a877 305 #define __HAL_DCMI_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= DCMI_CR_ENABLE)
ganlikun 0:13413ea9a877 306
ganlikun 0:13413ea9a877 307 /**
ganlikun 0:13413ea9a877 308 * @brief Disable the DCMI.
ganlikun 0:13413ea9a877 309 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 310 * @retval None
ganlikun 0:13413ea9a877 311 */
ganlikun 0:13413ea9a877 312 #define __HAL_DCMI_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(DCMI_CR_ENABLE))
ganlikun 0:13413ea9a877 313
ganlikun 0:13413ea9a877 314 /* Interrupt & Flag management */
ganlikun 0:13413ea9a877 315 /**
ganlikun 0:13413ea9a877 316 * @brief Get the DCMI pending flag.
ganlikun 0:13413ea9a877 317 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 318 * @param __FLAG__: Get the specified flag.
ganlikun 0:13413ea9a877 319 * This parameter can be one of the following values (no combination allowed)
ganlikun 0:13413ea9a877 320 * @arg DCMI_FLAG_HSYNC: HSYNC pin state (active line / synchronization between lines)
ganlikun 0:13413ea9a877 321 * @arg DCMI_FLAG_VSYNC: VSYNC pin state (active frame / synchronization between frames)
ganlikun 0:13413ea9a877 322 * @arg DCMI_FLAG_FNE: FIFO empty flag
ganlikun 0:13413ea9a877 323 * @arg DCMI_FLAG_FRAMERI: Frame capture complete flag mask
ganlikun 0:13413ea9a877 324 * @arg DCMI_FLAG_OVRRI: Overrun flag mask
ganlikun 0:13413ea9a877 325 * @arg DCMI_FLAG_ERRRI: Synchronization error flag mask
ganlikun 0:13413ea9a877 326 * @arg DCMI_FLAG_VSYNCRI: VSYNC flag mask
ganlikun 0:13413ea9a877 327 * @arg DCMI_FLAG_LINERI: Line flag mask
ganlikun 0:13413ea9a877 328 * @arg DCMI_FLAG_FRAMEMI: DCMI Capture complete masked interrupt status
ganlikun 0:13413ea9a877 329 * @arg DCMI_FLAG_OVRMI: DCMI Overrun masked interrupt status
ganlikun 0:13413ea9a877 330 * @arg DCMI_FLAG_ERRMI: DCMI Synchronization error masked interrupt status
ganlikun 0:13413ea9a877 331 * @arg DCMI_FLAG_VSYNCMI: DCMI VSYNC masked interrupt status
ganlikun 0:13413ea9a877 332 * @arg DCMI_FLAG_LINEMI: DCMI Line masked interrupt status
ganlikun 0:13413ea9a877 333 * @retval The state of FLAG.
ganlikun 0:13413ea9a877 334 */
ganlikun 0:13413ea9a877 335 #define __HAL_DCMI_GET_FLAG(__HANDLE__, __FLAG__)\
ganlikun 0:13413ea9a877 336 ((((__FLAG__) & (DCMI_SR_INDEX|DCMI_MIS_INDEX)) == 0x0U)? ((__HANDLE__)->Instance->RISR & (__FLAG__)) :\
ganlikun 0:13413ea9a877 337 (((__FLAG__) & DCMI_SR_INDEX) == 0x0U)? ((__HANDLE__)->Instance->MISR & (__FLAG__)) : ((__HANDLE__)->Instance->SR & (__FLAG__)))
ganlikun 0:13413ea9a877 338
ganlikun 0:13413ea9a877 339 /**
ganlikun 0:13413ea9a877 340 * @brief Clear the DCMI pending flags.
ganlikun 0:13413ea9a877 341 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 342 * @param __FLAG__: specifies the flag to clear.
ganlikun 0:13413ea9a877 343 * This parameter can be any combination of the following values:
ganlikun 0:13413ea9a877 344 * @arg DCMI_FLAG_FRAMERI: Frame capture complete flag mask
ganlikun 0:13413ea9a877 345 * @arg DCMI_FLAG_OVRRI: Overrun flag mask
ganlikun 0:13413ea9a877 346 * @arg DCMI_FLAG_ERRRI: Synchronization error flag mask
ganlikun 0:13413ea9a877 347 * @arg DCMI_FLAG_VSYNCRI: VSYNC flag mask
ganlikun 0:13413ea9a877 348 * @arg DCMI_FLAG_LINERI: Line flag mask
ganlikun 0:13413ea9a877 349 * @retval None
ganlikun 0:13413ea9a877 350 */
ganlikun 0:13413ea9a877 351 #define __HAL_DCMI_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
ganlikun 0:13413ea9a877 352
ganlikun 0:13413ea9a877 353 /**
ganlikun 0:13413ea9a877 354 * @brief Enable the specified DCMI interrupts.
ganlikun 0:13413ea9a877 355 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 356 * @param __INTERRUPT__: specifies the DCMI interrupt sources to be enabled.
ganlikun 0:13413ea9a877 357 * This parameter can be any combination of the following values:
ganlikun 0:13413ea9a877 358 * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask
ganlikun 0:13413ea9a877 359 * @arg DCMI_IT_OVR: Overrun interrupt mask
ganlikun 0:13413ea9a877 360 * @arg DCMI_IT_ERR: Synchronization error interrupt mask
ganlikun 0:13413ea9a877 361 * @arg DCMI_IT_VSYNC: VSYNC interrupt mask
ganlikun 0:13413ea9a877 362 * @arg DCMI_IT_LINE: Line interrupt mask
ganlikun 0:13413ea9a877 363 * @retval None
ganlikun 0:13413ea9a877 364 */
ganlikun 0:13413ea9a877 365 #define __HAL_DCMI_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
ganlikun 0:13413ea9a877 366
ganlikun 0:13413ea9a877 367 /**
ganlikun 0:13413ea9a877 368 * @brief Disable the specified DCMI interrupts.
ganlikun 0:13413ea9a877 369 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 370 * @param __INTERRUPT__: specifies the DCMI interrupt sources to be enabled.
ganlikun 0:13413ea9a877 371 * This parameter can be any combination of the following values:
ganlikun 0:13413ea9a877 372 * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask
ganlikun 0:13413ea9a877 373 * @arg DCMI_IT_OVR: Overrun interrupt mask
ganlikun 0:13413ea9a877 374 * @arg DCMI_IT_ERR: Synchronization error interrupt mask
ganlikun 0:13413ea9a877 375 * @arg DCMI_IT_VSYNC: VSYNC interrupt mask
ganlikun 0:13413ea9a877 376 * @arg DCMI_IT_LINE: Line interrupt mask
ganlikun 0:13413ea9a877 377 * @retval None
ganlikun 0:13413ea9a877 378 */
ganlikun 0:13413ea9a877 379 #define __HAL_DCMI_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= ~(__INTERRUPT__))
ganlikun 0:13413ea9a877 380
ganlikun 0:13413ea9a877 381 /**
ganlikun 0:13413ea9a877 382 * @brief Check whether the specified DCMI interrupt has occurred or not.
ganlikun 0:13413ea9a877 383 * @param __HANDLE__: DCMI handle
ganlikun 0:13413ea9a877 384 * @param __INTERRUPT__: specifies the DCMI interrupt source to check.
ganlikun 0:13413ea9a877 385 * This parameter can be one of the following values:
ganlikun 0:13413ea9a877 386 * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask
ganlikun 0:13413ea9a877 387 * @arg DCMI_IT_OVR: Overrun interrupt mask
ganlikun 0:13413ea9a877 388 * @arg DCMI_IT_ERR: Synchronization error interrupt mask
ganlikun 0:13413ea9a877 389 * @arg DCMI_IT_VSYNC: VSYNC interrupt mask
ganlikun 0:13413ea9a877 390 * @arg DCMI_IT_LINE: Line interrupt mask
ganlikun 0:13413ea9a877 391 * @retval The state of INTERRUPT.
ganlikun 0:13413ea9a877 392 */
ganlikun 0:13413ea9a877 393 #define __HAL_DCMI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->MISR & (__INTERRUPT__))
ganlikun 0:13413ea9a877 394
ganlikun 0:13413ea9a877 395 /**
ganlikun 0:13413ea9a877 396 * @}
ganlikun 0:13413ea9a877 397 */
ganlikun 0:13413ea9a877 398
ganlikun 0:13413ea9a877 399 /* Exported functions --------------------------------------------------------*/
ganlikun 0:13413ea9a877 400 /** @addtogroup DCMI_Exported_Functions DCMI Exported Functions
ganlikun 0:13413ea9a877 401 * @{
ganlikun 0:13413ea9a877 402 */
ganlikun 0:13413ea9a877 403
ganlikun 0:13413ea9a877 404 /** @addtogroup DCMI_Exported_Functions_Group1 Initialization and Configuration functions
ganlikun 0:13413ea9a877 405 * @{
ganlikun 0:13413ea9a877 406 */
ganlikun 0:13413ea9a877 407 /* Initialization and de-initialization functions *****************************/
ganlikun 0:13413ea9a877 408 HAL_StatusTypeDef HAL_DCMI_Init(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 409 HAL_StatusTypeDef HAL_DCMI_DeInit(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 410 void HAL_DCMI_MspInit(DCMI_HandleTypeDef* hdcmi);
ganlikun 0:13413ea9a877 411 void HAL_DCMI_MspDeInit(DCMI_HandleTypeDef* hdcmi);
ganlikun 0:13413ea9a877 412 /**
ganlikun 0:13413ea9a877 413 * @}
ganlikun 0:13413ea9a877 414 */
ganlikun 0:13413ea9a877 415
ganlikun 0:13413ea9a877 416 /** @addtogroup DCMI_Exported_Functions_Group2 IO operation functions
ganlikun 0:13413ea9a877 417 * @{
ganlikun 0:13413ea9a877 418 */
ganlikun 0:13413ea9a877 419 /* IO operation functions *****************************************************/
ganlikun 0:13413ea9a877 420 HAL_StatusTypeDef HAL_DCMI_Start_DMA(DCMI_HandleTypeDef* hdcmi, uint32_t DCMI_Mode, uint32_t pData, uint32_t Length);
ganlikun 0:13413ea9a877 421 HAL_StatusTypeDef HAL_DCMI_Stop(DCMI_HandleTypeDef* hdcmi);
ganlikun 0:13413ea9a877 422 HAL_StatusTypeDef HAL_DCMI_Suspend(DCMI_HandleTypeDef* hdcmi);
ganlikun 0:13413ea9a877 423 HAL_StatusTypeDef HAL_DCMI_Resume(DCMI_HandleTypeDef* hdcmi);
ganlikun 0:13413ea9a877 424 void HAL_DCMI_ErrorCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 425 void HAL_DCMI_LineEventCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 426 void HAL_DCMI_FrameEventCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 427 void HAL_DCMI_VsyncEventCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 428 void HAL_DCMI_VsyncCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 429 void HAL_DCMI_HsyncCallback(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 430 void HAL_DCMI_IRQHandler(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 431 /**
ganlikun 0:13413ea9a877 432 * @}
ganlikun 0:13413ea9a877 433 */
ganlikun 0:13413ea9a877 434
ganlikun 0:13413ea9a877 435 /** @addtogroup DCMI_Exported_Functions_Group3 Peripheral Control functions
ganlikun 0:13413ea9a877 436 * @{
ganlikun 0:13413ea9a877 437 */
ganlikun 0:13413ea9a877 438 /* Peripheral Control functions ***********************************************/
ganlikun 0:13413ea9a877 439 HAL_StatusTypeDef HAL_DCMI_ConfigCrop(DCMI_HandleTypeDef *hdcmi, uint32_t X0, uint32_t Y0, uint32_t XSize, uint32_t YSize);
ganlikun 0:13413ea9a877 440 HAL_StatusTypeDef HAL_DCMI_EnableCrop(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 441 HAL_StatusTypeDef HAL_DCMI_DisableCrop(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 442 /**
ganlikun 0:13413ea9a877 443 * @}
ganlikun 0:13413ea9a877 444 */
ganlikun 0:13413ea9a877 445
ganlikun 0:13413ea9a877 446 /** @addtogroup DCMI_Exported_Functions_Group4 Peripheral State functions
ganlikun 0:13413ea9a877 447 * @{
ganlikun 0:13413ea9a877 448 */
ganlikun 0:13413ea9a877 449 /* Peripheral State functions *************************************************/
ganlikun 0:13413ea9a877 450 HAL_DCMI_StateTypeDef HAL_DCMI_GetState(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 451 uint32_t HAL_DCMI_GetError(DCMI_HandleTypeDef *hdcmi);
ganlikun 0:13413ea9a877 452 /**
ganlikun 0:13413ea9a877 453 * @}
ganlikun 0:13413ea9a877 454 */
ganlikun 0:13413ea9a877 455
ganlikun 0:13413ea9a877 456 /**
ganlikun 0:13413ea9a877 457 * @}
ganlikun 0:13413ea9a877 458 */
ganlikun 0:13413ea9a877 459
ganlikun 0:13413ea9a877 460 /* Private types -------------------------------------------------------------*/
ganlikun 0:13413ea9a877 461 /* Private variables ---------------------------------------------------------*/
ganlikun 0:13413ea9a877 462 /* Private constants ---------------------------------------------------------*/
ganlikun 0:13413ea9a877 463 /** @defgroup DCMI_Private_Constants DCMI Private Constants
ganlikun 0:13413ea9a877 464 * @{
ganlikun 0:13413ea9a877 465 */
ganlikun 0:13413ea9a877 466 #define DCMI_MIS_INDEX 0x1000U /*!< DCMI MIS register index */
ganlikun 0:13413ea9a877 467 #define DCMI_SR_INDEX 0x2000U /*!< DCMI SR register index */
ganlikun 0:13413ea9a877 468 /**
ganlikun 0:13413ea9a877 469 * @}
ganlikun 0:13413ea9a877 470 */
ganlikun 0:13413ea9a877 471 /* Private macro -------------------------------------------------------------*/
ganlikun 0:13413ea9a877 472 /** @defgroup DCMI_Private_Macros DCMI Private Macros
ganlikun 0:13413ea9a877 473 * @{
ganlikun 0:13413ea9a877 474 */
ganlikun 0:13413ea9a877 475 #define IS_DCMI_CAPTURE_MODE(MODE)(((MODE) == DCMI_MODE_CONTINUOUS) || \
ganlikun 0:13413ea9a877 476 ((MODE) == DCMI_MODE_SNAPSHOT))
ganlikun 0:13413ea9a877 477
ganlikun 0:13413ea9a877 478 #define IS_DCMI_SYNCHRO(MODE)(((MODE) == DCMI_SYNCHRO_HARDWARE) || \
ganlikun 0:13413ea9a877 479 ((MODE) == DCMI_SYNCHRO_EMBEDDED))
ganlikun 0:13413ea9a877 480
ganlikun 0:13413ea9a877 481 #define IS_DCMI_PCKPOLARITY(POLARITY)(((POLARITY) == DCMI_PCKPOLARITY_FALLING) || \
ganlikun 0:13413ea9a877 482 ((POLARITY) == DCMI_PCKPOLARITY_RISING))
ganlikun 0:13413ea9a877 483
ganlikun 0:13413ea9a877 484 #define IS_DCMI_VSPOLARITY(POLARITY)(((POLARITY) == DCMI_VSPOLARITY_LOW) || \
ganlikun 0:13413ea9a877 485 ((POLARITY) == DCMI_VSPOLARITY_HIGH))
ganlikun 0:13413ea9a877 486
ganlikun 0:13413ea9a877 487 #define IS_DCMI_HSPOLARITY(POLARITY)(((POLARITY) == DCMI_HSPOLARITY_LOW) || \
ganlikun 0:13413ea9a877 488 ((POLARITY) == DCMI_HSPOLARITY_HIGH))
ganlikun 0:13413ea9a877 489
ganlikun 0:13413ea9a877 490 #define IS_DCMI_MODE_JPEG(JPEG_MODE)(((JPEG_MODE) == DCMI_JPEG_DISABLE) || \
ganlikun 0:13413ea9a877 491 ((JPEG_MODE) == DCMI_JPEG_ENABLE))
ganlikun 0:13413ea9a877 492
ganlikun 0:13413ea9a877 493 #define IS_DCMI_CAPTURE_RATE(RATE) (((RATE) == DCMI_CR_ALL_FRAME) || \
ganlikun 0:13413ea9a877 494 ((RATE) == DCMI_CR_ALTERNATE_2_FRAME) || \
ganlikun 0:13413ea9a877 495 ((RATE) == DCMI_CR_ALTERNATE_4_FRAME))
ganlikun 0:13413ea9a877 496
ganlikun 0:13413ea9a877 497 #define IS_DCMI_EXTENDED_DATA(DATA)(((DATA) == DCMI_EXTEND_DATA_8B) || \
ganlikun 0:13413ea9a877 498 ((DATA) == DCMI_EXTEND_DATA_10B) || \
ganlikun 0:13413ea9a877 499 ((DATA) == DCMI_EXTEND_DATA_12B) || \
ganlikun 0:13413ea9a877 500 ((DATA) == DCMI_EXTEND_DATA_14B))
ganlikun 0:13413ea9a877 501
ganlikun 0:13413ea9a877 502 #define IS_DCMI_WINDOW_COORDINATE(COORDINATE) ((COORDINATE) <= DCMI_WINDOW_COORDINATE)
ganlikun 0:13413ea9a877 503
ganlikun 0:13413ea9a877 504 #define IS_DCMI_WINDOW_HEIGHT(HEIGHT) ((HEIGHT) <= DCMI_WINDOW_HEIGHT)
ganlikun 0:13413ea9a877 505
ganlikun 0:13413ea9a877 506 /**
ganlikun 0:13413ea9a877 507 * @}
ganlikun 0:13413ea9a877 508 */
ganlikun 0:13413ea9a877 509
ganlikun 0:13413ea9a877 510 /* Private functions ---------------------------------------------------------*/
ganlikun 0:13413ea9a877 511 /** @addtogroup DCMI_Private_Functions DCMI Private Functions
ganlikun 0:13413ea9a877 512 * @{
ganlikun 0:13413ea9a877 513 */
ganlikun 0:13413ea9a877 514
ganlikun 0:13413ea9a877 515 /**
ganlikun 0:13413ea9a877 516 * @}
ganlikun 0:13413ea9a877 517 */
ganlikun 0:13413ea9a877 518
ganlikun 0:13413ea9a877 519 #endif /* STM32F407xx || STM32F417xx || STM32F427xx || STM32F437xx ||\
ganlikun 0:13413ea9a877 520 STM32F429xx || STM32F439xx || STM32F446xx || STM32F469xx ||\
ganlikun 0:13413ea9a877 521 STM32F479xx */
ganlikun 0:13413ea9a877 522
ganlikun 0:13413ea9a877 523 /**
ganlikun 0:13413ea9a877 524 * @}
ganlikun 0:13413ea9a877 525 */
ganlikun 0:13413ea9a877 526
ganlikun 0:13413ea9a877 527 /**
ganlikun 0:13413ea9a877 528 * @}
ganlikun 0:13413ea9a877 529 */
ganlikun 0:13413ea9a877 530
ganlikun 0:13413ea9a877 531 #ifdef __cplusplus
ganlikun 0:13413ea9a877 532 }
ganlikun 0:13413ea9a877 533 #endif
ganlikun 0:13413ea9a877 534
ganlikun 0:13413ea9a877 535 #endif /* __STM32F4xx_HAL_DCMI_H */
ganlikun 0:13413ea9a877 536
ganlikun 0:13413ea9a877 537 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
ganlikun 0:13413ea9a877 538