fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

Committer:
nameless129
Date:
Mon May 16 16:50:30 2016 +0000
Revision:
129:2e517c56bcfb
Parent:
113:b3775bf36a83
PWM Fix:Duty 0%??H???????????????

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