You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

911 lines
39 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32H7xx_hal_flash_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of FLASH HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics.
  10. * All rights reserved.</center></h2>
  11. *
  12. * This software component is licensed by ST under BSD 3-Clause license,
  13. * the "License"; You may not use this file except in compliance with the
  14. * License. You may obtain a copy of the License at:
  15. * opensource.org/licenses/BSD-3-Clause
  16. *
  17. ******************************************************************************
  18. */
  19. /* Define to prevent recursive inclusion -------------------------------------*/
  20. #ifndef STM32H7xx_HAL_FLASH_EX_H
  21. #define STM32H7xx_HAL_FLASH_EX_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /* Includes ------------------------------------------------------------------*/
  26. #include "stm32h7xx_hal_def.h"
  27. /** @addtogroup STM32H7xx_HAL_Driver
  28. * @{
  29. */
  30. /** @addtogroup FLASHEx
  31. * @{
  32. */
  33. /* Exported types ------------------------------------------------------------*/
  34. /** @defgroup FLASHEx_Exported_Types FLASH Exported Types
  35. * @{
  36. */
  37. /**
  38. * @brief FLASH Erase structure definition
  39. */
  40. typedef struct
  41. {
  42. uint32_t TypeErase; /*!< Mass erase or sector Erase.
  43. This parameter can be a value of @ref FLASHEx_Type_Erase */
  44. uint32_t Banks; /*!< Select banks to erase when Mass erase is enabled.
  45. This parameter must be a value of @ref FLASHEx_Banks */
  46. uint32_t Sector; /*!< Initial FLASH sector to erase when Mass erase is disabled
  47. This parameter must be a value of @ref FLASH_Sectors */
  48. uint32_t NbSectors; /*!< Number of sectors to be erased.
  49. This parameter must be a value between 1 and (max number of sectors - value of Initial sector)*/
  50. uint32_t VoltageRange;/*!< The device voltage range which defines the erase parallelism
  51. This parameter must be a value of @ref FLASHEx_Voltage_Range */
  52. } FLASH_EraseInitTypeDef;
  53. /**
  54. * @brief FLASH Option Bytes Program structure definition
  55. */
  56. typedef struct
  57. {
  58. uint32_t OptionType; /*!< Option byte to be configured.
  59. This parameter can be a value of @ref FLASHEx_Option_Type */
  60. uint32_t WRPState; /*!< Write protection activation or deactivation.
  61. This parameter can be a value of @ref FLASHEx_WRP_State */
  62. uint32_t WRPSector; /*!< Specifies the sector(s) to be write protected.
  63. The value of this parameter depend on device used within the same series */
  64. uint32_t RDPLevel; /*!< Set the read protection level.
  65. This parameter can be a value of @ref FLASHEx_Option_Bytes_Read_Protection */
  66. uint32_t BORLevel; /*!< Set the BOR Level.
  67. This parameter can be a value of @ref FLASHEx_BOR_Reset_Level */
  68. uint32_t USERType; /*!< User option byte(s) to be configured (used for OPTIONBYTE_USER).
  69. This parameter can be a combination of @ref FLASHEx_OB_USER_Type */
  70. uint32_t USERConfig; /*!< Program the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY /
  71. IWDG_FREEZE_STOP / IWDG_FREEZE_SANDBY / IO_HSLV / SWAP_BANK_OPT */
  72. uint32_t Banks; /*!< Select banks for WRP , PCROP and secure area config .
  73. This parameter must be a value of @ref FLASHEx_Banks */
  74. uint32_t PCROPConfig; /*!< specifies if the PCROP area shall be erased or not
  75. when RDP level decreased from Level 1 to Level 0 or during a mass erase.
  76. This parameter must be a value of @ref FLASHEx_OB_PCROP_RDP enumeration */
  77. uint32_t PCROPStartAddr; /*!< PCROP Start address (used for OPTIONBYTE_PCROP).
  78. This parameter must be a value between begin and end of a bank */
  79. uint32_t PCROPEndAddr; /*!< PCROP End address (used for OPTIONBYTE_PCROP).
  80. This parameter must be a value between PCROP Start address and end of a bank */
  81. uint32_t BootConfig; /*!< Specifies if the Boot Address to be configured BOOT_ADD0, BOOT_ADD1
  82. or both. This parameter must be a value of @ref FLASHEx_OB_BOOT_OPTION enumeration */
  83. uint32_t BootAddr0; /*!< Boot Address 0.
  84. This parameter must be a value between begin and end of a bank */
  85. uint32_t BootAddr1; /*!< Boot Address 1.
  86. This parameter must be a value between begin and end of a bank */
  87. #if defined(DUAL_CORE)
  88. uint32_t CM4BootConfig; /*!< specifies if the CM4 boot Address to be configured BOOT_ADD0, BOOT_ADD1
  89. or both.
  90. This parameter must be a value of @ref FLASHEx_OB_BOOT_OPTION enumeration */
  91. uint32_t CM4BootAddr0; /*!< CM4 Boot Address 0.
  92. This parameter must be a value between begin and end of a bank */
  93. uint32_t CM4BootAddr1; /*!< CM4 Boot Address 1.
  94. This parameter must be a value between begin and end of a bank */
  95. #endif /*DUAL_CORE*/
  96. uint32_t SecureAreaConfig; /*!< specifies if the bank secured area shall be erased or not
  97. when RDP level decreased from Level 1 to Level 0 or during a mass erase.
  98. This parameter must be a value of @ref FLASHEx_OB_SECURE_RDP enumeration */
  99. uint32_t SecureAreaStartAddr; /*!< Bank Secure area Start address.
  100. This parameter must be a value between begin address and end address of bank1 */
  101. uint32_t SecureAreaEndAddr; /*!< Bank Secure area End address.
  102. This parameter must be a value between Secure Area Start address and end address of a bank1 */
  103. #if defined (FLASH_OTPBL_LOCKBL)
  104. uint32_t OTPBlockLock; /*!< Specifies the OTP block(s) to be locked.
  105. This parameter must be a value of @ref FLASHEx_OTP_Blocks */
  106. #endif /* FLASH_OTPBL_LOCKBL */
  107. } FLASH_OBProgramInitTypeDef;
  108. /**
  109. * @brief FLASH Erase structure definition
  110. */
  111. typedef struct
  112. {
  113. uint32_t TypeCRC; /*!< CRC Selection Type.
  114. This parameter can be a value of @ref FLASHEx_CRC_Selection_Type */
  115. uint32_t BurstSize; /*!< CRC Burst Size.
  116. This parameter can be a value of @ref FLASHEx_CRC_Burst_Size */
  117. uint32_t Bank; /*!< Select bank where CRC computation is enabled.
  118. This parameter must be FLASH_BANK_1 or FLASH_BANK_2 */
  119. uint32_t Sector; /*!< Initial FLASH sector from which starts the CRC computation
  120. This parameter must be a value of @ref FLASH_Sectors */
  121. uint32_t NbSectors; /*!< Number of sectors to be computed.
  122. This parameter must be a value between 1 and (max number of sectors - value of Initial sector)*/
  123. uint32_t CRCStartAddr; /*!< CRC Start address.
  124. This parameter must be a value between begin address and end address of a bank */
  125. uint32_t CRCEndAddr; /*!< CRC End address.
  126. This parameter must be a value between CRC Start address and end address of a bank */
  127. } FLASH_CRCInitTypeDef;
  128. /**
  129. * @}
  130. */
  131. /* Exported constants --------------------------------------------------------*/
  132. /** @defgroup FLASHEx_Exported_Constants FLASH Exported Constants
  133. * @{
  134. */
  135. /** @defgroup FLASHEx_Type_Erase FLASH Type Erase
  136. * @{
  137. */
  138. #define FLASH_TYPEERASE_SECTORS 0x00U /*!< Sectors erase only */
  139. #define FLASH_TYPEERASE_MASSERASE 0x01U /*!< Flash Mass erase activation */
  140. /**
  141. * @}
  142. */
  143. #if defined (FLASH_CR_PSIZE)
  144. /** @defgroup FLASHEx_Voltage_Range FLASH Voltage Range
  145. * @{
  146. */
  147. #define FLASH_VOLTAGE_RANGE_1 0x00000000U /*!< Flash program/erase by 8 bits */
  148. #define FLASH_VOLTAGE_RANGE_2 FLASH_CR_PSIZE_0 /*!< Flash program/erase by 16 bits */
  149. #define FLASH_VOLTAGE_RANGE_3 FLASH_CR_PSIZE_1 /*!< Flash program/erase by 32 bits */
  150. #define FLASH_VOLTAGE_RANGE_4 FLASH_CR_PSIZE /*!< Flash program/erase by 64 bits */
  151. /**
  152. * @}
  153. */
  154. #endif /* FLASH_CR_PSIZE */
  155. /** @defgroup FLASHEx_WRP_State FLASH WRP State
  156. * @{
  157. */
  158. #define OB_WRPSTATE_DISABLE 0x00000000U /*!< Disable the write protection of the desired bank 1 sectors */
  159. #define OB_WRPSTATE_ENABLE 0x00000001U /*!< Enable the write protection of the desired bank 1 sectors */
  160. /**
  161. * @}
  162. */
  163. /** @defgroup FLASHEx_Option_Type FLASH Option Type
  164. * @{
  165. */
  166. #define OPTIONBYTE_WRP 0x01U /*!< WRP option byte configuration */
  167. #define OPTIONBYTE_RDP 0x02U /*!< RDP option byte configuration */
  168. #define OPTIONBYTE_USER 0x04U /*!< USER option byte configuration */
  169. #define OPTIONBYTE_PCROP 0x08U /*!< PCROP option byte configuration */
  170. #define OPTIONBYTE_BOR 0x10U /*!< BOR option byte configuration */
  171. #define OPTIONBYTE_SECURE_AREA 0x20U /*!< secure area option byte configuration */
  172. #if defined (DUAL_CORE)
  173. #define OPTIONBYTE_CM7_BOOTADD 0x40U /*!< CM7 BOOT ADD option byte configuration */
  174. #define OPTIONBYTE_CM4_BOOTADD 0x80U /*!< CM4 BOOT ADD option byte configuration */
  175. #define OPTIONBYTE_BOOTADD OPTIONBYTE_CM7_BOOTADD /*!< BOOT ADD option byte configuration */
  176. #else /* Single core */
  177. #define OPTIONBYTE_BOOTADD 0x40U /*!< BOOT ADD option byte configuration */
  178. #endif /*DUAL_CORE*/
  179. #if defined (FLASH_OTPBL_LOCKBL)
  180. #define OPTIONBYTE_OTP_LOCK 0x80U /*!< OTP Lock option byte configuration */
  181. #endif /* FLASH_OTPBL_LOCKBL */
  182. /**
  183. * @}
  184. */
  185. /** @defgroup FLASHEx_Option_Bytes_Read_Protection FLASH Option Bytes Read Protection
  186. * @{
  187. */
  188. #define OB_RDP_LEVEL_0 0xAA00U
  189. #define OB_RDP_LEVEL_1 0x5500U
  190. #define OB_RDP_LEVEL_2 0xCC00U /*!< Warning: When enabling read protection level 2
  191. it s no more possible to go back to level 1 or 0 */
  192. /**
  193. * @}
  194. */
  195. /** @defgroup FLASHEx_Option_Bytes_WWatchdog FLASH Option Bytes WWatchdog
  196. * @{
  197. */
  198. #define OB_WWDG_SW 0x10U /*!< Software WWDG selected */
  199. #define OB_WWDG_HW 0x00U /*!< Hardware WWDG selected */
  200. /**
  201. * @}
  202. */
  203. /** @defgroup FLASHEx_Option_Bytes_IWatchdog FLASH Option Bytes IWatchdog
  204. * @{
  205. */
  206. #define OB_IWDG_SW 0x20U /*!< Software IWDG selected */
  207. #define OB_IWDG_HW 0x00U /*!< Hardware IWDG selected */
  208. /**
  209. * @}
  210. */
  211. /** @defgroup FLASHEx_Option_Bytes_nRST_STOP FLASH Option Bytes nRST_STOP
  212. * @{
  213. */
  214. #define OB_STOP_NO_RST 0x40U /*!< No reset generated when entering in STOP */
  215. #define OB_STOP_RST 0x00U /*!< Reset generated when entering in STOP */
  216. /**
  217. * @}
  218. */
  219. /** @defgroup FLASHEx_Option_Bytes_nRST_STDBY FLASH Option Bytes nRST_STDBY
  220. * @{
  221. */
  222. #define OB_STDBY_NO_RST 0x80U /*!< No reset generated when entering in STANDBY */
  223. #define OB_STDBY_RST 0x00U /*!< Reset generated when entering in STANDBY */
  224. /**
  225. * @}
  226. */
  227. /** @defgroup FLASHEx_Option_Bytes_IWDG_FREEZE_STOP FLASH IWDG Counter Freeze in STOP
  228. * @{
  229. */
  230. #define OB_IWDG_STOP_FREEZE 0x00000000U /*!< Freeze IWDG counter in STOP mode */
  231. #define OB_IWDG_STOP_ACTIVE FLASH_OPTSR_FZ_IWDG_STOP /*!< IWDG counter active in STOP mode */
  232. /**
  233. * @}
  234. */
  235. /** @defgroup FLASHEx_Option_Bytes_IWDG_FREEZE_SANDBY FLASH IWDG Counter Freeze in STANDBY
  236. * @{
  237. */
  238. #define OB_IWDG_STDBY_FREEZE 0x00000000U /*!< Freeze IWDG counter in STANDBY mode */
  239. #define OB_IWDG_STDBY_ACTIVE FLASH_OPTSR_FZ_IWDG_SDBY /*!< IWDG counter active in STANDBY mode */
  240. /**
  241. * @}
  242. */
  243. /** @defgroup FLASHEx_BOR_Reset_Level FLASH BOR Reset Level
  244. * @{
  245. */
  246. #define OB_BOR_LEVEL0 0x00000000U /*!< Reset level threshold is set to 1.6V */
  247. #define OB_BOR_LEVEL1 FLASH_OPTSR_BOR_LEV_0 /*!< Reset level threshold is set to 2.1V */
  248. #define OB_BOR_LEVEL2 FLASH_OPTSR_BOR_LEV_1 /*!< Reset level threshold is set to 2.4V */
  249. #define OB_BOR_LEVEL3 (FLASH_OPTSR_BOR_LEV_1 | FLASH_OPTSR_BOR_LEV_0) /*!< Reset level threshold is set to 2.7V */
  250. /**
  251. * @}
  252. */
  253. /** @defgroup FLASHEx_Boot_Address FLASH Boot Address
  254. * @{
  255. */
  256. #define OB_BOOTADDR_ITCM_RAM 0x0000U /*!< Boot from ITCM RAM (0x00000000) */
  257. #define OB_BOOTADDR_SYSTEM 0x0040U /*!< Boot from System memory bootloader (0x00100000) */
  258. #define OB_BOOTADDR_ITCM_FLASH 0x0080U /*!< Boot from Flash on ITCM interface (0x00200000) */
  259. #define OB_BOOTADDR_AXIM_FLASH 0x2000U /*!< Boot from Flash on AXIM interface (0x08000000) */
  260. #define OB_BOOTADDR_DTCM_RAM 0x8000U /*!< Boot from DTCM RAM (0x20000000) */
  261. #define OB_BOOTADDR_SRAM1 0x8004U /*!< Boot from SRAM1 (0x20010000) */
  262. #define OB_BOOTADDR_SRAM2 0x8013U /*!< Boot from SRAM2 (0x2004C000) */
  263. /**
  264. * @}
  265. */
  266. /** @defgroup FLASH_Latency FLASH Latency
  267. * @{
  268. */
  269. #define FLASH_LATENCY_0 FLASH_ACR_LATENCY_0WS /*!< FLASH Zero Latency cycle */
  270. #define FLASH_LATENCY_1 FLASH_ACR_LATENCY_1WS /*!< FLASH One Latency cycle */
  271. #define FLASH_LATENCY_2 FLASH_ACR_LATENCY_2WS /*!< FLASH Two Latency cycles */
  272. #define FLASH_LATENCY_3 FLASH_ACR_LATENCY_3WS /*!< FLASH Three Latency cycles */
  273. #define FLASH_LATENCY_4 FLASH_ACR_LATENCY_4WS /*!< FLASH Four Latency cycles */
  274. #define FLASH_LATENCY_5 FLASH_ACR_LATENCY_5WS /*!< FLASH Five Latency cycles */
  275. #define FLASH_LATENCY_6 FLASH_ACR_LATENCY_6WS /*!< FLASH Six Latency cycles */
  276. #define FLASH_LATENCY_7 FLASH_ACR_LATENCY_7WS /*!< FLASH Seven Latency cycles */
  277. #define FLASH_LATENCY_8 FLASH_ACR_LATENCY_8WS /*!< FLASH Eight Latency cycle */
  278. #define FLASH_LATENCY_9 FLASH_ACR_LATENCY_9WS /*!< FLASH Nine Latency cycle */
  279. #define FLASH_LATENCY_10 FLASH_ACR_LATENCY_10WS /*!< FLASH Ten Latency cycles */
  280. #define FLASH_LATENCY_11 FLASH_ACR_LATENCY_11WS /*!< FLASH Eleven Latency cycles */
  281. #define FLASH_LATENCY_12 FLASH_ACR_LATENCY_12WS /*!< FLASH Twelve Latency cycles */
  282. #define FLASH_LATENCY_13 FLASH_ACR_LATENCY_13WS /*!< FLASH Thirteen Latency cycles */
  283. #define FLASH_LATENCY_14 FLASH_ACR_LATENCY_14WS /*!< FLASH Fourteen Latency cycles */
  284. #define FLASH_LATENCY_15 FLASH_ACR_LATENCY_15WS /*!< FLASH Fifteen Latency cycles */
  285. /**
  286. * @}
  287. */
  288. /** @defgroup FLASHEx_Banks FLASH Banks
  289. * @{
  290. */
  291. #define FLASH_BANK_1 0x01U /*!< Bank 1 */
  292. #define FLASH_BANK_2 0x02U /*!< Bank 2 */
  293. #define FLASH_BANK_BOTH (FLASH_BANK_1 | FLASH_BANK_2) /*!< Bank1 and Bank2 */
  294. /**
  295. * @}
  296. */
  297. /** @defgroup FLASHEx_OB_PCROP_RDP FLASHEx OB PCROP RDP
  298. * @{
  299. */
  300. #define OB_PCROP_RDP_NOT_ERASE 0x00000000U /*!< PCROP area is not erased when the RDP level
  301. is decreased from Level 1 to Level 0 or during a mass erase */
  302. #define OB_PCROP_RDP_ERASE FLASH_PRAR_DMEP /*!< PCROP area is erased when the RDP level is
  303. decreased from Level 1 to Level 0 (full mass erase) */
  304. /**
  305. * @}
  306. */
  307. /** @defgroup FLASHEx_Option_Bytes_Write_Protection FLASH Option Bytes Write Protection
  308. * @{
  309. */
  310. #if (FLASH_SECTOR_TOTAL == 128)
  311. #define OB_WRP_SECTOR_0TO3 0x00000001U /*!< Write protection of Sector0 to Sector3 */
  312. #define OB_WRP_SECTOR_4TO7 0x00000002U /*!< Write protection of Sector4 to Sector7 */
  313. #define OB_WRP_SECTOR_8TO11 0x00000004U /*!< Write protection of Sector8 to Sector11 */
  314. #define OB_WRP_SECTOR_12TO15 0x00000008U /*!< Write protection of Sector12 to Sector15 */
  315. #define OB_WRP_SECTOR_16TO19 0x00000010U /*!< Write protection of Sector16 to Sector19 */
  316. #define OB_WRP_SECTOR_20TO23 0x00000020U /*!< Write protection of Sector20 to Sector23 */
  317. #define OB_WRP_SECTOR_24TO27 0x00000040U /*!< Write protection of Sector24 to Sector27 */
  318. #define OB_WRP_SECTOR_28TO31 0x00000080U /*!< Write protection of Sector28 to Sector31 */
  319. #define OB_WRP_SECTOR_32TO35 0x00000100U /*!< Write protection of Sector32 to Sector35 */
  320. #define OB_WRP_SECTOR_36TO39 0x00000200U /*!< Write protection of Sector36 to Sector39 */
  321. #define OB_WRP_SECTOR_40TO43 0x00000400U /*!< Write protection of Sector40 to Sector43 */
  322. #define OB_WRP_SECTOR_44TO47 0x00000800U /*!< Write protection of Sector44 to Sector47 */
  323. #define OB_WRP_SECTOR_48TO51 0x00001000U /*!< Write protection of Sector48 to Sector51 */
  324. #define OB_WRP_SECTOR_52TO55 0x00002000U /*!< Write protection of Sector52 to Sector55 */
  325. #define OB_WRP_SECTOR_56TO59 0x00004000U /*!< Write protection of Sector56 to Sector59 */
  326. #define OB_WRP_SECTOR_60TO63 0x00008000U /*!< Write protection of Sector60 to Sector63 */
  327. #define OB_WRP_SECTOR_64TO67 0x00010000U /*!< Write protection of Sector64 to Sector67 */
  328. #define OB_WRP_SECTOR_68TO71 0x00020000U /*!< Write protection of Sector68 to Sector71 */
  329. #define OB_WRP_SECTOR_72TO75 0x00040000U /*!< Write protection of Sector72 to Sector75 */
  330. #define OB_WRP_SECTOR_76TO79 0x00080000U /*!< Write protection of Sector76 to Sector79 */
  331. #define OB_WRP_SECTOR_80TO83 0x00100000U /*!< Write protection of Sector80 to Sector83 */
  332. #define OB_WRP_SECTOR_84TO87 0x00200000U /*!< Write protection of Sector84 to Sector87 */
  333. #define OB_WRP_SECTOR_88TO91 0x00400000U /*!< Write protection of Sector88 to Sector91 */
  334. #define OB_WRP_SECTOR_92TO95 0x00800000U /*!< Write protection of Sector92 to Sector95 */
  335. #define OB_WRP_SECTOR_96TO99 0x01000000U /*!< Write protection of Sector96 to Sector99 */
  336. #define OB_WRP_SECTOR_100TO103 0x02000000U /*!< Write protection of Sector100 to Sector103 */
  337. #define OB_WRP_SECTOR_104TO107 0x04000000U /*!< Write protection of Sector104 to Sector107 */
  338. #define OB_WRP_SECTOR_108TO111 0x08000000U /*!< Write protection of Sector108 to Sector111 */
  339. #define OB_WRP_SECTOR_112TO115 0x10000000U /*!< Write protection of Sector112 to Sector115 */
  340. #define OB_WRP_SECTOR_116TO119 0x20000000U /*!< Write protection of Sector116 to Sector119 */
  341. #define OB_WRP_SECTOR_120TO123 0x40000000U /*!< Write protection of Sector120 to Sector123 */
  342. #define OB_WRP_SECTOR_124TO127 0x80000000U /*!< Write protection of Sector124 to Sector127 */
  343. #define OB_WRP_SECTOR_ALL 0xFFFFFFFFU /*!< Write protection of all Sectors */
  344. #else
  345. #define OB_WRP_SECTOR_0 0x00000001U /*!< Write protection of Sector0 */
  346. #define OB_WRP_SECTOR_1 0x00000002U /*!< Write protection of Sector1 */
  347. #define OB_WRP_SECTOR_2 0x00000004U /*!< Write protection of Sector2 */
  348. #define OB_WRP_SECTOR_3 0x00000008U /*!< Write protection of Sector3 */
  349. #define OB_WRP_SECTOR_4 0x00000010U /*!< Write protection of Sector4 */
  350. #define OB_WRP_SECTOR_5 0x00000020U /*!< Write protection of Sector5 */
  351. #define OB_WRP_SECTOR_6 0x00000040U /*!< Write protection of Sector6 */
  352. #define OB_WRP_SECTOR_7 0x00000080U /*!< Write protection of Sector7 */
  353. #define OB_WRP_SECTOR_ALL 0x000000FFU /*!< Write protection of all Sectors */
  354. #endif /* FLASH_SECTOR_TOTAL == 128 */
  355. /**
  356. * @}
  357. */
  358. /** @defgroup FLASHEx_OB_SECURITY FLASHEx OB SECURITY
  359. * @{
  360. */
  361. #define OB_SECURITY_DISABLE 0x00000000U /*!< security enabled */
  362. #define OB_SECURITY_ENABLE FLASH_OPTSR_SECURITY /*!< security disabled */
  363. /**
  364. * @}
  365. */
  366. /** @defgroup FLASHEx_OB_ST_RAM_SIZE FLASHEx OB ST RAM SIZE
  367. * @{
  368. */
  369. #define OB_ST_RAM_SIZE_2KB 0x00000000U /*!< 2 Kbytes reserved to ST code */
  370. #define OB_ST_RAM_SIZE_4KB FLASH_OPTSR_ST_RAM_SIZE_0 /*!< 4 Kbytes reserved to ST code */
  371. #define OB_ST_RAM_SIZE_8KB FLASH_OPTSR_ST_RAM_SIZE_1 /*!< 8 Kbytes reserved to ST code */
  372. #define OB_ST_RAM_SIZE_16KB FLASH_OPTSR_ST_RAM_SIZE /*!< 16 Kbytes reserved to ST code */
  373. /**
  374. * @}
  375. */
  376. #if defined(DUAL_CORE)
  377. /** @defgroup FLASHEx_OB_BCM7 FLASHEx OB BCM7
  378. * @{
  379. */
  380. #define OB_BCM7_DISABLE 0x00000000U /*!< CM7 Boot disabled */
  381. #define OB_BCM7_ENABLE FLASH_OPTSR_BCM7 /*!< CM7 Boot enabled */
  382. /**
  383. * @}
  384. */
  385. /** @defgroup FLASHEx_OB_BCM4 FLASHEx OB BCM4
  386. * @{
  387. */
  388. #define OB_BCM4_DISABLE 0x00000000U /*!< CM4 Boot disabled */
  389. #define OB_BCM4_ENABLE FLASH_OPTSR_BCM4 /*!< CM4 Boot enabled */
  390. /**
  391. * @}
  392. */
  393. #endif /* DUAL_CORE */
  394. /** @defgroup FLASHEx_OB_IWDG1_SW FLASHEx OB IWDG1 SW
  395. * @{
  396. */
  397. #define OB_IWDG1_SW FLASH_OPTSR_IWDG1_SW /*!< Hardware independent watchdog 1 */
  398. #define OB_IWDG1_HW 0x00000000U /*!< Software independent watchdog 1 */
  399. /**
  400. * @}
  401. */
  402. #if defined(DUAL_CORE)
  403. /** @defgroup FLASHEx_OB_IWDG2_SW FLASHEx OB IWDG2 SW
  404. * @{
  405. */
  406. #define OB_IWDG2_SW FLASH_OPTSR_IWDG2_SW /*!< Hardware independent watchdog 2*/
  407. #define OB_IWDG2_HW 0x00000000U /*!< Software independent watchdog 2*/
  408. /**
  409. * @}
  410. */
  411. #endif
  412. /** @defgroup FLASHEx_OB_NRST_STOP_D1 FLASHEx OB NRST STOP D1
  413. * @{
  414. */
  415. #define OB_STOP_RST_D1 0x00000000U /*!< Reset generated when entering the D1 to stop mode */
  416. #define OB_STOP_NO_RST_D1 FLASH_OPTSR_NRST_STOP_D1 /*!< No reset generated when entering the D1 to stop mode */
  417. /**
  418. * @}
  419. */
  420. /** @defgroup FLASHEx_OB_NRST_STDBY_D1 FLASHEx OB NRST STDBY D1
  421. * @{
  422. */
  423. #define OB_STDBY_RST_D1 0x00000000U /*!< Reset generated when entering the D1 to standby mode */
  424. #define OB_STDBY_NO_RST_D1 FLASH_OPTSR_NRST_STBY_D1 /*!< No reset generated when entering the D1 to standby mode */
  425. /**
  426. * @}
  427. */
  428. #if defined (DUAL_CORE)
  429. /** @defgroup FLASHEx_OB_NRST_STOP_D2 FLASHEx OB NRST STOP D2
  430. * @{
  431. */
  432. #define OB_STOP_RST_D2 0x00000000U /*!< Reset generated when entering the D2 to stop mode */
  433. #define OB_STOP_NO_RST_D2 FLASH_OPTSR_NRST_STOP_D2 /*!< No reset generated when entering the D2 to stop mode */
  434. /**
  435. * @}
  436. */
  437. /** @defgroup FLASHEx_OB_NRST_STDBY_D2 FLASHEx OB NRST STDBY D2
  438. * @{
  439. */
  440. #define OB_STDBY_RST_D2 0x00000000U /*!< Reset generated when entering the D2 to standby mode */
  441. #define OB_STDBY_NO_RST_D2 FLASH_OPTSR_NRST_STBY_D2 /*!< No reset generated when entering the D2 to standby mode */
  442. /**
  443. * @}
  444. */
  445. #endif /* DUAL_CORE */
  446. /** @defgroup FLASHEx_OB_SWAP_BANK FLASHEx OB SWAP BANK
  447. * @{
  448. */
  449. #define OB_SWAP_BANK_DISABLE 0x00000000U /*!< Bank swap disabled */
  450. #define OB_SWAP_BANK_ENABLE FLASH_OPTSR_SWAP_BANK_OPT /*!< Bank swap enabled */
  451. /**
  452. * @}
  453. */
  454. /** @defgroup FLASHEx_OB_IOHSLV FLASHEx OB IOHSLV
  455. * @{
  456. */
  457. #define OB_IOHSLV_DISABLE 0x00000000U /*!< IOHSLV disabled */
  458. #define OB_IOHSLV_ENABLE FLASH_OPTSR_IO_HSLV /*!< IOHSLV enabled */
  459. /**
  460. * @}
  461. */
  462. #if defined (FLASH_OPTSR_VDDMMC_HSLV)
  463. /** @defgroup FLASHEx_OB_VDDMMC_HSLV FLASHEx OB VDDMMC HSLV
  464. * @{
  465. */
  466. #define OB_VDDMMC_HSLV_DISABLE 0x00000000U /*!< VDDMMC HSLV disabled */
  467. #define OB_VDDMMC_HSLV_ENABLE FLASH_OPTSR_VDDMMC_HSLV /*!< VDDMMC HSLV enabled */
  468. /**
  469. * @}
  470. */
  471. #endif /* FLASH_OPTSR_VDDMMC_HSLV */
  472. /** @defgroup FLASHEx_OB_BOOT_OPTION FLASHEx OB BOOT OPTION
  473. * @{
  474. */
  475. #define OB_BOOT_ADD0 0x01U /*!< Select Boot Address 0 */
  476. #define OB_BOOT_ADD1 0x02U /*!< Select Boot Address 1 */
  477. #define OB_BOOT_ADD_BOTH 0x03U /*!< Select Boot Address 0 and 1 */
  478. /**
  479. * @}
  480. */
  481. /** @defgroup FLASHEx_OB_USER_Type FLASHEx OB USER Type
  482. * @{
  483. */
  484. #define OB_USER_IWDG1_SW 0x0001U /*!< Independent watchdog selection */
  485. #define OB_USER_NRST_STOP_D1 0x0002U /*!< Reset when entering Stop mode selection*/
  486. #define OB_USER_NRST_STDBY_D1 0x0004U /*!< Reset when entering standby mode selection*/
  487. #define OB_USER_IWDG_STOP 0x0008U /*!< Independent watchdog counter freeze in stop mode */
  488. #define OB_USER_IWDG_STDBY 0x0010U /*!< Independent watchdog counter freeze in standby mode */
  489. #define OB_USER_ST_RAM_SIZE 0x0020U /*!< dedicated DTCM Ram size selection */
  490. #define OB_USER_SECURITY 0x0040U /*!< security selection */
  491. #define OB_USER_IOHSLV 0x0080U /*!< IO HSLV selection */
  492. #define OB_USER_SWAP_BANK 0x0100U /*!< Bank swap selection */
  493. #if defined (FLASH_OPTSR_VDDMMC_HSLV)
  494. #define OB_USER_VDDMMC_HSLV 0x0200U /*!< VDDMMC HSLV selection */
  495. #endif /* FLASH_OPTSR_VDDMMC_HSLV */
  496. #if defined (DUAL_CORE)
  497. #define OB_USER_IWDG2_SW 0x0200U /*!< Window watchdog selection */
  498. #define OB_USER_BCM4 0x0400U /*!< CM4 boot selection */
  499. #define OB_USER_BCM7 0x0800U /*!< CM7 boot selection */
  500. #define OB_USER_NRST_STOP_D2 0x1000U /*!< Reset when entering Stop mode selection*/
  501. #define OB_USER_NRST_STDBY_D2 0x2000U /*!< Reset when entering standby mode selection*/
  502. #endif /*DUAL_CORE*/
  503. /**
  504. * @}
  505. */
  506. /** @defgroup FLASHEx_OB_SECURE_RDP FLASHEx OB SECURE RDP
  507. * @{
  508. */
  509. #define OB_SECURE_RDP_NOT_ERASE 0x00000000U /*!< Secure area is not erased when the RDP level
  510. is decreased from Level 1 to Level 0 or during a mass erase */
  511. #define OB_SECURE_RDP_ERASE FLASH_SCAR_DMES /*!< Secure area is erased when the RDP level is
  512. decreased from Level 1 to Level 0 (full mass erase) */
  513. /**
  514. * @}
  515. */
  516. /** @defgroup FLASHEx_CRC_Selection_Type FLASH CRC Selection Type
  517. * @{
  518. */
  519. #define FLASH_CRC_ADDR 0x00000000U /*!< CRC selection type by address */
  520. #define FLASH_CRC_SECTORS FLASH_CRCCR_CRC_BY_SECT /*!< CRC selection type by sectors */
  521. #define FLASH_CRC_BANK (FLASH_CRCCR_ALL_BANK | FLASH_CRCCR_CRC_BY_SECT) /*!< CRC selection type by bank */
  522. /**
  523. * @}
  524. */
  525. /** @defgroup FLASHEx_CRC_Burst_Size FLASH CRC Burst Size
  526. * @{
  527. */
  528. #define FLASH_CRC_BURST_SIZE_4 0x00000000U /*!< Every burst has a size of 4 Flash words (256-bit) */
  529. #define FLASH_CRC_BURST_SIZE_16 FLASH_CRCCR_CRC_BURST_0 /*!< Every burst has a size of 16 Flash words (256-bit) */
  530. #define FLASH_CRC_BURST_SIZE_64 FLASH_CRCCR_CRC_BURST_1 /*!< Every burst has a size of 64 Flash words (256-bit) */
  531. #define FLASH_CRC_BURST_SIZE_256 FLASH_CRCCR_CRC_BURST /*!< Every burst has a size of 256 Flash words (256-bit) */
  532. /**
  533. * @}
  534. */
  535. /** @defgroup FLASHEx_Programming_Delay FLASH Programming Delay
  536. * @{
  537. */
  538. #define FLASH_PROGRAMMING_DELAY_0 0x00000000U /*!< programming delay set for Flash running at 70 MHz or below */
  539. #define FLASH_PROGRAMMING_DELAY_1 FLASH_ACR_WRHIGHFREQ_0 /*!< programming delay set for Flash running between 70 MHz and 185 MHz */
  540. #define FLASH_PROGRAMMING_DELAY_2 FLASH_ACR_WRHIGHFREQ_1 /*!< programming delay set for Flash running between 185 MHz and 225 MHz */
  541. #define FLASH_PROGRAMMING_DELAY_3 FLASH_ACR_WRHIGHFREQ /*!< programming delay set for Flash at startup */
  542. /**
  543. * @}
  544. */
  545. #if defined (FLASH_OTPBL_LOCKBL)
  546. /** @defgroup FLASHEx_OTP_Blocks FLASH OTP blocks
  547. * @{
  548. */
  549. #define FLASH_OTP_BLOCK_0 0x00000001U /*!< OTP Block0 */
  550. #define FLASH_OTP_BLOCK_1 0x00000002U /*!< OTP Block1 */
  551. #define FLASH_OTP_BLOCK_2 0x00000004U /*!< OTP Block2 */
  552. #define FLASH_OTP_BLOCK_3 0x00000008U /*!< OTP Block3 */
  553. #define FLASH_OTP_BLOCK_4 0x00000010U /*!< OTP Block4 */
  554. #define FLASH_OTP_BLOCK_5 0x00000020U /*!< OTP Block5 */
  555. #define FLASH_OTP_BLOCK_6 0x00000040U /*!< OTP Block6 */
  556. #define FLASH_OTP_BLOCK_7 0x00000080U /*!< OTP Block7 */
  557. #define FLASH_OTP_BLOCK_8 0x00000100U /*!< OTP Block8 */
  558. #define FLASH_OTP_BLOCK_9 0x00000200U /*!< OTP Block9 */
  559. #define FLASH_OTP_BLOCK_10 0x00000400U /*!< OTP Block10 */
  560. #define FLASH_OTP_BLOCK_11 0x00000800U /*!< OTP Block11 */
  561. #define FLASH_OTP_BLOCK_12 0x00001000U /*!< OTP Block12 */
  562. #define FLASH_OTP_BLOCK_13 0x00002000U /*!< OTP Block13 */
  563. #define FLASH_OTP_BLOCK_14 0x00004000U /*!< OTP Block14 */
  564. #define FLASH_OTP_BLOCK_15 0x00008000U /*!< OTP Block15 */
  565. #define FLASH_OTP_BLOCK_ALL 0x0000FFFFU /*!< OTP All Blocks */
  566. /**
  567. * @}
  568. */
  569. #endif /* FLASH_OTPBL_LOCKBL */
  570. /* Exported macro ------------------------------------------------------------*/
  571. /** @defgroup FLASHEx_Exported_Macros FLASH Exported Macros
  572. * @{
  573. */
  574. /**
  575. * @brief Calculate the FLASH Boot Base Adress (BOOT_ADD0 or BOOT_ADD1)
  576. * @note Returned value BOOT_ADDx[15:0] corresponds to boot address [29:14].
  577. * @param __ADDRESS__: FLASH Boot Address (in the range 0x0000 0000 to 0x2004 FFFF with a granularity of 16KB)
  578. * @retval The FLASH Boot Base Adress
  579. */
  580. #define __HAL_FLASH_CALC_BOOT_BASE_ADR(__ADDRESS__) ((__ADDRESS__) >> 14U)
  581. /**
  582. * @}
  583. */
  584. #if defined (FLASH_CR_PSIZE)
  585. /**
  586. * @brief Set the FLASH Program/Erase parallelism.
  587. * @param __PSIZE__ FLASH Program/Erase parallelism
  588. * This parameter can be a value of @ref FLASH_Program_Parallelism
  589. * @param __BANK__: Flash bank (FLASH_BANK_1 or FLASH_BANK_2)
  590. * @retval none
  591. */
  592. #define __HAL_FLASH_SET_PSIZE(__PSIZE__, __BANK__) (((__BANK__) == FLASH_BANK_1) ? \
  593. MODIFY_REG(FLASH->CR1, FLASH_CR_PSIZE, (__PSIZE__)) : \
  594. MODIFY_REG(FLASH->CR2, FLASH_CR_PSIZE, (__PSIZE__)))
  595. /**
  596. * @brief Get the FLASH Program/Erase parallelism.
  597. * @param __BANK__ Flash bank (FLASH_BANK_1 or FLASH_BANK_2)
  598. * @retval FLASH Program/Erase parallelism
  599. * This return value can be a value of @ref FLASH_Program_Parallelism
  600. */
  601. #define __HAL_FLASH_GET_PSIZE(__BANK__) (((__BANK__) == FLASH_BANK_1) ? \
  602. READ_BIT((FLASH->CR1), FLASH_CR_PSIZE) : \
  603. READ_BIT((FLASH->CR2), FLASH_CR_PSIZE))
  604. #endif /* FLASH_CR_PSIZE */
  605. /**
  606. * @brief Set the FLASH Programming Delay.
  607. * @param __DELAY__ FLASH Programming Delay
  608. * This parameter can be a value of @ref FLASHEx_Programming_Delay
  609. * @retval none
  610. */
  611. #define __HAL_FLASH_SET_PROGRAM_DELAY(__DELAY__) MODIFY_REG(FLASH->ACR, FLASH_ACR_WRHIGHFREQ, (__DELAY__))
  612. /**
  613. * @brief Get the FLASH Programming Delay.
  614. * @retval FLASH Programming Delay
  615. * This return value can be a value of @ref FLASHEx_Programming_Delay
  616. */
  617. #define __HAL_FLASH_GET_PROGRAM_DELAY() READ_BIT(FLASH->ACR, FLASH_ACR_WRHIGHFREQ)
  618. /* Exported functions --------------------------------------------------------*/
  619. /** @addtogroup FLASHEx_Exported_Functions
  620. * @{
  621. */
  622. /** @addtogroup FLASHEx_Exported_Functions_Group1
  623. * @{
  624. */
  625. /* Extension Program operation functions *************************************/
  626. HAL_StatusTypeDef HAL_FLASHEx_Erase(FLASH_EraseInitTypeDef *pEraseInit, uint32_t *SectorError);
  627. HAL_StatusTypeDef HAL_FLASHEx_Erase_IT(FLASH_EraseInitTypeDef *pEraseInit);
  628. HAL_StatusTypeDef HAL_FLASHEx_OBProgram(FLASH_OBProgramInitTypeDef *pOBInit);
  629. void HAL_FLASHEx_OBGetConfig(FLASH_OBProgramInitTypeDef *pOBInit);
  630. HAL_StatusTypeDef HAL_FLASHEx_Unlock_Bank1(void);
  631. HAL_StatusTypeDef HAL_FLASHEx_Lock_Bank1(void);
  632. HAL_StatusTypeDef HAL_FLASHEx_Unlock_Bank2(void);
  633. HAL_StatusTypeDef HAL_FLASHEx_Lock_Bank2(void);
  634. HAL_StatusTypeDef HAL_FLASHEx_ComputeCRC(FLASH_CRCInitTypeDef *pCRCInit, uint32_t *CRC_Result);
  635. /**
  636. * @}
  637. */
  638. /**
  639. * @}
  640. */
  641. /* Private types -------------------------------------------------------------*/
  642. /* Private variables ---------------------------------------------------------*/
  643. /* Private constants ---------------------------------------------------------*/
  644. /* Private macros ------------------------------------------------------------*/
  645. /** @defgroup FLASHEx_Private_Macros FLASHEx Private Macros
  646. * @{
  647. */
  648. /** @defgroup FLASHEx_IS_FLASH_Definitions FLASHEx Private macros to check input parameters
  649. * @{
  650. */
  651. #define IS_FLASH_TYPEERASE(VALUE) (((VALUE) == FLASH_TYPEERASE_SECTORS) || \
  652. ((VALUE) == FLASH_TYPEERASE_MASSERASE))
  653. #if defined (FLASH_CR_PSIZE)
  654. #define IS_VOLTAGERANGE(RANGE) (((RANGE) == FLASH_VOLTAGE_RANGE_1) || \
  655. ((RANGE) == FLASH_VOLTAGE_RANGE_2) || \
  656. ((RANGE) == FLASH_VOLTAGE_RANGE_3) || \
  657. ((RANGE) == FLASH_VOLTAGE_RANGE_4))
  658. #endif /* FLASH_CR_PSIZE */
  659. #define IS_WRPSTATE(VALUE) (((VALUE) == OB_WRPSTATE_DISABLE) || \
  660. ((VALUE) == OB_WRPSTATE_ENABLE))
  661. #if defined (FLASH_OPTSR_VDDMMC_HSLV)
  662. #define IS_OPTIONBYTE(VALUE) (((VALUE) <= 0x03FFU) && ((VALUE) != 0U))
  663. #elif defined (DUAL_CORE)
  664. #define IS_OPTIONBYTE(VALUE) (((VALUE) <= 0x3FFFU) && ((VALUE) != 0U))
  665. #else
  666. #define IS_OPTIONBYTE(VALUE) (((VALUE) <= 0x01FFU) && ((VALUE) != 0U))
  667. #endif /*DUAL_CORE*/
  668. #define IS_OB_BOOT_ADDRESS(ADDRESS) ((ADDRESS) <= 0x8013U)
  669. #define IS_OB_RDP_LEVEL(LEVEL) (((LEVEL) == OB_RDP_LEVEL_0) ||\
  670. ((LEVEL) == OB_RDP_LEVEL_1) ||\
  671. ((LEVEL) == OB_RDP_LEVEL_2))
  672. #define IS_OB_WWDG_SOURCE(SOURCE) (((SOURCE) == OB_WWDG_SW) || ((SOURCE) == OB_WWDG_HW))
  673. #define IS_OB_IWDG_SOURCE(SOURCE) (((SOURCE) == OB_IWDG_SW) || ((SOURCE) == OB_IWDG_HW))
  674. #define IS_OB_STOP_SOURCE(SOURCE) (((SOURCE) == OB_STOP_NO_RST) || ((SOURCE) == OB_STOP_RST))
  675. #define IS_OB_STDBY_SOURCE(SOURCE) (((SOURCE) == OB_STDBY_NO_RST) || ((SOURCE) == OB_STDBY_RST))
  676. #define IS_OB_IWDG_STOP_FREEZE(FREEZE) (((FREEZE) == OB_IWDG_STOP_FREEZE) || ((FREEZE) == OB_IWDG_STOP_ACTIVE))
  677. #define IS_OB_IWDG_STDBY_FREEZE(FREEZE) (((FREEZE) == OB_IWDG_STDBY_FREEZE) || ((FREEZE) == OB_IWDG_STDBY_ACTIVE))
  678. #define IS_OB_BOR_LEVEL(LEVEL) (((LEVEL) == OB_BOR_LEVEL0) || ((LEVEL) == OB_BOR_LEVEL1) || \
  679. ((LEVEL) == OB_BOR_LEVEL2) || ((LEVEL) == OB_BOR_LEVEL3))
  680. #define IS_FLASH_LATENCY(LATENCY) (((LATENCY) == FLASH_LATENCY_0) || \
  681. ((LATENCY) == FLASH_LATENCY_1) || \
  682. ((LATENCY) == FLASH_LATENCY_2) || \
  683. ((LATENCY) == FLASH_LATENCY_3) || \
  684. ((LATENCY) == FLASH_LATENCY_4) || \
  685. ((LATENCY) == FLASH_LATENCY_5) || \
  686. ((LATENCY) == FLASH_LATENCY_6) || \
  687. ((LATENCY) == FLASH_LATENCY_7) || \
  688. ((LATENCY) == FLASH_LATENCY_8) || \
  689. ((LATENCY) == FLASH_LATENCY_9) || \
  690. ((LATENCY) == FLASH_LATENCY_10) || \
  691. ((LATENCY) == FLASH_LATENCY_11) || \
  692. ((LATENCY) == FLASH_LATENCY_12) || \
  693. ((LATENCY) == FLASH_LATENCY_13) || \
  694. ((LATENCY) == FLASH_LATENCY_14) || \
  695. ((LATENCY) == FLASH_LATENCY_15))
  696. #define IS_FLASH_SECTOR(SECTOR) ((SECTOR) < FLASH_SECTOR_TOTAL)
  697. #if (FLASH_SECTOR_TOTAL == 8U)
  698. #define IS_OB_WRP_SECTOR(SECTOR) ((((SECTOR) & 0xFFFFFF00U) == 0x00000000U) && ((SECTOR) != 0x00000000U))
  699. #else
  700. #define IS_OB_WRP_SECTOR(SECTOR) ((SECTOR) != 0x00000000U)
  701. #endif /* FLASH_SECTOR_TOTAL == 8U */
  702. #define IS_OB_PCROP_RDP(CONFIG) (((CONFIG) == OB_PCROP_RDP_NOT_ERASE) || \
  703. ((CONFIG) == OB_PCROP_RDP_ERASE))
  704. #define IS_OB_SECURE_RDP(CONFIG) (((CONFIG) == OB_SECURE_RDP_NOT_ERASE) || \
  705. ((CONFIG) == OB_SECURE_RDP_ERASE))
  706. #define IS_OB_USER_SWAP_BANK(VALUE) (((VALUE) == OB_SWAP_BANK_DISABLE) || ((VALUE) == OB_SWAP_BANK_ENABLE))
  707. #define IS_OB_USER_IOHSLV(VALUE) (((VALUE) == OB_IOHSLV_DISABLE) || ((VALUE) == OB_IOHSLV_ENABLE))
  708. #if defined (FLASH_OPTSR_VDDMMC_HSLV)
  709. #define IS_OB_USER_VDDMMC_HSLV(VALUE) (((VALUE) == OB_VDDMMC_HSLV_DISABLE) || ((VALUE) == OB_VDDMMC_HSLV_ENABLE))
  710. #endif /* FLASH_OPTSR_VDDMMC_HSLV */
  711. #define IS_OB_IWDG1_SOURCE(SOURCE) (((SOURCE) == OB_IWDG1_SW) || ((SOURCE) == OB_IWDG1_HW))
  712. #if defined (DUAL_CORE)
  713. #define IS_OB_IWDG2_SOURCE(SOURCE) (((SOURCE) == OB_IWDG2_SW) || ((SOURCE) == OB_IWDG2_HW))
  714. #endif /* DUAL_CORE */
  715. #define IS_OB_STOP_D1_RESET(VALUE) (((VALUE) == OB_STOP_NO_RST_D1) || ((VALUE) == OB_STOP_RST_D1))
  716. #define IS_OB_STDBY_D1_RESET(VALUE) (((VALUE) == OB_STDBY_NO_RST_D1) || ((VALUE) == OB_STDBY_RST_D1))
  717. #define IS_OB_USER_IWDG_STOP(VALUE) (((VALUE) == OB_IWDG_STOP_FREEZE) || ((VALUE) == OB_IWDG_STOP_ACTIVE))
  718. #define IS_OB_USER_IWDG_STDBY(VALUE) (((VALUE) == OB_IWDG_STDBY_FREEZE) || ((VALUE) == OB_IWDG_STDBY_ACTIVE))
  719. #define IS_OB_USER_ST_RAM_SIZE(VALUE) (((VALUE) == OB_ST_RAM_SIZE_2KB) || ((VALUE) == OB_ST_RAM_SIZE_4KB) || \
  720. ((VALUE) == OB_ST_RAM_SIZE_8KB) || ((VALUE) == OB_ST_RAM_SIZE_16KB))
  721. #define IS_OB_USER_SECURITY(VALUE) (((VALUE) == OB_SECURITY_ENABLE) || ((VALUE) == OB_SECURITY_DISABLE))
  722. #if defined (DUAL_CORE)
  723. #define IS_OB_USER_BCM4(VALUE) (((VALUE) == OB_BCM4_DISABLE) || ((VALUE) == OB_BCM4_ENABLE))
  724. #define IS_OB_USER_BCM7(VALUE) (((VALUE) == OB_BCM7_DISABLE) || ((VALUE) == OB_BCM7_ENABLE))
  725. #define IS_OB_STOP_D2_RESET(VALUE) (((VALUE) == OB_STOP_NO_RST_D2) || ((VALUE) == OB_STOP_RST_D2))
  726. #define IS_OB_STDBY_D2_RESET(VALUE) (((VALUE) == OB_STDBY_NO_RST_D2) || ((VALUE) == OB_STDBY_RST_D2))
  727. #endif /* DUAL_CORE */
  728. #if defined (DUAL_CORE)
  729. #define IS_OB_USER_TYPE(TYPE) (((TYPE) <= (uint32_t)0x3FFFU) && ((TYPE) != 0U))
  730. #else
  731. #define IS_OB_USER_TYPE(TYPE) (((TYPE) <= (uint32_t)0x73FU) && ((TYPE) != 0U))
  732. #endif /* DUAL_CORE */
  733. #define IS_OB_BOOT_ADD_OPTION(VALUE) (((VALUE) == OB_BOOT_ADD0) || \
  734. ((VALUE) == OB_BOOT_ADD1) || \
  735. ((VALUE) == OB_BOOT_ADD_BOTH))
  736. #define IS_FLASH_TYPECRC(VALUE) (((VALUE) == FLASH_CRC_ADDR) || \
  737. ((VALUE) == FLASH_CRC_SECTORS) || \
  738. ((VALUE) == FLASH_CRC_BANK))
  739. #if defined (FLASH_OTPBL_LOCKBL)
  740. #define IS_OTP_BLOCK(VALUE) ((((VALUE) & 0xFFFF0000U) == 0x00000000U) && ((VALUE) != 0x00000000U))
  741. #endif /* FLASH_OTPBL_LOCKBL */
  742. /**
  743. * @}
  744. */
  745. /**
  746. * @}
  747. */
  748. /* Private functions ---------------------------------------------------------*/
  749. /** @defgroup FLASHEx_Private_Functions FLASHEx Private Functions
  750. * @{
  751. */
  752. void FLASH_Erase_Sector(uint32_t Sector, uint32_t Banks, uint32_t VoltageRange);
  753. /**
  754. * @}
  755. */
  756. /**
  757. * @}
  758. */
  759. /**
  760. * @}
  761. */
  762. /**
  763. * @}
  764. */
  765. #ifdef __cplusplus
  766. }
  767. #endif
  768. #endif /* STM32H7xx_HAL_FLASH_EX_H */
  769. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/