stm32h7xx_hal_flash.h 50 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861
  1. /**
  2. ******************************************************************************
  3. * @file stm32h7xx_hal_flash.h
  4. * @author MCD Application Team
  5. * @brief Header file of FLASH HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2017 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file in
  13. * the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. ******************************************************************************
  16. */
  17. /* Define to prevent recursive inclusion -------------------------------------*/
  18. #ifndef STM32H7xx_HAL_FLASH_H
  19. #define STM32H7xx_HAL_FLASH_H
  20. #ifdef __cplusplus
  21. extern "C" {
  22. #endif
  23. /* Includes ------------------------------------------------------------------*/
  24. #include "stm32h7xx_hal_def.h"
  25. /** @addtogroup STM32H7xx_HAL_Driver
  26. * @{
  27. */
  28. /** @addtogroup FLASH
  29. * @{
  30. */
  31. /* Exported types ------------------------------------------------------------*/
  32. /** @defgroup FLASH_Exported_Types FLASH Exported Types
  33. * @{
  34. */
  35. /**
  36. * @brief FLASH Procedure structure definition
  37. */
  38. typedef enum
  39. {
  40. FLASH_PROC_NONE = 0U,
  41. FLASH_PROC_SECTERASE_BANK1,
  42. FLASH_PROC_MASSERASE_BANK1,
  43. FLASH_PROC_PROGRAM_BANK1,
  44. FLASH_PROC_SECTERASE_BANK2,
  45. FLASH_PROC_MASSERASE_BANK2,
  46. FLASH_PROC_PROGRAM_BANK2,
  47. FLASH_PROC_ALLBANK_MASSERASE
  48. } FLASH_ProcedureTypeDef;
  49. /**
  50. * @brief FLASH handle Structure definition
  51. */
  52. typedef struct
  53. {
  54. __IO FLASH_ProcedureTypeDef ProcedureOnGoing; /*!< Internal variable to indicate which procedure is ongoing or not in IT context */
  55. __IO uint32_t NbSectorsToErase; /*!< Internal variable to save the remaining sectors to erase in IT context */
  56. __IO uint32_t VoltageForErase; /*!< Internal variable to provide voltage range selected by user in IT context */
  57. __IO uint32_t Sector; /*!< Internal variable to define the current sector which is erasing */
  58. __IO uint32_t Address; /*!< Internal variable to save address selected for program */
  59. HAL_LockTypeDef Lock; /*!< FLASH locking object */
  60. __IO uint32_t ErrorCode; /*!< FLASH error code */
  61. }FLASH_ProcessTypeDef;
  62. /**
  63. * @}
  64. */
  65. /* Exported constants --------------------------------------------------------*/
  66. /** @defgroup FLASH_Exported_Constants FLASH Exported Constants
  67. * @{
  68. */
  69. /** @defgroup FLASH_Error_Code FLASH Error Code
  70. * @brief FLASH Error Code
  71. * @{
  72. */
  73. #define HAL_FLASH_ERROR_NONE 0x00000000U /*!< No error */
  74. #define HAL_FLASH_ERROR_WRP FLASH_FLAG_WRPERR /*!< Write Protection Error */
  75. #define HAL_FLASH_ERROR_PGS FLASH_FLAG_PGSERR /*!< Program Sequence Error */
  76. #define HAL_FLASH_ERROR_STRB FLASH_FLAG_STRBERR /*!< Strobe Error */
  77. #define HAL_FLASH_ERROR_INC FLASH_FLAG_INCERR /*!< Inconsistency Error */
  78. #if defined (FLASH_SR_OPERR)
  79. #define HAL_FLASH_ERROR_OPE FLASH_FLAG_OPERR /*!< Operation Error */
  80. #endif /* FLASH_SR_OPERR */
  81. #define HAL_FLASH_ERROR_RDP FLASH_FLAG_RDPERR /*!< Read Protection Error */
  82. #define HAL_FLASH_ERROR_RDS FLASH_FLAG_RDSERR /*!< Read Secured Error */
  83. #define HAL_FLASH_ERROR_SNECC FLASH_FLAG_SNECCERR /*!< ECC Single Correction Error */
  84. #define HAL_FLASH_ERROR_DBECC FLASH_FLAG_DBECCERR /*!< ECC Double Detection Error */
  85. #define HAL_FLASH_ERROR_CRCRD FLASH_FLAG_CRCRDERR /*!< CRC Read Error */
  86. #define HAL_FLASH_ERROR_WRP_BANK1 FLASH_FLAG_WRPERR_BANK1 /*!< Write Protection Error on Bank 1 */
  87. #define HAL_FLASH_ERROR_PGS_BANK1 FLASH_FLAG_PGSERR_BANK1 /*!< Program Sequence Error on Bank 1 */
  88. #define HAL_FLASH_ERROR_STRB_BANK1 FLASH_FLAG_STRBERR_BANK1 /*!< Strobe Error on Bank 1 */
  89. #define HAL_FLASH_ERROR_INC_BANK1 FLASH_FLAG_INCERR_BANK1 /*!< Inconsistency Error on Bank 1 */
  90. #if defined (FLASH_SR_OPERR)
  91. #define HAL_FLASH_ERROR_OPE_BANK1 FLASH_FLAG_OPERR_BANK1 /*!< Operation Error on Bank 1 */
  92. #endif /* FLASH_SR_OPERR */
  93. #define HAL_FLASH_ERROR_RDP_BANK1 FLASH_FLAG_RDPERR_BANK1 /*!< Read Protection Error on Bank 1 */
  94. #define HAL_FLASH_ERROR_RDS_BANK1 FLASH_FLAG_RDSERR_BANK1 /*!< Read Secured Error on Bank 1 */
  95. #define HAL_FLASH_ERROR_SNECC_BANK1 FLASH_FLAG_SNECCERR_BANK1 /*!< ECC Single Correction Error on Bank 1 */
  96. #define HAL_FLASH_ERROR_DBECC_BANK1 FLASH_FLAG_DBECCERR_BANK1 /*!< ECC Double Detection Error on Bank 1 */
  97. #define HAL_FLASH_ERROR_CRCRD_BANK1 FLASH_FLAG_CRCRDERR_BANK1 /*!< CRC Read Error on Bank1 */
  98. #define HAL_FLASH_ERROR_WRP_BANK2 FLASH_FLAG_WRPERR_BANK2 /*!< Write Protection Error on Bank 2 */
  99. #define HAL_FLASH_ERROR_PGS_BANK2 FLASH_FLAG_PGSERR_BANK2 /*!< Program Sequence Error on Bank 2 */
  100. #define HAL_FLASH_ERROR_STRB_BANK2 FLASH_FLAG_STRBERR_BANK2 /*!< Strobe Error on Bank 2 */
  101. #define HAL_FLASH_ERROR_INC_BANK2 FLASH_FLAG_INCERR_BANK2 /*!< Inconsistency Error on Bank 2 */
  102. #if defined (FLASH_SR_OPERR)
  103. #define HAL_FLASH_ERROR_OPE_BANK2 FLASH_FLAG_OPERR_BANK2 /*!< Operation Error on Bank 2 */
  104. #endif /* FLASH_SR_OPERR */
  105. #define HAL_FLASH_ERROR_RDP_BANK2 FLASH_FLAG_RDPERR_BANK2 /*!< Read Protection Error on Bank 2 */
  106. #define HAL_FLASH_ERROR_RDS_BANK2 FLASH_FLAG_RDSERR_BANK2 /*!< Read Secured Error on Bank 2 */
  107. #define HAL_FLASH_ERROR_SNECC_BANK2 FLASH_FLAG_SNECCERR_BANK2 /*!< ECC Single Correction Error on Bank 2 */
  108. #define HAL_FLASH_ERROR_DBECC_BANK2 FLASH_FLAG_DBECCERR_BANK2 /*!< ECC Double Detection Error on Bank 2 */
  109. #define HAL_FLASH_ERROR_CRCRD_BANK2 FLASH_FLAG_CRCRDERR_BANK2 /*!< CRC Read Error on Bank2 */
  110. #define HAL_FLASH_ERROR_OB_CHANGE FLASH_OPTSR_OPTCHANGEERR /*!< Option Byte Change Error */
  111. /**
  112. * @}
  113. */
  114. /** @defgroup FLASH_Type_Program FLASH Type Program
  115. * @{
  116. */
  117. #define FLASH_TYPEPROGRAM_FLASHWORD 0x01U /*!< Program a flash word at a specified address */
  118. #if defined (FLASH_OPTCR_PG_OTP)
  119. #define FLASH_TYPEPROGRAM_OTPWORD 0x02U /*!< Program an OTP word at a specified address */
  120. #endif /* FLASH_OPTCR_PG_OTP */
  121. /**
  122. * @}
  123. */
  124. /** @defgroup FLASH_Flag_definition FLASH Flag definition
  125. * @brief Flag definition
  126. * @{
  127. */
  128. #define FLASH_FLAG_BSY FLASH_SR_BSY /*!< FLASH Busy flag */
  129. #define FLASH_FLAG_WBNE FLASH_SR_WBNE /*!< Write Buffer Not Empty flag */
  130. #define FLASH_FLAG_QW FLASH_SR_QW /*!< Wait Queue on flag */
  131. #define FLASH_FLAG_CRC_BUSY FLASH_SR_CRC_BUSY /*!< CRC Busy flag */
  132. #define FLASH_FLAG_EOP FLASH_SR_EOP /*!< End Of Program on flag */
  133. #define FLASH_FLAG_WRPERR FLASH_SR_WRPERR /*!< Write Protection Error on flag */
  134. #define FLASH_FLAG_PGSERR FLASH_SR_PGSERR /*!< Program Sequence Error on flag */
  135. #define FLASH_FLAG_STRBERR FLASH_SR_STRBERR /*!< Strobe Error flag */
  136. #define FLASH_FLAG_INCERR FLASH_SR_INCERR /*!< Inconsistency Error on flag */
  137. #if defined (FLASH_SR_OPERR)
  138. #define FLASH_FLAG_OPERR FLASH_SR_OPERR /*!< Operation Error on flag */
  139. #endif /* FLASH_SR_OPERR */
  140. #define FLASH_FLAG_RDPERR FLASH_SR_RDPERR /*!< Read Protection Error on flag */
  141. #define FLASH_FLAG_RDSERR FLASH_SR_RDSERR /*!< Read Secured Error on flag */
  142. #define FLASH_FLAG_SNECCERR FLASH_SR_SNECCERR /*!< Single ECC Error Correction on flag */
  143. #define FLASH_FLAG_DBECCERR FLASH_SR_DBECCERR /*!< Double Detection ECC Error on flag */
  144. #define FLASH_FLAG_CRCEND FLASH_SR_CRCEND /*!< CRC End of Calculation flag */
  145. #define FLASH_FLAG_CRCRDERR FLASH_SR_CRCRDERR /*!< CRC Read Error on bank flag */
  146. #define FLASH_FLAG_BSY_BANK1 FLASH_SR_BSY /*!< FLASH Bank 1 Busy flag */
  147. #define FLASH_FLAG_WBNE_BANK1 FLASH_SR_WBNE /*!< Write Buffer Not Empty on Bank 1 flag */
  148. #define FLASH_FLAG_QW_BANK1 FLASH_SR_QW /*!< Wait Queue on Bank 1 flag */
  149. #define FLASH_FLAG_CRC_BUSY_BANK1 FLASH_SR_CRC_BUSY /*!< CRC Busy on Bank 1 flag */
  150. #define FLASH_FLAG_EOP_BANK1 FLASH_SR_EOP /*!< End Of Program on Bank 1 flag */
  151. #define FLASH_FLAG_WRPERR_BANK1 FLASH_SR_WRPERR /*!< Write Protection Error on Bank 1 flag */
  152. #define FLASH_FLAG_PGSERR_BANK1 FLASH_SR_PGSERR /*!< Program Sequence Error on Bank 1 flag */
  153. #define FLASH_FLAG_STRBERR_BANK1 FLASH_SR_STRBERR /*!< Strobe Error on Bank 1 flag */
  154. #define FLASH_FLAG_INCERR_BANK1 FLASH_SR_INCERR /*!< Inconsistency Error on Bank 1 flag */
  155. #if defined (FLASH_SR_OPERR)
  156. #define FLASH_FLAG_OPERR_BANK1 FLASH_SR_OPERR /*!< Operation Error on Bank 1 flag */
  157. #endif /* FLASH_SR_OPERR */
  158. #define FLASH_FLAG_RDPERR_BANK1 FLASH_SR_RDPERR /*!< Read Protection Error on Bank 1 flag */
  159. #define FLASH_FLAG_RDSERR_BANK1 FLASH_SR_RDSERR /*!< Read Secured Error on Bank 1 flag */
  160. #define FLASH_FLAG_SNECCERR_BANK1 FLASH_SR_SNECCERR /*!< Single ECC Error Correction on Bank 1 flag */
  161. #define FLASH_FLAG_DBECCERR_BANK1 FLASH_SR_DBECCERR /*!< Double Detection ECC Error on Bank 1 flag */
  162. #define FLASH_FLAG_CRCEND_BANK1 FLASH_SR_CRCEND /*!< CRC End of Calculation on Bank 1 flag */
  163. #define FLASH_FLAG_CRCRDERR_BANK1 FLASH_SR_CRCRDERR /*!< CRC Read error on Bank 1 flag */
  164. #if defined (FLASH_SR_OPERR)
  165. #define FLASH_FLAG_ALL_ERRORS_BANK1 (FLASH_FLAG_WRPERR_BANK1 | FLASH_FLAG_PGSERR_BANK1 | \
  166. FLASH_FLAG_STRBERR_BANK1 | FLASH_FLAG_INCERR_BANK1 | \
  167. FLASH_FLAG_OPERR_BANK1 | FLASH_FLAG_RDPERR_BANK1 | \
  168. FLASH_FLAG_RDSERR_BANK1 | FLASH_FLAG_SNECCERR_BANK1 | \
  169. FLASH_FLAG_DBECCERR_BANK1 | FLASH_FLAG_CRCRDERR_BANK1) /*!< All Bank 1 error flags */
  170. #else
  171. #define FLASH_FLAG_ALL_ERRORS_BANK1 (FLASH_FLAG_WRPERR_BANK1 | FLASH_FLAG_PGSERR_BANK1 | \
  172. FLASH_FLAG_STRBERR_BANK1 | FLASH_FLAG_INCERR_BANK1 | \
  173. FLASH_FLAG_RDPERR_BANK1 | FLASH_FLAG_RDSERR_BANK1 | \
  174. FLASH_FLAG_SNECCERR_BANK1 | FLASH_FLAG_DBECCERR_BANK1 | \
  175. FLASH_FLAG_CRCRDERR_BANK1) /*!< All Bank 1 error flags */
  176. #endif /* FLASH_SR_OPERR */
  177. #define FLASH_FLAG_ALL_BANK1 (FLASH_FLAG_BSY_BANK1 | FLASH_FLAG_WBNE_BANK1 | \
  178. FLASH_FLAG_QW_BANK1 | FLASH_FLAG_CRC_BUSY_BANK1 | \
  179. FLASH_FLAG_EOP_BANK1 | FLASH_FLAG_CRCEND_BANK1 | \
  180. FLASH_FLAG_ALL_ERRORS_BANK1) /*!< All Bank 1 flags */
  181. #define FLASH_FLAG_BSY_BANK2 (FLASH_SR_BSY | 0x80000000U) /*!< FLASH Bank 2 Busy flag */
  182. #define FLASH_FLAG_WBNE_BANK2 (FLASH_SR_WBNE | 0x80000000U) /*!< Write Buffer Not Empty on Bank 2 flag */
  183. #define FLASH_FLAG_QW_BANK2 (FLASH_SR_QW | 0x80000000U) /*!< Wait Queue on Bank 2 flag */
  184. #define FLASH_FLAG_CRC_BUSY_BANK2 (FLASH_SR_CRC_BUSY | 0x80000000U) /*!< CRC Busy on Bank 2 flag */
  185. #define FLASH_FLAG_EOP_BANK2 (FLASH_SR_EOP | 0x80000000U) /*!< End Of Program on Bank 2 flag */
  186. #define FLASH_FLAG_WRPERR_BANK2 (FLASH_SR_WRPERR | 0x80000000U) /*!< Write Protection Error on Bank 2 flag */
  187. #define FLASH_FLAG_PGSERR_BANK2 (FLASH_SR_PGSERR | 0x80000000U) /*!< Program Sequence Error on Bank 2 flag */
  188. #define FLASH_FLAG_STRBERR_BANK2 (FLASH_SR_STRBERR | 0x80000000U) /*!< Strobe Error on Bank 2 flag */
  189. #define FLASH_FLAG_INCERR_BANK2 (FLASH_SR_INCERR | 0x80000000U) /*!< Inconsistency Error on Bank 2 flag */
  190. #if defined (FLASH_SR_OPERR)
  191. #define FLASH_FLAG_OPERR_BANK2 (FLASH_SR_OPERR | 0x80000000U) /*!< Operation Error on Bank 2 flag */
  192. #endif /* FLASH_SR_OPERR */
  193. #define FLASH_FLAG_RDPERR_BANK2 (FLASH_SR_RDPERR | 0x80000000U) /*!< Read Protection Error on Bank 2 flag */
  194. #define FLASH_FLAG_RDSERR_BANK2 (FLASH_SR_RDSERR | 0x80000000U) /*!< Read Secured Error on Bank 2 flag */
  195. #define FLASH_FLAG_SNECCERR_BANK2 (FLASH_SR_SNECCERR | 0x80000000U) /*!< Single ECC Error Correction on Bank 2 flag */
  196. #define FLASH_FLAG_DBECCERR_BANK2 (FLASH_SR_DBECCERR | 0x80000000U) /*!< Double Detection ECC Error on Bank 2 flag */
  197. #define FLASH_FLAG_CRCEND_BANK2 (FLASH_SR_CRCEND | 0x80000000U) /*!< CRC End of Calculation on Bank 2 flag */
  198. #define FLASH_FLAG_CRCRDERR_BANK2 (FLASH_SR_CRCRDERR | 0x80000000U) /*!< CRC Read error on Bank 2 flag */
  199. #if defined (FLASH_SR_OPERR)
  200. #define FLASH_FLAG_ALL_ERRORS_BANK2 (FLASH_FLAG_WRPERR_BANK2 | FLASH_FLAG_PGSERR_BANK2 | \
  201. FLASH_FLAG_STRBERR_BANK2 | FLASH_FLAG_INCERR_BANK2 | \
  202. FLASH_FLAG_OPERR_BANK2 | FLASH_FLAG_RDPERR_BANK2 | \
  203. FLASH_FLAG_RDSERR_BANK2 | FLASH_FLAG_SNECCERR_BANK2 | \
  204. FLASH_FLAG_DBECCERR_BANK2 | FLASH_FLAG_CRCRDERR_BANK2) /*!< All Bank 2 error flags */
  205. #else
  206. #define FLASH_FLAG_ALL_ERRORS_BANK2 (FLASH_FLAG_WRPERR_BANK2 | FLASH_FLAG_PGSERR_BANK2 | \
  207. FLASH_FLAG_STRBERR_BANK2 | FLASH_FLAG_INCERR_BANK2 | \
  208. FLASH_FLAG_RDPERR_BANK2 | FLASH_FLAG_RDSERR_BANK2 | \
  209. FLASH_FLAG_SNECCERR_BANK2 | FLASH_FLAG_DBECCERR_BANK2 | \
  210. FLASH_FLAG_CRCRDERR_BANK2) /*!< All Bank 2 error flags */
  211. #endif /* FLASH_SR_OPERR */
  212. #define FLASH_FLAG_ALL_BANK2 (FLASH_FLAG_BSY_BANK2 | FLASH_FLAG_WBNE_BANK2 | \
  213. FLASH_FLAG_QW_BANK2 | FLASH_FLAG_CRC_BUSY_BANK2 | \
  214. FLASH_FLAG_EOP_BANK2 | FLASH_FLAG_CRCEND_BANK2 | \
  215. FLASH_FLAG_ALL_ERRORS_BANK2) /*!< All Bank 2 flags */
  216. /**
  217. * @}
  218. */
  219. /** @defgroup FLASH_Interrupt_definition FLASH Interrupt definition
  220. * @brief FLASH Interrupt definition
  221. * @{
  222. */
  223. #define FLASH_IT_EOP_BANK1 FLASH_CR_EOPIE /*!< End of FLASH Bank 1 Operation Interrupt source */
  224. #define FLASH_IT_WRPERR_BANK1 FLASH_CR_WRPERRIE /*!< Write Protection Error on Bank 1 Interrupt source */
  225. #define FLASH_IT_PGSERR_BANK1 FLASH_CR_PGSERRIE /*!< Program Sequence Error on Bank 1 Interrupt source */
  226. #define FLASH_IT_STRBERR_BANK1 FLASH_CR_STRBERRIE /*!< Strobe Error on Bank 1 Interrupt source */
  227. #define FLASH_IT_INCERR_BANK1 FLASH_CR_INCERRIE /*!< Inconsistency Error on Bank 1 Interrupt source */
  228. #if defined (FLASH_CR_OPERRIE)
  229. #define FLASH_IT_OPERR_BANK1 FLASH_CR_OPERRIE /*!< Operation Error on Bank 1 Interrupt source */
  230. #endif /* FLASH_CR_OPERRIE */
  231. #define FLASH_IT_RDPERR_BANK1 FLASH_CR_RDPERRIE /*!< Read protection Error on Bank 1 Interrupt source */
  232. #define FLASH_IT_RDSERR_BANK1 FLASH_CR_RDSERRIE /*!< Read Secured Error on Bank 1 Interrupt source */
  233. #define FLASH_IT_SNECCERR_BANK1 FLASH_CR_SNECCERRIE /*!< Single ECC Error Correction on Bank 1 Interrupt source */
  234. #define FLASH_IT_DBECCERR_BANK1 FLASH_CR_DBECCERRIE /*!< Double Detection ECC Error on Bank 1 Interrupt source */
  235. #define FLASH_IT_CRCEND_BANK1 FLASH_CR_CRCENDIE /*!< CRC End on Bank 1 Interrupt source */
  236. #define FLASH_IT_CRCRDERR_BANK1 FLASH_CR_CRCRDERRIE /*!< CRC Read error on Bank 1 Interrupt source */
  237. #if defined (FLASH_CR_OPERRIE)
  238. #define FLASH_IT_ALL_BANK1 (FLASH_IT_EOP_BANK1 | FLASH_IT_WRPERR_BANK1 | \
  239. FLASH_IT_PGSERR_BANK1 | FLASH_IT_STRBERR_BANK1 | \
  240. FLASH_IT_INCERR_BANK1 | FLASH_IT_OPERR_BANK1 | \
  241. FLASH_IT_RDPERR_BANK1 | FLASH_IT_RDSERR_BANK1 | \
  242. FLASH_IT_SNECCERR_BANK1 | FLASH_IT_DBECCERR_BANK1 | \
  243. FLASH_IT_CRCEND_BANK1 | FLASH_IT_CRCRDERR_BANK1) /*!< All Bank 1 Interrupt sources */
  244. #else
  245. #define FLASH_IT_ALL_BANK1 (FLASH_IT_EOP_BANK1 | FLASH_IT_WRPERR_BANK1 | \
  246. FLASH_IT_PGSERR_BANK1 | FLASH_IT_STRBERR_BANK1 | \
  247. FLASH_IT_INCERR_BANK1 | FLASH_IT_RDPERR_BANK1 | \
  248. FLASH_IT_RDSERR_BANK1 | FLASH_IT_SNECCERR_BANK1 | \
  249. FLASH_IT_DBECCERR_BANK1 | FLASH_IT_CRCEND_BANK1 | \
  250. FLASH_IT_CRCRDERR_BANK1) /*!< All Bank 1 Interrupt sources */
  251. #endif /* FLASH_CR_OPERRIE */
  252. #define FLASH_IT_EOP_BANK2 (FLASH_CR_EOPIE | 0x80000000U) /*!< End of FLASH Bank 2 Operation Interrupt source */
  253. #define FLASH_IT_WRPERR_BANK2 (FLASH_CR_WRPERRIE | 0x80000000U) /*!< Write Protection Error on Bank 2 Interrupt source */
  254. #define FLASH_IT_PGSERR_BANK2 (FLASH_CR_PGSERRIE | 0x80000000U) /*!< Program Sequence Error on Bank 2 Interrupt source */
  255. #define FLASH_IT_STRBERR_BANK2 (FLASH_CR_STRBERRIE | 0x80000000U) /*!< Strobe Error on Bank 2 Interrupt source */
  256. #define FLASH_IT_INCERR_BANK2 (FLASH_CR_INCERRIE | 0x80000000U) /*!< Inconsistency Error on Bank 2 Interrupt source */
  257. #if defined (FLASH_CR_OPERRIE)
  258. #define FLASH_IT_OPERR_BANK2 (FLASH_CR_OPERRIE | 0x80000000U) /*!< Operation Error on Bank 2 Interrupt source */
  259. #endif /* FLASH_CR_OPERRIE */
  260. #define FLASH_IT_RDPERR_BANK2 (FLASH_CR_RDPERRIE | 0x80000000U) /*!< Read protection Error on Bank 2 Interrupt source */
  261. #define FLASH_IT_RDSERR_BANK2 (FLASH_CR_RDSERRIE | 0x80000000U) /*!< Read Secured Error on Bank 2 Interrupt source */
  262. #define FLASH_IT_SNECCERR_BANK2 (FLASH_CR_SNECCERRIE | 0x80000000U) /*!< Single ECC Error Correction on Bank 2 Interrupt source */
  263. #define FLASH_IT_DBECCERR_BANK2 (FLASH_CR_DBECCERRIE | 0x80000000U) /*!< Double Detection ECC Error on Bank 2 Interrupt source */
  264. #define FLASH_IT_CRCEND_BANK2 (FLASH_CR_CRCENDIE | 0x80000000U) /*!< CRC End on Bank 2 Interrupt source */
  265. #define FLASH_IT_CRCRDERR_BANK2 (FLASH_CR_CRCRDERRIE | 0x80000000U) /*!< CRC Read Error on Bank 2 Interrupt source */
  266. #if defined (FLASH_CR_OPERRIE)
  267. #define FLASH_IT_ALL_BANK2 (FLASH_IT_EOP_BANK2 | FLASH_IT_WRPERR_BANK2 | \
  268. FLASH_IT_PGSERR_BANK2 | FLASH_IT_STRBERR_BANK2 | \
  269. FLASH_IT_INCERR_BANK2 | FLASH_IT_OPERR_BANK2 | \
  270. FLASH_IT_RDPERR_BANK2 | FLASH_IT_RDSERR_BANK2 | \
  271. FLASH_IT_SNECCERR_BANK2 | FLASH_IT_DBECCERR_BANK2 | \
  272. FLASH_IT_CRCEND_BANK2 | FLASH_IT_CRCRDERR_BANK2) /*!< All Bank 2 Interrupt sources */
  273. #else
  274. #define FLASH_IT_ALL_BANK2 (FLASH_IT_EOP_BANK2 | FLASH_IT_WRPERR_BANK2 | \
  275. FLASH_IT_PGSERR_BANK2 | FLASH_IT_STRBERR_BANK2 | \
  276. FLASH_IT_INCERR_BANK2 | FLASH_IT_RDPERR_BANK2 | \
  277. FLASH_IT_RDSERR_BANK2 | FLASH_IT_SNECCERR_BANK2 | \
  278. FLASH_IT_DBECCERR_BANK2 | FLASH_IT_CRCEND_BANK2 | \
  279. FLASH_IT_CRCRDERR_BANK2) /*!< All Bank 2 Interrupt sources */
  280. #endif /* FLASH_CR_OPERRIE */
  281. /**
  282. * @}
  283. */
  284. #if defined (FLASH_CR_PSIZE)
  285. /** @defgroup FLASH_Program_Parallelism FLASH Program Parallelism
  286. * @{
  287. */
  288. #define FLASH_PSIZE_BYTE 0x00000000U /*!< Flash program/erase by 8 bits */
  289. #define FLASH_PSIZE_HALF_WORD FLASH_CR_PSIZE_0 /*!< Flash program/erase by 16 bits */
  290. #define FLASH_PSIZE_WORD FLASH_CR_PSIZE_1 /*!< Flash program/erase by 32 bits */
  291. #define FLASH_PSIZE_DOUBLE_WORD FLASH_CR_PSIZE /*!< Flash program/erase by 64 bits */
  292. /**
  293. * @}
  294. */
  295. #endif /* FLASH_CR_PSIZE */
  296. /** @defgroup FLASH_Keys FLASH Keys
  297. * @{
  298. */
  299. #define FLASH_KEY1 0x45670123U
  300. #define FLASH_KEY2 0xCDEF89ABU
  301. #define FLASH_OPT_KEY1 0x08192A3BU
  302. #define FLASH_OPT_KEY2 0x4C5D6E7FU
  303. /**
  304. * @}
  305. */
  306. /** @defgroup FLASH_Sectors FLASH Sectors
  307. * @{
  308. */
  309. #define FLASH_SECTOR_0 0U /*!< Sector Number 0 */
  310. #define FLASH_SECTOR_1 1U /*!< Sector Number 1 */
  311. #define FLASH_SECTOR_2 2U /*!< Sector Number 2 */
  312. #define FLASH_SECTOR_3 3U /*!< Sector Number 3 */
  313. #define FLASH_SECTOR_4 4U /*!< Sector Number 4 */
  314. #define FLASH_SECTOR_5 5U /*!< Sector Number 5 */
  315. #define FLASH_SECTOR_6 6U /*!< Sector Number 6 */
  316. #define FLASH_SECTOR_7 7U /*!< Sector Number 7 */
  317. #if (FLASH_SECTOR_TOTAL == 128)
  318. #define FLASH_SECTOR_8 8U /*!< Sector Number 8 */
  319. #define FLASH_SECTOR_9 9U /*!< Sector Number 9 */
  320. #define FLASH_SECTOR_10 10U /*!< Sector Number 10 */
  321. #define FLASH_SECTOR_11 11U /*!< Sector Number 11 */
  322. #define FLASH_SECTOR_12 12U /*!< Sector Number 12 */
  323. #define FLASH_SECTOR_13 13U /*!< Sector Number 13 */
  324. #define FLASH_SECTOR_14 14U /*!< Sector Number 14 */
  325. #define FLASH_SECTOR_15 15U /*!< Sector Number 15 */
  326. #define FLASH_SECTOR_16 16U /*!< Sector Number 16 */
  327. #define FLASH_SECTOR_17 17U /*!< Sector Number 17 */
  328. #define FLASH_SECTOR_18 18U /*!< Sector Number 18 */
  329. #define FLASH_SECTOR_19 19U /*!< Sector Number 19 */
  330. #define FLASH_SECTOR_20 20U /*!< Sector Number 20 */
  331. #define FLASH_SECTOR_21 21U /*!< Sector Number 21 */
  332. #define FLASH_SECTOR_22 22U /*!< Sector Number 22 */
  333. #define FLASH_SECTOR_23 23U /*!< Sector Number 23 */
  334. #define FLASH_SECTOR_24 24U /*!< Sector Number 24 */
  335. #define FLASH_SECTOR_25 25U /*!< Sector Number 25 */
  336. #define FLASH_SECTOR_26 26U /*!< Sector Number 26 */
  337. #define FLASH_SECTOR_27 27U /*!< Sector Number 27 */
  338. #define FLASH_SECTOR_28 28U /*!< Sector Number 28 */
  339. #define FLASH_SECTOR_29 29U /*!< Sector Number 29 */
  340. #define FLASH_SECTOR_30 30U /*!< Sector Number 30 */
  341. #define FLASH_SECTOR_31 31U /*!< Sector Number 31 */
  342. #define FLASH_SECTOR_32 32U /*!< Sector Number 32 */
  343. #define FLASH_SECTOR_33 33U /*!< Sector Number 33 */
  344. #define FLASH_SECTOR_34 34U /*!< Sector Number 34 */
  345. #define FLASH_SECTOR_35 35U /*!< Sector Number 35 */
  346. #define FLASH_SECTOR_36 36U /*!< Sector Number 36 */
  347. #define FLASH_SECTOR_37 37U /*!< Sector Number 37 */
  348. #define FLASH_SECTOR_38 38U /*!< Sector Number 38 */
  349. #define FLASH_SECTOR_39 39U /*!< Sector Number 39 */
  350. #define FLASH_SECTOR_40 40U /*!< Sector Number 40 */
  351. #define FLASH_SECTOR_41 41U /*!< Sector Number 41 */
  352. #define FLASH_SECTOR_42 42U /*!< Sector Number 42 */
  353. #define FLASH_SECTOR_43 43U /*!< Sector Number 43 */
  354. #define FLASH_SECTOR_44 44U /*!< Sector Number 44 */
  355. #define FLASH_SECTOR_45 45U /*!< Sector Number 45 */
  356. #define FLASH_SECTOR_46 46U /*!< Sector Number 46 */
  357. #define FLASH_SECTOR_47 47U /*!< Sector Number 47 */
  358. #define FLASH_SECTOR_48 48U /*!< Sector Number 48 */
  359. #define FLASH_SECTOR_49 49U /*!< Sector Number 49 */
  360. #define FLASH_SECTOR_50 50U /*!< Sector Number 50 */
  361. #define FLASH_SECTOR_51 51U /*!< Sector Number 51 */
  362. #define FLASH_SECTOR_52 52U /*!< Sector Number 52 */
  363. #define FLASH_SECTOR_53 53U /*!< Sector Number 53 */
  364. #define FLASH_SECTOR_54 54U /*!< Sector Number 54 */
  365. #define FLASH_SECTOR_55 55U /*!< Sector Number 55 */
  366. #define FLASH_SECTOR_56 56U /*!< Sector Number 56 */
  367. #define FLASH_SECTOR_57 57U /*!< Sector Number 57 */
  368. #define FLASH_SECTOR_58 58U /*!< Sector Number 58 */
  369. #define FLASH_SECTOR_59 59U /*!< Sector Number 59 */
  370. #define FLASH_SECTOR_60 60U /*!< Sector Number 60 */
  371. #define FLASH_SECTOR_61 61U /*!< Sector Number 61 */
  372. #define FLASH_SECTOR_62 62U /*!< Sector Number 62 */
  373. #define FLASH_SECTOR_63 63U /*!< Sector Number 63 */
  374. #define FLASH_SECTOR_64 64U /*!< Sector Number 64 */
  375. #define FLASH_SECTOR_65 65U /*!< Sector Number 65 */
  376. #define FLASH_SECTOR_66 66U /*!< Sector Number 66 */
  377. #define FLASH_SECTOR_67 67U /*!< Sector Number 67 */
  378. #define FLASH_SECTOR_68 68U /*!< Sector Number 68 */
  379. #define FLASH_SECTOR_69 69U /*!< Sector Number 69 */
  380. #define FLASH_SECTOR_70 70U /*!< Sector Number 70 */
  381. #define FLASH_SECTOR_71 71U /*!< Sector Number 71 */
  382. #define FLASH_SECTOR_72 72U /*!< Sector Number 72 */
  383. #define FLASH_SECTOR_73 73U /*!< Sector Number 73 */
  384. #define FLASH_SECTOR_74 74U /*!< Sector Number 74 */
  385. #define FLASH_SECTOR_75 75U /*!< Sector Number 75 */
  386. #define FLASH_SECTOR_76 76U /*!< Sector Number 76 */
  387. #define FLASH_SECTOR_77 77U /*!< Sector Number 77 */
  388. #define FLASH_SECTOR_78 78U /*!< Sector Number 78 */
  389. #define FLASH_SECTOR_79 79U /*!< Sector Number 79 */
  390. #define FLASH_SECTOR_80 80U /*!< Sector Number 80 */
  391. #define FLASH_SECTOR_81 81U /*!< Sector Number 81 */
  392. #define FLASH_SECTOR_82 82U /*!< Sector Number 82 */
  393. #define FLASH_SECTOR_83 83U /*!< Sector Number 83 */
  394. #define FLASH_SECTOR_84 84U /*!< Sector Number 84 */
  395. #define FLASH_SECTOR_85 85U /*!< Sector Number 85 */
  396. #define FLASH_SECTOR_86 86U /*!< Sector Number 86 */
  397. #define FLASH_SECTOR_87 87U /*!< Sector Number 87 */
  398. #define FLASH_SECTOR_88 88U /*!< Sector Number 88 */
  399. #define FLASH_SECTOR_89 89U /*!< Sector Number 89 */
  400. #define FLASH_SECTOR_90 90U /*!< Sector Number 90 */
  401. #define FLASH_SECTOR_91 91U /*!< Sector Number 91 */
  402. #define FLASH_SECTOR_92 92U /*!< Sector Number 92 */
  403. #define FLASH_SECTOR_93 93U /*!< Sector Number 93 */
  404. #define FLASH_SECTOR_94 94U /*!< Sector Number 94 */
  405. #define FLASH_SECTOR_95 95U /*!< Sector Number 95 */
  406. #define FLASH_SECTOR_96 96U /*!< Sector Number 96 */
  407. #define FLASH_SECTOR_97 97U /*!< Sector Number 97 */
  408. #define FLASH_SECTOR_98 98U /*!< Sector Number 98 */
  409. #define FLASH_SECTOR_99 99U /*!< Sector Number 99 */
  410. #define FLASH_SECTOR_100 100U /*!< Sector Number 100 */
  411. #define FLASH_SECTOR_101 101U /*!< Sector Number 101 */
  412. #define FLASH_SECTOR_102 102U /*!< Sector Number 102 */
  413. #define FLASH_SECTOR_103 103U /*!< Sector Number 103 */
  414. #define FLASH_SECTOR_104 104U /*!< Sector Number 104 */
  415. #define FLASH_SECTOR_105 105U /*!< Sector Number 105 */
  416. #define FLASH_SECTOR_106 106U /*!< Sector Number 106 */
  417. #define FLASH_SECTOR_107 107U /*!< Sector Number 107 */
  418. #define FLASH_SECTOR_108 108U /*!< Sector Number 108 */
  419. #define FLASH_SECTOR_109 109U /*!< Sector Number 109 */
  420. #define FLASH_SECTOR_110 110U /*!< Sector Number 110 */
  421. #define FLASH_SECTOR_111 111U /*!< Sector Number 111 */
  422. #define FLASH_SECTOR_112 112U /*!< Sector Number 112 */
  423. #define FLASH_SECTOR_113 113U /*!< Sector Number 113 */
  424. #define FLASH_SECTOR_114 114U /*!< Sector Number 114 */
  425. #define FLASH_SECTOR_115 115U /*!< Sector Number 115 */
  426. #define FLASH_SECTOR_116 116U /*!< Sector Number 116 */
  427. #define FLASH_SECTOR_117 117U /*!< Sector Number 117 */
  428. #define FLASH_SECTOR_118 118U /*!< Sector Number 118 */
  429. #define FLASH_SECTOR_119 119U /*!< Sector Number 119 */
  430. #define FLASH_SECTOR_120 120U /*!< Sector Number 120 */
  431. #define FLASH_SECTOR_121 121U /*!< Sector Number 121 */
  432. #define FLASH_SECTOR_122 122U /*!< Sector Number 122 */
  433. #define FLASH_SECTOR_123 123U /*!< Sector Number 123 */
  434. #define FLASH_SECTOR_124 124U /*!< Sector Number 124 */
  435. #define FLASH_SECTOR_125 125U /*!< Sector Number 125 */
  436. #define FLASH_SECTOR_126 126U /*!< Sector Number 126 */
  437. #define FLASH_SECTOR_127 127U /*!< Sector Number 127 */
  438. #endif /* FLASH_SECTOR_TOTAL == 128 */
  439. /**
  440. * @}
  441. */
  442. /**
  443. * @}
  444. */
  445. /* Exported macro ------------------------------------------------------------*/
  446. /** @defgroup FLASH_Exported_Macros FLASH Exported Macros
  447. * @{
  448. */
  449. /**
  450. * @brief Set the FLASH Latency.
  451. * @param __LATENCY__: FLASH Latency
  452. * The value of this parameter depend on device used within the same series
  453. * @retval none
  454. */
  455. #define __HAL_FLASH_SET_LATENCY(__LATENCY__) \
  456. MODIFY_REG(FLASH->ACR, FLASH_ACR_LATENCY, (uint32_t)(__LATENCY__))
  457. /**
  458. * @brief Get the FLASH Latency.
  459. * @retval FLASH Latency
  460. * The value of this parameter depend on device used within the same series
  461. */
  462. #define __HAL_FLASH_GET_LATENCY() (READ_BIT((FLASH->ACR), FLASH_ACR_LATENCY))
  463. /**
  464. * @brief Enable the specified FLASH interrupt.
  465. * @param __INTERRUPT__ : FLASH interrupt
  466. * In case of Bank 1 This parameter can be any combination of the following values:
  467. * @arg FLASH_IT_EOP_BANK1 : End of FLASH Bank 1 Operation Interrupt source
  468. * @arg FLASH_IT_WRPERR_BANK1 : Write Protection Error on Bank 1 Interrupt source
  469. * @arg FLASH_IT_PGSERR_BANK1 : Program Sequence Error on Bank 1 Interrupt source
  470. * @arg FLASH_IT_STRBERR_BANK1 : Strobe Error on Bank 1 Interrupt source
  471. * @arg FLASH_IT_INCERR_BANK1 : Inconsistency Error on Bank 1 Interrupt source
  472. * @arg FLASH_IT_OPERR_BANK1 : Operation Error on Bank 1 Interrupt source
  473. * @arg FLASH_IT_RDPERR_BANK1 : Read protection Error on Bank 1 Interrupt source
  474. * @arg FLASH_IT_RDSERR_BANK1 : Read secure Error on Bank 1 Interrupt source
  475. * @arg FLASH_IT_SNECCERR_BANK1 : Single ECC Error Correction on Bank 1 Interrupt source
  476. * @arg FLASH_IT_DBECCERR_BANK1 : Double Detection ECC Error on Bank 1 Interrupt source
  477. * @arg FLASH_IT_CRCEND_BANK1 : CRC End on Bank 1 Interrupt source
  478. * @arg FLASH_IT_CRCRDERR_BANK1 : CRC Read error on Bank 1 Interrupt source
  479. * @arg FLASH_IT_ALL_BANK1 : All Bank 1 Interrupt sources
  480. *
  481. * In case of Bank 2, this parameter can be any combination of the following values:
  482. * @arg FLASH_IT_EOP_BANK2 : End of FLASH Bank 2 Operation Interrupt source
  483. * @arg FLASH_IT_WRPERR_BANK2 : Write Protection Error on Bank 2 Interrupt source
  484. * @arg FLASH_IT_PGSERR_BANK2 : Program Sequence Error on Bank 2 Interrupt source
  485. * @arg FLASH_IT_STRBERR_BANK2 : Strobe Error on Bank 2 Interrupt source
  486. * @arg FLASH_IT_INCERR_BANK2 : Inconsistency Error on Bank 2 Interrupt source
  487. * @arg FLASH_IT_OPERR_BANK2 : Operation Error on Bank 2 Interrupt source
  488. * @arg FLASH_IT_RDPERR_BANK2 : Read protection Error on Bank 2 Interrupt source
  489. * @arg FLASH_IT_RDSERR_BANK2 : Read secure Error on Bank 2 Interrupt source
  490. * @arg FLASH_IT_SNECCERR_BANK2 : Single ECC Error Correction on Bank 2 Interrupt source
  491. * @arg FLASH_IT_DBECCERR_BANK2 : Double Detection ECC Error on Bank 2 Interrupt source
  492. * @arg FLASH_IT_CRCEND_BANK2 : CRC End on Bank 2 Interrupt source
  493. * @arg FLASH_IT_CRCRDERR_BANK2 : CRC Read error on Bank 2 Interrupt source
  494. * @arg FLASH_IT_ALL_BANK2 : All Bank 2 Interrupt sources
  495. * @retval none
  496. */
  497. #define __HAL_FLASH_ENABLE_IT_BANK1(__INTERRUPT__) (FLASH->CR1 |= (__INTERRUPT__))
  498. #define __HAL_FLASH_ENABLE_IT_BANK2(__INTERRUPT__) (FLASH->CR2 |= ((__INTERRUPT__) & 0x7FFFFFFFU))
  499. #if defined (DUAL_BANK)
  500. #define __HAL_FLASH_ENABLE_IT(__INTERRUPT__) (IS_FLASH_IT_BANK1(__INTERRUPT__) ? \
  501. __HAL_FLASH_ENABLE_IT_BANK1(__INTERRUPT__) : \
  502. __HAL_FLASH_ENABLE_IT_BANK2(__INTERRUPT__))
  503. #else
  504. #define __HAL_FLASH_ENABLE_IT(__INTERRUPT__) __HAL_FLASH_ENABLE_IT_BANK1(__INTERRUPT__)
  505. #endif /* DUAL_BANK */
  506. /**
  507. * @brief Disable the specified FLASH interrupt.
  508. * @param __INTERRUPT__ : FLASH interrupt
  509. * In case of Bank 1 This parameter can be any combination of the following values:
  510. * @arg FLASH_IT_EOP_BANK1 : End of FLASH Bank 1 Operation Interrupt source
  511. * @arg FLASH_IT_WRPERR_BANK1 : Write Protection Error on Bank 1 Interrupt source
  512. * @arg FLASH_IT_PGSERR_BANK1 : Program Sequence Error on Bank 1 Interrupt source
  513. * @arg FLASH_IT_STRBERR_BANK1 : Strobe Error on Bank 1 Interrupt source
  514. * @arg FLASH_IT_INCERR_BANK1 : Inconsistency Error on Bank 1 Interrupt source
  515. * @arg FLASH_IT_OPERR_BANK1 : Operation Error on Bank 1 Interrupt source
  516. * @arg FLASH_IT_RDPERR_BANK1 : Read protection Error on Bank 1 Interrupt source
  517. * @arg FLASH_IT_RDSERR_BANK1 : Read secure Error on Bank 1 Interrupt source
  518. * @arg FLASH_IT_SNECCERR_BANK1 : Single ECC Error Correction on Bank 1 Interrupt source
  519. * @arg FLASH_IT_DBECCERR_BANK1 : Double Detection ECC Error on Bank 1 Interrupt source
  520. * @arg FLASH_IT_CRCEND_BANK1 : CRC End on Bank 1 Interrupt source
  521. * @arg FLASH_IT_CRCRDERR_BANK1 : CRC Read error on Bank 1 Interrupt source
  522. * @arg FLASH_IT_ALL_BANK1 : All Bank 1 Interrupt sources
  523. *
  524. * In case of Bank 2, this parameter can be any combination of the following values:
  525. * @arg FLASH_IT_EOP_BANK2 : End of FLASH Bank 2 Operation Interrupt source
  526. * @arg FLASH_IT_WRPERR_BANK2 : Write Protection Error on Bank 2 Interrupt source
  527. * @arg FLASH_IT_PGSERR_BANK2 : Program Sequence Error on Bank 2 Interrupt source
  528. * @arg FLASH_IT_STRBERR_BANK2 : Strobe Error on Bank 2 Interrupt source
  529. * @arg FLASH_IT_INCERR_BANK2 : Inconsistency Error on Bank 2 Interrupt source
  530. * @arg FLASH_IT_OPERR_BANK2 : Operation Error on Bank 2 Interrupt source
  531. * @arg FLASH_IT_RDPERR_BANK2 : Read protection Error on Bank 2 Interrupt source
  532. * @arg FLASH_IT_RDSERR_BANK2 : Read secure Error on Bank 2 Interrupt source
  533. * @arg FLASH_IT_SNECCERR_BANK2 : Single ECC Error Correction on Bank 2 Interrupt source
  534. * @arg FLASH_IT_DBECCERR_BANK2 : Double Detection ECC Error on Bank 2 Interrupt source
  535. * @arg FLASH_IT_CRCEND_BANK2 : CRC End on Bank 2 Interrupt source
  536. * @arg FLASH_IT_CRCRDERR_BANK2 : CRC Read error on Bank 2 Interrupt source
  537. * @arg FLASH_IT_ALL_BANK2 : All Bank 2 Interrupt sources
  538. * @retval none
  539. */
  540. #define __HAL_FLASH_DISABLE_IT_BANK1(__INTERRUPT__) (FLASH->CR1 &= ~(uint32_t)(__INTERRUPT__))
  541. #define __HAL_FLASH_DISABLE_IT_BANK2(__INTERRUPT__) (FLASH->CR2 &= ~(uint32_t)((__INTERRUPT__) & 0x7FFFFFFFU))
  542. #if defined (DUAL_BANK)
  543. #define __HAL_FLASH_DISABLE_IT(__INTERRUPT__) (IS_FLASH_IT_BANK1(__INTERRUPT__) ? \
  544. __HAL_FLASH_DISABLE_IT_BANK1(__INTERRUPT__) : \
  545. __HAL_FLASH_DISABLE_IT_BANK2(__INTERRUPT__))
  546. #else
  547. #define __HAL_FLASH_DISABLE_IT(__INTERRUPT__) __HAL_FLASH_DISABLE_IT_BANK1(__INTERRUPT__)
  548. #endif /* DUAL_BANK */
  549. /**
  550. * @brief Checks whether the specified FLASH flag is set or not.
  551. * @param __FLAG__: specifies the FLASH flag to check.
  552. * In case of Bank 1 This parameter can be one of the following values :
  553. * @arg FLASH_FLAG_BSY_BANK1 : FLASH Bank 1 Busy flag
  554. * @arg FLASH_FLAG_WBNE_BANK1 : Write Buffer Not Empty on Bank 1 flag
  555. * @arg FLASH_FLAG_QW_BANK1 : Wait Queue on Bank 1 flag
  556. * @arg FLASH_FLAG_CRC_BUSY_BANK1 : CRC module is working on Bank 1 flag
  557. * @arg FLASH_FLAG_EOP_BANK1 : End Of Program on Bank 1 flag
  558. * @arg FLASH_FLAG_WRPERR_BANK1 : Write Protection Error on Bank 1 flag
  559. * @arg FLASH_FLAG_PGSERR_BANK1 : Program Sequence Error on Bank 1 flag
  560. * @arg FLASH_FLAG_STRBER_BANK1 : Program Alignment Error on Bank 1 flag
  561. * @arg FLASH_FLAG_INCERR_BANK1 : Inconsistency Error on Bank 1 flag
  562. * @arg FLASH_FLAG_OPERR_BANK1 : Operation Error on Bank 1 flag
  563. * @arg FLASH_FLAG_RDPERR_BANK1 : Read Protection Error on Bank 1 flag
  564. * @arg FLASH_FLAG_RDSERR_BANK1 : Read secure Error on Bank 1 flag
  565. * @arg FLASH_FLAG_SNECCE_BANK1 : Single ECC Error Correction on Bank 1 flag
  566. * @arg FLASH_FLAG_DBECCE_BANK1 : Double Detection ECC Error on Bank 1 flag
  567. * @arg FLASH_FLAG_CRCEND_BANK1 : CRC End on Bank 1 flag
  568. * @arg FLASH_FLAG_CRCRDERR_BANK1 : CRC Read error on Bank 1 flag
  569. *
  570. * In case of Bank 2 This parameter can be one of the following values :
  571. * @arg FLASH_FLAG_BSY_BANK2 : FLASH Bank 2 Busy flag
  572. * @arg FLASH_FLAG_WBNE_BANK2 : Write Buffer Not Empty on Bank 2 flag
  573. * @arg FLASH_FLAG_QW_BANK2 : Wait Queue on Bank 2 flag
  574. * @arg FLASH_FLAG_CRC_BUSY_BANK2 : CRC module is working on Bank 2 flag
  575. * @arg FLASH_FLAG_EOP_BANK2 : End Of Program on Bank 2 flag
  576. * @arg FLASH_FLAG_WRPERR_BANK2 : Write Protection Error on Bank 2 flag
  577. * @arg FLASH_FLAG_PGSERR_BANK2 : Program Sequence Error on Bank 2 flag
  578. * @arg FLASH_FLAG_STRBER_BANK2 : Program Alignment Error on Bank 2 flag
  579. * @arg FLASH_FLAG_INCERR_BANK2 : Inconsistency Error on Bank 2 flag
  580. * @arg FLASH_FLAG_OPERR_BANK2 : Operation Error on Bank 2 flag
  581. * @arg FLASH_FLAG_RDPERR_BANK2 : Read Protection Error on Bank 2 flag
  582. * @arg FLASH_FLAG_RDSERR_BANK2 : Read secure Error on Bank 2 flag
  583. * @arg FLASH_FLAG_SNECCE_BANK2 : Single ECC Error Correction on Bank 2 flag
  584. * @arg FLASH_FLAG_DBECCE_BANK2 : Double Detection ECC Error on Bank 2 flag
  585. * @arg FLASH_FLAG_CRCEND_BANK2 : CRC End on Bank 2 flag
  586. * @arg FLASH_FLAG_CRCRDERR_BANK2 : CRC Read error on Bank 2 flag
  587. * @retval The new state of FLASH_FLAG (SET or RESET).
  588. */
  589. #define __HAL_FLASH_GET_FLAG_BANK1(__FLAG__) (READ_BIT(FLASH->SR1, (__FLAG__)) == (__FLAG__))
  590. #define __HAL_FLASH_GET_FLAG_BANK2(__FLAG__) (READ_BIT(FLASH->SR2, ((__FLAG__) & 0x7FFFFFFFU)) == (((__FLAG__) & 0x7FFFFFFFU)))
  591. #if defined (DUAL_BANK)
  592. #define __HAL_FLASH_GET_FLAG(__FLAG__) (IS_FLASH_FLAG_BANK1(__FLAG__) ? __HAL_FLASH_GET_FLAG_BANK1(__FLAG__) : \
  593. __HAL_FLASH_GET_FLAG_BANK2(__FLAG__))
  594. #else
  595. #define __HAL_FLASH_GET_FLAG(__FLAG__) __HAL_FLASH_GET_FLAG_BANK1(__FLAG__)
  596. #endif /* DUAL_BANK */
  597. /**
  598. * @brief Clear the specified FLASH flag.
  599. * @param __FLAG__: specifies the FLASH flags to clear.
  600. * In case of Bank 1, this parameter can be any combination of the following values:
  601. * @arg FLASH_FLAG_EOP_BANK1 : End Of Program on Bank 1 flag
  602. * @arg FLASH_FLAG_WRPERR_BANK1 : Write Protection Error on Bank 1 flag
  603. * @arg FLASH_FLAG_PGSERR_BANK1 : Program Sequence Error on Bank 1 flag
  604. * @arg FLASH_FLAG_STRBER_BANK1 : Program Alignment Error on Bank 1 flag
  605. * @arg FLASH_FLAG_INCERR_BANK1 : Inconsistency Error on Bank 1 flag
  606. * @arg FLASH_FLAG_OPERR_BANK1 : Operation Error on Bank 1 flag
  607. * @arg FLASH_FLAG_RDPERR_BANK1 : Read Protection Error on Bank 1 flag
  608. * @arg FLASH_FLAG_RDSERR_BANK1 : Read secure Error on Bank 1 flag
  609. * @arg FLASH_FLAG_SNECCE_BANK1 : Single ECC Error Correction on Bank 1 flag
  610. * @arg FLASH_FLAG_DBECCE_BANK1 : Double Detection ECC Error on Bank 1 flag
  611. * @arg FLASH_FLAG_CRCEND_BANK1 : CRC End on Bank 1 flag
  612. * @arg FLASH_FLAG_CRCRDERR_BANK1 : CRC Read error on Bank 1 flag
  613. * @arg FLASH_FLAG_ALL_ERRORS_BANK1 : All Bank 1 error flags
  614. * @arg FLASH_FLAG_ALL_BANK1 : All Bank 1 flags
  615. *
  616. * In case of Bank 2, this parameter can be any combination of the following values :
  617. * @arg FLASH_FLAG_EOP_BANK2 : End Of Program on Bank 2 flag
  618. * @arg FLASH_FLAG_WRPERR_BANK2 : Write Protection Error on Bank 2 flag
  619. * @arg FLASH_FLAG_PGSERR_BANK2 : Program Sequence Error on Bank 2 flag
  620. * @arg FLASH_FLAG_STRBER_BANK2 : Program Alignment Error on Bank 2 flag
  621. * @arg FLASH_FLAG_INCERR_BANK2 : Inconsistency Error on Bank 2 flag
  622. * @arg FLASH_FLAG_OPERR_BANK2 : Operation Error on Bank 2 flag
  623. * @arg FLASH_FLAG_RDPERR_BANK2 : Read Protection Error on Bank 2 flag
  624. * @arg FLASH_FLAG_RDSERR_BANK2 : Read secure Error on Bank 2 flag
  625. * @arg FLASH_FLAG_SNECCE_BANK2 : Single ECC Error Correction on Bank 2 flag
  626. * @arg FLASH_FLAG_DBECCE_BANK2 : Double Detection ECC Error on Bank 2 flag
  627. * @arg FLASH_FLAG_CRCEND_BANK2 : CRC End on Bank 2 flag
  628. * @arg FLASH_FLAG_CRCRDERR_BANK2 : CRC Read error on Bank 2 flag
  629. * @arg FLASH_FLAG_ALL_ERRORS_BANK2 : All Bank 2 error flags
  630. * @arg FLASH_FLAG_ALL_BANK2 : All Bank 2 flags
  631. * @retval none
  632. */
  633. #define __HAL_FLASH_CLEAR_FLAG_BANK1(__FLAG__) WRITE_REG(FLASH->CCR1, (__FLAG__))
  634. #define __HAL_FLASH_CLEAR_FLAG_BANK2(__FLAG__) WRITE_REG(FLASH->CCR2, ((__FLAG__) & 0x7FFFFFFFU))
  635. #if defined (DUAL_BANK)
  636. #define __HAL_FLASH_CLEAR_FLAG(__FLAG__) (IS_FLASH_FLAG_BANK1(__FLAG__) ? __HAL_FLASH_CLEAR_FLAG_BANK1(__FLAG__) : \
  637. __HAL_FLASH_CLEAR_FLAG_BANK2(__FLAG__))
  638. #else
  639. #define __HAL_FLASH_CLEAR_FLAG(__FLAG__) __HAL_FLASH_CLEAR_FLAG_BANK1(__FLAG__)
  640. #endif /* DUAL_BANK */
  641. /**
  642. * @}
  643. */
  644. /* Include FLASH HAL Extension module */
  645. #include "stm32h7xx_hal_flash_ex.h"
  646. /* Exported functions --------------------------------------------------------*/
  647. /** @addtogroup FLASH_Exported_Functions
  648. * @{
  649. */
  650. /** @addtogroup FLASH_Exported_Functions_Group1
  651. * @{
  652. */
  653. /* Program operation functions ***********************************************/
  654. HAL_StatusTypeDef HAL_FLASH_Program(uint32_t TypeProgram, uint32_t FlashAddress, uint32_t DataAddress);
  655. HAL_StatusTypeDef HAL_FLASH_Program_IT(uint32_t TypeProgram, uint32_t FlashAddress, uint32_t DataAddress);
  656. /* FLASH IRQ handler method */
  657. void HAL_FLASH_IRQHandler(void);
  658. /* Callbacks in non blocking modes */
  659. void HAL_FLASH_EndOfOperationCallback(uint32_t ReturnValue);
  660. void HAL_FLASH_OperationErrorCallback(uint32_t ReturnValue);
  661. /**
  662. * @}
  663. */
  664. /** @addtogroup FLASH_Exported_Functions_Group2
  665. * @{
  666. */
  667. /* Peripheral Control functions **********************************************/
  668. HAL_StatusTypeDef HAL_FLASH_Unlock(void);
  669. HAL_StatusTypeDef HAL_FLASH_Lock(void);
  670. HAL_StatusTypeDef HAL_FLASH_OB_Unlock(void);
  671. HAL_StatusTypeDef HAL_FLASH_OB_Lock(void);
  672. /* Option bytes control */
  673. HAL_StatusTypeDef HAL_FLASH_OB_Launch(void);
  674. /**
  675. * @}
  676. */
  677. /** @addtogroup FLASH_Exported_Functions_Group3
  678. * @{
  679. */
  680. /* Peripheral State functions ************************************************/
  681. uint32_t HAL_FLASH_GetError(void);
  682. /**
  683. * @}
  684. */
  685. /**
  686. * @}
  687. */
  688. /* Private types -------------------------------------------------------------*/
  689. /* Private variables ---------------------------------------------------------*/
  690. /** @defgroup FLASH_Private_Variables FLASH Private Variables
  691. * @{
  692. */
  693. extern FLASH_ProcessTypeDef pFlash;
  694. /**
  695. * @}
  696. */
  697. /* Private constants ---------------------------------------------------------*/
  698. /** @defgroup FLASH_Private_Constants FLASH Private Constants
  699. * @{
  700. */
  701. /**
  702. * @}
  703. */
  704. /* Private macros ------------------------------------------------------------*/
  705. /** @defgroup FLASH_Private_Macros FLASH Private Macros
  706. * @{
  707. */
  708. #if defined (FLASH_OPTCR_PG_OTP)
  709. #define IS_FLASH_TYPEPROGRAM(VALUE) (((VALUE) == FLASH_TYPEPROGRAM_FLASHWORD) || \
  710. ((VALUE) == FLASH_TYPEPROGRAM_OTPWORD))
  711. #else
  712. #define IS_FLASH_TYPEPROGRAM(VALUE) ((VALUE) == FLASH_TYPEPROGRAM_FLASHWORD)
  713. #endif /* FLASH_OPTCR_PG_OTP */
  714. #define IS_FLASH_IT_BANK1(IT) (((IT) & FLASH_IT_ALL_BANK1) == (IT))
  715. #if defined (DUAL_BANK)
  716. #define IS_FLASH_IT_BANK2(IT) (((IT) & FLASH_IT_ALL_BANK2) == (IT))
  717. #endif /* DUAL_BANK */
  718. #define IS_FLASH_FLAG_BANK1(FLAG) (((FLAG) & FLASH_FLAG_ALL_BANK1) == (FLAG))
  719. #if defined (DUAL_BANK)
  720. #define IS_FLASH_FLAG_BANK2(FLAG) (((FLAG) & FLASH_FLAG_ALL_BANK2) == (FLAG))
  721. #endif /* DUAL_BANK */
  722. #if defined (DUAL_BANK)
  723. #define IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS) (((ADDRESS) >= FLASH_BANK1_BASE) && ((ADDRESS) < FLASH_BANK2_BASE))
  724. #define IS_FLASH_PROGRAM_ADDRESS_BANK2(ADDRESS) (((ADDRESS) >= FLASH_BANK2_BASE ) && ((ADDRESS) <= FLASH_END))
  725. #else
  726. #define IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS) (((ADDRESS) >= FLASH_BANK1_BASE) && ((ADDRESS) <= FLASH_END))
  727. #endif /* DUAL_BANK */
  728. #if defined (DUAL_BANK)
  729. #if defined (FLASH_OPTCR_PG_OTP)
  730. #define IS_FLASH_PROGRAM_ADDRESS_OTP(ADDRESS) (((ADDRESS) >= 0x08FFF000U) && ((ADDRESS) <= 0x08FFF3FFU))
  731. #define IS_FLASH_PROGRAM_ADDRESS(ADDRESS) (IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS) || \
  732. IS_FLASH_PROGRAM_ADDRESS_BANK2(ADDRESS) || \
  733. IS_FLASH_PROGRAM_ADDRESS_OTP(ADDRESS))
  734. #else
  735. #define IS_FLASH_PROGRAM_ADDRESS(ADDRESS) (IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS) || \
  736. IS_FLASH_PROGRAM_ADDRESS_BANK2(ADDRESS))
  737. #endif /* FLASH_OPTCR_PG_OTP */
  738. #else
  739. #if defined (FLASH_OPTCR_PG_OTP)
  740. #define IS_FLASH_PROGRAM_ADDRESS_OTP(ADDRESS) (((ADDRESS) >= 0x08FFF000U) && ((ADDRESS) <= 0x08FFF3FFU))
  741. #define IS_FLASH_PROGRAM_ADDRESS(ADDRESS) (IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS) || \
  742. IS_FLASH_PROGRAM_ADDRESS_OTP(ADDRESS))
  743. #else
  744. #define IS_FLASH_PROGRAM_ADDRESS(ADDRESS) (IS_FLASH_PROGRAM_ADDRESS_BANK1(ADDRESS))
  745. #endif /* FLASH_OPTCR_PG_OTP */
  746. #endif /* DUAL_BANK */
  747. #define IS_BOOT_ADDRESS(ADDRESS) ((ADDRESS) <= (0x3FFF0000U))
  748. #if defined (DUAL_BANK)
  749. #define IS_FLASH_BANK(BANK) (((BANK) == FLASH_BANK_1) || \
  750. ((BANK) == FLASH_BANK_2) || \
  751. ((BANK) == FLASH_BANK_BOTH))
  752. #define IS_FLASH_BANK_EXCLUSIVE(BANK) (((BANK) == FLASH_BANK_1) || \
  753. ((BANK) == FLASH_BANK_2))
  754. #else
  755. #define IS_FLASH_BANK(BANK) ((BANK) == FLASH_BANK_1)
  756. #define IS_FLASH_BANK_EXCLUSIVE(BANK) ((BANK) == FLASH_BANK_1)
  757. #endif /* DUAL_BANK */
  758. /**
  759. * @}
  760. */
  761. /* Private functions ---------------------------------------------------------*/
  762. /** @defgroup FLASH_Private_Functions FLASH Private functions
  763. * @{
  764. */
  765. HAL_StatusTypeDef FLASH_WaitForLastOperation(uint32_t Timeout, uint32_t Bank);
  766. HAL_StatusTypeDef FLASH_OB_WaitForLastOperation(uint32_t Timeout);
  767. HAL_StatusTypeDef FLASH_CRC_WaitForLastOperation(uint32_t Timeout, uint32_t Bank);
  768. /**
  769. * @}
  770. */
  771. /**
  772. * @}
  773. */
  774. /**
  775. * @}
  776. */
  777. #ifdef __cplusplus
  778. }
  779. #endif
  780. #endif /* STM32H7xx_HAL_FLASH_H */