shao ziyang / mbed-dev

Dependents:   SensorTileTest

Fork of mbed-dev by mbed official

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev

Replaces mbed-src (now inactive)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32l0xx_hal_flash_ex.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.2.0
bogdanm 0:9b334a45a8ff 6 * @date 06-February-2015
bogdanm 0:9b334a45a8ff 7 * @brief FLASH HAL module driver.
bogdanm 0:9b334a45a8ff 8 * This file provides firmware functions to manage the following
bogdanm 0:9b334a45a8ff 9 * functionalities of the internal FLASH memory:
bogdanm 0:9b334a45a8ff 10 * + FLASH Interface configuration
bogdanm 0:9b334a45a8ff 11 * + FLASH Memory Erasing
bogdanm 0:9b334a45a8ff 12 * + DATA EEPROM Programming/Erasing
bogdanm 0:9b334a45a8ff 13 * + Option Bytes Programming
bogdanm 0:9b334a45a8ff 14 * + Interrupts management
bogdanm 0:9b334a45a8ff 15 *
bogdanm 0:9b334a45a8ff 16 * @verbatim
bogdanm 0:9b334a45a8ff 17 ==============================================================================
bogdanm 0:9b334a45a8ff 18 ##### Flash peripheral Extended features #####
bogdanm 0:9b334a45a8ff 19 ==============================================================================
bogdanm 0:9b334a45a8ff 20
bogdanm 0:9b334a45a8ff 21 [..] Comparing to other products, the FLASH interface for STM32L0xx
bogdanm 0:9b334a45a8ff 22 devices contains the following additional features
bogdanm 0:9b334a45a8ff 23 (+) Erase functions
bogdanm 0:9b334a45a8ff 24 (+) DATA_EEPROM memory management
bogdanm 0:9b334a45a8ff 25 (+) BOOT option bit configuration
bogdanm 0:9b334a45a8ff 26 (+) PCROP protection for all sectors
bogdanm 0:9b334a45a8ff 27
bogdanm 0:9b334a45a8ff 28 ##### How to use this driver #####
bogdanm 0:9b334a45a8ff 29 ==============================================================================
bogdanm 0:9b334a45a8ff 30 [..] This driver provides functions to configure and program the FLASH memory
bogdanm 0:9b334a45a8ff 31 of all STM32L0xx. It includes:
bogdanm 0:9b334a45a8ff 32 (+) Full DATA_EEPROM erase and program management
bogdanm 0:9b334a45a8ff 33 (+) Boot activation
bogdanm 0:9b334a45a8ff 34 (+) PCROP protection configuration and control for all sectors
bogdanm 0:9b334a45a8ff 35
bogdanm 0:9b334a45a8ff 36 @endverbatim
bogdanm 0:9b334a45a8ff 37 ******************************************************************************
bogdanm 0:9b334a45a8ff 38 * @attention
bogdanm 0:9b334a45a8ff 39 *
bogdanm 0:9b334a45a8ff 40 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bogdanm 0:9b334a45a8ff 41 *
bogdanm 0:9b334a45a8ff 42 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 0:9b334a45a8ff 43 * are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 44 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 45 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 46 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 47 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 48 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 49 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 50 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 51 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 52 *
bogdanm 0:9b334a45a8ff 53 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 54 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 55 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 56 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 57 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 58 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 59 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 60 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 61 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 62 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 63 *
bogdanm 0:9b334a45a8ff 64 ******************************************************************************
bogdanm 0:9b334a45a8ff 65 */
bogdanm 0:9b334a45a8ff 66
bogdanm 0:9b334a45a8ff 67 /* Includes ------------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 68 #include "stm32l0xx_hal.h"
bogdanm 0:9b334a45a8ff 69
bogdanm 0:9b334a45a8ff 70 /** @addtogroup STM32L0xx_HAL_Driver
bogdanm 0:9b334a45a8ff 71 * @{
bogdanm 0:9b334a45a8ff 72 */
bogdanm 0:9b334a45a8ff 73
bogdanm 0:9b334a45a8ff 74 /** @addtogroup FLASHEx
bogdanm 0:9b334a45a8ff 75 * @brief FLASH HAL Extension module driver
bogdanm 0:9b334a45a8ff 76 * @{
bogdanm 0:9b334a45a8ff 77 */
bogdanm 0:9b334a45a8ff 78
bogdanm 0:9b334a45a8ff 79 #ifdef HAL_FLASH_MODULE_ENABLED
bogdanm 0:9b334a45a8ff 80
bogdanm 0:9b334a45a8ff 81 /* Private typedef -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 82 /* Private define ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 83 /* Private macro -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 84 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 85 /* Private function prototypes -----------------------------------------------*/
bogdanm 0:9b334a45a8ff 86 static HAL_StatusTypeDef FLASH_OB_RDPConfig(uint8_t OB_RDP);
bogdanm 0:9b334a45a8ff 87 static HAL_StatusTypeDef FLASH_OB_BORConfig(uint8_t OB_BOR);
bogdanm 0:9b334a45a8ff 88 static uint8_t FLASH_OB_GetUser(void);
bogdanm 0:9b334a45a8ff 89 static uint8_t FLASH_OB_GetRDP(void);
bogdanm 0:9b334a45a8ff 90 static uint8_t FLASH_OB_GetBOR(void);
bogdanm 0:9b334a45a8ff 91 static uint8_t FLASH_OB_GetBOOTBit1(void);
bogdanm 0:9b334a45a8ff 92 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 93 static HAL_StatusTypeDef FLASH_OB_ProtectedSectorsConfig(uint32_t Sector, uint32_t Sector2, uint32_t NewState);
bogdanm 0:9b334a45a8ff 94 #else
bogdanm 0:9b334a45a8ff 95 static HAL_StatusTypeDef FLASH_OB_ProtectedSectorsConfig(uint32_t Sector, uint32_t NewState);
bogdanm 0:9b334a45a8ff 96 #endif
bogdanm 0:9b334a45a8ff 97 static HAL_StatusTypeDef FLASH_OB_PCROPSelectionConfig(uint32_t WPRMOD);
bogdanm 0:9b334a45a8ff 98 static uint32_t FLASH_OB_GetWRP(void);
bogdanm 0:9b334a45a8ff 99 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 100 static uint32_t FLASH_OB_GetWRP2(void);
bogdanm 0:9b334a45a8ff 101 #endif
bogdanm 0:9b334a45a8ff 102 static HAL_StatusTypeDef FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY);
bogdanm 0:9b334a45a8ff 103 static HAL_StatusTypeDef FLASH_OB_BOOTBit1Config(uint8_t OB_BOOT_Bit1);
bogdanm 0:9b334a45a8ff 104 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 105 static HAL_StatusTypeDef FLASH_OB_BFB2Config(uint8_t OB_BFB2);
bogdanm 0:9b334a45a8ff 106 #endif
bogdanm 0:9b334a45a8ff 107
bogdanm 0:9b334a45a8ff 108 /* Exported functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 109
bogdanm 0:9b334a45a8ff 110 /** @addtogroup FLASHEx_Exported_Functions
bogdanm 0:9b334a45a8ff 111 * @{
bogdanm 0:9b334a45a8ff 112 */
bogdanm 0:9b334a45a8ff 113
bogdanm 0:9b334a45a8ff 114 /** @addtogroup FLASHEx_Exported_Functions_Group1
bogdanm 0:9b334a45a8ff 115 * @brief FLASH Memory Erasing functions
bogdanm 0:9b334a45a8ff 116 *
bogdanm 0:9b334a45a8ff 117 @verbatim
bogdanm 0:9b334a45a8ff 118 ==============================================================================
bogdanm 0:9b334a45a8ff 119 ##### FLASH Erasing Programming functions #####
bogdanm 0:9b334a45a8ff 120 ==============================================================================
bogdanm 0:9b334a45a8ff 121
bogdanm 0:9b334a45a8ff 122 [..] The FLASH Memory Erasing functions, includes the following functions:
bogdanm 0:9b334a45a8ff 123 (+) HAL_FLASHEx_Erase: return only when erase has been done
bogdanm 0:9b334a45a8ff 124 (+) HAL_FLASHEx_Erase_IT: end of erase is done when HAL_FLASH_EndOfOperationCallback is called with parameter
bogdanm 0:9b334a45a8ff 125 0xFFFFFFFF
bogdanm 0:9b334a45a8ff 126
bogdanm 0:9b334a45a8ff 127 [..] Any operation of erase should follow these steps:
bogdanm 0:9b334a45a8ff 128 (#) Call the HAL_FLASH_Unlock() function to enable the flash control register and
bogdanm 0:9b334a45a8ff 129 program memory access.
bogdanm 0:9b334a45a8ff 130 (#) Call the desired function to erase page.
bogdanm 0:9b334a45a8ff 131 (#) Call the HAL_FLASH_Lock() to disable the flash program memory access
bogdanm 0:9b334a45a8ff 132 (recommended to protect the FLASH memory against possible unwanted operation).
bogdanm 0:9b334a45a8ff 133
bogdanm 0:9b334a45a8ff 134 @endverbatim
bogdanm 0:9b334a45a8ff 135 * @{
bogdanm 0:9b334a45a8ff 136 */
bogdanm 0:9b334a45a8ff 137
bogdanm 0:9b334a45a8ff 138 /**
bogdanm 0:9b334a45a8ff 139 * @brief Erase the specified FLASH memory Pages
bogdanm 0:9b334a45a8ff 140 * @note To correctly run this function, the HAL_FLASH_Unlock() function
bogdanm 0:9b334a45a8ff 141 * must be called before.
bogdanm 0:9b334a45a8ff 142 * Call the HAL_FLASH_Lock() to disable the flash memory access
bogdanm 0:9b334a45a8ff 143 * (recommended to protect the FLASH memory against possible unwanted operation)
bogdanm 0:9b334a45a8ff 144 * @param[in] pEraseInit: pointer to an FLASH_EraseInitTypeDef structure that
bogdanm 0:9b334a45a8ff 145 * contains the configuration information for the erasing.
bogdanm 0:9b334a45a8ff 146 *
bogdanm 0:9b334a45a8ff 147 * @param[out] PageError: pointer to variable that
bogdanm 0:9b334a45a8ff 148 * contains the configuration information on faulty sector in case of error
bogdanm 0:9b334a45a8ff 149 * (0xFFFFFFFF means that all the sectors have been correctly erased)
bogdanm 0:9b334a45a8ff 150 *
bogdanm 0:9b334a45a8ff 151 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 152 */
bogdanm 0:9b334a45a8ff 153 HAL_StatusTypeDef HAL_FLASHEx_Erase(FLASH_EraseInitTypeDef *pEraseInit, uint32_t *PageError)
bogdanm 0:9b334a45a8ff 154 {
bogdanm 0:9b334a45a8ff 155 HAL_StatusTypeDef status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 156 uint32_t index = 0;
bogdanm 0:9b334a45a8ff 157
bogdanm 0:9b334a45a8ff 158 /* Process Locked */
bogdanm 0:9b334a45a8ff 159 __HAL_LOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 160
bogdanm 0:9b334a45a8ff 161 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 162 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 163
bogdanm 0:9b334a45a8ff 164 if (status == HAL_OK)
bogdanm 0:9b334a45a8ff 165 {
bogdanm 0:9b334a45a8ff 166 /* Clean the error context */
bogdanm 0:9b334a45a8ff 167 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 168
bogdanm 0:9b334a45a8ff 169 /*Initialization of PageError variable*/
bogdanm 0:9b334a45a8ff 170 *PageError = 0xFFFFFFFF;
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 /* Check the parameters */
bogdanm 0:9b334a45a8ff 173 assert_param(IS_NBPAGES(pEraseInit->NbPages));
bogdanm 0:9b334a45a8ff 174 assert_param(IS_FLASH_TYPEERASE(pEraseInit->TypeErase));
bogdanm 0:9b334a45a8ff 175 assert_param(IS_FLASH_PROGRAM_ADDRESS(pEraseInit->PageAddress));
bogdanm 0:9b334a45a8ff 176 assert_param(IS_FLASH_PROGRAM_ADDRESS(pEraseInit->PageAddress + pEraseInit->NbPages * FLASH_PAGE_SIZE - 1));
bogdanm 0:9b334a45a8ff 177
bogdanm 0:9b334a45a8ff 178 /* Erase by sector by sector to be done*/
bogdanm 0:9b334a45a8ff 179 for(index = pEraseInit->PageAddress; index < ((pEraseInit->NbPages * FLASH_PAGE_SIZE)+ pEraseInit->PageAddress); index += FLASH_PAGE_SIZE)
bogdanm 0:9b334a45a8ff 180 {
bogdanm 0:9b334a45a8ff 181 FLASH_ErasePage(index);
bogdanm 0:9b334a45a8ff 182
bogdanm 0:9b334a45a8ff 183 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 184 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 185
bogdanm 0:9b334a45a8ff 186 /* If the erase operation is completed, disable the ERASE Bit */
bogdanm 0:9b334a45a8ff 187 CLEAR_BIT(FLASH->PECR, FLASH_PECR_PROG);
bogdanm 0:9b334a45a8ff 188 CLEAR_BIT(FLASH->PECR, FLASH_PECR_ERASE);
bogdanm 0:9b334a45a8ff 189
bogdanm 0:9b334a45a8ff 190 if (status != HAL_OK)
bogdanm 0:9b334a45a8ff 191 {
bogdanm 0:9b334a45a8ff 192 /* In case of error, stop erase procedure and return the faulty sector*/
bogdanm 0:9b334a45a8ff 193 *PageError = index;
bogdanm 0:9b334a45a8ff 194 break;
bogdanm 0:9b334a45a8ff 195 }
bogdanm 0:9b334a45a8ff 196 }
bogdanm 0:9b334a45a8ff 197 }
bogdanm 0:9b334a45a8ff 198
bogdanm 0:9b334a45a8ff 199 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 200 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 201
bogdanm 0:9b334a45a8ff 202 return status;
bogdanm 0:9b334a45a8ff 203 }
bogdanm 0:9b334a45a8ff 204
bogdanm 0:9b334a45a8ff 205 /**
bogdanm 0:9b334a45a8ff 206 * @brief Perform a page erase of the specified FLASH memory pages with interrupt enabled
bogdanm 0:9b334a45a8ff 207 * @note To correctly run this function, the HAL_FLASH_Unlock() function
bogdanm 0:9b334a45a8ff 208 * must be called before.
bogdanm 0:9b334a45a8ff 209 * Call the HAL_FLASH_Lock() to disable the flash memory access
bogdanm 0:9b334a45a8ff 210 * (recommended to protect the FLASH memory against possible unwanted operation).
bogdanm 0:9b334a45a8ff 211 End of erase is done when HAL_FLASH_EndOfOperationCallback is called with parameter
bogdanm 0:9b334a45a8ff 212 0xFFFFFFFF
bogdanm 0:9b334a45a8ff 213 * @param pEraseInit: pointer to an FLASH_EraseInitTypeDef structure that
bogdanm 0:9b334a45a8ff 214 * contains the configuration information for the erasing.
bogdanm 0:9b334a45a8ff 215 *
bogdanm 0:9b334a45a8ff 216 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 217 */
bogdanm 0:9b334a45a8ff 218 HAL_StatusTypeDef HAL_FLASHEx_Erase_IT(FLASH_EraseInitTypeDef *pEraseInit)
bogdanm 0:9b334a45a8ff 219 {
bogdanm 0:9b334a45a8ff 220 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 221
bogdanm 0:9b334a45a8ff 222 /* Process Locked */
bogdanm 0:9b334a45a8ff 223 __HAL_LOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 224
bogdanm 0:9b334a45a8ff 225 /* Enable End of FLASH Operation interrupt */
bogdanm 0:9b334a45a8ff 226 __HAL_FLASH_ENABLE_IT(FLASH_IT_EOP);
bogdanm 0:9b334a45a8ff 227
bogdanm 0:9b334a45a8ff 228 /* Enable Error source interrupt */
bogdanm 0:9b334a45a8ff 229 __HAL_FLASH_ENABLE_IT(FLASH_IT_ERR);
bogdanm 0:9b334a45a8ff 230
bogdanm 0:9b334a45a8ff 231 /* Check the parameters */
bogdanm 0:9b334a45a8ff 232 assert_param(IS_NBPAGES(pEraseInit->NbPages));
bogdanm 0:9b334a45a8ff 233 assert_param(IS_FLASH_TYPEERASE(pEraseInit->TypeErase));
bogdanm 0:9b334a45a8ff 234 assert_param(IS_FLASH_PROGRAM_ADDRESS(pEraseInit->PageAddress));
bogdanm 0:9b334a45a8ff 235 assert_param(IS_FLASH_PROGRAM_ADDRESS(pEraseInit->PageAddress + pEraseInit->NbPages * FLASH_PAGE_SIZE - 1));
bogdanm 0:9b334a45a8ff 236
bogdanm 0:9b334a45a8ff 237 /* Clean the error context */
bogdanm 0:9b334a45a8ff 238 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 239 ProcFlash.ProcedureOnGoing = FLASH_PROC_PAGEERASE;
bogdanm 0:9b334a45a8ff 240 ProcFlash.NbPagesToErase = pEraseInit->NbPages;
bogdanm 0:9b334a45a8ff 241 ProcFlash.Page = pEraseInit->PageAddress;
bogdanm 0:9b334a45a8ff 242
bogdanm 0:9b334a45a8ff 243 /* Erase 1st page and wait for IT */
bogdanm 0:9b334a45a8ff 244 FLASH_ErasePage(pEraseInit->PageAddress);
bogdanm 0:9b334a45a8ff 245 return status;
bogdanm 0:9b334a45a8ff 246 }
bogdanm 0:9b334a45a8ff 247
bogdanm 0:9b334a45a8ff 248 /**
bogdanm 0:9b334a45a8ff 249 * @}
bogdanm 0:9b334a45a8ff 250 */
bogdanm 0:9b334a45a8ff 251
bogdanm 0:9b334a45a8ff 252
bogdanm 0:9b334a45a8ff 253 /** @addtogroup FLASHEx_Exported_Functions_Group2
bogdanm 0:9b334a45a8ff 254 * @brief Option Bytes Programming functions
bogdanm 0:9b334a45a8ff 255 *
bogdanm 0:9b334a45a8ff 256 @verbatim
bogdanm 0:9b334a45a8ff 257 ==============================================================================
bogdanm 0:9b334a45a8ff 258 ##### Option Bytes Programming functions #####
bogdanm 0:9b334a45a8ff 259 ==============================================================================
bogdanm 0:9b334a45a8ff 260
bogdanm 0:9b334a45a8ff 261 [..] Any operation of erase or program should follow these steps:
bogdanm 0:9b334a45a8ff 262 (#) Call the HAL_FLASH_OB_Unlock() function to enable the Flash option control
bogdanm 0:9b334a45a8ff 263 register access.
bogdanm 0:9b334a45a8ff 264 (#) Call following function to program the desired option bytes.
bogdanm 0:9b334a45a8ff 265 (++) HAL_FLASHEx_OBProgram:
bogdanm 0:9b334a45a8ff 266 - To Enable/Disable the desired sector write protection.
bogdanm 0:9b334a45a8ff 267 - To set the desired read Protection Level.
bogdanm 0:9b334a45a8ff 268 - To configure the user option Bytes: IWDG, STOP and the Standby.
bogdanm 0:9b334a45a8ff 269 - To Set the BOR level.
bogdanm 0:9b334a45a8ff 270 (#) Once all needed option bytes to be programmed are correctly written, call the
bogdanm 0:9b334a45a8ff 271 HAL_FLASH_OB_Launch(void) function to launch the Option Bytes programming process.
bogdanm 0:9b334a45a8ff 272 (#) Call the HAL_FLASH_OB_Lock() to disable the Flash option control register access (recommended
bogdanm 0:9b334a45a8ff 273 to protect the option Bytes against possible unwanted operations).
bogdanm 0:9b334a45a8ff 274
bogdanm 0:9b334a45a8ff 275 [..] Proprietary code Read Out Protection (PcROP):
bogdanm 0:9b334a45a8ff 276 (#) The PcROP sector is selected by using the same option bytes as the Write
bogdanm 0:9b334a45a8ff 277 protection (nWRPi bits). As a result, these 2 options are exclusive each other.
bogdanm 0:9b334a45a8ff 278 (#) In order to activate the PcROP (change the function of the nWRPi option bits),
bogdanm 0:9b334a45a8ff 279 the WPRMOD option bit must be activated.
bogdanm 0:9b334a45a8ff 280 (#) The active value of nWRPi bits is inverted when PCROP mode is active, this
bogdanm 0:9b334a45a8ff 281 means: if WPRMOD = 1 and nWRPi = 1 (default value), then the user sector "i"
bogdanm 0:9b334a45a8ff 282 is read/write protected.
bogdanm 0:9b334a45a8ff 283 (#) To activate PCROP mode for Flash sector(s), you need to call the following function:
bogdanm 0:9b334a45a8ff 284 (++) HAL_FLASHEx_AdvOBProgram in selecting sectors to be read/write protected
bogdanm 0:9b334a45a8ff 285 (++) HAL_FLASHEx_OB_SelectPCROP to enable the read/write protection
bogdanm 0:9b334a45a8ff 286 @endverbatim
bogdanm 0:9b334a45a8ff 287 * @{
bogdanm 0:9b334a45a8ff 288 */
bogdanm 0:9b334a45a8ff 289
bogdanm 0:9b334a45a8ff 290 /**
bogdanm 0:9b334a45a8ff 291 * @brief Program option bytes
bogdanm 0:9b334a45a8ff 292 * @param pOBInit: pointer to an FLASH_OBInitStruct structure that
bogdanm 0:9b334a45a8ff 293 * contains the configuration information for the programming.
bogdanm 0:9b334a45a8ff 294 *
bogdanm 0:9b334a45a8ff 295 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 296 */
bogdanm 0:9b334a45a8ff 297 HAL_StatusTypeDef HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit)
bogdanm 0:9b334a45a8ff 298 {
bogdanm 0:9b334a45a8ff 299 HAL_StatusTypeDef status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 300
bogdanm 0:9b334a45a8ff 301 /* Process Locked */
bogdanm 0:9b334a45a8ff 302 __HAL_LOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 303
bogdanm 0:9b334a45a8ff 304 /* Check the parameters */
bogdanm 0:9b334a45a8ff 305 assert_param(IS_OPTIONBYTE(pOBInit->OptionType));
bogdanm 0:9b334a45a8ff 306
bogdanm 0:9b334a45a8ff 307 /* Write protection configuration */
bogdanm 0:9b334a45a8ff 308 if((pOBInit->OptionType & OPTIONBYTE_WRP) == OPTIONBYTE_WRP)
bogdanm 0:9b334a45a8ff 309 {
bogdanm 0:9b334a45a8ff 310 assert_param(IS_WRPSTATE(pOBInit->WRPState));
bogdanm 0:9b334a45a8ff 311 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 312 status = FLASH_OB_ProtectedSectorsConfig(pOBInit->WRPSector, pOBInit->WRPSector2, pOBInit->WRPState);
bogdanm 0:9b334a45a8ff 313 #else
bogdanm 0:9b334a45a8ff 314 status = FLASH_OB_ProtectedSectorsConfig(pOBInit->WRPSector, pOBInit->WRPState);
bogdanm 0:9b334a45a8ff 315 #endif
bogdanm 0:9b334a45a8ff 316 if (status != HAL_OK)
bogdanm 0:9b334a45a8ff 317 {
bogdanm 0:9b334a45a8ff 318 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 319 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 320 return status;
bogdanm 0:9b334a45a8ff 321 }
bogdanm 0:9b334a45a8ff 322 }
bogdanm 0:9b334a45a8ff 323
bogdanm 0:9b334a45a8ff 324 /* Read protection configuration */
bogdanm 0:9b334a45a8ff 325 if((pOBInit->OptionType & OPTIONBYTE_RDP) == OPTIONBYTE_RDP)
bogdanm 0:9b334a45a8ff 326 {
bogdanm 0:9b334a45a8ff 327 status = FLASH_OB_RDPConfig(pOBInit->RDPLevel);
bogdanm 0:9b334a45a8ff 328 if (status != HAL_OK)
bogdanm 0:9b334a45a8ff 329 {
bogdanm 0:9b334a45a8ff 330 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 331 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 332 return status;
bogdanm 0:9b334a45a8ff 333 }
bogdanm 0:9b334a45a8ff 334 }
bogdanm 0:9b334a45a8ff 335
bogdanm 0:9b334a45a8ff 336 /* USER configuration */
bogdanm 0:9b334a45a8ff 337 if((pOBInit->OptionType & OPTIONBYTE_USER) == OPTIONBYTE_USER)
bogdanm 0:9b334a45a8ff 338 {
bogdanm 0:9b334a45a8ff 339 status = FLASH_OB_UserConfig(pOBInit->USERConfig & OB_IWDG_SW,
bogdanm 0:9b334a45a8ff 340 pOBInit->USERConfig & OB_STOP_NORST,
bogdanm 0:9b334a45a8ff 341 pOBInit->USERConfig & OB_STDBY_NORST);
bogdanm 0:9b334a45a8ff 342 if (status != HAL_OK)
bogdanm 0:9b334a45a8ff 343 {
bogdanm 0:9b334a45a8ff 344 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 345 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 346 return status;
bogdanm 0:9b334a45a8ff 347 }
bogdanm 0:9b334a45a8ff 348 }
bogdanm 0:9b334a45a8ff 349
bogdanm 0:9b334a45a8ff 350 /* BOR Level configuration */
bogdanm 0:9b334a45a8ff 351 if((pOBInit->OptionType & OPTIONBYTE_BOR) == OPTIONBYTE_BOR)
bogdanm 0:9b334a45a8ff 352 {
bogdanm 0:9b334a45a8ff 353 status = FLASH_OB_BORConfig(pOBInit->BORLevel);
bogdanm 0:9b334a45a8ff 354 }
bogdanm 0:9b334a45a8ff 355
bogdanm 0:9b334a45a8ff 356 /* Program BOOT Bit1 config option byte */
bogdanm 0:9b334a45a8ff 357 if ((pOBInit->OptionType & OPTIONBYTE_BOOT_BIT1) == OPTIONBYTE_BOOT_BIT1)
bogdanm 0:9b334a45a8ff 358 {
bogdanm 0:9b334a45a8ff 359 status = FLASH_OB_BOOTBit1Config(pOBInit->BOOTBit1Config);
bogdanm 0:9b334a45a8ff 360 }
bogdanm 0:9b334a45a8ff 361
bogdanm 0:9b334a45a8ff 362 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 363 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 364 return status;
bogdanm 0:9b334a45a8ff 365 }
bogdanm 0:9b334a45a8ff 366
bogdanm 0:9b334a45a8ff 367 /**
bogdanm 0:9b334a45a8ff 368 * @brief Get the Option byte configuration
bogdanm 0:9b334a45a8ff 369 * @param pOBInit: pointer to an FLASH_OBInitStruct structure that
bogdanm 0:9b334a45a8ff 370 * contains the configuration information for the programming.
bogdanm 0:9b334a45a8ff 371 *
bogdanm 0:9b334a45a8ff 372 * @retval None
bogdanm 0:9b334a45a8ff 373 */
bogdanm 0:9b334a45a8ff 374 void HAL_FLASHEx_OBGetConfig(FLASH_OBProgramInitTypeDef *pOBInit)
bogdanm 0:9b334a45a8ff 375 {
bogdanm 0:9b334a45a8ff 376 pOBInit->OptionType = OPTIONBYTE_WRP | OPTIONBYTE_RDP | OPTIONBYTE_USER | OPTIONBYTE_BOR;
bogdanm 0:9b334a45a8ff 377
bogdanm 0:9b334a45a8ff 378 /* Get WRP sector */
bogdanm 0:9b334a45a8ff 379 pOBInit->WRPSector = FLASH_OB_GetWRP();
bogdanm 0:9b334a45a8ff 380
bogdanm 0:9b334a45a8ff 381 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 382 pOBInit->WRPSector2 = FLASH_OB_GetWRP2();
bogdanm 0:9b334a45a8ff 383 #endif
bogdanm 0:9b334a45a8ff 384
bogdanm 0:9b334a45a8ff 385 /* Get RDP Level */
bogdanm 0:9b334a45a8ff 386 pOBInit->RDPLevel = FLASH_OB_GetRDP();
bogdanm 0:9b334a45a8ff 387
bogdanm 0:9b334a45a8ff 388 /* Get USER */
bogdanm 0:9b334a45a8ff 389 pOBInit->USERConfig = FLASH_OB_GetUser();
bogdanm 0:9b334a45a8ff 390
bogdanm 0:9b334a45a8ff 391 /* Get BOR Level */
bogdanm 0:9b334a45a8ff 392 pOBInit->BORLevel = FLASH_OB_GetBOR();
bogdanm 0:9b334a45a8ff 393
bogdanm 0:9b334a45a8ff 394 /* Get BOOT bit 1 config OB */
bogdanm 0:9b334a45a8ff 395 pOBInit->BOOTBit1Config = FLASH_OB_GetBOOTBit1();
bogdanm 0:9b334a45a8ff 396
bogdanm 0:9b334a45a8ff 397 }
bogdanm 0:9b334a45a8ff 398
bogdanm 0:9b334a45a8ff 399 /**
bogdanm 0:9b334a45a8ff 400 * @brief Program option bytes
bogdanm 0:9b334a45a8ff 401 * @param pAdvOBInit: pointer to an FLASH_AdvOBProgramInitTypeDef structure that
bogdanm 0:9b334a45a8ff 402 * contains the configuration information for the programming.
bogdanm 0:9b334a45a8ff 403 *
bogdanm 0:9b334a45a8ff 404 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 405 */
bogdanm 0:9b334a45a8ff 406 HAL_StatusTypeDef HAL_FLASHEx_AdvOBProgram (FLASH_AdvOBProgramInitTypeDef *pAdvOBInit)
bogdanm 0:9b334a45a8ff 407 {
bogdanm 0:9b334a45a8ff 408 HAL_StatusTypeDef status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 409
bogdanm 0:9b334a45a8ff 410 /* Check the parameters */
bogdanm 0:9b334a45a8ff 411 assert_param(IS_OBEX(pAdvOBInit->OptionType));
bogdanm 0:9b334a45a8ff 412
bogdanm 0:9b334a45a8ff 413 /* Program PCROP option byte */
bogdanm 0:9b334a45a8ff 414 if ((pAdvOBInit->OptionType & OPTIONBYTE_PCROP) == OPTIONBYTE_PCROP)
bogdanm 0:9b334a45a8ff 415 {
bogdanm 0:9b334a45a8ff 416 /* Check the parameters */
bogdanm 0:9b334a45a8ff 417 assert_param(IS_PCROPSTATE(pAdvOBInit->PCROPState));
bogdanm 0:9b334a45a8ff 418 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 419 status = FLASH_OB_ProtectedSectorsConfig(pAdvOBInit->PCROPSector, pAdvOBInit->PCROPSector2, pAdvOBInit->PCROPState);
bogdanm 0:9b334a45a8ff 420 #else
bogdanm 0:9b334a45a8ff 421 status = FLASH_OB_ProtectedSectorsConfig(pAdvOBInit->PCROPSector, pAdvOBInit->PCROPState);
bogdanm 0:9b334a45a8ff 422 #endif
bogdanm 0:9b334a45a8ff 423 }
bogdanm 0:9b334a45a8ff 424 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 425 if ((pAdvOBInit->OptionType & OPTIONBYTE_BOOTCONFIG) == OPTIONBYTE_BOOTCONFIG)
bogdanm 0:9b334a45a8ff 426 {
bogdanm 0:9b334a45a8ff 427 status = FLASH_OB_BFB2Config(pAdvOBInit->BootConfig);
bogdanm 0:9b334a45a8ff 428 }
bogdanm 0:9b334a45a8ff 429 #endif
bogdanm 0:9b334a45a8ff 430
bogdanm 0:9b334a45a8ff 431 return status;
bogdanm 0:9b334a45a8ff 432 }
bogdanm 0:9b334a45a8ff 433
bogdanm 0:9b334a45a8ff 434 /**
bogdanm 0:9b334a45a8ff 435 * @brief Get the OBEX byte configuration
bogdanm 0:9b334a45a8ff 436 * @param pAdvOBInit: pointer to an FLASH_AdvOBProgramInitTypeDef structure that
bogdanm 0:9b334a45a8ff 437 * contains the configuration information for the programming.
bogdanm 0:9b334a45a8ff 438 *
bogdanm 0:9b334a45a8ff 439 * @retval None
bogdanm 0:9b334a45a8ff 440 */
bogdanm 0:9b334a45a8ff 441 void HAL_FLASHEx_AdvOBGetConfig(FLASH_AdvOBProgramInitTypeDef *pAdvOBInit)
bogdanm 0:9b334a45a8ff 442 {
bogdanm 0:9b334a45a8ff 443 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 444 pAdvOBInit->OptionType = OPTIONBYTE_PCROP| OPTIONBYTE_BOOTCONFIG;
bogdanm 0:9b334a45a8ff 445 #else
bogdanm 0:9b334a45a8ff 446 pAdvOBInit->OptionType = OPTIONBYTE_PCROP;
bogdanm 0:9b334a45a8ff 447 #endif
bogdanm 0:9b334a45a8ff 448 /* Get PCROP state */
bogdanm 0:9b334a45a8ff 449 pAdvOBInit->PCROPState = (FLASH->OPTR & FLASH_OPTR_WPRMOD) >> 8;
bogdanm 0:9b334a45a8ff 450 /* Get PCROP protected sector */
bogdanm 0:9b334a45a8ff 451 pAdvOBInit->PCROPSector = FLASH->WRPR;
bogdanm 0:9b334a45a8ff 452
bogdanm 0:9b334a45a8ff 453 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 454 /* Get PCROP protected sector */
bogdanm 0:9b334a45a8ff 455 pAdvOBInit->PCROPSector2 = FLASH->WRPR2;
bogdanm 0:9b334a45a8ff 456
bogdanm 0:9b334a45a8ff 457 /* Get boot bank config */
bogdanm 0:9b334a45a8ff 458 pAdvOBInit->BootConfig = (FLASH->OPTR & FLASH_OPTR_BFB2) >> 23;
bogdanm 0:9b334a45a8ff 459 #endif
bogdanm 0:9b334a45a8ff 460 }
bogdanm 0:9b334a45a8ff 461
bogdanm 0:9b334a45a8ff 462 /**
bogdanm 0:9b334a45a8ff 463 * @brief Select the Protection Mode (WPRMOD).
bogdanm 0:9b334a45a8ff 464 * @note Once WPRMOD bit is active, unprotection of a protected sector is not possible
bogdanm 0:9b334a45a8ff 465 * @note Read a protected sector will set RDERR Flag and write a protected sector will set WRPERR Flag
bogdanm 0:9b334a45a8ff 466 * @param None
bogdanm 0:9b334a45a8ff 467 * @retval HAL status
bogdanm 0:9b334a45a8ff 468 */
bogdanm 0:9b334a45a8ff 469 HAL_StatusTypeDef HAL_FLASHEx_OB_SelectPCROP(void)
bogdanm 0:9b334a45a8ff 470 {
bogdanm 0:9b334a45a8ff 471 return (FLASH_OB_PCROPSelectionConfig(1));
bogdanm 0:9b334a45a8ff 472 }
bogdanm 0:9b334a45a8ff 473
bogdanm 0:9b334a45a8ff 474 /**
bogdanm 0:9b334a45a8ff 475 * @brief Deselect the Protection Mode (WPRMOD).
bogdanm 0:9b334a45a8ff 476 * @note Once WPRMOD bit is active, unprotection of a protected sector is not possible
bogdanm 0:9b334a45a8ff 477 * @note Read a protected sector will set RDERR Flag and write a protected sector will set WRPERR Flag
bogdanm 0:9b334a45a8ff 478 * @param None
bogdanm 0:9b334a45a8ff 479 * @retval HAL status
bogdanm 0:9b334a45a8ff 480 */
bogdanm 0:9b334a45a8ff 481 HAL_StatusTypeDef HAL_FLASHEx_OB_DeSelectPCROP(void)
bogdanm 0:9b334a45a8ff 482 {
bogdanm 0:9b334a45a8ff 483 return (FLASH_OB_PCROPSelectionConfig(0));
bogdanm 0:9b334a45a8ff 484 }
bogdanm 0:9b334a45a8ff 485
bogdanm 0:9b334a45a8ff 486 /**
bogdanm 0:9b334a45a8ff 487 * @}
bogdanm 0:9b334a45a8ff 488 */
bogdanm 0:9b334a45a8ff 489
bogdanm 0:9b334a45a8ff 490 /** @addtogroup FLASHEx_Exported_Functions_Group3
bogdanm 0:9b334a45a8ff 491 * @brief DATA EEPROM Programming functions
bogdanm 0:9b334a45a8ff 492 *
bogdanm 0:9b334a45a8ff 493 @verbatim
bogdanm 0:9b334a45a8ff 494 ===============================================================================
bogdanm 0:9b334a45a8ff 495 ##### DATA EEPROM Programming functions #####
bogdanm 0:9b334a45a8ff 496 ===============================================================================
bogdanm 0:9b334a45a8ff 497
bogdanm 0:9b334a45a8ff 498 [..] The FLASH_DATAEEPROM Programming_Functions, includes the following functions:
bogdanm 0:9b334a45a8ff 499 (+) HAL_FLASHEx_DATAEEPROM_Unlock(void);
bogdanm 0:9b334a45a8ff 500 (+) HAL_FLASHEx_DATAEEPROM_Lock(void);
bogdanm 0:9b334a45a8ff 501 (+) HAL_FLASHEx_DATAEEPROM_Erase(uint32_t Address)
bogdanm 0:9b334a45a8ff 502 (+) HAL_FLASHEx_DATAEEPROM_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
bogdanm 0:9b334a45a8ff 503
bogdanm 0:9b334a45a8ff 504 [..] Any operation of erase or program should follow these steps:
bogdanm 0:9b334a45a8ff 505 (#) Call the HAL_FLASHEx_DATAEEPROM_Unlock() function to enable the data EEPROM access
bogdanm 0:9b334a45a8ff 506 and Flash program erase control register access.
bogdanm 0:9b334a45a8ff 507 (#) Call the desired function to erase or program data.
bogdanm 0:9b334a45a8ff 508 (#) Call the HAL_FLASHEx_DATAEEPROM_Lock() to disable the data EEPROM access
bogdanm 0:9b334a45a8ff 509 and Flash program erase control register access(recommended
bogdanm 0:9b334a45a8ff 510 to protect the DATA_EEPROM against possible unwanted operation).
bogdanm 0:9b334a45a8ff 511
bogdanm 0:9b334a45a8ff 512 @endverbatim
bogdanm 0:9b334a45a8ff 513 * @{
bogdanm 0:9b334a45a8ff 514 */
bogdanm 0:9b334a45a8ff 515 /**
bogdanm 0:9b334a45a8ff 516 * @brief Unlocks the data memory and FLASH_PECR register access.
bogdanm 0:9b334a45a8ff 517 * @param None
bogdanm 0:9b334a45a8ff 518 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 519 */
bogdanm 0:9b334a45a8ff 520 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Unlock(void)
bogdanm 0:9b334a45a8ff 521 {
bogdanm 0:9b334a45a8ff 522 if((FLASH->PECR & FLASH_PECR_PELOCK) != RESET)
bogdanm 0:9b334a45a8ff 523 {
bogdanm 0:9b334a45a8ff 524 /* Unlocking the Data memory and FLASH_PECR register access */
bogdanm 0:9b334a45a8ff 525 FLASH->PEKEYR = FLASH_PEKEY1;
bogdanm 0:9b334a45a8ff 526 FLASH->PEKEYR = FLASH_PEKEY2;
bogdanm 0:9b334a45a8ff 527 return HAL_OK;
bogdanm 0:9b334a45a8ff 528 }
bogdanm 0:9b334a45a8ff 529 else
bogdanm 0:9b334a45a8ff 530 {
bogdanm 0:9b334a45a8ff 531 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 532 }
bogdanm 0:9b334a45a8ff 533 }
bogdanm 0:9b334a45a8ff 534
bogdanm 0:9b334a45a8ff 535 /**
bogdanm 0:9b334a45a8ff 536 * @brief Locks the Data memory and FLASH_PECR register access.
bogdanm 0:9b334a45a8ff 537 * @param None
bogdanm 0:9b334a45a8ff 538 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 539 */
bogdanm 0:9b334a45a8ff 540 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Lock(void)
bogdanm 0:9b334a45a8ff 541 {
bogdanm 0:9b334a45a8ff 542 /* Set the PELOCK Bit to lock the data memory and FLASH_PECR register access */
bogdanm 0:9b334a45a8ff 543 SET_BIT(FLASH->PECR, FLASH_PECR_PELOCK);
bogdanm 0:9b334a45a8ff 544 return HAL_OK;
bogdanm 0:9b334a45a8ff 545 }
bogdanm 0:9b334a45a8ff 546
bogdanm 0:9b334a45a8ff 547 /**
bogdanm 0:9b334a45a8ff 548 * @brief Erase a word in data memory.
bogdanm 0:9b334a45a8ff 549 * @param Address: specifies the address to be erased.
bogdanm 0:9b334a45a8ff 550 * @note To correctly run this function, the HAL_FLASHEx_DATAEEPROM_Unlock() function
bogdanm 0:9b334a45a8ff 551 * must be called before.
bogdanm 0:9b334a45a8ff 552 * Call the HAL_FLASHEx_DATAEEPROM_Lock() to the data EEPROM access
bogdanm 0:9b334a45a8ff 553 * and Flash program erase control register access(recommended to protect
bogdanm 0:9b334a45a8ff 554 * the DATA_EEPROM against possible unwanted operation).
bogdanm 0:9b334a45a8ff 555 * @retval HAL status
bogdanm 0:9b334a45a8ff 556 */
bogdanm 0:9b334a45a8ff 557 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Erase(uint32_t Address)
bogdanm 0:9b334a45a8ff 558 {
bogdanm 0:9b334a45a8ff 559 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 560
bogdanm 0:9b334a45a8ff 561 /* Check the parameters */
bogdanm 0:9b334a45a8ff 562 assert_param(IS_FLASH_DATA_ADDRESS(Address));
bogdanm 0:9b334a45a8ff 563
bogdanm 0:9b334a45a8ff 564 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 565 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 566
bogdanm 0:9b334a45a8ff 567 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 568 {
bogdanm 0:9b334a45a8ff 569 /* Clean the error context */
bogdanm 0:9b334a45a8ff 570 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 571
bogdanm 0:9b334a45a8ff 572 /* Write "00000000h" to valid address in the data memory" */
bogdanm 0:9b334a45a8ff 573 *(__IO uint32_t *) Address = 0x00000000;
bogdanm 0:9b334a45a8ff 574 }
bogdanm 0:9b334a45a8ff 575 return status;
bogdanm 0:9b334a45a8ff 576 }
bogdanm 0:9b334a45a8ff 577
bogdanm 0:9b334a45a8ff 578 /**
bogdanm 0:9b334a45a8ff 579 * @brief Program word at a specified address
bogdanm 0:9b334a45a8ff 580 * @param TypeProgram: Indicate the way to program at a specified address.
bogdanm 0:9b334a45a8ff 581 * This parameter can be a value of @ref FLASHEx_Type_Program_Data
bogdanm 0:9b334a45a8ff 582 * @param Address: specifies the address to be programmed.
bogdanm 0:9b334a45a8ff 583 * @param Data: specifies the data to be programmed
bogdanm 0:9b334a45a8ff 584 *
bogdanm 0:9b334a45a8ff 585 * @retval HAL_StatusTypeDef HAL Status
bogdanm 0:9b334a45a8ff 586 */
bogdanm 0:9b334a45a8ff 587
bogdanm 0:9b334a45a8ff 588 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data)
bogdanm 0:9b334a45a8ff 589 {
bogdanm 0:9b334a45a8ff 590 HAL_StatusTypeDef status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 591
bogdanm 0:9b334a45a8ff 592 /* Process Locked */
bogdanm 0:9b334a45a8ff 593 __HAL_LOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 594
bogdanm 0:9b334a45a8ff 595 /* Check the parameters */
bogdanm 0:9b334a45a8ff 596 assert_param(IS_TYPEPROGRAMDATA(TypeProgram));
bogdanm 0:9b334a45a8ff 597 assert_param(IS_FLASH_DATA_ADDRESS(Address));
bogdanm 0:9b334a45a8ff 598
bogdanm 0:9b334a45a8ff 599 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 600 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 601
bogdanm 0:9b334a45a8ff 602 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 603 {
bogdanm 0:9b334a45a8ff 604 /* Clean the error context */
bogdanm 0:9b334a45a8ff 605 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 606
bogdanm 0:9b334a45a8ff 607 if(TypeProgram == FLASH_TYPEPROGRAMDATA_WORD)
bogdanm 0:9b334a45a8ff 608 {
bogdanm 0:9b334a45a8ff 609 /* Program word (32-bit) at a specified address */
bogdanm 0:9b334a45a8ff 610 *(__IO uint32_t *)Address = Data;
bogdanm 0:9b334a45a8ff 611 }
bogdanm 0:9b334a45a8ff 612 else if(TypeProgram == FLASH_TYPEPROGRAMDATA_HALFWORD)
bogdanm 0:9b334a45a8ff 613 {
bogdanm 0:9b334a45a8ff 614 /* Program word (16-bit) at a specified address */
bogdanm 0:9b334a45a8ff 615 *(__IO uint16_t *)Address = (uint16_t) Data;
bogdanm 0:9b334a45a8ff 616 }
bogdanm 0:9b334a45a8ff 617 else if(TypeProgram == FLASH_TYPEPROGRAMDATA_BYTE)
bogdanm 0:9b334a45a8ff 618 {
bogdanm 0:9b334a45a8ff 619 /*Program word (8-bit) at a specified address */
bogdanm 0:9b334a45a8ff 620 *(__IO uint8_t *)Address = (uint8_t) Data;
bogdanm 0:9b334a45a8ff 621 }
bogdanm 0:9b334a45a8ff 622 else
bogdanm 0:9b334a45a8ff 623 {
bogdanm 0:9b334a45a8ff 624 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 625 }
bogdanm 0:9b334a45a8ff 626
bogdanm 0:9b334a45a8ff 627 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 628 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 629 }
bogdanm 0:9b334a45a8ff 630 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 631 __HAL_UNLOCK(&ProcFlash);
bogdanm 0:9b334a45a8ff 632 return status;
bogdanm 0:9b334a45a8ff 633 }
bogdanm 0:9b334a45a8ff 634
bogdanm 0:9b334a45a8ff 635 /**
bogdanm 0:9b334a45a8ff 636 * @brief Enable DATA EEPROM fixed Time programming (2*Tprog).
bogdanm 0:9b334a45a8ff 637 * @retval None
bogdanm 0:9b334a45a8ff 638 */
bogdanm 0:9b334a45a8ff 639 void HAL_FLASHEx_DATAEEPROM_EnableFixedTimeProgram(void)
bogdanm 0:9b334a45a8ff 640 {
bogdanm 0:9b334a45a8ff 641 SET_BIT(FLASH->PECR, FLASH_PECR_FIX);
bogdanm 0:9b334a45a8ff 642 }
bogdanm 0:9b334a45a8ff 643
bogdanm 0:9b334a45a8ff 644 /**
bogdanm 0:9b334a45a8ff 645 * @brief Disables DATA EEPROM fixed Time programming (2*Tprog).
bogdanm 0:9b334a45a8ff 646 * @retval None
bogdanm 0:9b334a45a8ff 647 */
bogdanm 0:9b334a45a8ff 648 void HAL_FLASHEx_DATAEEPROM_DisableFixedTimeProgram(void)
bogdanm 0:9b334a45a8ff 649 {
bogdanm 0:9b334a45a8ff 650 CLEAR_BIT(FLASH->PECR, FLASH_PECR_FIX);
bogdanm 0:9b334a45a8ff 651 }
bogdanm 0:9b334a45a8ff 652
bogdanm 0:9b334a45a8ff 653 /**
bogdanm 0:9b334a45a8ff 654 * @}
bogdanm 0:9b334a45a8ff 655 */
bogdanm 0:9b334a45a8ff 656
bogdanm 0:9b334a45a8ff 657 /**
bogdanm 0:9b334a45a8ff 658 * @brief Returns the FLASH User Option Bytes values.
bogdanm 0:9b334a45a8ff 659 * @param None
bogdanm 0:9b334a45a8ff 660 * @retval The FLASH User Option Bytes.
bogdanm 0:9b334a45a8ff 661 */
bogdanm 0:9b334a45a8ff 662 static uint8_t FLASH_OB_GetUser(void)
bogdanm 0:9b334a45a8ff 663 {
bogdanm 0:9b334a45a8ff 664 /* Return the User Option Byte */
bogdanm 0:9b334a45a8ff 665 return (uint8_t)((FLASH->OPTR & FLASH_OPTR_USER) >> 16);
bogdanm 0:9b334a45a8ff 666 }
bogdanm 0:9b334a45a8ff 667
bogdanm 0:9b334a45a8ff 668 /**
bogdanm 0:9b334a45a8ff 669 * @brief Returns the FLASH Read out Protection Level.
bogdanm 0:9b334a45a8ff 670 * @param None
bogdanm 0:9b334a45a8ff 671 * @retval FLASH RDP level.
bogdanm 0:9b334a45a8ff 672 */
bogdanm 0:9b334a45a8ff 673 static uint8_t FLASH_OB_GetRDP(void)
bogdanm 0:9b334a45a8ff 674 {
bogdanm 0:9b334a45a8ff 675 return (uint8_t)(FLASH->OPTR & FLASH_OPTR_RDPROT);
bogdanm 0:9b334a45a8ff 676 }
bogdanm 0:9b334a45a8ff 677
bogdanm 0:9b334a45a8ff 678 /**
bogdanm 0:9b334a45a8ff 679 * @brief Returns the FLASH BOR level.
bogdanm 0:9b334a45a8ff 680 * @param None
bogdanm 0:9b334a45a8ff 681 * @retval The BOR level Option Bytes.
bogdanm 0:9b334a45a8ff 682 */
bogdanm 0:9b334a45a8ff 683 static uint8_t FLASH_OB_GetBOR(void)
bogdanm 0:9b334a45a8ff 684 {
bogdanm 0:9b334a45a8ff 685 /* Return the BOR level */
bogdanm 0:9b334a45a8ff 686 return (uint8_t)((FLASH->OPTR & (uint32_t)FLASH_OPTR_BOR_LEV) >> 16);
bogdanm 0:9b334a45a8ff 687 }
bogdanm 0:9b334a45a8ff 688
bogdanm 0:9b334a45a8ff 689 /**
bogdanm 0:9b334a45a8ff 690 * @brief Returns the FLASH BOOT bit1 value.
bogdanm 0:9b334a45a8ff 691 * @param None
bogdanm 0:9b334a45a8ff 692 * @retval The BOOT bit 1 value Option Bytes.
bogdanm 0:9b334a45a8ff 693 */
bogdanm 0:9b334a45a8ff 694 static uint8_t FLASH_OB_GetBOOTBit1(void)
bogdanm 0:9b334a45a8ff 695 {
bogdanm 0:9b334a45a8ff 696 /* Return the BOR level */
bogdanm 0:9b334a45a8ff 697 return (FLASH->OPTR & FLASH_OPTR_BOOT1) >> 31;
bogdanm 0:9b334a45a8ff 698
bogdanm 0:9b334a45a8ff 699 }
bogdanm 0:9b334a45a8ff 700
bogdanm 0:9b334a45a8ff 701 /**
bogdanm 0:9b334a45a8ff 702 * @brief Returns the FLASH Write Protection Option Bytes value.
bogdanm 0:9b334a45a8ff 703 * @param None
bogdanm 0:9b334a45a8ff 704 * @retval The FLASH Write Protection Option Bytes value.
bogdanm 0:9b334a45a8ff 705 */
bogdanm 0:9b334a45a8ff 706 static uint32_t FLASH_OB_GetWRP(void)
bogdanm 0:9b334a45a8ff 707 {
bogdanm 0:9b334a45a8ff 708 /* Return the FLASH write protection Register value */
bogdanm 0:9b334a45a8ff 709 return (uint32_t)(FLASH->WRPR);
bogdanm 0:9b334a45a8ff 710 }
bogdanm 0:9b334a45a8ff 711
bogdanm 0:9b334a45a8ff 712 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 713 /**
bogdanm 0:9b334a45a8ff 714 * @brief Returns the FLASH Write Protection Option Bytes value.
bogdanm 0:9b334a45a8ff 715 * @param None
bogdanm 0:9b334a45a8ff 716 * @retval The FLASH Write Protection Option Bytes value.
bogdanm 0:9b334a45a8ff 717 */
bogdanm 0:9b334a45a8ff 718 static uint32_t FLASH_OB_GetWRP2(void)
bogdanm 0:9b334a45a8ff 719 {
bogdanm 0:9b334a45a8ff 720 /* Return the FLASH write protection Register value */
bogdanm 0:9b334a45a8ff 721 return (uint32_t)(FLASH->WRPR2);
bogdanm 0:9b334a45a8ff 722 }
bogdanm 0:9b334a45a8ff 723 #endif /* STM32L071xx || STM32L072xx || STM32L073xx || STM32L081xx || STM32L082xx || STM32L083xx */
bogdanm 0:9b334a45a8ff 724
bogdanm 0:9b334a45a8ff 725 /**
bogdanm 0:9b334a45a8ff 726 * @brief Programs the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY.
bogdanm 0:9b334a45a8ff 727 * @param OB_IWDG: Selects the WDG mode.
bogdanm 0:9b334a45a8ff 728 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 729 * @arg OB_IWDG_SW: Software WDG selected
bogdanm 0:9b334a45a8ff 730 * @arg OB_IWDG_HW: Hardware WDG selected
bogdanm 0:9b334a45a8ff 731 * @param OB_STOP: Reset event when entering STOP mode.
bogdanm 0:9b334a45a8ff 732 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 733 * @arg OB_STOP_NoRST: No reset generated when entering in STOP
bogdanm 0:9b334a45a8ff 734 * @arg OB_STOP_RST: Reset generated when entering in STOP
bogdanm 0:9b334a45a8ff 735 * @param OB_STDBY: Reset event when entering Standby mode.
bogdanm 0:9b334a45a8ff 736 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 737 * @arg OB_STDBY_NORST: No reset generated when entering in STANDBY
bogdanm 0:9b334a45a8ff 738 * @arg OB_STDBY_RST: Reset generated when entering in STANDBY
bogdanm 0:9b334a45a8ff 739 * @retval HAL status
bogdanm 0:9b334a45a8ff 740 */
bogdanm 0:9b334a45a8ff 741 static HAL_StatusTypeDef FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY)
bogdanm 0:9b334a45a8ff 742 {
bogdanm 0:9b334a45a8ff 743 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 744 uint32_t tmp = 0, tmp1 = 0, OB_Bits = (uint32_t) (OB_IWDG | OB_STOP | OB_STDBY);
bogdanm 0:9b334a45a8ff 745
bogdanm 0:9b334a45a8ff 746 /* Check the parameters */
bogdanm 0:9b334a45a8ff 747 assert_param(IS_OB_IWDG_SOURCE(OB_IWDG));
bogdanm 0:9b334a45a8ff 748 assert_param(IS_OB_STOP_SOURCE(OB_STOP));
bogdanm 0:9b334a45a8ff 749 assert_param(IS_OB_STDBY_SOURCE(OB_STDBY));
bogdanm 0:9b334a45a8ff 750
bogdanm 0:9b334a45a8ff 751 /* Clean the error context */
bogdanm 0:9b334a45a8ff 752 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 753
bogdanm 0:9b334a45a8ff 754 /* Get the User Option byte register */
bogdanm 0:9b334a45a8ff 755 tmp1 = OB->USER & ((~FLASH_OPTR_USER) >> 16);
bogdanm 0:9b334a45a8ff 756
bogdanm 0:9b334a45a8ff 757 /* Calculate the user option byte to write */
bogdanm 0:9b334a45a8ff 758 tmp = (~(OB_Bits | tmp1)) << 16;
bogdanm 0:9b334a45a8ff 759 tmp |= OB_Bits | tmp1;
bogdanm 0:9b334a45a8ff 760
bogdanm 0:9b334a45a8ff 761 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 762 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 763
bogdanm 0:9b334a45a8ff 764 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 765 {
bogdanm 0:9b334a45a8ff 766 /* Clean the error context */
bogdanm 0:9b334a45a8ff 767 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 768 /* Program OB */
bogdanm 0:9b334a45a8ff 769 OB->USER = tmp;
bogdanm 0:9b334a45a8ff 770 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 771 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 772 }
bogdanm 0:9b334a45a8ff 773 return status;
bogdanm 0:9b334a45a8ff 774 }
bogdanm 0:9b334a45a8ff 775
bogdanm 0:9b334a45a8ff 776 /**
bogdanm 0:9b334a45a8ff 777 * @brief Enables or disables the read out protection.
bogdanm 0:9b334a45a8ff 778 * @note To correctly run this function, the FLASH_OB_Unlock() function
bogdanm 0:9b334a45a8ff 779 * must be called before.
bogdanm 0:9b334a45a8ff 780 * @param OB_RDP: specifies the read protection level.
bogdanm 0:9b334a45a8ff 781 * This parameter can be:
bogdanm 0:9b334a45a8ff 782 * @arg OB_RDP_LEVEL0: No protection
bogdanm 0:9b334a45a8ff 783 * @arg OB_RDP_LEVEL1: Read protection of the memory
bogdanm 0:9b334a45a8ff 784 * @arg OB_RDP_LEVEL2: Chip protection
bogdanm 0:9b334a45a8ff 785 *
bogdanm 0:9b334a45a8ff 786 * !!!Warning!!! When enabling OB_RDP_LEVEL2 it's no more possible to go back to level 1 or 0
bogdanm 0:9b334a45a8ff 787 *
bogdanm 0:9b334a45a8ff 788 * @retval HAL status
bogdanm 0:9b334a45a8ff 789 */
bogdanm 0:9b334a45a8ff 790 static HAL_StatusTypeDef FLASH_OB_RDPConfig(uint8_t OB_RDP)
bogdanm 0:9b334a45a8ff 791 {
bogdanm 0:9b334a45a8ff 792 HAL_StatusTypeDef status;
bogdanm 0:9b334a45a8ff 793 uint32_t tmp = 0, tmp1 = 0, OB_Bits = (uint32_t) OB_RDP;
bogdanm 0:9b334a45a8ff 794
bogdanm 0:9b334a45a8ff 795 /* Check the parameters */
bogdanm 0:9b334a45a8ff 796 assert_param(IS_OB_RDP(OB_RDP));
bogdanm 0:9b334a45a8ff 797
bogdanm 0:9b334a45a8ff 798 /* Calculate the option byte to write */
bogdanm 0:9b334a45a8ff 799 tmp = (OB->RDP & ((~FLASH_OPTR_RDPROT) & 0x0000FFFF)) | OB_Bits;
bogdanm 0:9b334a45a8ff 800 tmp1 = (~tmp << 16) | tmp;
bogdanm 0:9b334a45a8ff 801
bogdanm 0:9b334a45a8ff 802 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 803 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 804
bogdanm 0:9b334a45a8ff 805 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 806 {
bogdanm 0:9b334a45a8ff 807 /* Clean the error context */
bogdanm 0:9b334a45a8ff 808 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 809 /* Program OB */
bogdanm 0:9b334a45a8ff 810 OB->RDP = tmp1;
bogdanm 0:9b334a45a8ff 811 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 812 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 813 }
bogdanm 0:9b334a45a8ff 814 return status;
bogdanm 0:9b334a45a8ff 815 }
bogdanm 0:9b334a45a8ff 816
bogdanm 0:9b334a45a8ff 817 /**
bogdanm 0:9b334a45a8ff 818 * @brief Programs the FLASH brownout reset threshold level Option Byte.
bogdanm 0:9b334a45a8ff 819 * @param OB_BOR: Selects the brownout reset threshold level.
bogdanm 0:9b334a45a8ff 820 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 821 * @arg OB_BOR_OFF: BOR is disabled at power down, the reset is asserted when the VDD
bogdanm 0:9b334a45a8ff 822 * power supply reaches the PDR(Power Down Reset) threshold (1.5V)
bogdanm 0:9b334a45a8ff 823 * @arg OB_BOR_LEVEL1: BOR Reset threshold levels for 1.7V - 1.8V VDD power supply
bogdanm 0:9b334a45a8ff 824 * @arg OB_BOR_LEVEL2: BOR Reset threshold levels for 1.9V - 2.0V VDD power supply
bogdanm 0:9b334a45a8ff 825 * @arg OB_BOR_LEVEL3: BOR Reset threshold levels for 2.3V - 2.4V VDD power supply
bogdanm 0:9b334a45a8ff 826 * @arg OB_BOR_LEVEL4: BOR Reset threshold levels for 2.55V - 2.65V VDD power supply
bogdanm 0:9b334a45a8ff 827 * @arg OB_BOR_LEVEL5: BOR Reset threshold levels for 2.8V - 2.9V VDD power supply
bogdanm 0:9b334a45a8ff 828 * @retval HAL status
bogdanm 0:9b334a45a8ff 829 */
bogdanm 0:9b334a45a8ff 830 static HAL_StatusTypeDef FLASH_OB_BORConfig(uint8_t OB_BOR)
bogdanm 0:9b334a45a8ff 831 {
bogdanm 0:9b334a45a8ff 832 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 833 uint32_t tmp = 0, tmp1 = 0, OB_Bits = (uint32_t) OB_BOR;
bogdanm 0:9b334a45a8ff 834
bogdanm 0:9b334a45a8ff 835 /* Check the parameters */
bogdanm 0:9b334a45a8ff 836 assert_param(IS_OB_BOR_LEVEL(OB_BOR));
bogdanm 0:9b334a45a8ff 837
bogdanm 0:9b334a45a8ff 838 /* Get the User Option byte register */
bogdanm 0:9b334a45a8ff 839 tmp1 = OB->USER & ((~FLASH_OPTR_BOR_LEV) >> 16);
bogdanm 0:9b334a45a8ff 840
bogdanm 0:9b334a45a8ff 841 /* Calculate the user option byte to write */
bogdanm 0:9b334a45a8ff 842 tmp = (~(OB_Bits | tmp1)) << 16;
bogdanm 0:9b334a45a8ff 843 tmp |= OB_Bits | tmp1;
bogdanm 0:9b334a45a8ff 844
bogdanm 0:9b334a45a8ff 845 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 846 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 847
bogdanm 0:9b334a45a8ff 848 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 849 {
bogdanm 0:9b334a45a8ff 850 /* Clean the error context */
bogdanm 0:9b334a45a8ff 851 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 852 /* Program OB */
bogdanm 0:9b334a45a8ff 853 OB->USER = tmp;
bogdanm 0:9b334a45a8ff 854 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 855 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 856 }
bogdanm 0:9b334a45a8ff 857
bogdanm 0:9b334a45a8ff 858 return status;
bogdanm 0:9b334a45a8ff 859 }
bogdanm 0:9b334a45a8ff 860
bogdanm 0:9b334a45a8ff 861 /**
bogdanm 0:9b334a45a8ff 862 * @brief Sets or resets the BOOT bit1 option bit.
bogdanm 0:9b334a45a8ff 863 * @param OB_BOOT_BIT1: Set or Reset the BOOT bit1 option bit.
bogdanm 0:9b334a45a8ff 864 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 865 * @arg OB_BOOT_BIT1_RESET: BOOT1 option bit reset
bogdanm 0:9b334a45a8ff 866 * @arg OB_BOOT_BIT1_SET: BOOT1 option bit set
bogdanm 0:9b334a45a8ff 867 * @retval HAL status
bogdanm 0:9b334a45a8ff 868 */
bogdanm 0:9b334a45a8ff 869 static HAL_StatusTypeDef FLASH_OB_BOOTBit1Config(uint8_t OB_BOOT_BIT1)
bogdanm 0:9b334a45a8ff 870 {
bogdanm 0:9b334a45a8ff 871 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 872 uint32_t tmp = 0, tmp1 = 0, OB_Bits = ((uint32_t) OB_BOOT_BIT1) << 15;
bogdanm 0:9b334a45a8ff 873
bogdanm 0:9b334a45a8ff 874 /* Check the parameters */
bogdanm 0:9b334a45a8ff 875 assert_param(IS_OB_BOOT1(OB_BOOT_BIT1));
bogdanm 0:9b334a45a8ff 876
bogdanm 0:9b334a45a8ff 877 /* Get the User Option byte register */
bogdanm 0:9b334a45a8ff 878 tmp1 = OB->USER & ((~FLASH_OPTR_BOOT1) >> 16);
bogdanm 0:9b334a45a8ff 879
bogdanm 0:9b334a45a8ff 880 /* Calculate the user option byte to write */
bogdanm 0:9b334a45a8ff 881 tmp = (~(OB_Bits | tmp1)) << 16;
bogdanm 0:9b334a45a8ff 882 tmp |= OB_Bits | tmp1;
bogdanm 0:9b334a45a8ff 883
bogdanm 0:9b334a45a8ff 884 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 885 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 886
bogdanm 0:9b334a45a8ff 887 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 888 {
bogdanm 0:9b334a45a8ff 889 /* Clean the error context */
bogdanm 0:9b334a45a8ff 890 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 891 /* Program OB */
bogdanm 0:9b334a45a8ff 892 OB->USER = tmp;
bogdanm 0:9b334a45a8ff 893 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 894 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 895 }
bogdanm 0:9b334a45a8ff 896
bogdanm 0:9b334a45a8ff 897 return status;
bogdanm 0:9b334a45a8ff 898 }
bogdanm 0:9b334a45a8ff 899
bogdanm 0:9b334a45a8ff 900 /**
bogdanm 0:9b334a45a8ff 901 * @brief Select the Protection Mode (WPRMOD).
bogdanm 0:9b334a45a8ff 902 * @note Once WPRMOD bit is active, unprotection of a protected sector is not possible
bogdanm 0:9b334a45a8ff 903 * @note Read a protected sector will set RDERR Flag and write a protected sector will set WRPERR Flag
bogdanm 0:9b334a45a8ff 904 * @param OB_PcROP: Select the Protection Mode of WPR bits.
bogdanm 0:9b334a45a8ff 905 * This parameter can be:
bogdanm 0:9b334a45a8ff 906 * @arg OB_PCROP_SELECTED: nWRP control the read&write protection (PcROP) of respective user sectors.
bogdanm 0:9b334a45a8ff 907 * @arg OB_PCROP_DESELECTED: nWRP control the write protection of respective user sectors.
bogdanm 0:9b334a45a8ff 908 * @retval HAL status
bogdanm 0:9b334a45a8ff 909 */
bogdanm 0:9b334a45a8ff 910 static HAL_StatusTypeDef FLASH_OB_PCROPSelectionConfig(uint32_t WPRMOD)
bogdanm 0:9b334a45a8ff 911 {
bogdanm 0:9b334a45a8ff 912 HAL_StatusTypeDef status;
bogdanm 0:9b334a45a8ff 913 uint32_t tmp = 0, tmp1 = 0, OB_Bits = ((uint32_t) WPRMOD) << 8;
bogdanm 0:9b334a45a8ff 914
bogdanm 0:9b334a45a8ff 915 /* Get the User Option byte register */
bogdanm 0:9b334a45a8ff 916 tmp1 = OB->USER & ((~FLASH_OPTR_WPRMOD) >> 16);
bogdanm 0:9b334a45a8ff 917
bogdanm 0:9b334a45a8ff 918 /* Calculate the user option byte to write */
bogdanm 0:9b334a45a8ff 919 tmp = (~(OB_Bits | tmp1)) << 16;
bogdanm 0:9b334a45a8ff 920 tmp |= OB_Bits | tmp1;
bogdanm 0:9b334a45a8ff 921
bogdanm 0:9b334a45a8ff 922 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 923 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 924
bogdanm 0:9b334a45a8ff 925 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 926 {
bogdanm 0:9b334a45a8ff 927 /* Clean the error context */
bogdanm 0:9b334a45a8ff 928 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 929 /* Program OB */
bogdanm 0:9b334a45a8ff 930 OB->RDP = tmp;
bogdanm 0:9b334a45a8ff 931 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 932 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 933 }
bogdanm 0:9b334a45a8ff 934
bogdanm 0:9b334a45a8ff 935 return status;
bogdanm 0:9b334a45a8ff 936 }
bogdanm 0:9b334a45a8ff 937
bogdanm 0:9b334a45a8ff 938 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 939 /**
bogdanm 0:9b334a45a8ff 940 * @brief Sets or resets the BFB2 option bit.
bogdanm 0:9b334a45a8ff 941 * @param BFB2: Set or Reset the BFB2 option bit.
bogdanm 0:9b334a45a8ff 942 * This parameter can be one of the following values:
bogdanm 0:9b334a45a8ff 943 * @arg OB_BOOT_BANK1: BFB2 option bit reset
bogdanm 0:9b334a45a8ff 944 * @arg OB_BOOT_BANK2: BFB2 option bit set
bogdanm 0:9b334a45a8ff 945 * @retval None
bogdanm 0:9b334a45a8ff 946 */
bogdanm 0:9b334a45a8ff 947 static HAL_StatusTypeDef FLASH_OB_BFB2Config(uint8_t OB_BFB2)
bogdanm 0:9b334a45a8ff 948 {
bogdanm 0:9b334a45a8ff 949 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 950 uint32_t tmp = 0, tmp1 = 0, OB_Bits = ((uint32_t) OB_BFB2) << 7;
bogdanm 0:9b334a45a8ff 951
bogdanm 0:9b334a45a8ff 952 /* Check the parameters */
bogdanm 0:9b334a45a8ff 953 assert_param(IS_OB_BOOT_BANK(OB_BFB2));
bogdanm 0:9b334a45a8ff 954
bogdanm 0:9b334a45a8ff 955 /* Get the User Option byte register */
bogdanm 0:9b334a45a8ff 956 tmp1 = OB->USER & ((~FLASH_OPTR_BFB2) >> 16);
bogdanm 0:9b334a45a8ff 957
bogdanm 0:9b334a45a8ff 958 /* Calculate the user option byte to write */
bogdanm 0:9b334a45a8ff 959 tmp = (~(OB_Bits | tmp1)) << 16;
bogdanm 0:9b334a45a8ff 960 tmp |= OB_Bits | tmp1;
bogdanm 0:9b334a45a8ff 961
bogdanm 0:9b334a45a8ff 962 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 963 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 964
bogdanm 0:9b334a45a8ff 965 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 966 {
bogdanm 0:9b334a45a8ff 967 /* Clean the error context */
bogdanm 0:9b334a45a8ff 968 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 969
bogdanm 0:9b334a45a8ff 970 /* Program OB */
bogdanm 0:9b334a45a8ff 971 OB->USER = tmp;
bogdanm 0:9b334a45a8ff 972
bogdanm 0:9b334a45a8ff 973 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 974 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 975 }
bogdanm 0:9b334a45a8ff 976 return status;
bogdanm 0:9b334a45a8ff 977 }
bogdanm 0:9b334a45a8ff 978 #endif
bogdanm 0:9b334a45a8ff 979
bogdanm 0:9b334a45a8ff 980 /**
bogdanm 0:9b334a45a8ff 981 * @brief Write Option Byte of the desired pages of the Flash.
bogdanm 0:9b334a45a8ff 982 * @param Sector: specifies the sectors to be write protected.
bogdanm 0:9b334a45a8ff 983 * @param Sector2: specifies the sectors to be write protected only stm32l07xxx and stm32l08xxx devices
bogdanm 0:9b334a45a8ff 984 * @param NewState: new state of the specified FLASH Pages Wite protection.
bogdanm 0:9b334a45a8ff 985 * This parameter can be: ENABLE or DISABLE.
bogdanm 0:9b334a45a8ff 986 * @retval HAL_StatusTypeDef
bogdanm 0:9b334a45a8ff 987 */
bogdanm 0:9b334a45a8ff 988 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 989 static HAL_StatusTypeDef FLASH_OB_ProtectedSectorsConfig(uint32_t Sector, uint32_t Sector2, uint32_t NewState)
bogdanm 0:9b334a45a8ff 990 #else
bogdanm 0:9b334a45a8ff 991 static HAL_StatusTypeDef FLASH_OB_ProtectedSectorsConfig(uint32_t Sector, uint32_t NewState)
bogdanm 0:9b334a45a8ff 992 #endif
bogdanm 0:9b334a45a8ff 993 {
bogdanm 0:9b334a45a8ff 994 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 995 uint32_t WRP_Data = 0;
bogdanm 0:9b334a45a8ff 996 uint32_t OB_WRP = Sector;
bogdanm 0:9b334a45a8ff 997
bogdanm 0:9b334a45a8ff 998 /* Check the parameters */
bogdanm 0:9b334a45a8ff 999 assert_param(IS_FUNCTIONAL_STATE(NewState));
bogdanm 0:9b334a45a8ff 1000
bogdanm 0:9b334a45a8ff 1001 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 1002 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 1003
bogdanm 0:9b334a45a8ff 1004 if(status == HAL_OK)
bogdanm 0:9b334a45a8ff 1005 {
bogdanm 0:9b334a45a8ff 1006 /* Clean the error context */
bogdanm 0:9b334a45a8ff 1007 ProcFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
bogdanm 0:9b334a45a8ff 1008
bogdanm 0:9b334a45a8ff 1009 if (OB_WRP & 0x0000FFFF)
bogdanm 0:9b334a45a8ff 1010 {
bogdanm 0:9b334a45a8ff 1011 if (NewState != OB_WRPSTATE_DISABLE)
bogdanm 0:9b334a45a8ff 1012 {
bogdanm 0:9b334a45a8ff 1013 WRP_Data = (uint16_t)(((OB_WRP & WRP_MASK_LOW) | OB->WRP01));
bogdanm 0:9b334a45a8ff 1014 OB->WRP01 = (uint32_t)(~(WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1015 }
bogdanm 0:9b334a45a8ff 1016 else
bogdanm 0:9b334a45a8ff 1017 {
bogdanm 0:9b334a45a8ff 1018 WRP_Data = (uint16_t)(~OB_WRP & (WRP_MASK_LOW & OB->WRP01));
bogdanm 0:9b334a45a8ff 1019 OB->WRP01 = (uint32_t)((~WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1020 }
bogdanm 0:9b334a45a8ff 1021 }
bogdanm 0:9b334a45a8ff 1022 #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx)
bogdanm 0:9b334a45a8ff 1023 if (OB_WRP & 0xFFFF0000)
bogdanm 0:9b334a45a8ff 1024 {
bogdanm 0:9b334a45a8ff 1025 if (NewState != OB_WRPSTATE_DISABLE)
bogdanm 0:9b334a45a8ff 1026 {
bogdanm 0:9b334a45a8ff 1027 WRP_Data = (uint16_t)((((OB_WRP & WRP_MASK_HIGH) >> 16 | OB->WRP23)));
bogdanm 0:9b334a45a8ff 1028 OB->WRP23 = (uint32_t)(~(WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1029 }
bogdanm 0:9b334a45a8ff 1030 else
bogdanm 0:9b334a45a8ff 1031 {
bogdanm 0:9b334a45a8ff 1032 WRP_Data = (uint16_t)((((~OB_WRP & WRP_MASK_HIGH) >> 16 & OB->WRP23)));
bogdanm 0:9b334a45a8ff 1033 OB->WRP23 = (uint32_t)((~WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1034 }
bogdanm 0:9b334a45a8ff 1035 }
bogdanm 0:9b334a45a8ff 1036
bogdanm 0:9b334a45a8ff 1037 OB_WRP = Sector2;
bogdanm 0:9b334a45a8ff 1038 if (OB_WRP & 0x0000FFFF)
bogdanm 0:9b334a45a8ff 1039 {
bogdanm 0:9b334a45a8ff 1040 if (NewState != OB_WRPSTATE_DISABLE)
bogdanm 0:9b334a45a8ff 1041 {
bogdanm 0:9b334a45a8ff 1042 WRP_Data = (uint16_t)(((OB_WRP & WRP_MASK_LOW) | OB->WRP45));
bogdanm 0:9b334a45a8ff 1043 OB->WRP45 =(uint32_t)(~(WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1044 }
bogdanm 0:9b334a45a8ff 1045 else
bogdanm 0:9b334a45a8ff 1046 {
bogdanm 0:9b334a45a8ff 1047 WRP_Data = (uint16_t)(~OB_WRP & (WRP_MASK_LOW & OB->WRP45));
bogdanm 0:9b334a45a8ff 1048 OB->WRP45 = (uint32_t)((~WRP_Data) << 16) | (WRP_Data);
bogdanm 0:9b334a45a8ff 1049 }
bogdanm 0:9b334a45a8ff 1050 }
bogdanm 0:9b334a45a8ff 1051 #endif /* STM32L071xx || STM32L072xx || STM32L073xx || STM32L081xx || STM32L082xx || STM32L083xx */
bogdanm 0:9b334a45a8ff 1052 }
bogdanm 0:9b334a45a8ff 1053 /* Wait for last operation to be completed */
bogdanm 0:9b334a45a8ff 1054 status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE);
bogdanm 0:9b334a45a8ff 1055
bogdanm 0:9b334a45a8ff 1056 /* Return the write protection operation Status */
bogdanm 0:9b334a45a8ff 1057 return status;
bogdanm 0:9b334a45a8ff 1058 }
bogdanm 0:9b334a45a8ff 1059
bogdanm 0:9b334a45a8ff 1060 /**
bogdanm 0:9b334a45a8ff 1061 * @}
bogdanm 0:9b334a45a8ff 1062 */
bogdanm 0:9b334a45a8ff 1063 #endif /* HAL_FLASH_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 1064
bogdanm 0:9b334a45a8ff 1065 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/