shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_L053R8/stm32l0xx_hal_flash.c@181:a4cbdfbbd2f4, 2014-05-07 (annotated)

Committer:
mbed_official
Date:
Wed May 07 13:15:08 2014 +0100
Revision:
181:a4cbdfbbd2f4
Synchronized with git revision 7751e759576c6fd68deccb81ea82bac19ed41745



Full URL: https://github.com/mbedmicro/mbed/commit/7751e759576c6fd68deccb81ea82bac19ed41745/

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 181:a4cbdfbbd2f4 1 /**
mbed_official 181:a4cbdfbbd2f4 2 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 3 * @file stm32l0xx_hal_flash.c
mbed_official 181:a4cbdfbbd2f4 4 * @author MCD Application Team
mbed_official 181:a4cbdfbbd2f4 5 * @version V1.0.0
mbed_official 181:a4cbdfbbd2f4 6 * @date 22-April-2014
mbed_official 181:a4cbdfbbd2f4 7 * @brief FLASH HAL module driver.
mbed_official 181:a4cbdfbbd2f4 8 * This file provides firmware functions to manage the following
mbed_official 181:a4cbdfbbd2f4 9 * functionalities of the internal FLASH memory:
mbed_official 181:a4cbdfbbd2f4 10 * + FLASH Interface configuration
mbed_official 181:a4cbdfbbd2f4 11 * + FLASH Memory Programming
mbed_official 181:a4cbdfbbd2f4 12 * + DATA EEPROM Programming
mbed_official 181:a4cbdfbbd2f4 13 * + Option Bytes Programming
mbed_official 181:a4cbdfbbd2f4 14 * + Interrupts and flags management
mbed_official 181:a4cbdfbbd2f4 15 *
mbed_official 181:a4cbdfbbd2f4 16 * @verbatim
mbed_official 181:a4cbdfbbd2f4 17
mbed_official 181:a4cbdfbbd2f4 18 ==============================================================================
mbed_official 181:a4cbdfbbd2f4 19 ##### FLASH peripheral features #####
mbed_official 181:a4cbdfbbd2f4 20 ==============================================================================
mbed_official 181:a4cbdfbbd2f4 21
mbed_official 181:a4cbdfbbd2f4 22 [..] The Flash memory interface manages CPU accesses to the Flash memory.
mbed_official 181:a4cbdfbbd2f4 23 It implements the erase and program Flash memory operations
mbed_official 181:a4cbdfbbd2f4 24 and the read and write protection mechanisms.
mbed_official 181:a4cbdfbbd2f4 25
mbed_official 181:a4cbdfbbd2f4 26 [..] The FLASH main features are:
mbed_official 181:a4cbdfbbd2f4 27 (+) Flash memory read operations
mbed_official 181:a4cbdfbbd2f4 28 (+) Flash memory program/erase operations
mbed_official 181:a4cbdfbbd2f4 29 (+) Read / write protections
mbed_official 181:a4cbdfbbd2f4 30 (+) Option Bytes programming
mbed_official 181:a4cbdfbbd2f4 31
mbed_official 181:a4cbdfbbd2f4 32 ##### How to use this driver #####
mbed_official 181:a4cbdfbbd2f4 33 ==============================================================================
mbed_official 181:a4cbdfbbd2f4 34 [..]
mbed_official 181:a4cbdfbbd2f4 35 This driver provides functions and macros to configure and program the FLASH
mbed_official 181:a4cbdfbbd2f4 36 memory of all STM32L0xx devices.
mbed_official 181:a4cbdfbbd2f4 37
mbed_official 181:a4cbdfbbd2f4 38 (#) FLASH Memory IO Programming functions:
mbed_official 181:a4cbdfbbd2f4 39 (++) Lock and Unlock the FLASH interface using HAL_FLASH_Unlock() and
mbed_official 181:a4cbdfbbd2f4 40 HAL_FLASH_Lock() functions
mbed_official 181:a4cbdfbbd2f4 41 (++) Program functions: byte, half word and word
mbed_official 181:a4cbdfbbd2f4 42 (++) There Two modes of programming :
mbed_official 181:a4cbdfbbd2f4 43 (+++) Polling mode using HAL_FLASH_Program() function
mbed_official 181:a4cbdfbbd2f4 44 (+++) Interrupt mode using HAL_FLASH_Program_IT() function
mbed_official 181:a4cbdfbbd2f4 45
mbed_official 181:a4cbdfbbd2f4 46 (#) Interrupts and flags management functions :
mbed_official 181:a4cbdfbbd2f4 47 (++) Handle FLASH interrupts by calling HAL_FLASH_IRQHandler()
mbed_official 181:a4cbdfbbd2f4 48 (++) Wait for last FLASH operation according to its status
mbed_official 181:a4cbdfbbd2f4 49 (++) Get error flag status by calling HAL_GetErrorCode()
mbed_official 181:a4cbdfbbd2f4 50
mbed_official 181:a4cbdfbbd2f4 51 [..]
mbed_official 181:a4cbdfbbd2f4 52 In addition to these functions, this driver includes a set of macros allowing
mbed_official 181:a4cbdfbbd2f4 53 to handle the following operations:
mbed_official 181:a4cbdfbbd2f4 54 (+) Set the latency
mbed_official 181:a4cbdfbbd2f4 55 (+) Enable/Disable the prefetch buffer
mbed_official 181:a4cbdfbbd2f4 56 (+) Enable/Disable the preread buffer
mbed_official 181:a4cbdfbbd2f4 57 (+) Enable/Disable the Flash power-down
mbed_official 181:a4cbdfbbd2f4 58 (+) Enable/Disable the FLASH interrupts
mbed_official 181:a4cbdfbbd2f4 59 (+) Monitor the FLASH flags status
mbed_official 181:a4cbdfbbd2f4 60
mbed_official 181:a4cbdfbbd2f4 61 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 62 ##### Programming operation functions #####
mbed_official 181:a4cbdfbbd2f4 63 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 64 [..]
mbed_official 181:a4cbdfbbd2f4 65 This subsection provides a set of functions allowing to manage the FLASH
mbed_official 181:a4cbdfbbd2f4 66 program operations.
mbed_official 181:a4cbdfbbd2f4 67
mbed_official 181:a4cbdfbbd2f4 68 [..] The FLASH Memory Programming functions, includes the following functions:
mbed_official 181:a4cbdfbbd2f4 69 (+) HAL_FLASH_Unlock(void);
mbed_official 181:a4cbdfbbd2f4 70 (+) HAL_FLASH_Lock(void);
mbed_official 181:a4cbdfbbd2f4 71 (+) HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
mbed_official 181:a4cbdfbbd2f4 72 (+) HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
mbed_official 181:a4cbdfbbd2f4 73
mbed_official 181:a4cbdfbbd2f4 74 [..] Any operation of erase or program should follow these steps:
mbed_official 181:a4cbdfbbd2f4 75 (#) Call the HAL_FLASH_Unlock() function to enable the flash control register and
mbed_official 181:a4cbdfbbd2f4 76 program memory access.
mbed_official 181:a4cbdfbbd2f4 77 (#) Call the desired function to erase page or program data.
mbed_official 181:a4cbdfbbd2f4 78 (#) Call the HAL_FLASH_Lock() to disable the flash program memory access
mbed_official 181:a4cbdfbbd2f4 79 (recommended to protect the FLASH memory against possible unwanted operation).
mbed_official 181:a4cbdfbbd2f4 80
mbed_official 181:a4cbdfbbd2f4 81 ==============================================================================
mbed_official 181:a4cbdfbbd2f4 82 ##### Option Bytes Programming functions #####
mbed_official 181:a4cbdfbbd2f4 83 ==============================================================================
mbed_official 181:a4cbdfbbd2f4 84
mbed_official 181:a4cbdfbbd2f4 85 [..] The FLASH_Option Bytes Programming_functions, includes the following functions:
mbed_official 181:a4cbdfbbd2f4 86 (+) HAL_FLASH_OB_Unlock(void);
mbed_official 181:a4cbdfbbd2f4 87 (+) HAL_FLASH_OB_Lock(void);
mbed_official 181:a4cbdfbbd2f4 88 (+) HAL_FLASH_OB_Launch(void);
mbed_official 181:a4cbdfbbd2f4 89 (+) HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit);
mbed_official 181:a4cbdfbbd2f4 90 (+) HAL_FLASHEx_OBGetConfig(FLASH_OBProgramInitTypeDef *pOBInit);
mbed_official 181:a4cbdfbbd2f4 91
mbed_official 181:a4cbdfbbd2f4 92 [..] Any operation of erase or program should follow these steps:
mbed_official 181:a4cbdfbbd2f4 93 (#) Call the HAL_FLASH_OB_Unlock() function to enable the Flash option control
mbed_official 181:a4cbdfbbd2f4 94 register access.
mbed_official 181:a4cbdfbbd2f4 95 (#) Call the following functions to program the desired option bytes.
mbed_official 181:a4cbdfbbd2f4 96 (++) HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit);
mbed_official 181:a4cbdfbbd2f4 97 (#) Once all needed option bytes to be programmed are correctly written, call the
mbed_official 181:a4cbdfbbd2f4 98 HAL_FLASH_OB_Launch(void) function to launch the Option Bytes programming process.
mbed_official 181:a4cbdfbbd2f4 99 (#) Call the HAL_FLASH_OB_Lock() to disable the Flash option control register access (recommended
mbed_official 181:a4cbdfbbd2f4 100 to protect the option Bytes against possible unwanted operations).
mbed_official 181:a4cbdfbbd2f4 101
mbed_official 181:a4cbdfbbd2f4 102 [..] Proprietary code Read Out Protection (PcROP):
mbed_official 181:a4cbdfbbd2f4 103 (#) The PcROP sector is selected by using the same option bytes as the Write
mbed_official 181:a4cbdfbbd2f4 104 protection (nWRPi bits). As a result, these 2 options are exclusive each other.
mbed_official 181:a4cbdfbbd2f4 105 (#) In order to activate the PcROP (change the function of the nWRPi option bits),
mbed_official 181:a4cbdfbbd2f4 106 the SPRMOD option bit must be activated.
mbed_official 181:a4cbdfbbd2f4 107 (#) The active value of nWRPi bits is inverted when PCROP mode is active, this
mbed_official 181:a4cbdfbbd2f4 108 means: if SPRMOD = 1 and nWRPi = 1 (default value), then the user page "i"
mbed_official 181:a4cbdfbbd2f4 109 is read/write protected.
mbed_official 181:a4cbdfbbd2f4 110 (#) To activate PCROP mode for Flash page(s), you need to follow the sequence below:
mbed_official 181:a4cbdfbbd2f4 111 (++) For page(s) within the first 64KB of the Flash, use this function
mbed_official 181:a4cbdfbbd2f4 112 HAL_FLASHEx_AdvOBProgram with PCROPState = PCROPSTATE_ENABLE.
mbed_official 181:a4cbdfbbd2f4 113
mbed_official 181:a4cbdfbbd2f4 114
mbed_official 181:a4cbdfbbd2f4 115 * @endverbatim
mbed_official 181:a4cbdfbbd2f4 116 *
mbed_official 181:a4cbdfbbd2f4 117 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 118 * @attention
mbed_official 181:a4cbdfbbd2f4 119 *
mbed_official 181:a4cbdfbbd2f4 120 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 181:a4cbdfbbd2f4 121 *
mbed_official 181:a4cbdfbbd2f4 122 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 181:a4cbdfbbd2f4 123 * are permitted provided that the following conditions are met:
mbed_official 181:a4cbdfbbd2f4 124 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 181:a4cbdfbbd2f4 125 * this list of conditions and the following disclaimer.
mbed_official 181:a4cbdfbbd2f4 126 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 181:a4cbdfbbd2f4 127 * this list of conditions and the following disclaimer in the documentation
mbed_official 181:a4cbdfbbd2f4 128 * and/or other materials provided with the distribution.
mbed_official 181:a4cbdfbbd2f4 129 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 181:a4cbdfbbd2f4 130 * may be used to endorse or promote products derived from this software
mbed_official 181:a4cbdfbbd2f4 131 * without specific prior written permission.
mbed_official 181:a4cbdfbbd2f4 132 *
mbed_official 181:a4cbdfbbd2f4 133 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 181:a4cbdfbbd2f4 134 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 181:a4cbdfbbd2f4 135 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 181:a4cbdfbbd2f4 136 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 181:a4cbdfbbd2f4 137 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 181:a4cbdfbbd2f4 138 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 181:a4cbdfbbd2f4 139 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 181:a4cbdfbbd2f4 140 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 181:a4cbdfbbd2f4 141 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 181:a4cbdfbbd2f4 142 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 181:a4cbdfbbd2f4 143 *
mbed_official 181:a4cbdfbbd2f4 144 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 145 */
mbed_official 181:a4cbdfbbd2f4 146
mbed_official 181:a4cbdfbbd2f4 147 /* Includes ------------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 148 #include "stm32l0xx_hal.h"
mbed_official 181:a4cbdfbbd2f4 149
mbed_official 181:a4cbdfbbd2f4 150 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 181:a4cbdfbbd2f4 151 * @{
mbed_official 181:a4cbdfbbd2f4 152 */
mbed_official 181:a4cbdfbbd2f4 153
mbed_official 181:a4cbdfbbd2f4 154 /** @defgroup FLASH
mbed_official 181:a4cbdfbbd2f4 155 * @brief FLASH driver modules
mbed_official 181:a4cbdfbbd2f4 156 * @{
mbed_official 181:a4cbdfbbd2f4 157 */
mbed_official 181:a4cbdfbbd2f4 158
mbed_official 181:a4cbdfbbd2f4 159 /* Private typedef -----------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 160 /* Private define ------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 161 #define HAL_FLASH_TIMEOUT_VALUE ((uint32_t)0xFFFF0)
mbed_official 181:a4cbdfbbd2f4 162
mbed_official 181:a4cbdfbbd2f4 163 /* FLASH Mask */
mbed_official 181:a4cbdfbbd2f4 164 #define WRP01_MASK ((uint32_t)0x0000FFFF)
mbed_official 181:a4cbdfbbd2f4 165 #define PAGESIZE ((uint32_t)0x00000080)
mbed_official 181:a4cbdfbbd2f4 166
mbed_official 181:a4cbdfbbd2f4 167 /* Private macro -------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 168 /*Variables used for Erase sectors under interruption*/
mbed_official 181:a4cbdfbbd2f4 169 FLASH_ProcessTypeDef pFlash;
mbed_official 181:a4cbdfbbd2f4 170
mbed_official 181:a4cbdfbbd2f4 171 /* Private function prototypes -----------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 172 static void FLASH_Program_Word(uint32_t Address, uint32_t Data);
mbed_official 181:a4cbdfbbd2f4 173 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout);
mbed_official 181:a4cbdfbbd2f4 174 static void FLASH_SetErrorCode(void);
mbed_official 181:a4cbdfbbd2f4 175 static HAL_StatusTypeDef DATA_EEPROM_Unlock(void);
mbed_official 181:a4cbdfbbd2f4 176
mbed_official 181:a4cbdfbbd2f4 177 /* Private functions ---------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 178
mbed_official 181:a4cbdfbbd2f4 179 /** @defgroup FLASH_Private_Functions
mbed_official 181:a4cbdfbbd2f4 180 * @{
mbed_official 181:a4cbdfbbd2f4 181 */
mbed_official 181:a4cbdfbbd2f4 182
mbed_official 181:a4cbdfbbd2f4 183 /** @defgroup FLASH_Group1 Programming operation functions
mbed_official 181:a4cbdfbbd2f4 184 * @brief Programming operation functions
mbed_official 181:a4cbdfbbd2f4 185 *
mbed_official 181:a4cbdfbbd2f4 186 @verbatim
mbed_official 181:a4cbdfbbd2f4 187 @endverbatim
mbed_official 181:a4cbdfbbd2f4 188 * @{
mbed_official 181:a4cbdfbbd2f4 189 */
mbed_official 181:a4cbdfbbd2f4 190 /**
mbed_official 181:a4cbdfbbd2f4 191 * @brief Program word at a specified address
mbed_official 181:a4cbdfbbd2f4 192 * @param TypeProgram: Indicate the way to program at a specified address.
mbed_official 181:a4cbdfbbd2f4 193 * This parameter can be a value of @ref FLASH_Type_Program
mbed_official 181:a4cbdfbbd2f4 194 * @param Address: specifies the address to be programmed.
mbed_official 181:a4cbdfbbd2f4 195 * @param Data: specifies the data to be programmed
mbed_official 181:a4cbdfbbd2f4 196 *
mbed_official 181:a4cbdfbbd2f4 197 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 198 */
mbed_official 181:a4cbdfbbd2f4 199 HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
mbed_official 181:a4cbdfbbd2f4 200 {
mbed_official 181:a4cbdfbbd2f4 201 HAL_StatusTypeDef status = HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 202
mbed_official 181:a4cbdfbbd2f4 203 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 204 __HAL_LOCK(&pFlash);
mbed_official 181:a4cbdfbbd2f4 205
mbed_official 181:a4cbdfbbd2f4 206 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 207 assert_param(IS_TYPEPROGRAM(TypeProgram));
mbed_official 181:a4cbdfbbd2f4 208
mbed_official 181:a4cbdfbbd2f4 209 /* Wait for last operation to be completed */
mbed_official 181:a4cbdfbbd2f4 210 status = FLASH_WaitForLastOperation((uint32_t)HAL_FLASH_TIMEOUT_VALUE);
mbed_official 181:a4cbdfbbd2f4 211
mbed_official 181:a4cbdfbbd2f4 212 if(status == HAL_OK)
mbed_official 181:a4cbdfbbd2f4 213 {
mbed_official 181:a4cbdfbbd2f4 214 if(TypeProgram == TYPEPROGRAM_WORD)
mbed_official 181:a4cbdfbbd2f4 215 {
mbed_official 181:a4cbdfbbd2f4 216 /*Program word (32-bit) at a specified address.*/
mbed_official 181:a4cbdfbbd2f4 217 FLASH_Program_Word(Address, (uint32_t) Data);
mbed_official 181:a4cbdfbbd2f4 218 }
mbed_official 181:a4cbdfbbd2f4 219 /* Wait for last operation to be completed */
mbed_official 181:a4cbdfbbd2f4 220 status = FLASH_WaitForLastOperation((uint32_t)HAL_FLASH_TIMEOUT_VALUE);
mbed_official 181:a4cbdfbbd2f4 221
mbed_official 181:a4cbdfbbd2f4 222 /* Reset PROG bit */
mbed_official 181:a4cbdfbbd2f4 223 FLASH->PECR &= ~FLASH_PECR_PROG;
mbed_official 181:a4cbdfbbd2f4 224 }
mbed_official 181:a4cbdfbbd2f4 225
mbed_official 181:a4cbdfbbd2f4 226 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 227 __HAL_UNLOCK(&pFlash);
mbed_official 181:a4cbdfbbd2f4 228
mbed_official 181:a4cbdfbbd2f4 229 return status;
mbed_official 181:a4cbdfbbd2f4 230 }
mbed_official 181:a4cbdfbbd2f4 231
mbed_official 181:a4cbdfbbd2f4 232 /**
mbed_official 181:a4cbdfbbd2f4 233 * @brief Program word at a specified address with interrupt enabled.
mbed_official 181:a4cbdfbbd2f4 234 * @param TypeProgram: Indicate the way to program at a specified address.
mbed_official 181:a4cbdfbbd2f4 235 * This parameter can be a value of @ref FLASH_Type_Program
mbed_official 181:a4cbdfbbd2f4 236 * @param Address: specifies the address to be programmed.
mbed_official 181:a4cbdfbbd2f4 237 * @param Data: specifies the data to be programmed
mbed_official 181:a4cbdfbbd2f4 238 *
mbed_official 181:a4cbdfbbd2f4 239 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 240 */
mbed_official 181:a4cbdfbbd2f4 241 HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
mbed_official 181:a4cbdfbbd2f4 242 {
mbed_official 181:a4cbdfbbd2f4 243 HAL_StatusTypeDef status = HAL_OK;
mbed_official 181:a4cbdfbbd2f4 244
mbed_official 181:a4cbdfbbd2f4 245 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 246 __HAL_LOCK(&pFlash);
mbed_official 181:a4cbdfbbd2f4 247
mbed_official 181:a4cbdfbbd2f4 248 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 249 assert_param(IS_TYPEPROGRAM(TypeProgram));
mbed_official 181:a4cbdfbbd2f4 250
mbed_official 181:a4cbdfbbd2f4 251 /* Enable End of FLASH Operation interrupt */
mbed_official 181:a4cbdfbbd2f4 252 __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP);
mbed_official 181:a4cbdfbbd2f4 253
mbed_official 181:a4cbdfbbd2f4 254 /* Enable Error source interrupt */
mbed_official 181:a4cbdfbbd2f4 255 __HAL_FLASH_ENABLE_IT(FLASH_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 256
mbed_official 181:a4cbdfbbd2f4 257 /* Clear pending flags (if any) */
mbed_official 181:a4cbdfbbd2f4 258 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP | FLASH_FLAG_ENDHV | FLASH_FLAG_WRPERR |\
mbed_official 181:a4cbdfbbd2f4 259 FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR| FLASH_FLAG_OPTVERR |\
mbed_official 181:a4cbdfbbd2f4 260 FLASH_FLAG_RDERR | FLASH_FLAG_NOTZEROERR);
mbed_official 181:a4cbdfbbd2f4 261
mbed_official 181:a4cbdfbbd2f4 262 pFlash.ProcedureOnGoing = FLASH_PROC_PROGRAM;
mbed_official 181:a4cbdfbbd2f4 263 pFlash.Address = Address;
mbed_official 181:a4cbdfbbd2f4 264
mbed_official 181:a4cbdfbbd2f4 265 if(TypeProgram == TYPEPROGRAM_WORD)
mbed_official 181:a4cbdfbbd2f4 266 {
mbed_official 181:a4cbdfbbd2f4 267 /*Program word (32-bit) at a specified address.*/
mbed_official 181:a4cbdfbbd2f4 268 FLASH_Program_Word(Address, (uint32_t) Data);
mbed_official 181:a4cbdfbbd2f4 269 }
mbed_official 181:a4cbdfbbd2f4 270
mbed_official 181:a4cbdfbbd2f4 271 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 272 __HAL_UNLOCK(&pFlash);
mbed_official 181:a4cbdfbbd2f4 273
mbed_official 181:a4cbdfbbd2f4 274 return status;
mbed_official 181:a4cbdfbbd2f4 275 }
mbed_official 181:a4cbdfbbd2f4 276
mbed_official 181:a4cbdfbbd2f4 277 /**
mbed_official 181:a4cbdfbbd2f4 278 * @brief This function handles FLASH interrupt request.
mbed_official 181:a4cbdfbbd2f4 279 * @param None
mbed_official 181:a4cbdfbbd2f4 280 * @retval None
mbed_official 181:a4cbdfbbd2f4 281 */
mbed_official 181:a4cbdfbbd2f4 282 void HAL_FLASH_IRQHandler(void)
mbed_official 181:a4cbdfbbd2f4 283 {
mbed_official 181:a4cbdfbbd2f4 284 uint32_t temp;
mbed_official 181:a4cbdfbbd2f4 285
mbed_official 181:a4cbdfbbd2f4 286 /* If the program operation is completed, disable the PROG Bit */
mbed_official 181:a4cbdfbbd2f4 287 FLASH->PECR &= (~FLASH_PECR_PROG);
mbed_official 181:a4cbdfbbd2f4 288
mbed_official 181:a4cbdfbbd2f4 289 /* If the erase operation is completed, disable the ERASE Bit */
mbed_official 181:a4cbdfbbd2f4 290 FLASH->PECR &= (~FLASH_PECR_ERASE);
mbed_official 181:a4cbdfbbd2f4 291
mbed_official 181:a4cbdfbbd2f4 292 /* Check FLASH End of Operation flag */
mbed_official 181:a4cbdfbbd2f4 293 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
mbed_official 181:a4cbdfbbd2f4 294 {
mbed_official 181:a4cbdfbbd2f4 295 if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
mbed_official 181:a4cbdfbbd2f4 296 {
mbed_official 181:a4cbdfbbd2f4 297 /*Nb of sector to erased can be decreased*/
mbed_official 181:a4cbdfbbd2f4 298 pFlash.NbPagesToErase--;
mbed_official 181:a4cbdfbbd2f4 299
mbed_official 181:a4cbdfbbd2f4 300 /* Check if there are still sectors to erase*/
mbed_official 181:a4cbdfbbd2f4 301 if(pFlash.NbPagesToErase != 0)
mbed_official 181:a4cbdfbbd2f4 302 {
mbed_official 181:a4cbdfbbd2f4 303 temp = pFlash.Page;
mbed_official 181:a4cbdfbbd2f4 304 /*Indicate user which sector has been erased*/
mbed_official 181:a4cbdfbbd2f4 305 HAL_FLASH_EndOfOperationCallback(temp);
mbed_official 181:a4cbdfbbd2f4 306
mbed_official 181:a4cbdfbbd2f4 307 /* Clear pending flags (if any) */
mbed_official 181:a4cbdfbbd2f4 308 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP | FLASH_FLAG_ENDHV | FLASH_FLAG_WRPERR |\
mbed_official 181:a4cbdfbbd2f4 309 FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR| FLASH_FLAG_OPTVERR |\
mbed_official 181:a4cbdfbbd2f4 310 FLASH_FLAG_RDERR | FLASH_FLAG_NOTZEROERR);
mbed_official 181:a4cbdfbbd2f4 311
mbed_official 181:a4cbdfbbd2f4 312 /*Increment sector number*/
mbed_official 181:a4cbdfbbd2f4 313 temp = pFlash.Page + PAGESIZE;
mbed_official 181:a4cbdfbbd2f4 314 pFlash.Page = pFlash.Page + PAGESIZE;
mbed_official 181:a4cbdfbbd2f4 315 FLASH_Erase_Page(temp);
mbed_official 181:a4cbdfbbd2f4 316 }
mbed_official 181:a4cbdfbbd2f4 317 else
mbed_official 181:a4cbdfbbd2f4 318 {
mbed_official 181:a4cbdfbbd2f4 319 /*No more sectors to Erase, user callback can be called.*/
mbed_official 181:a4cbdfbbd2f4 320 /*Reset Sector and stop Erase sectors procedure*/
mbed_official 181:a4cbdfbbd2f4 321 pFlash.Page = temp = 0xFFFFFFFF;
mbed_official 181:a4cbdfbbd2f4 322 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
mbed_official 181:a4cbdfbbd2f4 323 /* FLASH EOP interrupt user callback */
mbed_official 181:a4cbdfbbd2f4 324 HAL_FLASH_EndOfOperationCallback(temp);
mbed_official 181:a4cbdfbbd2f4 325 /* Clear FLASH End of Operation pending bit */
mbed_official 181:a4cbdfbbd2f4 326 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
mbed_official 181:a4cbdfbbd2f4 327 }
mbed_official 181:a4cbdfbbd2f4 328 }
mbed_official 181:a4cbdfbbd2f4 329 else
mbed_official 181:a4cbdfbbd2f4 330 {
mbed_official 181:a4cbdfbbd2f4 331 if(pFlash.ProcedureOnGoing == FLASH_PROC_PROGRAM)
mbed_official 181:a4cbdfbbd2f4 332 {
mbed_official 181:a4cbdfbbd2f4 333 /*Program ended. Return the selected address*/
mbed_official 181:a4cbdfbbd2f4 334 /* FLASH EOP interrupt user callback */
mbed_official 181:a4cbdfbbd2f4 335 HAL_FLASH_EndOfOperationCallback(pFlash.Address);
mbed_official 181:a4cbdfbbd2f4 336 }
mbed_official 181:a4cbdfbbd2f4 337 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
mbed_official 181:a4cbdfbbd2f4 338 /* Clear FLASH End of Operation pending bit */
mbed_official 181:a4cbdfbbd2f4 339 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
mbed_official 181:a4cbdfbbd2f4 340 }
mbed_official 181:a4cbdfbbd2f4 341
mbed_official 181:a4cbdfbbd2f4 342 }
mbed_official 181:a4cbdfbbd2f4 343 /* Check FLASH operation error flags */
mbed_official 181:a4cbdfbbd2f4 344 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_EOP | FLASH_FLAG_ENDHV | FLASH_FLAG_WRPERR |\
mbed_official 181:a4cbdfbbd2f4 345 FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR| FLASH_FLAG_OPTVERR |\
mbed_official 181:a4cbdfbbd2f4 346 FLASH_FLAG_RDERR | FLASH_FLAG_NOTZEROERR)))
mbed_official 181:a4cbdfbbd2f4 347 {
mbed_official 181:a4cbdfbbd2f4 348 if(pFlash.ProcedureOnGoing == FLASH_PROC_PAGEERASE)
mbed_official 181:a4cbdfbbd2f4 349 {
mbed_official 181:a4cbdfbbd2f4 350 /*return the faulty sector*/
mbed_official 181:a4cbdfbbd2f4 351 temp = pFlash.Page;
mbed_official 181:a4cbdfbbd2f4 352 pFlash.Page = 0xFFFFFFFF;
mbed_official 181:a4cbdfbbd2f4 353 }
mbed_official 181:a4cbdfbbd2f4 354 else
mbed_official 181:a4cbdfbbd2f4 355 {
mbed_official 181:a4cbdfbbd2f4 356 /*retrun the faulty address*/
mbed_official 181:a4cbdfbbd2f4 357 temp = pFlash.Address;
mbed_official 181:a4cbdfbbd2f4 358 }
mbed_official 181:a4cbdfbbd2f4 359
mbed_official 181:a4cbdfbbd2f4 360 /*Save the Error code*/
mbed_official 181:a4cbdfbbd2f4 361 FLASH_SetErrorCode();
mbed_official 181:a4cbdfbbd2f4 362
mbed_official 181:a4cbdfbbd2f4 363 /* FLASH error interrupt user callback */
mbed_official 181:a4cbdfbbd2f4 364 HAL_FLASH_OperationErrorCallback(temp);
mbed_official 181:a4cbdfbbd2f4 365 /* Clear FLASH error pending bits */
mbed_official 181:a4cbdfbbd2f4 366 __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP | FLASH_FLAG_ENDHV | FLASH_FLAG_WRPERR |\
mbed_official 181:a4cbdfbbd2f4 367 FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR| FLASH_FLAG_OPTVERR |\
mbed_official 181:a4cbdfbbd2f4 368 FLASH_FLAG_RDERR | FLASH_FLAG_NOTZEROERR);
mbed_official 181:a4cbdfbbd2f4 369
mbed_official 181:a4cbdfbbd2f4 370 /*Stop the procedure ongoing*/
mbed_official 181:a4cbdfbbd2f4 371 pFlash.ProcedureOnGoing = FLASH_PROC_NONE;
mbed_official 181:a4cbdfbbd2f4 372 }
mbed_official 181:a4cbdfbbd2f4 373
mbed_official 181:a4cbdfbbd2f4 374 if(pFlash.ProcedureOnGoing == FLASH_PROC_NONE)
mbed_official 181:a4cbdfbbd2f4 375 {
mbed_official 181:a4cbdfbbd2f4 376 /* Disable End of FLASH Operation interrupt */
mbed_official 181:a4cbdfbbd2f4 377 __HAL_FLASH_DISABLE_IT(FLASH_IT_EOP);
mbed_official 181:a4cbdfbbd2f4 378
mbed_official 181:a4cbdfbbd2f4 379 /* Disable Error source interrupt */
mbed_official 181:a4cbdfbbd2f4 380 __HAL_FLASH_DISABLE_IT(FLASH_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 381
mbed_official 181:a4cbdfbbd2f4 382 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 383 __HAL_UNLOCK(&pFlash);
mbed_official 181:a4cbdfbbd2f4 384 }
mbed_official 181:a4cbdfbbd2f4 385
mbed_official 181:a4cbdfbbd2f4 386 }
mbed_official 181:a4cbdfbbd2f4 387
mbed_official 181:a4cbdfbbd2f4 388 /**
mbed_official 181:a4cbdfbbd2f4 389 * @brief FLASH end of operation interrupt callback
mbed_official 181:a4cbdfbbd2f4 390 * @param ReturnValue: The value saved in this parameter depends on the ongoing procedure
mbed_official 181:a4cbdfbbd2f4 391 * - Pages Erase: Sector which has been erased
mbed_official 181:a4cbdfbbd2f4 392 * (if 0xFFFFFFFF, it means that all the selected sectors have been erased)
mbed_official 181:a4cbdfbbd2f4 393 * - Program: Address which was selected for data program
mbed_official 181:a4cbdfbbd2f4 394 * @retval none
mbed_official 181:a4cbdfbbd2f4 395 */
mbed_official 181:a4cbdfbbd2f4 396 __weak void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue)
mbed_official 181:a4cbdfbbd2f4 397 {
mbed_official 181:a4cbdfbbd2f4 398 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 399 the HAL_FLASH_EndOfOperationCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 400 */
mbed_official 181:a4cbdfbbd2f4 401 }
mbed_official 181:a4cbdfbbd2f4 402
mbed_official 181:a4cbdfbbd2f4 403 /**
mbed_official 181:a4cbdfbbd2f4 404 * @brief FLASH operation error interrupt callback
mbed_official 181:a4cbdfbbd2f4 405 * @param ReturnValue: The value saved in this parameter depends on the ongoing procedure
mbed_official 181:a4cbdfbbd2f4 406 * - Pagess Erase: Sector number which returned an error
mbed_official 181:a4cbdfbbd2f4 407 * - Program: Address which was selected for data program
mbed_official 181:a4cbdfbbd2f4 408 * @retval none
mbed_official 181:a4cbdfbbd2f4 409 */
mbed_official 181:a4cbdfbbd2f4 410 __weak void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue)
mbed_official 181:a4cbdfbbd2f4 411 {
mbed_official 181:a4cbdfbbd2f4 412 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 413 the HAL_FLASH_OperationErrorCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 414 */
mbed_official 181:a4cbdfbbd2f4 415 }
mbed_official 181:a4cbdfbbd2f4 416
mbed_official 181:a4cbdfbbd2f4 417 /**
mbed_official 181:a4cbdfbbd2f4 418 * @}
mbed_official 181:a4cbdfbbd2f4 419 */
mbed_official 181:a4cbdfbbd2f4 420
mbed_official 181:a4cbdfbbd2f4 421 /** @defgroup FLASH_Group2 Peripheral Control functions
mbed_official 181:a4cbdfbbd2f4 422 * @brief management functions
mbed_official 181:a4cbdfbbd2f4 423 *
mbed_official 181:a4cbdfbbd2f4 424 @verbatim
mbed_official 181:a4cbdfbbd2f4 425 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 426 ##### Peripheral Control functions #####
mbed_official 181:a4cbdfbbd2f4 427 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 428 [..]
mbed_official 181:a4cbdfbbd2f4 429 This subsection provides a set of functions allowing to control the FLASH
mbed_official 181:a4cbdfbbd2f4 430 memory operations.
mbed_official 181:a4cbdfbbd2f4 431
mbed_official 181:a4cbdfbbd2f4 432 @endverbatim
mbed_official 181:a4cbdfbbd2f4 433 * @{
mbed_official 181:a4cbdfbbd2f4 434 */
mbed_official 181:a4cbdfbbd2f4 435 /**
mbed_official 181:a4cbdfbbd2f4 436 * @brief Unlock the FLASH control register access
mbed_official 181:a4cbdfbbd2f4 437 * @param None
mbed_official 181:a4cbdfbbd2f4 438 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 439 */
mbed_official 181:a4cbdfbbd2f4 440 HAL_StatusTypeDef HAL_FLASH_Unlock(void)
mbed_official 181:a4cbdfbbd2f4 441 {
mbed_official 181:a4cbdfbbd2f4 442 if((FLASH->PECR & FLASH_PECR_PRGLOCK) != RESET)
mbed_official 181:a4cbdfbbd2f4 443 {
mbed_official 181:a4cbdfbbd2f4 444 /* Unlocking the data memory and FLASH_PECR register access */
mbed_official 181:a4cbdfbbd2f4 445 DATA_EEPROM_Unlock();
mbed_official 181:a4cbdfbbd2f4 446
mbed_official 181:a4cbdfbbd2f4 447 /* Unlocking the program memory access */
mbed_official 181:a4cbdfbbd2f4 448 FLASH->PRGKEYR = FLASH_PRGKEY1;
mbed_official 181:a4cbdfbbd2f4 449 FLASH->PRGKEYR = FLASH_PRGKEY2;
mbed_official 181:a4cbdfbbd2f4 450 }
mbed_official 181:a4cbdfbbd2f4 451 else
mbed_official 181:a4cbdfbbd2f4 452 {
mbed_official 181:a4cbdfbbd2f4 453 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 454 }
mbed_official 181:a4cbdfbbd2f4 455
mbed_official 181:a4cbdfbbd2f4 456 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 457 }
mbed_official 181:a4cbdfbbd2f4 458
mbed_official 181:a4cbdfbbd2f4 459 /**
mbed_official 181:a4cbdfbbd2f4 460 * @brief Locks the FLASH control register access
mbed_official 181:a4cbdfbbd2f4 461 * @param None
mbed_official 181:a4cbdfbbd2f4 462 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 463 */
mbed_official 181:a4cbdfbbd2f4 464 HAL_StatusTypeDef HAL_FLASH_Lock(void)
mbed_official 181:a4cbdfbbd2f4 465 {
mbed_official 181:a4cbdfbbd2f4 466 /* Set the PRGLOCK Bit to lock the program memory access */
mbed_official 181:a4cbdfbbd2f4 467 FLASH->PECR |= FLASH_PECR_PRGLOCK;
mbed_official 181:a4cbdfbbd2f4 468
mbed_official 181:a4cbdfbbd2f4 469 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 470 }
mbed_official 181:a4cbdfbbd2f4 471
mbed_official 181:a4cbdfbbd2f4 472 /**
mbed_official 181:a4cbdfbbd2f4 473 * @brief Unlock the FLASH Option Control Registers access.
mbed_official 181:a4cbdfbbd2f4 474 * @param None
mbed_official 181:a4cbdfbbd2f4 475 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 476 */
mbed_official 181:a4cbdfbbd2f4 477 HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void)
mbed_official 181:a4cbdfbbd2f4 478 {
mbed_official 181:a4cbdfbbd2f4 479 if((FLASH->PECR & FLASH_PECR_OPTLOCK) != RESET)
mbed_official 181:a4cbdfbbd2f4 480 {
mbed_official 181:a4cbdfbbd2f4 481 /* Unlocking the data memory and FLASH_PECR register access */
mbed_official 181:a4cbdfbbd2f4 482 DATA_EEPROM_Unlock();
mbed_official 181:a4cbdfbbd2f4 483
mbed_official 181:a4cbdfbbd2f4 484 /* Unlocking the option bytes block access */
mbed_official 181:a4cbdfbbd2f4 485 FLASH->OPTKEYR = FLASH_OPTKEY1;
mbed_official 181:a4cbdfbbd2f4 486 FLASH->OPTKEYR = FLASH_OPTKEY2;
mbed_official 181:a4cbdfbbd2f4 487 }
mbed_official 181:a4cbdfbbd2f4 488 else
mbed_official 181:a4cbdfbbd2f4 489 {
mbed_official 181:a4cbdfbbd2f4 490 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 491 }
mbed_official 181:a4cbdfbbd2f4 492
mbed_official 181:a4cbdfbbd2f4 493 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 494 }
mbed_official 181:a4cbdfbbd2f4 495
mbed_official 181:a4cbdfbbd2f4 496 /**
mbed_official 181:a4cbdfbbd2f4 497 * @brief Lock the FLASH Option Control Registers access.
mbed_official 181:a4cbdfbbd2f4 498 * @param None
mbed_official 181:a4cbdfbbd2f4 499 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 500 */
mbed_official 181:a4cbdfbbd2f4 501 HAL_StatusTypeDef HAL_FLASH_OB_Lock(void)
mbed_official 181:a4cbdfbbd2f4 502 {
mbed_official 181:a4cbdfbbd2f4 503 /* Set the OPTLOCK Bit to lock the option bytes block access */
mbed_official 181:a4cbdfbbd2f4 504 FLASH->PECR |= FLASH_PECR_OPTLOCK;
mbed_official 181:a4cbdfbbd2f4 505
mbed_official 181:a4cbdfbbd2f4 506 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 507 }
mbed_official 181:a4cbdfbbd2f4 508
mbed_official 181:a4cbdfbbd2f4 509 /**
mbed_official 181:a4cbdfbbd2f4 510 * @brief Launch the option byte loading.
mbed_official 181:a4cbdfbbd2f4 511 * @param None
mbed_official 181:a4cbdfbbd2f4 512 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 513 */
mbed_official 181:a4cbdfbbd2f4 514 HAL_StatusTypeDef HAL_FLASH_OB_Launch(void)
mbed_official 181:a4cbdfbbd2f4 515 {
mbed_official 181:a4cbdfbbd2f4 516 /* Set the OBL_Launch bit to lauch the option byte loading */
mbed_official 181:a4cbdfbbd2f4 517 FLASH->PECR |= FLASH_PECR_OBL_LAUNCH;
mbed_official 181:a4cbdfbbd2f4 518
mbed_official 181:a4cbdfbbd2f4 519 /* Wait for last operation to be completed */
mbed_official 181:a4cbdfbbd2f4 520 return(FLASH_WaitForLastOperation((uint32_t)HAL_FLASH_TIMEOUT_VALUE));
mbed_official 181:a4cbdfbbd2f4 521 }
mbed_official 181:a4cbdfbbd2f4 522
mbed_official 181:a4cbdfbbd2f4 523 /**
mbed_official 181:a4cbdfbbd2f4 524 * @brief Unlocks the data memory and FLASH_PECR register access.
mbed_official 181:a4cbdfbbd2f4 525 * @param None
mbed_official 181:a4cbdfbbd2f4 526 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 527 */
mbed_official 181:a4cbdfbbd2f4 528 static HAL_StatusTypeDef DATA_EEPROM_Unlock(void)
mbed_official 181:a4cbdfbbd2f4 529 {
mbed_official 181:a4cbdfbbd2f4 530 if((FLASH->PECR & FLASH_PECR_PELOCK) != RESET)
mbed_official 181:a4cbdfbbd2f4 531 {
mbed_official 181:a4cbdfbbd2f4 532 /* Unlocking the Data memory and FLASH_PECR register access*/
mbed_official 181:a4cbdfbbd2f4 533 FLASH->PEKEYR = FLASH_PEKEY1;
mbed_official 181:a4cbdfbbd2f4 534 FLASH->PEKEYR = FLASH_PEKEY2;
mbed_official 181:a4cbdfbbd2f4 535 }
mbed_official 181:a4cbdfbbd2f4 536 else
mbed_official 181:a4cbdfbbd2f4 537 {
mbed_official 181:a4cbdfbbd2f4 538 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 539 }
mbed_official 181:a4cbdfbbd2f4 540 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 541 }
mbed_official 181:a4cbdfbbd2f4 542
mbed_official 181:a4cbdfbbd2f4 543 /**
mbed_official 181:a4cbdfbbd2f4 544 * @}
mbed_official 181:a4cbdfbbd2f4 545 */
mbed_official 181:a4cbdfbbd2f4 546
mbed_official 181:a4cbdfbbd2f4 547 /** @defgroup FLASH_Group3 Peripheral State and Errors functions
mbed_official 181:a4cbdfbbd2f4 548 * @brief Peripheral Errors functions
mbed_official 181:a4cbdfbbd2f4 549 *
mbed_official 181:a4cbdfbbd2f4 550 @verbatim
mbed_official 181:a4cbdfbbd2f4 551 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 552 ##### Peripheral Errors functions #####
mbed_official 181:a4cbdfbbd2f4 553 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 554 [..]
mbed_official 181:a4cbdfbbd2f4 555 This subsection permit to get in run-time Errors of the FLASH peripheral.
mbed_official 181:a4cbdfbbd2f4 556
mbed_official 181:a4cbdfbbd2f4 557 @endverbatim
mbed_official 181:a4cbdfbbd2f4 558 * @{
mbed_official 181:a4cbdfbbd2f4 559 */
mbed_official 181:a4cbdfbbd2f4 560
mbed_official 181:a4cbdfbbd2f4 561 /**
mbed_official 181:a4cbdfbbd2f4 562 * @brief Get the specific FLASH error flag.
mbed_official 181:a4cbdfbbd2f4 563 * @param None
mbed_official 181:a4cbdfbbd2f4 564 * @retval FLASH_ErrorCode: The returned value can be:
mbed_official 181:a4cbdfbbd2f4 565 * @arg FLASH_ERROR_RD: FLASH Read Protection error flag (PCROP)
mbed_official 181:a4cbdfbbd2f4 566 * @arg FLASH_ERROR_ENDHV: FLASH Programming Sequence error flag
mbed_official 181:a4cbdfbbd2f4 567 * @arg FLASH_ERROR_SIZE: FLASH Programming Parallelism error flag
mbed_official 181:a4cbdfbbd2f4 568 * @arg FLASH_ERROR_PGA: FLASH Programming Alignment error flag
mbed_official 181:a4cbdfbbd2f4 569 * @arg FLASH_ERROR_WRP: FLASH Write protected error flag
mbed_official 181:a4cbdfbbd2f4 570 * @arg FLASH_ERROR_OPTV: FLASH Option valid error flag
mbed_official 181:a4cbdfbbd2f4 571 * @arg FLASH_ERROR_NOTZERO: FLASH write operation is done in a not-erased region
mbed_official 181:a4cbdfbbd2f4 572 */
mbed_official 181:a4cbdfbbd2f4 573 FLASH_ErrorTypeDef HAL_FLASH_GetError(void)
mbed_official 181:a4cbdfbbd2f4 574 {
mbed_official 181:a4cbdfbbd2f4 575 return pFlash.ErrorCode;
mbed_official 181:a4cbdfbbd2f4 576 }
mbed_official 181:a4cbdfbbd2f4 577
mbed_official 181:a4cbdfbbd2f4 578 /**
mbed_official 181:a4cbdfbbd2f4 579 * @brief Wait for a FLASH operation to complete.
mbed_official 181:a4cbdfbbd2f4 580 * @param Timeout: maximum flash operationtimeout
mbed_official 181:a4cbdfbbd2f4 581 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 582 */
mbed_official 181:a4cbdfbbd2f4 583 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout)
mbed_official 181:a4cbdfbbd2f4 584 {
mbed_official 181:a4cbdfbbd2f4 585 uint32_t tickstart = 0;
mbed_official 181:a4cbdfbbd2f4 586
mbed_official 181:a4cbdfbbd2f4 587 /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
mbed_official 181:a4cbdfbbd2f4 588 Even if the FLASH operation fails, the BUSY flag will be reset and an error
mbed_official 181:a4cbdfbbd2f4 589 flag will be set */
mbed_official 181:a4cbdfbbd2f4 590
mbed_official 181:a4cbdfbbd2f4 591 tickstart = HAL_GetTick();
mbed_official 181:a4cbdfbbd2f4 592
mbed_official 181:a4cbdfbbd2f4 593 while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY))
mbed_official 181:a4cbdfbbd2f4 594 {
mbed_official 181:a4cbdfbbd2f4 595 if(Timeout != HAL_MAX_DELAY)
mbed_official 181:a4cbdfbbd2f4 596 {
mbed_official 181:a4cbdfbbd2f4 597 if((HAL_GetTick() - tickstart ) > Timeout)
mbed_official 181:a4cbdfbbd2f4 598 {
mbed_official 181:a4cbdfbbd2f4 599 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 600 }
mbed_official 181:a4cbdfbbd2f4 601 }
mbed_official 181:a4cbdfbbd2f4 602 }
mbed_official 181:a4cbdfbbd2f4 603
mbed_official 181:a4cbdfbbd2f4 604 if(__HAL_FLASH_GET_FLAG((FLASH_FLAG_WRPERR | FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR | FLASH_FLAG_OPTVERR |\
mbed_official 181:a4cbdfbbd2f4 605 FLASH_FLAG_RDERR | FLASH_FLAG_NOTZEROERR)))
mbed_official 181:a4cbdfbbd2f4 606 {
mbed_official 181:a4cbdfbbd2f4 607 /*Save the error code*/
mbed_official 181:a4cbdfbbd2f4 608 FLASH_SetErrorCode();
mbed_official 181:a4cbdfbbd2f4 609 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 610 }
mbed_official 181:a4cbdfbbd2f4 611
mbed_official 181:a4cbdfbbd2f4 612 /* If there is an error flag set */
mbed_official 181:a4cbdfbbd2f4 613 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 614 }
mbed_official 181:a4cbdfbbd2f4 615
mbed_official 181:a4cbdfbbd2f4 616 /**
mbed_official 181:a4cbdfbbd2f4 617 * @brief Set the specific FLASH error flag.
mbed_official 181:a4cbdfbbd2f4 618 * @param None
mbed_official 181:a4cbdfbbd2f4 619 * @retval None
mbed_official 181:a4cbdfbbd2f4 620 */
mbed_official 181:a4cbdfbbd2f4 621 static void FLASH_SetErrorCode(void)
mbed_official 181:a4cbdfbbd2f4 622 {
mbed_official 181:a4cbdfbbd2f4 623 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_ENDHV))
mbed_official 181:a4cbdfbbd2f4 624 {
mbed_official 181:a4cbdfbbd2f4 625 pFlash.ErrorCode = FLASH_ERROR_ENDHV;
mbed_official 181:a4cbdfbbd2f4 626 }
mbed_official 181:a4cbdfbbd2f4 627 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR))
mbed_official 181:a4cbdfbbd2f4 628 {
mbed_official 181:a4cbdfbbd2f4 629 pFlash.ErrorCode = FLASH_ERROR_WRP;
mbed_official 181:a4cbdfbbd2f4 630 }
mbed_official 181:a4cbdfbbd2f4 631 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGAERR))
mbed_official 181:a4cbdfbbd2f4 632 {
mbed_official 181:a4cbdfbbd2f4 633 pFlash.ErrorCode = FLASH_ERROR_PGA;
mbed_official 181:a4cbdfbbd2f4 634 }
mbed_official 181:a4cbdfbbd2f4 635 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_SIZERR))
mbed_official 181:a4cbdfbbd2f4 636 {
mbed_official 181:a4cbdfbbd2f4 637 pFlash.ErrorCode = FLASH_ERROR_SIZE;
mbed_official 181:a4cbdfbbd2f4 638 }
mbed_official 181:a4cbdfbbd2f4 639 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_OPTVERR))
mbed_official 181:a4cbdfbbd2f4 640 {
mbed_official 181:a4cbdfbbd2f4 641 pFlash.ErrorCode = FLASH_ERROR_OPTV;
mbed_official 181:a4cbdfbbd2f4 642 }
mbed_official 181:a4cbdfbbd2f4 643 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_RDERR))
mbed_official 181:a4cbdfbbd2f4 644 {
mbed_official 181:a4cbdfbbd2f4 645 pFlash.ErrorCode = FLASH_ERROR_RD;
mbed_official 181:a4cbdfbbd2f4 646 }
mbed_official 181:a4cbdfbbd2f4 647 if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_NOTZEROERR))
mbed_official 181:a4cbdfbbd2f4 648 {
mbed_official 181:a4cbdfbbd2f4 649 pFlash.ErrorCode = FLASH_ERROR_NOTZERO;
mbed_official 181:a4cbdfbbd2f4 650 }
mbed_official 181:a4cbdfbbd2f4 651 }
mbed_official 181:a4cbdfbbd2f4 652
mbed_official 181:a4cbdfbbd2f4 653 /**
mbed_official 181:a4cbdfbbd2f4 654 * @brief Erases a specified page in program memory.
mbed_official 181:a4cbdfbbd2f4 655 * @note To correctly run this function, the HAL_FLASH_Unlock() function
mbed_official 181:a4cbdfbbd2f4 656 * must be called before.
mbed_official 181:a4cbdfbbd2f4 657 * Call the HAL_FLASH_Lock() to disable the flash memory access
mbed_official 181:a4cbdfbbd2f4 658 * (recommended to protect the FLASH memory against possible unwanted operation)
mbed_official 181:a4cbdfbbd2f4 659 * @param Page_Address: The page address in program memory to be erased.
mbed_official 181:a4cbdfbbd2f4 660 * @note A Page is erased in the Program memory only if the address to load
mbed_official 181:a4cbdfbbd2f4 661 * is the start address of a page (multiple of 256 bytes).
mbed_official 181:a4cbdfbbd2f4 662 * @retval HAL_StatusTypeDef HAL Status
mbed_official 181:a4cbdfbbd2f4 663 */
mbed_official 181:a4cbdfbbd2f4 664 void FLASH_Erase_Page(uint32_t Page_Address)
mbed_official 181:a4cbdfbbd2f4 665 {
mbed_official 181:a4cbdfbbd2f4 666 /* Set the ERASE bit */
mbed_official 181:a4cbdfbbd2f4 667 FLASH->PECR |= FLASH_PECR_ERASE;
mbed_official 181:a4cbdfbbd2f4 668
mbed_official 181:a4cbdfbbd2f4 669 /* Set PROG bit */
mbed_official 181:a4cbdfbbd2f4 670 FLASH->PECR |= FLASH_PECR_PROG;
mbed_official 181:a4cbdfbbd2f4 671
mbed_official 181:a4cbdfbbd2f4 672 /* Write 00000000h to the first word of the program page to erase */
mbed_official 181:a4cbdfbbd2f4 673 *(__IO uint32_t *)Page_Address = 0x00000000;
mbed_official 181:a4cbdfbbd2f4 674 }
mbed_official 181:a4cbdfbbd2f4 675
mbed_official 181:a4cbdfbbd2f4 676 /**
mbed_official 181:a4cbdfbbd2f4 677 * @}
mbed_official 181:a4cbdfbbd2f4 678 */
mbed_official 181:a4cbdfbbd2f4 679
mbed_official 181:a4cbdfbbd2f4 680 /**
mbed_official 181:a4cbdfbbd2f4 681 * @}
mbed_official 181:a4cbdfbbd2f4 682 */
mbed_official 181:a4cbdfbbd2f4 683 /**
mbed_official 181:a4cbdfbbd2f4 684 * @brief Program word (32-bit) at a specified address.
mbed_official 181:a4cbdfbbd2f4 685 * @param Address: specifies the address to be programmed.
mbed_official 181:a4cbdfbbd2f4 686 * @param Data: specifies the data to be programmed.
mbed_official 181:a4cbdfbbd2f4 687 * @retval None
mbed_official 181:a4cbdfbbd2f4 688 */
mbed_official 181:a4cbdfbbd2f4 689 static void FLASH_Program_Word(uint32_t Address, uint32_t Data)
mbed_official 181:a4cbdfbbd2f4 690 {
mbed_official 181:a4cbdfbbd2f4 691 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 692 assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));
mbed_official 181:a4cbdfbbd2f4 693
mbed_official 181:a4cbdfbbd2f4 694 /* Set PROG bit */
mbed_official 181:a4cbdfbbd2f4 695 FLASH->PECR |= FLASH_PECR_PROG;
mbed_official 181:a4cbdfbbd2f4 696
mbed_official 181:a4cbdfbbd2f4 697 *(__IO uint32_t*)Address = Data;
mbed_official 181:a4cbdfbbd2f4 698 }
mbed_official 181:a4cbdfbbd2f4 699
mbed_official 181:a4cbdfbbd2f4 700 /**
mbed_official 181:a4cbdfbbd2f4 701 * @}
mbed_official 181:a4cbdfbbd2f4 702 */
mbed_official 181:a4cbdfbbd2f4 703
mbed_official 181:a4cbdfbbd2f4 704 /**
mbed_official 181:a4cbdfbbd2f4 705 * @}
mbed_official 181:a4cbdfbbd2f4 706 */
mbed_official 181:a4cbdfbbd2f4 707
mbed_official 181:a4cbdfbbd2f4 708
mbed_official 181:a4cbdfbbd2f4 709
mbed_official 181:a4cbdfbbd2f4 710 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/