robot

Dependencies:   FastPWM3 mbed

Committer:
bwang
Date:
Tue Nov 13 17:46:23 2018 +0000
Revision:
252:38644631ed97
Parent:
181:d3510c8beab6
11/13/2018 12:45 - hitting <return> on empty line prints "\r>", so that hitting enter after intially connecting to the controller generates a prompt

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bwang 181:d3510c8beab6 1 /**
bwang 181:d3510c8beab6 2 ******************************************************************************
bwang 181:d3510c8beab6 3 * @file stm32f4xx_flash.c
bwang 181:d3510c8beab6 4 * @author MCD Application Team
bwang 181:d3510c8beab6 5 * @version V1.7.1
bwang 181:d3510c8beab6 6 * @date 20-May-2016
bwang 181:d3510c8beab6 7 * @brief This file provides firmware functions to manage the following
bwang 181:d3510c8beab6 8 * functionalities of the FLASH peripheral:
bwang 181:d3510c8beab6 9 * + FLASH Interface configuration
bwang 181:d3510c8beab6 10 * + FLASH Memory Programming
bwang 181:d3510c8beab6 11 * + Option Bytes Programming
bwang 181:d3510c8beab6 12 * + Interrupts and flags management
bwang 181:d3510c8beab6 13 *
bwang 181:d3510c8beab6 14 @verbatim
bwang 181:d3510c8beab6 15 ===============================================================================
bwang 181:d3510c8beab6 16 ##### How to use this driver #####
bwang 181:d3510c8beab6 17 ===============================================================================
bwang 181:d3510c8beab6 18 [..]
bwang 181:d3510c8beab6 19 This driver provides functions to configure and program the FLASH memory
bwang 181:d3510c8beab6 20 of all STM32F4xx devices. These functions are split in 4 groups:
bwang 181:d3510c8beab6 21
bwang 181:d3510c8beab6 22 (#) FLASH Interface configuration functions: this group includes the
bwang 181:d3510c8beab6 23 management of the following features:
bwang 181:d3510c8beab6 24 (++) Set the latency
bwang 181:d3510c8beab6 25 (++) Enable/Disable the prefetch buffer
bwang 181:d3510c8beab6 26 (++) Enable/Disable the Instruction cache and the Data cache
bwang 181:d3510c8beab6 27 (++) Reset the Instruction cache and the Data cache
bwang 181:d3510c8beab6 28
bwang 181:d3510c8beab6 29 (#) FLASH Memory Programming functions: this group includes all needed
bwang 181:d3510c8beab6 30 functions to erase and program the main memory:
bwang 181:d3510c8beab6 31 (++) Lock and Unlock the FLASH interface
bwang 181:d3510c8beab6 32 (++) Erase function: Erase sector, erase all sectors
bwang 181:d3510c8beab6 33 (++) Program functions: byte, half word, word and double word
bwang 181:d3510c8beab6 34
bwang 181:d3510c8beab6 35 (#) Option Bytes Programming functions: this group includes all needed
bwang 181:d3510c8beab6 36 functions to manage the Option Bytes:
bwang 181:d3510c8beab6 37 (++) Set/Reset the write protection
bwang 181:d3510c8beab6 38 (++) Set the Read protection Level
bwang 181:d3510c8beab6 39 (++) Set the BOR level
bwang 181:d3510c8beab6 40 (++) Program the user Option Bytes
bwang 181:d3510c8beab6 41 (++) Launch the Option Bytes loader
bwang 181:d3510c8beab6 42
bwang 181:d3510c8beab6 43 (#) Interrupts and flags management functions: this group
bwang 181:d3510c8beab6 44 includes all needed functions to:
bwang 181:d3510c8beab6 45 (++) Enable/Disable the FLASH interrupt sources
bwang 181:d3510c8beab6 46 (++) Get flags status
bwang 181:d3510c8beab6 47 (++) Clear flags
bwang 181:d3510c8beab6 48 (++) Get FLASH operation status
bwang 181:d3510c8beab6 49 (++) Wait for last FLASH operation
bwang 181:d3510c8beab6 50 @endverbatim
bwang 181:d3510c8beab6 51 ******************************************************************************
bwang 181:d3510c8beab6 52 * @attention
bwang 181:d3510c8beab6 53 *
bwang 181:d3510c8beab6 54 * <h2><center>&copy; COPYRIGHT 2016 STMicroelectronics</center></h2>
bwang 181:d3510c8beab6 55 *
bwang 181:d3510c8beab6 56 * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
bwang 181:d3510c8beab6 57 * You may not use this file except in compliance with the License.
bwang 181:d3510c8beab6 58 * You may obtain a copy of the License at:
bwang 181:d3510c8beab6 59 *
bwang 181:d3510c8beab6 60 * http://www.st.com/software_license_agreement_liberty_v2
bwang 181:d3510c8beab6 61 *
bwang 181:d3510c8beab6 62 * Unless required by applicable law or agreed to in writing, software
bwang 181:d3510c8beab6 63 * distributed under the License is distributed on an "AS IS" BASIS,
bwang 181:d3510c8beab6 64 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bwang 181:d3510c8beab6 65 * See the License for the specific language governing permissions and
bwang 181:d3510c8beab6 66 * limitations under the License.
bwang 181:d3510c8beab6 67 *
bwang 181:d3510c8beab6 68 ******************************************************************************
bwang 181:d3510c8beab6 69 */
bwang 181:d3510c8beab6 70
bwang 181:d3510c8beab6 71 /* Includes ------------------------------------------------------------------*/
bwang 181:d3510c8beab6 72 #include "stm32f4xx_flash.h"
bwang 181:d3510c8beab6 73
bwang 181:d3510c8beab6 74 /** @addtogroup STM32F4xx_StdPeriph_Driver
bwang 181:d3510c8beab6 75 * @{
bwang 181:d3510c8beab6 76 */
bwang 181:d3510c8beab6 77
bwang 181:d3510c8beab6 78 /** @defgroup FLASH
bwang 181:d3510c8beab6 79 * @brief FLASH driver modules
bwang 181:d3510c8beab6 80 * @{
bwang 181:d3510c8beab6 81 */
bwang 181:d3510c8beab6 82
bwang 181:d3510c8beab6 83 /* Private typedef -----------------------------------------------------------*/
bwang 181:d3510c8beab6 84 /* Private define ------------------------------------------------------------*/
bwang 181:d3510c8beab6 85 #define SECTOR_MASK ((uint32_t)0xFFFFFF07)
bwang 181:d3510c8beab6 86
bwang 181:d3510c8beab6 87 /* Private macro -------------------------------------------------------------*/
bwang 181:d3510c8beab6 88 /* Private variables ---------------------------------------------------------*/
bwang 181:d3510c8beab6 89 /* Private function prototypes -----------------------------------------------*/
bwang 181:d3510c8beab6 90 /* Private functions ---------------------------------------------------------*/
bwang 181:d3510c8beab6 91
bwang 181:d3510c8beab6 92 /** @defgroup FLASH_Private_Functions
bwang 181:d3510c8beab6 93 * @{
bwang 181:d3510c8beab6 94 */
bwang 181:d3510c8beab6 95
bwang 181:d3510c8beab6 96 /** @defgroup FLASH_Group1 FLASH Interface configuration functions
bwang 181:d3510c8beab6 97 * @brief FLASH Interface configuration functions
bwang 181:d3510c8beab6 98 *
bwang 181:d3510c8beab6 99
bwang 181:d3510c8beab6 100 @verbatim
bwang 181:d3510c8beab6 101 ===============================================================================
bwang 181:d3510c8beab6 102 ##### FLASH Interface configuration functions #####
bwang 181:d3510c8beab6 103 ===============================================================================
bwang 181:d3510c8beab6 104 [..]
bwang 181:d3510c8beab6 105 This group includes the following functions:
bwang 181:d3510c8beab6 106 (+) void FLASH_SetLatency(uint32_t FLASH_Latency)
bwang 181:d3510c8beab6 107 To correctly read data from FLASH memory, the number of wait states (LATENCY)
bwang 181:d3510c8beab6 108 must be correctly programmed according to the frequency of the CPU clock
bwang 181:d3510c8beab6 109 (HCLK) and the supply voltage of the device.
bwang 181:d3510c8beab6 110 [..]
bwang 181:d3510c8beab6 111 For STM32F405xx/07xx and STM32F415xx/17xx devices
bwang 181:d3510c8beab6 112 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 113 | Latency | HCLK clock frequency (MHz) |
bwang 181:d3510c8beab6 114 | |---------------------------------------------------------------------|
bwang 181:d3510c8beab6 115 | | voltage range | voltage range | voltage range | voltage range |
bwang 181:d3510c8beab6 116 | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V |
bwang 181:d3510c8beab6 117 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 118 |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 |
bwang 181:d3510c8beab6 119 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 120 |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 |
bwang 181:d3510c8beab6 121 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 122 |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 |
bwang 181:d3510c8beab6 123 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 124 |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 |
bwang 181:d3510c8beab6 125 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 126 |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 |
bwang 181:d3510c8beab6 127 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 128 |5WS(6CPU cycle)|150< HCLK <= 168|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120|
bwang 181:d3510c8beab6 129 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 130 |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140|
bwang 181:d3510c8beab6 131 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 132 |7WS(8CPU cycle)| NA | NA |154 < HCLK <= 168|140 < HCLK <= 160|
bwang 181:d3510c8beab6 133 +---------------|----------------|----------------|-----------------|-----------------+
bwang 181:d3510c8beab6 134
bwang 181:d3510c8beab6 135 [..]
bwang 181:d3510c8beab6 136 For STM32F42xxx/43xxx devices
bwang 181:d3510c8beab6 137 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 138 | Latency | HCLK clock frequency (MHz) |
bwang 181:d3510c8beab6 139 | |---------------------------------------------------------------------|
bwang 181:d3510c8beab6 140 | | voltage range | voltage range | voltage range | voltage range |
bwang 181:d3510c8beab6 141 | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V |
bwang 181:d3510c8beab6 142 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 143 |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 |
bwang 181:d3510c8beab6 144 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 145 |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 |
bwang 181:d3510c8beab6 146 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 147 |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 |
bwang 181:d3510c8beab6 148 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 149 |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 |
bwang 181:d3510c8beab6 150 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 151 |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 |
bwang 181:d3510c8beab6 152 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 153 |5WS(6CPU cycle)|120< HCLK <= 180|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120|
bwang 181:d3510c8beab6 154 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 155 |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140|
bwang 181:d3510c8beab6 156 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 157 |7WS(8CPU cycle)| NA |168< HCLK <= 180|154 < HCLK <= 176|140 < HCLK <= 160|
bwang 181:d3510c8beab6 158 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 159 |8WS(9CPU cycle)| NA | NA |176 < HCLK <= 180|160 < HCLK <= 168|
bwang 181:d3510c8beab6 160 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 161
bwang 181:d3510c8beab6 162 [..]
bwang 181:d3510c8beab6 163 For STM32F401x devices
bwang 181:d3510c8beab6 164 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 165 | Latency | HCLK clock frequency (MHz) |
bwang 181:d3510c8beab6 166 | |---------------------------------------------------------------------|
bwang 181:d3510c8beab6 167 | | voltage range | voltage range | voltage range | voltage range |
bwang 181:d3510c8beab6 168 | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V |
bwang 181:d3510c8beab6 169 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 170 |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 |
bwang 181:d3510c8beab6 171 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 172 |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 |
bwang 181:d3510c8beab6 173 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 174 |2WS(3CPU cycle)|60 < HCLK <= 84 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 |
bwang 181:d3510c8beab6 175 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 176 |3WS(4CPU cycle)| NA |72 < HCLK <= 84 |66 < HCLK <= 84 |60 < HCLK <= 80 |
bwang 181:d3510c8beab6 177 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 178 |4WS(5CPU cycle)| NA | NA | NA |80 < HCLK <= 84 |
bwang 181:d3510c8beab6 179 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 180
bwang 181:d3510c8beab6 181 [..]
bwang 181:d3510c8beab6 182 For STM32F410xx/STM32F411xE devices
bwang 181:d3510c8beab6 183 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 184 | Latency | HCLK clock frequency (MHz) |
bwang 181:d3510c8beab6 185 | |---------------------------------------------------------------------|
bwang 181:d3510c8beab6 186 | | voltage range | voltage range | voltage range | voltage range |
bwang 181:d3510c8beab6 187 | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V |
bwang 181:d3510c8beab6 188 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 189 |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 18 |0 < HCLK <= 16 |
bwang 181:d3510c8beab6 190 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 191 |1WS(2CPU cycle)|30 < HCLK <= 64 |24 < HCLK <= 48 |18 < HCLK <= 36 |16 < HCLK <= 32 |
bwang 181:d3510c8beab6 192 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 193 |2WS(3CPU cycle)|64 < HCLK <= 90 |48 < HCLK <= 72 |36 < HCLK <= 54 |32 < HCLK <= 48 |
bwang 181:d3510c8beab6 194 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 195 |3WS(4CPU cycle)|90 < HCLK <= 100|72 < HCLK <= 96 |54 < HCLK <= 72 |48 < HCLK <= 64 |
bwang 181:d3510c8beab6 196 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 197 |4WS(5CPU cycle)| NA |96 < HCLK <= 100|72 < HCLK <= 90 |64 < HCLK <= 80 |
bwang 181:d3510c8beab6 198 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 199 |5WS(6CPU cycle)| NA | NA |90 < HCLK <= 100 |80 < HCLK <= 96 |
bwang 181:d3510c8beab6 200 |---------------|----------------|----------------|-----------------|-----------------|
bwang 181:d3510c8beab6 201 |6WS(7CPU cycle)| NA | NA | NA |96 < HCLK <= 100 |
bwang 181:d3510c8beab6 202 +-------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 203
bwang 181:d3510c8beab6 204 [..]
bwang 181:d3510c8beab6 205 +-------------------------------------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 206 | | voltage range | voltage range | voltage range | voltage range | voltage range 2.7 V - 3.6 V |
bwang 181:d3510c8beab6 207 | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | with External Vpp = 9V |
bwang 181:d3510c8beab6 208 |---------------|----------------|----------------|-----------------|-----------------|-----------------------------|
bwang 181:d3510c8beab6 209 |Max Parallelism| x32 | x16 | x8 | x64 |
bwang 181:d3510c8beab6 210 |---------------|----------------|----------------|-----------------|-----------------|-----------------------------|
bwang 181:d3510c8beab6 211 |PSIZE[1:0] | 10 | 01 | 00 | 11 |
bwang 181:d3510c8beab6 212 +-------------------------------------------------------------------------------------------------------------------+
bwang 181:d3510c8beab6 213
bwang 181:d3510c8beab6 214 -@- On STM32F405xx/407xx and STM32F415xx/417xx devices:
bwang 181:d3510c8beab6 215 (++) when VOS = '0' Scale 2 mode, the maximum value of fHCLK = 144MHz.
bwang 181:d3510c8beab6 216 (++) when VOS = '1' Scale 1 mode, the maximum value of fHCLK = 168MHz.
bwang 181:d3510c8beab6 217 [..]
bwang 181:d3510c8beab6 218 On STM32F42xxx/43xxx devices:
bwang 181:d3510c8beab6 219 (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 120MHz.
bwang 181:d3510c8beab6 220 (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 144MHz if OverDrive OFF and 168MHz if OverDrive ON.
bwang 181:d3510c8beab6 221 (++) when VOS[1:0] = '0x11' Scale 1 mode, the maximum value of fHCLK is 168MHz if OverDrive OFF and 180MHz if OverDrive ON.
bwang 181:d3510c8beab6 222 [..]
bwang 181:d3510c8beab6 223 On STM32F401x devices:
bwang 181:d3510c8beab6 224 (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 60MHz.
bwang 181:d3510c8beab6 225 (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 84MHz.
bwang 181:d3510c8beab6 226 [..]
bwang 181:d3510c8beab6 227 On STM32F410xx/STM32F411xE devices:
bwang 181:d3510c8beab6 228 (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 64MHz.
bwang 181:d3510c8beab6 229 (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 84MHz.
bwang 181:d3510c8beab6 230 (++) when VOS[1:0] = '0x11' Scale 1 mode, the maximum value of fHCLK is 100MHz.
bwang 181:d3510c8beab6 231
bwang 181:d3510c8beab6 232 For more details please refer product DataSheet
bwang 181:d3510c8beab6 233 You can use PWR_MainRegulatorModeConfig() function to control VOS bits.
bwang 181:d3510c8beab6 234
bwang 181:d3510c8beab6 235 (+) void FLASH_PrefetchBufferCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 236 (+) void FLASH_InstructionCacheCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 237 (+) void FLASH_DataCacheCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 238 (+) void FLASH_InstructionCacheReset(void)
bwang 181:d3510c8beab6 239 (+) void FLASH_DataCacheReset(void)
bwang 181:d3510c8beab6 240
bwang 181:d3510c8beab6 241 [..]
bwang 181:d3510c8beab6 242 The unlock sequence is not needed for these functions.
bwang 181:d3510c8beab6 243
bwang 181:d3510c8beab6 244 @endverbatim
bwang 181:d3510c8beab6 245 * @{
bwang 181:d3510c8beab6 246 */
bwang 181:d3510c8beab6 247
bwang 181:d3510c8beab6 248 /**
bwang 181:d3510c8beab6 249 * @brief Sets the code latency value.
bwang 181:d3510c8beab6 250 * @param FLASH_Latency: specifies the FLASH Latency value.
bwang 181:d3510c8beab6 251 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 252 * @arg FLASH_Latency_0: FLASH Zero Latency cycle
bwang 181:d3510c8beab6 253 * @arg FLASH_Latency_1: FLASH One Latency cycle
bwang 181:d3510c8beab6 254 * @arg FLASH_Latency_2: FLASH Two Latency cycles
bwang 181:d3510c8beab6 255 * @arg FLASH_Latency_3: FLASH Three Latency cycles
bwang 181:d3510c8beab6 256 * @arg FLASH_Latency_4: FLASH Four Latency cycles
bwang 181:d3510c8beab6 257 * @arg FLASH_Latency_5: FLASH Five Latency cycles
bwang 181:d3510c8beab6 258 * @arg FLASH_Latency_6: FLASH Six Latency cycles
bwang 181:d3510c8beab6 259 * @arg FLASH_Latency_7: FLASH Seven Latency cycles
bwang 181:d3510c8beab6 260 * @arg FLASH_Latency_8: FLASH Eight Latency cycles
bwang 181:d3510c8beab6 261 * @arg FLASH_Latency_9: FLASH Nine Latency cycles
bwang 181:d3510c8beab6 262 * @arg FLASH_Latency_10: FLASH Teen Latency cycles
bwang 181:d3510c8beab6 263 * @arg FLASH_Latency_11: FLASH Eleven Latency cycles
bwang 181:d3510c8beab6 264 * @arg FLASH_Latency_12: FLASH Twelve Latency cycles
bwang 181:d3510c8beab6 265 * @arg FLASH_Latency_13: FLASH Thirteen Latency cycles
bwang 181:d3510c8beab6 266 * @arg FLASH_Latency_14: FLASH Fourteen Latency cycles
bwang 181:d3510c8beab6 267 * @arg FLASH_Latency_15: FLASH Fifteen Latency cycles
bwang 181:d3510c8beab6 268 *
bwang 181:d3510c8beab6 269 * @note For STM32F405xx/407xx, STM32F415xx/417xx, STM32F401xx/411xE and STM32F412xG devices
bwang 181:d3510c8beab6 270 * this parameter can be a value between FLASH_Latency_0 and FLASH_Latency_7.
bwang 181:d3510c8beab6 271 *
bwang 181:d3510c8beab6 272 * @note For STM32F42xxx/43xxx devices this parameter can be a value between
bwang 181:d3510c8beab6 273 * FLASH_Latency_0 and FLASH_Latency_15.
bwang 181:d3510c8beab6 274 *
bwang 181:d3510c8beab6 275 * @retval None
bwang 181:d3510c8beab6 276 */
bwang 181:d3510c8beab6 277 void FLASH_SetLatency(uint32_t FLASH_Latency)
bwang 181:d3510c8beab6 278 {
bwang 181:d3510c8beab6 279 /* Check the parameters */
bwang 181:d3510c8beab6 280 assert_param(IS_FLASH_LATENCY(FLASH_Latency));
bwang 181:d3510c8beab6 281
bwang 181:d3510c8beab6 282 /* Perform Byte access to FLASH_ACR[8:0] to set the Latency value */
bwang 181:d3510c8beab6 283 *(__IO uint8_t *)ACR_BYTE0_ADDRESS = (uint8_t)FLASH_Latency;
bwang 181:d3510c8beab6 284 }
bwang 181:d3510c8beab6 285
bwang 181:d3510c8beab6 286 /**
bwang 181:d3510c8beab6 287 * @brief Enables or disables the Prefetch Buffer.
bwang 181:d3510c8beab6 288 * @param NewState: new state of the Prefetch Buffer.
bwang 181:d3510c8beab6 289 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 290 * @retval None
bwang 181:d3510c8beab6 291 */
bwang 181:d3510c8beab6 292 void FLASH_PrefetchBufferCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 293 {
bwang 181:d3510c8beab6 294 /* Check the parameters */
bwang 181:d3510c8beab6 295 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 296
bwang 181:d3510c8beab6 297 /* Enable or disable the Prefetch Buffer */
bwang 181:d3510c8beab6 298 if(NewState != DISABLE)
bwang 181:d3510c8beab6 299 {
bwang 181:d3510c8beab6 300 FLASH->ACR |= FLASH_ACR_PRFTEN;
bwang 181:d3510c8beab6 301 }
bwang 181:d3510c8beab6 302 else
bwang 181:d3510c8beab6 303 {
bwang 181:d3510c8beab6 304 FLASH->ACR &= (~FLASH_ACR_PRFTEN);
bwang 181:d3510c8beab6 305 }
bwang 181:d3510c8beab6 306 }
bwang 181:d3510c8beab6 307
bwang 181:d3510c8beab6 308 /**
bwang 181:d3510c8beab6 309 * @brief Enables or disables the Instruction Cache feature.
bwang 181:d3510c8beab6 310 * @param NewState: new state of the Instruction Cache.
bwang 181:d3510c8beab6 311 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 312 * @retval None
bwang 181:d3510c8beab6 313 */
bwang 181:d3510c8beab6 314 void FLASH_InstructionCacheCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 315 {
bwang 181:d3510c8beab6 316 /* Check the parameters */
bwang 181:d3510c8beab6 317 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 318
bwang 181:d3510c8beab6 319 if(NewState != DISABLE)
bwang 181:d3510c8beab6 320 {
bwang 181:d3510c8beab6 321 FLASH->ACR |= FLASH_ACR_ICEN;
bwang 181:d3510c8beab6 322 }
bwang 181:d3510c8beab6 323 else
bwang 181:d3510c8beab6 324 {
bwang 181:d3510c8beab6 325 FLASH->ACR &= (~FLASH_ACR_ICEN);
bwang 181:d3510c8beab6 326 }
bwang 181:d3510c8beab6 327 }
bwang 181:d3510c8beab6 328
bwang 181:d3510c8beab6 329 /**
bwang 181:d3510c8beab6 330 * @brief Enables or disables the Data Cache feature.
bwang 181:d3510c8beab6 331 * @param NewState: new state of the Data Cache.
bwang 181:d3510c8beab6 332 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 333 * @retval None
bwang 181:d3510c8beab6 334 */
bwang 181:d3510c8beab6 335 void FLASH_DataCacheCmd(FunctionalState NewState)
bwang 181:d3510c8beab6 336 {
bwang 181:d3510c8beab6 337 /* Check the parameters */
bwang 181:d3510c8beab6 338 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 339
bwang 181:d3510c8beab6 340 if(NewState != DISABLE)
bwang 181:d3510c8beab6 341 {
bwang 181:d3510c8beab6 342 FLASH->ACR |= FLASH_ACR_DCEN;
bwang 181:d3510c8beab6 343 }
bwang 181:d3510c8beab6 344 else
bwang 181:d3510c8beab6 345 {
bwang 181:d3510c8beab6 346 FLASH->ACR &= (~FLASH_ACR_DCEN);
bwang 181:d3510c8beab6 347 }
bwang 181:d3510c8beab6 348 }
bwang 181:d3510c8beab6 349
bwang 181:d3510c8beab6 350 /**
bwang 181:d3510c8beab6 351 * @brief Resets the Instruction Cache.
bwang 181:d3510c8beab6 352 * @note This function must be used only when the Instruction Cache is disabled.
bwang 181:d3510c8beab6 353 * @param None
bwang 181:d3510c8beab6 354 * @retval None
bwang 181:d3510c8beab6 355 */
bwang 181:d3510c8beab6 356 void FLASH_InstructionCacheReset(void)
bwang 181:d3510c8beab6 357 {
bwang 181:d3510c8beab6 358 FLASH->ACR |= FLASH_ACR_ICRST;
bwang 181:d3510c8beab6 359 }
bwang 181:d3510c8beab6 360
bwang 181:d3510c8beab6 361 /**
bwang 181:d3510c8beab6 362 * @brief Resets the Data Cache.
bwang 181:d3510c8beab6 363 * @note This function must be used only when the Data Cache is disabled.
bwang 181:d3510c8beab6 364 * @param None
bwang 181:d3510c8beab6 365 * @retval None
bwang 181:d3510c8beab6 366 */
bwang 181:d3510c8beab6 367 void FLASH_DataCacheReset(void)
bwang 181:d3510c8beab6 368 {
bwang 181:d3510c8beab6 369 FLASH->ACR |= FLASH_ACR_DCRST;
bwang 181:d3510c8beab6 370 }
bwang 181:d3510c8beab6 371
bwang 181:d3510c8beab6 372 /**
bwang 181:d3510c8beab6 373 * @}
bwang 181:d3510c8beab6 374 */
bwang 181:d3510c8beab6 375
bwang 181:d3510c8beab6 376 /** @defgroup FLASH_Group2 FLASH Memory Programming functions
bwang 181:d3510c8beab6 377 * @brief FLASH Memory Programming functions
bwang 181:d3510c8beab6 378 *
bwang 181:d3510c8beab6 379 @verbatim
bwang 181:d3510c8beab6 380 ===============================================================================
bwang 181:d3510c8beab6 381 ##### FLASH Memory Programming functions #####
bwang 181:d3510c8beab6 382 ===============================================================================
bwang 181:d3510c8beab6 383 [..]
bwang 181:d3510c8beab6 384 This group includes the following functions:
bwang 181:d3510c8beab6 385 (+) void FLASH_Unlock(void)
bwang 181:d3510c8beab6 386 (+) void FLASH_Lock(void)
bwang 181:d3510c8beab6 387 (+) FLASH_Status FLASH_EraseSector(uint32_t FLASH_Sector, uint8_t VoltageRange)
bwang 181:d3510c8beab6 388 (+) FLASH_Status FLASH_EraseAllSectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 389 (+) FLASH_Status FLASH_ProgramDoubleWord(uint32_t Address, uint64_t Data)
bwang 181:d3510c8beab6 390 (+) FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data)
bwang 181:d3510c8beab6 391 (+) FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data)
bwang 181:d3510c8beab6 392 (+) FLASH_Status FLASH_ProgramByte(uint32_t Address, uint8_t Data)
bwang 181:d3510c8beab6 393 The following functions can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 394 (+) FLASH_Status FLASH_EraseAllBank1Sectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 395 (+) FLASH_Status FLASH_EraseAllBank2Sectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 396 [..]
bwang 181:d3510c8beab6 397 Any operation of erase or program should follow these steps:
bwang 181:d3510c8beab6 398 (#) Call the FLASH_Unlock() function to enable the FLASH control register access
bwang 181:d3510c8beab6 399
bwang 181:d3510c8beab6 400 (#) Call the desired function to erase sector(s) or program data
bwang 181:d3510c8beab6 401
bwang 181:d3510c8beab6 402 (#) Call the FLASH_Lock() function to disable the FLASH control register access
bwang 181:d3510c8beab6 403 (recommended to protect the FLASH memory against possible unwanted operation)
bwang 181:d3510c8beab6 404
bwang 181:d3510c8beab6 405 @endverbatim
bwang 181:d3510c8beab6 406 * @{
bwang 181:d3510c8beab6 407 */
bwang 181:d3510c8beab6 408
bwang 181:d3510c8beab6 409 /**
bwang 181:d3510c8beab6 410 * @brief Unlocks the FLASH control register access
bwang 181:d3510c8beab6 411 * @param None
bwang 181:d3510c8beab6 412 * @retval None
bwang 181:d3510c8beab6 413 */
bwang 181:d3510c8beab6 414 void FLASH_Unlock(void)
bwang 181:d3510c8beab6 415 {
bwang 181:d3510c8beab6 416 if((FLASH->CR & FLASH_CR_LOCK) != RESET)
bwang 181:d3510c8beab6 417 {
bwang 181:d3510c8beab6 418 /* Authorize the FLASH Registers access */
bwang 181:d3510c8beab6 419 FLASH->KEYR = FLASH_KEY1;
bwang 181:d3510c8beab6 420 FLASH->KEYR = FLASH_KEY2;
bwang 181:d3510c8beab6 421 }
bwang 181:d3510c8beab6 422 }
bwang 181:d3510c8beab6 423
bwang 181:d3510c8beab6 424 /**
bwang 181:d3510c8beab6 425 * @brief Locks the FLASH control register access
bwang 181:d3510c8beab6 426 * @param None
bwang 181:d3510c8beab6 427 * @retval None
bwang 181:d3510c8beab6 428 */
bwang 181:d3510c8beab6 429 void FLASH_Lock(void)
bwang 181:d3510c8beab6 430 {
bwang 181:d3510c8beab6 431 /* Set the LOCK Bit to lock the FLASH Registers access */
bwang 181:d3510c8beab6 432 FLASH->CR |= FLASH_CR_LOCK;
bwang 181:d3510c8beab6 433 }
bwang 181:d3510c8beab6 434
bwang 181:d3510c8beab6 435 /**
bwang 181:d3510c8beab6 436 * @brief Erases a specified FLASH Sector.
bwang 181:d3510c8beab6 437 *
bwang 181:d3510c8beab6 438 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 439 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 440 *
bwang 181:d3510c8beab6 441 * @param FLASH_Sector: The Sector number to be erased.
bwang 181:d3510c8beab6 442 *
bwang 181:d3510c8beab6 443 * @note For STM32F405xx/407xx and STM32F415xx/417xx devices this parameter can
bwang 181:d3510c8beab6 444 * be a value between FLASH_Sector_0 and FLASH_Sector_11.
bwang 181:d3510c8beab6 445 *
bwang 181:d3510c8beab6 446 * For STM32F42xxx/43xxx devices this parameter can be a value between
bwang 181:d3510c8beab6 447 * FLASH_Sector_0 and FLASH_Sector_23.
bwang 181:d3510c8beab6 448 *
bwang 181:d3510c8beab6 449 * For STM32F401xx devices this parameter can be a value between
bwang 181:d3510c8beab6 450 * FLASH_Sector_0 and FLASH_Sector_5.
bwang 181:d3510c8beab6 451 *
bwang 181:d3510c8beab6 452 * For STM32F411xE and STM32F412xG devices this parameter can be a value between
bwang 181:d3510c8beab6 453 * FLASH_Sector_0 and FLASH_Sector_7.
bwang 181:d3510c8beab6 454 *
bwang 181:d3510c8beab6 455 * For STM32F410xx devices this parameter can be a value between
bwang 181:d3510c8beab6 456 * FLASH_Sector_0 and FLASH_Sector_4.
bwang 181:d3510c8beab6 457 *
bwang 181:d3510c8beab6 458 * @param VoltageRange: The device voltage range which defines the erase parallelism.
bwang 181:d3510c8beab6 459 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 460 * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V,
bwang 181:d3510c8beab6 461 * the operation will be done by byte (8-bit)
bwang 181:d3510c8beab6 462 * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V,
bwang 181:d3510c8beab6 463 * the operation will be done by half word (16-bit)
bwang 181:d3510c8beab6 464 * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V,
bwang 181:d3510c8beab6 465 * the operation will be done by word (32-bit)
bwang 181:d3510c8beab6 466 * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp,
bwang 181:d3510c8beab6 467 * the operation will be done by double word (64-bit)
bwang 181:d3510c8beab6 468 *
bwang 181:d3510c8beab6 469 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 470 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 471 */
bwang 181:d3510c8beab6 472 FLASH_Status FLASH_EraseSector(uint32_t FLASH_Sector, uint8_t VoltageRange)
bwang 181:d3510c8beab6 473 {
bwang 181:d3510c8beab6 474 uint32_t tmp_psize = 0x0;
bwang 181:d3510c8beab6 475 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 476
bwang 181:d3510c8beab6 477 /* Check the parameters */
bwang 181:d3510c8beab6 478 assert_param(IS_FLASH_SECTOR(FLASH_Sector));
bwang 181:d3510c8beab6 479 assert_param(IS_VOLTAGERANGE(VoltageRange));
bwang 181:d3510c8beab6 480
bwang 181:d3510c8beab6 481 if(VoltageRange == VoltageRange_1)
bwang 181:d3510c8beab6 482 {
bwang 181:d3510c8beab6 483 tmp_psize = FLASH_PSIZE_BYTE;
bwang 181:d3510c8beab6 484 }
bwang 181:d3510c8beab6 485 else if(VoltageRange == VoltageRange_2)
bwang 181:d3510c8beab6 486 {
bwang 181:d3510c8beab6 487 tmp_psize = FLASH_PSIZE_HALF_WORD;
bwang 181:d3510c8beab6 488 }
bwang 181:d3510c8beab6 489 else if(VoltageRange == VoltageRange_3)
bwang 181:d3510c8beab6 490 {
bwang 181:d3510c8beab6 491 tmp_psize = FLASH_PSIZE_WORD;
bwang 181:d3510c8beab6 492 }
bwang 181:d3510c8beab6 493 else
bwang 181:d3510c8beab6 494 {
bwang 181:d3510c8beab6 495 tmp_psize = FLASH_PSIZE_DOUBLE_WORD;
bwang 181:d3510c8beab6 496 }
bwang 181:d3510c8beab6 497 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 498 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 499
bwang 181:d3510c8beab6 500 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 501 {
bwang 181:d3510c8beab6 502 /* if the previous operation is completed, proceed to erase the sector */
bwang 181:d3510c8beab6 503 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 504 FLASH->CR |= tmp_psize;
bwang 181:d3510c8beab6 505 FLASH->CR &= SECTOR_MASK;
bwang 181:d3510c8beab6 506 FLASH->CR |= FLASH_CR_SER | FLASH_Sector;
bwang 181:d3510c8beab6 507 FLASH->CR |= FLASH_CR_STRT;
bwang 181:d3510c8beab6 508
bwang 181:d3510c8beab6 509 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 510 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 511
bwang 181:d3510c8beab6 512 /* if the erase operation is completed, disable the SER Bit */
bwang 181:d3510c8beab6 513 FLASH->CR &= (~FLASH_CR_SER);
bwang 181:d3510c8beab6 514 FLASH->CR &= SECTOR_MASK;
bwang 181:d3510c8beab6 515 }
bwang 181:d3510c8beab6 516 /* Return the Erase Status */
bwang 181:d3510c8beab6 517 return status;
bwang 181:d3510c8beab6 518 }
bwang 181:d3510c8beab6 519
bwang 181:d3510c8beab6 520 /**
bwang 181:d3510c8beab6 521 * @brief Erases all FLASH Sectors.
bwang 181:d3510c8beab6 522 *
bwang 181:d3510c8beab6 523 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 524 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 525 *
bwang 181:d3510c8beab6 526 * @param VoltageRange: The device voltage range which defines the erase parallelism.
bwang 181:d3510c8beab6 527 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 528 * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V,
bwang 181:d3510c8beab6 529 * the operation will be done by byte (8-bit)
bwang 181:d3510c8beab6 530 * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V,
bwang 181:d3510c8beab6 531 * the operation will be done by half word (16-bit)
bwang 181:d3510c8beab6 532 * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V,
bwang 181:d3510c8beab6 533 * the operation will be done by word (32-bit)
bwang 181:d3510c8beab6 534 * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp,
bwang 181:d3510c8beab6 535 * the operation will be done by double word (64-bit)
bwang 181:d3510c8beab6 536 *
bwang 181:d3510c8beab6 537 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 538 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 539 */
bwang 181:d3510c8beab6 540 FLASH_Status FLASH_EraseAllSectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 541 {
bwang 181:d3510c8beab6 542 uint32_t tmp_psize = 0x0;
bwang 181:d3510c8beab6 543 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 544
bwang 181:d3510c8beab6 545 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 546 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 547 assert_param(IS_VOLTAGERANGE(VoltageRange));
bwang 181:d3510c8beab6 548
bwang 181:d3510c8beab6 549 if(VoltageRange == VoltageRange_1)
bwang 181:d3510c8beab6 550 {
bwang 181:d3510c8beab6 551 tmp_psize = FLASH_PSIZE_BYTE;
bwang 181:d3510c8beab6 552 }
bwang 181:d3510c8beab6 553 else if(VoltageRange == VoltageRange_2)
bwang 181:d3510c8beab6 554 {
bwang 181:d3510c8beab6 555 tmp_psize = FLASH_PSIZE_HALF_WORD;
bwang 181:d3510c8beab6 556 }
bwang 181:d3510c8beab6 557 else if(VoltageRange == VoltageRange_3)
bwang 181:d3510c8beab6 558 {
bwang 181:d3510c8beab6 559 tmp_psize = FLASH_PSIZE_WORD;
bwang 181:d3510c8beab6 560 }
bwang 181:d3510c8beab6 561 else
bwang 181:d3510c8beab6 562 {
bwang 181:d3510c8beab6 563 tmp_psize = FLASH_PSIZE_DOUBLE_WORD;
bwang 181:d3510c8beab6 564 }
bwang 181:d3510c8beab6 565 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 566 {
bwang 181:d3510c8beab6 567 /* if the previous operation is completed, proceed to erase all sectors */
bwang 181:d3510c8beab6 568 #if defined(STM32F427_437xx) || defined(STM32F429_439xx) || defined(STM32F469_479xx)
bwang 181:d3510c8beab6 569 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 570 FLASH->CR |= tmp_psize;
bwang 181:d3510c8beab6 571 FLASH->CR |= (FLASH_CR_MER1 | FLASH_CR_MER2);
bwang 181:d3510c8beab6 572 FLASH->CR |= FLASH_CR_STRT;
bwang 181:d3510c8beab6 573
bwang 181:d3510c8beab6 574 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 575 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 576
bwang 181:d3510c8beab6 577 /* if the erase operation is completed, disable the MER Bit */
bwang 181:d3510c8beab6 578 FLASH->CR &= ~(FLASH_CR_MER1 | FLASH_CR_MER2);
bwang 181:d3510c8beab6 579 #endif /* STM32F427_437xx || STM32F429_439xx || STM32F469_479xx */
bwang 181:d3510c8beab6 580
bwang 181:d3510c8beab6 581 #if defined(STM32F40_41xxx) || defined(STM32F401xx) || defined(STM32F410xx) || defined(STM32F411xE) || defined(STM32F412xG) || defined(STM32F446xx)
bwang 181:d3510c8beab6 582 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 583 FLASH->CR |= tmp_psize;
bwang 181:d3510c8beab6 584 FLASH->CR |= FLASH_CR_MER;
bwang 181:d3510c8beab6 585 FLASH->CR |= FLASH_CR_STRT;
bwang 181:d3510c8beab6 586
bwang 181:d3510c8beab6 587 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 588 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 589
bwang 181:d3510c8beab6 590 /* if the erase operation is completed, disable the MER Bit */
bwang 181:d3510c8beab6 591 FLASH->CR &= (~FLASH_CR_MER);
bwang 181:d3510c8beab6 592 #endif /* STM32F40_41xxx || STM32F401xx || STM32F410xx || STM32F411xE || STM32F412xG || STM32F446xx */
bwang 181:d3510c8beab6 593
bwang 181:d3510c8beab6 594 }
bwang 181:d3510c8beab6 595 /* Return the Erase Status */
bwang 181:d3510c8beab6 596 return status;
bwang 181:d3510c8beab6 597 }
bwang 181:d3510c8beab6 598
bwang 181:d3510c8beab6 599 /**
bwang 181:d3510c8beab6 600 * @brief Erases all FLASH Sectors in Bank 1.
bwang 181:d3510c8beab6 601 *
bwang 181:d3510c8beab6 602 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 603 *
bwang 181:d3510c8beab6 604 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 605 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 606 *
bwang 181:d3510c8beab6 607 * @param VoltageRange: The device voltage range which defines the erase parallelism.
bwang 181:d3510c8beab6 608 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 609 * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V,
bwang 181:d3510c8beab6 610 * the operation will be done by byte (8-bit)
bwang 181:d3510c8beab6 611 * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V,
bwang 181:d3510c8beab6 612 * the operation will be done by half word (16-bit)
bwang 181:d3510c8beab6 613 * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V,
bwang 181:d3510c8beab6 614 * the operation will be done by word (32-bit)
bwang 181:d3510c8beab6 615 * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp,
bwang 181:d3510c8beab6 616 * the operation will be done by double word (64-bit)
bwang 181:d3510c8beab6 617 *
bwang 181:d3510c8beab6 618 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 619 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 620 */
bwang 181:d3510c8beab6 621 FLASH_Status FLASH_EraseAllBank1Sectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 622 {
bwang 181:d3510c8beab6 623 uint32_t tmp_psize = 0x0;
bwang 181:d3510c8beab6 624 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 625
bwang 181:d3510c8beab6 626 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 627 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 628 assert_param(IS_VOLTAGERANGE(VoltageRange));
bwang 181:d3510c8beab6 629
bwang 181:d3510c8beab6 630 if(VoltageRange == VoltageRange_1)
bwang 181:d3510c8beab6 631 {
bwang 181:d3510c8beab6 632 tmp_psize = FLASH_PSIZE_BYTE;
bwang 181:d3510c8beab6 633 }
bwang 181:d3510c8beab6 634 else if(VoltageRange == VoltageRange_2)
bwang 181:d3510c8beab6 635 {
bwang 181:d3510c8beab6 636 tmp_psize = FLASH_PSIZE_HALF_WORD;
bwang 181:d3510c8beab6 637 }
bwang 181:d3510c8beab6 638 else if(VoltageRange == VoltageRange_3)
bwang 181:d3510c8beab6 639 {
bwang 181:d3510c8beab6 640 tmp_psize = FLASH_PSIZE_WORD;
bwang 181:d3510c8beab6 641 }
bwang 181:d3510c8beab6 642 else
bwang 181:d3510c8beab6 643 {
bwang 181:d3510c8beab6 644 tmp_psize = FLASH_PSIZE_DOUBLE_WORD;
bwang 181:d3510c8beab6 645 }
bwang 181:d3510c8beab6 646 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 647 {
bwang 181:d3510c8beab6 648 /* if the previous operation is completed, proceed to erase all sectors */
bwang 181:d3510c8beab6 649 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 650 FLASH->CR |= tmp_psize;
bwang 181:d3510c8beab6 651 FLASH->CR |= FLASH_CR_MER1;
bwang 181:d3510c8beab6 652 FLASH->CR |= FLASH_CR_STRT;
bwang 181:d3510c8beab6 653
bwang 181:d3510c8beab6 654 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 655 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 656
bwang 181:d3510c8beab6 657 /* if the erase operation is completed, disable the MER Bit */
bwang 181:d3510c8beab6 658 FLASH->CR &= (~FLASH_CR_MER1);
bwang 181:d3510c8beab6 659
bwang 181:d3510c8beab6 660 }
bwang 181:d3510c8beab6 661 /* Return the Erase Status */
bwang 181:d3510c8beab6 662 return status;
bwang 181:d3510c8beab6 663 }
bwang 181:d3510c8beab6 664
bwang 181:d3510c8beab6 665
bwang 181:d3510c8beab6 666 /**
bwang 181:d3510c8beab6 667 * @brief Erases all FLASH Sectors in Bank 2.
bwang 181:d3510c8beab6 668 *
bwang 181:d3510c8beab6 669 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 670 *
bwang 181:d3510c8beab6 671 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 672 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 673 *
bwang 181:d3510c8beab6 674 * @param VoltageRange: The device voltage range which defines the erase parallelism.
bwang 181:d3510c8beab6 675 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 676 * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V,
bwang 181:d3510c8beab6 677 * the operation will be done by byte (8-bit)
bwang 181:d3510c8beab6 678 * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V,
bwang 181:d3510c8beab6 679 * the operation will be done by half word (16-bit)
bwang 181:d3510c8beab6 680 * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V,
bwang 181:d3510c8beab6 681 * the operation will be done by word (32-bit)
bwang 181:d3510c8beab6 682 * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp,
bwang 181:d3510c8beab6 683 * the operation will be done by double word (64-bit)
bwang 181:d3510c8beab6 684 *
bwang 181:d3510c8beab6 685 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 686 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 687 */
bwang 181:d3510c8beab6 688 FLASH_Status FLASH_EraseAllBank2Sectors(uint8_t VoltageRange)
bwang 181:d3510c8beab6 689 {
bwang 181:d3510c8beab6 690 uint32_t tmp_psize = 0x0;
bwang 181:d3510c8beab6 691 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 692
bwang 181:d3510c8beab6 693 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 694 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 695 assert_param(IS_VOLTAGERANGE(VoltageRange));
bwang 181:d3510c8beab6 696
bwang 181:d3510c8beab6 697 if(VoltageRange == VoltageRange_1)
bwang 181:d3510c8beab6 698 {
bwang 181:d3510c8beab6 699 tmp_psize = FLASH_PSIZE_BYTE;
bwang 181:d3510c8beab6 700 }
bwang 181:d3510c8beab6 701 else if(VoltageRange == VoltageRange_2)
bwang 181:d3510c8beab6 702 {
bwang 181:d3510c8beab6 703 tmp_psize = FLASH_PSIZE_HALF_WORD;
bwang 181:d3510c8beab6 704 }
bwang 181:d3510c8beab6 705 else if(VoltageRange == VoltageRange_3)
bwang 181:d3510c8beab6 706 {
bwang 181:d3510c8beab6 707 tmp_psize = FLASH_PSIZE_WORD;
bwang 181:d3510c8beab6 708 }
bwang 181:d3510c8beab6 709 else
bwang 181:d3510c8beab6 710 {
bwang 181:d3510c8beab6 711 tmp_psize = FLASH_PSIZE_DOUBLE_WORD;
bwang 181:d3510c8beab6 712 }
bwang 181:d3510c8beab6 713 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 714 {
bwang 181:d3510c8beab6 715 /* if the previous operation is completed, proceed to erase all sectors */
bwang 181:d3510c8beab6 716 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 717 FLASH->CR |= tmp_psize;
bwang 181:d3510c8beab6 718 FLASH->CR |= FLASH_CR_MER2;
bwang 181:d3510c8beab6 719 FLASH->CR |= FLASH_CR_STRT;
bwang 181:d3510c8beab6 720
bwang 181:d3510c8beab6 721 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 722 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 723
bwang 181:d3510c8beab6 724 /* if the erase operation is completed, disable the MER Bit */
bwang 181:d3510c8beab6 725 FLASH->CR &= (~FLASH_CR_MER2);
bwang 181:d3510c8beab6 726
bwang 181:d3510c8beab6 727 }
bwang 181:d3510c8beab6 728 /* Return the Erase Status */
bwang 181:d3510c8beab6 729 return status;
bwang 181:d3510c8beab6 730 }
bwang 181:d3510c8beab6 731
bwang 181:d3510c8beab6 732 /**
bwang 181:d3510c8beab6 733 * @brief Programs a double word (64-bit) at a specified address.
bwang 181:d3510c8beab6 734 * @note This function must be used when the device voltage range is from
bwang 181:d3510c8beab6 735 * 2.7V to 3.6V and an External Vpp is present.
bwang 181:d3510c8beab6 736 *
bwang 181:d3510c8beab6 737 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 738 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 739 *
bwang 181:d3510c8beab6 740 * @param Address: specifies the address to be programmed.
bwang 181:d3510c8beab6 741 * @param Data: specifies the data to be programmed.
bwang 181:d3510c8beab6 742 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 743 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 744 */
bwang 181:d3510c8beab6 745 FLASH_Status FLASH_ProgramDoubleWord(uint32_t Address, uint64_t Data)
bwang 181:d3510c8beab6 746 {
bwang 181:d3510c8beab6 747 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 748
bwang 181:d3510c8beab6 749 /* Check the parameters */
bwang 181:d3510c8beab6 750 assert_param(IS_FLASH_ADDRESS(Address));
bwang 181:d3510c8beab6 751
bwang 181:d3510c8beab6 752 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 753 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 754
bwang 181:d3510c8beab6 755 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 756 {
bwang 181:d3510c8beab6 757 /* if the previous operation is completed, proceed to program the new data */
bwang 181:d3510c8beab6 758 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 759 FLASH->CR |= FLASH_PSIZE_DOUBLE_WORD;
bwang 181:d3510c8beab6 760 FLASH->CR |= FLASH_CR_PG;
bwang 181:d3510c8beab6 761
bwang 181:d3510c8beab6 762 *(__IO uint64_t*)Address = Data;
bwang 181:d3510c8beab6 763
bwang 181:d3510c8beab6 764 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 765 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 766
bwang 181:d3510c8beab6 767 /* if the program operation is completed, disable the PG Bit */
bwang 181:d3510c8beab6 768 FLASH->CR &= (~FLASH_CR_PG);
bwang 181:d3510c8beab6 769 }
bwang 181:d3510c8beab6 770 /* Return the Program Status */
bwang 181:d3510c8beab6 771 return status;
bwang 181:d3510c8beab6 772 }
bwang 181:d3510c8beab6 773
bwang 181:d3510c8beab6 774 /**
bwang 181:d3510c8beab6 775 * @brief Programs a word (32-bit) at a specified address.
bwang 181:d3510c8beab6 776 *
bwang 181:d3510c8beab6 777 * @note This function must be used when the device voltage range is from 2.7V to 3.6V.
bwang 181:d3510c8beab6 778 *
bwang 181:d3510c8beab6 779 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 780 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 781 *
bwang 181:d3510c8beab6 782 * @param Address: specifies the address to be programmed.
bwang 181:d3510c8beab6 783 * This parameter can be any address in Program memory zone or in OTP zone.
bwang 181:d3510c8beab6 784 * @param Data: specifies the data to be programmed.
bwang 181:d3510c8beab6 785 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 786 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 787 */
bwang 181:d3510c8beab6 788 FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data)
bwang 181:d3510c8beab6 789 {
bwang 181:d3510c8beab6 790 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 791
bwang 181:d3510c8beab6 792 /* Check the parameters */
bwang 181:d3510c8beab6 793 assert_param(IS_FLASH_ADDRESS(Address));
bwang 181:d3510c8beab6 794
bwang 181:d3510c8beab6 795 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 796 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 797
bwang 181:d3510c8beab6 798 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 799 {
bwang 181:d3510c8beab6 800 /* if the previous operation is completed, proceed to program the new data */
bwang 181:d3510c8beab6 801 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 802 FLASH->CR |= FLASH_PSIZE_WORD;
bwang 181:d3510c8beab6 803 FLASH->CR |= FLASH_CR_PG;
bwang 181:d3510c8beab6 804
bwang 181:d3510c8beab6 805 *(__IO uint32_t*)Address = Data;
bwang 181:d3510c8beab6 806
bwang 181:d3510c8beab6 807 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 808 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 809
bwang 181:d3510c8beab6 810 /* if the program operation is completed, disable the PG Bit */
bwang 181:d3510c8beab6 811 FLASH->CR &= (~FLASH_CR_PG);
bwang 181:d3510c8beab6 812 }
bwang 181:d3510c8beab6 813 /* Return the Program Status */
bwang 181:d3510c8beab6 814 return status;
bwang 181:d3510c8beab6 815 }
bwang 181:d3510c8beab6 816
bwang 181:d3510c8beab6 817 /**
bwang 181:d3510c8beab6 818 * @brief Programs a half word (16-bit) at a specified address.
bwang 181:d3510c8beab6 819 * @note This function must be used when the device voltage range is from 2.1V to 3.6V.
bwang 181:d3510c8beab6 820 *
bwang 181:d3510c8beab6 821 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 822 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 823 *
bwang 181:d3510c8beab6 824 * @param Address: specifies the address to be programmed.
bwang 181:d3510c8beab6 825 * This parameter can be any address in Program memory zone or in OTP zone.
bwang 181:d3510c8beab6 826 * @param Data: specifies the data to be programmed.
bwang 181:d3510c8beab6 827 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 828 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 829 */
bwang 181:d3510c8beab6 830 FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data)
bwang 181:d3510c8beab6 831 {
bwang 181:d3510c8beab6 832 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 833
bwang 181:d3510c8beab6 834 /* Check the parameters */
bwang 181:d3510c8beab6 835 assert_param(IS_FLASH_ADDRESS(Address));
bwang 181:d3510c8beab6 836
bwang 181:d3510c8beab6 837 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 838 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 839
bwang 181:d3510c8beab6 840 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 841 {
bwang 181:d3510c8beab6 842 /* if the previous operation is completed, proceed to program the new data */
bwang 181:d3510c8beab6 843 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 844 FLASH->CR |= FLASH_PSIZE_HALF_WORD;
bwang 181:d3510c8beab6 845 FLASH->CR |= FLASH_CR_PG;
bwang 181:d3510c8beab6 846
bwang 181:d3510c8beab6 847 *(__IO uint16_t*)Address = Data;
bwang 181:d3510c8beab6 848
bwang 181:d3510c8beab6 849 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 850 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 851
bwang 181:d3510c8beab6 852 /* if the program operation is completed, disable the PG Bit */
bwang 181:d3510c8beab6 853 FLASH->CR &= (~FLASH_CR_PG);
bwang 181:d3510c8beab6 854 }
bwang 181:d3510c8beab6 855 /* Return the Program Status */
bwang 181:d3510c8beab6 856 return status;
bwang 181:d3510c8beab6 857 }
bwang 181:d3510c8beab6 858
bwang 181:d3510c8beab6 859 /**
bwang 181:d3510c8beab6 860 * @brief Programs a byte (8-bit) at a specified address.
bwang 181:d3510c8beab6 861 * @note This function can be used within all the device supply voltage ranges.
bwang 181:d3510c8beab6 862 *
bwang 181:d3510c8beab6 863 * @note If an erase and a program operations are requested simultaneously,
bwang 181:d3510c8beab6 864 * the erase operation is performed before the program one.
bwang 181:d3510c8beab6 865 *
bwang 181:d3510c8beab6 866 * @param Address: specifies the address to be programmed.
bwang 181:d3510c8beab6 867 * This parameter can be any address in Program memory zone or in OTP zone.
bwang 181:d3510c8beab6 868 * @param Data: specifies the data to be programmed.
bwang 181:d3510c8beab6 869 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 870 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 871 */
bwang 181:d3510c8beab6 872 FLASH_Status FLASH_ProgramByte(uint32_t Address, uint8_t Data)
bwang 181:d3510c8beab6 873 {
bwang 181:d3510c8beab6 874 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 875
bwang 181:d3510c8beab6 876 /* Check the parameters */
bwang 181:d3510c8beab6 877 assert_param(IS_FLASH_ADDRESS(Address));
bwang 181:d3510c8beab6 878
bwang 181:d3510c8beab6 879 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 880 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 881
bwang 181:d3510c8beab6 882 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 883 {
bwang 181:d3510c8beab6 884 /* if the previous operation is completed, proceed to program the new data */
bwang 181:d3510c8beab6 885 FLASH->CR &= CR_PSIZE_MASK;
bwang 181:d3510c8beab6 886 FLASH->CR |= FLASH_PSIZE_BYTE;
bwang 181:d3510c8beab6 887 FLASH->CR |= FLASH_CR_PG;
bwang 181:d3510c8beab6 888
bwang 181:d3510c8beab6 889 *(__IO uint8_t*)Address = Data;
bwang 181:d3510c8beab6 890
bwang 181:d3510c8beab6 891 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 892 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 893
bwang 181:d3510c8beab6 894 /* if the program operation is completed, disable the PG Bit */
bwang 181:d3510c8beab6 895 FLASH->CR &= (~FLASH_CR_PG);
bwang 181:d3510c8beab6 896 }
bwang 181:d3510c8beab6 897
bwang 181:d3510c8beab6 898 /* Return the Program Status */
bwang 181:d3510c8beab6 899 return status;
bwang 181:d3510c8beab6 900 }
bwang 181:d3510c8beab6 901
bwang 181:d3510c8beab6 902 /**
bwang 181:d3510c8beab6 903 * @}
bwang 181:d3510c8beab6 904 */
bwang 181:d3510c8beab6 905
bwang 181:d3510c8beab6 906 /** @defgroup FLASH_Group3 Option Bytes Programming functions
bwang 181:d3510c8beab6 907 * @brief Option Bytes Programming functions
bwang 181:d3510c8beab6 908 *
bwang 181:d3510c8beab6 909 @verbatim
bwang 181:d3510c8beab6 910 ===============================================================================
bwang 181:d3510c8beab6 911 ##### Option Bytes Programming functions #####
bwang 181:d3510c8beab6 912 ===============================================================================
bwang 181:d3510c8beab6 913 [..]
bwang 181:d3510c8beab6 914 This group includes the following functions:
bwang 181:d3510c8beab6 915 (+) void FLASH_OB_Unlock(void)
bwang 181:d3510c8beab6 916 (+) void FLASH_OB_Lock(void)
bwang 181:d3510c8beab6 917 (+) void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState)
bwang 181:d3510c8beab6 918 (+) void FLASH_OB_WRP1Config(uint32_t OB_WRP, FunctionalState NewState)
bwang 181:d3510c8beab6 919 (+) void FLASH_OB_PCROPSelectionConfig(uint8_t OB_PCROPSelect)
bwang 181:d3510c8beab6 920 (+) void FLASH_OB_PCROPConfig(uint32_t OB_PCROP, FunctionalState NewState)
bwang 181:d3510c8beab6 921 (+) void FLASH_OB_PCROP1Config(uint32_t OB_PCROP, FunctionalState NewState)
bwang 181:d3510c8beab6 922 (+) void FLASH_OB_RDPConfig(uint8_t OB_RDP)
bwang 181:d3510c8beab6 923 (+) void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY)
bwang 181:d3510c8beab6 924 (+) void FLASH_OB_BORConfig(uint8_t OB_BOR)
bwang 181:d3510c8beab6 925 (+) FLASH_Status FLASH_ProgramOTP(uint32_t Address, uint32_t Data)
bwang 181:d3510c8beab6 926 (+) FLASH_Status FLASH_OB_Launch(void)
bwang 181:d3510c8beab6 927 (+) uint32_t FLASH_OB_GetUser(void)
bwang 181:d3510c8beab6 928 (+) uint8_t FLASH_OB_GetWRP(void)
bwang 181:d3510c8beab6 929 (+) uint8_t FLASH_OB_GetWRP1(void)
bwang 181:d3510c8beab6 930 (+) uint8_t FLASH_OB_GetPCROP(void)
bwang 181:d3510c8beab6 931 (+) uint8_t FLASH_OB_GetPCROP1(void)
bwang 181:d3510c8beab6 932 (+) uint8_t FLASH_OB_GetRDP(void)
bwang 181:d3510c8beab6 933 (+) uint8_t FLASH_OB_GetBOR(void)
bwang 181:d3510c8beab6 934 [..]
bwang 181:d3510c8beab6 935 The following function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 936 (+) void FLASH_OB_BootConfig(uint8_t OB_BOOT)
bwang 181:d3510c8beab6 937 [..]
bwang 181:d3510c8beab6 938 Any operation of erase or program should follow these steps:
bwang 181:d3510c8beab6 939 (#) Call the FLASH_OB_Unlock() function to enable the FLASH option control
bwang 181:d3510c8beab6 940 register access
bwang 181:d3510c8beab6 941
bwang 181:d3510c8beab6 942 (#) Call one or several functions to program the desired Option Bytes:
bwang 181:d3510c8beab6 943 (++) void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState)
bwang 181:d3510c8beab6 944 => to Enable/Disable the desired sector write protection
bwang 181:d3510c8beab6 945 (++) void FLASH_OB_RDPConfig(uint8_t OB_RDP) => to set the desired read
bwang 181:d3510c8beab6 946 Protection Level
bwang 181:d3510c8beab6 947 (++) void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY)
bwang 181:d3510c8beab6 948 => to configure the user Option Bytes.
bwang 181:d3510c8beab6 949 (++) void FLASH_OB_BORConfig(uint8_t OB_BOR) => to set the BOR Level
bwang 181:d3510c8beab6 950
bwang 181:d3510c8beab6 951 (#) Once all needed Option Bytes to be programmed are correctly written,
bwang 181:d3510c8beab6 952 call the FLASH_OB_Launch() function to launch the Option Bytes
bwang 181:d3510c8beab6 953 programming process.
bwang 181:d3510c8beab6 954
bwang 181:d3510c8beab6 955 -@- When changing the IWDG mode from HW to SW or from SW to HW, a system
bwang 181:d3510c8beab6 956 reset is needed to make the change effective.
bwang 181:d3510c8beab6 957
bwang 181:d3510c8beab6 958 (#) Call the FLASH_OB_Lock() function to disable the FLASH option control
bwang 181:d3510c8beab6 959 register access (recommended to protect the Option Bytes against
bwang 181:d3510c8beab6 960 possible unwanted operations)
bwang 181:d3510c8beab6 961
bwang 181:d3510c8beab6 962 @endverbatim
bwang 181:d3510c8beab6 963 * @{
bwang 181:d3510c8beab6 964 */
bwang 181:d3510c8beab6 965
bwang 181:d3510c8beab6 966 /**
bwang 181:d3510c8beab6 967 * @brief Unlocks the FLASH Option Control Registers access.
bwang 181:d3510c8beab6 968 * @param None
bwang 181:d3510c8beab6 969 * @retval None
bwang 181:d3510c8beab6 970 */
bwang 181:d3510c8beab6 971 void FLASH_OB_Unlock(void)
bwang 181:d3510c8beab6 972 {
bwang 181:d3510c8beab6 973 if((FLASH->OPTCR & FLASH_OPTCR_OPTLOCK) != RESET)
bwang 181:d3510c8beab6 974 {
bwang 181:d3510c8beab6 975 /* Authorizes the Option Byte register programming */
bwang 181:d3510c8beab6 976 FLASH->OPTKEYR = FLASH_OPT_KEY1;
bwang 181:d3510c8beab6 977 FLASH->OPTKEYR = FLASH_OPT_KEY2;
bwang 181:d3510c8beab6 978 }
bwang 181:d3510c8beab6 979 }
bwang 181:d3510c8beab6 980
bwang 181:d3510c8beab6 981 /**
bwang 181:d3510c8beab6 982 * @brief Locks the FLASH Option Control Registers access.
bwang 181:d3510c8beab6 983 * @param None
bwang 181:d3510c8beab6 984 * @retval None
bwang 181:d3510c8beab6 985 */
bwang 181:d3510c8beab6 986 void FLASH_OB_Lock(void)
bwang 181:d3510c8beab6 987 {
bwang 181:d3510c8beab6 988 /* Set the OPTLOCK Bit to lock the FLASH Option Byte Registers access */
bwang 181:d3510c8beab6 989 FLASH->OPTCR |= FLASH_OPTCR_OPTLOCK;
bwang 181:d3510c8beab6 990 }
bwang 181:d3510c8beab6 991
bwang 181:d3510c8beab6 992 /**
bwang 181:d3510c8beab6 993 * @brief Enables or disables the write protection of the desired sectors, for the first
bwang 181:d3510c8beab6 994 * 1 Mb of the Flash
bwang 181:d3510c8beab6 995 *
bwang 181:d3510c8beab6 996 * @note When the memory read protection level is selected (RDP level = 1),
bwang 181:d3510c8beab6 997 * it is not possible to program or erase the flash sector i if CortexM4
bwang 181:d3510c8beab6 998 * debug features are connected or boot code is executed in RAM, even if nWRPi = 1
bwang 181:d3510c8beab6 999 * @note Active value of nWRPi bits is inverted when PCROP mode is active (SPRMOD =1).
bwang 181:d3510c8beab6 1000 *
bwang 181:d3510c8beab6 1001 * @param OB_WRP: specifies the sector(s) to be write protected or unprotected.
bwang 181:d3510c8beab6 1002 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1003 * @arg OB_WRP: A value between OB_WRP_Sector0 and OB_WRP_Sector11
bwang 181:d3510c8beab6 1004 * @arg OB_WRP_Sector_All
bwang 181:d3510c8beab6 1005 * @param Newstate: new state of the Write Protection.
bwang 181:d3510c8beab6 1006 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 1007 * @retval None
bwang 181:d3510c8beab6 1008 */
bwang 181:d3510c8beab6 1009 void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState)
bwang 181:d3510c8beab6 1010 {
bwang 181:d3510c8beab6 1011 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1012
bwang 181:d3510c8beab6 1013 /* Check the parameters */
bwang 181:d3510c8beab6 1014 assert_param(IS_OB_WRP(OB_WRP));
bwang 181:d3510c8beab6 1015 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 1016
bwang 181:d3510c8beab6 1017 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1018
bwang 181:d3510c8beab6 1019 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1020 {
bwang 181:d3510c8beab6 1021 if(NewState != DISABLE)
bwang 181:d3510c8beab6 1022 {
bwang 181:d3510c8beab6 1023 *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS &= (~OB_WRP);
bwang 181:d3510c8beab6 1024 }
bwang 181:d3510c8beab6 1025 else
bwang 181:d3510c8beab6 1026 {
bwang 181:d3510c8beab6 1027 *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS |= (uint16_t)OB_WRP;
bwang 181:d3510c8beab6 1028 }
bwang 181:d3510c8beab6 1029 }
bwang 181:d3510c8beab6 1030 }
bwang 181:d3510c8beab6 1031
bwang 181:d3510c8beab6 1032 /**
bwang 181:d3510c8beab6 1033 * @brief Enables or disables the write protection of the desired sectors, for the second
bwang 181:d3510c8beab6 1034 * 1 Mb of the Flash
bwang 181:d3510c8beab6 1035 *
bwang 181:d3510c8beab6 1036 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 1037 *
bwang 181:d3510c8beab6 1038 * @note When the memory read out protection is selected (RDP level = 1),
bwang 181:d3510c8beab6 1039 * it is not possible to program or erase the flash sector i if CortexM4
bwang 181:d3510c8beab6 1040 * debug features are connected or boot code is executed in RAM, even if nWRPi = 1
bwang 181:d3510c8beab6 1041 * @note Active value of nWRPi bits is inverted when PCROP mode is active (SPRMOD =1).
bwang 181:d3510c8beab6 1042 *
bwang 181:d3510c8beab6 1043 * @param OB_WRP: specifies the sector(s) to be write protected or unprotected.
bwang 181:d3510c8beab6 1044 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1045 * @arg OB_WRP: A value between OB_WRP_Sector12 and OB_WRP_Sector23
bwang 181:d3510c8beab6 1046 * @arg OB_WRP_Sector_All
bwang 181:d3510c8beab6 1047 * @param Newstate: new state of the Write Protection.
bwang 181:d3510c8beab6 1048 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 1049 * @retval None
bwang 181:d3510c8beab6 1050 */
bwang 181:d3510c8beab6 1051 void FLASH_OB_WRP1Config(uint32_t OB_WRP, FunctionalState NewState)
bwang 181:d3510c8beab6 1052 {
bwang 181:d3510c8beab6 1053 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1054
bwang 181:d3510c8beab6 1055 /* Check the parameters */
bwang 181:d3510c8beab6 1056 assert_param(IS_OB_WRP(OB_WRP));
bwang 181:d3510c8beab6 1057 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 1058
bwang 181:d3510c8beab6 1059 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1060
bwang 181:d3510c8beab6 1061 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1062 {
bwang 181:d3510c8beab6 1063 if(NewState != DISABLE)
bwang 181:d3510c8beab6 1064 {
bwang 181:d3510c8beab6 1065 *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS &= (~OB_WRP);
bwang 181:d3510c8beab6 1066 }
bwang 181:d3510c8beab6 1067 else
bwang 181:d3510c8beab6 1068 {
bwang 181:d3510c8beab6 1069 *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS |= (uint16_t)OB_WRP;
bwang 181:d3510c8beab6 1070 }
bwang 181:d3510c8beab6 1071 }
bwang 181:d3510c8beab6 1072 }
bwang 181:d3510c8beab6 1073
bwang 181:d3510c8beab6 1074 /**
bwang 181:d3510c8beab6 1075 * @brief Select the Protection Mode (SPRMOD).
bwang 181:d3510c8beab6 1076 *
bwang 181:d3510c8beab6 1077 * @note This function can be used only for STM32F42xxx/43xxx and STM32F401xx/411xE devices.
bwang 181:d3510c8beab6 1078 *
bwang 181:d3510c8beab6 1079 * @note After PCROP activation, Option Byte modification is not possible.
bwang 181:d3510c8beab6 1080 * Exception made for the global Read Out Protection modification level (level1 to level0)
bwang 181:d3510c8beab6 1081 * @note Once SPRMOD bit is active unprotection of a protected sector is not possible
bwang 181:d3510c8beab6 1082 *
bwang 181:d3510c8beab6 1083 * @note Read a protected sector will set RDERR Flag and write a protected sector will set WRPERR Flag
bwang 181:d3510c8beab6 1084 *
bwang 181:d3510c8beab6 1085 * @note Some Precautions should be taken when activating the PCROP feature :
bwang 181:d3510c8beab6 1086 * The active value of nWRPi bits is inverted when PCROP mode is active, this means if SPRMOD = 1
bwang 181:d3510c8beab6 1087 * and WRPi = 1 (default value), then the user sector i is read/write protected.
bwang 181:d3510c8beab6 1088 * In order to avoid activation of PCROP Mode for undesired sectors, please follow the
bwang 181:d3510c8beab6 1089 * below safety sequence :
bwang 181:d3510c8beab6 1090 * - Disable PCROP for all Sectors using FLASH_OB_PCROPConfig(OB_PCROP_Sector_All, DISABLE) function
bwang 181:d3510c8beab6 1091 * for Bank1 or FLASH_OB_PCROP1Config(OB_PCROP_Sector_All, DISABLE) function for Bank2
bwang 181:d3510c8beab6 1092 * - Enable PCROP for the desired Sector i using FLASH_OB_PCROPConfig(Sector i, ENABLE) function
bwang 181:d3510c8beab6 1093 * - Activate the PCROP Mode FLASH_OB_PCROPSelectionConfig() function.
bwang 181:d3510c8beab6 1094 *
bwang 181:d3510c8beab6 1095 * @param OB_PCROP: Select the Protection Mode of nWPRi bits
bwang 181:d3510c8beab6 1096 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1097 * @arg OB_PcROP_Disable: nWRPi control the write protection of respective user sectors.
bwang 181:d3510c8beab6 1098 * @arg OB_PcROP_Enable: nWRPi control the read&write protection (PCROP) of respective user sectors.
bwang 181:d3510c8beab6 1099 * @retval None
bwang 181:d3510c8beab6 1100 */
bwang 181:d3510c8beab6 1101 void FLASH_OB_PCROPSelectionConfig(uint8_t OB_PcROP)
bwang 181:d3510c8beab6 1102 {
bwang 181:d3510c8beab6 1103 uint8_t optiontmp = 0xFF;
bwang 181:d3510c8beab6 1104
bwang 181:d3510c8beab6 1105 /* Check the parameters */
bwang 181:d3510c8beab6 1106 assert_param(IS_OB_PCROP_SELECT(OB_PcROP));
bwang 181:d3510c8beab6 1107
bwang 181:d3510c8beab6 1108 /* Mask SPRMOD bit */
bwang 181:d3510c8beab6 1109 optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE3_ADDRESS) & (uint8_t)0x7F);
bwang 181:d3510c8beab6 1110 /* Update Option Byte */
bwang 181:d3510c8beab6 1111 *(__IO uint8_t *)OPTCR_BYTE3_ADDRESS = (uint8_t)(OB_PcROP | optiontmp);
bwang 181:d3510c8beab6 1112
bwang 181:d3510c8beab6 1113 }
bwang 181:d3510c8beab6 1114
bwang 181:d3510c8beab6 1115 /**
bwang 181:d3510c8beab6 1116 * @brief Enables or disables the read/write protection (PCROP) of the desired
bwang 181:d3510c8beab6 1117 * sectors, for the first 1 MB of the Flash.
bwang 181:d3510c8beab6 1118 *
bwang 181:d3510c8beab6 1119 * @note This function can be used only for STM32F42xxx/43xxx , STM32F401xx/411xE
bwang 181:d3510c8beab6 1120 * and STM32F412xG devices.
bwang 181:d3510c8beab6 1121 *
bwang 181:d3510c8beab6 1122 * @param OB_PCROP: specifies the sector(s) to be read/write protected or unprotected.
bwang 181:d3510c8beab6 1123 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1124 * @arg OB_PCROP: A value between OB_PCROP_Sector0 and OB_PCROP_Sector11 for
bwang 181:d3510c8beab6 1125 * STM32F42xxx/43xxx devices and between OB_PCROP_Sector0 and
bwang 181:d3510c8beab6 1126 * OB_PCROP_Sector5 for STM32F401xx/411xE devices.
bwang 181:d3510c8beab6 1127 * @arg OB_PCROP_Sector_All
bwang 181:d3510c8beab6 1128 * @param Newstate: new state of the Write Protection.
bwang 181:d3510c8beab6 1129 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 1130 * @retval None
bwang 181:d3510c8beab6 1131 */
bwang 181:d3510c8beab6 1132 void FLASH_OB_PCROPConfig(uint32_t OB_PCROP, FunctionalState NewState)
bwang 181:d3510c8beab6 1133 {
bwang 181:d3510c8beab6 1134 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1135
bwang 181:d3510c8beab6 1136 /* Check the parameters */
bwang 181:d3510c8beab6 1137 assert_param(IS_OB_PCROP(OB_PCROP));
bwang 181:d3510c8beab6 1138 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 1139
bwang 181:d3510c8beab6 1140 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1141
bwang 181:d3510c8beab6 1142 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1143 {
bwang 181:d3510c8beab6 1144 if(NewState != DISABLE)
bwang 181:d3510c8beab6 1145 {
bwang 181:d3510c8beab6 1146 *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS |= (uint16_t)OB_PCROP;
bwang 181:d3510c8beab6 1147 }
bwang 181:d3510c8beab6 1148 else
bwang 181:d3510c8beab6 1149 {
bwang 181:d3510c8beab6 1150 *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS &= (~OB_PCROP);
bwang 181:d3510c8beab6 1151 }
bwang 181:d3510c8beab6 1152 }
bwang 181:d3510c8beab6 1153 }
bwang 181:d3510c8beab6 1154
bwang 181:d3510c8beab6 1155 /**
bwang 181:d3510c8beab6 1156 * @brief Enables or disables the read/write protection (PCROP) of the desired
bwang 181:d3510c8beab6 1157 * sectors
bwang 181:d3510c8beab6 1158 *
bwang 181:d3510c8beab6 1159 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 1160 *
bwang 181:d3510c8beab6 1161 * @param OB_PCROP: specifies the sector(s) to be read/write protected or unprotected.
bwang 181:d3510c8beab6 1162 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1163 * @arg OB_PCROP: A value between OB_PCROP_Sector12 and OB_PCROP_Sector23
bwang 181:d3510c8beab6 1164 * @arg OB_PCROP_Sector_All
bwang 181:d3510c8beab6 1165 * @param Newstate: new state of the Write Protection.
bwang 181:d3510c8beab6 1166 * This parameter can be: ENABLE or DISABLE.
bwang 181:d3510c8beab6 1167 * @retval None
bwang 181:d3510c8beab6 1168 */
bwang 181:d3510c8beab6 1169 void FLASH_OB_PCROP1Config(uint32_t OB_PCROP, FunctionalState NewState)
bwang 181:d3510c8beab6 1170 {
bwang 181:d3510c8beab6 1171 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1172
bwang 181:d3510c8beab6 1173 /* Check the parameters */
bwang 181:d3510c8beab6 1174 assert_param(IS_OB_PCROP(OB_PCROP));
bwang 181:d3510c8beab6 1175 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 1176
bwang 181:d3510c8beab6 1177 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1178
bwang 181:d3510c8beab6 1179 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1180 {
bwang 181:d3510c8beab6 1181 if(NewState != DISABLE)
bwang 181:d3510c8beab6 1182 {
bwang 181:d3510c8beab6 1183 *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS |= (uint16_t)OB_PCROP;
bwang 181:d3510c8beab6 1184 }
bwang 181:d3510c8beab6 1185 else
bwang 181:d3510c8beab6 1186 {
bwang 181:d3510c8beab6 1187 *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS &= (~OB_PCROP);
bwang 181:d3510c8beab6 1188 }
bwang 181:d3510c8beab6 1189 }
bwang 181:d3510c8beab6 1190 }
bwang 181:d3510c8beab6 1191
bwang 181:d3510c8beab6 1192
bwang 181:d3510c8beab6 1193 /**
bwang 181:d3510c8beab6 1194 * @brief Sets the read protection level.
bwang 181:d3510c8beab6 1195 * @param OB_RDP: specifies the read protection level.
bwang 181:d3510c8beab6 1196 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1197 * @arg OB_RDP_Level_0: No protection
bwang 181:d3510c8beab6 1198 * @arg OB_RDP_Level_1: Read protection of the memory
bwang 181:d3510c8beab6 1199 * @arg OB_RDP_Level_2: Full chip protection
bwang 181:d3510c8beab6 1200 *
bwang 181:d3510c8beab6 1201 * /!\ Warning /!\ When enabling OB_RDP level 2 it's no more possible to go back to level 1 or 0
bwang 181:d3510c8beab6 1202 *
bwang 181:d3510c8beab6 1203 * @retval None
bwang 181:d3510c8beab6 1204 */
bwang 181:d3510c8beab6 1205 void FLASH_OB_RDPConfig(uint8_t OB_RDP)
bwang 181:d3510c8beab6 1206 {
bwang 181:d3510c8beab6 1207 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1208
bwang 181:d3510c8beab6 1209 /* Check the parameters */
bwang 181:d3510c8beab6 1210 assert_param(IS_OB_RDP(OB_RDP));
bwang 181:d3510c8beab6 1211
bwang 181:d3510c8beab6 1212 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1213
bwang 181:d3510c8beab6 1214 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1215 {
bwang 181:d3510c8beab6 1216 *(__IO uint8_t*)OPTCR_BYTE1_ADDRESS = OB_RDP;
bwang 181:d3510c8beab6 1217
bwang 181:d3510c8beab6 1218 }
bwang 181:d3510c8beab6 1219 }
bwang 181:d3510c8beab6 1220
bwang 181:d3510c8beab6 1221 /**
bwang 181:d3510c8beab6 1222 * @brief Programs the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY.
bwang 181:d3510c8beab6 1223 * @param OB_IWDG: Selects the IWDG mode
bwang 181:d3510c8beab6 1224 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1225 * @arg OB_IWDG_SW: Software IWDG selected
bwang 181:d3510c8beab6 1226 * @arg OB_IWDG_HW: Hardware IWDG selected
bwang 181:d3510c8beab6 1227 * @param OB_STOP: Reset event when entering STOP mode.
bwang 181:d3510c8beab6 1228 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1229 * @arg OB_STOP_NoRST: No reset generated when entering in STOP
bwang 181:d3510c8beab6 1230 * @arg OB_STOP_RST: Reset generated when entering in STOP
bwang 181:d3510c8beab6 1231 * @param OB_STDBY: Reset event when entering Standby mode.
bwang 181:d3510c8beab6 1232 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1233 * @arg OB_STDBY_NoRST: No reset generated when entering in STANDBY
bwang 181:d3510c8beab6 1234 * @arg OB_STDBY_RST: Reset generated when entering in STANDBY
bwang 181:d3510c8beab6 1235 * @retval None
bwang 181:d3510c8beab6 1236 */
bwang 181:d3510c8beab6 1237 void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY)
bwang 181:d3510c8beab6 1238 {
bwang 181:d3510c8beab6 1239 uint8_t optiontmp = 0xFF;
bwang 181:d3510c8beab6 1240 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1241
bwang 181:d3510c8beab6 1242 /* Check the parameters */
bwang 181:d3510c8beab6 1243 assert_param(IS_OB_IWDG_SOURCE(OB_IWDG));
bwang 181:d3510c8beab6 1244 assert_param(IS_OB_STOP_SOURCE(OB_STOP));
bwang 181:d3510c8beab6 1245 assert_param(IS_OB_STDBY_SOURCE(OB_STDBY));
bwang 181:d3510c8beab6 1246
bwang 181:d3510c8beab6 1247 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 1248 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1249
bwang 181:d3510c8beab6 1250 if(status == FLASH_COMPLETE2)
bwang 181:d3510c8beab6 1251 {
bwang 181:d3510c8beab6 1252 #if defined(STM32F427_437xx) || defined(STM32F429_439xx) || defined(STM32F469_479xx)
bwang 181:d3510c8beab6 1253 /* Mask OPTLOCK, OPTSTRT, BOR_LEV and BFB2 bits */
bwang 181:d3510c8beab6 1254 optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE0_ADDRESS) & (uint8_t)0x1F);
bwang 181:d3510c8beab6 1255 #endif /* STM32F427_437xx || STM32F429_439xx || STM32F469_479xx */
bwang 181:d3510c8beab6 1256
bwang 181:d3510c8beab6 1257 #if defined(STM32F40_41xxx) || defined(STM32F401xx) || defined(STM32F410xx) || defined(STM32F411xE) || defined(STM32F446xx)
bwang 181:d3510c8beab6 1258 /* Mask OPTLOCK, OPTSTRT and BOR_LEV bits */
bwang 181:d3510c8beab6 1259 optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE0_ADDRESS) & (uint8_t)0x0F);
bwang 181:d3510c8beab6 1260 #endif /* STM32F40_41xxx || STM32F401xx || STM32F410xx || STM32F411xE || STM32F446xx */
bwang 181:d3510c8beab6 1261
bwang 181:d3510c8beab6 1262 /* Update User Option Byte */
bwang 181:d3510c8beab6 1263 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS = OB_IWDG | (uint8_t)(OB_STDBY | (uint8_t)(OB_STOP | ((uint8_t)optiontmp)));
bwang 181:d3510c8beab6 1264 }
bwang 181:d3510c8beab6 1265 }
bwang 181:d3510c8beab6 1266
bwang 181:d3510c8beab6 1267 /**
bwang 181:d3510c8beab6 1268 * @brief Configure the Dual Bank Boot.
bwang 181:d3510c8beab6 1269 *
bwang 181:d3510c8beab6 1270 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 1271 *
bwang 181:d3510c8beab6 1272 * @param OB_BOOT: specifies the Dual Bank Boot Option byte.
bwang 181:d3510c8beab6 1273 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1274 * @arg OB_Dual_BootEnabled: Dual Bank Boot Enable
bwang 181:d3510c8beab6 1275 * @arg OB_Dual_BootDisabled: Dual Bank Boot Disabled
bwang 181:d3510c8beab6 1276 * @retval None
bwang 181:d3510c8beab6 1277 */
bwang 181:d3510c8beab6 1278 void FLASH_OB_BootConfig(uint8_t OB_BOOT)
bwang 181:d3510c8beab6 1279 {
bwang 181:d3510c8beab6 1280 /* Check the parameters */
bwang 181:d3510c8beab6 1281 assert_param(IS_OB_BOOT(OB_BOOT));
bwang 181:d3510c8beab6 1282
bwang 181:d3510c8beab6 1283 /* Set Dual Bank Boot */
bwang 181:d3510c8beab6 1284 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS &= (~FLASH_OPTCR_BFB2);
bwang 181:d3510c8beab6 1285 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= OB_BOOT;
bwang 181:d3510c8beab6 1286
bwang 181:d3510c8beab6 1287 }
bwang 181:d3510c8beab6 1288
bwang 181:d3510c8beab6 1289 /**
bwang 181:d3510c8beab6 1290 * @brief Sets the BOR Level.
bwang 181:d3510c8beab6 1291 * @param OB_BOR: specifies the Option Bytes BOR Reset Level.
bwang 181:d3510c8beab6 1292 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1293 * @arg OB_BOR_LEVEL3: Supply voltage ranges from 2.7 to 3.6 V
bwang 181:d3510c8beab6 1294 * @arg OB_BOR_LEVEL2: Supply voltage ranges from 2.4 to 2.7 V
bwang 181:d3510c8beab6 1295 * @arg OB_BOR_LEVEL1: Supply voltage ranges from 2.1 to 2.4 V
bwang 181:d3510c8beab6 1296 * @arg OB_BOR_OFF: Supply voltage ranges from 1.62 to 2.1 V
bwang 181:d3510c8beab6 1297 * @retval None
bwang 181:d3510c8beab6 1298 */
bwang 181:d3510c8beab6 1299 void FLASH_OB_BORConfig(uint8_t OB_BOR)
bwang 181:d3510c8beab6 1300 {
bwang 181:d3510c8beab6 1301 /* Check the parameters */
bwang 181:d3510c8beab6 1302 assert_param(IS_OB_BOR(OB_BOR));
bwang 181:d3510c8beab6 1303
bwang 181:d3510c8beab6 1304 /* Set the BOR Level */
bwang 181:d3510c8beab6 1305 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS &= (~FLASH_OPTCR_BOR_LEV);
bwang 181:d3510c8beab6 1306 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= OB_BOR;
bwang 181:d3510c8beab6 1307
bwang 181:d3510c8beab6 1308 }
bwang 181:d3510c8beab6 1309
bwang 181:d3510c8beab6 1310 /**
bwang 181:d3510c8beab6 1311 * @brief Launch the option byte loading.
bwang 181:d3510c8beab6 1312 * @param None
bwang 181:d3510c8beab6 1313 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 1314 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 1315 */
bwang 181:d3510c8beab6 1316 FLASH_Status FLASH_OB_Launch(void)
bwang 181:d3510c8beab6 1317 {
bwang 181:d3510c8beab6 1318 FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1319
bwang 181:d3510c8beab6 1320 /* Set the OPTSTRT bit in OPTCR register */
bwang 181:d3510c8beab6 1321 *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= FLASH_OPTCR_OPTSTRT;
bwang 181:d3510c8beab6 1322
bwang 181:d3510c8beab6 1323 /* Wait for last operation to be completed */
bwang 181:d3510c8beab6 1324 status = FLASH_WaitForLastOperation2();
bwang 181:d3510c8beab6 1325
bwang 181:d3510c8beab6 1326 return status;
bwang 181:d3510c8beab6 1327 }
bwang 181:d3510c8beab6 1328
bwang 181:d3510c8beab6 1329 /**
bwang 181:d3510c8beab6 1330 * @brief Returns the FLASH User Option Bytes values.
bwang 181:d3510c8beab6 1331 * @param None
bwang 181:d3510c8beab6 1332 * @retval The FLASH User Option Bytes values: IWDG_SW(Bit0), RST_STOP(Bit1)
bwang 181:d3510c8beab6 1333 * and RST_STDBY(Bit2).
bwang 181:d3510c8beab6 1334 */
bwang 181:d3510c8beab6 1335 uint8_t FLASH_OB_GetUser(void)
bwang 181:d3510c8beab6 1336 {
bwang 181:d3510c8beab6 1337 /* Return the User Option Byte */
bwang 181:d3510c8beab6 1338 return (uint8_t)(FLASH->OPTCR >> 5);
bwang 181:d3510c8beab6 1339 }
bwang 181:d3510c8beab6 1340
bwang 181:d3510c8beab6 1341 /**
bwang 181:d3510c8beab6 1342 * @brief Returns the FLASH Write Protection Option Bytes value.
bwang 181:d3510c8beab6 1343 * @param None
bwang 181:d3510c8beab6 1344 * @retval The FLASH Write Protection Option Bytes value
bwang 181:d3510c8beab6 1345 */
bwang 181:d3510c8beab6 1346 uint16_t FLASH_OB_GetWRP(void)
bwang 181:d3510c8beab6 1347 {
bwang 181:d3510c8beab6 1348 /* Return the FLASH write protection Register value */
bwang 181:d3510c8beab6 1349 return (*(__IO uint16_t *)(OPTCR_BYTE2_ADDRESS));
bwang 181:d3510c8beab6 1350 }
bwang 181:d3510c8beab6 1351
bwang 181:d3510c8beab6 1352 /**
bwang 181:d3510c8beab6 1353 * @brief Returns the FLASH Write Protection Option Bytes value.
bwang 181:d3510c8beab6 1354 *
bwang 181:d3510c8beab6 1355 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 1356 *
bwang 181:d3510c8beab6 1357 * @param None
bwang 181:d3510c8beab6 1358 * @retval The FLASH Write Protection Option Bytes value
bwang 181:d3510c8beab6 1359 */
bwang 181:d3510c8beab6 1360 uint16_t FLASH_OB_GetWRP1(void)
bwang 181:d3510c8beab6 1361 {
bwang 181:d3510c8beab6 1362 /* Return the FLASH write protection Register value */
bwang 181:d3510c8beab6 1363 return (*(__IO uint16_t *)(OPTCR1_BYTE2_ADDRESS));
bwang 181:d3510c8beab6 1364 }
bwang 181:d3510c8beab6 1365
bwang 181:d3510c8beab6 1366 /**
bwang 181:d3510c8beab6 1367 * @brief Returns the FLASH PC Read/Write Protection Option Bytes value.
bwang 181:d3510c8beab6 1368 *
bwang 181:d3510c8beab6 1369 * @note This function can be used only for STM32F42xxx/43xxx devices and STM32F401xx/411xE devices.
bwang 181:d3510c8beab6 1370 *
bwang 181:d3510c8beab6 1371 * @param None
bwang 181:d3510c8beab6 1372 * @retval The FLASH PC Read/Write Protection Option Bytes value
bwang 181:d3510c8beab6 1373 */
bwang 181:d3510c8beab6 1374 uint16_t FLASH_OB_GetPCROP(void)
bwang 181:d3510c8beab6 1375 {
bwang 181:d3510c8beab6 1376 /* Return the FLASH PC Read/write protection Register value */
bwang 181:d3510c8beab6 1377 return (*(__IO uint16_t *)(OPTCR_BYTE2_ADDRESS));
bwang 181:d3510c8beab6 1378 }
bwang 181:d3510c8beab6 1379
bwang 181:d3510c8beab6 1380 /**
bwang 181:d3510c8beab6 1381 * @brief Returns the FLASH PC Read/Write Protection Option Bytes value.
bwang 181:d3510c8beab6 1382 *
bwang 181:d3510c8beab6 1383 * @note This function can be used only for STM32F42xxx/43xxx devices.
bwang 181:d3510c8beab6 1384 *
bwang 181:d3510c8beab6 1385 * @param None
bwang 181:d3510c8beab6 1386 * @retval The FLASH PC Read/Write Protection Option Bytes value
bwang 181:d3510c8beab6 1387 */
bwang 181:d3510c8beab6 1388 uint16_t FLASH_OB_GetPCROP1(void)
bwang 181:d3510c8beab6 1389 {
bwang 181:d3510c8beab6 1390 /* Return the FLASH write protection Register value */
bwang 181:d3510c8beab6 1391 return (*(__IO uint16_t *)(OPTCR1_BYTE2_ADDRESS));
bwang 181:d3510c8beab6 1392 }
bwang 181:d3510c8beab6 1393
bwang 181:d3510c8beab6 1394 /**
bwang 181:d3510c8beab6 1395 * @brief Returns the FLASH Read Protection level.
bwang 181:d3510c8beab6 1396 * @param None
bwang 181:d3510c8beab6 1397 * @retval FLASH ReadOut Protection Status:
bwang 181:d3510c8beab6 1398 * - SET, when OB_RDP_Level_1 or OB_RDP_Level_2 is set
bwang 181:d3510c8beab6 1399 * - RESET, when OB_RDP_Level_0 is set
bwang 181:d3510c8beab6 1400 */
bwang 181:d3510c8beab6 1401 FlagStatus FLASH_OB_GetRDP(void)
bwang 181:d3510c8beab6 1402 {
bwang 181:d3510c8beab6 1403 FlagStatus readstatus = RESET;
bwang 181:d3510c8beab6 1404
bwang 181:d3510c8beab6 1405 if ((*(__IO uint8_t*)(OPTCR_BYTE1_ADDRESS) != (uint8_t)OB_RDP_Level_0))
bwang 181:d3510c8beab6 1406 {
bwang 181:d3510c8beab6 1407 readstatus = SET;
bwang 181:d3510c8beab6 1408 }
bwang 181:d3510c8beab6 1409 else
bwang 181:d3510c8beab6 1410 {
bwang 181:d3510c8beab6 1411 readstatus = RESET;
bwang 181:d3510c8beab6 1412 }
bwang 181:d3510c8beab6 1413 return readstatus;
bwang 181:d3510c8beab6 1414 }
bwang 181:d3510c8beab6 1415
bwang 181:d3510c8beab6 1416 /**
bwang 181:d3510c8beab6 1417 * @brief Returns the FLASH BOR level.
bwang 181:d3510c8beab6 1418 * @param None
bwang 181:d3510c8beab6 1419 * @retval The FLASH BOR level:
bwang 181:d3510c8beab6 1420 * - OB_BOR_LEVEL3: Supply voltage ranges from 2.7 to 3.6 V
bwang 181:d3510c8beab6 1421 * - OB_BOR_LEVEL2: Supply voltage ranges from 2.4 to 2.7 V
bwang 181:d3510c8beab6 1422 * - OB_BOR_LEVEL1: Supply voltage ranges from 2.1 to 2.4 V
bwang 181:d3510c8beab6 1423 * - OB_BOR_OFF : Supply voltage ranges from 1.62 to 2.1 V
bwang 181:d3510c8beab6 1424 */
bwang 181:d3510c8beab6 1425 uint8_t FLASH_OB_GetBOR(void)
bwang 181:d3510c8beab6 1426 {
bwang 181:d3510c8beab6 1427 /* Return the FLASH BOR level */
bwang 181:d3510c8beab6 1428 return (uint8_t)(*(__IO uint8_t *)(OPTCR_BYTE0_ADDRESS) & (uint8_t)0x0C);
bwang 181:d3510c8beab6 1429 }
bwang 181:d3510c8beab6 1430
bwang 181:d3510c8beab6 1431 /**
bwang 181:d3510c8beab6 1432 * @}
bwang 181:d3510c8beab6 1433 */
bwang 181:d3510c8beab6 1434
bwang 181:d3510c8beab6 1435 /** @defgroup FLASH_Group4 Interrupts and flags management functions
bwang 181:d3510c8beab6 1436 * @brief Interrupts and flags management functions
bwang 181:d3510c8beab6 1437 *
bwang 181:d3510c8beab6 1438 @verbatim
bwang 181:d3510c8beab6 1439 ===============================================================================
bwang 181:d3510c8beab6 1440 ##### Interrupts and flags management functions #####
bwang 181:d3510c8beab6 1441 ===============================================================================
bwang 181:d3510c8beab6 1442 @endverbatim
bwang 181:d3510c8beab6 1443 * @{
bwang 181:d3510c8beab6 1444 */
bwang 181:d3510c8beab6 1445
bwang 181:d3510c8beab6 1446 /**
bwang 181:d3510c8beab6 1447 * @brief Enables or disables the specified FLASH interrupts.
bwang 181:d3510c8beab6 1448 * @param FLASH_IT: specifies the FLASH interrupt sources to be enabled or disabled.
bwang 181:d3510c8beab6 1449 * This parameter can be any combination of the following values:
bwang 181:d3510c8beab6 1450 * @arg FLASH_IT_ERR: FLASH Error Interrupt
bwang 181:d3510c8beab6 1451 * @arg FLASH_IT_EOP: FLASH end of operation Interrupt
bwang 181:d3510c8beab6 1452 * @retval None
bwang 181:d3510c8beab6 1453 */
bwang 181:d3510c8beab6 1454 void FLASH_ITConfig(uint32_t FLASH_IT, FunctionalState NewState)
bwang 181:d3510c8beab6 1455 {
bwang 181:d3510c8beab6 1456 /* Check the parameters */
bwang 181:d3510c8beab6 1457 assert_param(IS_FLASH_IT(FLASH_IT));
bwang 181:d3510c8beab6 1458 assert_param(IS_FUNCTIONAL_STATE(NewState));
bwang 181:d3510c8beab6 1459
bwang 181:d3510c8beab6 1460 if(NewState != DISABLE)
bwang 181:d3510c8beab6 1461 {
bwang 181:d3510c8beab6 1462 /* Enable the interrupt sources */
bwang 181:d3510c8beab6 1463 FLASH->CR |= FLASH_IT;
bwang 181:d3510c8beab6 1464 }
bwang 181:d3510c8beab6 1465 else
bwang 181:d3510c8beab6 1466 {
bwang 181:d3510c8beab6 1467 /* Disable the interrupt sources */
bwang 181:d3510c8beab6 1468 FLASH->CR &= ~(uint32_t)FLASH_IT;
bwang 181:d3510c8beab6 1469 }
bwang 181:d3510c8beab6 1470 }
bwang 181:d3510c8beab6 1471
bwang 181:d3510c8beab6 1472 /**
bwang 181:d3510c8beab6 1473 * @brief Checks whether the specified FLASH flag is set or not.
bwang 181:d3510c8beab6 1474 * @param FLASH_FLAG: specifies the FLASH flag to check.
bwang 181:d3510c8beab6 1475 * This parameter can be one of the following values:
bwang 181:d3510c8beab6 1476 * @arg FLASH_FLAG_EOP: FLASH End of Operation flag
bwang 181:d3510c8beab6 1477 * @arg FLASH_FLAG_OPERR: FLASH operation Error flag
bwang 181:d3510c8beab6 1478 * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag
bwang 181:d3510c8beab6 1479 * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag
bwang 181:d3510c8beab6 1480 * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag
bwang 181:d3510c8beab6 1481 * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag
bwang 181:d3510c8beab6 1482 * @arg FLASH_FLAG_RDERR: FLASH (PCROP) Read Protection error flag (STM32F42xx/43xxx and STM32F401xx/411xE devices)
bwang 181:d3510c8beab6 1483 * @arg FLASH_FLAG_BSY: FLASH Busy flag
bwang 181:d3510c8beab6 1484 * @retval The new state of FLASH_FLAG (SET or RESET).
bwang 181:d3510c8beab6 1485 */
bwang 181:d3510c8beab6 1486 FlagStatus FLASH_GetFlagStatus(uint32_t FLASH_FLAG)
bwang 181:d3510c8beab6 1487 {
bwang 181:d3510c8beab6 1488 FlagStatus bitstatus = RESET;
bwang 181:d3510c8beab6 1489 /* Check the parameters */
bwang 181:d3510c8beab6 1490 assert_param(IS_FLASH_GET_FLAG(FLASH_FLAG));
bwang 181:d3510c8beab6 1491
bwang 181:d3510c8beab6 1492 if((FLASH->SR & FLASH_FLAG) != (uint32_t)RESET)
bwang 181:d3510c8beab6 1493 {
bwang 181:d3510c8beab6 1494 bitstatus = SET;
bwang 181:d3510c8beab6 1495 }
bwang 181:d3510c8beab6 1496 else
bwang 181:d3510c8beab6 1497 {
bwang 181:d3510c8beab6 1498 bitstatus = RESET;
bwang 181:d3510c8beab6 1499 }
bwang 181:d3510c8beab6 1500 /* Return the new state of FLASH_FLAG (SET or RESET) */
bwang 181:d3510c8beab6 1501 return bitstatus;
bwang 181:d3510c8beab6 1502 }
bwang 181:d3510c8beab6 1503
bwang 181:d3510c8beab6 1504 /**
bwang 181:d3510c8beab6 1505 * @brief Clears the FLASH's pending flags.
bwang 181:d3510c8beab6 1506 * @param FLASH_FLAG: specifies the FLASH flags to clear.
bwang 181:d3510c8beab6 1507 * This parameter can be any combination of the following values:
bwang 181:d3510c8beab6 1508 * @arg FLASH_FLAG_EOP: FLASH End of Operation flag
bwang 181:d3510c8beab6 1509 * @arg FLASH_FLAG_OPERR: FLASH operation Error flag
bwang 181:d3510c8beab6 1510 * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag
bwang 181:d3510c8beab6 1511 * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag
bwang 181:d3510c8beab6 1512 * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag
bwang 181:d3510c8beab6 1513 * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag
bwang 181:d3510c8beab6 1514 * @arg FLASH_FLAG_RDERR: FLASH Read Protection error flag (STM32F42xx/43xxx and STM32F401xx/411xE devices)
bwang 181:d3510c8beab6 1515 * @retval None
bwang 181:d3510c8beab6 1516 */
bwang 181:d3510c8beab6 1517 void FLASH_ClearFlag(uint32_t FLASH_FLAG)
bwang 181:d3510c8beab6 1518 {
bwang 181:d3510c8beab6 1519 /* Check the parameters */
bwang 181:d3510c8beab6 1520 assert_param(IS_FLASH_CLEAR_FLAG(FLASH_FLAG));
bwang 181:d3510c8beab6 1521
bwang 181:d3510c8beab6 1522 /* Clear the flags */
bwang 181:d3510c8beab6 1523 FLASH->SR = FLASH_FLAG;
bwang 181:d3510c8beab6 1524 }
bwang 181:d3510c8beab6 1525
bwang 181:d3510c8beab6 1526 /**
bwang 181:d3510c8beab6 1527 * @brief Returns the FLASH Status.
bwang 181:d3510c8beab6 1528 * @param None
bwang 181:d3510c8beab6 1529 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 1530 * FLASH_ERROR_WRP2, FLASH_ERROR_RD2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 1531 */
bwang 181:d3510c8beab6 1532 FLASH_Status FLASH_GetStatus(void)
bwang 181:d3510c8beab6 1533 {
bwang 181:d3510c8beab6 1534 FLASH_Status flashstatus = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1535
bwang 181:d3510c8beab6 1536 if((FLASH->SR & FLASH_FLAG_BSY) == FLASH_FLAG_BSY)
bwang 181:d3510c8beab6 1537 {
bwang 181:d3510c8beab6 1538 flashstatus = FLASH_BUSY2;
bwang 181:d3510c8beab6 1539 }
bwang 181:d3510c8beab6 1540 else
bwang 181:d3510c8beab6 1541 {
bwang 181:d3510c8beab6 1542 if((FLASH->SR & FLASH_FLAG_WRPERR) != (uint32_t)0x00)
bwang 181:d3510c8beab6 1543 {
bwang 181:d3510c8beab6 1544 flashstatus = FLASH_ERROR_WRP2;
bwang 181:d3510c8beab6 1545 }
bwang 181:d3510c8beab6 1546 else
bwang 181:d3510c8beab6 1547 {
bwang 181:d3510c8beab6 1548 if((FLASH->SR & FLASH_FLAG_RDERR) != (uint32_t)0x00)
bwang 181:d3510c8beab6 1549 {
bwang 181:d3510c8beab6 1550 flashstatus = FLASH_ERROR_RD2;
bwang 181:d3510c8beab6 1551 }
bwang 181:d3510c8beab6 1552 else
bwang 181:d3510c8beab6 1553 {
bwang 181:d3510c8beab6 1554 if((FLASH->SR & (uint32_t)0xE0) != (uint32_t)0x00)
bwang 181:d3510c8beab6 1555 {
bwang 181:d3510c8beab6 1556 flashstatus = FLASH_ERROR_PROGRAM2;
bwang 181:d3510c8beab6 1557 }
bwang 181:d3510c8beab6 1558 else
bwang 181:d3510c8beab6 1559 {
bwang 181:d3510c8beab6 1560 if((FLASH->SR & FLASH_FLAG_OPERR) != (uint32_t)0x00)
bwang 181:d3510c8beab6 1561 {
bwang 181:d3510c8beab6 1562 flashstatus = FLASH_ERROR_OPERATION2;
bwang 181:d3510c8beab6 1563 }
bwang 181:d3510c8beab6 1564 else
bwang 181:d3510c8beab6 1565 {
bwang 181:d3510c8beab6 1566 flashstatus = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1567 }
bwang 181:d3510c8beab6 1568 }
bwang 181:d3510c8beab6 1569 }
bwang 181:d3510c8beab6 1570 }
bwang 181:d3510c8beab6 1571 }
bwang 181:d3510c8beab6 1572 /* Return the FLASH Status */
bwang 181:d3510c8beab6 1573 return flashstatus;
bwang 181:d3510c8beab6 1574 }
bwang 181:d3510c8beab6 1575
bwang 181:d3510c8beab6 1576 /**
bwang 181:d3510c8beab6 1577 * @brief Waits for a FLASH operation to complete.
bwang 181:d3510c8beab6 1578 * @param None
bwang 181:d3510c8beab6 1579 * @retval FLASH Status: The returned value can be: FLASH_BUSY2, FLASH_ERROR_PROGRAM2,
bwang 181:d3510c8beab6 1580 * FLASH_ERROR_WRP2, FLASH_ERROR_OPERATION2 or FLASH_COMPLETE2.
bwang 181:d3510c8beab6 1581 */
bwang 181:d3510c8beab6 1582 FLASH_Status FLASH_WaitForLastOperation2(void)
bwang 181:d3510c8beab6 1583 {
bwang 181:d3510c8beab6 1584 __IO FLASH_Status status = FLASH_COMPLETE2;
bwang 181:d3510c8beab6 1585
bwang 181:d3510c8beab6 1586 /* Check for the FLASH Status */
bwang 181:d3510c8beab6 1587 status = FLASH_GetStatus();
bwang 181:d3510c8beab6 1588
bwang 181:d3510c8beab6 1589 /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
bwang 181:d3510c8beab6 1590 Even if the FLASH operation fails, the BUSY flag will be reset and an error
bwang 181:d3510c8beab6 1591 flag will be set */
bwang 181:d3510c8beab6 1592 while(status == FLASH_BUSY2)
bwang 181:d3510c8beab6 1593 {
bwang 181:d3510c8beab6 1594 status = FLASH_GetStatus();
bwang 181:d3510c8beab6 1595 }
bwang 181:d3510c8beab6 1596 /* Return the operation status */
bwang 181:d3510c8beab6 1597 return status;
bwang 181:d3510c8beab6 1598 }
bwang 181:d3510c8beab6 1599
bwang 181:d3510c8beab6 1600 /**
bwang 181:d3510c8beab6 1601 * @}
bwang 181:d3510c8beab6 1602 */
bwang 181:d3510c8beab6 1603
bwang 181:d3510c8beab6 1604 /**
bwang 181:d3510c8beab6 1605 * @}
bwang 181:d3510c8beab6 1606 */
bwang 181:d3510c8beab6 1607
bwang 181:d3510c8beab6 1608 /**
bwang 181:d3510c8beab6 1609 * @}
bwang 181:d3510c8beab6 1610 */
bwang 181:d3510c8beab6 1611
bwang 181:d3510c8beab6 1612 /**
bwang 181:d3510c8beab6 1613 * @}
bwang 181:d3510c8beab6 1614 */
bwang 181:d3510c8beab6 1615
bwang 181:d3510c8beab6 1616 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/