mbed library sources
Dependents: frdm_kl05z_gpio_test
Fork of mbed-src by
targets/cmsis/TARGET_STM/TARGET_DISCO_F051R8/stm32f0xx_flash.c@130:1dec54e4aec3, 2014-03-21 (annotated)
- Committer:
- mbed_official
- Date:
- Fri Mar 21 11:45:09 2014 +0000
- Revision:
- 130:1dec54e4aec3
Synchronized with git revision e5c9ff6781a4e277a5a454e5a0b037f76e31739d
Full URL: https://github.com/mbedmicro/mbed/commit/e5c9ff6781a4e277a5a454e5a0b037f76e31739d/
STM32F0-Discovery (STM32F051R8) initial port
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
mbed_official | 130:1dec54e4aec3 | 1 | /** |
mbed_official | 130:1dec54e4aec3 | 2 | ****************************************************************************** |
mbed_official | 130:1dec54e4aec3 | 3 | * @file stm32f0xx_flash.c |
mbed_official | 130:1dec54e4aec3 | 4 | * @author MCD Application Team |
mbed_official | 130:1dec54e4aec3 | 5 | * @version V1.3.0 |
mbed_official | 130:1dec54e4aec3 | 6 | * @date 16-January-2014 |
mbed_official | 130:1dec54e4aec3 | 7 | * @brief This file provides firmware functions to manage the following |
mbed_official | 130:1dec54e4aec3 | 8 | * functionalities of the FLASH peripheral: |
mbed_official | 130:1dec54e4aec3 | 9 | * - FLASH Interface configuration |
mbed_official | 130:1dec54e4aec3 | 10 | * - FLASH Memory Programming |
mbed_official | 130:1dec54e4aec3 | 11 | * - Option Bytes Programming |
mbed_official | 130:1dec54e4aec3 | 12 | * - Interrupts and flags management |
mbed_official | 130:1dec54e4aec3 | 13 | * |
mbed_official | 130:1dec54e4aec3 | 14 | * @verbatim |
mbed_official | 130:1dec54e4aec3 | 15 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 16 | ##### How to use this driver ##### |
mbed_official | 130:1dec54e4aec3 | 17 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 18 | [..] This driver provides functions to configure and program the Flash |
mbed_official | 130:1dec54e4aec3 | 19 | memory of all STM32F0xx devices. These functions are split in 4 groups |
mbed_official | 130:1dec54e4aec3 | 20 | (#) FLASH Interface configuration functions: this group includes the |
mbed_official | 130:1dec54e4aec3 | 21 | management of following features: |
mbed_official | 130:1dec54e4aec3 | 22 | (++) Set the latency |
mbed_official | 130:1dec54e4aec3 | 23 | (++) Enable/Disable the prefetch buffer |
mbed_official | 130:1dec54e4aec3 | 24 | |
mbed_official | 130:1dec54e4aec3 | 25 | (#) FLASH Memory Programming functions: this group includes all needed |
mbed_official | 130:1dec54e4aec3 | 26 | functions to erase and program the main memory: |
mbed_official | 130:1dec54e4aec3 | 27 | (++) Lock and Unlock the Flash interface. |
mbed_official | 130:1dec54e4aec3 | 28 | (++) Erase function: Erase Page, erase all pages. |
mbed_official | 130:1dec54e4aec3 | 29 | (++) Program functions: Half Word and Word write. |
mbed_official | 130:1dec54e4aec3 | 30 | |
mbed_official | 130:1dec54e4aec3 | 31 | (#) FLASH Option Bytes Programming functions: this group includes all |
mbed_official | 130:1dec54e4aec3 | 32 | needed functions to: |
mbed_official | 130:1dec54e4aec3 | 33 | (++) Lock and Unlock the Flash Option bytes. |
mbed_official | 130:1dec54e4aec3 | 34 | (++) Launch the Option Bytes loader |
mbed_official | 130:1dec54e4aec3 | 35 | (++) Erase the Option Bytes |
mbed_official | 130:1dec54e4aec3 | 36 | (++)Set/Reset the write protection |
mbed_official | 130:1dec54e4aec3 | 37 | (++) Set the Read protection Level |
mbed_official | 130:1dec54e4aec3 | 38 | (++) Program the user option Bytes |
mbed_official | 130:1dec54e4aec3 | 39 | (++) Set/Reset the BOOT1 bit |
mbed_official | 130:1dec54e4aec3 | 40 | (++) Enable/Disable the VDDA Analog Monitoring |
mbed_official | 130:1dec54e4aec3 | 41 | (++) Get the user option bytes |
mbed_official | 130:1dec54e4aec3 | 42 | (++) Get the Write protection |
mbed_official | 130:1dec54e4aec3 | 43 | (++) Get the read protection status |
mbed_official | 130:1dec54e4aec3 | 44 | |
mbed_official | 130:1dec54e4aec3 | 45 | (#) FLASH Interrupts and flag management functions: this group includes |
mbed_official | 130:1dec54e4aec3 | 46 | all needed functions to: |
mbed_official | 130:1dec54e4aec3 | 47 | (++) Enable/Disable the flash interrupt sources |
mbed_official | 130:1dec54e4aec3 | 48 | (++) Get flags status |
mbed_official | 130:1dec54e4aec3 | 49 | (++) Clear flags |
mbed_official | 130:1dec54e4aec3 | 50 | (++) Get Flash operation status |
mbed_official | 130:1dec54e4aec3 | 51 | (++) Wait for last flash operation |
mbed_official | 130:1dec54e4aec3 | 52 | |
mbed_official | 130:1dec54e4aec3 | 53 | @endverbatim |
mbed_official | 130:1dec54e4aec3 | 54 | |
mbed_official | 130:1dec54e4aec3 | 55 | ****************************************************************************** |
mbed_official | 130:1dec54e4aec3 | 56 | * @attention |
mbed_official | 130:1dec54e4aec3 | 57 | * |
mbed_official | 130:1dec54e4aec3 | 58 | * <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2> |
mbed_official | 130:1dec54e4aec3 | 59 | * |
mbed_official | 130:1dec54e4aec3 | 60 | * Redistribution and use in source and binary forms, with or without modification, |
mbed_official | 130:1dec54e4aec3 | 61 | * are permitted provided that the following conditions are met: |
mbed_official | 130:1dec54e4aec3 | 62 | * 1. Redistributions of source code must retain the above copyright notice, |
mbed_official | 130:1dec54e4aec3 | 63 | * this list of conditions and the following disclaimer. |
mbed_official | 130:1dec54e4aec3 | 64 | * 2. Redistributions in binary form must reproduce the above copyright notice, |
mbed_official | 130:1dec54e4aec3 | 65 | * this list of conditions and the following disclaimer in the documentation |
mbed_official | 130:1dec54e4aec3 | 66 | * and/or other materials provided with the distribution. |
mbed_official | 130:1dec54e4aec3 | 67 | * 3. Neither the name of STMicroelectronics nor the names of its contributors |
mbed_official | 130:1dec54e4aec3 | 68 | * may be used to endorse or promote products derived from this software |
mbed_official | 130:1dec54e4aec3 | 69 | * without specific prior written permission. |
mbed_official | 130:1dec54e4aec3 | 70 | * |
mbed_official | 130:1dec54e4aec3 | 71 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
mbed_official | 130:1dec54e4aec3 | 72 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
mbed_official | 130:1dec54e4aec3 | 73 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
mbed_official | 130:1dec54e4aec3 | 74 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
mbed_official | 130:1dec54e4aec3 | 75 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
mbed_official | 130:1dec54e4aec3 | 76 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
mbed_official | 130:1dec54e4aec3 | 77 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
mbed_official | 130:1dec54e4aec3 | 78 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
mbed_official | 130:1dec54e4aec3 | 79 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
mbed_official | 130:1dec54e4aec3 | 80 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
mbed_official | 130:1dec54e4aec3 | 81 | * |
mbed_official | 130:1dec54e4aec3 | 82 | ****************************************************************************** |
mbed_official | 130:1dec54e4aec3 | 83 | */ |
mbed_official | 130:1dec54e4aec3 | 84 | |
mbed_official | 130:1dec54e4aec3 | 85 | /* Includes ------------------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 86 | #include "stm32f0xx_flash.h" |
mbed_official | 130:1dec54e4aec3 | 87 | |
mbed_official | 130:1dec54e4aec3 | 88 | /** @addtogroup STM32F0xx_StdPeriph_Driver |
mbed_official | 130:1dec54e4aec3 | 89 | * @{ |
mbed_official | 130:1dec54e4aec3 | 90 | */ |
mbed_official | 130:1dec54e4aec3 | 91 | |
mbed_official | 130:1dec54e4aec3 | 92 | /** @defgroup FLASH |
mbed_official | 130:1dec54e4aec3 | 93 | * @brief FLASH driver modules |
mbed_official | 130:1dec54e4aec3 | 94 | * @{ |
mbed_official | 130:1dec54e4aec3 | 95 | */ |
mbed_official | 130:1dec54e4aec3 | 96 | |
mbed_official | 130:1dec54e4aec3 | 97 | /* Private typedef -----------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 98 | /* Private define ------------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 99 | /* Private macro -------------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 100 | /* Private variables ---------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 101 | /* Private function prototypes -----------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 102 | /* Private functions ---------------------------------------------------------*/ |
mbed_official | 130:1dec54e4aec3 | 103 | |
mbed_official | 130:1dec54e4aec3 | 104 | /** @defgroup FLASH_Private_Functions |
mbed_official | 130:1dec54e4aec3 | 105 | * @{ |
mbed_official | 130:1dec54e4aec3 | 106 | */ |
mbed_official | 130:1dec54e4aec3 | 107 | |
mbed_official | 130:1dec54e4aec3 | 108 | /** @defgroup FLASH_Group1 FLASH Interface configuration functions |
mbed_official | 130:1dec54e4aec3 | 109 | * @brief FLASH Interface configuration functions |
mbed_official | 130:1dec54e4aec3 | 110 | * |
mbed_official | 130:1dec54e4aec3 | 111 | @verbatim |
mbed_official | 130:1dec54e4aec3 | 112 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 113 | ##### FLASH Interface configuration functions ##### |
mbed_official | 130:1dec54e4aec3 | 114 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 115 | |
mbed_official | 130:1dec54e4aec3 | 116 | [..] FLASH_Interface configuration_Functions, includes the following functions: |
mbed_official | 130:1dec54e4aec3 | 117 | (+) void FLASH_SetLatency(uint32_t FLASH_Latency): |
mbed_official | 130:1dec54e4aec3 | 118 | [..] To correctly read data from Flash memory, the number of wait states (LATENCY) |
mbed_official | 130:1dec54e4aec3 | 119 | must be correctly programmed according to the frequency of the CPU clock (HCLK) |
mbed_official | 130:1dec54e4aec3 | 120 | [..] |
mbed_official | 130:1dec54e4aec3 | 121 | +--------------------------------------------- + |
mbed_official | 130:1dec54e4aec3 | 122 | | Wait states | HCLK clock frequency (MHz) | |
mbed_official | 130:1dec54e4aec3 | 123 | |---------------|------------------------------| |
mbed_official | 130:1dec54e4aec3 | 124 | |0WS(1CPU cycle)| 0 < HCLK <= 24 | |
mbed_official | 130:1dec54e4aec3 | 125 | |---------------|------------------------------| |
mbed_official | 130:1dec54e4aec3 | 126 | |1WS(2CPU cycle)| 24 < HCLK <= 48 | |
mbed_official | 130:1dec54e4aec3 | 127 | +----------------------------------------------+ |
mbed_official | 130:1dec54e4aec3 | 128 | [..] |
mbed_official | 130:1dec54e4aec3 | 129 | (+) void FLASH_PrefetchBufferCmd(FunctionalState NewState); |
mbed_official | 130:1dec54e4aec3 | 130 | [..] |
mbed_official | 130:1dec54e4aec3 | 131 | All these functions don't need the unlock sequence. |
mbed_official | 130:1dec54e4aec3 | 132 | |
mbed_official | 130:1dec54e4aec3 | 133 | @endverbatim |
mbed_official | 130:1dec54e4aec3 | 134 | * @{ |
mbed_official | 130:1dec54e4aec3 | 135 | */ |
mbed_official | 130:1dec54e4aec3 | 136 | |
mbed_official | 130:1dec54e4aec3 | 137 | /** |
mbed_official | 130:1dec54e4aec3 | 138 | * @brief Sets the code latency value. |
mbed_official | 130:1dec54e4aec3 | 139 | * @param FLASH_Latency: specifies the FLASH Latency value. |
mbed_official | 130:1dec54e4aec3 | 140 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 141 | * @arg FLASH_Latency_0: FLASH Zero Latency cycle |
mbed_official | 130:1dec54e4aec3 | 142 | * @arg FLASH_Latency_1: FLASH One Latency cycle |
mbed_official | 130:1dec54e4aec3 | 143 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 144 | */ |
mbed_official | 130:1dec54e4aec3 | 145 | void FLASH_SetLatency(uint32_t FLASH_Latency) |
mbed_official | 130:1dec54e4aec3 | 146 | { |
mbed_official | 130:1dec54e4aec3 | 147 | uint32_t tmpreg = 0; |
mbed_official | 130:1dec54e4aec3 | 148 | |
mbed_official | 130:1dec54e4aec3 | 149 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 150 | assert_param(IS_FLASH_LATENCY(FLASH_Latency)); |
mbed_official | 130:1dec54e4aec3 | 151 | |
mbed_official | 130:1dec54e4aec3 | 152 | /* Read the ACR register */ |
mbed_official | 130:1dec54e4aec3 | 153 | tmpreg = FLASH->ACR; |
mbed_official | 130:1dec54e4aec3 | 154 | |
mbed_official | 130:1dec54e4aec3 | 155 | /* Sets the Latency value */ |
mbed_official | 130:1dec54e4aec3 | 156 | tmpreg &= (uint32_t) (~((uint32_t)FLASH_ACR_LATENCY)); |
mbed_official | 130:1dec54e4aec3 | 157 | tmpreg |= FLASH_Latency; |
mbed_official | 130:1dec54e4aec3 | 158 | |
mbed_official | 130:1dec54e4aec3 | 159 | /* Write the ACR register */ |
mbed_official | 130:1dec54e4aec3 | 160 | FLASH->ACR = tmpreg; |
mbed_official | 130:1dec54e4aec3 | 161 | } |
mbed_official | 130:1dec54e4aec3 | 162 | |
mbed_official | 130:1dec54e4aec3 | 163 | /** |
mbed_official | 130:1dec54e4aec3 | 164 | * @brief Enables or disables the Prefetch Buffer. |
mbed_official | 130:1dec54e4aec3 | 165 | * @param NewState: new state of the FLASH prefetch buffer. |
mbed_official | 130:1dec54e4aec3 | 166 | * This parameter can be: ENABLE or DISABLE. |
mbed_official | 130:1dec54e4aec3 | 167 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 168 | */ |
mbed_official | 130:1dec54e4aec3 | 169 | void FLASH_PrefetchBufferCmd(FunctionalState NewState) |
mbed_official | 130:1dec54e4aec3 | 170 | { |
mbed_official | 130:1dec54e4aec3 | 171 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 172 | assert_param(IS_FUNCTIONAL_STATE(NewState)); |
mbed_official | 130:1dec54e4aec3 | 173 | |
mbed_official | 130:1dec54e4aec3 | 174 | if(NewState != DISABLE) |
mbed_official | 130:1dec54e4aec3 | 175 | { |
mbed_official | 130:1dec54e4aec3 | 176 | FLASH->ACR |= FLASH_ACR_PRFTBE; |
mbed_official | 130:1dec54e4aec3 | 177 | } |
mbed_official | 130:1dec54e4aec3 | 178 | else |
mbed_official | 130:1dec54e4aec3 | 179 | { |
mbed_official | 130:1dec54e4aec3 | 180 | FLASH->ACR &= (uint32_t)(~((uint32_t)FLASH_ACR_PRFTBE)); |
mbed_official | 130:1dec54e4aec3 | 181 | } |
mbed_official | 130:1dec54e4aec3 | 182 | } |
mbed_official | 130:1dec54e4aec3 | 183 | |
mbed_official | 130:1dec54e4aec3 | 184 | /** |
mbed_official | 130:1dec54e4aec3 | 185 | * @brief Checks whether the FLASH Prefetch Buffer status is set or not. |
mbed_official | 130:1dec54e4aec3 | 186 | * @param None |
mbed_official | 130:1dec54e4aec3 | 187 | * @retval FLASH Prefetch Buffer Status (SET or RESET). |
mbed_official | 130:1dec54e4aec3 | 188 | */ |
mbed_official | 130:1dec54e4aec3 | 189 | FlagStatus FLASH_GetPrefetchBufferStatus(void) |
mbed_official | 130:1dec54e4aec3 | 190 | { |
mbed_official | 130:1dec54e4aec3 | 191 | FlagStatus bitstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 192 | |
mbed_official | 130:1dec54e4aec3 | 193 | if ((FLASH->ACR & FLASH_ACR_PRFTBS) != (uint32_t)RESET) |
mbed_official | 130:1dec54e4aec3 | 194 | { |
mbed_official | 130:1dec54e4aec3 | 195 | bitstatus = SET; |
mbed_official | 130:1dec54e4aec3 | 196 | } |
mbed_official | 130:1dec54e4aec3 | 197 | else |
mbed_official | 130:1dec54e4aec3 | 198 | { |
mbed_official | 130:1dec54e4aec3 | 199 | bitstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 200 | } |
mbed_official | 130:1dec54e4aec3 | 201 | /* Return the new state of FLASH Prefetch Buffer Status (SET or RESET) */ |
mbed_official | 130:1dec54e4aec3 | 202 | return bitstatus; |
mbed_official | 130:1dec54e4aec3 | 203 | } |
mbed_official | 130:1dec54e4aec3 | 204 | |
mbed_official | 130:1dec54e4aec3 | 205 | /** |
mbed_official | 130:1dec54e4aec3 | 206 | * @} |
mbed_official | 130:1dec54e4aec3 | 207 | */ |
mbed_official | 130:1dec54e4aec3 | 208 | |
mbed_official | 130:1dec54e4aec3 | 209 | /** @defgroup FLASH_Group2 FLASH Memory Programming functions |
mbed_official | 130:1dec54e4aec3 | 210 | * @brief FLASH Memory Programming functions |
mbed_official | 130:1dec54e4aec3 | 211 | * |
mbed_official | 130:1dec54e4aec3 | 212 | @verbatim |
mbed_official | 130:1dec54e4aec3 | 213 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 214 | ##### FLASH Memory Programming functions ##### |
mbed_official | 130:1dec54e4aec3 | 215 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 216 | |
mbed_official | 130:1dec54e4aec3 | 217 | [..] The FLASH Memory Programming functions, includes the following functions: |
mbed_official | 130:1dec54e4aec3 | 218 | (+) void FLASH_Unlock(void); |
mbed_official | 130:1dec54e4aec3 | 219 | (+) void FLASH_Lock(void); |
mbed_official | 130:1dec54e4aec3 | 220 | (+) FLASH_Status FLASH_ErasePage(uint32_t Page_Address); |
mbed_official | 130:1dec54e4aec3 | 221 | (+) FLASH_Status FLASH_EraseAllPages(void); |
mbed_official | 130:1dec54e4aec3 | 222 | (+) FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data); |
mbed_official | 130:1dec54e4aec3 | 223 | (+) FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data); |
mbed_official | 130:1dec54e4aec3 | 224 | |
mbed_official | 130:1dec54e4aec3 | 225 | [..] Any operation of erase or program should follow these steps: |
mbed_official | 130:1dec54e4aec3 | 226 | |
mbed_official | 130:1dec54e4aec3 | 227 | (#) Call the FLASH_Unlock() function to enable the flash control register and |
mbed_official | 130:1dec54e4aec3 | 228 | program memory access |
mbed_official | 130:1dec54e4aec3 | 229 | (#) Call the desired function to erase page or program data |
mbed_official | 130:1dec54e4aec3 | 230 | (#) Call the FLASH_Lock() to disable the flash program memory access |
mbed_official | 130:1dec54e4aec3 | 231 | (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 232 | |
mbed_official | 130:1dec54e4aec3 | 233 | @endverbatim |
mbed_official | 130:1dec54e4aec3 | 234 | * @{ |
mbed_official | 130:1dec54e4aec3 | 235 | */ |
mbed_official | 130:1dec54e4aec3 | 236 | |
mbed_official | 130:1dec54e4aec3 | 237 | /** |
mbed_official | 130:1dec54e4aec3 | 238 | * @brief Unlocks the FLASH control register and program memory access. |
mbed_official | 130:1dec54e4aec3 | 239 | * @param None |
mbed_official | 130:1dec54e4aec3 | 240 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 241 | */ |
mbed_official | 130:1dec54e4aec3 | 242 | void FLASH_Unlock(void) |
mbed_official | 130:1dec54e4aec3 | 243 | { |
mbed_official | 130:1dec54e4aec3 | 244 | if((FLASH->CR & FLASH_CR_LOCK) != RESET) |
mbed_official | 130:1dec54e4aec3 | 245 | { |
mbed_official | 130:1dec54e4aec3 | 246 | /* Unlocking the program memory access */ |
mbed_official | 130:1dec54e4aec3 | 247 | FLASH->KEYR = FLASH_FKEY1; |
mbed_official | 130:1dec54e4aec3 | 248 | FLASH->KEYR = FLASH_FKEY2; |
mbed_official | 130:1dec54e4aec3 | 249 | } |
mbed_official | 130:1dec54e4aec3 | 250 | } |
mbed_official | 130:1dec54e4aec3 | 251 | |
mbed_official | 130:1dec54e4aec3 | 252 | /** |
mbed_official | 130:1dec54e4aec3 | 253 | * @brief Locks the Program memory access. |
mbed_official | 130:1dec54e4aec3 | 254 | * @param None |
mbed_official | 130:1dec54e4aec3 | 255 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 256 | */ |
mbed_official | 130:1dec54e4aec3 | 257 | void FLASH_Lock(void) |
mbed_official | 130:1dec54e4aec3 | 258 | { |
mbed_official | 130:1dec54e4aec3 | 259 | /* Set the LOCK Bit to lock the FLASH control register and program memory access */ |
mbed_official | 130:1dec54e4aec3 | 260 | FLASH->CR |= FLASH_CR_LOCK; |
mbed_official | 130:1dec54e4aec3 | 261 | } |
mbed_official | 130:1dec54e4aec3 | 262 | |
mbed_official | 130:1dec54e4aec3 | 263 | /** |
mbed_official | 130:1dec54e4aec3 | 264 | * @brief Erases a specified page in program memory. |
mbed_official | 130:1dec54e4aec3 | 265 | * @note To correctly run this function, the FLASH_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 266 | * @note Call the FLASH_Lock() to disable the flash memory access (recommended |
mbed_official | 130:1dec54e4aec3 | 267 | * to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 268 | * @param Page_Address: The page address in program memory to be erased. |
mbed_official | 130:1dec54e4aec3 | 269 | * @note A Page is erased in the Program memory only if the address to load |
mbed_official | 130:1dec54e4aec3 | 270 | * is the start address of a page (multiple of 1024 bytes). |
mbed_official | 130:1dec54e4aec3 | 271 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 272 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 273 | */ |
mbed_official | 130:1dec54e4aec3 | 274 | FLASH_Status FLASH_ErasePage(uint32_t Page_Address) |
mbed_official | 130:1dec54e4aec3 | 275 | { |
mbed_official | 130:1dec54e4aec3 | 276 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 277 | |
mbed_official | 130:1dec54e4aec3 | 278 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 279 | assert_param(IS_FLASH_PROGRAM_ADDRESS(Page_Address)); |
mbed_official | 130:1dec54e4aec3 | 280 | |
mbed_official | 130:1dec54e4aec3 | 281 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 282 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 283 | |
mbed_official | 130:1dec54e4aec3 | 284 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 285 | { |
mbed_official | 130:1dec54e4aec3 | 286 | /* If the previous operation is completed, proceed to erase the page */ |
mbed_official | 130:1dec54e4aec3 | 287 | FLASH->CR |= FLASH_CR_PER; |
mbed_official | 130:1dec54e4aec3 | 288 | FLASH->AR = Page_Address; |
mbed_official | 130:1dec54e4aec3 | 289 | FLASH->CR |= FLASH_CR_STRT; |
mbed_official | 130:1dec54e4aec3 | 290 | |
mbed_official | 130:1dec54e4aec3 | 291 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 292 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 293 | |
mbed_official | 130:1dec54e4aec3 | 294 | /* Disable the PER Bit */ |
mbed_official | 130:1dec54e4aec3 | 295 | FLASH->CR &= ~FLASH_CR_PER; |
mbed_official | 130:1dec54e4aec3 | 296 | } |
mbed_official | 130:1dec54e4aec3 | 297 | |
mbed_official | 130:1dec54e4aec3 | 298 | /* Return the Erase Status */ |
mbed_official | 130:1dec54e4aec3 | 299 | return status; |
mbed_official | 130:1dec54e4aec3 | 300 | } |
mbed_official | 130:1dec54e4aec3 | 301 | |
mbed_official | 130:1dec54e4aec3 | 302 | /** |
mbed_official | 130:1dec54e4aec3 | 303 | * @brief Erases all FLASH pages. |
mbed_official | 130:1dec54e4aec3 | 304 | * @note To correctly run this function, the FLASH_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 305 | * @note Call the FLASH_Lock() to disable the flash memory access (recommended |
mbed_official | 130:1dec54e4aec3 | 306 | * to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 307 | * @param None |
mbed_official | 130:1dec54e4aec3 | 308 | * @retval FLASH Status: The returned value can be: FLASH_ERROR_PG, |
mbed_official | 130:1dec54e4aec3 | 309 | * FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 310 | */ |
mbed_official | 130:1dec54e4aec3 | 311 | FLASH_Status FLASH_EraseAllPages(void) |
mbed_official | 130:1dec54e4aec3 | 312 | { |
mbed_official | 130:1dec54e4aec3 | 313 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 314 | |
mbed_official | 130:1dec54e4aec3 | 315 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 316 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 317 | |
mbed_official | 130:1dec54e4aec3 | 318 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 319 | { |
mbed_official | 130:1dec54e4aec3 | 320 | /* if the previous operation is completed, proceed to erase all pages */ |
mbed_official | 130:1dec54e4aec3 | 321 | FLASH->CR |= FLASH_CR_MER; |
mbed_official | 130:1dec54e4aec3 | 322 | FLASH->CR |= FLASH_CR_STRT; |
mbed_official | 130:1dec54e4aec3 | 323 | |
mbed_official | 130:1dec54e4aec3 | 324 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 325 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 326 | |
mbed_official | 130:1dec54e4aec3 | 327 | /* Disable the MER Bit */ |
mbed_official | 130:1dec54e4aec3 | 328 | FLASH->CR &= ~FLASH_CR_MER; |
mbed_official | 130:1dec54e4aec3 | 329 | } |
mbed_official | 130:1dec54e4aec3 | 330 | |
mbed_official | 130:1dec54e4aec3 | 331 | /* Return the Erase Status */ |
mbed_official | 130:1dec54e4aec3 | 332 | return status; |
mbed_official | 130:1dec54e4aec3 | 333 | } |
mbed_official | 130:1dec54e4aec3 | 334 | |
mbed_official | 130:1dec54e4aec3 | 335 | /** |
mbed_official | 130:1dec54e4aec3 | 336 | * @brief Programs a word at a specified address. |
mbed_official | 130:1dec54e4aec3 | 337 | * @note To correctly run this function, the FLASH_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 338 | * @note Call the FLASH_Lock() to disable the flash memory access (recommended |
mbed_official | 130:1dec54e4aec3 | 339 | * to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 340 | * @param Address: specifies the address to be programmed. |
mbed_official | 130:1dec54e4aec3 | 341 | * @param Data: specifies the data to be programmed. |
mbed_official | 130:1dec54e4aec3 | 342 | * @retval FLASH Status: The returned value can be: FLASH_ERROR_PG, |
mbed_official | 130:1dec54e4aec3 | 343 | * FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 344 | */ |
mbed_official | 130:1dec54e4aec3 | 345 | FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) |
mbed_official | 130:1dec54e4aec3 | 346 | { |
mbed_official | 130:1dec54e4aec3 | 347 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 348 | __IO uint32_t tmp = 0; |
mbed_official | 130:1dec54e4aec3 | 349 | |
mbed_official | 130:1dec54e4aec3 | 350 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 351 | assert_param(IS_FLASH_PROGRAM_ADDRESS(Address)); |
mbed_official | 130:1dec54e4aec3 | 352 | |
mbed_official | 130:1dec54e4aec3 | 353 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 354 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 355 | |
mbed_official | 130:1dec54e4aec3 | 356 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 357 | { |
mbed_official | 130:1dec54e4aec3 | 358 | /* If the previous operation is completed, proceed to program the new first |
mbed_official | 130:1dec54e4aec3 | 359 | half word */ |
mbed_official | 130:1dec54e4aec3 | 360 | FLASH->CR |= FLASH_CR_PG; |
mbed_official | 130:1dec54e4aec3 | 361 | |
mbed_official | 130:1dec54e4aec3 | 362 | *(__IO uint16_t*)Address = (uint16_t)Data; |
mbed_official | 130:1dec54e4aec3 | 363 | |
mbed_official | 130:1dec54e4aec3 | 364 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 365 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 366 | |
mbed_official | 130:1dec54e4aec3 | 367 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 368 | { |
mbed_official | 130:1dec54e4aec3 | 369 | /* If the previous operation is completed, proceed to program the new second |
mbed_official | 130:1dec54e4aec3 | 370 | half word */ |
mbed_official | 130:1dec54e4aec3 | 371 | tmp = Address + 2; |
mbed_official | 130:1dec54e4aec3 | 372 | |
mbed_official | 130:1dec54e4aec3 | 373 | *(__IO uint16_t*) tmp = Data >> 16; |
mbed_official | 130:1dec54e4aec3 | 374 | |
mbed_official | 130:1dec54e4aec3 | 375 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 376 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 377 | |
mbed_official | 130:1dec54e4aec3 | 378 | /* Disable the PG Bit */ |
mbed_official | 130:1dec54e4aec3 | 379 | FLASH->CR &= ~FLASH_CR_PG; |
mbed_official | 130:1dec54e4aec3 | 380 | } |
mbed_official | 130:1dec54e4aec3 | 381 | else |
mbed_official | 130:1dec54e4aec3 | 382 | { |
mbed_official | 130:1dec54e4aec3 | 383 | /* Disable the PG Bit */ |
mbed_official | 130:1dec54e4aec3 | 384 | FLASH->CR &= ~FLASH_CR_PG; |
mbed_official | 130:1dec54e4aec3 | 385 | } |
mbed_official | 130:1dec54e4aec3 | 386 | } |
mbed_official | 130:1dec54e4aec3 | 387 | |
mbed_official | 130:1dec54e4aec3 | 388 | /* Return the Program Status */ |
mbed_official | 130:1dec54e4aec3 | 389 | return status; |
mbed_official | 130:1dec54e4aec3 | 390 | } |
mbed_official | 130:1dec54e4aec3 | 391 | |
mbed_official | 130:1dec54e4aec3 | 392 | /** |
mbed_official | 130:1dec54e4aec3 | 393 | * @brief Programs a half word at a specified address. |
mbed_official | 130:1dec54e4aec3 | 394 | * @note To correctly run this function, the FLASH_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 395 | * @note Call the FLASH_Lock() to disable the flash memory access (recommended |
mbed_official | 130:1dec54e4aec3 | 396 | * to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 397 | * @param Address: specifies the address to be programmed. |
mbed_official | 130:1dec54e4aec3 | 398 | * @param Data: specifies the data to be programmed. |
mbed_official | 130:1dec54e4aec3 | 399 | * @retval FLASH Status: The returned value can be: FLASH_ERROR_PG, |
mbed_official | 130:1dec54e4aec3 | 400 | * FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 401 | */ |
mbed_official | 130:1dec54e4aec3 | 402 | FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) |
mbed_official | 130:1dec54e4aec3 | 403 | { |
mbed_official | 130:1dec54e4aec3 | 404 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 405 | |
mbed_official | 130:1dec54e4aec3 | 406 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 407 | assert_param(IS_FLASH_PROGRAM_ADDRESS(Address)); |
mbed_official | 130:1dec54e4aec3 | 408 | |
mbed_official | 130:1dec54e4aec3 | 409 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 410 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 411 | |
mbed_official | 130:1dec54e4aec3 | 412 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 413 | { |
mbed_official | 130:1dec54e4aec3 | 414 | /* If the previous operation is completed, proceed to program the new data */ |
mbed_official | 130:1dec54e4aec3 | 415 | FLASH->CR |= FLASH_CR_PG; |
mbed_official | 130:1dec54e4aec3 | 416 | |
mbed_official | 130:1dec54e4aec3 | 417 | *(__IO uint16_t*)Address = Data; |
mbed_official | 130:1dec54e4aec3 | 418 | |
mbed_official | 130:1dec54e4aec3 | 419 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 420 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 421 | |
mbed_official | 130:1dec54e4aec3 | 422 | /* Disable the PG Bit */ |
mbed_official | 130:1dec54e4aec3 | 423 | FLASH->CR &= ~FLASH_CR_PG; |
mbed_official | 130:1dec54e4aec3 | 424 | } |
mbed_official | 130:1dec54e4aec3 | 425 | |
mbed_official | 130:1dec54e4aec3 | 426 | /* Return the Program Status */ |
mbed_official | 130:1dec54e4aec3 | 427 | return status; |
mbed_official | 130:1dec54e4aec3 | 428 | } |
mbed_official | 130:1dec54e4aec3 | 429 | |
mbed_official | 130:1dec54e4aec3 | 430 | /** |
mbed_official | 130:1dec54e4aec3 | 431 | * @} |
mbed_official | 130:1dec54e4aec3 | 432 | */ |
mbed_official | 130:1dec54e4aec3 | 433 | |
mbed_official | 130:1dec54e4aec3 | 434 | /** @defgroup FLASH_Group3 Option Bytes Programming functions |
mbed_official | 130:1dec54e4aec3 | 435 | * @brief Option Bytes Programming functions |
mbed_official | 130:1dec54e4aec3 | 436 | * |
mbed_official | 130:1dec54e4aec3 | 437 | @verbatim |
mbed_official | 130:1dec54e4aec3 | 438 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 439 | ##### Option Bytes Programming functions ##### |
mbed_official | 130:1dec54e4aec3 | 440 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 441 | |
mbed_official | 130:1dec54e4aec3 | 442 | [..] The FLASH_Option Bytes Programming_functions, includes the following functions: |
mbed_official | 130:1dec54e4aec3 | 443 | (+) void FLASH_OB_Unlock(void); |
mbed_official | 130:1dec54e4aec3 | 444 | (+) void FLASH_OB_Lock(void); |
mbed_official | 130:1dec54e4aec3 | 445 | (+) void FLASH_OB_Launch(void); |
mbed_official | 130:1dec54e4aec3 | 446 | (+) FLASH_Status FLASH_OB_Erase(void); |
mbed_official | 130:1dec54e4aec3 | 447 | (+) FLASH_Status FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState); |
mbed_official | 130:1dec54e4aec3 | 448 | (+) FLASH_Status FLASH_OB_RDPConfig(uint8_t OB_RDP); |
mbed_official | 130:1dec54e4aec3 | 449 | (+) FLASH_Status FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY); |
mbed_official | 130:1dec54e4aec3 | 450 | (+) FLASH_Status FLASH_OB_BOOTConfig(uint8_t OB_BOOT1); |
mbed_official | 130:1dec54e4aec3 | 451 | (+) FLASH_Status FLASH_OB_VDDAConfig(uint8_t OB_VDDA_ANALOG); |
mbed_official | 130:1dec54e4aec3 | 452 | (+) FLASH_Status FLASH_OB_WriteUser(uint8_t OB_USER); |
mbed_official | 130:1dec54e4aec3 | 453 | (+) FLASH_OB_ProgramData(uint32_t Address, uint8_t Data); |
mbed_official | 130:1dec54e4aec3 | 454 | (+) uint8_t FLASH_OB_GetUser(void); |
mbed_official | 130:1dec54e4aec3 | 455 | (+) uint32_t FLASH_OB_GetWRP(void); |
mbed_official | 130:1dec54e4aec3 | 456 | (+) FlagStatus FLASH_OB_GetRDP(void); |
mbed_official | 130:1dec54e4aec3 | 457 | |
mbed_official | 130:1dec54e4aec3 | 458 | [..] Any operation of erase or program should follow these steps: |
mbed_official | 130:1dec54e4aec3 | 459 | |
mbed_official | 130:1dec54e4aec3 | 460 | (#) Call the FLASH_OB_Unlock() function to enable the Option Bytes registers access |
mbed_official | 130:1dec54e4aec3 | 461 | |
mbed_official | 130:1dec54e4aec3 | 462 | (#) Call one or several functions to program the desired option bytes |
mbed_official | 130:1dec54e4aec3 | 463 | (++) FLASH_Status FLASH_OB_RDPConfig(uint8_t OB_RDP) => to set the desired read Protection Level |
mbed_official | 130:1dec54e4aec3 | 464 | (++) FLASH_Status FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState) |
mbed_official | 130:1dec54e4aec3 | 465 | => to Enable/Disable the desired sector write protection |
mbed_official | 130:1dec54e4aec3 | 466 | (++) FLASH_Status FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY) |
mbed_official | 130:1dec54e4aec3 | 467 | => to configure the user option Bytes: IWDG, STOP and the Standby. |
mbed_official | 130:1dec54e4aec3 | 468 | (++) FLASH_Status FLASH_OB_BOOTConfig(uint8_t OB_BOOT1) |
mbed_official | 130:1dec54e4aec3 | 469 | => to set or reset BOOT1 |
mbed_official | 130:1dec54e4aec3 | 470 | (++) FLASH_Status FLASH_OB_VDDAConfig(uint8_t OB_VDDA_ANALOG) |
mbed_official | 130:1dec54e4aec3 | 471 | => to enable or disable the VDDA Analog Monitoring |
mbed_official | 130:1dec54e4aec3 | 472 | (++) You can write all User Options bytes at once using a single function |
mbed_official | 130:1dec54e4aec3 | 473 | by calling FLASH_Status FLASH_OB_WriteUser(uint8_t OB_USER) |
mbed_official | 130:1dec54e4aec3 | 474 | (++) FLASH_OB_ProgramData(uint32_t Address, uint8_t Data) to program the |
mbed_official | 130:1dec54e4aec3 | 475 | two half word in the option bytes |
mbed_official | 130:1dec54e4aec3 | 476 | |
mbed_official | 130:1dec54e4aec3 | 477 | (#) Once all needed option bytes to be programmed are correctly written, call the |
mbed_official | 130:1dec54e4aec3 | 478 | FLASH_OB_Launch(void) function to launch the Option Bytes programming process. |
mbed_official | 130:1dec54e4aec3 | 479 | |
mbed_official | 130:1dec54e4aec3 | 480 | (#) Call the FLASH_OB_Lock() to disable the Option Bytes registers access (recommended |
mbed_official | 130:1dec54e4aec3 | 481 | to protect the option Bytes against possible unwanted operations) |
mbed_official | 130:1dec54e4aec3 | 482 | |
mbed_official | 130:1dec54e4aec3 | 483 | @endverbatim |
mbed_official | 130:1dec54e4aec3 | 484 | * @{ |
mbed_official | 130:1dec54e4aec3 | 485 | */ |
mbed_official | 130:1dec54e4aec3 | 486 | |
mbed_official | 130:1dec54e4aec3 | 487 | /** |
mbed_official | 130:1dec54e4aec3 | 488 | * @brief Unlocks the option bytes block access. |
mbed_official | 130:1dec54e4aec3 | 489 | * @param None |
mbed_official | 130:1dec54e4aec3 | 490 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 491 | */ |
mbed_official | 130:1dec54e4aec3 | 492 | void FLASH_OB_Unlock(void) |
mbed_official | 130:1dec54e4aec3 | 493 | { |
mbed_official | 130:1dec54e4aec3 | 494 | if((FLASH->CR & FLASH_CR_OPTWRE) == RESET) |
mbed_official | 130:1dec54e4aec3 | 495 | { |
mbed_official | 130:1dec54e4aec3 | 496 | /* Unlocking the option bytes block access */ |
mbed_official | 130:1dec54e4aec3 | 497 | FLASH->OPTKEYR = FLASH_OPTKEY1; |
mbed_official | 130:1dec54e4aec3 | 498 | FLASH->OPTKEYR = FLASH_OPTKEY2; |
mbed_official | 130:1dec54e4aec3 | 499 | } |
mbed_official | 130:1dec54e4aec3 | 500 | } |
mbed_official | 130:1dec54e4aec3 | 501 | |
mbed_official | 130:1dec54e4aec3 | 502 | /** |
mbed_official | 130:1dec54e4aec3 | 503 | * @brief Locks the option bytes block access. |
mbed_official | 130:1dec54e4aec3 | 504 | * @param None |
mbed_official | 130:1dec54e4aec3 | 505 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 506 | */ |
mbed_official | 130:1dec54e4aec3 | 507 | void FLASH_OB_Lock(void) |
mbed_official | 130:1dec54e4aec3 | 508 | { |
mbed_official | 130:1dec54e4aec3 | 509 | /* Set the OPTWREN Bit to lock the option bytes block access */ |
mbed_official | 130:1dec54e4aec3 | 510 | FLASH->CR &= ~FLASH_CR_OPTWRE; |
mbed_official | 130:1dec54e4aec3 | 511 | } |
mbed_official | 130:1dec54e4aec3 | 512 | |
mbed_official | 130:1dec54e4aec3 | 513 | /** |
mbed_official | 130:1dec54e4aec3 | 514 | * @brief Launch the option byte loading. |
mbed_official | 130:1dec54e4aec3 | 515 | * @param None |
mbed_official | 130:1dec54e4aec3 | 516 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 517 | */ |
mbed_official | 130:1dec54e4aec3 | 518 | void FLASH_OB_Launch(void) |
mbed_official | 130:1dec54e4aec3 | 519 | { |
mbed_official | 130:1dec54e4aec3 | 520 | /* Set the OBL_Launch bit to launch the option byte loading */ |
mbed_official | 130:1dec54e4aec3 | 521 | FLASH->CR |= FLASH_CR_OBL_LAUNCH; |
mbed_official | 130:1dec54e4aec3 | 522 | } |
mbed_official | 130:1dec54e4aec3 | 523 | |
mbed_official | 130:1dec54e4aec3 | 524 | /** |
mbed_official | 130:1dec54e4aec3 | 525 | * @brief Erases the FLASH option bytes. |
mbed_official | 130:1dec54e4aec3 | 526 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 527 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 528 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 529 | * @note This functions erases all option bytes except the Read protection (RDP). |
mbed_official | 130:1dec54e4aec3 | 530 | * @param None |
mbed_official | 130:1dec54e4aec3 | 531 | * @retval FLASH Status: The returned value can be: FLASH_ERROR_PG, |
mbed_official | 130:1dec54e4aec3 | 532 | * FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 533 | */ |
mbed_official | 130:1dec54e4aec3 | 534 | FLASH_Status FLASH_OB_Erase(void) |
mbed_official | 130:1dec54e4aec3 | 535 | { |
mbed_official | 130:1dec54e4aec3 | 536 | uint16_t rdptmp = OB_RDP_Level_0; |
mbed_official | 130:1dec54e4aec3 | 537 | |
mbed_official | 130:1dec54e4aec3 | 538 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 539 | |
mbed_official | 130:1dec54e4aec3 | 540 | /* Get the actual read protection Option Byte value */ |
mbed_official | 130:1dec54e4aec3 | 541 | if(FLASH_OB_GetRDP() != RESET) |
mbed_official | 130:1dec54e4aec3 | 542 | { |
mbed_official | 130:1dec54e4aec3 | 543 | rdptmp = 0x00; |
mbed_official | 130:1dec54e4aec3 | 544 | } |
mbed_official | 130:1dec54e4aec3 | 545 | |
mbed_official | 130:1dec54e4aec3 | 546 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 547 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 548 | |
mbed_official | 130:1dec54e4aec3 | 549 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 550 | { |
mbed_official | 130:1dec54e4aec3 | 551 | /* If the previous operation is completed, proceed to erase the option bytes */ |
mbed_official | 130:1dec54e4aec3 | 552 | FLASH->CR |= FLASH_CR_OPTER; |
mbed_official | 130:1dec54e4aec3 | 553 | FLASH->CR |= FLASH_CR_STRT; |
mbed_official | 130:1dec54e4aec3 | 554 | |
mbed_official | 130:1dec54e4aec3 | 555 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 556 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 557 | |
mbed_official | 130:1dec54e4aec3 | 558 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 559 | { |
mbed_official | 130:1dec54e4aec3 | 560 | /* If the erase operation is completed, disable the OPTER Bit */ |
mbed_official | 130:1dec54e4aec3 | 561 | FLASH->CR &= ~FLASH_CR_OPTER; |
mbed_official | 130:1dec54e4aec3 | 562 | |
mbed_official | 130:1dec54e4aec3 | 563 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 564 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 565 | |
mbed_official | 130:1dec54e4aec3 | 566 | /* Restore the last read protection Option Byte value */ |
mbed_official | 130:1dec54e4aec3 | 567 | OB->RDP = (uint16_t)rdptmp; |
mbed_official | 130:1dec54e4aec3 | 568 | |
mbed_official | 130:1dec54e4aec3 | 569 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 570 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 571 | |
mbed_official | 130:1dec54e4aec3 | 572 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 573 | { |
mbed_official | 130:1dec54e4aec3 | 574 | /* if the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 575 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 576 | } |
mbed_official | 130:1dec54e4aec3 | 577 | } |
mbed_official | 130:1dec54e4aec3 | 578 | else |
mbed_official | 130:1dec54e4aec3 | 579 | { |
mbed_official | 130:1dec54e4aec3 | 580 | if (status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 581 | { |
mbed_official | 130:1dec54e4aec3 | 582 | /* Disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 583 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 584 | } |
mbed_official | 130:1dec54e4aec3 | 585 | } |
mbed_official | 130:1dec54e4aec3 | 586 | } |
mbed_official | 130:1dec54e4aec3 | 587 | /* Return the erase status */ |
mbed_official | 130:1dec54e4aec3 | 588 | return status; |
mbed_official | 130:1dec54e4aec3 | 589 | } |
mbed_official | 130:1dec54e4aec3 | 590 | |
mbed_official | 130:1dec54e4aec3 | 591 | /** |
mbed_official | 130:1dec54e4aec3 | 592 | * @brief Write protects the desired pages |
mbed_official | 130:1dec54e4aec3 | 593 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 594 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 595 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 596 | * @param OB_WRP: specifies the address of the pages to be write protected. |
mbed_official | 130:1dec54e4aec3 | 597 | * This parameter can be: |
mbed_official | 130:1dec54e4aec3 | 598 | * @arg OB_WRP_Pages0to3..OB_WRP_Pages60to63 |
mbed_official | 130:1dec54e4aec3 | 599 | * @arg OB_WRP_AllPages |
mbed_official | 130:1dec54e4aec3 | 600 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 601 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 602 | */ |
mbed_official | 130:1dec54e4aec3 | 603 | FLASH_Status FLASH_OB_EnableWRP(uint32_t OB_WRP) |
mbed_official | 130:1dec54e4aec3 | 604 | { |
mbed_official | 130:1dec54e4aec3 | 605 | uint16_t WRP0_Data = 0xFFFF, WRP1_Data = 0xFFFF, WRP2_Data = 0xFFFF, WRP3_Data = 0xFFFF; |
mbed_official | 130:1dec54e4aec3 | 606 | |
mbed_official | 130:1dec54e4aec3 | 607 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 608 | |
mbed_official | 130:1dec54e4aec3 | 609 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 610 | assert_param(IS_OB_WRP(OB_WRP)); |
mbed_official | 130:1dec54e4aec3 | 611 | |
mbed_official | 130:1dec54e4aec3 | 612 | OB_WRP = (uint32_t)(~OB_WRP); |
mbed_official | 130:1dec54e4aec3 | 613 | WRP0_Data = (uint16_t)(OB_WRP & OB_WRP0_WRP0); |
mbed_official | 130:1dec54e4aec3 | 614 | WRP1_Data = (uint16_t)((OB_WRP >> 8) & OB_WRP0_WRP0); |
mbed_official | 130:1dec54e4aec3 | 615 | WRP2_Data = (uint16_t)((OB_WRP >> 16) & OB_WRP0_WRP0) ; |
mbed_official | 130:1dec54e4aec3 | 616 | WRP3_Data = (uint16_t)((OB_WRP >> 24) & OB_WRP0_WRP0) ; |
mbed_official | 130:1dec54e4aec3 | 617 | |
mbed_official | 130:1dec54e4aec3 | 618 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 619 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 620 | |
mbed_official | 130:1dec54e4aec3 | 621 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 622 | { |
mbed_official | 130:1dec54e4aec3 | 623 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 624 | |
mbed_official | 130:1dec54e4aec3 | 625 | if(WRP0_Data != 0xFF) |
mbed_official | 130:1dec54e4aec3 | 626 | { |
mbed_official | 130:1dec54e4aec3 | 627 | OB->WRP0 = WRP0_Data; |
mbed_official | 130:1dec54e4aec3 | 628 | |
mbed_official | 130:1dec54e4aec3 | 629 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 630 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 631 | } |
mbed_official | 130:1dec54e4aec3 | 632 | if((status == FLASH_COMPLETE) && (WRP1_Data != 0xFF)) |
mbed_official | 130:1dec54e4aec3 | 633 | { |
mbed_official | 130:1dec54e4aec3 | 634 | OB->WRP1 = WRP1_Data; |
mbed_official | 130:1dec54e4aec3 | 635 | |
mbed_official | 130:1dec54e4aec3 | 636 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 637 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 638 | } |
mbed_official | 130:1dec54e4aec3 | 639 | if((status == FLASH_COMPLETE) && (WRP2_Data != 0xFF)) |
mbed_official | 130:1dec54e4aec3 | 640 | { |
mbed_official | 130:1dec54e4aec3 | 641 | OB->WRP2 = WRP2_Data; |
mbed_official | 130:1dec54e4aec3 | 642 | |
mbed_official | 130:1dec54e4aec3 | 643 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 644 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 645 | } |
mbed_official | 130:1dec54e4aec3 | 646 | if((status == FLASH_COMPLETE) && (WRP3_Data != 0xFF)) |
mbed_official | 130:1dec54e4aec3 | 647 | { |
mbed_official | 130:1dec54e4aec3 | 648 | OB->WRP3 = WRP3_Data; |
mbed_official | 130:1dec54e4aec3 | 649 | |
mbed_official | 130:1dec54e4aec3 | 650 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 651 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 652 | } |
mbed_official | 130:1dec54e4aec3 | 653 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 654 | { |
mbed_official | 130:1dec54e4aec3 | 655 | /* if the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 656 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 657 | } |
mbed_official | 130:1dec54e4aec3 | 658 | } |
mbed_official | 130:1dec54e4aec3 | 659 | /* Return the write protection operation Status */ |
mbed_official | 130:1dec54e4aec3 | 660 | return status; |
mbed_official | 130:1dec54e4aec3 | 661 | } |
mbed_official | 130:1dec54e4aec3 | 662 | |
mbed_official | 130:1dec54e4aec3 | 663 | /** |
mbed_official | 130:1dec54e4aec3 | 664 | * @brief Enables or disables the read out protection. |
mbed_official | 130:1dec54e4aec3 | 665 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 666 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 667 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 668 | * @param FLASH_ReadProtection_Level: specifies the read protection level. |
mbed_official | 130:1dec54e4aec3 | 669 | * This parameter can be: |
mbed_official | 130:1dec54e4aec3 | 670 | * @arg OB_RDP_Level_0: No protection |
mbed_official | 130:1dec54e4aec3 | 671 | * @arg OB_RDP_Level_1: Read protection of the memory |
mbed_official | 130:1dec54e4aec3 | 672 | * @arg OB_RDP_Level_2: Chip protection |
mbed_official | 130:1dec54e4aec3 | 673 | * @note When enabling OB_RDP level 2 it's no more possible to go back to level 1 or 0 |
mbed_official | 130:1dec54e4aec3 | 674 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 675 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 676 | */ |
mbed_official | 130:1dec54e4aec3 | 677 | FLASH_Status FLASH_OB_RDPConfig(uint8_t OB_RDP) |
mbed_official | 130:1dec54e4aec3 | 678 | { |
mbed_official | 130:1dec54e4aec3 | 679 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 680 | |
mbed_official | 130:1dec54e4aec3 | 681 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 682 | assert_param(IS_OB_RDP(OB_RDP)); |
mbed_official | 130:1dec54e4aec3 | 683 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 684 | |
mbed_official | 130:1dec54e4aec3 | 685 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 686 | { |
mbed_official | 130:1dec54e4aec3 | 687 | FLASH->CR |= FLASH_CR_OPTER; |
mbed_official | 130:1dec54e4aec3 | 688 | FLASH->CR |= FLASH_CR_STRT; |
mbed_official | 130:1dec54e4aec3 | 689 | |
mbed_official | 130:1dec54e4aec3 | 690 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 691 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 692 | |
mbed_official | 130:1dec54e4aec3 | 693 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 694 | { |
mbed_official | 130:1dec54e4aec3 | 695 | /* If the erase operation is completed, disable the OPTER Bit */ |
mbed_official | 130:1dec54e4aec3 | 696 | FLASH->CR &= ~FLASH_CR_OPTER; |
mbed_official | 130:1dec54e4aec3 | 697 | |
mbed_official | 130:1dec54e4aec3 | 698 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 699 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 700 | |
mbed_official | 130:1dec54e4aec3 | 701 | OB->RDP = OB_RDP; |
mbed_official | 130:1dec54e4aec3 | 702 | |
mbed_official | 130:1dec54e4aec3 | 703 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 704 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 705 | |
mbed_official | 130:1dec54e4aec3 | 706 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 707 | { |
mbed_official | 130:1dec54e4aec3 | 708 | /* if the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 709 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 710 | } |
mbed_official | 130:1dec54e4aec3 | 711 | } |
mbed_official | 130:1dec54e4aec3 | 712 | else |
mbed_official | 130:1dec54e4aec3 | 713 | { |
mbed_official | 130:1dec54e4aec3 | 714 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 715 | { |
mbed_official | 130:1dec54e4aec3 | 716 | /* Disable the OPTER Bit */ |
mbed_official | 130:1dec54e4aec3 | 717 | FLASH->CR &= ~FLASH_CR_OPTER; |
mbed_official | 130:1dec54e4aec3 | 718 | } |
mbed_official | 130:1dec54e4aec3 | 719 | } |
mbed_official | 130:1dec54e4aec3 | 720 | } |
mbed_official | 130:1dec54e4aec3 | 721 | /* Return the protection operation Status */ |
mbed_official | 130:1dec54e4aec3 | 722 | return status; |
mbed_official | 130:1dec54e4aec3 | 723 | } |
mbed_official | 130:1dec54e4aec3 | 724 | |
mbed_official | 130:1dec54e4aec3 | 725 | /** |
mbed_official | 130:1dec54e4aec3 | 726 | * @brief Programs the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY. |
mbed_official | 130:1dec54e4aec3 | 727 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 728 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 729 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 730 | * @param OB_IWDG: Selects the WDG mode |
mbed_official | 130:1dec54e4aec3 | 731 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 732 | * @arg OB_IWDG_SW: Software WDG selected |
mbed_official | 130:1dec54e4aec3 | 733 | * @arg OB_IWDG_HW: Hardware WDG selected |
mbed_official | 130:1dec54e4aec3 | 734 | * @param OB_STOP: Reset event when entering STOP mode. |
mbed_official | 130:1dec54e4aec3 | 735 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 736 | * @arg OB_STOP_NoRST: No reset generated when entering in STOP |
mbed_official | 130:1dec54e4aec3 | 737 | * @arg OB_STOP_RST: Reset generated when entering in STOP |
mbed_official | 130:1dec54e4aec3 | 738 | * @param OB_STDBY: Reset event when entering Standby mode. |
mbed_official | 130:1dec54e4aec3 | 739 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 740 | * @arg OB_STDBY_NoRST: No reset generated when entering in STANDBY |
mbed_official | 130:1dec54e4aec3 | 741 | * @arg OB_STDBY_RST: Reset generated when entering in STANDBY |
mbed_official | 130:1dec54e4aec3 | 742 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 743 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 744 | */ |
mbed_official | 130:1dec54e4aec3 | 745 | FLASH_Status FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY) |
mbed_official | 130:1dec54e4aec3 | 746 | { |
mbed_official | 130:1dec54e4aec3 | 747 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 748 | |
mbed_official | 130:1dec54e4aec3 | 749 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 750 | assert_param(IS_OB_IWDG_SOURCE(OB_IWDG)); |
mbed_official | 130:1dec54e4aec3 | 751 | assert_param(IS_OB_STOP_SOURCE(OB_STOP)); |
mbed_official | 130:1dec54e4aec3 | 752 | assert_param(IS_OB_STDBY_SOURCE(OB_STDBY)); |
mbed_official | 130:1dec54e4aec3 | 753 | |
mbed_official | 130:1dec54e4aec3 | 754 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 755 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 756 | |
mbed_official | 130:1dec54e4aec3 | 757 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 758 | { |
mbed_official | 130:1dec54e4aec3 | 759 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 760 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 761 | |
mbed_official | 130:1dec54e4aec3 | 762 | OB->USER = (uint16_t)((uint16_t)(OB_IWDG | OB_STOP) | (uint16_t)(OB_STDBY | 0xF8)); |
mbed_official | 130:1dec54e4aec3 | 763 | |
mbed_official | 130:1dec54e4aec3 | 764 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 765 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 766 | |
mbed_official | 130:1dec54e4aec3 | 767 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 768 | { |
mbed_official | 130:1dec54e4aec3 | 769 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 770 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 771 | } |
mbed_official | 130:1dec54e4aec3 | 772 | } |
mbed_official | 130:1dec54e4aec3 | 773 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 774 | return status; |
mbed_official | 130:1dec54e4aec3 | 775 | } |
mbed_official | 130:1dec54e4aec3 | 776 | |
mbed_official | 130:1dec54e4aec3 | 777 | /** |
mbed_official | 130:1dec54e4aec3 | 778 | * @brief Sets or resets the BOOT1 option bit. |
mbed_official | 130:1dec54e4aec3 | 779 | * @param OB_BOOT1: Set or Reset the BOOT1 option bit. |
mbed_official | 130:1dec54e4aec3 | 780 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 781 | * @arg OB_BOOT1_RESET: BOOT1 option bit reset |
mbed_official | 130:1dec54e4aec3 | 782 | * @arg OB_BOOT1_SET: BOOT1 option bit set |
mbed_official | 130:1dec54e4aec3 | 783 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 784 | */ |
mbed_official | 130:1dec54e4aec3 | 785 | FLASH_Status FLASH_OB_BOOTConfig(uint8_t OB_BOOT1) |
mbed_official | 130:1dec54e4aec3 | 786 | { |
mbed_official | 130:1dec54e4aec3 | 787 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 788 | |
mbed_official | 130:1dec54e4aec3 | 789 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 790 | assert_param(IS_OB_BOOT1(OB_BOOT1)); |
mbed_official | 130:1dec54e4aec3 | 791 | |
mbed_official | 130:1dec54e4aec3 | 792 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 793 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 794 | |
mbed_official | 130:1dec54e4aec3 | 795 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 796 | { |
mbed_official | 130:1dec54e4aec3 | 797 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 798 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 799 | |
mbed_official | 130:1dec54e4aec3 | 800 | OB->USER = OB_BOOT1 | 0xEF; |
mbed_official | 130:1dec54e4aec3 | 801 | |
mbed_official | 130:1dec54e4aec3 | 802 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 803 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 804 | |
mbed_official | 130:1dec54e4aec3 | 805 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 806 | { |
mbed_official | 130:1dec54e4aec3 | 807 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 808 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 809 | } |
mbed_official | 130:1dec54e4aec3 | 810 | } |
mbed_official | 130:1dec54e4aec3 | 811 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 812 | return status; |
mbed_official | 130:1dec54e4aec3 | 813 | } |
mbed_official | 130:1dec54e4aec3 | 814 | |
mbed_official | 130:1dec54e4aec3 | 815 | /** |
mbed_official | 130:1dec54e4aec3 | 816 | * @brief Sets or resets the BOOT0 option bit. |
mbed_official | 130:1dec54e4aec3 | 817 | * @note This function is applicable only for the STM32F042 devices. |
mbed_official | 130:1dec54e4aec3 | 818 | * @param OB_BOOT0: Set or Reset the BOOT0 option bit. |
mbed_official | 130:1dec54e4aec3 | 819 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 820 | * @arg OB_BOOT0_RESET: BOOT0 option bit reset |
mbed_official | 130:1dec54e4aec3 | 821 | * @arg OB_BOOT0_SET: BOOT0 option bit set |
mbed_official | 130:1dec54e4aec3 | 822 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 823 | */ |
mbed_official | 130:1dec54e4aec3 | 824 | FLASH_Status FLASH_OB_BOOT0Config(uint8_t OB_BOOT0) |
mbed_official | 130:1dec54e4aec3 | 825 | { |
mbed_official | 130:1dec54e4aec3 | 826 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 827 | |
mbed_official | 130:1dec54e4aec3 | 828 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 829 | assert_param(IS_OB_BOOT0(OB_BOOT0)); |
mbed_official | 130:1dec54e4aec3 | 830 | |
mbed_official | 130:1dec54e4aec3 | 831 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 832 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 833 | |
mbed_official | 130:1dec54e4aec3 | 834 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 835 | { |
mbed_official | 130:1dec54e4aec3 | 836 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 837 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 838 | |
mbed_official | 130:1dec54e4aec3 | 839 | OB->USER = OB_BOOT0 | 0xF7; |
mbed_official | 130:1dec54e4aec3 | 840 | |
mbed_official | 130:1dec54e4aec3 | 841 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 842 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 843 | |
mbed_official | 130:1dec54e4aec3 | 844 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 845 | { |
mbed_official | 130:1dec54e4aec3 | 846 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 847 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 848 | } |
mbed_official | 130:1dec54e4aec3 | 849 | } |
mbed_official | 130:1dec54e4aec3 | 850 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 851 | return status; |
mbed_official | 130:1dec54e4aec3 | 852 | } |
mbed_official | 130:1dec54e4aec3 | 853 | |
mbed_official | 130:1dec54e4aec3 | 854 | /** |
mbed_official | 130:1dec54e4aec3 | 855 | * @brief Sets or resets the BOOT0SW option bit. |
mbed_official | 130:1dec54e4aec3 | 856 | * @note This function is applicable only for the STM32F042 devices. |
mbed_official | 130:1dec54e4aec3 | 857 | * @param OB_BOOT0SW: Set or Reset the BOOT0_SW option bit. |
mbed_official | 130:1dec54e4aec3 | 858 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 859 | * @arg OB_BOOT0_SW: BOOT0_SW option bit reset |
mbed_official | 130:1dec54e4aec3 | 860 | * @arg OB_BOOT0_HW: BOOT0_SW option bit set |
mbed_official | 130:1dec54e4aec3 | 861 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 862 | */ |
mbed_official | 130:1dec54e4aec3 | 863 | FLASH_Status FLASH_OB_BOOT0SWConfig(uint8_t OB_BOOT0SW) |
mbed_official | 130:1dec54e4aec3 | 864 | { |
mbed_official | 130:1dec54e4aec3 | 865 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 866 | |
mbed_official | 130:1dec54e4aec3 | 867 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 868 | assert_param(IS_OB_BOOT0SW(OB_BOOT0SW)); |
mbed_official | 130:1dec54e4aec3 | 869 | |
mbed_official | 130:1dec54e4aec3 | 870 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 871 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 872 | |
mbed_official | 130:1dec54e4aec3 | 873 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 874 | { |
mbed_official | 130:1dec54e4aec3 | 875 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 876 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 877 | |
mbed_official | 130:1dec54e4aec3 | 878 | OB->USER = OB_BOOT0SW | 0x7F; |
mbed_official | 130:1dec54e4aec3 | 879 | |
mbed_official | 130:1dec54e4aec3 | 880 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 881 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 882 | |
mbed_official | 130:1dec54e4aec3 | 883 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 884 | { |
mbed_official | 130:1dec54e4aec3 | 885 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 886 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 887 | } |
mbed_official | 130:1dec54e4aec3 | 888 | } |
mbed_official | 130:1dec54e4aec3 | 889 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 890 | return status; |
mbed_official | 130:1dec54e4aec3 | 891 | } |
mbed_official | 130:1dec54e4aec3 | 892 | |
mbed_official | 130:1dec54e4aec3 | 893 | /** |
mbed_official | 130:1dec54e4aec3 | 894 | * @brief Sets or resets the analogue monitoring on VDDA Power source. |
mbed_official | 130:1dec54e4aec3 | 895 | * @param OB_VDDA_ANALOG: Selects the analog monitoring on VDDA Power source. |
mbed_official | 130:1dec54e4aec3 | 896 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 897 | * @arg OB_VDDA_ANALOG_ON: Analog monitoring on VDDA Power source ON |
mbed_official | 130:1dec54e4aec3 | 898 | * @arg OB_VDDA_ANALOG_OFF: Analog monitoring on VDDA Power source OFF |
mbed_official | 130:1dec54e4aec3 | 899 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 900 | */ |
mbed_official | 130:1dec54e4aec3 | 901 | FLASH_Status FLASH_OB_VDDAConfig(uint8_t OB_VDDA_ANALOG) |
mbed_official | 130:1dec54e4aec3 | 902 | { |
mbed_official | 130:1dec54e4aec3 | 903 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 904 | |
mbed_official | 130:1dec54e4aec3 | 905 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 906 | assert_param(IS_OB_VDDA_ANALOG(OB_VDDA_ANALOG)); |
mbed_official | 130:1dec54e4aec3 | 907 | |
mbed_official | 130:1dec54e4aec3 | 908 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 909 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 910 | |
mbed_official | 130:1dec54e4aec3 | 911 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 912 | { |
mbed_official | 130:1dec54e4aec3 | 913 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 914 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 915 | |
mbed_official | 130:1dec54e4aec3 | 916 | OB->USER = OB_VDDA_ANALOG | 0xDF; |
mbed_official | 130:1dec54e4aec3 | 917 | |
mbed_official | 130:1dec54e4aec3 | 918 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 919 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 920 | |
mbed_official | 130:1dec54e4aec3 | 921 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 922 | { |
mbed_official | 130:1dec54e4aec3 | 923 | /* if the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 924 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 925 | } |
mbed_official | 130:1dec54e4aec3 | 926 | } |
mbed_official | 130:1dec54e4aec3 | 927 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 928 | return status; |
mbed_official | 130:1dec54e4aec3 | 929 | } |
mbed_official | 130:1dec54e4aec3 | 930 | |
mbed_official | 130:1dec54e4aec3 | 931 | /** |
mbed_official | 130:1dec54e4aec3 | 932 | * @brief Sets or resets the SRAM parity. |
mbed_official | 130:1dec54e4aec3 | 933 | * @param OB_SRAM_Parity: Set or Reset the SRAM parity enable bit. |
mbed_official | 130:1dec54e4aec3 | 934 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 935 | * @arg OB_SRAM_PARITY_SET: Set SRAM parity. |
mbed_official | 130:1dec54e4aec3 | 936 | * @arg OB_SRAM_PARITY_RESET: Reset SRAM parity. |
mbed_official | 130:1dec54e4aec3 | 937 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 938 | */ |
mbed_official | 130:1dec54e4aec3 | 939 | FLASH_Status FLASH_OB_SRAMParityConfig(uint8_t OB_SRAM_Parity) |
mbed_official | 130:1dec54e4aec3 | 940 | { |
mbed_official | 130:1dec54e4aec3 | 941 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 942 | |
mbed_official | 130:1dec54e4aec3 | 943 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 944 | assert_param(IS_OB_SRAM_PARITY(OB_SRAM_Parity)); |
mbed_official | 130:1dec54e4aec3 | 945 | |
mbed_official | 130:1dec54e4aec3 | 946 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 947 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 948 | |
mbed_official | 130:1dec54e4aec3 | 949 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 950 | { |
mbed_official | 130:1dec54e4aec3 | 951 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 952 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 953 | |
mbed_official | 130:1dec54e4aec3 | 954 | OB->USER = OB_SRAM_Parity | 0xBF; |
mbed_official | 130:1dec54e4aec3 | 955 | |
mbed_official | 130:1dec54e4aec3 | 956 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 957 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 958 | |
mbed_official | 130:1dec54e4aec3 | 959 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 960 | { |
mbed_official | 130:1dec54e4aec3 | 961 | /* if the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 962 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 963 | } |
mbed_official | 130:1dec54e4aec3 | 964 | } |
mbed_official | 130:1dec54e4aec3 | 965 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 966 | return status; |
mbed_official | 130:1dec54e4aec3 | 967 | } |
mbed_official | 130:1dec54e4aec3 | 968 | |
mbed_official | 130:1dec54e4aec3 | 969 | /** |
mbed_official | 130:1dec54e4aec3 | 970 | * @brief Programs the FLASH User Option Byte: IWDG_SW, RST_STOP, RST_STDBY, |
mbed_official | 130:1dec54e4aec3 | 971 | * BOOT1 and VDDA ANALOG monitoring. |
mbed_official | 130:1dec54e4aec3 | 972 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 973 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 974 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 975 | * @param OB_USER: Selects all user option bytes |
mbed_official | 130:1dec54e4aec3 | 976 | * This parameter is a combination of the following values: |
mbed_official | 130:1dec54e4aec3 | 977 | * @arg OB_IWDG_SW / OB_IWDG_HW: Software / Hardware WDG selected |
mbed_official | 130:1dec54e4aec3 | 978 | * @arg OB_STOP_NoRST / OB_STOP_RST: No reset / Reset generated when entering in STOP |
mbed_official | 130:1dec54e4aec3 | 979 | * @arg OB_STDBY_NoRST / OB_STDBY_RST: No reset / Reset generated when entering in STANDBY |
mbed_official | 130:1dec54e4aec3 | 980 | * @arg OB_BOOT1_RESET / OB_BOOT1_SET: BOOT1 Reset / Set |
mbed_official | 130:1dec54e4aec3 | 981 | * @arg OB_VDDA_ANALOG_ON / OB_VDDA_ANALOG_OFF: Analog monitoring on VDDA Power source ON / OFF |
mbed_official | 130:1dec54e4aec3 | 982 | * @arg OB_SRAM_PARITY_SET / OB_SRAM_PARITY_RESET: SRAM Parity SET / RESET |
mbed_official | 130:1dec54e4aec3 | 983 | * @arg OB_BOOT0_RESET / OB_BOOT0_SET: BOOT0 Reset / Set |
mbed_official | 130:1dec54e4aec3 | 984 | * @arg OB_BOOT0_SW / OB_BOOT0_SW: BOOT0 pin disabled / BOOT0 pin bonded with GPIO |
mbed_official | 130:1dec54e4aec3 | 985 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 986 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 987 | */ |
mbed_official | 130:1dec54e4aec3 | 988 | FLASH_Status FLASH_OB_WriteUser(uint8_t OB_USER) |
mbed_official | 130:1dec54e4aec3 | 989 | { |
mbed_official | 130:1dec54e4aec3 | 990 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 991 | |
mbed_official | 130:1dec54e4aec3 | 992 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 993 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 994 | |
mbed_official | 130:1dec54e4aec3 | 995 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 996 | { |
mbed_official | 130:1dec54e4aec3 | 997 | /* Enable the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 998 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 999 | |
mbed_official | 130:1dec54e4aec3 | 1000 | OB->USER = OB_USER; |
mbed_official | 130:1dec54e4aec3 | 1001 | |
mbed_official | 130:1dec54e4aec3 | 1002 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 1003 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 1004 | |
mbed_official | 130:1dec54e4aec3 | 1005 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 1006 | { |
mbed_official | 130:1dec54e4aec3 | 1007 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 1008 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 1009 | } |
mbed_official | 130:1dec54e4aec3 | 1010 | } |
mbed_official | 130:1dec54e4aec3 | 1011 | /* Return the Option Byte program Status */ |
mbed_official | 130:1dec54e4aec3 | 1012 | return status; |
mbed_official | 130:1dec54e4aec3 | 1013 | |
mbed_official | 130:1dec54e4aec3 | 1014 | } |
mbed_official | 130:1dec54e4aec3 | 1015 | |
mbed_official | 130:1dec54e4aec3 | 1016 | /** |
mbed_official | 130:1dec54e4aec3 | 1017 | * @brief Programs a half word at a specified Option Byte Data address. |
mbed_official | 130:1dec54e4aec3 | 1018 | * @note To correctly run this function, the FLASH_OB_Unlock() function must be called before. |
mbed_official | 130:1dec54e4aec3 | 1019 | * @note Call the FLASH_OB_Lock() to disable the flash control register access and the option |
mbed_official | 130:1dec54e4aec3 | 1020 | * bytes (recommended to protect the FLASH memory against possible unwanted operation) |
mbed_official | 130:1dec54e4aec3 | 1021 | * @param Address: specifies the address to be programmed. |
mbed_official | 130:1dec54e4aec3 | 1022 | * This parameter can be 0x1FFFF804 or 0x1FFFF806. |
mbed_official | 130:1dec54e4aec3 | 1023 | * @param Data: specifies the data to be programmed. |
mbed_official | 130:1dec54e4aec3 | 1024 | * @retval FLASH Status: The returned value can be: FLASH_ERROR_PG, |
mbed_official | 130:1dec54e4aec3 | 1025 | * FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 1026 | */ |
mbed_official | 130:1dec54e4aec3 | 1027 | FLASH_Status FLASH_OB_ProgramData(uint32_t Address, uint8_t Data) |
mbed_official | 130:1dec54e4aec3 | 1028 | { |
mbed_official | 130:1dec54e4aec3 | 1029 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 1030 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 1031 | assert_param(IS_OB_DATA_ADDRESS(Address)); |
mbed_official | 130:1dec54e4aec3 | 1032 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 1033 | |
mbed_official | 130:1dec54e4aec3 | 1034 | if(status == FLASH_COMPLETE) |
mbed_official | 130:1dec54e4aec3 | 1035 | { |
mbed_official | 130:1dec54e4aec3 | 1036 | /* Enables the Option Bytes Programming operation */ |
mbed_official | 130:1dec54e4aec3 | 1037 | FLASH->CR |= FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 1038 | *(__IO uint16_t*)Address = Data; |
mbed_official | 130:1dec54e4aec3 | 1039 | |
mbed_official | 130:1dec54e4aec3 | 1040 | /* Wait for last operation to be completed */ |
mbed_official | 130:1dec54e4aec3 | 1041 | status = FLASH_WaitForLastOperation(FLASH_ER_PRG_TIMEOUT); |
mbed_official | 130:1dec54e4aec3 | 1042 | |
mbed_official | 130:1dec54e4aec3 | 1043 | if(status != FLASH_TIMEOUT) |
mbed_official | 130:1dec54e4aec3 | 1044 | { |
mbed_official | 130:1dec54e4aec3 | 1045 | /* If the program operation is completed, disable the OPTPG Bit */ |
mbed_official | 130:1dec54e4aec3 | 1046 | FLASH->CR &= ~FLASH_CR_OPTPG; |
mbed_official | 130:1dec54e4aec3 | 1047 | } |
mbed_official | 130:1dec54e4aec3 | 1048 | } |
mbed_official | 130:1dec54e4aec3 | 1049 | /* Return the Option Byte Data Program Status */ |
mbed_official | 130:1dec54e4aec3 | 1050 | return status; |
mbed_official | 130:1dec54e4aec3 | 1051 | } |
mbed_official | 130:1dec54e4aec3 | 1052 | |
mbed_official | 130:1dec54e4aec3 | 1053 | /** |
mbed_official | 130:1dec54e4aec3 | 1054 | * @brief Returns the FLASH User Option Bytes values. |
mbed_official | 130:1dec54e4aec3 | 1055 | * @param None |
mbed_official | 130:1dec54e4aec3 | 1056 | * @retval The FLASH User Option Bytes . |
mbed_official | 130:1dec54e4aec3 | 1057 | */ |
mbed_official | 130:1dec54e4aec3 | 1058 | uint8_t FLASH_OB_GetUser(void) |
mbed_official | 130:1dec54e4aec3 | 1059 | { |
mbed_official | 130:1dec54e4aec3 | 1060 | /* Return the User Option Byte */ |
mbed_official | 130:1dec54e4aec3 | 1061 | return (uint8_t)(FLASH->OBR >> 8); |
mbed_official | 130:1dec54e4aec3 | 1062 | } |
mbed_official | 130:1dec54e4aec3 | 1063 | |
mbed_official | 130:1dec54e4aec3 | 1064 | /** |
mbed_official | 130:1dec54e4aec3 | 1065 | * @brief Returns the FLASH Write Protection Option Bytes value. |
mbed_official | 130:1dec54e4aec3 | 1066 | * @param None |
mbed_official | 130:1dec54e4aec3 | 1067 | * @retval The FLASH Write Protection Option Bytes value |
mbed_official | 130:1dec54e4aec3 | 1068 | */ |
mbed_official | 130:1dec54e4aec3 | 1069 | uint32_t FLASH_OB_GetWRP(void) |
mbed_official | 130:1dec54e4aec3 | 1070 | { |
mbed_official | 130:1dec54e4aec3 | 1071 | /* Return the FLASH write protection Register value */ |
mbed_official | 130:1dec54e4aec3 | 1072 | return (uint32_t)(FLASH->WRPR); |
mbed_official | 130:1dec54e4aec3 | 1073 | } |
mbed_official | 130:1dec54e4aec3 | 1074 | |
mbed_official | 130:1dec54e4aec3 | 1075 | /** |
mbed_official | 130:1dec54e4aec3 | 1076 | * @brief Checks whether the FLASH Read out Protection Status is set or not. |
mbed_official | 130:1dec54e4aec3 | 1077 | * @param None |
mbed_official | 130:1dec54e4aec3 | 1078 | * @retval FLASH ReadOut Protection Status(SET or RESET) |
mbed_official | 130:1dec54e4aec3 | 1079 | */ |
mbed_official | 130:1dec54e4aec3 | 1080 | FlagStatus FLASH_OB_GetRDP(void) |
mbed_official | 130:1dec54e4aec3 | 1081 | { |
mbed_official | 130:1dec54e4aec3 | 1082 | FlagStatus readstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 1083 | |
mbed_official | 130:1dec54e4aec3 | 1084 | if ((uint8_t)(FLASH->OBR & (FLASH_OBR_RDPRT1 | FLASH_OBR_RDPRT2)) != RESET) |
mbed_official | 130:1dec54e4aec3 | 1085 | { |
mbed_official | 130:1dec54e4aec3 | 1086 | readstatus = SET; |
mbed_official | 130:1dec54e4aec3 | 1087 | } |
mbed_official | 130:1dec54e4aec3 | 1088 | else |
mbed_official | 130:1dec54e4aec3 | 1089 | { |
mbed_official | 130:1dec54e4aec3 | 1090 | readstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 1091 | } |
mbed_official | 130:1dec54e4aec3 | 1092 | return readstatus; |
mbed_official | 130:1dec54e4aec3 | 1093 | } |
mbed_official | 130:1dec54e4aec3 | 1094 | |
mbed_official | 130:1dec54e4aec3 | 1095 | /** |
mbed_official | 130:1dec54e4aec3 | 1096 | * @} |
mbed_official | 130:1dec54e4aec3 | 1097 | */ |
mbed_official | 130:1dec54e4aec3 | 1098 | |
mbed_official | 130:1dec54e4aec3 | 1099 | /** @defgroup FLASH_Group4 Interrupts and flags management functions |
mbed_official | 130:1dec54e4aec3 | 1100 | * @brief Interrupts and flags management functions |
mbed_official | 130:1dec54e4aec3 | 1101 | * |
mbed_official | 130:1dec54e4aec3 | 1102 | @verbatim |
mbed_official | 130:1dec54e4aec3 | 1103 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 1104 | ##### Interrupts and flags management functions ##### |
mbed_official | 130:1dec54e4aec3 | 1105 | =============================================================================== |
mbed_official | 130:1dec54e4aec3 | 1106 | |
mbed_official | 130:1dec54e4aec3 | 1107 | @endverbatim |
mbed_official | 130:1dec54e4aec3 | 1108 | * @{ |
mbed_official | 130:1dec54e4aec3 | 1109 | */ |
mbed_official | 130:1dec54e4aec3 | 1110 | |
mbed_official | 130:1dec54e4aec3 | 1111 | /** |
mbed_official | 130:1dec54e4aec3 | 1112 | * @brief Enables or disables the specified FLASH interrupts. |
mbed_official | 130:1dec54e4aec3 | 1113 | * @param FLASH_IT: specifies the FLASH interrupt sources to be enabled or |
mbed_official | 130:1dec54e4aec3 | 1114 | * disabled. |
mbed_official | 130:1dec54e4aec3 | 1115 | * This parameter can be any combination of the following values: |
mbed_official | 130:1dec54e4aec3 | 1116 | * @arg FLASH_IT_EOP: FLASH end of programming Interrupt |
mbed_official | 130:1dec54e4aec3 | 1117 | * @arg FLASH_IT_ERR: FLASH Error Interrupt |
mbed_official | 130:1dec54e4aec3 | 1118 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 1119 | */ |
mbed_official | 130:1dec54e4aec3 | 1120 | void FLASH_ITConfig(uint32_t FLASH_IT, FunctionalState NewState) |
mbed_official | 130:1dec54e4aec3 | 1121 | { |
mbed_official | 130:1dec54e4aec3 | 1122 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 1123 | assert_param(IS_FLASH_IT(FLASH_IT)); |
mbed_official | 130:1dec54e4aec3 | 1124 | assert_param(IS_FUNCTIONAL_STATE(NewState)); |
mbed_official | 130:1dec54e4aec3 | 1125 | |
mbed_official | 130:1dec54e4aec3 | 1126 | if(NewState != DISABLE) |
mbed_official | 130:1dec54e4aec3 | 1127 | { |
mbed_official | 130:1dec54e4aec3 | 1128 | /* Enable the interrupt sources */ |
mbed_official | 130:1dec54e4aec3 | 1129 | FLASH->CR |= FLASH_IT; |
mbed_official | 130:1dec54e4aec3 | 1130 | } |
mbed_official | 130:1dec54e4aec3 | 1131 | else |
mbed_official | 130:1dec54e4aec3 | 1132 | { |
mbed_official | 130:1dec54e4aec3 | 1133 | /* Disable the interrupt sources */ |
mbed_official | 130:1dec54e4aec3 | 1134 | FLASH->CR &= ~(uint32_t)FLASH_IT; |
mbed_official | 130:1dec54e4aec3 | 1135 | } |
mbed_official | 130:1dec54e4aec3 | 1136 | } |
mbed_official | 130:1dec54e4aec3 | 1137 | |
mbed_official | 130:1dec54e4aec3 | 1138 | /** |
mbed_official | 130:1dec54e4aec3 | 1139 | * @brief Checks whether the specified FLASH flag is set or not. |
mbed_official | 130:1dec54e4aec3 | 1140 | * @param FLASH_FLAG: specifies the FLASH flag to check. |
mbed_official | 130:1dec54e4aec3 | 1141 | * This parameter can be one of the following values: |
mbed_official | 130:1dec54e4aec3 | 1142 | * @arg FLASH_FLAG_BSY: FLASH write/erase operations in progress flag |
mbed_official | 130:1dec54e4aec3 | 1143 | * @arg FLASH_FLAG_PGERR: FLASH Programming error flag flag |
mbed_official | 130:1dec54e4aec3 | 1144 | * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag |
mbed_official | 130:1dec54e4aec3 | 1145 | * @arg FLASH_FLAG_EOP: FLASH End of Programming flag |
mbed_official | 130:1dec54e4aec3 | 1146 | * @retval The new state of FLASH_FLAG (SET or RESET). |
mbed_official | 130:1dec54e4aec3 | 1147 | */ |
mbed_official | 130:1dec54e4aec3 | 1148 | FlagStatus FLASH_GetFlagStatus(uint32_t FLASH_FLAG) |
mbed_official | 130:1dec54e4aec3 | 1149 | { |
mbed_official | 130:1dec54e4aec3 | 1150 | FlagStatus bitstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 1151 | |
mbed_official | 130:1dec54e4aec3 | 1152 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 1153 | assert_param(IS_FLASH_GET_FLAG(FLASH_FLAG)); |
mbed_official | 130:1dec54e4aec3 | 1154 | |
mbed_official | 130:1dec54e4aec3 | 1155 | if((FLASH->SR & FLASH_FLAG) != (uint32_t)RESET) |
mbed_official | 130:1dec54e4aec3 | 1156 | { |
mbed_official | 130:1dec54e4aec3 | 1157 | bitstatus = SET; |
mbed_official | 130:1dec54e4aec3 | 1158 | } |
mbed_official | 130:1dec54e4aec3 | 1159 | else |
mbed_official | 130:1dec54e4aec3 | 1160 | { |
mbed_official | 130:1dec54e4aec3 | 1161 | bitstatus = RESET; |
mbed_official | 130:1dec54e4aec3 | 1162 | } |
mbed_official | 130:1dec54e4aec3 | 1163 | /* Return the new state of FLASH_FLAG (SET or RESET) */ |
mbed_official | 130:1dec54e4aec3 | 1164 | return bitstatus; |
mbed_official | 130:1dec54e4aec3 | 1165 | } |
mbed_official | 130:1dec54e4aec3 | 1166 | |
mbed_official | 130:1dec54e4aec3 | 1167 | /** |
mbed_official | 130:1dec54e4aec3 | 1168 | * @brief Clears the FLASH's pending flags. |
mbed_official | 130:1dec54e4aec3 | 1169 | * @param FLASH_FLAG: specifies the FLASH flags to clear. |
mbed_official | 130:1dec54e4aec3 | 1170 | * This parameter can be any combination of the following values: |
mbed_official | 130:1dec54e4aec3 | 1171 | * @arg FLASH_FLAG_PGERR: FLASH Programming error flag flag |
mbed_official | 130:1dec54e4aec3 | 1172 | * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag |
mbed_official | 130:1dec54e4aec3 | 1173 | * @arg FLASH_FLAG_EOP: FLASH End of Programming flag |
mbed_official | 130:1dec54e4aec3 | 1174 | * @retval None |
mbed_official | 130:1dec54e4aec3 | 1175 | */ |
mbed_official | 130:1dec54e4aec3 | 1176 | void FLASH_ClearFlag(uint32_t FLASH_FLAG) |
mbed_official | 130:1dec54e4aec3 | 1177 | { |
mbed_official | 130:1dec54e4aec3 | 1178 | /* Check the parameters */ |
mbed_official | 130:1dec54e4aec3 | 1179 | assert_param(IS_FLASH_CLEAR_FLAG(FLASH_FLAG)); |
mbed_official | 130:1dec54e4aec3 | 1180 | |
mbed_official | 130:1dec54e4aec3 | 1181 | /* Clear the flags */ |
mbed_official | 130:1dec54e4aec3 | 1182 | FLASH->SR = FLASH_FLAG; |
mbed_official | 130:1dec54e4aec3 | 1183 | } |
mbed_official | 130:1dec54e4aec3 | 1184 | |
mbed_official | 130:1dec54e4aec3 | 1185 | /** |
mbed_official | 130:1dec54e4aec3 | 1186 | * @brief Returns the FLASH Status. |
mbed_official | 130:1dec54e4aec3 | 1187 | * @param None |
mbed_official | 130:1dec54e4aec3 | 1188 | * @retval FLASH Status: The returned value can be: |
mbed_official | 130:1dec54e4aec3 | 1189 | * FLASH_BUSY, FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP or FLASH_COMPLETE. |
mbed_official | 130:1dec54e4aec3 | 1190 | */ |
mbed_official | 130:1dec54e4aec3 | 1191 | FLASH_Status FLASH_GetStatus(void) |
mbed_official | 130:1dec54e4aec3 | 1192 | { |
mbed_official | 130:1dec54e4aec3 | 1193 | FLASH_Status FLASHstatus = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 1194 | |
mbed_official | 130:1dec54e4aec3 | 1195 | if((FLASH->SR & FLASH_FLAG_BSY) == FLASH_FLAG_BSY) |
mbed_official | 130:1dec54e4aec3 | 1196 | { |
mbed_official | 130:1dec54e4aec3 | 1197 | FLASHstatus = FLASH_BUSY; |
mbed_official | 130:1dec54e4aec3 | 1198 | } |
mbed_official | 130:1dec54e4aec3 | 1199 | else |
mbed_official | 130:1dec54e4aec3 | 1200 | { |
mbed_official | 130:1dec54e4aec3 | 1201 | if((FLASH->SR & (uint32_t)FLASH_FLAG_WRPERR)!= (uint32_t)0x00) |
mbed_official | 130:1dec54e4aec3 | 1202 | { |
mbed_official | 130:1dec54e4aec3 | 1203 | FLASHstatus = FLASH_ERROR_WRP; |
mbed_official | 130:1dec54e4aec3 | 1204 | } |
mbed_official | 130:1dec54e4aec3 | 1205 | else |
mbed_official | 130:1dec54e4aec3 | 1206 | { |
mbed_official | 130:1dec54e4aec3 | 1207 | if((FLASH->SR & (uint32_t)(FLASH_SR_PGERR)) != (uint32_t)0x00) |
mbed_official | 130:1dec54e4aec3 | 1208 | { |
mbed_official | 130:1dec54e4aec3 | 1209 | FLASHstatus = FLASH_ERROR_PROGRAM; |
mbed_official | 130:1dec54e4aec3 | 1210 | } |
mbed_official | 130:1dec54e4aec3 | 1211 | else |
mbed_official | 130:1dec54e4aec3 | 1212 | { |
mbed_official | 130:1dec54e4aec3 | 1213 | FLASHstatus = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 1214 | } |
mbed_official | 130:1dec54e4aec3 | 1215 | } |
mbed_official | 130:1dec54e4aec3 | 1216 | } |
mbed_official | 130:1dec54e4aec3 | 1217 | /* Return the FLASH Status */ |
mbed_official | 130:1dec54e4aec3 | 1218 | return FLASHstatus; |
mbed_official | 130:1dec54e4aec3 | 1219 | } |
mbed_official | 130:1dec54e4aec3 | 1220 | |
mbed_official | 130:1dec54e4aec3 | 1221 | |
mbed_official | 130:1dec54e4aec3 | 1222 | /** |
mbed_official | 130:1dec54e4aec3 | 1223 | * @brief Waits for a FLASH operation to complete or a TIMEOUT to occur. |
mbed_official | 130:1dec54e4aec3 | 1224 | * @param Timeout: FLASH programming Timeout |
mbed_official | 130:1dec54e4aec3 | 1225 | * @retval FLASH Status: The returned value can be: FLASH_BUSY, |
mbed_official | 130:1dec54e4aec3 | 1226 | * FLASH_ERROR_PROGRAM, FLASH_ERROR_WRP, FLASH_COMPLETE or FLASH_TIMEOUT. |
mbed_official | 130:1dec54e4aec3 | 1227 | */ |
mbed_official | 130:1dec54e4aec3 | 1228 | FLASH_Status FLASH_WaitForLastOperation(uint32_t Timeout) |
mbed_official | 130:1dec54e4aec3 | 1229 | { |
mbed_official | 130:1dec54e4aec3 | 1230 | FLASH_Status status = FLASH_COMPLETE; |
mbed_official | 130:1dec54e4aec3 | 1231 | |
mbed_official | 130:1dec54e4aec3 | 1232 | /* Check for the FLASH Status */ |
mbed_official | 130:1dec54e4aec3 | 1233 | status = FLASH_GetStatus(); |
mbed_official | 130:1dec54e4aec3 | 1234 | |
mbed_official | 130:1dec54e4aec3 | 1235 | /* Wait for a FLASH operation to complete or a TIMEOUT to occur */ |
mbed_official | 130:1dec54e4aec3 | 1236 | while((status == FLASH_BUSY) && (Timeout != 0x00)) |
mbed_official | 130:1dec54e4aec3 | 1237 | { |
mbed_official | 130:1dec54e4aec3 | 1238 | status = FLASH_GetStatus(); |
mbed_official | 130:1dec54e4aec3 | 1239 | Timeout--; |
mbed_official | 130:1dec54e4aec3 | 1240 | } |
mbed_official | 130:1dec54e4aec3 | 1241 | |
mbed_official | 130:1dec54e4aec3 | 1242 | if(Timeout == 0x00 ) |
mbed_official | 130:1dec54e4aec3 | 1243 | { |
mbed_official | 130:1dec54e4aec3 | 1244 | status = FLASH_TIMEOUT; |
mbed_official | 130:1dec54e4aec3 | 1245 | } |
mbed_official | 130:1dec54e4aec3 | 1246 | /* Return the operation status */ |
mbed_official | 130:1dec54e4aec3 | 1247 | return status; |
mbed_official | 130:1dec54e4aec3 | 1248 | } |
mbed_official | 130:1dec54e4aec3 | 1249 | |
mbed_official | 130:1dec54e4aec3 | 1250 | /** |
mbed_official | 130:1dec54e4aec3 | 1251 | * @} |
mbed_official | 130:1dec54e4aec3 | 1252 | */ |
mbed_official | 130:1dec54e4aec3 | 1253 | |
mbed_official | 130:1dec54e4aec3 | 1254 | /** |
mbed_official | 130:1dec54e4aec3 | 1255 | * @} |
mbed_official | 130:1dec54e4aec3 | 1256 | */ |
mbed_official | 130:1dec54e4aec3 | 1257 | |
mbed_official | 130:1dec54e4aec3 | 1258 | /** |
mbed_official | 130:1dec54e4aec3 | 1259 | * @} |
mbed_official | 130:1dec54e4aec3 | 1260 | */ |
mbed_official | 130:1dec54e4aec3 | 1261 | |
mbed_official | 130:1dec54e4aec3 | 1262 | /** |
mbed_official | 130:1dec54e4aec3 | 1263 | * @} |
mbed_official | 130:1dec54e4aec3 | 1264 | */ |
mbed_official | 130:1dec54e4aec3 | 1265 | |
mbed_official | 130:1dec54e4aec3 | 1266 | /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |