1 /**
2   ******************************************************************************
3   * @file    stm32h5xx_hal_flash.h
4   * @author  MCD Application Team
5   * @brief   Header file of FLASH HAL module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2023 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32H5xx_HAL_FLASH_H
21 #define STM32H5xx_HAL_FLASH_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32h5xx_hal_def.h"
29 
30 /** @addtogroup STM32H5xx_HAL_Driver
31   * @{
32   */
33 
34 /** @addtogroup FLASH
35   * @{
36   */
37 
38 /* Exported types ------------------------------------------------------------*/
39 /** @defgroup FLASH_Exported_Types FLASH Exported Types
40   * @{
41   */
42 
43 /**
44   * @brief  FLASH handle Structure definition
45   */
46 typedef struct
47 {
48   HAL_LockTypeDef        Lock;               /*!< FLASH locking object                                                */
49 
50   uint32_t               ErrorCode;          /*!< FLASH error code                                                    */
51 
52   uint32_t               ProcedureOnGoing;   /*!< Internal variable to indicate which procedure is ongoing or not
53                                                   in IT context */
54 
55   uint32_t               Address;            /*!< Internal variable to save address selected for program              */
56 
57   uint32_t               Bank;               /*!< Internal variable to save current bank selected during erase in
58                                                   IT context */
59 
60   uint32_t               Sector;             /*!< Internal variable to define the current sector which is erasing     */
61 
62   uint32_t               NbSectorsToErase;   /*!< Internal variable to save the remaining sectors to erase in
63                                                   IT context  */
64 
65 } FLASH_ProcessTypeDef;
66 
67 /**
68   * @}
69   */
70 
71 /* Exported constants --------------------------------------------------------*/
72 /** @defgroup FLASH_Exported_Constants FLASH Exported Constants
73   * @{
74   */
75 
76 /** @defgroup FLASH_Flag_definition FLASH Flag definition
77   * @brief Flag definition
78   * @{
79   */
80 #define FLASH_FLAG_BSY                     FLASH_SR_BSY             /*!< FLASH Busy flag */
81 #define FLASH_FLAG_WBNE                    FLASH_SR_WBNE            /*!< FLASH Write Buffer Not Empty flag */
82 #define FLASH_FLAG_DBNE                    FLASH_SR_DBNE            /*!< FLASH data Buffer Not Empty flag */
83 #define FLASH_FLAG_EOP                     FLASH_SR_EOP             /*!< FLASH End Of operation flag */
84 #define FLASH_FLAG_WRPERR                  FLASH_SR_WRPERR          /*!< FLASH Write Protection Error flag */
85 #define FLASH_FLAG_PGSERR                  FLASH_SR_PGSERR          /*!< FLASH Program Sequence Error flag */
86 #define FLASH_FLAG_STRBERR                 FLASH_SR_STRBERR         /*!< FLASH Strobe Error flag */
87 #define FLASH_FLAG_INCERR                  FLASH_SR_INCERR          /*!< FLASH Inconsistency Error flag */
88 #if defined (FLASH_SR_OBKERR)
89 #define FLASH_FLAG_OBKERR                  FLASH_SR_OBKERR          /*!< FLASH OBK Error flag */
90 #define FLASH_FLAG_OBKWERR                 FLASH_SR_OBKWERR         /*!< FLASH OBK Write Error flag */
91 #endif /* FLASH_SR_OBKERR */
92 #define FLASH_FLAG_OPTCHANGEERR            FLASH_SR_OPTCHANGEERR    /*!< FLASH Option Byte change Error flag */
93 #define FLASH_FLAG_ECCC                    FLASH_ECCR_ECCC          /*!< FLASH ECC Correction flag */
94 #define FLASH_FLAG_ECCD                    FLASH_ECCR_ECCD          /*!< FLASH ECC Detection flag */
95 
96 #if defined (FLASH_SR_OBKERR)
97 #define FLASH_FLAG_SR_ERRORS               (FLASH_SR_WRPERR      | FLASH_SR_PGSERR    | \
98                                             FLASH_SR_STRBERR     | FLASH_SR_INCERR    | \
99                                             FLASH_SR_OBKERR      | FLASH_SR_OBKWERR   | \
100                                             FLASH_SR_OPTCHANGEERR)
101 #else
102 #define FLASH_FLAG_SR_ERRORS               (FLASH_SR_WRPERR      | FLASH_SR_PGSERR    | \
103                                             FLASH_SR_STRBERR     | FLASH_SR_INCERR    | \
104                                             FLASH_SR_OPTCHANGEERR)
105 #endif /* FLASH_SR_OBKERR */
106 #define FLASH_FLAG_ECCR_ERRORS             (FLASH_FLAG_ECCC      | FLASH_FLAG_ECCD)
107 #define FLASH_FLAG_ALL_ERRORS              (FLASH_FLAG_SR_ERRORS | FLASH_FLAG_ECCR_ERRORS) /*!< All FLASH error flags */
108 /**
109   * @}
110   */
111 
112 /** @defgroup FLASH_Interrupt_definition FLASH Interrupts definition
113   * @brief FLASH Interrupt definition
114   * @{
115   */
116 #define FLASH_IT_EOP                  FLASH_CR_EOPIE        /*!< End of FLASH Operation interrupt enable */
117 #define FLASH_IT_WRPERR               FLASH_CR_WRPERRIE     /*!< Write Protection Error interrupt enable */
118 #define FLASH_IT_PGSERR               FLASH_CR_PGSERRIE     /*!< Program Sequence Error interrupt enable */
119 #define FLASH_IT_STRBERR              FLASH_CR_STRBERRIE    /*!< Strobe Error interrupt enable */
120 #define FLASH_IT_INCERR               FLASH_CR_INCERRIE     /*!< Inconsistency Error interrupt enable */
121 #if defined (FLASH_SR_OBKERR)
122 #define FLASH_IT_OBKERR               FLASH_CR_OBKERRIE     /*!< OBK Error interrupt enable */
123 #define FLASH_IT_OBKWERR              FLASH_CR_OBKWERRIE    /*!< OBK Write Error interrupt enable */
124 #endif /* FLASH_SR_OBKERR */
125 #define FLASH_IT_OPTCHANGEERR         FLASH_CR_OPTCHANGEERRIE /*!< Option Byte change Error interrupt enable */
126 #define FLASH_IT_ECCC                 FLASH_ECCR_ECCIE      /*!< Single ECC Error Correction interrupt enable */
127 
128 #if defined (FLASH_SR_OBKERR)
129 #define FLASH_IT_ALL                 (FLASH_IT_EOP       | FLASH_IT_WRPERR   | \
130                                       FLASH_IT_PGSERR    | FLASH_IT_STRBERR  | \
131                                       FLASH_IT_INCERR    | FLASH_IT_OBKERR   | \
132                                       FLASH_IT_OBKWERR   | FLASH_IT_OPTCHANGEERR   | \
133                                       FLASH_IT_ECCC) /*!< All Flash interrupt sources */
134 #else
135 #define FLASH_IT_ALL                 (FLASH_IT_EOP       | FLASH_IT_WRPERR       | \
136                                       FLASH_IT_PGSERR    | FLASH_IT_STRBERR      | \
137                                       FLASH_IT_INCERR    | FLASH_IT_OPTCHANGEERR | \
138                                       FLASH_IT_ECCC) /*!< All Flash interrupt sources */
139 #endif /* FLASH_SR_OBKERR */
140 
141 /**
142   * @}
143   */
144 
145 /** @defgroup FLASH_Error_Code FLASH Error Code
146   * @brief    FLASH Error Code
147   * @{
148   */
149 #define HAL_FLASH_ERROR_NONE         0x00000000U               /*!< No error                              */
150 #define HAL_FLASH_ERROR_WRP          FLASH_FLAG_WRPERR         /*!< Write Protection Error                */
151 #define HAL_FLASH_ERROR_PGS          FLASH_FLAG_PGSERR         /*!< Program Sequence Error                */
152 #define HAL_FLASH_ERROR_STRB         FLASH_FLAG_STRBERR        /*!< Strobe Error                          */
153 #define HAL_FLASH_ERROR_INC          FLASH_FLAG_INCERR         /*!< Inconsistency Error                   */
154 #if defined (FLASH_SR_OBKERR)
155 #define HAL_FLASH_ERROR_OBK          FLASH_FLAG_OBKERR         /*!< OBK Error                             */
156 #define HAL_FLASH_ERROR_OBKW         FLASH_FLAG_OBKWERR        /*!< OBK Write Error                       */
157 #endif /* FLASH_SR_OBKERR */
158 #define HAL_FLASH_ERROR_OB_CHANGE    FLASH_FLAG_OPTCHANGEERR   /*!< Option Byte Change Error              */
159 #define HAL_FLASH_ERROR_ECCC         FLASH_FLAG_ECCC           /*!< ECC Single Correction Error           */
160 #define HAL_FLASH_ERROR_ECCD         FLASH_FLAG_ECCD           /*!< ECC Double Detection Error            */
161 /**
162   * @}
163   */
164 
165 /** @defgroup FLASH_Type_Program FLASH Program Type
166   * @{
167   */
168 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
169 #define FLASH_TYPEPROGRAM_QUADWORD         FLASH_CR_PG                                        /*!< Program a quad-word
170                                                                              (128-bit) at  a specified secure address */
171 #define FLASH_TYPEPROGRAM_QUADWORD_NS       (FLASH_CR_PG | FLASH_NON_SECURE_MASK)              /*!< Program a quad-word
172                                                                           (128-bit) at a specified non-secure address */
173 #if defined (FLASH_SR_OBKERR)
174 #define FLASH_TYPEPROGRAM_QUADWORD_OBK      (FLASH_CR_PG | FLASH_OBK)                          /*!< Program a quad-word
175                                                                                    (128-bit) of OBK to current sector */
176 #define FLASH_TYPEPROGRAM_QUADWORD_OBK_ALT  (FLASH_CR_PG | FLASH_OBK | FLASH_OBKCFGR_ALT_SECT) /*!< Program a quad-word
177                                                                                  (128-bit) of OBK to alternate sector */
178 #endif /* FLASH_SR_OBKERR */
179 #if defined (FLASH_EDATAR_EDATA_EN)
180 #define FLASH_TYPEPROGRAM_HALFWORD_EDATA    (FLASH_CR_PG | FLASH_EDATA_HALFWORD)               /*!< Program a flash
181                                                       high-cycle data half-word (16-bit)at a specified secure address */
182 #define FLASH_TYPEPROGRAM_HALFWORD_EDATA_NS (FLASH_CR_PG | FLASH_EDATA_HALFWORD | FLASH_NON_SECURE_MASK)  /*!< Program a flash
183                                                   high-cycle data half-word (16-bit)at a specified non-secure address */
184 #define FLASH_TYPEPROGRAM_WORD_EDATA    (FLASH_CR_PG | FLASH_EDATA_WORD)                          /*!< Program a flash
185                                                       high-cycle data word (32-bit)at a specified secure address */
186 #define FLASH_TYPEPROGRAM_WORD_EDATA_NS (FLASH_CR_PG | FLASH_EDATA_WORD | FLASH_NON_SECURE_MASK)  /*!< Program a flash
187                                                   high-cycle data word (32-bit)at a specified non-secure address */
188 #endif /* FLASH_EDATAR_EDATA_EN */
189 #else
190 #define FLASH_TYPEPROGRAM_QUADWORD           FLASH_CR_PG                                        /*!< Program a quad-word
191                                                                                      (128-bit) at a specified address */
192 #if defined (FLASH_SR_OBKERR)
193 #define FLASH_TYPEPROGRAM_QUADWORD_OBK     (FLASH_CR_PG | FLASH_OBK)                           /*!< Program a quad-word
194                                                                                    (128-bit) of OBK to current sector */
195 #define FLASH_TYPEPROGRAM_QUADWORD_OBK_ALT (FLASH_CR_PG | FLASH_OBK | FLASH_OBKCFGR_ALT_SECT)  /*!< Program a quad-word
196                                                                                  (128-bit) of OBK to alternate sector */
197 #endif /* FLASH_SR_OBKERR */
198 #if defined (FLASH_EDATAR_EDATA_EN)
199 #define FLASH_TYPEPROGRAM_HALFWORD_EDATA    (FLASH_CR_PG | FLASH_EDATA_HALFWORD)                /*!< Program a flash
200                                                              high-cycle data half-word (16-bit)at a specified address */
201 #define FLASH_TYPEPROGRAM_WORD_EDATA    (FLASH_CR_PG | FLASH_EDATA_WORD)                          /*!< Program a flash
202                                                              high-cycle data half-word (32-bit)at a specified address */
203 #endif /* FLASH_EDATAR_EDATA_EN */
204 #endif /* __ARM_FEATURE_CMSE */
205 #define FLASH_TYPEPROGRAM_HALFWORD_OTP      (FLASH_CR_PG | FLASH_OTP | FLASH_NON_SECURE_MASK)   /*!< Program an OTP
206                                                                              half-word (16-bit)at a specified address */
207 /**
208   * @}
209   */
210 
211 /** @defgroup FLASH_Latency FLASH Latency
212   * @{
213   */
214 #define FLASH_LATENCY_0          FLASH_ACR_LATENCY_0WS   /*!< FLASH Zero wait cycle      */
215 #define FLASH_LATENCY_1          FLASH_ACR_LATENCY_1WS   /*!< FLASH One wait cycle       */
216 #define FLASH_LATENCY_2          FLASH_ACR_LATENCY_2WS   /*!< FLASH Two wait cycles      */
217 #define FLASH_LATENCY_3          FLASH_ACR_LATENCY_3WS   /*!< FLASH Three wait cycles    */
218 #define FLASH_LATENCY_4          FLASH_ACR_LATENCY_4WS   /*!< FLASH Four wait cycles     */
219 #define FLASH_LATENCY_5          FLASH_ACR_LATENCY_5WS   /*!< FLASH Five wait cycles     */
220 #define FLASH_LATENCY_6          FLASH_ACR_LATENCY_6WS   /*!< FLASH Six wait cycles      */
221 #define FLASH_LATENCY_7          FLASH_ACR_LATENCY_7WS   /*!< FLASH Seven wait cycles    */
222 #define FLASH_LATENCY_8          FLASH_ACR_LATENCY_8WS   /*!< FLASH Eight wait cycle     */
223 #define FLASH_LATENCY_9          FLASH_ACR_LATENCY_9WS   /*!< FLASH Nine wait cycle      */
224 #define FLASH_LATENCY_10         FLASH_ACR_LATENCY_10WS  /*!< FLASH Ten wait cycles      */
225 #define FLASH_LATENCY_11         FLASH_ACR_LATENCY_11WS  /*!< FLASH Eleven wait cycles   */
226 #define FLASH_LATENCY_12         FLASH_ACR_LATENCY_12WS  /*!< FLASH Twelve wait cycles   */
227 #define FLASH_LATENCY_13         FLASH_ACR_LATENCY_13WS  /*!< FLASH Thirteen wait cycles */
228 #define FLASH_LATENCY_14         FLASH_ACR_LATENCY_14WS  /*!< FLASH Fourteen wait cycles */
229 #define FLASH_LATENCY_15         FLASH_ACR_LATENCY_15WS  /*!< FLASH Fifteen wait cycles  */
230 /**
231   * @}
232   */
233 
234 /** @defgroup FLASH_Keys FLASH Keys
235   * @{
236   */
237 #define FLASH_KEY1                 0x45670123U
238 #define FLASH_KEY2                 0xCDEF89ABU
239 #define FLASH_OPT_KEY1             0x08192A3BU
240 #define FLASH_OPT_KEY2             0x4C5D6E7FU
241 #if defined (FLASH_SR_OBKERR)
242 #define FLASH_OBK_KEY1             0x192A083BU
243 #define FLASH_OBK_KEY2             0x6E7F4C5DU
244 #endif /* FLASH_SR_OBKERR */
245 /**
246   * @}
247   */
248 
249 /** @defgroup FLASH_Sectors FLASH Sectors
250   * @{
251   */
252 #define FLASH_SECTOR_0             0U       /*!< Sector Number 0   */
253 #define FLASH_SECTOR_1             1U       /*!< Sector Number 1   */
254 #define FLASH_SECTOR_2             2U       /*!< Sector Number 2   */
255 #define FLASH_SECTOR_3             3U       /*!< Sector Number 3   */
256 #define FLASH_SECTOR_4             4U       /*!< Sector Number 4   */
257 #define FLASH_SECTOR_5             5U       /*!< Sector Number 5   */
258 #define FLASH_SECTOR_6             6U       /*!< Sector Number 6   */
259 #define FLASH_SECTOR_7             7U       /*!< Sector Number 7   */
260 #if (FLASH_SECTOR_NB >= 32)
261 #define FLASH_SECTOR_8             8U       /*!< Sector Number 8   */
262 #define FLASH_SECTOR_9             9U       /*!< Sector Number 9   */
263 #define FLASH_SECTOR_10            10U      /*!< Sector Number 10  */
264 #define FLASH_SECTOR_11            11U      /*!< Sector Number 11  */
265 #define FLASH_SECTOR_12            12U      /*!< Sector Number 12  */
266 #define FLASH_SECTOR_13            13U      /*!< Sector Number 13  */
267 #define FLASH_SECTOR_14            14U      /*!< Sector Number 14  */
268 #define FLASH_SECTOR_15            15U      /*!< Sector Number 15  */
269 #define FLASH_SECTOR_16            16U      /*!< Sector Number 16  */
270 #define FLASH_SECTOR_17            17U      /*!< Sector Number 17  */
271 #define FLASH_SECTOR_18            18U      /*!< Sector Number 18  */
272 #define FLASH_SECTOR_19            19U      /*!< Sector Number 19  */
273 #define FLASH_SECTOR_20            20U      /*!< Sector Number 20  */
274 #define FLASH_SECTOR_21            21U      /*!< Sector Number 21  */
275 #define FLASH_SECTOR_22            22U      /*!< Sector Number 22  */
276 #define FLASH_SECTOR_23            23U      /*!< Sector Number 23  */
277 #define FLASH_SECTOR_24            24U      /*!< Sector Number 24  */
278 #define FLASH_SECTOR_25            25U      /*!< Sector Number 25  */
279 #define FLASH_SECTOR_26            26U      /*!< Sector Number 26  */
280 #define FLASH_SECTOR_27            27U      /*!< Sector Number 27  */
281 #define FLASH_SECTOR_28            28U      /*!< Sector Number 28  */
282 #define FLASH_SECTOR_29            29U      /*!< Sector Number 29  */
283 #define FLASH_SECTOR_30            30U      /*!< Sector Number 30  */
284 #define FLASH_SECTOR_31            31U      /*!< Sector Number 31  */
285 #endif /* (FLASH_SECTOR_NB >= 32) */
286 #if (FLASH_SECTOR_NB >= 128)
287 #define FLASH_SECTOR_32            32U      /*!< Sector Number 32  */
288 #define FLASH_SECTOR_33            33U      /*!< Sector Number 33  */
289 #define FLASH_SECTOR_34            34U      /*!< Sector Number 34  */
290 #define FLASH_SECTOR_35            35U      /*!< Sector Number 35  */
291 #define FLASH_SECTOR_36            36U      /*!< Sector Number 36  */
292 #define FLASH_SECTOR_37            37U      /*!< Sector Number 37  */
293 #define FLASH_SECTOR_38            38U      /*!< Sector Number 38  */
294 #define FLASH_SECTOR_39            39U      /*!< Sector Number 39  */
295 #define FLASH_SECTOR_40            40U      /*!< Sector Number 40  */
296 #define FLASH_SECTOR_41            41U      /*!< Sector Number 41  */
297 #define FLASH_SECTOR_42            42U      /*!< Sector Number 42  */
298 #define FLASH_SECTOR_43            43U      /*!< Sector Number 43  */
299 #define FLASH_SECTOR_44            44U      /*!< Sector Number 44  */
300 #define FLASH_SECTOR_45            45U      /*!< Sector Number 45  */
301 #define FLASH_SECTOR_46            46U      /*!< Sector Number 46  */
302 #define FLASH_SECTOR_47            47U      /*!< Sector Number 47  */
303 #define FLASH_SECTOR_48            48U      /*!< Sector Number 48  */
304 #define FLASH_SECTOR_49            49U      /*!< Sector Number 49  */
305 #define FLASH_SECTOR_50            50U      /*!< Sector Number 50  */
306 #define FLASH_SECTOR_51            51U      /*!< Sector Number 51  */
307 #define FLASH_SECTOR_52            52U      /*!< Sector Number 52  */
308 #define FLASH_SECTOR_53            53U      /*!< Sector Number 53  */
309 #define FLASH_SECTOR_54            54U      /*!< Sector Number 54  */
310 #define FLASH_SECTOR_55            55U      /*!< Sector Number 55  */
311 #define FLASH_SECTOR_56            56U      /*!< Sector Number 56  */
312 #define FLASH_SECTOR_57            57U      /*!< Sector Number 57  */
313 #define FLASH_SECTOR_58            58U      /*!< Sector Number 58  */
314 #define FLASH_SECTOR_59            59U      /*!< Sector Number 59  */
315 #define FLASH_SECTOR_60            60U      /*!< Sector Number 60  */
316 #define FLASH_SECTOR_61            61U      /*!< Sector Number 61  */
317 #define FLASH_SECTOR_62            62U      /*!< Sector Number 62  */
318 #define FLASH_SECTOR_63            63U      /*!< Sector Number 63  */
319 #define FLASH_SECTOR_64            64U      /*!< Sector Number 64  */
320 #define FLASH_SECTOR_65            65U      /*!< Sector Number 65  */
321 #define FLASH_SECTOR_66            66U      /*!< Sector Number 66  */
322 #define FLASH_SECTOR_67            67U      /*!< Sector Number 67  */
323 #define FLASH_SECTOR_68            68U      /*!< Sector Number 68  */
324 #define FLASH_SECTOR_69            69U      /*!< Sector Number 69  */
325 #define FLASH_SECTOR_70            70U      /*!< Sector Number 70  */
326 #define FLASH_SECTOR_71            71U      /*!< Sector Number 71  */
327 #define FLASH_SECTOR_72            72U      /*!< Sector Number 72  */
328 #define FLASH_SECTOR_73            73U      /*!< Sector Number 73  */
329 #define FLASH_SECTOR_74            74U      /*!< Sector Number 74  */
330 #define FLASH_SECTOR_75            75U      /*!< Sector Number 75  */
331 #define FLASH_SECTOR_76            76U      /*!< Sector Number 76  */
332 #define FLASH_SECTOR_77            77U      /*!< Sector Number 77  */
333 #define FLASH_SECTOR_78            78U      /*!< Sector Number 78  */
334 #define FLASH_SECTOR_79            79U      /*!< Sector Number 79  */
335 #define FLASH_SECTOR_80            80U      /*!< Sector Number 80  */
336 #define FLASH_SECTOR_81            81U      /*!< Sector Number 81  */
337 #define FLASH_SECTOR_82            82U      /*!< Sector Number 82  */
338 #define FLASH_SECTOR_83            83U      /*!< Sector Number 83  */
339 #define FLASH_SECTOR_84            84U      /*!< Sector Number 84  */
340 #define FLASH_SECTOR_85            85U      /*!< Sector Number 85  */
341 #define FLASH_SECTOR_86            86U      /*!< Sector Number 86  */
342 #define FLASH_SECTOR_87            87U      /*!< Sector Number 87  */
343 #define FLASH_SECTOR_88            88U      /*!< Sector Number 88  */
344 #define FLASH_SECTOR_89            89U      /*!< Sector Number 89  */
345 #define FLASH_SECTOR_90            90U      /*!< Sector Number 90  */
346 #define FLASH_SECTOR_91            91U      /*!< Sector Number 91  */
347 #define FLASH_SECTOR_92            92U      /*!< Sector Number 92  */
348 #define FLASH_SECTOR_93            93U      /*!< Sector Number 93  */
349 #define FLASH_SECTOR_94            94U      /*!< Sector Number 94  */
350 #define FLASH_SECTOR_95            95U      /*!< Sector Number 95  */
351 #define FLASH_SECTOR_96            96U      /*!< Sector Number 96  */
352 #define FLASH_SECTOR_97            97U      /*!< Sector Number 97  */
353 #define FLASH_SECTOR_98            98U      /*!< Sector Number 98  */
354 #define FLASH_SECTOR_99            99U      /*!< Sector Number 99  */
355 #define FLASH_SECTOR_100           100U     /*!< Sector Number 100 */
356 #define FLASH_SECTOR_101           101U     /*!< Sector Number 101 */
357 #define FLASH_SECTOR_102           102U     /*!< Sector Number 102 */
358 #define FLASH_SECTOR_103           103U     /*!< Sector Number 103 */
359 #define FLASH_SECTOR_104           104U     /*!< Sector Number 104 */
360 #define FLASH_SECTOR_105           105U     /*!< Sector Number 105 */
361 #define FLASH_SECTOR_106           106U     /*!< Sector Number 106 */
362 #define FLASH_SECTOR_107           107U     /*!< Sector Number 107 */
363 #define FLASH_SECTOR_108           108U     /*!< Sector Number 108 */
364 #define FLASH_SECTOR_109           109U     /*!< Sector Number 109 */
365 #define FLASH_SECTOR_110           110U     /*!< Sector Number 110 */
366 #define FLASH_SECTOR_111           111U     /*!< Sector Number 111 */
367 #define FLASH_SECTOR_112           112U     /*!< Sector Number 112 */
368 #define FLASH_SECTOR_113           113U     /*!< Sector Number 113 */
369 #define FLASH_SECTOR_114           114U     /*!< Sector Number 114 */
370 #define FLASH_SECTOR_115           115U     /*!< Sector Number 115 */
371 #define FLASH_SECTOR_116           116U     /*!< Sector Number 116 */
372 #define FLASH_SECTOR_117           117U     /*!< Sector Number 117 */
373 #define FLASH_SECTOR_118           118U     /*!< Sector Number 118 */
374 #define FLASH_SECTOR_119           119U     /*!< Sector Number 119 */
375 #define FLASH_SECTOR_120           120U     /*!< Sector Number 120 */
376 #define FLASH_SECTOR_121           121U     /*!< Sector Number 121 */
377 #define FLASH_SECTOR_122           122U     /*!< Sector Number 122 */
378 #define FLASH_SECTOR_123           123U     /*!< Sector Number 123 */
379 #define FLASH_SECTOR_124           124U     /*!< Sector Number 124 */
380 #define FLASH_SECTOR_125           125U     /*!< Sector Number 125 */
381 #define FLASH_SECTOR_126           126U     /*!< Sector Number 126 */
382 #define FLASH_SECTOR_127           127U     /*!< Sector Number 127 */
383 #endif /* (FLASH_SECTOR_NB >= 128) */
384 /**
385   * @}
386   */
387 
388 /**
389   * @}
390   */
391 
392 /* Exported macros ------------------------------------------------------------*/
393 /** @defgroup FLASH_Exported_Macros FLASH Exported Macros
394   * @{
395   */
396 /**
397   * @brief  Set the FLASH Latency.
398   * @param  __LATENCY__: FLASH Latency
399   *         This parameter can be one of the following values :
400   *     @arg FLASH_LATENCY_0: FLASH Zero wait state
401   *     @arg FLASH_LATENCY_1: FLASH One wait state
402   *     @arg FLASH_LATENCY_2: FLASH Two wait states
403   *     @arg FLASH_LATENCY_3: FLASH Three wait states
404   *     @arg FLASH_LATENCY_4: FLASH Four wait states
405   *     @arg FLASH_LATENCY_5: FLASH Five wait states
406   *     @arg FLASH_LATENCY_6: FLASH Six wait states
407   *     @arg FLASH_LATENCY_7: FLASH Seven wait states
408   *     @arg FLASH_LATENCY_8: FLASH Eight wait states
409   *     @arg FLASH_LATENCY_9: FLASH Nine wait states
410   *     @arg FLASH_LATENCY_10: FLASH Ten wait states
411   *     @arg FLASH_LATENCY_11: FLASH Eleven wait states
412   *     @arg FLASH_LATENCY_12: FLASH Twelve wait states
413   *     @arg FLASH_LATENCY_13: FLASH Thirteen wait states
414   *     @arg FLASH_LATENCY_14: FLASH Fourteen wait states
415   *     @arg FLASH_LATENCY_15: FLASH Fifteen wait states
416   * @retval none
417   */
418 #define __HAL_FLASH_SET_LATENCY(__LATENCY__)    MODIFY_REG(FLASH->ACR, FLASH_ACR_LATENCY, (__LATENCY__))
419 
420 /**
421   * @brief  Get the FLASH Latency.
422   * @retval FLASH Latency
423   *         This return value can be one of the following values :
424   *     @arg FLASH_LATENCY_0: FLASH Zero wait state
425   *     @arg FLASH_LATENCY_1: FLASH One wait state
426   *     @arg FLASH_LATENCY_2: FLASH Two wait states
427   *     @arg FLASH_LATENCY_3: FLASH Three wait states
428   *     @arg FLASH_LATENCY_4: FLASH Four wait states
429   *     @arg FLASH_LATENCY_5: FLASH Five wait states
430   *     @arg FLASH_LATENCY_6: FLASH Six wait states
431   *     @arg FLASH_LATENCY_7: FLASH Seven wait states
432   *     @arg FLASH_LATENCY_8: FLASH Eight wait states
433   *     @arg FLASH_LATENCY_9: FLASH Nine wait states
434   *     @arg FLASH_LATENCY_10: FLASH Ten wait states
435   *     @arg FLASH_LATENCY_11: FLASH Eleven wait states
436   *     @arg FLASH_LATENCY_12: FLASH Twelve wait states
437   *     @arg FLASH_LATENCY_13: FLASH Thirteen wait states
438   *     @arg FLASH_LATENCY_14: FLASH Fourteen wait states
439   *     @arg FLASH_LATENCY_15: FLASH Fifteen wait states
440   */
441 #define __HAL_FLASH_GET_LATENCY()               READ_BIT((FLASH->ACR), FLASH_ACR_LATENCY)
442 
443 /**
444   * @brief  Enable the specified FLASH interrupt.
445   * @param  __INTERRUPT__ : FLASH interrupt
446   *   This parameter can be any combination of the following values:
447   *     @arg FLASH_IT_EOP       : End of FLASH Operation Interrupt
448   *     @arg FLASH_IT_WRPERR    : Write Protection Error Interrupt
449   *     @arg FLASH_IT_PGSERR    : Program Sequence Error Interrupt
450   *     @arg FLASH_IT_STRBERR   : Strobe Error Interrupt
451   *     @arg FLASH_IT_INCERR    : Inconsistency Error Interrupt
452   *     @arg FLASH_IT_OBKERR    : OBK Error Interrupt
453   *     @arg FLASH_IT_OBKWERR   : OBK Write Error Interrupt
454   *     @arg FLASH_IT_OPTCHANGEERR : Option Byte Change Error Interrupt
455   *     @arg FLASH_IT_ECCC      : Single ECC Error Correction Interrupt
456   * @retval none
457   */
458 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
459 /* Enable secure FLASH interrupts from the secure world */
460 #define __HAL_FLASH_ENABLE_IT(__INTERRUPT__) do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U)                          \
461                                                     { SET_BIT(FLASH->ECCCORR, FLASH_IT_ECCC); }                        \
462                                                   if(((__INTERRUPT__) & FLASH_IT_OPTCHANGEERR) != 0U)                  \
463                                                     { SET_BIT(FLASH->NSCR, FLASH_IT_OPTCHANGEERR); }                   \
464                                                   if(((__INTERRUPT__) & (~FLASH_IT_ECCC)) != 0U)                       \
465                                                     { SET_BIT(FLASH->SECCR, ((__INTERRUPT__) & (~(FLASH_IT_ECCC |      \
466                                                       FLASH_IT_OPTCHANGEERR)))); }\
467                                                 } while(0)
468 /* Enable non-secure FLASH interrupts from the secure world */
469 #define __HAL_FLASH_ENABLE_IT_NS(__INTERRUPT__) do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U)                       \
470                                                        { SET_BIT(FLASH->ECCCORR, FLASH_IT_ECCC); }                     \
471                                                      if(((__INTERRUPT__) & (~FLASH_IT_ECCC)) != 0U)                    \
472                                                        { SET_BIT(FLASH->NSCR, ((__INTERRUPT__) & (~FLASH_IT_ECCC))); } \
473                                                    } while(0)
474 #else
475 /* Enable non-secure FLASH interrupts from the non-secure world */
476 #define __HAL_FLASH_ENABLE_IT(__INTERRUPT__)    do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U)                       \
477                                                        { SET_BIT(FLASH->ECCCORR, FLASH_IT_ECCC); }                     \
478                                                      if(((__INTERRUPT__) & (~FLASH_IT_ECCC)) != 0U)                    \
479                                                        { SET_BIT(FLASH->NSCR, ((__INTERRUPT__) & (~FLASH_IT_ECCC))); } \
480                                                    } while(0)
481 #endif /* __ARM_FEATURE_CMSE */
482 
483 /**
484   * @brief  Disable the specified FLASH interrupt.
485   * @param  __INTERRUPT__ : FLASH interrupt
486   *   This parameter can be any combination of the following values:
487   *     @arg FLASH_IT_EOP       : End of FLASH Operation Interrupt
488   *     @arg FLASH_IT_WRPERR    : Write Protection Error Interrupt
489   *     @arg FLASH_IT_PGSERR    : Program Sequence Error Interrupt
490   *     @arg FLASH_IT_STRBERR   : Strobe Error Interrupt
491   *     @arg FLASH_IT_INCERR    : Inconsistency Error Interrupt
492   *     @arg FLASH_IT_OBKERR    : OBK Error Interrupt
493   *     @arg FLASH_IT_OBKWERR   : OBK Write Error Interrupt
494   *     @arg FLASH_IT_OPTCHANGEERR : Option Byte Change Error Interrupt
495   *     @arg FLASH_IT_ECCC      : Single ECC Error Correction Interrupt
496   * @retval none
497   */
498 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
499 /* Disable secure FLASH interrupts from the secure world */
500 #define __HAL_FLASH_DISABLE_IT(__INTERRUPT__) do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U)                         \
501                                                      { CLEAR_BIT(FLASH->ECCCORR, FLASH_IT_ECCC); }                     \
502                                                    if(((__INTERRUPT__) & FLASH_IT_OPTCHANGEERR) != 0U)                 \
503                                                      { CLEAR_BIT(FLASH->NSCR, FLASH_IT_OPTCHANGEERR); }                \
504                                                    if(((__INTERRUPT__) & (~(FLASH_IT_ECCC | FLASH_IT_OPTCHANGEERR)))   \
505                                                      != 0U){ CLEAR_BIT(FLASH->SECCR, ((__INTERRUPT__) &                \
506                                                      (~(FLASH_IT_ECCC | FLASH_IT_OPTCHANGEERR)))); }\
507                                                  } while(0)
508 /* Disable non-secure FLASH interrupts from the secure world */
509 #define __HAL_FLASH_DISABLE_IT_NS(__INTERRUPT__) do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U) { CLEAR_BIT          \
510                                                         (FLASH->ECCCORR, FLASH_IT_ECCC); }                             \
511                                                       if(((__INTERRUPT__) & (~FLASH_IT_ECCC)) != 0U)                   \
512                                                         { CLEAR_BIT(FLASH->NSCR, ((__INTERRUPT__) & (~FLASH_IT_ECCC)));\
513                                                         }                                                              \
514                                                     } while(0)
515 #else
516 /* Disable non-secure FLASH interrupts from the non-secure world */
517 #define __HAL_FLASH_DISABLE_IT(__INTERRUPT__)   do { if(((__INTERRUPT__) & FLASH_IT_ECCC) != 0U) { CLEAR_BIT           \
518                                                        (FLASH->ECCCORR, FLASH_IT_ECCC); }                              \
519                                                      if(((__INTERRUPT__) & (~FLASH_IT_ECCC)) != 0U) { CLEAR_BIT        \
520                                                        (FLASH->NSCR, ((__INTERRUPT__) & (~FLASH_IT_ECCC))); }          \
521                                                     } while(0)
522 #endif /* __ARM_FEATURE_CMSE */
523 
524 /**
525   * @brief  Checks whether the specified FLASH flag is set or not.
526   * @param  __FLAG__: specifies the FLASH flag to check.
527   *   This parameter can be one of the following values :
528   *     @arg FLASH_FLAG_BSY      : FLASH Busy flag
529   *     @arg FLASH_FLAG_WBNE     : Write Buffer Not Empty flag
530   *     @arg FLASH_FLAG_EOP      : End Of Operation flag
531   *     @arg FLASH_FLAG_WRPERR   : Write Protection Error flag
532   *     @arg FLASH_FLAG_PGSERR   : Program Sequence Error flag
533   *     @arg FLASH_FLAG_STRBERR  : Strobe Error flag
534   *     @arg FLASH_FLAG_INCERR   : Inconsistency Error flag
535   *     @arg FLASH_FLAG_OBKERR   : OBK Error flag
536   *     @arg FLASH_FLAG_OBKWERR  : OBK Write Error flag
537   *     @arg FLASH_FLAG_OPTCHANGEERR : Option Byte Change Error flag
538   *     @arg FLASH_FLAG_ECCC     : Single ECC Error Correction flag
539   *     @arg FLASH_FLAG_ECCD     : Double Detection ECC Error flag
540   * @retval The new state of FLASH_FLAG (SET or RESET).
541   */
542 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
543 /* Get secure FLASH flags from the secure world */
544 #define __HAL_FLASH_GET_FLAG(__FLAG__)          ((((__FLAG__) & (FLASH_FLAG_ECCC)) != 0U) ?                            \
545                                                  (READ_BIT(FLASH->ECCCORR, (__FLAG__)) == (__FLAG__))  :               \
546                                                  (((__FLAG__) & (FLASH_FLAG_ECCD)) != 0U) ?                            \
547                                                  (READ_BIT(FLASH->ECCDETR, (__FLAG__)) == (__FLAG__))  :               \
548                                                  ((((__FLAG__) & (FLASH_FLAG_OPTCHANGEERR)) != 0U) ?                   \
549                                                   (READ_BIT(FLASH->NSSR, (__FLAG__)) == (__FLAG__)) :                  \
550                                                   (READ_BIT(FLASH->SECSR, (__FLAG__)) == (__FLAG__))))
551 /* Get non-secure FLASH flags from the secure world */
552 #define __HAL_FLASH_GET_FLAG_NS(__FLAG__)       ((((__FLAG__) & (FLASH_FLAG_ECCC)) != 0U) ?                            \
553                                                  (READ_BIT(FLASH->ECCCORR, (__FLAG__)) == (__FLAG__))  :               \
554                                                  (((__FLAG__) & (FLASH_FLAG_ECCD)) != 0U) ?                            \
555                                                  (READ_BIT(FLASH->ECCDETR, (__FLAG__)) == (__FLAG__))  :               \
556                                                  (READ_BIT(FLASH->NSSR, (__FLAG__)) == (__FLAG__))))
557 #else
558 /* Get non-secure FLASH flags from the non-secure world */
559 #define __HAL_FLASH_GET_FLAG(__FLAG__)          ((((__FLAG__) & (FLASH_FLAG_ECCC)) != 0U) ?                            \
560                                                  (READ_BIT(FLASH->ECCCORR, (__FLAG__)) == (__FLAG__))  :               \
561                                                  (((__FLAG__) & (FLASH_FLAG_ECCD)) != 0U) ?                            \
562                                                  (READ_BIT(FLASH->ECCDETR, (__FLAG__)) == (__FLAG__))  :               \
563                                                  (READ_BIT(FLASH->NSSR, (__FLAG__)) == (__FLAG__)))
564 #endif /* __ARM_FEATURE_CMSE */
565 
566 /**
567   * @brief  Clear the specified FLASH flag.
568   * @param  __FLAG__: specifies the FLASH flags to clear.
569   *   This parameter can be one of the following values :
570   *     @arg FLASH_FLAG_BSY       : FLASH Busy flag
571   *     @arg FLASH_FLAG_WBNE      : Write Buffer Not Empty flag
572   *     @arg FLASH_FLAG_EOP       : End Of Operation flag
573   *     @arg FLASH_FLAG_WRPERR    : Write Protection Error flag
574   *     @arg FLASH_FLAG_PGSERR    : Program Sequence Error flag
575   *     @arg FLASH_FLAG_STRBERR   : Strobe Error flag
576   *     @arg FLASH_FLAG_INCERR    : Inconsistency Error flag
577   *     @arg FLASH_FLAG_OBKERR    : OBK Error flag
578   *     @arg FLASH_FLAG_OBKWERR   : OBK Write Error flag
579   *     @arg FLASH_FLAG_OPTCHANGEERR : Option Byte Change Error flag
580   *     @arg FLASH_FLAG_ECCC      : Single ECC Error Correction flag
581   *     @arg FLASH_FLAG_ECCD      : Double Detection ECC Error flag
582   *     @arg FLASH_FLAG_ALL_ERRORS: All errors flags
583   * @retval none
584   */
585 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
586 /* Clear secure FLASH flags from the secure world */
587 #define __HAL_FLASH_CLEAR_FLAG(__FLAG__)        do { if(((__FLAG__) & FLASH_FLAG_ECCC) != 0U) { SET_BIT(FLASH->ECCCORR,\
588                                                         ((__FLAG__) & FLASH_FLAG_ECCC)); }                             \
589                                                      if(((__FLAG__) & FLASH_FLAG_ECCD) != 0U) { SET_BIT(FLASH->ECCDETR,\
590                                                         ((__FLAG__) & FLASH_FLAG_ECCD)); }                             \
591                                                      if(((__FLAG__) & FLASH_FLAG_OPTCHANGEERR) != 0U) { SET_BIT        \
592                                                          (FLASH->NSCCR, ((__FLAG__) & (FLASH_FLAG_OPTCHANGEERR))); }   \
593                                                      if(((__FLAG__) & ~(FLASH_FLAG_ECCR_ERRORS |                       \
594                                                           FLASH_FLAG_OPTCHANGEERR)) != 0U) { WRITE_REG(FLASH->SECCCR,  \
595                                                         ((__FLAG__) & ~(FLASH_FLAG_ECCR_ERRORS |                       \
596                                                           FLASH_FLAG_OPTCHANGEERR))); }                                \
597                                                    } while(0)
598 /* Clear non-secure FLASH flags from the secure world */
599 #define __HAL_FLASH_CLEAR_FLAG_NS(__FLAG__)     do { if(((__FLAG__) & FLASH_FLAG_ECCC) != 0U) { SET_BIT(FLASH->ECCCORR,\
600                                                         ((__FLAG__) & FLASH_FLAG_ECCC)); }                             \
601                                                      if(((__FLAG__) & FLASH_FLAG_ECCD) != 0U) { SET_BIT(FLASH->ECCDETR,\
602                                                         ((__FLAG__) & FLASH_FLAG_ECCD)); }                             \
603                                                      if(((__FLAG__) & (~FLASH_FLAG_ECCR_ERRORS)) != 0U) { WRITE_REG    \
604                                                          (FLASH->NSCCR, ((__FLAG__) & (~FLASH_FLAG_ECCR_ERRORS))); }   \
605                                                    } while(0)
606 #else
607 /* Clear non-secure FLASH flags from the non-secure world */
608 #define __HAL_FLASH_CLEAR_FLAG(__FLAG__)        do { if(((__FLAG__) & FLASH_FLAG_ECCC) != 0U) { SET_BIT(FLASH->ECCCORR,\
609                                                         ((__FLAG__) & FLASH_FLAG_ECCC)); }                             \
610                                                      if(((__FLAG__) & FLASH_FLAG_ECCD) != 0U) { SET_BIT(FLASH->ECCDETR,\
611                                                         ((__FLAG__) & FLASH_FLAG_ECCD)); }                             \
612                                                      if(((__FLAG__) & (~FLASH_FLAG_ECCR_ERRORS)) != 0U) { WRITE_REG    \
613                                                          (FLASH->NSCCR, ((__FLAG__) & (~FLASH_FLAG_ECCR_ERRORS))); }   \
614                                                    } while(0)
615 #endif /* __ARM_FEATURE_CMSE */
616 
617 /**
618   * @}
619   */
620 
621 /* Include FLASH HAL Extension module */
622 #include "stm32h5xx_hal_flash_ex.h"
623 
624 /* Exported functions --------------------------------------------------------*/
625 /** @addtogroup FLASH_Exported_Functions
626   * @{
627   */
628 /** @addtogroup FLASH_Exported_Functions_Group1
629   * @{
630   */
631 /* Program operation functions */
632 HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t FlashAddress, uint32_t DataAddress);
633 HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t FlashAddress, uint32_t DataAddress);
634 /* FLASH IRQ handler method */
635 void HAL_FLASH_IRQHandler(void);
636 /* Callbacks in non blocking modes */
637 void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue);
638 void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue);
639 /**
640   * @}
641   */
642 
643 /** @addtogroup FLASH_Exported_Functions_Group2
644   * @{
645   */
646 /* Peripheral Control functions */
647 HAL_StatusTypeDef HAL_FLASH_Unlock(void);
648 HAL_StatusTypeDef HAL_FLASH_Lock(void);
649 HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void);
650 HAL_StatusTypeDef HAL_FLASH_OB_Lock(void);
651 /* Option bytes control */
652 HAL_StatusTypeDef HAL_FLASH_OB_Launch(void);
653 /**
654   * @}
655   */
656 
657 /** @addtogroup FLASH_Exported_Functions_Group3
658   * @{
659   */
660 /* Peripheral State functions */
661 uint32_t HAL_FLASH_GetError(void);
662 /**
663   * @}
664   */
665 
666 /**
667   * @}
668   */
669 /* Private types -------------------------------------------------------------*/
670 /* Private variables ---------------------------------------------------------*/
671 /** @defgroup FLASH_Private_Variables FLASH Private Variables
672   * @{
673   */
674 extern FLASH_ProcessTypeDef pFlash;
675 /**
676   * @}
677   */
678 /* Private constants ---------------------------------------------------------*/
679 /** @defgroup FLASH_Private_Constants FLASH Private Constants
680   * @{
681   */
682 #define FLASH_TIMEOUT_VALUE             1000U   /*!< 1 s */
683 
684 #if defined (FLASH_SR_OBKERR)
685 #define FLASH_OBK                       0x10000000U
686 #endif /* FLASH_SR_OBKERR */
687 
688 #define FLASH_OTP                       0x20000000U
689 
690 #if defined (FLASH_EDATAR_EDATA_EN)
691 #define FLASH_EDATA_HALFWORD            0x40000000U
692 #define FLASH_EDATA_WORD                0x60000000U
693 #endif /* FLASH_EDATAR_EDATA_EN */
694 
695 #define FLASH_NON_SECURE_MASK           0x80000000U
696 
697 #define FLASH_EDATA_SECTOR_NB           8U       /*!< Maximum number of FLASH high-cycle data sectors */
698 /**
699   * @}
700   */
701 
702 /* Private macros ------------------------------------------------------------*/
703 /** @defgroup FLASH_Private_Macros FLASH Private Macros
704   * @{
705   */
706 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
707 #if defined (FLASH_SR_OBKERR) && defined (FLASH_EDATAR_EDATA_EN)
708 #define IS_FLASH_TYPEPROGRAM(VALUE)      (((VALUE) == FLASH_TYPEPROGRAM_QUADWORD)                                   || \
709                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_NS)                                || \
710                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_OTP)                               || \
711                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_EDATA)                             || \
712                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_EDATA_NS)                          || \
713                                           ((VALUE) == FLASH_TYPEPROGRAM_WORD_EDATA)                                 || \
714                                           ((VALUE) == FLASH_TYPEPROGRAM_WORD_EDATA_NS)                              || \
715                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_OBK)                               || \
716                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_OBK_ALT))
717 #else
718 #define IS_FLASH_TYPEPROGRAM(VALUE)      (((VALUE) == FLASH_TYPEPROGRAM_QUADWORD)                                   || \
719                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_NS)                                || \
720                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_OTP))
721 #endif /* FLASH_SR_OBKERR && FLASH_EDATAR_EDATA_EN */
722 #else
723 #if defined (FLASH_SR_OBKERR) && defined (FLASH_EDATAR_EDATA_EN)
724 #define IS_FLASH_TYPEPROGRAM(VALUE)      (((VALUE) == FLASH_TYPEPROGRAM_QUADWORD)                                   || \
725                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_OTP)                               || \
726                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_EDATA)                             || \
727                                           ((VALUE) == FLASH_TYPEPROGRAM_WORD_EDATA)                                 || \
728                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_OBK)                               || \
729                                           ((VALUE) == FLASH_TYPEPROGRAM_QUADWORD_OBK_ALT))
730 #else
731 #define IS_FLASH_TYPEPROGRAM(VALUE)      (((VALUE) == FLASH_TYPEPROGRAM_QUADWORD)                                   || \
732                                           ((VALUE) == FLASH_TYPEPROGRAM_HALFWORD_OTP))
733 #endif /* FLASH_SR_OBKERR && FLASH_EDATAR_EDATA_EN */
734 #endif /* __ARM_FEATURE_CMSE */
735 
736 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
737 #define IS_FLASH_USER_MEM_ADDRESS(ADDRESS) ((((ADDRESS) >= FLASH_BASE) && ((ADDRESS) < (FLASH_BASE+FLASH_SIZE)))    || \
738                                             (((ADDRESS) >= FLASH_BASE_NS) && ((ADDRESS) < (FLASH_BASE_NS+FLASH_SIZE))))
739 #if defined (FLASH_SR_OBKERR)
740 #define IS_FLASH_OBK_ADDRESS(ADDRESS)      ((((ADDRESS) >= FLASH_OBK_BASE)                                          && \
741                                              ((ADDRESS)  < (FLASH_OBK_BASE+FLASH_OBK_SIZE)))                        || \
742                                             (((ADDRESS) >= FLASH_OBK_BASE_NS)                                       && \
743                                              ((ADDRESS)  < (FLASH_OBK_BASE_NS+FLASH_OBK_SIZE))))
744 #endif /* FLASH_SR_OBKERR */
745 #if defined (FLASH_EDATAR_EDATA_EN)
746 #define IS_FLASH_EDATA_ADDRESS(ADDRESS)    ((((ADDRESS) >= FLASH_EDATA_BASE_S)                                      && \
747                                              ((ADDRESS)  < (FLASH_EDATA_BASE_S+FLASH_EDATA_SIZE)))                  || \
748                                             (((ADDRESS) >= FLASH_EDATA_BASE_NS)                                     && \
749                                              ((ADDRESS)  < (FLASH_EDATA_BASE_NS+FLASH_EDATA_SIZE))))
750 #endif /* FLASH_EDATAR_EDATA_EN */
751 #else
752 #define IS_FLASH_USER_MEM_ADDRESS(ADDRESS) (((ADDRESS) >= FLASH_BASE)                                               && \
753                                             ((ADDRESS) < (FLASH_BASE+FLASH_SIZE)))
754 #if defined (FLASH_SR_OBKERR)
755 #define IS_FLASH_OBK_ADDRESS(ADDRESS)      (((ADDRESS) >= FLASH_OBK_BASE)                                           && \
756                                             ((ADDRESS) < (FLASH_OBK_BASE + FLASH_OBK_SIZE)))
757 #endif /* FLASH_SR_OBKERR */
758 #if defined (FLASH_EDATAR_EDATA_EN)
759 #define IS_FLASH_EDATA_ADDRESS(ADDRESS)    (((ADDRESS) >= FLASH_EDATA_BASE_NS)                                      && \
760                                             ((ADDRESS) < (FLASH_EDATA_BASE_NS + FLASH_EDATA_SIZE)))
761 #endif /* FLASH_EDATAR_EDATA_EN */
762 #endif /* __ARM_FEATURE_CMSE */
763 
764 #define IS_FLASH_OTP_ADDRESS(ADDRESS)      (((ADDRESS) >= FLASH_OTP_BASE)                                           && \
765                                             ((ADDRESS) < (FLASH_OTP_BASE + FLASH_OTP_SIZE)))
766 
767 #define IS_FLASH_BANK(BANK)              (((BANK) == FLASH_BANK_1)                                                  || \
768                                           ((BANK) == FLASH_BANK_2)                                                  || \
769                                           ((BANK) == FLASH_BANK_BOTH))
770 
771 #define IS_FLASH_BANK_EXCLUSIVE(BANK)    (((BANK) == FLASH_BANK_1)                                                  || \
772                                           ((BANK) == FLASH_BANK_2))
773 
774 #define IS_FLASH_SECTOR(SECTOR)          ((SECTOR) < FLASH_SECTOR_NB)
775 
776 #define IS_FLASH_LATENCY(LATENCY)        (((LATENCY) == FLASH_LATENCY_0)                                            || \
777                                           ((LATENCY) == FLASH_LATENCY_1)                                            || \
778                                           ((LATENCY) == FLASH_LATENCY_2)                                            || \
779                                           ((LATENCY) == FLASH_LATENCY_3)                                            || \
780                                           ((LATENCY) == FLASH_LATENCY_4)                                            || \
781                                           ((LATENCY) == FLASH_LATENCY_5)                                            || \
782                                           ((LATENCY) == FLASH_LATENCY_6)                                            || \
783                                           ((LATENCY) == FLASH_LATENCY_7)                                            || \
784                                           ((LATENCY) == FLASH_LATENCY_8)                                            || \
785                                           ((LATENCY) == FLASH_LATENCY_9)                                            || \
786                                           ((LATENCY) == FLASH_LATENCY_10)                                           || \
787                                           ((LATENCY) == FLASH_LATENCY_11)                                           || \
788                                           ((LATENCY) == FLASH_LATENCY_12)                                           || \
789                                           ((LATENCY) == FLASH_LATENCY_13)                                           || \
790                                           ((LATENCY) == FLASH_LATENCY_14)                                           || \
791                                           ((LATENCY) == FLASH_LATENCY_15))
792 
793 #if defined (__ARM_FEATURE_CMSE) && (__ARM_FEATURE_CMSE == 3U)
794 #define IS_FLASH_SECURE_OPERATION()        ((pFlash.ProcedureOnGoing & FLASH_NON_SECURE_MASK) == 0U)
795 #else
796 #define IS_FLASH_SECURE_OPERATION()        (1U == 0U)
797 #endif /* __ARM_FEATURE_CMSE */
798 /**
799   * @}
800   */
801 /* Private functions ---------------------------------------------------------*/
802 /** @defgroup FLASH_Private_Functions FLASH Private Functions
803   * @{
804   */
805 HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout);
806 /**
807   * @}
808   */
809 
810 /**
811   * @}
812   */
813 
814 /**
815   * @}
816   */
817 
818 #ifdef __cplusplus
819 }
820 #endif
821 
822 #endif /* STM32H5xx_HAL_FLASH_H */
823