Frederick Huang / mbed-STM32L452

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   STM32L452_Nucleo_ticker

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32F4/device/stm32f4xx_hal_flash.h@167:e84263d55307, 2017-06-21 (annotated)

Committer:
AnnaBridge
Date:
Wed Jun 21 17:46:44 2017 +0100
Revision:
167:e84263d55307
Parent:
149:156823d33999 
This updates the lib to the mbed lib v 145

Who changed what in which revision?

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