| /** |
| ****************************************************************************** |
| * @file stm32l0xx_hal_flash_ex.h |
| * @author MCD Application Team |
| * @brief Header file of Flash HAL Extended module. |
| ****************************************************************************** |
| * @attention |
| * |
| * Copyright (c) 2016 STMicroelectronics. |
| * All rights reserved. |
| * |
| * This software is licensed under terms that can be found in the LICENSE file in |
| * the root directory of this software component. |
| * If no LICENSE file comes with this software, it is provided AS-IS. |
| ****************************************************************************** |
| */ |
| |
| /* Define to prevent recursive inclusion -------------------------------------*/ |
| #ifndef __STM32L0xx_HAL_FLASH_EX_H |
| #define __STM32L0xx_HAL_FLASH_EX_H |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32l0xx_hal_def.h" |
| |
| /** @addtogroup STM32L0xx_HAL_Driver |
| * @{ |
| */ |
| |
| /** @addtogroup FLASHEx |
| * @{ |
| */ |
| |
| /** @addtogroup FLASHEx_Private_Constants |
| * @{ |
| */ |
| |
| #define FLASH_NBPAGES_MAX (FLASH_SIZE / FLASH_PAGE_SIZE) |
| |
| #define WRP_MASK_LOW (0x0000FFFFU) |
| #define WRP_MASK_HIGH (0xFFFF0000U) |
| |
| /** |
| * @} |
| */ |
| |
| /** @addtogroup FLASHEx_Private_Macros |
| * @{ |
| */ |
| |
| #define IS_FLASH_TYPEERASE(__VALUE__) (((__VALUE__) == FLASH_TYPEERASE_PAGES)) |
| |
| #define IS_OPTIONBYTE(__VALUE__) (((__VALUE__) <= (OPTIONBYTE_WRP | OPTIONBYTE_RDP | \ |
| OPTIONBYTE_USER | OPTIONBYTE_BOR | OPTIONBYTE_BOOT_BIT1))) |
| |
| #define IS_WRPSTATE(__VALUE__) (((__VALUE__) == OB_WRPSTATE_DISABLE) || \ |
| ((__VALUE__) == OB_WRPSTATE_ENABLE)) |
| |
| #define IS_OB_WRP(__PAGE__) (((__PAGE__) != 0x0000000U)) |
| |
| #define IS_OB_RDP(__LEVEL__) (((__LEVEL__) == OB_RDP_LEVEL_0) ||\ |
| ((__LEVEL__) == OB_RDP_LEVEL_1) ||\ |
| ((__LEVEL__) == OB_RDP_LEVEL_2)) |
| |
| #define IS_OB_BOR_LEVEL(__LEVEL__) (((__LEVEL__) == OB_BOR_OFF) || \ |
| ((__LEVEL__) == OB_BOR_LEVEL1) || \ |
| ((__LEVEL__) == OB_BOR_LEVEL2) || \ |
| ((__LEVEL__) == OB_BOR_LEVEL3) || \ |
| ((__LEVEL__) == OB_BOR_LEVEL4) || \ |
| ((__LEVEL__) == OB_BOR_LEVEL5)) |
| |
| #define IS_OB_IWDG_SOURCE(__SOURCE__) (((__SOURCE__) == OB_IWDG_SW) || ((__SOURCE__) == OB_IWDG_HW)) |
| |
| #define IS_OB_STOP_SOURCE(__SOURCE__) (((__SOURCE__) == OB_STOP_NORST) || ((__SOURCE__) == OB_STOP_RST)) |
| |
| #define IS_OB_STDBY_SOURCE(__SOURCE__) (((__SOURCE__) == OB_STDBY_NORST) || ((__SOURCE__) == OB_STDBY_RST)) |
| |
| #if defined(FLASH_OPTR_WPRMOD) && defined(FLASH_OPTR_BFB2) |
| |
| #define IS_OBEX(__VALUE__) (((__VALUE__) <= (OPTIONBYTE_PCROP | OPTIONBYTE_BOOTCONFIG)) && ((__VALUE__) != 0U)) |
| |
| #elif defined(FLASH_OPTR_WPRMOD) && !defined(FLASH_OPTR_BFB2) |
| |
| #define IS_OBEX(__VALUE__) ((__VALUE__) == OPTIONBYTE_PCROP) |
| |
| #elif !defined(FLASH_OPTR_WPRMOD) && defined(FLASH_OPTR_BFB2) |
| |
| #define IS_OBEX(__VALUE__) ((__VALUE__) == OPTIONBYTE_BOOTCONFIG) |
| |
| #endif /* FLASH_OPTR_WPRMOD && FLASH_OPTR_BFB2 */ |
| |
| #if defined(FLASH_OPTR_WPRMOD) |
| |
| #define IS_PCROPSTATE(__VALUE__) (((__VALUE__) == OB_PCROP_STATE_DISABLE) || \ |
| ((__VALUE__) == OB_PCROP_STATE_ENABLE)) |
| |
| #define IS_OB_PCROP(__PAGE__) (((__PAGE__) != 0x0000000U)) |
| #endif /* FLASH_OPTR_WPRMOD */ |
| |
| #if defined(FLASH_OPTR_BFB2) |
| |
| #define IS_OB_BOOT_BANK(__BANK__) (((__BANK__) == OB_BOOT_BANK2) || ((__BANK__) == OB_BOOT_BANK1)) |
| |
| #endif /* FLASH_OPTR_BFB2 */ |
| |
| #define IS_OB_BOOT1(__BOOT_BIT1__) (((__BOOT_BIT1__) == OB_BOOT_BIT1_RESET) || ((__BOOT_BIT1__) == OB_BOOT_BIT1_SET)) |
| #define IS_TYPEPROGRAMDATA(__VALUE__) (((__VALUE__) == FLASH_TYPEPROGRAMDATA_BYTE) || \ |
| ((__VALUE__) == FLASH_TYPEPROGRAMDATA_HALFWORD) || \ |
| ((__VALUE__) == FLASH_TYPEPROGRAMDATA_WORD)) |
| |
| #if defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx) |
| |
| #define IS_FLASH_DATA_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= DATA_EEPROM_BASE) && ((__ADDRESS__) <= DATA_EEPROM_BANK2_END)) |
| #define IS_FLASH_DATA_BANK1_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= DATA_EEPROM_BASE) && ((__ADDRESS__) <= DATA_EEPROM_BANK1_END)) |
| #define IS_FLASH_DATA_BANK2_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= DATA_EEPROM_BANK2_BASE) && ((__ADDRESS__) <= DATA_EEPROM_BANK2_END)) |
| #define IS_FLASH_PROGRAM_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) < (FLASH_BASE + FLASH_SIZE))) |
| #define IS_FLASH_PROGRAM_BANK1_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) < (FLASH_BASE + (FLASH_SIZE >> 1)))) |
| #define IS_FLASH_PROGRAM_BANK2_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BANK2_BASE) && ((__ADDRESS__) < (FLASH_BASE + FLASH_SIZE))) |
| #else |
| #define IS_FLASH_DATA_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= DATA_EEPROM_BASE) && ((__ADDRESS__) <= DATA_EEPROM_END)) |
| #define IS_FLASH_PROGRAM_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) < (FLASH_BASE + FLASH_SIZE))) |
| #endif |
| |
| #define IS_NBPAGES(__PAGES__) (((__PAGES__) >= 1) && ((__PAGES__) <= FLASH_NBPAGES_MAX)) |
| |
| /** |
| * @} |
| */ |
| |
| /** @addtogroup FLASHEx_Private_Functions |
| * @{ |
| */ |
| |
| void FLASH_PageErase(uint32_t PageAddress); |
| |
| /** |
| * @} |
| */ |
| |
| /* Exported types ------------------------------------------------------------*/ |
| |
| /** @defgroup FLASHEx_Exported_Types FLASHEx Exported Types |
| * @{ |
| */ |
| |
| /** |
| * @brief FLASH Erase structure definition |
| */ |
| typedef struct |
| { |
| uint32_t TypeErase; /*!< TypeErase: Page Erase only. |
| This parameter can be a value of @ref FLASHEx_Type_Erase */ |
| |
| uint32_t PageAddress; /*!< PageAddress: Initial FLASH address to be erased |
| This parameter must be a value belonging to FLASH Program address (depending on the devices) */ |
| |
| uint32_t NbPages; /*!< NbPages: Number of pages to be erased. |
| This parameter must be a value between 1 and (max number of pages - value of Initial page)*/ |
| |
| } FLASH_EraseInitTypeDef; |
| |
| /** |
| * @brief FLASH Option Bytes PROGRAM structure definition |
| */ |
| typedef struct |
| { |
| uint32_t OptionType; /*!< OptionType: Option byte to be configured. |
| This parameter can be a value of @ref FLASHEx_Option_Type */ |
| |
| uint32_t WRPState; /*!< WRPState: Write protection activation or deactivation. |
| This parameter can be a value of @ref FLASHEx_WRP_State */ |
| |
| uint32_t WRPSector; /*!< WRPSector: This bitfield specifies the sector (s) which are write protected. |
| This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection */ |
| |
| #if defined(STM32L071xx) || defined(STM32L072xx) || defined(STM32L073xx) || defined(STM32L081xx) || defined(STM32L082xx) || defined(STM32L083xx) |
| uint32_t WRPSector2; /*!< WRPSector2 : This bitfield specifies the sector(s) upper Sector31 which are write protected. |
| This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection2 */ |
| #endif |
| |
| uint8_t RDPLevel; /*!< RDPLevel: Set the read protection level. |
| This parameter can be a value of @ref FLASHEx_Option_Bytes_Read_Protection */ |
| |
| uint8_t BORLevel; /*!< BORLevel: Set the BOR Level. |
| This parameter can be a value of @ref FLASHEx_Option_Bytes_BOR_Level */ |
| |
| uint8_t USERConfig; /*!< USERConfig: Program the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY. |
| This parameter can be a combination of @ref FLASHEx_Option_Bytes_IWatchdog, |
| @ref FLASHEx_Option_Bytes_nRST_STOP and @ref FLASHEx_Option_Bytes_nRST_STDBY*/ |
| |
| uint8_t BOOTBit1Config; /*!< BOOT1Config: Together with input pad Boot0, this bit selects the boot source, flash, ram or system memory |
| This parameter can be a value of @ref FLASHEx_Option_Bytes_BOOTBit1 */ |
| } FLASH_OBProgramInitTypeDef; |
| |
| #if defined(FLASH_OPTR_WPRMOD) || defined(FLASH_OPTR_BFB2) |
| /** |
| * @brief FLASH Advanced Option Bytes Program structure definition |
| */ |
| typedef struct |
| { |
| uint32_t OptionType; /*!< OptionType: Option byte to be configured for extension . |
| This parameter can be a value of @ref FLASHEx_OptionAdv_Type */ |
| |
| #if defined(FLASH_OPTR_WPRMOD) |
| uint32_t PCROPState; /*!< PCROPState: PCROP activation or deactivation. |
| This parameter can be a value of @ref FLASHEx_PCROP_State */ |
| |
| uint32_t PCROPSector; /*!< PCROPSector : This bitfield specifies the sector(s) which are read/write protected. |
| This parameter can be a combination of @ref FLASHEx_Option_Bytes_PC_ReadWrite_Protection */ |
| |
| #if defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx) |
| uint32_t PCROPSector2; /*!< PCROPSector : This bitfield specifies the sector(s) upper Sector31 which are read/write protected. |
| This parameter can be a combination of @ref FLASHEx_Option_Bytes_PC_ReadWrite_Protection2 */ |
| #endif /* STM32L071xx || STM32L072xx || STM32L073xx || STM32L081xx || STM32L082xx || STM32L083xx */ |
| #endif /* FLASH_OPTR_WPRMOD */ |
| |
| #if defined(FLASH_OPTR_BFB2) |
| uint16_t BootConfig; /*!< BootConfig: specifies Option bytes for boot config |
| This parameter can be a value of @ref FLASHEx_Option_Bytes_BOOT */ |
| #endif /* FLASH_OPTR_BFB2*/ |
| } FLASH_AdvOBProgramInitTypeDef; |
| |
| /** |
| * @} |
| */ |
| #endif /* FLASH_OPTR_WPRMOD || FLASH_OPTR_BFB2 */ |
| |
| /* Exported constants --------------------------------------------------------*/ |
| |
| |
| /** @defgroup FLASHEx_Exported_Constants FLASHEx Exported Constants |
| * @{ |
| */ |
| |
| /** @defgroup FLASHEx_Type_Erase FLASHEx_Type_Erase |
| * @{ |
| */ |
| #define FLASH_TYPEERASE_PAGES (0x00U) /*!<Page erase only*/ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Type FLASHEx Option Type |
| * @{ |
| */ |
| #define OPTIONBYTE_WRP (0x01U) /*!<WRP option byte configuration*/ |
| #define OPTIONBYTE_RDP (0x02U) /*!<RDP option byte configuration*/ |
| #define OPTIONBYTE_USER (0x04U) /*!<USER option byte configuration*/ |
| #define OPTIONBYTE_BOR (0x08U) /*!<BOR option byte configuration*/ |
| #define OPTIONBYTE_BOOT_BIT1 (0x10U) /*!< BOOT PIN1 option byte configuration*/ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_WRP_State FLASHEx WRP State |
| * @{ |
| */ |
| #define OB_WRPSTATE_DISABLE (0x00U) /*!<Disable the write protection of the desired sectors*/ |
| #define OB_WRPSTATE_ENABLE (0x01U) /*!<Enable the write protection of the desired sectors*/ |
| |
| /** |
| * @} |
| */ |
| |
| #if defined (STM32L011xx) || defined (STM32L021xx) || defined (STM32L031xx) || defined (STM32L041xx) |
| /** @defgroup FLASHEx_Option_Bytes_Write_Protection FLASH Option Bytes Write Protection |
| * @{ |
| */ |
| #define OB_WRP_Pages0to31 (0x00000001U) /* Write protection of Sector0 */ |
| #define OB_WRP_Pages32to63 (0x00000002U) /* Write protection of Sector1 */ |
| #define OB_WRP_Pages64to95 (0x00000004U) /* Write protection of Sector2 */ |
| #define OB_WRP_Pages96to127 (0x00000008U) /* Write protection of Sector3 */ |
| #define OB_WRP_Pages128to159 (0x00000010U) /* Write protection of Sector4 */ |
| #define OB_WRP_Pages160to191 (0x00000020U) /* Write protection of Sector5 */ |
| #define OB_WRP_Pages192to223 (0x00000040U) /* Write protection of Sector6 */ |
| #define OB_WRP_Pages224to255 (0x00000080U) /* Write protection of Sector7 */ |
| #define OB_WRP_AllPages (0x000000FFU) /*!< Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| #elif defined (STM32L051xx) || defined (STM32L052xx) || defined (STM32L053xx) || defined (STM32L062xx) || defined (STM32L063xx) |
| /** @defgroup FLASHEx_Option_Bytes_Write_Protection FLASH Option Bytes Write Protection |
| * @{ |
| */ |
| #define OB_WRP_Pages0to31 (0x00000001U) /* Write protection of Sector0 */ |
| #define OB_WRP_Pages32to63 (0x00000002U) /* Write protection of Sector1 */ |
| #define OB_WRP_Pages64to95 (0x00000004U) /* Write protection of Sector2 */ |
| #define OB_WRP_Pages96to127 (0x00000008U) /* Write protection of Sector3 */ |
| #define OB_WRP_Pages128to159 (0x00000010U) /* Write protection of Sector4 */ |
| #define OB_WRP_Pages160to191 (0x00000020U) /* Write protection of Sector5 */ |
| #define OB_WRP_Pages192to223 (0x00000040U) /* Write protection of Sector6 */ |
| #define OB_WRP_Pages224to255 (0x00000080U) /* Write protection of Sector7 */ |
| #define OB_WRP_Pages256to287 (0x00000100U) /* Write protection of Sector8 */ |
| #define OB_WRP_Pages288to319 (0x00000200U) /* Write protection of Sector9 */ |
| #define OB_WRP_Pages320to351 (0x00000400U) /* Write protection of Sector10 */ |
| #define OB_WRP_Pages352to383 (0x00000800U) /* Write protection of Sector11 */ |
| #define OB_WRP_Pages384to415 (0x00001000U) /* Write protection of Sector12 */ |
| #define OB_WRP_Pages416to447 (0x00002000U) /* Write protection of Sector13 */ |
| #define OB_WRP_Pages448to479 (0x00004000U) /* Write protection of Sector14 */ |
| #define OB_WRP_Pages480to511 (0x00008000U) /* Write protection of Sector15 */ |
| #define OB_WRP_AllPages (0x0000FFFFU) /*!< Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| |
| #elif defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx) |
| /** @defgroup FLASHEx_Option_Bytes_Write_Protection FLASH Option Bytes Write ProtectionP |
| * @{ |
| */ |
| #define OB_WRP_Pages0to31 (0x00000001U) /* Write protection of Sector0 */ |
| #define OB_WRP_Pages32to63 (0x00000002U) /* Write protection of Sector1 */ |
| #define OB_WRP_Pages64to95 (0x00000004U) /* Write protection of Sector2 */ |
| #define OB_WRP_Pages96to127 (0x00000008U) /* Write protection of Sector3 */ |
| #define OB_WRP_Pages128to159 (0x00000010U) /* Write protection of Sector4 */ |
| #define OB_WRP_Pages160to191 (0x00000020U) /* Write protection of Sector5 */ |
| #define OB_WRP_Pages192to223 (0x00000040U) /* Write protection of Sector6 */ |
| #define OB_WRP_Pages224to255 (0x00000080U) /* Write protection of Sector7 */ |
| #define OB_WRP_Pages256to287 (0x00000100U) /* Write protection of Sector8 */ |
| #define OB_WRP_Pages288to319 (0x00000200U) /* Write protection of Sector9 */ |
| #define OB_WRP_Pages320to351 (0x00000400U) /* Write protection of Sector10 */ |
| #define OB_WRP_Pages352to383 (0x00000800U) /* Write protection of Sector11 */ |
| #define OB_WRP_Pages384to415 (0x00001000U) /* Write protection of Sector12 */ |
| #define OB_WRP_Pages416to447 (0x00002000U) /* Write protection of Sector13 */ |
| #define OB_WRP_Pages448to479 (0x00004000U) /* Write protection of Sector14 */ |
| #define OB_WRP_Pages480to511 (0x00008000U) /* Write protection of Sector15 */ |
| #define OB_WRP_Pages512to543 (0x00010000U) /* Write protection of Sector16 */ |
| #define OB_WRP_Pages544to575 (0x00020000U) /* Write protection of Sector17 */ |
| #define OB_WRP_Pages576to607 (0x00040000U) /* Write protection of Sector18 */ |
| #define OB_WRP_Pages608to639 (0x00080000U) /* Write protection of Sector19 */ |
| #define OB_WRP_Pages640to671 (0x00100000U) /* Write protection of Sector20 */ |
| #define OB_WRP_Pages672to703 (0x00200000U) /* Write protection of Sector21 */ |
| #define OB_WRP_Pages704to735 (0x00400000U) /* Write protection of Sector22 */ |
| #define OB_WRP_Pages736to767 (0x00800000U) /* Write protection of Sector23 */ |
| #define OB_WRP_Pages768to799 (0x01000000U) /* Write protection of Sector24 */ |
| #define OB_WRP_Pages800to831 (0x02000000U) /* Write protection of Sector25 */ |
| #define OB_WRP_Pages832to863 (0x04000000U) /* Write protection of Sector26 */ |
| #define OB_WRP_Pages864to895 (0x08000000U) /* Write protection of Sector27 */ |
| #define OB_WRP_Pages896to927 (0x10000000U) /* Write protection of Sector28 */ |
| #define OB_WRP_Pages928to959 (0x20000000U) /* Write protection of Sector29 */ |
| #define OB_WRP_Pages960to991 (0x40000000U) /* Write protection of Sector30 */ |
| #define OB_WRP_Pages992to1023 (0x80000000U) /* Write protection of Sector31 */ |
| #define OB_WRP_AllPages (0xFFFFFFFFU) /*!<Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_Write_Protection2 FLASH Option Bytes Write Protection |
| * @{ |
| */ |
| #define OB_WRP2_Pages1024to1055 (0x00000001U) /* Write protection of Sector32 */ |
| #define OB_WRP2_Pages1056to1087 (0x00000002U) /* Write protection of Sector33 */ |
| #define OB_WRP2_Pages1088to1119 (0x00000004U) /* Write protection of Sector34 */ |
| #define OB_WRP2_Pages1120to1151 (0x00000008U) /* Write protection of Sector35 */ |
| #define OB_WRP2_Pages1152to1183 (0x00000010U) /* Write protection of Sector36 */ |
| #define OB_WRP2_Pages1184to1215 (0x00000020U) /* Write protection of Sector37 */ |
| #define OB_WRP2_Pages1216to1247 (0x00000040U) /* Write protection of Sector38 */ |
| #define OB_WRP2_Pages1248to1279 (0x00000080U) /* Write protection of Sector39 */ |
| #define OB_WRP2_Pages1280to1311 (0x00000100U) /* Write protection of Sector40 */ |
| #define OB_WRP2_Pages1312to1343 (0x00000200U) /* Write protection of Sector41 */ |
| #define OB_WRP2_Pages1344to1375 (0x00000400U) /* Write protection of Sector42 */ |
| #define OB_WRP2_Pages1376to1407 (0x00000800U) /* Write protection of Sector43 */ |
| #define OB_WRP2_Pages1408to1439 (0x00001000U) /* Write protection of Sector44 */ |
| #define OB_WRP2_Pages1440to1471 (0x00002000U) /* Write protection of Sector45 */ |
| #define OB_WRP2_Pages1472to1503 (0x00004000U) /* Write protection of Sector46 */ |
| #define OB_WRP2_Pages1504to1535 (0x00008000U) /* Write protection of Sector47 */ |
| #define OB_WRP2_AllPages (0x0000FFFFU) /*!< Write protection of all Sectors WRP2 */ |
| /** |
| * @} |
| */ |
| #endif /* STM32L071xx || STM32L072xx || (STM32L073xx) || (STM32L081xx) || (STM32L082xx) || (STM32L083xx) */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_Read_Protection FLASHEx Option Bytes Read Protection |
| * @{ |
| */ |
| #define OB_RDP_LEVEL_0 ((uint8_t)0xAA) |
| #define OB_RDP_LEVEL_1 ((uint8_t)0xBB) |
| #define OB_RDP_LEVEL_2 ((uint8_t)0xCC) /* Warning: When enabling read protection level 2 |
| it is no more possible to go back to level 1 or 0 */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_BOR_Level FLASHEx Option Bytes BOR Level |
| * @{ |
| */ |
| |
| #define OB_BOR_OFF ((uint8_t)0x00) /*!< BOR is disabled at power down, the reset is asserted when the VDD |
| power supply reaches the PDR(Power Down Reset) threshold (1.5V) */ |
| #define OB_BOR_LEVEL1 ((uint8_t)0x08) /*!< BOR Reset threshold levels for 1.7V - 1.8V VDD power supply */ |
| #define OB_BOR_LEVEL2 ((uint8_t)0x09) /*!< BOR Reset threshold levels for 1.9V - 2.0V VDD power supply */ |
| #define OB_BOR_LEVEL3 ((uint8_t)0x0A) /*!< BOR Reset threshold levels for 2.3V - 2.4V VDD power supply */ |
| #define OB_BOR_LEVEL4 ((uint8_t)0x0B) /*!< BOR Reset threshold levels for 2.55V - 2.65V VDD power supply */ |
| #define OB_BOR_LEVEL5 ((uint8_t)0x0C) /*!< BOR Reset threshold levels for 2.8V - 2.9V VDD power supply */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_IWatchdog FLASHEx Option Bytes IWatchdog |
| * @{ |
| */ |
| |
| #define OB_IWDG_SW ((uint8_t)0x10) /*!< Software WDG selected */ |
| #define OB_IWDG_HW ((uint8_t)0x00) /*!< Hardware WDG selected */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_nRST_STOP FLASHEx Option Bytes nRST_STOP |
| * @{ |
| */ |
| |
| #define OB_STOP_NORST ((uint8_t)0x20) /*!< No reset generated when entering in STOP */ |
| #define OB_STOP_RST ((uint8_t)0x00) /*!< Reset generated when entering in STOP */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_nRST_STDBY FLASHEx Option Bytes nRST_STDBY |
| * @{ |
| */ |
| |
| #define OB_STDBY_NORST ((uint8_t)0x40) /*!< No reset generated when entering in STANDBY */ |
| #define OB_STDBY_RST ((uint8_t)0x00) /*!< Reset generated when entering in STANDBY */ |
| |
| /** |
| * @} |
| */ |
| |
| #if defined(FLASH_OPTR_WPRMOD) |
| |
| /** @defgroup FLASHEx_OptionAdv_Type FLASHEx Option Advanced Type |
| * @{ |
| */ |
| |
| #define OPTIONBYTE_PCROP (0x01U) /*!<PCROP option byte configuration*/ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* FLASH_OPTR_WPRMOD */ |
| |
| #if defined(FLASH_OPTR_BFB2) |
| |
| /** @defgroup FLASHEx_OptionAdv_Type FLASHEx Option Advanced Type |
| * @{ |
| */ |
| |
| #define OPTIONBYTE_BOOTCONFIG (0x02U) /*!<BOOTConfig option byte configuration*/ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* FLASH_OPTR_BFB2 */ |
| |
| #if defined(FLASH_OPTR_WPRMOD) |
| |
| /** @defgroup FLASHEx_PCROP_State FLASHEx PCROP State |
| * @{ |
| */ |
| #define OB_PCROP_STATE_DISABLE (0x00U) /*!<Disable PCROP for selected sectors */ |
| #define OB_PCROP_STATE_ENABLE (0x01U) /*!<Enable PCROP for selected sectors */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Selection_Protection_Mode FLASHEx Selection Protection Mode |
| * @{ |
| */ |
| #define OB_PCROP_DESELECTED ((uint16_t)0x0000) /*!< Disabled PCROP, nWPRi bits used for Write Protection on sector i */ |
| #define OB_PCROP_SELECTED ((uint16_t)FLASH_OPTR_WPRMOD) /*!< Enable PCROP, nWPRi bits used for PCRoP Protection on sector i */ |
| |
| /** |
| * @} |
| */ |
| #endif /* FLASH_OPTR_WPRMOD */ |
| |
| #if defined (STM32L011xx) || defined (STM32L021xx) || defined (STM32L031xx) || defined (STM32L041xx) |
| /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection FLASHEx Option Bytes PC Read/Write Protection |
| * @{ |
| */ |
| #define OB_PCROP_Pages0to31 (0x00000001U) /* PC Read/Write protection of Sector0 */ |
| #define OB_PCROP_Pages32to63 (0x00000002U) /* PC Read/Write protection of Sector1 */ |
| #define OB_PCROP_Pages64to95 (0x00000004U) /* PC Read/Write protection of Sector2 */ |
| #define OB_PCROP_Pages96to127 (0x00000008U) /* PC Read/Write protection of Sector3 */ |
| #define OB_PCROP_Pages128to159 (0x00000010U) /* PC Read/Write protection of Sector4 */ |
| #define OB_PCROP_Pages160to191 (0x00000020U) /* PC Read/Write protection of Sector5 */ |
| #define OB_PCROP_Pages192to223 (0x00000040U) /* PC Read/Write protection of Sector6 */ |
| #define OB_PCROP_Pages224to255 (0x00000080U) /* PC Read/Write protection of Sector7 */ |
| #define OB_PCROP_AllPages (0x000000FFU) /*!< PC Read/Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| #elif defined (STM32L051xx) || defined (STM32L052xx) || defined (STM32L053xx) || defined (STM32L062xx) || defined (STM32L063xx) |
| /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection FLASHEx Option Bytes PC Read/Write Protection |
| * @{ |
| */ |
| #define OB_PCROP_Pages0to31 (0x00000001U) /* PC Read/Write protection of Sector0 */ |
| #define OB_PCROP_Pages32to63 (0x00000002U) /* PC Read/Write protection of Sector1 */ |
| #define OB_PCROP_Pages64to95 (0x00000004U) /* PC Read/Write protection of Sector2 */ |
| #define OB_PCROP_Pages96to127 (0x00000008U) /* PC Read/Write protection of Sector3 */ |
| #define OB_PCROP_Pages128to159 (0x00000010U) /* PC Read/Write protection of Sector4 */ |
| #define OB_PCROP_Pages160to191 (0x00000020U) /* PC Read/Write protection of Sector5 */ |
| #define OB_PCROP_Pages192to223 (0x00000040U) /* PC Read/Write protection of Sector6 */ |
| #define OB_PCROP_Pages224to255 (0x00000080U) /* PC Read/Write protection of Sector7 */ |
| #define OB_PCROP_Pages256to287 (0x00000100U) /* PC Read/Write protection of Sector8 */ |
| #define OB_PCROP_Pages288to319 (0x00000200U) /* PC Read/Write protection of Sector9 */ |
| #define OB_PCROP_Pages320to351 (0x00000400U) /* PC Read/Write protection of Sector10 */ |
| #define OB_PCROP_Pages352to383 (0x00000800U) /* PC Read/Write protection of Sector11 */ |
| #define OB_PCROP_Pages384to415 (0x00001000U) /* PC Read/Write protection of Sector12 */ |
| #define OB_PCROP_Pages416to447 (0x00002000U) /* PC Read/Write protection of Sector13 */ |
| #define OB_PCROP_Pages448to479 (0x00004000U) /* PC Read/Write protection of Sector14 */ |
| #define OB_PCROP_Pages480to511 (0x00008000U) /* PC Read/Write protection of Sector15 */ |
| #define OB_PCROP_AllPages (0x0000FFFFU) /*!< PC Read/Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| #endif |
| |
| #if defined (STM32L071xx) || defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx) |
| /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection FLASH Option Bytes PC Read/Write Protection |
| * @{ |
| */ |
| #define OB_PCROP_Pages0to31 (0x00000001U) /* PC Read/Write protection of Sector0 */ |
| #define OB_PCROP_Pages32to63 (0x00000002U) /* PC Read/Write protection of Sector1 */ |
| #define OB_PCROP_Pages64to95 (0x00000004U) /* PC Read/Write protection of Sector2 */ |
| #define OB_PCROP_Pages96to127 (0x00000008U) /* PC Read/Write protection of Sector3 */ |
| #define OB_PCROP_Pages128to159 (0x00000010U) /* PC Read/Write protection of Sector4 */ |
| #define OB_PCROP_Pages160to191 (0x00000020U) /* PC Read/Write protection of Sector5 */ |
| #define OB_PCROP_Pages192to223 (0x00000040U) /* PC Read/Write protection of Sector6 */ |
| #define OB_PCROP_Pages224to255 (0x00000080U) /* PC Read/Write protection of Sector7 */ |
| #define OB_PCROP_Pages256to287 (0x00000100U) /* PC Read/Write protection of Sector8 */ |
| #define OB_PCROP_Pages288to319 (0x00000200U) /* PC Read/Write protection of Sector9 */ |
| #define OB_PCROP_Pages320to351 (0x00000400U) /* PC Read/Write protection of Sector10 */ |
| #define OB_PCROP_Pages352to383 (0x00000800U) /* PC Read/Write protection of Sector11 */ |
| #define OB_PCROP_Pages384to415 (0x00001000U) /* PC Read/Write protection of Sector12 */ |
| #define OB_PCROP_Pages416to447 (0x00002000U) /* PC Read/Write protection of Sector13 */ |
| #define OB_PCROP_Pages448to479 (0x00004000U) /* PC Read/Write protection of Sector14 */ |
| #define OB_PCROP_Pages480to511 (0x00008000U) /* PC Read/Write protection of Sector15 */ |
| #define OB_PCROP_Pages512to543 (0x00010000U) /* PC Read/Write protection of Sector16 */ |
| #define OB_PCROP_Pages544to575 (0x00020000U) /* PC Read/Write protection of Sector17 */ |
| #define OB_PCROP_Pages576to607 (0x00040000U) /* PC Read/Write protection of Sector18 */ |
| #define OB_PCROP_Pages608to639 (0x00080000U) /* PC Read/Write protection of Sector19 */ |
| #define OB_PCROP_Pages640to671 (0x00100000U) /* PC Read/Write protection of Sector20 */ |
| #define OB_PCROP_Pages672to703 (0x00200000U) /* PC Read/Write protection of Sector21 */ |
| #define OB_PCROP_Pages704to735 (0x00400000U) /* PC Read/Write protection of Sector22 */ |
| #define OB_PCROP_Pages736to767 (0x00800000U) /* PC Read/Write protection of Sector23 */ |
| #define OB_PCROP_Pages768to799 (0x01000000U) /* PC Read/Write protection of Sector24 */ |
| #define OB_PCROP_Pages800to831 (0x02000000U) /* PC Read/Write protection of Sector25 */ |
| #define OB_PCROP_Pages832to863 (0x04000000U) /* PC Read/Write protection of Sector26 */ |
| #define OB_PCROP_Pages864to895 (0x08000000U) /* PC Read/Write protection of Sector27 */ |
| #define OB_PCROP_Pages896to927 (0x10000000U) /* PC Read/Write protection of Sector28 */ |
| #define OB_PCROP_Pages928to959 (0x20000000U) /* PC Read/Write protection of Sector29 */ |
| #define OB_PCROP_Pages960to991 (0x40000000U) /* PC Read/Write protection of Sector30 */ |
| #define OB_PCROP_Pages992to1023 (0x80000000U) /* PC Read/Write protection of Sector31 */ |
| #define OB_PCROP_AllPages (0xFFFFFFFFU) /*!<PC Read/Write protection of all Sectors */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection2 FLASH Option Bytes PC Read/Write Protection (Sector 2) |
| * @{ |
| */ |
| #define OB_PCROP2_Pages1024to1055 (0x00000001U) /* PC Read/Write protection of Sector32 */ |
| #define OB_PCROP2_Pages1056to1087 (0x00000002U) /* PC Read/Write protection of Sector33 */ |
| #define OB_PCROP2_Pages1088to1119 (0x00000004U) /* PC Read/Write protection of Sector34 */ |
| #define OB_PCROP2_Pages1120to1151 (0x00000008U) /* PC Read/Write protection of Sector35 */ |
| #define OB_PCROP2_Pages1152to1183 (0x00000010U) /* PC Read/Write protection of Sector36 */ |
| #define OB_PCROP2_Pages1184to1215 (0x00000020U) /* PC Read/Write protection of Sector37 */ |
| #define OB_PCROP2_Pages1216to1247 (0x00000040U) /* PC Read/Write protection of Sector38 */ |
| #define OB_PCROP2_Pages1248to1279 (0x00000080U) /* PC Read/Write protection of Sector39 */ |
| #define OB_PCROP2_Pages1280to1311 (0x00000100U) /* PC Read/Write protection of Sector40 */ |
| #define OB_PCROP2_Pages1312to1343 (0x00000200U) /* PC Read/Write protection of Sector41 */ |
| #define OB_PCROP2_Pages1344to1375 (0x00000400U) /* PC Read/Write protection of Sector42 */ |
| #define OB_PCROP2_Pages1376to1407 (0x00000800U) /* PC Read/Write protection of Sector43 */ |
| #define OB_PCROP2_Pages1408to1439 (0x00001000U) /* PC Read/Write protection of Sector44 */ |
| #define OB_PCROP2_Pages1440to1471 (0x00002000U) /* PC Read/Write protection of Sector45 */ |
| #define OB_PCROP2_Pages1472to1503 (0x00004000U) /* PC Read/Write protection of Sector46 */ |
| #define OB_PCROP2_Pages1504to1535 (0x00008000U) /* PC Read/Write protection of Sector47 */ |
| #define OB_PCROP2_AllPages (0x0000FFFFU) /*!< PC Read/Write protection of all Sectors PCROP2 */ |
| /** |
| * @} |
| */ |
| #endif /* STM32L071xx || STM32L072xx || STM32L073xx || STM32L081xx || STM32L082xx || STM32L083xx */ |
| |
| /** @defgroup FLASHEx_Option_Bytes_BOOTBit1 FLASH Option Bytes BOOT Bit1 Setup |
| * @{ |
| */ |
| #define OB_BOOT_BIT1_RESET (uint8_t)(0x00) /*!< BOOT Bit 1 Reset */ |
| #define OB_BOOT_BIT1_SET (uint8_t)(0x01) /*!< BOOT Bit 1 Set */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup FLASHEx_Type_Program_Data FLASHEx Type Program Data |
| * @{ |
| */ |
| #define FLASH_TYPEPROGRAMDATA_BYTE (0x00U) /*!<Program byte (8-bit) at a specified address.*/ |
| #define FLASH_TYPEPROGRAMDATA_HALFWORD (0x01U) /*!<Program a half-word (16-bit) at a specified address.*/ |
| #define FLASH_TYPEPROGRAMDATA_WORD (0x02U) /*!<Program a word (32-bit) at a specified address.*/ |
| |
| /** |
| * @} |
| */ |
| |
| #if defined(FLASH_OPTR_BFB2) |
| |
| /** @defgroup FLASHEx_Option_Bytes_BOOT FLASHEx Option Bytes BOOT |
| * @{ |
| */ |
| |
| #define OB_BOOT_BANK1 ((uint8_t)0x00) /*!< At startup, if boot pin 0 and BOOT1 bit are set in boot from user Flash position |
| and this parameter is selected the device will boot from Bank 1 (Default)*/ |
| #define OB_BOOT_BANK2 ((uint8_t)(FLASH_OPTR_BFB2 >> 16)) /*!< At startup, if boot pin 0 and BOOT1 bit are set in boot from user Flash position |
| and this parameter is selected the device will boot from Bank 2 */ |
| |
| /** |
| * @} |
| */ |
| #endif /* FLASH_OPTR_BFB2 */ |
| |
| /** |
| * @} |
| */ |
| |
| /* Exported macro ------------------------------------------------------------*/ |
| |
| /** @defgroup FLASHEx_Exported_Macros FLASHEx Exported Macros |
| * @{ |
| */ |
| |
| /** |
| * @brief Set the FLASH Latency. |
| * @param __LATENCY__ FLASH Latency |
| * This parameter can be one of the following values: |
| * @arg @ref FLASH_LATENCY_0 FLASH Zero Latency cycle |
| * @arg @ref FLASH_LATENCY_1 FLASH One Latency cycle |
| * @retval none |
| */ |
| #define __HAL_FLASH_SET_LATENCY(__LATENCY__) \ |
| MODIFY_REG(FLASH->ACR, FLASH_ACR_LATENCY, (uint32_t)(__LATENCY__)) |
| |
| /** |
| * @brief Get the FLASH Latency. |
| * @retval FLASH Latency |
| * This parameter can be one of the following values: |
| * @arg @ref FLASH_LATENCY_0 FLASH Zero Latency cycle |
| * @arg @ref FLASH_LATENCY_1 FLASH One Latency cycle |
| */ |
| #define __HAL_FLASH_GET_LATENCY() (READ_BIT((FLASH->ACR), FLASH_ACR_LATENCY)) |
| |
| /** |
| * @brief Enable the FLASH prefetch buffer. |
| * @retval none |
| */ |
| #define __HAL_FLASH_PREFETCH_BUFFER_ENABLE() SET_BIT((FLASH->ACR), FLASH_ACR_PRFTEN) |
| |
| /** |
| * @brief Disable the FLASH prefetch buffer. |
| * @retval none |
| */ |
| #define __HAL_FLASH_PREFETCH_BUFFER_DISABLE() CLEAR_BIT((FLASH->ACR), FLASH_ACR_PRFTEN) |
| |
| /** |
| * @brief Enable the FLASH Buffer cache. |
| * @retval none |
| */ |
| #define __HAL_FLASH_BUFFER_CACHE_ENABLE() CLEAR_BIT((FLASH->ACR), FLASH_ACR_DISAB_BUF) |
| |
| /** |
| * @brief Disable the FLASH Buffer cache. |
| * @retval none |
| */ |
| #define __HAL_FLASH_BUFFER_CACHE_DISABLE() SET_BIT((FLASH->ACR), FLASH_ACR_DISAB_BUF) |
| |
| /** |
| * @brief Enable the FLASH preread buffer. |
| * @retval none |
| */ |
| #define __HAL_FLASH_PREREAD_BUFFER_ENABLE() SET_BIT((FLASH->ACR), FLASH_ACR_PRE_READ) |
| |
| /** |
| * @brief Disable the FLASH preread buffer. |
| * @retval none |
| */ |
| #define __HAL_FLASH_PREREAD_BUFFER_DISABLE() CLEAR_BIT((FLASH->ACR), FLASH_ACR_PRE_READ) |
| |
| /** |
| * @brief Enable the FLASH power down during Sleep mode |
| * @retval none |
| */ |
| #define __HAL_FLASH_SLEEP_POWERDOWN_ENABLE() SET_BIT(FLASH->ACR, FLASH_ACR_SLEEP_PD) |
| |
| /** |
| * @brief Disable the FLASH power down during Sleep mode |
| * @retval none |
| */ |
| #define __HAL_FLASH_SLEEP_POWERDOWN_DISABLE() CLEAR_BIT(FLASH->ACR, FLASH_ACR_SLEEP_PD) |
| |
| /** |
| * @brief Enable the Flash Run power down mode. |
| * @note Writing this bit to 0 this bit, automatically the keys are |
| * loss and a new unlock sequence is necessary to re-write it to 1. |
| */ |
| #define __HAL_FLASH_POWER_DOWN_ENABLE() do { FLASH->PDKEYR = FLASH_PDKEY1; \ |
| FLASH->PDKEYR = FLASH_PDKEY2; \ |
| SET_BIT((FLASH->ACR), FLASH_ACR_RUN_PD); \ |
| } while (0) |
| |
| /** |
| * @brief Disable the Flash Run power down mode. |
| * @note Writing this bit to 0 this bit, automatically the keys are |
| * loss and a new unlock sequence is necessary to re-write it to 1. |
| */ |
| #define __HAL_FLASH_POWER_DOWN_DISABLE() do { FLASH->PDKEYR = FLASH_PDKEY1; \ |
| FLASH->PDKEYR = FLASH_PDKEY2; \ |
| CLEAR_BIT((FLASH->ACR), FLASH_ACR_RUN_PD); \ |
| } while (0) |
| |
| /** |
| * @} |
| */ |
| |
| /* Exported functions --------------------------------------------------------*/ |
| |
| /** @addtogroup FLASHEx_Exported_Functions |
| * @{ |
| */ |
| |
| /** @addtogroup FLASHEx_Exported_Functions_Group1 |
| * @{ |
| */ |
| |
| HAL_StatusTypeDef HAL_FLASHEx_Erase(FLASH_EraseInitTypeDef *pEraseInit, uint32_t *PageError); |
| HAL_StatusTypeDef HAL_FLASHEx_Erase_IT(FLASH_EraseInitTypeDef *pEraseInit); |
| |
| /** |
| * @} |
| */ |
| |
| /** @addtogroup FLASHEx_Exported_Functions_Group2 |
| * @{ |
| */ |
| |
| HAL_StatusTypeDef HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit); |
| void HAL_FLASHEx_OBGetConfig(FLASH_OBProgramInitTypeDef *pOBInit); |
| |
| #if defined(FLASH_OPTR_WPRMOD) || defined(FLASH_OPTR_BFB2) |
| |
| HAL_StatusTypeDef HAL_FLASHEx_AdvOBProgram (FLASH_AdvOBProgramInitTypeDef *pAdvOBInit); |
| void HAL_FLASHEx_AdvOBGetConfig(FLASH_AdvOBProgramInitTypeDef *pAdvOBInit); |
| |
| #endif /* FLASH_OPTR_WPRMOD || FLASH_OPTR_BFB2 */ |
| |
| #if defined(FLASH_OPTR_WPRMOD) |
| |
| HAL_StatusTypeDef HAL_FLASHEx_OB_SelectPCROP(void); |
| HAL_StatusTypeDef HAL_FLASHEx_OB_DeSelectPCROP(void); |
| |
| #endif /* FLASH_OPTR_WPRMOD */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @addtogroup FLASHEx_Exported_Functions_Group3 |
| * @{ |
| */ |
| |
| HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Unlock(void); |
| HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Lock(void); |
| |
| HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Erase(uint32_t Address); |
| HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data); |
| void HAL_FLASHEx_DATAEEPROM_EnableFixedTimeProgram(void); |
| void HAL_FLASHEx_DATAEEPROM_DisableFixedTimeProgram(void); |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* __STM32L0xx_HAL_FLASH_EX_H */ |
| |