1 /**
2   ******************************************************************************
3   * @file    stm32l1xx_hal_flash_ex.h
4   * @author  MCD Application Team
5   * @brief   Header file of Flash HAL Extended module.
6   ******************************************************************************
7   * @attention
8   *
9   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
10   * All rights reserved.</center></h2>
11   *
12   * This software component is licensed by ST under BSD 3-Clause license,
13   * the "License"; You may not use this file except in compliance with the
14   * License. You may obtain a copy of the License at:
15   *                        opensource.org/licenses/BSD-3-Clause
16   *
17   ******************************************************************************
18   */
19 
20 /* Define to prevent recursive inclusion -------------------------------------*/
21 #ifndef __STM32L1xx_HAL_FLASH_EX_H
22 #define __STM32L1xx_HAL_FLASH_EX_H
23 
24 #ifdef __cplusplus
25  extern "C" {
26 #endif
27 
28 /* Includes ------------------------------------------------------------------*/
29 #include "stm32l1xx_hal_def.h"
30 
31 /** @addtogroup STM32L1xx_HAL_Driver
32   * @{
33   */
34 
35 /** @addtogroup FLASHEx
36   * @{
37   */
38 
39 /** @addtogroup FLASHEx_Private_Constants
40   * @{
41   */
42 #if defined(FLASH_SR_RDERR) && defined(FLASH_SR_OPTVERRUSR)
43 
44 #define FLASH_FLAG_MASK         ( FLASH_FLAG_EOP        | FLASH_FLAG_ENDHV  | FLASH_FLAG_WRPERR | \
45                                   FLASH_FLAG_OPTVERR    | FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR | \
46                                   FLASH_FLAG_OPTVERRUSR | FLASH_FLAG_RDERR)
47 
48 #elif defined(FLASH_SR_RDERR)
49 
50 #define FLASH_FLAG_MASK         ( FLASH_FLAG_EOP        | FLASH_FLAG_ENDHV  | FLASH_FLAG_WRPERR | \
51                                   FLASH_FLAG_OPTVERR    | FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR | \
52                                   FLASH_FLAG_RDERR)
53 
54 #elif defined(FLASH_SR_OPTVERRUSR)
55 
56 #define FLASH_FLAG_MASK         ( FLASH_FLAG_EOP        | FLASH_FLAG_ENDHV  | FLASH_FLAG_WRPERR | \
57                                   FLASH_FLAG_OPTVERR    | FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR | \
58                                   FLASH_FLAG_OPTVERRUSR)
59 
60 #else
61 
62 #define FLASH_FLAG_MASK         ( FLASH_FLAG_EOP        | FLASH_FLAG_ENDHV  | FLASH_FLAG_WRPERR | \
63                                   FLASH_FLAG_OPTVERR    | FLASH_FLAG_PGAERR | FLASH_FLAG_SIZERR)
64 
65 #endif /* FLASH_SR_RDERR & FLASH_SR_OPTVERRUSR */
66 
67 #if defined(STM32L100xB) || defined(STM32L151xB) || defined(STM32L152xB) || defined(STM32L100xBA) \
68  || defined(STM32L151xBA) || defined(STM32L152xBA)
69 
70 /******* Devices with FLASH 128K *******/
71 #define FLASH_NBPAGES_MAX       512U /* 512 pages from page 0 to page 511U */
72 
73 #elif defined(STM32L100xC) || defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC) \
74    || defined(STM32L151xCA) || defined(STM32L152xCA) || defined(STM32L162xCA)
75 
76 /******* Devices with FLASH 256K *******/
77 #define FLASH_NBPAGES_MAX       1025U /* 1025 pages from page 0 to page 1024U */
78 
79 #elif defined(STM32L151xD) || defined(STM32L151xDX) || defined(STM32L152xD) || defined(STM32L152xDX) \
80    || defined(STM32L162xD) || defined(STM32L162xDX)
81 
82 /******* Devices with FLASH 384K *******/
83 #define FLASH_NBPAGES_MAX       1536U /* 1536 pages from page 0 to page 1535U */
84 
85 #elif defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE)
86 
87 /******* Devices with FLASH 512K *******/
88 #define FLASH_NBPAGES_MAX       2048U /* 2048 pages from page 0 to page 2047U */
89 
90 #endif /* STM32L100xB || STM32L151xB || STM32L152xB || STM32L100xBA || STM32L151xBA || STM32L152xBA */
91 
92 #define WRP_MASK_LOW                 (0x0000FFFFU)
93 #define WRP_MASK_HIGH                (0xFFFF0000U)
94 
95 /**
96   * @}
97   */
98 
99 /** @addtogroup FLASHEx_Private_Macros
100   * @{
101   */
102 
103 #define IS_FLASH_TYPEERASE(__VALUE__)   (((__VALUE__) == FLASH_TYPEERASE_PAGES))
104 
105 #define IS_OPTIONBYTE(__VALUE__)        (((__VALUE__) <= (OPTIONBYTE_WRP|OPTIONBYTE_RDP|OPTIONBYTE_USER|OPTIONBYTE_BOR)))
106 
107 #define IS_WRPSTATE(__VALUE__)          (((__VALUE__) == OB_WRPSTATE_DISABLE) || \
108                                          ((__VALUE__) == OB_WRPSTATE_ENABLE))
109 
110 #define IS_OB_WRP(__PAGE__)             (((__PAGE__) != 0x0000000U))
111 
112 #define IS_OB_RDP(__LEVEL__)            (((__LEVEL__) == OB_RDP_LEVEL_0) ||\
113                                          ((__LEVEL__) == OB_RDP_LEVEL_1) ||\
114                                          ((__LEVEL__) == OB_RDP_LEVEL_2))
115 
116 #define IS_OB_BOR_LEVEL(__LEVEL__)      (((__LEVEL__) == OB_BOR_OFF)     || \
117                                          ((__LEVEL__) == OB_BOR_LEVEL1)  || \
118                                          ((__LEVEL__) == OB_BOR_LEVEL2)  || \
119                                          ((__LEVEL__) == OB_BOR_LEVEL3)  || \
120                                          ((__LEVEL__) == OB_BOR_LEVEL4)  || \
121                                          ((__LEVEL__) == OB_BOR_LEVEL5))
122 
123 #define IS_OB_IWDG_SOURCE(__SOURCE__)   (((__SOURCE__) == OB_IWDG_SW) || ((__SOURCE__) == OB_IWDG_HW))
124 
125 #define IS_OB_STOP_SOURCE(__SOURCE__)   (((__SOURCE__) == OB_STOP_NORST) || ((__SOURCE__) == OB_STOP_RST))
126 
127 #define IS_OB_STDBY_SOURCE(__SOURCE__)  (((__SOURCE__) == OB_STDBY_NORST) || ((__SOURCE__) == OB_STDBY_RST))
128 
129 #if defined(FLASH_OBR_SPRMOD) && defined(FLASH_OBR_nRST_BFB2)
130 
131 #define IS_OBEX(__VALUE__)              (((__VALUE__) == OPTIONBYTE_PCROP) || ((__VALUE__) == OPTIONBYTE_BOOTCONFIG))
132 
133 #elif defined(FLASH_OBR_SPRMOD) && !defined(FLASH_OBR_nRST_BFB2)
134 
135 #define IS_OBEX(__VALUE__)              ((__VALUE__) == OPTIONBYTE_PCROP)
136 
137 #elif !defined(FLASH_OBR_SPRMOD) && defined(FLASH_OBR_nRST_BFB2)
138 
139 #define IS_OBEX(__VALUE__)              ((__VALUE__) == OPTIONBYTE_BOOTCONFIG)
140 
141 #endif /* FLASH_OBR_SPRMOD && FLASH_OBR_nRST_BFB2 */
142 
143 #if defined(FLASH_OBR_SPRMOD)
144 
145 #define IS_PCROPSTATE(__VALUE__)        (((__VALUE__) == OB_PCROP_STATE_DISABLE) || \
146                                          ((__VALUE__) == OB_PCROP_STATE_ENABLE))
147 
148 #define IS_OB_PCROP(__PAGE__)           (((__PAGE__) != 0x0000000U))
149 #endif /* FLASH_OBR_SPRMOD */
150 
151 #if defined(FLASH_OBR_nRST_BFB2)
152 
153 #define IS_OB_BOOT_BANK(__BANK__)     (((__BANK__) == OB_BOOT_BANK2) || ((__BANK__) == OB_BOOT_BANK1))
154 
155 #endif /* FLASH_OBR_nRST_BFB2 */
156 
157 #define IS_TYPEERASEDATA(__VALUE__)     (((__VALUE__) == FLASH_TYPEERASEDATA_BYTE) || \
158                                          ((__VALUE__) == FLASH_TYPEERASEDATA_HALFWORD) || \
159                                          ((__VALUE__) == FLASH_TYPEERASEDATA_WORD))
160 #define IS_TYPEPROGRAMDATA(__VALUE__)   (((__VALUE__) == FLASH_TYPEPROGRAMDATA_BYTE) || \
161                                          ((__VALUE__) == FLASH_TYPEPROGRAMDATA_HALFWORD) || \
162                                          ((__VALUE__) == FLASH_TYPEPROGRAMDATA_WORD) || \
163                                          ((__VALUE__) == FLASH_TYPEPROGRAMDATA_FASTBYTE) || \
164                                          ((__VALUE__) == FLASH_TYPEPROGRAMDATA_FASTHALFWORD) || \
165                                          ((__VALUE__) == FLASH_TYPEPROGRAMDATA_FASTWORD))
166 
167 
168 /** @defgroup FLASHEx_Address FLASHEx Address
169   * @{
170   */
171 
172 #define IS_FLASH_DATA_ADDRESS(__ADDRESS__)          (((__ADDRESS__) >= FLASH_EEPROM_BASE) && ((__ADDRESS__) <= FLASH_EEPROM_END))
173 
174 #if defined(STM32L100xB) || defined(STM32L151xB) || defined(STM32L152xB) || defined(STM32L100xBA)  \
175  || defined(STM32L151xBA) || defined(STM32L152xBA) || defined(STM32L100xC) || defined(STM32L151xC) \
176  || defined(STM32L152xC) || defined(STM32L162xC) || defined(STM32L151xCA) || defined(STM32L152xCA) \
177  || defined(STM32L162xCA)
178 
179 #define IS_FLASH_PROGRAM_ADDRESS(__ADDRESS__)       (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) <= FLASH_END))
180 
181 #else /*STM32L151xD || STM32L152xD || STM32L162xD || STM32L151xE || STM32L152xE || STM32L162xE */
182 
183 #define IS_FLASH_PROGRAM_ADDRESS(__ADDRESS__)       (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) <= FLASH_BANK2_END))
184 #define IS_FLASH_PROGRAM_BANK1_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BASE) && ((__ADDRESS__) <= FLASH_BANK1_END))
185 #define IS_FLASH_PROGRAM_BANK2_ADDRESS(__ADDRESS__) (((__ADDRESS__) >= FLASH_BANK2_BASE) && ((__ADDRESS__) <= FLASH_BANK2_END))
186 
187 #endif /* STM32L100xB || STM32L151xB || STM32L152xB || (...) || STM32L151xCA || STM32L152xCA || STM32L162xCA */
188 
189 #define IS_NBPAGES(__PAGES__) (((__PAGES__) >= 1U) && ((__PAGES__) <= FLASH_NBPAGES_MAX))
190 
191 /**
192   * @}
193   */
194 
195 /**
196   * @}
197   */
198 /* Exported types ------------------------------------------------------------*/
199 
200 /** @defgroup FLASHEx_Exported_Types FLASHEx Exported Types
201   * @{
202   */
203 
204 /**
205   * @brief  FLASH Erase structure definition
206   */
207 typedef struct
208 {
209   uint32_t TypeErase;   /*!< TypeErase: Page Erase only.
210                              This parameter can be a value of @ref FLASHEx_Type_Erase */
211 
212   uint32_t PageAddress; /*!< PageAddress: Initial FLASH address to be erased
213                              This parameter must be a value belonging to FLASH Programm address (depending on the devices)  */
214 
215   uint32_t NbPages;     /*!< NbPages: Number of pages to be erased.
216                              This parameter must be a value between 1 and (max number of pages - value of Initial page)*/
217 
218 } FLASH_EraseInitTypeDef;
219 
220 /**
221   * @brief  FLASH Option Bytes PROGRAM structure definition
222   */
223 typedef struct
224 {
225   uint32_t  OptionType;       /*!< OptionType: Option byte to be configured.
226                                    This parameter can be a value of @ref FLASHEx_Option_Type */
227 
228   uint32_t  WRPState;         /*!< WRPState: Write protection activation or deactivation.
229                                    This parameter can be a value of @ref FLASHEx_WRP_State */
230 
231   uint32_t  WRPSector0To31;   /*!< WRPSector0To31: specifies the sector(s) which are write protected between Sector 0 to 31
232                                    This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection1 */
233 
234 #if defined(STM32L100xC) || defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC)    \
235  || defined(STM32L151xCA) || defined(STM32L151xD) || defined(STM32L151xDX) || defined(STM32L152xCA) \
236  || defined(STM32L152xD) || defined(STM32L152xDX) || defined(STM32L162xCA) || defined(STM32L162xD)  \
237  || defined(STM32L162xDX) || defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE)
238   uint32_t  WRPSector32To63;  /*!< WRPSector32To63: specifies the sector(s) which are write protected between Sector 32 to 63
239                                    This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection2 */
240 #endif /* STM32L100xC || STM32L151xC || STM32L152xC || (...) || STM32L151xE || STM32L152xE || STM32L162xE */
241 
242 #if defined(STM32L151xD) || defined(STM32L151xDX) || defined(STM32L152xD) || defined(STM32L152xDX) \
243  || defined(STM32L162xD) || defined(STM32L162xDX) || defined(STM32L151xE) || defined(STM32L152xE)  \
244  || defined(STM32L162xE)
245   uint32_t  WRPSector64To95;  /*!< WRPSector64to95: specifies the sector(s) which are write protected between Sector 64 to 95
246                                    This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection3 */
247 #endif /* STM32L151xD || STM32L152xD || STM32L162xD || STM32L151xE || STM32L152xE || STM32L162xE */
248 
249 #if defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE) || defined(STM32L151xDX) \
250  || defined(STM32L152xDX) || defined(STM32L162xDX)
251   uint32_t  WRPSector96To127; /*!< WRPSector96To127: specifies the sector(s) which are write protected between Sector 96 to 127 or
252                                    Sectors 96 to 111 for STM32L1xxxDX devices.
253                                    This parameter can be a combination of @ref FLASHEx_Option_Bytes_Write_Protection4 */
254 #endif /* STM32L151xE || STM32L152xE || STM32L162xE || STM32L151xDX || ... */
255 
256   uint8_t   RDPLevel;         /*!< RDPLevel: Set the read protection level.
257                                    This parameter can be a value of @ref FLASHEx_Option_Bytes_Read_Protection */
258 
259   uint8_t   BORLevel;         /*!< BORLevel: Set the BOR Level.
260                                    This parameter can be a value of @ref FLASHEx_Option_Bytes_BOR_Level */
261 
262   uint8_t   USERConfig;       /*!< USERConfig: Program the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY.
263                                    This parameter can be a combination of @ref FLASHEx_Option_Bytes_IWatchdog,
264                                    @ref FLASHEx_Option_Bytes_nRST_STOP and @ref FLASHEx_Option_Bytes_nRST_STDBY*/
265 } FLASH_OBProgramInitTypeDef;
266 
267 #if defined(FLASH_OBR_SPRMOD) || defined(FLASH_OBR_nRST_BFB2)
268 /**
269   * @brief  FLASH Advanced Option Bytes Program structure definition
270   */
271 typedef struct
272 {
273   uint32_t OptionType;          /*!< OptionType: Option byte to be configured for extension .
274                                      This parameter can be a value of @ref FLASHEx_OptionAdv_Type */
275 
276 #if defined(FLASH_OBR_SPRMOD)
277   uint32_t PCROPState;          /*!< PCROPState: PCROP activation or deactivation.
278                                      This parameter can be a value of @ref FLASHEx_PCROP_State */
279 
280   uint32_t  PCROPSector0To31;   /*!< PCROPSector0To31: specifies the sector(s) set for PCROP
281                                      This parameter can be a value of @ref FLASHEx_Option_Bytes_PC_ReadWrite_Protection1 */
282 
283 #if defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC)
284   uint32_t  PCROPSector32To63;  /*!< PCROPSector32To63: specifies the sector(s) set for PCROP
285                                      This parameter can be a value of @ref FLASHEx_Option_Bytes_PC_ReadWrite_Protection2 */
286 #endif /* STM32L151xC || STM32L152xC || STM32L162xC */
287 #endif /* FLASH_OBR_SPRMOD */
288 
289 #if defined(FLASH_OBR_nRST_BFB2)
290   uint16_t BootConfig;          /*!< BootConfig: specifies Option bytes for boot config
291                                      This parameter can be a value of @ref FLASHEx_Option_Bytes_BOOT */
292 #endif /* FLASH_OBR_nRST_BFB2*/
293 } FLASH_AdvOBProgramInitTypeDef;
294 
295 /**
296   * @}
297   */
298 #endif /* FLASH_OBR_SPRMOD || FLASH_OBR_nRST_BFB2 */
299 
300 /* Exported constants --------------------------------------------------------*/
301 
302 
303 /** @defgroup FLASHEx_Exported_Constants FLASHEx Exported Constants
304   * @{
305   */
306 
307 /** @defgroup FLASHEx_Type_Erase FLASHEx_Type_Erase
308   * @{
309   */
310 #define FLASH_TYPEERASE_PAGES           (0x00U)  /*!<Page erase only*/
311 
312 /**
313   * @}
314   */
315 
316 /** @defgroup FLASHEx_Option_Type FLASHEx Option Type
317   * @{
318   */
319 #define OPTIONBYTE_WRP            (0x01U)  /*!<WRP option byte configuration*/
320 #define OPTIONBYTE_RDP            (0x02U)  /*!<RDP option byte configuration*/
321 #define OPTIONBYTE_USER           (0x04U)  /*!<USER option byte configuration*/
322 #define OPTIONBYTE_BOR            (0x08U)  /*!<BOR option byte configuration*/
323 
324 /**
325   * @}
326   */
327 
328 /** @defgroup FLASHEx_WRP_State FLASHEx WRP State
329   * @{
330   */
331 #define OB_WRPSTATE_DISABLE        (0x00U)  /*!<Disable the write protection of the desired sectors*/
332 #define OB_WRPSTATE_ENABLE         (0x01U)  /*!<Enable the write protection of the desired sectors*/
333 
334 /**
335   * @}
336   */
337 
338 /** @defgroup FLASHEx_Option_Bytes_Write_Protection1 FLASHEx Option Bytes Write Protection1
339   * @{
340   */
341 
342 /* Common pages for Cat1, Cat2, Cat3, Cat4 & Cat5 devices */
343 #define OB_WRP1_PAGES0TO15    (0x00000001U) /* Write protection of Sector0 */
344 #define OB_WRP1_PAGES16TO31   (0x00000002U) /* Write protection of Sector1 */
345 #define OB_WRP1_PAGES32TO47   (0x00000004U) /* Write protection of Sector2 */
346 #define OB_WRP1_PAGES48TO63   (0x00000008U) /* Write protection of Sector3 */
347 #define OB_WRP1_PAGES64TO79   (0x00000010U) /* Write protection of Sector4 */
348 #define OB_WRP1_PAGES80TO95   (0x00000020U) /* Write protection of Sector5 */
349 #define OB_WRP1_PAGES96TO111  (0x00000040U) /* Write protection of Sector6 */
350 #define OB_WRP1_PAGES112TO127 (0x00000080U) /* Write protection of Sector7 */
351 #define OB_WRP1_PAGES128TO143 (0x00000100U) /* Write protection of Sector8 */
352 #define OB_WRP1_PAGES144TO159 (0x00000200U) /* Write protection of Sector9 */
353 #define OB_WRP1_PAGES160TO175 (0x00000400U) /* Write protection of Sector10 */
354 #define OB_WRP1_PAGES176TO191 (0x00000800U) /* Write protection of Sector11 */
355 #define OB_WRP1_PAGES192TO207 (0x00001000U) /* Write protection of Sector12 */
356 #define OB_WRP1_PAGES208TO223 (0x00002000U) /* Write protection of Sector13 */
357 #define OB_WRP1_PAGES224TO239 (0x00004000U) /* Write protection of Sector14 */
358 #define OB_WRP1_PAGES240TO255 (0x00008000U) /* Write protection of Sector15 */
359 #define OB_WRP1_PAGES256TO271 (0x00010000U) /* Write protection of Sector16 */
360 #define OB_WRP1_PAGES272TO287 (0x00020000U) /* Write protection of Sector17 */
361 #define OB_WRP1_PAGES288TO303 (0x00040000U) /* Write protection of Sector18 */
362 #define OB_WRP1_PAGES304TO319 (0x00080000U) /* Write protection of Sector19 */
363 #define OB_WRP1_PAGES320TO335 (0x00100000U) /* Write protection of Sector20 */
364 #define OB_WRP1_PAGES336TO351 (0x00200000U) /* Write protection of Sector21 */
365 #define OB_WRP1_PAGES352TO367 (0x00400000U) /* Write protection of Sector22 */
366 #define OB_WRP1_PAGES368TO383 (0x00800000U) /* Write protection of Sector23 */
367 #define OB_WRP1_PAGES384TO399 (0x01000000U) /* Write protection of Sector24 */
368 #define OB_WRP1_PAGES400TO415 (0x02000000U) /* Write protection of Sector25 */
369 #define OB_WRP1_PAGES416TO431 (0x04000000U) /* Write protection of Sector26 */
370 #define OB_WRP1_PAGES432TO447 (0x08000000U) /* Write protection of Sector27 */
371 #define OB_WRP1_PAGES448TO463 (0x10000000U) /* Write protection of Sector28 */
372 #define OB_WRP1_PAGES464TO479 (0x20000000U) /* Write protection of Sector29 */
373 #define OB_WRP1_PAGES480TO495 (0x40000000U) /* Write protection of Sector30 */
374 #define OB_WRP1_PAGES496TO511 (0x80000000U) /* Write protection of Sector31 */
375 
376 #define OB_WRP1_ALLPAGES      ((uint32_t)FLASH_WRPR1_WRP) /*!< Write protection of all Sectors */
377 
378 /**
379   * @}
380   */
381 
382 #if defined(STM32L100xC) || defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC)    \
383  || defined(STM32L151xCA) || defined(STM32L151xD) || defined(STM32L151xDX) || defined(STM32L152xCA) \
384  || defined(STM32L152xD) || defined(STM32L152xDX) || defined(STM32L162xCA) || defined(STM32L162xD)  \
385  || defined(STM32L162xDX) || defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE)
386 
387 /** @defgroup FLASHEx_Option_Bytes_Write_Protection2 FLASHEx Option Bytes Write Protection2
388   * @{
389   */
390 
391 /* Pages for Cat3, Cat4 & Cat5 devices*/
392 #define OB_WRP2_PAGES512TO527   (0x00000001U) /* Write protection of Sector32 */
393 #define OB_WRP2_PAGES528TO543   (0x00000002U) /* Write protection of Sector33 */
394 #define OB_WRP2_PAGES544TO559   (0x00000004U) /* Write protection of Sector34 */
395 #define OB_WRP2_PAGES560TO575   (0x00000008U) /* Write protection of Sector35 */
396 #define OB_WRP2_PAGES576TO591   (0x00000010U) /* Write protection of Sector36 */
397 #define OB_WRP2_PAGES592TO607   (0x00000020U) /* Write protection of Sector37 */
398 #define OB_WRP2_PAGES608TO623   (0x00000040U) /* Write protection of Sector38 */
399 #define OB_WRP2_PAGES624TO639   (0x00000080U) /* Write protection of Sector39 */
400 #define OB_WRP2_PAGES640TO655   (0x00000100U) /* Write protection of Sector40 */
401 #define OB_WRP2_PAGES656TO671   (0x00000200U) /* Write protection of Sector41 */
402 #define OB_WRP2_PAGES672TO687   (0x00000400U) /* Write protection of Sector42 */
403 #define OB_WRP2_PAGES688TO703   (0x00000800U) /* Write protection of Sector43 */
404 #define OB_WRP2_PAGES704TO719   (0x00001000U) /* Write protection of Sector44 */
405 #define OB_WRP2_PAGES720TO735   (0x00002000U) /* Write protection of Sector45 */
406 #define OB_WRP2_PAGES736TO751   (0x00004000U) /* Write protection of Sector46 */
407 #define OB_WRP2_PAGES752TO767   (0x00008000U) /* Write protection of Sector47 */
408 
409 #if defined(STM32L100xC) || defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC)   \
410  || defined(STM32L151xCA) || defined(STM32L151xD) || defined(STM32L152xCA) || defined(STM32L152xD) \
411  || defined(STM32L162xCA) || defined(STM32L162xD) || defined(STM32L151xE) || defined(STM32L152xE)  \
412  || defined(STM32L162xE)
413 
414 #define OB_WRP2_PAGES768TO783   (0x00010000U) /* Write protection of Sector48 */
415 #define OB_WRP2_PAGES784TO799   (0x00020000U) /* Write protection of Sector49 */
416 #define OB_WRP2_PAGES800TO815   (0x00040000U) /* Write protection of Sector50 */
417 #define OB_WRP2_PAGES816TO831   (0x00080000U) /* Write protection of Sector51 */
418 #define OB_WRP2_PAGES832TO847   (0x00100000U) /* Write protection of Sector52 */
419 #define OB_WRP2_PAGES848TO863   (0x00200000U) /* Write protection of Sector53 */
420 #define OB_WRP2_PAGES864TO879   (0x00400000U) /* Write protection of Sector54 */
421 #define OB_WRP2_PAGES880TO895   (0x00800000U) /* Write protection of Sector55 */
422 #define OB_WRP2_PAGES896TO911   (0x01000000U) /* Write protection of Sector56 */
423 #define OB_WRP2_PAGES912TO927   (0x02000000U) /* Write protection of Sector57 */
424 #define OB_WRP2_PAGES928TO943   (0x04000000U) /* Write protection of Sector58 */
425 #define OB_WRP2_PAGES944TO959   (0x08000000U) /* Write protection of Sector59 */
426 #define OB_WRP2_PAGES960TO975   (0x10000000U) /* Write protection of Sector60 */
427 #define OB_WRP2_PAGES976TO991   (0x20000000U) /* Write protection of Sector61 */
428 #define OB_WRP2_PAGES992TO1007  (0x40000000U) /* Write protection of Sector62 */
429 #define OB_WRP2_PAGES1008TO1023 (0x80000000U) /* Write protection of Sector63 */
430 
431 #endif /* STM32L100xC || STM32L151xC || STM32L152xC || (...) || STM32L162xD || STM32L151xE || STM32L152xE || STM32L162xE */
432 
433 #define OB_WRP2_ALLPAGES        ((uint32_t)FLASH_WRPR2_WRP) /*!< Write protection of all Sectors */
434 
435 /**
436   * @}
437   */
438 
439 #endif /* STM32L100xC || STM32L151xC || STM32L152xC || (...) || STM32L162xD || STM32L151xDX || STM32L152xE || STM32L162xE */
440 
441 #if defined(STM32L151xD) || defined(STM32L151xDX) || defined(STM32L152xD) || defined(STM32L152xDX) \
442  || defined(STM32L162xD) || defined(STM32L162xDX) || defined(STM32L151xE) || defined(STM32L152xE)  \
443  || defined(STM32L162xE)
444 
445 /** @defgroup FLASHEx_Option_Bytes_Write_Protection3 FLASHEx Option Bytes Write Protection3
446   * @{
447   */
448 
449 /* Pages for devices with FLASH >= 256KB*/
450 #define OB_WRP3_PAGES1024TO1039 (0x00000001U) /* Write protection of Sector64 */
451 #define OB_WRP3_PAGES1040TO1055 (0x00000002U) /* Write protection of Sector65 */
452 #define OB_WRP3_PAGES1056TO1071 (0x00000004U) /* Write protection of Sector66 */
453 #define OB_WRP3_PAGES1072TO1087 (0x00000008U) /* Write protection of Sector67 */
454 #define OB_WRP3_PAGES1088TO1103 (0x00000010U) /* Write protection of Sector68 */
455 #define OB_WRP3_PAGES1104TO1119 (0x00000020U) /* Write protection of Sector69 */
456 #define OB_WRP3_PAGES1120TO1135 (0x00000040U) /* Write protection of Sector70 */
457 #define OB_WRP3_PAGES1136TO1151 (0x00000080U) /* Write protection of Sector71 */
458 #define OB_WRP3_PAGES1152TO1167 (0x00000100U) /* Write protection of Sector72 */
459 #define OB_WRP3_PAGES1168TO1183 (0x00000200U) /* Write protection of Sector73 */
460 #define OB_WRP3_PAGES1184TO1199 (0x00000400U) /* Write protection of Sector74 */
461 #define OB_WRP3_PAGES1200TO1215 (0x00000800U) /* Write protection of Sector75 */
462 #define OB_WRP3_PAGES1216TO1231 (0x00001000U) /* Write protection of Sector76 */
463 #define OB_WRP3_PAGES1232TO1247 (0x00002000U) /* Write protection of Sector77 */
464 #define OB_WRP3_PAGES1248TO1263 (0x00004000U) /* Write protection of Sector78 */
465 #define OB_WRP3_PAGES1264TO1279 (0x00008000U) /* Write protection of Sector79 */
466 #define OB_WRP3_PAGES1280TO1295 (0x00010000U) /* Write protection of Sector80 */
467 #define OB_WRP3_PAGES1296TO1311 (0x00020000U) /* Write protection of Sector81 */
468 #define OB_WRP3_PAGES1312TO1327 (0x00040000U) /* Write protection of Sector82 */
469 #define OB_WRP3_PAGES1328TO1343 (0x00080000U) /* Write protection of Sector83 */
470 #define OB_WRP3_PAGES1344TO1359 (0x00100000U) /* Write protection of Sector84 */
471 #define OB_WRP3_PAGES1360TO1375 (0x00200000U) /* Write protection of Sector85 */
472 #define OB_WRP3_PAGES1376TO1391 (0x00400000U) /* Write protection of Sector86 */
473 #define OB_WRP3_PAGES1392TO1407 (0x00800000U) /* Write protection of Sector87 */
474 #define OB_WRP3_PAGES1408TO1423 (0x01000000U) /* Write protection of Sector88 */
475 #define OB_WRP3_PAGES1424TO1439 (0x02000000U) /* Write protection of Sector89 */
476 #define OB_WRP3_PAGES1440TO1455 (0x04000000U) /* Write protection of Sector90 */
477 #define OB_WRP3_PAGES1456TO1471 (0x08000000U) /* Write protection of Sector91 */
478 #define OB_WRP3_PAGES1472TO1487 (0x10000000U) /* Write protection of Sector92 */
479 #define OB_WRP3_PAGES1488TO1503 (0x20000000U) /* Write protection of Sector93 */
480 #define OB_WRP3_PAGES1504TO1519 (0x40000000U) /* Write protection of Sector94 */
481 #define OB_WRP3_PAGES1520TO1535 (0x80000000U) /* Write protection of Sector95 */
482 
483 #define OB_WRP3_ALLPAGES        ((uint32_t)FLASH_WRPR3_WRP) /*!< Write protection of all Sectors */
484 
485 /**
486   * @}
487   */
488 
489 #endif /* STM32L151xD || STM32L152xD || STM32L162xD || STM32L151xE || STM32L152xE || STM32L162xE*/
490 
491 #if defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE) || defined(STM32L151xDX) \
492  || defined(STM32L152xDX) || defined(STM32L162xDX)
493 
494 /** @defgroup FLASHEx_Option_Bytes_Write_Protection4 FLASHEx Option Bytes Write Protection4
495   * @{
496   */
497 
498 /* Pages for Cat5 devices*/
499 #define OB_WRP4_PAGES1536TO1551 (0x00000001U)/* Write protection of Sector96*/
500 #define OB_WRP4_PAGES1552TO1567 (0x00000002U)/* Write protection of Sector97*/
501 #define OB_WRP4_PAGES1568TO1583 (0x00000004U)/* Write protection of Sector98*/
502 #define OB_WRP4_PAGES1584TO1599 (0x00000008U)/* Write protection of Sector99*/
503 #define OB_WRP4_PAGES1600TO1615 (0x00000010U) /* Write protection of Sector100*/
504 #define OB_WRP4_PAGES1616TO1631 (0x00000020U) /* Write protection of Sector101*/
505 #define OB_WRP4_PAGES1632TO1647 (0x00000040U) /* Write protection of Sector102*/
506 #define OB_WRP4_PAGES1648TO1663 (0x00000080U) /* Write protection of Sector103*/
507 #define OB_WRP4_PAGES1664TO1679 (0x00000100U) /* Write protection of Sector104*/
508 #define OB_WRP4_PAGES1680TO1695 (0x00000200U) /* Write protection of Sector105*/
509 #define OB_WRP4_PAGES1696TO1711 (0x00000400U) /* Write protection of Sector106*/
510 #define OB_WRP4_PAGES1712TO1727 (0x00000800U) /* Write protection of Sector107*/
511 #define OB_WRP4_PAGES1728TO1743 (0x00001000U) /* Write protection of Sector108*/
512 #define OB_WRP4_PAGES1744TO1759 (0x00002000U) /* Write protection of Sector109*/
513 #define OB_WRP4_PAGES1760TO1775 (0x00004000U) /* Write protection of Sector110*/
514 #define OB_WRP4_PAGES1776TO1791 (0x00008000U) /* Write protection of Sector111*/
515 
516 #if defined(STM32L151xE) || defined(STM32L152xE) || defined(STM32L162xE)
517 
518 #define OB_WRP4_PAGES1792TO1807 (0x00010000U) /* Write protection of Sector112*/
519 #define OB_WRP4_PAGES1808TO1823 (0x00020000U) /* Write protection of Sector113*/
520 #define OB_WRP4_PAGES1824TO1839 (0x00040000U) /* Write protection of Sector114*/
521 #define OB_WRP4_PAGES1840TO1855 (0x00080000U) /* Write protection of Sector115*/
522 #define OB_WRP4_PAGES1856TO1871 (0x00100000U) /* Write protection of Sector116*/
523 #define OB_WRP4_PAGES1872TO1887 (0x00200000U) /* Write protection of Sector117*/
524 #define OB_WRP4_PAGES1888TO1903 (0x00400000U) /* Write protection of Sector118*/
525 #define OB_WRP4_PAGES1904TO1919 (0x00800000U) /* Write protection of Sector119*/
526 #define OB_WRP4_PAGES1920TO1935 (0x01000000U) /* Write protection of Sector120*/
527 #define OB_WRP4_PAGES1936TO1951 (0x02000000U) /* Write protection of Sector121*/
528 #define OB_WRP4_PAGES1952TO1967 (0x04000000U) /* Write protection of Sector122*/
529 #define OB_WRP4_PAGES1968TO1983 (0x08000000U) /* Write protection of Sector123*/
530 #define OB_WRP4_PAGES1984TO1999 (0x10000000U) /* Write protection of Sector124*/
531 #define OB_WRP4_PAGES2000TO2015 (0x20000000U) /* Write protection of Sector125*/
532 #define OB_WRP4_PAGES2016TO2031 (0x40000000U) /* Write protection of Sector126*/
533 #define OB_WRP4_PAGES2032TO2047 (0x80000000U) /* Write protection of Sector127*/
534 
535 #endif /* STM32L151xE || STM32L152xE || STM32L162xE */
536 
537 #define OB_WRP4_ALLPAGES        ((uint32_t)FLASH_WRPR4_WRP) /*!< Write protection of all Sectors */
538 
539 /**
540   * @}
541   */
542 
543 #endif /* STM32L151xE || STM32L152xE || STM32L162xE || STM32L151xDX || ... */
544 
545 /** @defgroup FLASHEx_Option_Bytes_Read_Protection FLASHEx Option Bytes Read Protection
546   * @{
547   */
548 #define OB_RDP_LEVEL_0         ((uint8_t)0xAAU)
549 #define OB_RDP_LEVEL_1         ((uint8_t)0xBBU)
550 #define OB_RDP_LEVEL_2         ((uint8_t)0xCCU) /* Warning: When enabling read protection level 2
551                                                 it is no more possible to go back to level 1 or 0 */
552 
553 /**
554   * @}
555   */
556 
557 /** @defgroup FLASHEx_Option_Bytes_BOR_Level FLASHEx Option Bytes BOR Level
558   * @{
559   */
560 
561 #define OB_BOR_OFF       ((uint8_t)0x00U) /*!< BOR is disabled at power down, the reset is asserted when the VDD
562                                               power supply reaches the PDR(Power Down Reset) threshold (1.5V) */
563 #define OB_BOR_LEVEL1    ((uint8_t)0x08U) /*!< BOR Reset threshold levels for 1.7V - 1.8V VDD power supply    */
564 #define OB_BOR_LEVEL2    ((uint8_t)0x09U) /*!< BOR Reset threshold levels for 1.9V - 2.0V VDD power supply    */
565 #define OB_BOR_LEVEL3    ((uint8_t)0x0AU) /*!< BOR Reset threshold levels for 2.3V - 2.4V VDD power supply    */
566 #define OB_BOR_LEVEL4    ((uint8_t)0x0BU) /*!< BOR Reset threshold levels for 2.55V - 2.65V VDD power supply  */
567 #define OB_BOR_LEVEL5    ((uint8_t)0x0CU) /*!< BOR Reset threshold levels for 2.8V - 2.9V VDD power supply    */
568 
569 /**
570   * @}
571   */
572 
573 /** @defgroup FLASHEx_Option_Bytes_IWatchdog FLASHEx Option Bytes IWatchdog
574   * @{
575   */
576 
577 #define OB_IWDG_SW                     ((uint8_t)0x10U)  /*!< Software WDG selected */
578 #define OB_IWDG_HW                     ((uint8_t)0x00U)  /*!< Hardware WDG selected */
579 
580 /**
581   * @}
582   */
583 
584 /** @defgroup FLASHEx_Option_Bytes_nRST_STOP FLASHEx Option Bytes nRST_STOP
585   * @{
586   */
587 
588 #define OB_STOP_NORST                  ((uint8_t)0x20U) /*!< No reset generated when entering in STOP */
589 #define OB_STOP_RST                    ((uint8_t)0x00U) /*!< Reset generated when entering in STOP */
590 /**
591   * @}
592   */
593 
594 /** @defgroup FLASHEx_Option_Bytes_nRST_STDBY FLASHEx Option Bytes nRST_STDBY
595   * @{
596   */
597 
598 #define OB_STDBY_NORST                 ((uint8_t)0x40U) /*!< No reset generated when entering in STANDBY */
599 #define OB_STDBY_RST                   ((uint8_t)0x00U) /*!< Reset generated when entering in STANDBY */
600 
601 /**
602   * @}
603   */
604 
605 #if defined(FLASH_OBR_SPRMOD)
606 
607 /** @defgroup FLASHEx_OptionAdv_Type FLASHEx Option Advanced Type
608   * @{
609   */
610 
611 #define OPTIONBYTE_PCROP        (0x01U)  /*!<PCROP option byte configuration*/
612 
613 /**
614   * @}
615   */
616 
617 #endif /* FLASH_OBR_SPRMOD */
618 
619 #if defined(FLASH_OBR_nRST_BFB2)
620 
621 /** @defgroup FLASHEx_OptionAdv_Type FLASHEx Option Advanced Type
622   * @{
623   */
624 
625 #define OPTIONBYTE_BOOTCONFIG   (0x02U)  /*!<BOOTConfig option byte configuration*/
626 
627 /**
628   * @}
629   */
630 
631 #endif /* FLASH_OBR_nRST_BFB2 */
632 
633 #if defined(FLASH_OBR_SPRMOD)
634 
635 /** @defgroup  FLASHEx_PCROP_State FLASHEx PCROP State
636   * @{
637   */
638 #define OB_PCROP_STATE_DISABLE        (0x00U)  /*!<Disable PCROP for selected sectors */
639 #define OB_PCROP_STATE_ENABLE         (0x01U)  /*!<Enable PCROP for selected sectors */
640 
641 /**
642   * @}
643   */
644 
645 /** @defgroup  FLASHEx_Selection_Protection_Mode FLASHEx Selection Protection Mode
646   * @{
647   */
648 #define OB_PCROP_DESELECTED     ((uint16_t)0x0000U)            /*!< Disabled PCROP, nWPRi bits used for Write Protection on sector i */
649 #define OB_PCROP_SELECTED       ((uint16_t)FLASH_OBR_SPRMOD)  /*!< Enable PCROP, nWPRi bits used for PCRoP Protection on sector i   */
650 
651 /**
652   * @}
653   */
654 #endif /* FLASH_OBR_SPRMOD */
655 
656 #if defined(STM32L151xBA) || defined(STM32L152xBA) || defined(STM32L151xC) || defined(STM32L152xC) \
657  || defined(STM32L162xC)
658 /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection1 FLASHEx Option Bytes PC ReadWrite Protection 1
659   * @{
660   */
661 
662 /* Common pages for Cat1, Cat2, Cat3, Cat4 & Cat5 devices */
663 #define OB_PCROP1_PAGES0TO15    (0x00000001U) /* PC Read/Write  protection of Sector0 */
664 #define OB_PCROP1_PAGES16TO31   (0x00000002U) /* PC Read/Write  protection of Sector1 */
665 #define OB_PCROP1_PAGES32TO47   (0x00000004U) /* PC Read/Write  protection of Sector2 */
666 #define OB_PCROP1_PAGES48TO63   (0x00000008U) /* PC Read/Write  protection of Sector3 */
667 #define OB_PCROP1_PAGES64TO79   (0x00000010U) /* PC Read/Write  protection of Sector4 */
668 #define OB_PCROP1_PAGES80TO95   (0x00000020U) /* PC Read/Write  protection of Sector5 */
669 #define OB_PCROP1_PAGES96TO111  (0x00000040U) /* PC Read/Write  protection of Sector6 */
670 #define OB_PCROP1_PAGES112TO127 (0x00000080U) /* PC Read/Write  protection of Sector7 */
671 #define OB_PCROP1_PAGES128TO143 (0x00000100U) /* PC Read/Write  protection of Sector8 */
672 #define OB_PCROP1_PAGES144TO159 (0x00000200U) /* PC Read/Write  protection of Sector9 */
673 #define OB_PCROP1_PAGES160TO175 (0x00000400U) /* PC Read/Write  protection of Sector10 */
674 #define OB_PCROP1_PAGES176TO191 (0x00000800U) /* PC Read/Write  protection of Sector11 */
675 #define OB_PCROP1_PAGES192TO207 (0x00001000U) /* PC Read/Write  protection of Sector12 */
676 #define OB_PCROP1_PAGES208TO223 (0x00002000U) /* PC Read/Write  protection of Sector13 */
677 #define OB_PCROP1_PAGES224TO239 (0x00004000U) /* PC Read/Write  protection of Sector14 */
678 #define OB_PCROP1_PAGES240TO255 (0x00008000U) /* PC Read/Write  protection of Sector15 */
679 #define OB_PCROP1_PAGES256TO271 (0x00010000U) /* PC Read/Write  protection of Sector16 */
680 #define OB_PCROP1_PAGES272TO287 (0x00020000U) /* PC Read/Write  protection of Sector17 */
681 #define OB_PCROP1_PAGES288TO303 (0x00040000U) /* PC Read/Write  protection of Sector18 */
682 #define OB_PCROP1_PAGES304TO319 (0x00080000U) /* PC Read/Write  protection of Sector19 */
683 #define OB_PCROP1_PAGES320TO335 (0x00100000U) /* PC Read/Write  protection of Sector20 */
684 #define OB_PCROP1_PAGES336TO351 (0x00200000U) /* PC Read/Write  protection of Sector21 */
685 #define OB_PCROP1_PAGES352TO367 (0x00400000U) /* PC Read/Write  protection of Sector22 */
686 #define OB_PCROP1_PAGES368TO383 (0x00800000U) /* PC Read/Write  protection of Sector23 */
687 #define OB_PCROP1_PAGES384TO399 (0x01000000U) /* PC Read/Write  protection of Sector24 */
688 #define OB_PCROP1_PAGES400TO415 (0x02000000U) /* PC Read/Write  protection of Sector25 */
689 #define OB_PCROP1_PAGES416TO431 (0x04000000U) /* PC Read/Write  protection of Sector26 */
690 #define OB_PCROP1_PAGES432TO447 (0x08000000U) /* PC Read/Write  protection of Sector27 */
691 #define OB_PCROP1_PAGES448TO463 (0x10000000U) /* PC Read/Write  protection of Sector28 */
692 #define OB_PCROP1_PAGES464TO479 (0x20000000U) /* PC Read/Write  protection of Sector29 */
693 #define OB_PCROP1_PAGES480TO495 (0x40000000U) /* PC Read/Write  protection of Sector30 */
694 #define OB_PCROP1_PAGES496TO511 (0x80000000U) /* PC Read/Write  protection of Sector31 */
695 
696 #define OB_PCROP1_ALLPAGES      (0xFFFFFFFFU) /*!< PC Read/Write  protection of all Sectors */
697 
698 /**
699   * @}
700   */
701 #endif /* STM32L151xBA || STM32L152xBA || STM32L151xC || STM32L152xC || STM32L162xC */
702 
703 #if defined(STM32L151xC) || defined(STM32L152xC) || defined(STM32L162xC)
704 
705 /** @defgroup FLASHEx_Option_Bytes_PC_ReadWrite_Protection2 FLASHEx Option Bytes PC ReadWrite Protection 2
706   * @{
707   */
708 
709 /* Pages for Cat3, Cat4 & Cat5 devices*/
710 #define OB_PCROP2_PAGES512TO527   (0x00000001U) /* PC Read/Write  protection of Sector32 */
711 #define OB_PCROP2_PAGES528TO543   (0x00000002U) /* PC Read/Write  protection of Sector33 */
712 #define OB_PCROP2_PAGES544TO559   (0x00000004U) /* PC Read/Write  protection of Sector34 */
713 #define OB_PCROP2_PAGES560TO575   (0x00000008U) /* PC Read/Write  protection of Sector35 */
714 #define OB_PCROP2_PAGES576TO591   (0x00000010U) /* PC Read/Write  protection of Sector36 */
715 #define OB_PCROP2_PAGES592TO607   (0x00000020U) /* PC Read/Write  protection of Sector37 */
716 #define OB_PCROP2_PAGES608TO623   (0x00000040U) /* PC Read/Write  protection of Sector38 */
717 #define OB_PCROP2_PAGES624TO639   (0x00000080U) /* PC Read/Write  protection of Sector39 */
718 #define OB_PCROP2_PAGES640TO655   (0x00000100U) /* PC Read/Write  protection of Sector40 */
719 #define OB_PCROP2_PAGES656TO671   (0x00000200U) /* PC Read/Write  protection of Sector41 */
720 #define OB_PCROP2_PAGES672TO687   (0x00000400U) /* PC Read/Write  protection of Sector42 */
721 #define OB_PCROP2_PAGES688TO703   (0x00000800U) /* PC Read/Write  protection of Sector43 */
722 #define OB_PCROP2_PAGES704TO719   (0x00001000U) /* PC Read/Write  protection of Sector44 */
723 #define OB_PCROP2_PAGES720TO735   (0x00002000U) /* PC Read/Write  protection of Sector45 */
724 #define OB_PCROP2_PAGES736TO751   (0x00004000U) /* PC Read/Write  protection of Sector46 */
725 #define OB_PCROP2_PAGES752TO767   (0x00008000U) /* PC Read/Write  protection of Sector47 */
726 #define OB_PCROP2_PAGES768TO783   (0x00010000U) /* PC Read/Write  protection of Sector48 */
727 #define OB_PCROP2_PAGES784TO799   (0x00020000U) /* PC Read/Write  protection of Sector49 */
728 #define OB_PCROP2_PAGES800TO815   (0x00040000U) /* PC Read/Write  protection of Sector50 */
729 #define OB_PCROP2_PAGES816TO831   (0x00080000U) /* PC Read/Write  protection of Sector51 */
730 #define OB_PCROP2_PAGES832TO847   (0x00100000U) /* PC Read/Write  protection of Sector52 */
731 #define OB_PCROP2_PAGES848TO863   (0x00200000U) /* PC Read/Write  protection of Sector53 */
732 #define OB_PCROP2_PAGES864TO879   (0x00400000U) /* PC Read/Write  protection of Sector54 */
733 #define OB_PCROP2_PAGES880TO895   (0x00800000U) /* PC Read/Write  protection of Sector55 */
734 #define OB_PCROP2_PAGES896TO911   (0x01000000U) /* PC Read/Write  protection of Sector56 */
735 #define OB_PCROP2_PAGES912TO927   (0x02000000U) /* PC Read/Write  protection of Sector57 */
736 #define OB_PCROP2_PAGES928TO943   (0x04000000U) /* PC Read/Write  protection of Sector58 */
737 #define OB_PCROP2_PAGES944TO959   (0x08000000U) /* PC Read/Write  protection of Sector59 */
738 #define OB_PCROP2_PAGES960TO975   (0x10000000U) /* PC Read/Write  protection of Sector60 */
739 #define OB_PCROP2_PAGES976TO991   (0x20000000U) /* PC Read/Write  protection of Sector61 */
740 #define OB_PCROP2_PAGES992TO1007  (0x40000000U) /* PC Read/Write  protection of Sector62 */
741 #define OB_PCROP2_PAGES1008TO1023 (0x80000000U) /* PC Read/Write  protection of Sector63 */
742 
743 #define OB_PCROP2_ALLPAGES        (0xFFFFFFFFU) /*!< PC Read/Write  protection of all Sectors */
744 
745 /**
746   * @}
747   */
748 #endif /* STM32L151xC || STM32L152xC || STM32L162xC */
749 
750 /** @defgroup FLASHEx_Type_Erase_Data FLASHEx Type Erase Data
751   * @{
752   */
753 #define FLASH_TYPEERASEDATA_BYTE            (0x00U)  /*!<Erase byte (8-bit) at a specified address.*/
754 #define FLASH_TYPEERASEDATA_HALFWORD        (0x01U)  /*!<Erase a half-word (16-bit) at a specified address.*/
755 #define FLASH_TYPEERASEDATA_WORD            (0x02U)  /*!<Erase a word (32-bit) at a specified address.*/
756 
757 /**
758   * @}
759   */
760 
761 /** @defgroup FLASHEx_Type_Program_Data FLASHEx Type Program Data
762   * @{
763   */
764 #define FLASH_TYPEPROGRAMDATA_BYTE            (0x00U)  /*!<Program byte (8-bit) at a specified address.*/
765 #define FLASH_TYPEPROGRAMDATA_HALFWORD        (0x01U)  /*!<Program a half-word (16-bit) at a specified address.*/
766 #define FLASH_TYPEPROGRAMDATA_WORD            (0x02U)  /*!<Program a word (32-bit) at a specified address.*/
767 #define FLASH_TYPEPROGRAMDATA_FASTBYTE        (0x04U)  /*!<Fast Program byte (8-bit) at a specified address.*/
768 #define FLASH_TYPEPROGRAMDATA_FASTHALFWORD    (0x08U)  /*!<Fast Program a half-word (16-bit) at a specified address.*/
769 #define FLASH_TYPEPROGRAMDATA_FASTWORD        (0x10U)  /*!<Fast Program a word (32-bit) at a specified address.*/
770 
771 /**
772   * @}
773   */
774 
775 #if defined(FLASH_OBR_nRST_BFB2)
776 
777 /** @defgroup FLASHEx_Option_Bytes_BOOT FLASHEx Option Bytes BOOT
778   * @{
779   */
780 
781 #define OB_BOOT_BANK2                 ((uint8_t)0x00U) /*!< At startup, if boot pins are set in boot from user Flash position
782                                                             and this parameter is selected the device will boot from Bank 2
783                                                             or Bank 1, depending on the activation of the bank */
784 #define OB_BOOT_BANK1                 ((uint8_t)(FLASH_OBR_nRST_BFB2 >> 16U)) /*!< At startup, if boot pins are set in boot from user Flash position
785                                                             and this parameter is selected the device will boot from Bank1(Default) */
786 
787 /**
788   * @}
789   */
790 #endif /* FLASH_OBR_nRST_BFB2 */
791 
792 /**
793   * @}
794   */
795 
796 /* Exported macro ------------------------------------------------------------*/
797 
798 /** @defgroup FLASHEx_Exported_Macros FLASHEx Exported Macros
799  *  @{
800  */
801 
802 /**
803   * @brief  Set the FLASH Latency.
804   * @param  __LATENCY__ FLASH Latency
805   *          This parameter can be one of the following values:
806   *            @arg @ref FLASH_LATENCY_0  FLASH Zero Latency cycle
807   *            @arg @ref FLASH_LATENCY_1  FLASH One Latency cycle
808   * @retval none
809   */
810 #define __HAL_FLASH_SET_LATENCY(__LATENCY__)  do  { \
811                                                   if ((__LATENCY__) == FLASH_LATENCY_1) {__HAL_FLASH_ACC64_ENABLE();} \
812                                                   MODIFY_REG((FLASH->ACR), FLASH_ACR_LATENCY, (__LATENCY__)); \
813                                               } while(0U)
814 
815 /**
816   * @brief  Get the FLASH Latency.
817   * @retval FLASH Latency
818   *          This parameter can be one of the following values:
819   *            @arg @ref FLASH_LATENCY_0  FLASH Zero Latency cycle
820   *            @arg @ref FLASH_LATENCY_1  FLASH One Latency cycle
821   */
822 #define __HAL_FLASH_GET_LATENCY()     (READ_BIT((FLASH->ACR), FLASH_ACR_LATENCY))
823 
824 /**
825   * @brief  Enable the FLASH 64-bit access.
826   * @note    Read access 64 bit is used.
827   * @note    This bit cannot be written at the same time as the LATENCY and
828   *          PRFTEN bits.
829   * @retval none
830   */
831 #define __HAL_FLASH_ACC64_ENABLE()    (SET_BIT((FLASH->ACR), FLASH_ACR_ACC64))
832 
833   /**
834   * @brief  Disable the FLASH 64-bit access.
835   * @note     Read access 32 bit is used
836   * @note     To reset this bit, the LATENCY should be zero wait state and the
837   *               prefetch off.
838   * @retval none
839   */
840 #define __HAL_FLASH_ACC64_DISABLE()   (CLEAR_BIT((FLASH->ACR), FLASH_ACR_ACC64))
841 
842 /**
843   * @brief  Enable the FLASH prefetch buffer.
844   * @retval none
845   */
846 #define __HAL_FLASH_PREFETCH_BUFFER_ENABLE()    do  { __HAL_FLASH_ACC64_ENABLE(); \
847                                                   SET_BIT((FLASH->ACR), FLASH_ACR_PRFTEN); \
848                                                 } while(0U)
849 
850 /**
851   * @brief  Disable the FLASH prefetch buffer.
852   * @retval none
853   */
854 #define __HAL_FLASH_PREFETCH_BUFFER_DISABLE()     CLEAR_BIT((FLASH->ACR), FLASH_ACR_PRFTEN)
855 
856 /**
857   * @brief  Enable the FLASH power down during Sleep mode
858   * @retval none
859   */
860 #define __HAL_FLASH_SLEEP_POWERDOWN_ENABLE()      SET_BIT(FLASH->ACR, FLASH_ACR_SLEEP_PD)
861 
862 /**
863   * @brief  Disable the FLASH power down during Sleep mode
864   * @retval none
865   */
866 #define __HAL_FLASH_SLEEP_POWERDOWN_DISABLE()     CLEAR_BIT(FLASH->ACR, FLASH_ACR_SLEEP_PD)
867 
868 /**
869   * @brief  Enable the Flash Run power down mode.
870   * @note   Writing this bit  to 0 this bit, automatically the keys are
871   *         loss and a new unlock sequence is necessary to re-write it to 1.
872   */
873 #define __HAL_FLASH_POWER_DOWN_ENABLE() do { FLASH->PDKEYR = FLASH_PDKEY1;    \
874                                              FLASH->PDKEYR = FLASH_PDKEY2;    \
875                                              SET_BIT((FLASH->ACR), FLASH_ACR_RUN_PD);  \
876                                            } while (0U)
877 
878 /**
879   * @brief  Disable the Flash Run power down mode.
880   * @note   Writing this bit to 0 this bit, automatically the keys are
881   *         loss and a new unlock sequence is necessary to re-write it to 1.
882   */
883 #define __HAL_FLASH_POWER_DOWN_DISABLE() do { FLASH->PDKEYR = FLASH_PDKEY1;    \
884                                               FLASH->PDKEYR = FLASH_PDKEY2;    \
885                                              CLEAR_BIT((FLASH->ACR), FLASH_ACR_RUN_PD);  \
886                                             } while (0U)
887 
888 /**
889   * @}
890   */
891 
892 /* Exported functions --------------------------------------------------------*/
893 
894 /** @addtogroup FLASHEx_Exported_Functions
895   * @{
896   */
897 
898 /** @addtogroup FLASHEx_Exported_Functions_Group1
899   * @{
900   */
901 
902 HAL_StatusTypeDef HAL_FLASHEx_Erase(FLASH_EraseInitTypeDef *pEraseInit, uint32_t *PageError);
903 HAL_StatusTypeDef HAL_FLASHEx_Erase_IT(FLASH_EraseInitTypeDef *pEraseInit);
904 
905 /**
906   * @}
907   */
908 
909 /** @addtogroup FLASHEx_Exported_Functions_Group2
910   * @{
911   */
912 
913 HAL_StatusTypeDef HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit);
914 void              HAL_FLASHEx_OBGetConfig(FLASH_OBProgramInitTypeDef *pOBInit);
915 
916 #if defined(FLASH_OBR_SPRMOD) || defined(FLASH_OBR_nRST_BFB2)
917 
918 HAL_StatusTypeDef HAL_FLASHEx_AdvOBProgram (FLASH_AdvOBProgramInitTypeDef *pAdvOBInit);
919 void              HAL_FLASHEx_AdvOBGetConfig(FLASH_AdvOBProgramInitTypeDef *pAdvOBInit);
920 
921 #endif /* FLASH_OBR_SPRMOD || FLASH_OBR_nRST_BFB2 */
922 
923 #if defined(FLASH_OBR_SPRMOD)
924 
925 HAL_StatusTypeDef HAL_FLASHEx_OB_SelectPCROP(void);
926 HAL_StatusTypeDef HAL_FLASHEx_OB_DeSelectPCROP(void);
927 
928 #endif /* FLASH_OBR_SPRMOD */
929 
930 /**
931   * @}
932   */
933 
934 /** @addtogroup FLASHEx_Exported_Functions_Group3
935   * @{
936   */
937 
938 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Unlock(void);
939 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Lock(void);
940 
941 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Erase(uint32_t TypeErase, uint32_t Address);
942 HAL_StatusTypeDef HAL_FLASHEx_DATAEEPROM_Program(uint32_t TypeProgram, uint32_t Address, uint32_t Data);
943 void              HAL_FLASHEx_DATAEEPROM_EnableFixedTimeProgram(void);
944 void              HAL_FLASHEx_DATAEEPROM_DisableFixedTimeProgram(void);
945 
946 /**
947   * @}
948   */
949 
950 /**
951   * @}
952   */
953 
954 /**
955   * @}
956   */
957 
958 /**
959   * @}
960   */
961 
962 #ifdef __cplusplus
963 }
964 #endif
965 
966 #endif /* __STM32L1xx_HAL_FLASH_EX_H */
967 
968 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
969