Thomas Lyp / DevLibMemoryController

Initial commit

Dependencies:   FastPWM

mbed-dev-master/targets/TARGET_STM/TARGET_STM32F4/device/stm32f4xx_hal_flash.h@0:bb348c97df44, 2020-09-16 (annotated)

Committer:
lypinator
Date:
Wed Sep 16 01:11:49 2020 +0000
Revision:
0:bb348c97df44
Added PWM

Who changed what in which revision?

UserRevisionLine numberNew contents of line
lypinator 0:bb348c97df44 1 /**
lypinator 0:bb348c97df44 2 ******************************************************************************
lypinator 0:bb348c97df44 3 * @file stm32f4xx_hal_flash.h
lypinator 0:bb348c97df44 4 * @author MCD Application Team
lypinator 0:bb348c97df44 5 * @brief Header file of FLASH HAL module.
lypinator 0:bb348c97df44 6 ******************************************************************************
lypinator 0:bb348c97df44 7 * @attention
lypinator 0:bb348c97df44 8 *
lypinator 0:bb348c97df44 9 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
lypinator 0:bb348c97df44 10 *
lypinator 0:bb348c97df44 11 * Redistribution and use in source and binary forms, with or without modification,
lypinator 0:bb348c97df44 12 * are permitted provided that the following conditions are met:
lypinator 0:bb348c97df44 13 * 1. Redistributions of source code must retain the above copyright notice,
lypinator 0:bb348c97df44 14 * this list of conditions and the following disclaimer.
lypinator 0:bb348c97df44 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
lypinator 0:bb348c97df44 16 * this list of conditions and the following disclaimer in the documentation
lypinator 0:bb348c97df44 17 * and/or other materials provided with the distribution.
lypinator 0:bb348c97df44 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
lypinator 0:bb348c97df44 19 * may be used to endorse or promote products derived from this software
lypinator 0:bb348c97df44 20 * without specific prior written permission.
lypinator 0:bb348c97df44 21 *
lypinator 0:bb348c97df44 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
lypinator 0:bb348c97df44 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
lypinator 0:bb348c97df44 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
lypinator 0:bb348c97df44 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
lypinator 0:bb348c97df44 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
lypinator 0:bb348c97df44 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
lypinator 0:bb348c97df44 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
lypinator 0:bb348c97df44 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
lypinator 0:bb348c97df44 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
lypinator 0:bb348c97df44 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
lypinator 0:bb348c97df44 32 *
lypinator 0:bb348c97df44 33 ******************************************************************************
lypinator 0:bb348c97df44 34 */
lypinator 0:bb348c97df44 35
lypinator 0:bb348c97df44 36 /* Define to prevent recursive inclusion -------------------------------------*/
lypinator 0:bb348c97df44 37 #ifndef __STM32F4xx_HAL_FLASH_H
lypinator 0:bb348c97df44 38 #define __STM32F4xx_HAL_FLASH_H
lypinator 0:bb348c97df44 39
lypinator 0:bb348c97df44 40 #ifdef __cplusplus
lypinator 0:bb348c97df44 41 extern "C" {
lypinator 0:bb348c97df44 42 #endif
lypinator 0:bb348c97df44 43
lypinator 0:bb348c97df44 44 /* Includes ------------------------------------------------------------------*/
lypinator 0:bb348c97df44 45 #include "stm32f4xx_hal_def.h"
lypinator 0:bb348c97df44 46
lypinator 0:bb348c97df44 47 /** @addtogroup STM32F4xx_HAL_Driver
lypinator 0:bb348c97df44 48 * @{
lypinator 0:bb348c97df44 49 */
lypinator 0:bb348c97df44 50
lypinator 0:bb348c97df44 51 /** @addtogroup FLASH
lypinator 0:bb348c97df44 52 * @{
lypinator 0:bb348c97df44 53 */
lypinator 0:bb348c97df44 54
lypinator 0:bb348c97df44 55 /* Exported types ------------------------------------------------------------*/
lypinator 0:bb348c97df44 56 /** @defgroup FLASH_Exported_Types FLASH Exported Types
lypinator 0:bb348c97df44 57 * @{
lypinator 0:bb348c97df44 58 */
lypinator 0:bb348c97df44 59
lypinator 0:bb348c97df44 60 /**
lypinator 0:bb348c97df44 61 * @brief FLASH Procedure structure definition
lypinator 0:bb348c97df44 62 */
lypinator 0:bb348c97df44 63 typedef enum
lypinator 0:bb348c97df44 64 {
lypinator 0:bb348c97df44 65 FLASH_PROC_NONE = 0U,
lypinator 0:bb348c97df44 66 FLASH_PROC_SECTERASE,
lypinator 0:bb348c97df44 67 FLASH_PROC_MASSERASE,
lypinator 0:bb348c97df44 68 FLASH_PROC_PROGRAM
lypinator 0:bb348c97df44 69 } FLASH_ProcedureTypeDef;
lypinator 0:bb348c97df44 70
lypinator 0:bb348c97df44 71 /**
lypinator 0:bb348c97df44 72 * @brief FLASH handle Structure definition
lypinator 0:bb348c97df44 73 */
lypinator 0:bb348c97df44 74 typedef struct
lypinator 0:bb348c97df44 75 {
lypinator 0:bb348c97df44 76 __IO FLASH_ProcedureTypeDef ProcedureOnGoing; /*Internal variable to indicate which procedure is ongoing or not in IT context*/
lypinator 0:bb348c97df44 77
lypinator 0:bb348c97df44 78 __IO uint32_t NbSectorsToErase; /*Internal variable to save the remaining sectors to erase in IT context*/
lypinator 0:bb348c97df44 79
lypinator 0:bb348c97df44 80 __IO uint8_t VoltageForErase; /*Internal variable to provide voltage range selected by user in IT context*/
lypinator 0:bb348c97df44 81
lypinator 0:bb348c97df44 82 __IO uint32_t Sector; /*Internal variable to define the current sector which is erasing*/
lypinator 0:bb348c97df44 83
lypinator 0:bb348c97df44 84 __IO uint32_t Bank; /*Internal variable to save current bank selected during mass erase*/
lypinator 0:bb348c97df44 85
lypinator 0:bb348c97df44 86 __IO uint32_t Address; /*Internal variable to save address selected for program*/
lypinator 0:bb348c97df44 87
lypinator 0:bb348c97df44 88 HAL_LockTypeDef Lock; /* FLASH locking object */
lypinator 0:bb348c97df44 89
lypinator 0:bb348c97df44 90 __IO uint32_t ErrorCode; /* FLASH error code */
lypinator 0:bb348c97df44 91
lypinator 0:bb348c97df44 92 }FLASH_ProcessTypeDef;
lypinator 0:bb348c97df44 93
lypinator 0:bb348c97df44 94 /**
lypinator 0:bb348c97df44 95 * @}
lypinator 0:bb348c97df44 96 */
lypinator 0:bb348c97df44 97
lypinator 0:bb348c97df44 98 /* Exported constants --------------------------------------------------------*/
lypinator 0:bb348c97df44 99 /** @defgroup FLASH_Exported_Constants FLASH Exported Constants
lypinator 0:bb348c97df44 100 * @{
lypinator 0:bb348c97df44 101 */
lypinator 0:bb348c97df44 102 /** @defgroup FLASH_Error_Code FLASH Error Code
lypinator 0:bb348c97df44 103 * @brief FLASH Error Code
lypinator 0:bb348c97df44 104 * @{
lypinator 0:bb348c97df44 105 */
lypinator 0:bb348c97df44 106 #define HAL_FLASH_ERROR_NONE 0x00000000U /*!< No error */
lypinator 0:bb348c97df44 107 #define HAL_FLASH_ERROR_RD 0x00000001U /*!< Read Protection error */
lypinator 0:bb348c97df44 108 #define HAL_FLASH_ERROR_PGS 0x00000002U /*!< Programming Sequence error */
lypinator 0:bb348c97df44 109 #define HAL_FLASH_ERROR_PGP 0x00000004U /*!< Programming Parallelism error */
lypinator 0:bb348c97df44 110 #define HAL_FLASH_ERROR_PGA 0x00000008U /*!< Programming Alignment error */
lypinator 0:bb348c97df44 111 #define HAL_FLASH_ERROR_WRP 0x00000010U /*!< Write protection error */
lypinator 0:bb348c97df44 112 #define HAL_FLASH_ERROR_OPERATION 0x00000020U /*!< Operation Error */
lypinator 0:bb348c97df44 113 /**
lypinator 0:bb348c97df44 114 * @}
lypinator 0:bb348c97df44 115 */
lypinator 0:bb348c97df44 116
lypinator 0:bb348c97df44 117 /** @defgroup FLASH_Type_Program FLASH Type Program
lypinator 0:bb348c97df44 118 * @{
lypinator 0:bb348c97df44 119 */
lypinator 0:bb348c97df44 120 #define FLASH_TYPEPROGRAM_BYTE 0x00000000U /*!< Program byte (8-bit) at a specified address */
lypinator 0:bb348c97df44 121 #define FLASH_TYPEPROGRAM_HALFWORD 0x00000001U /*!< Program a half-word (16-bit) at a specified address */
lypinator 0:bb348c97df44 122 #define FLASH_TYPEPROGRAM_WORD 0x00000002U /*!< Program a word (32-bit) at a specified address */
lypinator 0:bb348c97df44 123 #define FLASH_TYPEPROGRAM_DOUBLEWORD 0x00000003U /*!< Program a double word (64-bit) at a specified address */
lypinator 0:bb348c97df44 124 /**
lypinator 0:bb348c97df44 125 * @}
lypinator 0:bb348c97df44 126 */
lypinator 0:bb348c97df44 127
lypinator 0:bb348c97df44 128 /** @defgroup FLASH_Flag_definition FLASH Flag definition
lypinator 0:bb348c97df44 129 * @brief Flag definition
lypinator 0:bb348c97df44 130 * @{
lypinator 0:bb348c97df44 131 */
lypinator 0:bb348c97df44 132 #define FLASH_FLAG_EOP FLASH_SR_EOP /*!< FLASH End of Operation flag */
lypinator 0:bb348c97df44 133 #define FLASH_FLAG_OPERR FLASH_SR_SOP /*!< FLASH operation Error flag */
lypinator 0:bb348c97df44 134 #define FLASH_FLAG_WRPERR FLASH_SR_WRPERR /*!< FLASH Write protected error flag */
lypinator 0:bb348c97df44 135 #define FLASH_FLAG_PGAERR FLASH_SR_PGAERR /*!< FLASH Programming Alignment error flag */
lypinator 0:bb348c97df44 136 #define FLASH_FLAG_PGPERR FLASH_SR_PGPERR /*!< FLASH Programming Parallelism error flag */
lypinator 0:bb348c97df44 137 #define FLASH_FLAG_PGSERR FLASH_SR_PGSERR /*!< FLASH Programming Sequence error flag */
lypinator 0:bb348c97df44 138 #if defined(FLASH_SR_RDERR)
lypinator 0:bb348c97df44 139 #define FLASH_FLAG_RDERR FLASH_SR_RDERR /*!< Read Protection error flag (PCROP) */
lypinator 0:bb348c97df44 140 #endif /* FLASH_SR_RDERR */
lypinator 0:bb348c97df44 141 #define FLASH_FLAG_BSY FLASH_SR_BSY /*!< FLASH Busy flag */
lypinator 0:bb348c97df44 142 /**
lypinator 0:bb348c97df44 143 * @}
lypinator 0:bb348c97df44 144 */
lypinator 0:bb348c97df44 145
lypinator 0:bb348c97df44 146 /** @defgroup FLASH_Interrupt_definition FLASH Interrupt definition
lypinator 0:bb348c97df44 147 * @brief FLASH Interrupt definition
lypinator 0:bb348c97df44 148 * @{
lypinator 0:bb348c97df44 149 */
lypinator 0:bb348c97df44 150 #define FLASH_IT_EOP FLASH_CR_EOPIE /*!< End of FLASH Operation Interrupt source */
lypinator 0:bb348c97df44 151 #define FLASH_IT_ERR 0x02000000U /*!< Error Interrupt source */
lypinator 0:bb348c97df44 152 /**
lypinator 0:bb348c97df44 153 * @}
lypinator 0:bb348c97df44 154 */
lypinator 0:bb348c97df44 155
lypinator 0:bb348c97df44 156 /** @defgroup FLASH_Program_Parallelism FLASH Program Parallelism
lypinator 0:bb348c97df44 157 * @{
lypinator 0:bb348c97df44 158 */
lypinator 0:bb348c97df44 159 #define FLASH_PSIZE_BYTE 0x00000000U
lypinator 0:bb348c97df44 160 #define FLASH_PSIZE_HALF_WORD 0x00000100U
lypinator 0:bb348c97df44 161 #define FLASH_PSIZE_WORD 0x00000200U
lypinator 0:bb348c97df44 162 #define FLASH_PSIZE_DOUBLE_WORD 0x00000300U
lypinator 0:bb348c97df44 163 #define CR_PSIZE_MASK 0xFFFFFCFFU
lypinator 0:bb348c97df44 164 /**
lypinator 0:bb348c97df44 165 * @}
lypinator 0:bb348c97df44 166 */
lypinator 0:bb348c97df44 167
lypinator 0:bb348c97df44 168 /** @defgroup FLASH_Keys FLASH Keys
lypinator 0:bb348c97df44 169 * @{
lypinator 0:bb348c97df44 170 */
lypinator 0:bb348c97df44 171 #define RDP_KEY ((uint16_t)0x00A5)
lypinator 0:bb348c97df44 172 #define FLASH_KEY1 0x45670123U
lypinator 0:bb348c97df44 173 #define FLASH_KEY2 0xCDEF89ABU
lypinator 0:bb348c97df44 174 #define FLASH_OPT_KEY1 0x08192A3BU
lypinator 0:bb348c97df44 175 #define FLASH_OPT_KEY2 0x4C5D6E7FU
lypinator 0:bb348c97df44 176 /**
lypinator 0:bb348c97df44 177 * @}
lypinator 0:bb348c97df44 178 */
lypinator 0:bb348c97df44 179
lypinator 0:bb348c97df44 180 /**
lypinator 0:bb348c97df44 181 * @}
lypinator 0:bb348c97df44 182 */
lypinator 0:bb348c97df44 183
lypinator 0:bb348c97df44 184 /* Exported macro ------------------------------------------------------------*/
lypinator 0:bb348c97df44 185 /** @defgroup FLASH_Exported_Macros FLASH Exported Macros
lypinator 0:bb348c97df44 186 * @{
lypinator 0:bb348c97df44 187 */
lypinator 0:bb348c97df44 188 /**
lypinator 0:bb348c97df44 189 * @brief Set the FLASH Latency.
lypinator 0:bb348c97df44 190 * @param __LATENCY__ FLASH Latency
lypinator 0:bb348c97df44 191 * The value of this parameter depend on device used within the same series
lypinator 0:bb348c97df44 192 * @retval none
lypinator 0:bb348c97df44 193 */
lypinator 0:bb348c97df44 194 #define __HAL_FLASH_SET_LATENCY(__LATENCY__) (*(__IO uint8_t *)ACR_BYTE0_ADDRESS = (uint8_t)(__LATENCY__))
lypinator 0:bb348c97df44 195
lypinator 0:bb348c97df44 196 /**
lypinator 0:bb348c97df44 197 * @brief Get the FLASH Latency.
lypinator 0:bb348c97df44 198 * @retval FLASH Latency
lypinator 0:bb348c97df44 199 * The value of this parameter depend on device used within the same series
lypinator 0:bb348c97df44 200 */
lypinator 0:bb348c97df44 201 #define __HAL_FLASH_GET_LATENCY() (READ_BIT((FLASH->ACR), FLASH_ACR_LATENCY))
lypinator 0:bb348c97df44 202
lypinator 0:bb348c97df44 203 /**
lypinator 0:bb348c97df44 204 * @brief Enable the FLASH prefetch buffer.
lypinator 0:bb348c97df44 205 * @retval none
lypinator 0:bb348c97df44 206 */
lypinator 0:bb348c97df44 207 #define __HAL_FLASH_PREFETCH_BUFFER_ENABLE() (FLASH->ACR |= FLASH_ACR_PRFTEN)
lypinator 0:bb348c97df44 208
lypinator 0:bb348c97df44 209 /**
lypinator 0:bb348c97df44 210 * @brief Disable the FLASH prefetch buffer.
lypinator 0:bb348c97df44 211 * @retval none
lypinator 0:bb348c97df44 212 */
lypinator 0:bb348c97df44 213 #define __HAL_FLASH_PREFETCH_BUFFER_DISABLE() (FLASH->ACR &= (~FLASH_ACR_PRFTEN))
lypinator 0:bb348c97df44 214
lypinator 0:bb348c97df44 215 /**
lypinator 0:bb348c97df44 216 * @brief Enable the FLASH instruction cache.
lypinator 0:bb348c97df44 217 * @retval none
lypinator 0:bb348c97df44 218 */
lypinator 0:bb348c97df44 219 #define __HAL_FLASH_INSTRUCTION_CACHE_ENABLE() (FLASH->ACR |= FLASH_ACR_ICEN)
lypinator 0:bb348c97df44 220
lypinator 0:bb348c97df44 221 /**
lypinator 0:bb348c97df44 222 * @brief Disable the FLASH instruction cache.
lypinator 0:bb348c97df44 223 * @retval none
lypinator 0:bb348c97df44 224 */
lypinator 0:bb348c97df44 225 #define __HAL_FLASH_INSTRUCTION_CACHE_DISABLE() (FLASH->ACR &= (~FLASH_ACR_ICEN))
lypinator 0:bb348c97df44 226
lypinator 0:bb348c97df44 227 /**
lypinator 0:bb348c97df44 228 * @brief Enable the FLASH data cache.
lypinator 0:bb348c97df44 229 * @retval none
lypinator 0:bb348c97df44 230 */
lypinator 0:bb348c97df44 231 #define __HAL_FLASH_DATA_CACHE_ENABLE() (FLASH->ACR |= FLASH_ACR_DCEN)
lypinator 0:bb348c97df44 232
lypinator 0:bb348c97df44 233 /**
lypinator 0:bb348c97df44 234 * @brief Disable the FLASH data cache.
lypinator 0:bb348c97df44 235 * @retval none
lypinator 0:bb348c97df44 236 */
lypinator 0:bb348c97df44 237 #define __HAL_FLASH_DATA_CACHE_DISABLE() (FLASH->ACR &= (~FLASH_ACR_DCEN))
lypinator 0:bb348c97df44 238
lypinator 0:bb348c97df44 239 /**
lypinator 0:bb348c97df44 240 * @brief Resets the FLASH instruction Cache.
lypinator 0:bb348c97df44 241 * @note This function must be used only when the Instruction Cache is disabled.
lypinator 0:bb348c97df44 242 * @retval None
lypinator 0:bb348c97df44 243 */
lypinator 0:bb348c97df44 244 #define __HAL_FLASH_INSTRUCTION_CACHE_RESET() do {FLASH->ACR |= FLASH_ACR_ICRST; \
lypinator 0:bb348c97df44 245 FLASH->ACR &= ~FLASH_ACR_ICRST; \
lypinator 0:bb348c97df44 246 }while(0U)
lypinator 0:bb348c97df44 247
lypinator 0:bb348c97df44 248 /**
lypinator 0:bb348c97df44 249 * @brief Resets the FLASH data Cache.
lypinator 0:bb348c97df44 250 * @note This function must be used only when the data Cache is disabled.
lypinator 0:bb348c97df44 251 * @retval None
lypinator 0:bb348c97df44 252 */
lypinator 0:bb348c97df44 253 #define __HAL_FLASH_DATA_CACHE_RESET() do {FLASH->ACR |= FLASH_ACR_DCRST; \
lypinator 0:bb348c97df44 254 FLASH->ACR &= ~FLASH_ACR_DCRST; \
lypinator 0:bb348c97df44 255 }while(0U)
lypinator 0:bb348c97df44 256 /**
lypinator 0:bb348c97df44 257 * @brief Enable the specified FLASH interrupt.
lypinator 0:bb348c97df44 258 * @param __INTERRUPT__ FLASH interrupt
lypinator 0:bb348c97df44 259 * This parameter can be any combination of the following values:
lypinator 0:bb348c97df44 260 * @arg FLASH_IT_EOP: End of FLASH Operation Interrupt
lypinator 0:bb348c97df44 261 * @arg FLASH_IT_ERR: Error Interrupt
lypinator 0:bb348c97df44 262 * @retval none
lypinator 0:bb348c97df44 263 */
lypinator 0:bb348c97df44 264 #define __HAL_FLASH_ENABLE_IT(__INTERRUPT__) (FLASH->CR |= (__INTERRUPT__))
lypinator 0:bb348c97df44 265
lypinator 0:bb348c97df44 266 /**
lypinator 0:bb348c97df44 267 * @brief Disable the specified FLASH interrupt.
lypinator 0:bb348c97df44 268 * @param __INTERRUPT__ FLASH interrupt
lypinator 0:bb348c97df44 269 * This parameter can be any combination of the following values:
lypinator 0:bb348c97df44 270 * @arg FLASH_IT_EOP: End of FLASH Operation Interrupt
lypinator 0:bb348c97df44 271 * @arg FLASH_IT_ERR: Error Interrupt
lypinator 0:bb348c97df44 272 * @retval none
lypinator 0:bb348c97df44 273 */
lypinator 0:bb348c97df44 274 #define __HAL_FLASH_DISABLE_IT(__INTERRUPT__) (FLASH->CR &= ~(uint32_t)(__INTERRUPT__))
lypinator 0:bb348c97df44 275
lypinator 0:bb348c97df44 276 /**
lypinator 0:bb348c97df44 277 * @brief Get the specified FLASH flag status.
lypinator 0:bb348c97df44 278 * @param __FLAG__ specifies the FLASH flags to check.
lypinator 0:bb348c97df44 279 * This parameter can be any combination of the following values:
lypinator 0:bb348c97df44 280 * @arg FLASH_FLAG_EOP : FLASH End of Operation flag
lypinator 0:bb348c97df44 281 * @arg FLASH_FLAG_OPERR : FLASH operation Error flag
lypinator 0:bb348c97df44 282 * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag
lypinator 0:bb348c97df44 283 * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag
lypinator 0:bb348c97df44 284 * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag
lypinator 0:bb348c97df44 285 * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag
lypinator 0:bb348c97df44 286 * @arg FLASH_FLAG_RDERR : FLASH Read Protection error flag (PCROP) (*)
lypinator 0:bb348c97df44 287 * @arg FLASH_FLAG_BSY : FLASH Busy flag
lypinator 0:bb348c97df44 288 * (*) FLASH_FLAG_RDERR is not available for STM32F405xx/407xx/415xx/417xx devices
lypinator 0:bb348c97df44 289 * @retval The new state of __FLAG__ (SET or RESET).
lypinator 0:bb348c97df44 290 */
lypinator 0:bb348c97df44 291 #define __HAL_FLASH_GET_FLAG(__FLAG__) ((FLASH->SR & (__FLAG__)))
lypinator 0:bb348c97df44 292
lypinator 0:bb348c97df44 293 /**
lypinator 0:bb348c97df44 294 * @brief Clear the specified FLASH flags.
lypinator 0:bb348c97df44 295 * @param __FLAG__ specifies the FLASH flags to clear.
lypinator 0:bb348c97df44 296 * This parameter can be any combination of the following values:
lypinator 0:bb348c97df44 297 * @arg FLASH_FLAG_EOP : FLASH End of Operation flag
lypinator 0:bb348c97df44 298 * @arg FLASH_FLAG_OPERR : FLASH operation Error flag
lypinator 0:bb348c97df44 299 * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag
lypinator 0:bb348c97df44 300 * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag
lypinator 0:bb348c97df44 301 * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag
lypinator 0:bb348c97df44 302 * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag
lypinator 0:bb348c97df44 303 * @arg FLASH_FLAG_RDERR : FLASH Read Protection error flag (PCROP) (*)
lypinator 0:bb348c97df44 304 * (*) FLASH_FLAG_RDERR is not available for STM32F405xx/407xx/415xx/417xx devices
lypinator 0:bb348c97df44 305 * @retval none
lypinator 0:bb348c97df44 306 */
lypinator 0:bb348c97df44 307 #define __HAL_FLASH_CLEAR_FLAG(__FLAG__) (FLASH->SR = (__FLAG__))
lypinator 0:bb348c97df44 308 /**
lypinator 0:bb348c97df44 309 * @}
lypinator 0:bb348c97df44 310 */
lypinator 0:bb348c97df44 311
lypinator 0:bb348c97df44 312 /* Include FLASH HAL Extension module */
lypinator 0:bb348c97df44 313 #include "stm32f4xx_hal_flash_ex.h"
lypinator 0:bb348c97df44 314 #include "stm32f4xx_hal_flash_ramfunc.h"
lypinator 0:bb348c97df44 315
lypinator 0:bb348c97df44 316 /* Exported functions --------------------------------------------------------*/
lypinator 0:bb348c97df44 317 /** @addtogroup FLASH_Exported_Functions
lypinator 0:bb348c97df44 318 * @{
lypinator 0:bb348c97df44 319 */
lypinator 0:bb348c97df44 320 /** @addtogroup FLASH_Exported_Functions_Group1
lypinator 0:bb348c97df44 321 * @{
lypinator 0:bb348c97df44 322 */
lypinator 0:bb348c97df44 323 /* Program operation functions ***********************************************/
lypinator 0:bb348c97df44 324 HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint64_t Data);
lypinator 0:bb348c97df44 325 HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint64_t Data);
lypinator 0:bb348c97df44 326 /* FLASH IRQ handler method */
lypinator 0:bb348c97df44 327 void HAL_FLASH_IRQHandler(void);
lypinator 0:bb348c97df44 328 /* Callbacks in non blocking modes */
lypinator 0:bb348c97df44 329 void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue);
lypinator 0:bb348c97df44 330 void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue);
lypinator 0:bb348c97df44 331 /**
lypinator 0:bb348c97df44 332 * @}
lypinator 0:bb348c97df44 333 */
lypinator 0:bb348c97df44 334
lypinator 0:bb348c97df44 335 /** @addtogroup FLASH_Exported_Functions_Group2
lypinator 0:bb348c97df44 336 * @{
lypinator 0:bb348c97df44 337 */
lypinator 0:bb348c97df44 338 /* Peripheral Control functions **********************************************/
lypinator 0:bb348c97df44 339 HAL_StatusTypeDef HAL_FLASH_Unlock(void);
lypinator 0:bb348c97df44 340 HAL_StatusTypeDef HAL_FLASH_Lock(void);
lypinator 0:bb348c97df44 341 HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void);
lypinator 0:bb348c97df44 342 HAL_StatusTypeDef HAL_FLASH_OB_Lock(void);
lypinator 0:bb348c97df44 343 /* Option bytes control */
lypinator 0:bb348c97df44 344 HAL_StatusTypeDef HAL_FLASH_OB_Launch(void);
lypinator 0:bb348c97df44 345 /**
lypinator 0:bb348c97df44 346 * @}
lypinator 0:bb348c97df44 347 */
lypinator 0:bb348c97df44 348
lypinator 0:bb348c97df44 349 /** @addtogroup FLASH_Exported_Functions_Group3
lypinator 0:bb348c97df44 350 * @{
lypinator 0:bb348c97df44 351 */
lypinator 0:bb348c97df44 352 /* Peripheral State functions ************************************************/
lypinator 0:bb348c97df44 353 uint32_t HAL_FLASH_GetError(void);
lypinator 0:bb348c97df44 354 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout);
lypinator 0:bb348c97df44 355 /**
lypinator 0:bb348c97df44 356 * @}
lypinator 0:bb348c97df44 357 */
lypinator 0:bb348c97df44 358
lypinator 0:bb348c97df44 359 /**
lypinator 0:bb348c97df44 360 * @}
lypinator 0:bb348c97df44 361 */
lypinator 0:bb348c97df44 362 /* Private types -------------------------------------------------------------*/
lypinator 0:bb348c97df44 363 /* Private variables ---------------------------------------------------------*/
lypinator 0:bb348c97df44 364 /** @defgroup FLASH_Private_Variables FLASH Private Variables
lypinator 0:bb348c97df44 365 * @{
lypinator 0:bb348c97df44 366 */
lypinator 0:bb348c97df44 367
lypinator 0:bb348c97df44 368 /**
lypinator 0:bb348c97df44 369 * @}
lypinator 0:bb348c97df44 370 */
lypinator 0:bb348c97df44 371 /* Private constants ---------------------------------------------------------*/
lypinator 0:bb348c97df44 372 /** @defgroup FLASH_Private_Constants FLASH Private Constants
lypinator 0:bb348c97df44 373 * @{
lypinator 0:bb348c97df44 374 */
lypinator 0:bb348c97df44 375
lypinator 0:bb348c97df44 376 /**
lypinator 0:bb348c97df44 377 * @brief ACR register byte 0 (Bits[7:0]) base address
lypinator 0:bb348c97df44 378 */
lypinator 0:bb348c97df44 379 #define ACR_BYTE0_ADDRESS 0x40023C00U
lypinator 0:bb348c97df44 380 /**
lypinator 0:bb348c97df44 381 * @brief OPTCR register byte 0 (Bits[7:0]) base address
lypinator 0:bb348c97df44 382 */
lypinator 0:bb348c97df44 383 #define OPTCR_BYTE0_ADDRESS 0x40023C14U
lypinator 0:bb348c97df44 384 /**
lypinator 0:bb348c97df44 385 * @brief OPTCR register byte 1 (Bits[15:8]) base address
lypinator 0:bb348c97df44 386 */
lypinator 0:bb348c97df44 387 #define OPTCR_BYTE1_ADDRESS 0x40023C15U
lypinator 0:bb348c97df44 388 /**
lypinator 0:bb348c97df44 389 * @brief OPTCR register byte 2 (Bits[23:16]) base address
lypinator 0:bb348c97df44 390 */
lypinator 0:bb348c97df44 391 #define OPTCR_BYTE2_ADDRESS 0x40023C16U
lypinator 0:bb348c97df44 392 /**
lypinator 0:bb348c97df44 393 * @brief OPTCR register byte 3 (Bits[31:24]) base address
lypinator 0:bb348c97df44 394 */
lypinator 0:bb348c97df44 395 #define OPTCR_BYTE3_ADDRESS 0x40023C17U
lypinator 0:bb348c97df44 396
lypinator 0:bb348c97df44 397 /**
lypinator 0:bb348c97df44 398 * @}
lypinator 0:bb348c97df44 399 */
lypinator 0:bb348c97df44 400
lypinator 0:bb348c97df44 401 /* Private macros ------------------------------------------------------------*/
lypinator 0:bb348c97df44 402 /** @defgroup FLASH_Private_Macros FLASH Private Macros
lypinator 0:bb348c97df44 403 * @{
lypinator 0:bb348c97df44 404 */
lypinator 0:bb348c97df44 405
lypinator 0:bb348c97df44 406 /** @defgroup FLASH_IS_FLASH_Definitions FLASH Private macros to check input parameters
lypinator 0:bb348c97df44 407 * @{
lypinator 0:bb348c97df44 408 */
lypinator 0:bb348c97df44 409 #define IS_FLASH_TYPEPROGRAM(VALUE)(((VALUE) == FLASH_TYPEPROGRAM_BYTE) || \
lypinator 0:bb348c97df44 410 ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD) || \
lypinator 0:bb348c97df44 411 ((VALUE) == FLASH_TYPEPROGRAM_WORD) || \
lypinator 0:bb348c97df44 412 ((VALUE) == FLASH_TYPEPROGRAM_DOUBLEWORD))
lypinator 0:bb348c97df44 413 /**
lypinator 0:bb348c97df44 414 * @}
lypinator 0:bb348c97df44 415 */
lypinator 0:bb348c97df44 416
lypinator 0:bb348c97df44 417 /**
lypinator 0:bb348c97df44 418 * @}
lypinator 0:bb348c97df44 419 */
lypinator 0:bb348c97df44 420
lypinator 0:bb348c97df44 421 /* Private functions ---------------------------------------------------------*/
lypinator 0:bb348c97df44 422 /** @defgroup FLASH_Private_Functions FLASH Private Functions
lypinator 0:bb348c97df44 423 * @{
lypinator 0:bb348c97df44 424 */
lypinator 0:bb348c97df44 425
lypinator 0:bb348c97df44 426 /**
lypinator 0:bb348c97df44 427 * @}
lypinator 0:bb348c97df44 428 */
lypinator 0:bb348c97df44 429
lypinator 0:bb348c97df44 430 /**
lypinator 0:bb348c97df44 431 * @}
lypinator 0:bb348c97df44 432 */
lypinator 0:bb348c97df44 433
lypinator 0:bb348c97df44 434 /**
lypinator 0:bb348c97df44 435 * @}
lypinator 0:bb348c97df44 436 */
lypinator 0:bb348c97df44 437
lypinator 0:bb348c97df44 438 #ifdef __cplusplus
lypinator 0:bb348c97df44 439 }
lypinator 0:bb348c97df44 440 #endif
lypinator 0:bb348c97df44 441
lypinator 0:bb348c97df44 442 #endif /* __STM32F4xx_HAL_FLASH_H */
lypinator 0:bb348c97df44 443
lypinator 0:bb348c97df44 444 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/