mbed official / mbed

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:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

TARGET_NUCLEO_F446RE/stm32f4xx_hal_flash.h@122:f9eeca106725, 2016-07-07 (annotated)

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
110:165afa46840b 
Release 122 of the mbed library



Changes:

- new targets - Nucleo L432KC, Beetle, Nucleo F446ZE, Nucleo L011K4

- Thread safety addition - mbed API should contain a statement about thread safety

- critical section API addition

- CAS API (core_util_atomic_incr/decr)

- DEVICE_ are generated from targets.json file, device.h deprecated

- Callback replaces FunctionPointer to provide std like interface

- mbed HAL API docs improvements

- toolchain - prexif attributes with MBED_

            - add new attributes - packed, weak, forcedinline, align

- target.json - contains targets definitions

- ST - L1XX - Cube update to 1.5

     - SPI clock selection fix (clock from APB domain)

     - F7 - Cube update v1.4.0

     - L0 -  baudrate init fix

     - L1 - Cube update v1.5

     - F3 - baudrate init fix, 3 targets CAN support

     - F4 - Cube update v1.12.0, 3 targets CAN support

     - L4XX - Cube update v1.5.1

     - F0 - update Cube to v1.5.0

     - L4 - 2 targets (L476RG/VG) CAN support

- NXP - pwm clock fix for KSDK2 MCU

      - LPC2368 - remove ARM toolchain support - due to regression

      - KSDK2 - fix SPI , I2C address and repeat start

- Silabs - some fixes backported from mbed 3

- Renesas - RZ_A1H - SystemCoreClockUpdate addition

Who changed what in which revision?

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