stm32f7xx_ll_system.h 43 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034
  1. /**
  2. ******************************************************************************
  3. * @file stm32f7xx_ll_system.h
  4. * @author MCD Application Team
  5. * @brief Header file of SYSTEM LL module.
  6. @verbatim
  7. ==============================================================================
  8. ##### How to use this driver #####
  9. ==============================================================================
  10. [..]
  11. The LL SYSTEM driver contains a set of generic APIs that can be
  12. used by user:
  13. (+) Some of the FLASH features need to be handled in the SYSTEM file.
  14. (+) Access to DBGCMU registers
  15. (+) Access to SYSCFG registers
  16. @endverbatim
  17. ******************************************************************************
  18. * @attention
  19. *
  20. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  21. *
  22. * Redistribution and use in source and binary forms, with or without modification,
  23. * are permitted provided that the following conditions are met:
  24. * 1. Redistributions of source code must retain the above copyright notice,
  25. * this list of conditions and the following disclaimer.
  26. * 2. Redistributions in binary form must reproduce the above copyright notice,
  27. * this list of conditions and the following disclaimer in the documentation
  28. * and/or other materials provided with the distribution.
  29. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  30. * may be used to endorse or promote products derived from this software
  31. * without specific prior written permission.
  32. *
  33. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  34. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  35. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  36. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  37. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  38. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  39. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  40. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  41. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  42. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  43. *
  44. ******************************************************************************
  45. */
  46. /* Define to prevent recursive inclusion -------------------------------------*/
  47. #ifndef __STM32F7xx_LL_SYSTEM_H
  48. #define __STM32F7xx_LL_SYSTEM_H
  49. #ifdef __cplusplus
  50. extern "C" {
  51. #endif
  52. /* Includes ------------------------------------------------------------------*/
  53. #include "stm32f7xx.h"
  54. /** @addtogroup STM32F7xx_LL_Driver
  55. * @{
  56. */
  57. #if defined (FLASH) || defined (SYSCFG) || defined (DBGMCU)
  58. /** @defgroup SYSTEM_LL SYSTEM
  59. * @{
  60. */
  61. /* Private types -------------------------------------------------------------*/
  62. /* Private variables ---------------------------------------------------------*/
  63. /* Private constants ---------------------------------------------------------*/
  64. /** @defgroup SYSTEM_LL_Private_Constants SYSTEM Private Constants
  65. * @{
  66. */
  67. /**
  68. * @}
  69. */
  70. /* Private macros ------------------------------------------------------------*/
  71. /* Exported types ------------------------------------------------------------*/
  72. /* Exported constants --------------------------------------------------------*/
  73. /** @defgroup SYSTEM_LL_Exported_Constants SYSTEM Exported Constants
  74. * @{
  75. */
  76. /** @defgroup SYSTEM_LL_EC_REMAP SYSCFG REMAP
  77. * @{
  78. */
  79. #define LL_SYSCFG_REMAP_BOOT0 0x00000000U /*!< Boot information after Reset */
  80. #define LL_SYSCFG_REMAP_BOOT1 SYSCFG_MEMRMP_MEM_BOOT /*!< Boot information after Reset */
  81. /**
  82. * @}
  83. */
  84. #if defined(SYSCFG_MEMRMP_SWP_FB)
  85. /** @defgroup SYSTEM_LL_EC_BANKMODE SYSCFG BANK MODE
  86. * @{
  87. */
  88. #define LL_SYSCFG_BANKMODE_BANK1 0x00000000U /*!< Flash Bank 1 base address mapped at 0x0800 0000 (AXI) and 0x0020 0000 (TCM)
  89. and Flash Bank 2 base address mapped at 0x0810 0000 (AXI) and 0x0030 0000 (TCM)*/
  90. #define LL_SYSCFG_BANKMODE_BANK2 SYSCFG_MEMRMP_SWP_FB /*!< Flash Bank 2 base address mapped at 0x0800 0000 (AXI) and 0x0020 0000(TCM)
  91. and Flash Bank 1 base address mapped at 0x0810 0000 (AXI) and 0x0030 0000(TCM) */
  92. /**
  93. * @}
  94. */
  95. #endif /* SYSCFG_MEMRMP_SWP_FB */
  96. #if defined(SYSCFG_PMC_MII_RMII_SEL)
  97. /** @defgroup SYSTEM_LL_EC_PMC SYSCFG PMC
  98. * @{
  99. */
  100. #define LL_SYSCFG_PMC_ETHMII 0x00000000U /*!< ETH Media MII interface */
  101. #define LL_SYSCFG_PMC_ETHRMII (uint32_t)SYSCFG_PMC_MII_RMII_SEL /*!< ETH Media RMII interface */
  102. /**
  103. * @}
  104. */
  105. #endif /* SYSCFG_PMC_MII_RMII_SEL */
  106. /** @defgroup SYSTEM_LL_EC_I2C_FASTMODEPLUS SYSCFG I2C FASTMODEPLUS
  107. * @{
  108. */
  109. #if defined(SYSCFG_PMC_I2C1_FMP)
  110. #define LL_SYSCFG_I2C_FASTMODEPLUS_I2C1 SYSCFG_PMC_I2C1_FMP /*!< Enable Fast Mode Plus for I2C1 */
  111. #define LL_SYSCFG_I2C_FASTMODEPLUS_I2C2 SYSCFG_PMC_I2C2_FMP /*!< Enable Fast Mode Plus for I2C2 */
  112. #define LL_SYSCFG_I2C_FASTMODEPLUS_I2C3 SYSCFG_PMC_I2C3_FMP /*!< Enable Fast Mode Plus for I2C3 */
  113. #endif /* SYSCFG_PMC_I2C1_FMP */
  114. #if defined(SYSCFG_PMC_I2C4_FMP)
  115. #define LL_SYSCFG_I2C_FASTMODEPLUS_I2C4 SYSCFG_PMC_I2C4_FMP /*!< Enable Fast Mode Plus for I2C4 */
  116. #endif /* SYSCFG_PMC_I2C4_FMP */
  117. #if defined(SYSCFG_PMC_I2C_PB6_FMP)
  118. #define LL_SYSCFG_I2C_FASTMODEPLUS_PB6 SYSCFG_PMC_I2C_PB6_FMP /*!< Enable Fast Mode Plus on PB6 */
  119. #define LL_SYSCFG_I2C_FASTMODEPLUS_PB7 SYSCFG_PMC_I2C_PB7_FMP /*!< Enable Fast Mode Plus on PB7 */
  120. #define LL_SYSCFG_I2C_FASTMODEPLUS_PB8 SYSCFG_PMC_I2C_PB8_FMP /*!< Enable Fast Mode Plus on PB8 */
  121. #define LL_SYSCFG_I2C_FASTMODEPLUS_PB9 SYSCFG_PMC_I2C_PB9_FMP /*!< Enable Fast Mode Plus on PB9 */
  122. #endif /* SYSCFG_PMC_I2C_PB6_FMP */
  123. /**
  124. * @}
  125. */
  126. /** @defgroup SYSTEM_LL_EC_EXTI_PORT SYSCFG EXTI PORT
  127. * @{
  128. */
  129. #define LL_SYSCFG_EXTI_PORTA 0U /*!< EXTI PORT A */
  130. #define LL_SYSCFG_EXTI_PORTB 1U /*!< EXTI PORT B */
  131. #define LL_SYSCFG_EXTI_PORTC 2U /*!< EXTI PORT C */
  132. #define LL_SYSCFG_EXTI_PORTD 3U /*!< EXTI PORT D */
  133. #define LL_SYSCFG_EXTI_PORTE 4U /*!< EXTI PORT E */
  134. #if defined(GPIOF)
  135. #define LL_SYSCFG_EXTI_PORTF 5U /*!< EXTI PORT F */
  136. #endif /* GPIOF */
  137. #if defined(GPIOG)
  138. #define LL_SYSCFG_EXTI_PORTG 6U /*!< EXTI PORT G */
  139. #endif /* GPIOG */
  140. #define LL_SYSCFG_EXTI_PORTH 7U /*!< EXTI PORT H */
  141. #if defined(GPIOI)
  142. #define LL_SYSCFG_EXTI_PORTI 8U /*!< EXTI PORT I */
  143. #endif /* GPIOI */
  144. #if defined(GPIOJ)
  145. #define LL_SYSCFG_EXTI_PORTJ 9U /*!< EXTI PORT J */
  146. #endif /* GPIOJ */
  147. #if defined(GPIOK)
  148. #define LL_SYSCFG_EXTI_PORTK 10U /*!< EXTI PORT k */
  149. #endif /* GPIOK */
  150. /**
  151. * @}
  152. */
  153. /** @defgroup SYSTEM_LL_EC_EXTI_LINE SYSCFG EXTI LINE
  154. * @{
  155. */
  156. #define LL_SYSCFG_EXTI_LINE0 (0x000FU << 16U | 0U) /*!< EXTI_POSITION_0 | EXTICR[0] */
  157. #define LL_SYSCFG_EXTI_LINE1 (0x00F0U << 16U | 0U) /*!< EXTI_POSITION_4 | EXTICR[0] */
  158. #define LL_SYSCFG_EXTI_LINE2 (0x0F00U << 16U | 0U) /*!< EXTI_POSITION_8 | EXTICR[0] */
  159. #define LL_SYSCFG_EXTI_LINE3 (0xF000U << 16U | 0U) /*!< EXTI_POSITION_12 | EXTICR[0] */
  160. #define LL_SYSCFG_EXTI_LINE4 (0x000FU << 16U | 1U) /*!< EXTI_POSITION_0 | EXTICR[1] */
  161. #define LL_SYSCFG_EXTI_LINE5 (0x00F0U << 16U | 1U) /*!< EXTI_POSITION_4 | EXTICR[1] */
  162. #define LL_SYSCFG_EXTI_LINE6 (0x0F00U << 16U | 1U) /*!< EXTI_POSITION_8 | EXTICR[1] */
  163. #define LL_SYSCFG_EXTI_LINE7 (0xF000U << 16U | 1U) /*!< EXTI_POSITION_12 | EXTICR[1] */
  164. #define LL_SYSCFG_EXTI_LINE8 (0x000FU << 16U | 2U) /*!< EXTI_POSITION_0 | EXTICR[2] */
  165. #define LL_SYSCFG_EXTI_LINE9 (0x00F0U << 16U | 2U) /*!< EXTI_POSITION_4 | EXTICR[2] */
  166. #define LL_SYSCFG_EXTI_LINE10 (0x0F00U << 16U | 2U) /*!< EXTI_POSITION_8 | EXTICR[2] */
  167. #define LL_SYSCFG_EXTI_LINE11 (0xF000U << 16U | 2U) /*!< EXTI_POSITION_12 | EXTICR[2] */
  168. #define LL_SYSCFG_EXTI_LINE12 (0x000FU << 16U | 3U) /*!< EXTI_POSITION_0 | EXTICR[3] */
  169. #define LL_SYSCFG_EXTI_LINE13 (0x00F0U << 16U | 3U) /*!< EXTI_POSITION_4 | EXTICR[3] */
  170. #define LL_SYSCFG_EXTI_LINE14 (0x0F00U << 16U | 3U) /*!< EXTI_POSITION_8 | EXTICR[3] */
  171. #define LL_SYSCFG_EXTI_LINE15 (0xF000U << 16U | 3U) /*!< EXTI_POSITION_12 | EXTICR[3] */
  172. /**
  173. * @}
  174. */
  175. /** @defgroup SYSTEM_LL_EC_TIMBREAK SYSCFG TIMER BREAK
  176. * @{
  177. */
  178. #if defined(SYSCFG_CBR_CLL)
  179. #define LL_SYSCFG_TIMBREAK_LOCKUP SYSCFG_CBR_CLL /*!< Enables and locks the Lockup output (raised during core
  180. lockup state) of Cortex-M7 with Break Input of TIMER1, TIMER8 */
  181. #define LL_SYSCFG_TIMBREAK_PVD SYSCFG_CBR_PVDL /*!< Enables and locks the PVD connection with TIMER1, TIMER8 Break input.
  182. It also locks (write protect) the PVD_EN and PVDSEL[2:0] bits
  183. of the power controller */
  184. #endif /* SYSCFG_CBR_CLL */
  185. /**
  186. * @}
  187. */
  188. /** @defgroup SYSTEM_LL_EC_CMP_PD SYSCFG CMP PD
  189. * @{
  190. */
  191. #define LL_SYSCFG_DISABLE_CMP_PD 0x00000000U /*!< I/O compensation cell power-down mode */
  192. #define LL_SYSCFG_ENABLE_CMP_PD SYSCFG_CMPCR_CMP_PD /*!< I/O compensation cell enabled */
  193. /**
  194. * @}
  195. */
  196. /** @defgroup SYSTEM_LL_EC_TRACE DBGMCU TRACE Pin Assignment
  197. * @{
  198. */
  199. #define LL_DBGMCU_TRACE_NONE 0x00000000U /*!< TRACE pins not assigned (default state) */
  200. #define LL_DBGMCU_TRACE_ASYNCH DBGMCU_CR_TRACE_IOEN /*!< TRACE pin assignment for Asynchronous Mode */
  201. #define LL_DBGMCU_TRACE_SYNCH_SIZE1 (DBGMCU_CR_TRACE_IOEN | DBGMCU_CR_TRACE_MODE_0) /*!< TRACE pin assignment for Synchronous Mode with a TRACEDATA size of 1 */
  202. #define LL_DBGMCU_TRACE_SYNCH_SIZE2 (DBGMCU_CR_TRACE_IOEN | DBGMCU_CR_TRACE_MODE_1) /*!< TRACE pin assignment for Synchronous Mode with a TRACEDATA size of 2 */
  203. #define LL_DBGMCU_TRACE_SYNCH_SIZE4 (DBGMCU_CR_TRACE_IOEN | DBGMCU_CR_TRACE_MODE) /*!< TRACE pin assignment for Synchronous Mode with a TRACEDATA size of 4 */
  204. /**
  205. * @}
  206. */
  207. /** @defgroup SYSTEM_LL_EC_APB1_GRP1_STOP_IP DBGMCU APB1 GRP1 STOP IP
  208. * @{
  209. */
  210. #define LL_DBGMCU_APB1_GRP1_TIM2_STOP DBGMCU_APB1_FZ_DBG_TIM2_STOP /*!< TIM2 counter stopped when core is halted */
  211. #define LL_DBGMCU_APB1_GRP1_TIM3_STOP DBGMCU_APB1_FZ_DBG_TIM3_STOP /*!< TIM3 counter stopped when core is halted */
  212. #define LL_DBGMCU_APB1_GRP1_TIM4_STOP DBGMCU_APB1_FZ_DBG_TIM4_STOP /*!< TIM4 counter stopped when core is halted */
  213. #define LL_DBGMCU_APB1_GRP1_TIM5_STOP DBGMCU_APB1_FZ_DBG_TIM5_STOP /*!< TIM5 counter stopped when core is halted */
  214. #define LL_DBGMCU_APB1_GRP1_TIM6_STOP DBGMCU_APB1_FZ_DBG_TIM6_STOP /*!< TIM6 counter stopped when core is halted */
  215. #define LL_DBGMCU_APB1_GRP1_TIM7_STOP DBGMCU_APB1_FZ_DBG_TIM7_STOP /*!< TIM7 counter stopped when core is halted */
  216. #define LL_DBGMCU_APB1_GRP1_TIM12_STOP DBGMCU_APB1_FZ_DBG_TIM12_STOP /*!< TIM12 counter stopped when core is halted */
  217. #define LL_DBGMCU_APB1_GRP1_TIM13_STOP DBGMCU_APB1_FZ_DBG_TIM13_STOP /*!< TIM13 counter stopped when core is halted */
  218. #define LL_DBGMCU_APB1_GRP1_TIM14_STOP DBGMCU_APB1_FZ_DBG_TIM14_STOP /*!< TIM14 counter stopped when core is halted */
  219. #define LL_DBGMCU_APB1_GRP1_LPTIM1_STOP DBGMCU_APB1_FZ_DBG_LPTIM1_STOP /*!< LPTIIM1 counter stopped when core is halted */
  220. #define LL_DBGMCU_APB1_GRP1_RTC_STOP DBGMCU_APB1_FZ_DBG_RTC_STOP /*!< RTC counter stopped when core is halted */
  221. #define LL_DBGMCU_APB1_GRP1_WWDG_STOP DBGMCU_APB1_FZ_DBG_WWDG_STOP /*!< Debug Window Watchdog stopped when Core is halted */
  222. #define LL_DBGMCU_APB1_GRP1_IWDG_STOP DBGMCU_APB1_FZ_DBG_IWDG_STOP /*!< Debug Independent Watchdog stopped when Core is halted */
  223. #define LL_DBGMCU_APB1_GRP1_I2C1_STOP DBGMCU_APB1_FZ_DBG_I2C1_SMBUS_TIMEOUT /*!< I2C1 SMBUS timeout mode stopped when Core is halted */
  224. #define LL_DBGMCU_APB1_GRP1_I2C2_STOP DBGMCU_APB1_FZ_DBG_I2C2_SMBUS_TIMEOUT /*!< I2C2 SMBUS timeout mode stopped when Core is halted */
  225. #define LL_DBGMCU_APB1_GRP1_I2C3_STOP DBGMCU_APB1_FZ_DBG_I2C3_SMBUS_TIMEOUT /*!< I2C3 SMBUS timeout mode stopped when Core is halted */
  226. #if defined(DBGMCU_APB1_FZ_DBG_I2C4_SMBUS_TIMEOUT)
  227. #define LL_DBGMCU_APB1_GRP1_I2C4_STOP DBGMCU_APB1_FZ_DBG_I2C4_SMBUS_TIMEOUT /*!< I2C4 SMBUS timeout mode stopped when core is halted */
  228. #endif /* DBGMCU_APB1_FZ_DBG_I2C4_SMBUS_TIMEOUT */
  229. #define LL_DBGMCU_APB1_GRP1_CAN1_STOP DBGMCU_APB1_FZ_DBG_CAN1_STOP /*!< CAN1 debug stopped when Core is halted */
  230. #if defined(DBGMCU_APB1_FZ_DBG_CAN2_STOP)
  231. #define LL_DBGMCU_APB1_GRP1_CAN2_STOP DBGMCU_APB1_FZ_DBG_CAN2_STOP /*!< CAN2 debug stopped when Core is halted */
  232. #endif /* DBGMCU_APB1_FZ_DBG_CAN2_STOP */
  233. #if defined(DBGMCU_APB1_FZ_DBG_CAN3_STOP)
  234. #define LL_DBGMCU_APB1_GRP1_CAN3_STOP DBGMCU_APB1_FZ_DBG_CAN3_STOP /*!< CAN3 debug stopped when Core is halted */
  235. #endif /*DBGMCU_APB1_FZ_DBG_CAN3_STOP*/
  236. /**
  237. * @}
  238. */
  239. /** @defgroup SYSTEM_LL_EC_APB2_GRP1_STOP_IP DBGMCU APB2 GRP1 STOP IP
  240. * @{
  241. */
  242. #define LL_DBGMCU_APB2_GRP1_TIM1_STOP DBGMCU_APB2_FZ_DBG_TIM1_STOP /*!< TIM1 counter stopped when core is halted */
  243. #define LL_DBGMCU_APB2_GRP1_TIM8_STOP DBGMCU_APB2_FZ_DBG_TIM8_STOP /*!< TIM8 counter stopped when core is halted */
  244. #define LL_DBGMCU_APB2_GRP1_TIM9_STOP DBGMCU_APB2_FZ_DBG_TIM9_STOP /*!< TIM9 counter stopped when core is halted */
  245. #define LL_DBGMCU_APB2_GRP1_TIM10_STOP DBGMCU_APB2_FZ_DBG_TIM10_STOP /*!< TIM10 counter stopped when core is halted */
  246. #define LL_DBGMCU_APB2_GRP1_TIM11_STOP DBGMCU_APB2_FZ_DBG_TIM11_STOP /*!< TIM11 counter stopped when core is halted */
  247. /**
  248. * @}
  249. */
  250. /** @defgroup SYSTEM_LL_EC_LATENCY FLASH LATENCY
  251. * @{
  252. */
  253. #define LL_FLASH_LATENCY_0 FLASH_ACR_LATENCY_0WS /*!< FLASH Zero wait state */
  254. #define LL_FLASH_LATENCY_1 FLASH_ACR_LATENCY_1WS /*!< FLASH One wait state */
  255. #define LL_FLASH_LATENCY_2 FLASH_ACR_LATENCY_2WS /*!< FLASH Two wait states */
  256. #define LL_FLASH_LATENCY_3 FLASH_ACR_LATENCY_3WS /*!< FLASH Three wait states */
  257. #define LL_FLASH_LATENCY_4 FLASH_ACR_LATENCY_4WS /*!< FLASH Four wait states */
  258. #define LL_FLASH_LATENCY_5 FLASH_ACR_LATENCY_5WS /*!< FLASH five wait state */
  259. #define LL_FLASH_LATENCY_6 FLASH_ACR_LATENCY_6WS /*!< FLASH six wait state */
  260. #define LL_FLASH_LATENCY_7 FLASH_ACR_LATENCY_7WS /*!< FLASH seven wait states */
  261. #define LL_FLASH_LATENCY_8 FLASH_ACR_LATENCY_8WS /*!< FLASH eight wait states */
  262. #define LL_FLASH_LATENCY_9 FLASH_ACR_LATENCY_9WS /*!< FLASH nine wait states */
  263. #define LL_FLASH_LATENCY_10 FLASH_ACR_LATENCY_10WS /*!< FLASH ten wait states */
  264. #define LL_FLASH_LATENCY_11 FLASH_ACR_LATENCY_11WS /*!< FLASH eleven wait states */
  265. #define LL_FLASH_LATENCY_12 FLASH_ACR_LATENCY_12WS /*!< FLASH twelve wait states */
  266. #define LL_FLASH_LATENCY_13 FLASH_ACR_LATENCY_13WS /*!< FLASH thirteen wait states */
  267. #define LL_FLASH_LATENCY_14 FLASH_ACR_LATENCY_14WS /*!< FLASH fourteen wait states */
  268. #define LL_FLASH_LATENCY_15 FLASH_ACR_LATENCY_15WS /*!< FLASH fifteen wait states */
  269. /**
  270. * @}
  271. */
  272. /**
  273. * @}
  274. */
  275. /* Exported macro ------------------------------------------------------------*/
  276. /* Exported functions --------------------------------------------------------*/
  277. /** @defgroup SYSTEM_LL_Exported_Functions SYSTEM Exported Functions
  278. * @{
  279. */
  280. /** @defgroup SYSTEM_LL_EF_SYSCFG SYSCFG
  281. * @{
  282. */
  283. /**
  284. * @brief Enables the FMC Memory Mapping Swapping
  285. * @rmtoll SYSCFG_MEMRMP SWP_FMC LL_SYSCFG_EnableFMCMemorySwapping
  286. * @note SDRAM is accessible at 0x60000000 and NOR/RAM
  287. * is accessible at 0xC0000000
  288. * @retval None
  289. */
  290. __STATIC_INLINE void LL_SYSCFG_EnableFMCMemorySwapping(void)
  291. {
  292. SET_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_SWP_FMC_0);
  293. }
  294. /**
  295. * @brief Disables the FMC Memory Mapping Swapping
  296. * @rmtoll SYSCFG_MEMRMP SWP_FMC LL_SYSCFG_DisableFMCMemorySwapping
  297. * @note SDRAM is accessible at 0xC0000000 (default mapping)
  298. * and NOR/RAM is accessible at 0x60000000 (default mapping)
  299. * @retval None
  300. */
  301. __STATIC_INLINE void LL_SYSCFG_DisableFMCMemorySwapping(void)
  302. {
  303. CLEAR_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_SWP_FMC);
  304. }
  305. /**
  306. * @brief Enables the Compensation Cell
  307. * @rmtoll SYSCFG_CMPCR CMP_PD LL_SYSCFG_EnableCompensationCell
  308. * @note The I/O compensation cell can be used only when the device supply
  309. * voltage ranges from 2.4 to 3.6 V
  310. * @retval None
  311. */
  312. __STATIC_INLINE void LL_SYSCFG_EnableCompensationCell(void)
  313. {
  314. SET_BIT(SYSCFG->CMPCR, SYSCFG_CMPCR_CMP_PD);
  315. }
  316. /**
  317. * @brief Disables the Compensation Cell
  318. * @rmtoll SYSCFG_CMPCR CMP_PD LL_SYSCFG_DisableCompensationCell
  319. * @note The I/O compensation cell can be used only when the device supply
  320. * voltage ranges from 2.4 to 3.6 V
  321. * @retval None
  322. */
  323. __STATIC_INLINE void LL_SYSCFG_DisableCompensationCell(void)
  324. {
  325. CLEAR_BIT(SYSCFG->CMPCR, SYSCFG_CMPCR_CMP_PD);
  326. }
  327. /**
  328. * @brief Get Compensation Cell ready Flag
  329. * @rmtoll SYSCFG_CMPCR READY LL_SYSCFG_IsActiveFlag_CMPCR
  330. * @retval State of bit (1 or 0).
  331. */
  332. __STATIC_INLINE uint32_t LL_SYSCFG_IsActiveFlag_CMPCR(void)
  333. {
  334. return (READ_BIT(SYSCFG->CMPCR, SYSCFG_CMPCR_READY) == (SYSCFG_CMPCR_READY));
  335. }
  336. /**
  337. * @brief Get the memory boot mapping as configured by user
  338. * @rmtoll SYSCFG_MEMRMP MEM_BOOT LL_SYSCFG_GetRemapMemoryBoot
  339. * @retval Returned value can be one of the following values:
  340. * @arg @ref LL_SYSCFG_REMAP_BOOT0
  341. * @arg @ref LL_SYSCFG_REMAP_BOOT1
  342. *
  343. * (*) value not defined in all devices
  344. */
  345. __STATIC_INLINE uint32_t LL_SYSCFG_GetRemapMemoryBoot(void)
  346. {
  347. return (uint32_t)(READ_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_MEM_BOOT));
  348. }
  349. #if defined(SYSCFG_PMC_MII_RMII_SEL)
  350. /**
  351. * @brief Select Ethernet PHY interface
  352. * @rmtoll SYSCFG_PMC MII_RMII_SEL LL_SYSCFG_SetPHYInterface
  353. * @param Interface This parameter can be one of the following values:
  354. * @arg @ref LL_SYSCFG_PMC_ETHMII
  355. * @arg @ref LL_SYSCFG_PMC_ETHRMII
  356. * @retval None
  357. */
  358. __STATIC_INLINE void LL_SYSCFG_SetPHYInterface(uint32_t Interface)
  359. {
  360. MODIFY_REG(SYSCFG->PMC, SYSCFG_PMC_MII_RMII_SEL, Interface);
  361. }
  362. /**
  363. * @brief Get Ethernet PHY interface
  364. * @rmtoll SYSCFG_PMC MII_RMII_SEL LL_SYSCFG_GetPHYInterface
  365. * @retval Returned value can be one of the following values:
  366. * @arg @ref LL_SYSCFG_PMC_ETHMII
  367. * @arg @ref LL_SYSCFG_PMC_ETHRMII
  368. * @retval None
  369. */
  370. __STATIC_INLINE uint32_t LL_SYSCFG_GetPHYInterface(void)
  371. {
  372. return (uint32_t)(READ_BIT(SYSCFG->PMC, SYSCFG_PMC_MII_RMII_SEL));
  373. }
  374. #endif /* SYSCFG_PMC_MII_RMII_SEL */
  375. #if defined(SYSCFG_MEMRMP_SWP_FB)
  376. /**
  377. * @brief Select Flash bank mode (Bank flashed at 0x08000000)
  378. * @rmtoll SYSCFG_MEMRMP FB_MODE LL_SYSCFG_SetFlashBankMode
  379. * @param Bank This parameter can be one of the following values:
  380. * @arg @ref LL_SYSCFG_BANKMODE_BANK1
  381. * @arg @ref LL_SYSCFG_BANKMODE_BANK2
  382. * @retval None
  383. */
  384. __STATIC_INLINE void LL_SYSCFG_SetFlashBankMode(uint32_t Bank)
  385. {
  386. MODIFY_REG(SYSCFG->MEMRMP, SYSCFG_MEMRMP_SWP_FB, Bank);
  387. }
  388. /**
  389. * @brief Get Flash bank mode (Bank flashed at 0x08000000)
  390. * @rmtoll SYSCFG_MEMRMP FB_MODE LL_SYSCFG_GetFlashBankMode
  391. * @retval Returned value can be one of the following values:
  392. * @arg @ref LL_SYSCFG_BANKMODE_BANK1
  393. * @arg @ref LL_SYSCFG_BANKMODE_BANK2
  394. */
  395. __STATIC_INLINE uint32_t LL_SYSCFG_GetFlashBankMode(void)
  396. {
  397. return (uint32_t)(READ_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_SWP_FB));
  398. }
  399. #endif /* SYSCFG_MEMRMP_SWP_FB */
  400. #if defined(SYSCFG_PMC_I2C1_FMP)
  401. /**
  402. * @brief Enable the I2C fast mode plus driving capability.
  403. * @rmtoll SYSCFG_PMC I2C_PBx_FMP LL_SYSCFG_EnableFastModePlus\n
  404. * SYSCFG_PMC I2Cx_FMP LL_SYSCFG_EnableFastModePlus
  405. * @param ConfigFastModePlus This parameter can be a combination of the following values:
  406. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB6
  407. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB7
  408. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB8 (*)
  409. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB9 (*)
  410. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C1
  411. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C2 (*)
  412. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C3
  413. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C4(*)
  414. *
  415. * (*) value not defined in all devices
  416. * @retval None
  417. */
  418. __STATIC_INLINE void LL_SYSCFG_EnableFastModePlus(uint32_t ConfigFastModePlus)
  419. {
  420. SET_BIT(SYSCFG->PMC, ConfigFastModePlus);
  421. }
  422. /**
  423. * @brief Disable the I2C fast mode plus driving capability.
  424. * @rmtoll SYSCFG_PMC I2C_PBx_FMP LL_SYSCFG_DisableFastModePlus\n
  425. * SYSCFG_PMC I2Cx_FMP LL_SYSCFG_DisableFastModePlus
  426. * @param ConfigFastModePlus This parameter can be a combination of the following values:
  427. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB6
  428. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB7
  429. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB8 (*)
  430. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_PB9 (*)
  431. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C1
  432. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C2 (*)
  433. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C3
  434. * @arg @ref LL_SYSCFG_I2C_FASTMODEPLUS_I2C4
  435. * (*) value not defined in all devices
  436. * @retval None
  437. */
  438. __STATIC_INLINE void LL_SYSCFG_DisableFastModePlus(uint32_t ConfigFastModePlus)
  439. {
  440. CLEAR_BIT(SYSCFG->PMC, ConfigFastModePlus);
  441. }
  442. #endif /* SYSCFG_PMC_I2C1_FMP */
  443. /**
  444. * @brief Configure source input for the EXTI external interrupt.
  445. * @rmtoll SYSCFG_EXTICR1 EXTIx LL_SYSCFG_SetEXTISource\n
  446. * SYSCFG_EXTICR2 EXTIx LL_SYSCFG_SetEXTISource\n
  447. * SYSCFG_EXTICR3 EXTIx LL_SYSCFG_SetEXTISource\n
  448. * SYSCFG_EXTICR4 EXTIx LL_SYSCFG_SetEXTISource
  449. * @param Port This parameter can be one of the following values:
  450. * @arg @ref LL_SYSCFG_EXTI_PORTA
  451. * @arg @ref LL_SYSCFG_EXTI_PORTB
  452. * @arg @ref LL_SYSCFG_EXTI_PORTC
  453. * @arg @ref LL_SYSCFG_EXTI_PORTD
  454. * @arg @ref LL_SYSCFG_EXTI_PORTE
  455. * @arg @ref LL_SYSCFG_EXTI_PORTF
  456. * @arg @ref LL_SYSCFG_EXTI_PORTG
  457. * @arg @ref LL_SYSCFG_EXTI_PORTH
  458. * @arg @ref LL_SYSCFG_EXTI_PORTI
  459. * @arg @ref LL_SYSCFG_EXTI_PORTJ
  460. * @arg @ref LL_SYSCFG_EXTI_PORTK
  461. *
  462. * (*) value not defined in all devices
  463. * @param Line This parameter can be one of the following values:
  464. * @arg @ref LL_SYSCFG_EXTI_LINE0
  465. * @arg @ref LL_SYSCFG_EXTI_LINE1
  466. * @arg @ref LL_SYSCFG_EXTI_LINE2
  467. * @arg @ref LL_SYSCFG_EXTI_LINE3
  468. * @arg @ref LL_SYSCFG_EXTI_LINE4
  469. * @arg @ref LL_SYSCFG_EXTI_LINE5
  470. * @arg @ref LL_SYSCFG_EXTI_LINE6
  471. * @arg @ref LL_SYSCFG_EXTI_LINE7
  472. * @arg @ref LL_SYSCFG_EXTI_LINE8
  473. * @arg @ref LL_SYSCFG_EXTI_LINE9
  474. * @arg @ref LL_SYSCFG_EXTI_LINE10
  475. * @arg @ref LL_SYSCFG_EXTI_LINE11
  476. * @arg @ref LL_SYSCFG_EXTI_LINE12
  477. * @arg @ref LL_SYSCFG_EXTI_LINE13
  478. * @arg @ref LL_SYSCFG_EXTI_LINE14
  479. * @arg @ref LL_SYSCFG_EXTI_LINE15
  480. * @retval None
  481. */
  482. __STATIC_INLINE void LL_SYSCFG_SetEXTISource(uint32_t Port, uint32_t Line)
  483. {
  484. MODIFY_REG(SYSCFG->EXTICR[Line & 0xFFU], (Line >> 16U), Port << POSITION_VAL((Line >> 16U)));
  485. }
  486. /**
  487. * @brief Get the configured defined for specific EXTI Line
  488. * @rmtoll SYSCFG_EXTICR1 EXTIx LL_SYSCFG_GetEXTISource\n
  489. * SYSCFG_EXTICR2 EXTIx LL_SYSCFG_GetEXTISource\n
  490. * SYSCFG_EXTICR3 EXTIx LL_SYSCFG_GetEXTISource\n
  491. * SYSCFG_EXTICR4 EXTIx LL_SYSCFG_GetEXTISource
  492. * @param Line This parameter can be one of the following values:
  493. * @arg @ref LL_SYSCFG_EXTI_LINE0
  494. * @arg @ref LL_SYSCFG_EXTI_LINE1
  495. * @arg @ref LL_SYSCFG_EXTI_LINE2
  496. * @arg @ref LL_SYSCFG_EXTI_LINE3
  497. * @arg @ref LL_SYSCFG_EXTI_LINE4
  498. * @arg @ref LL_SYSCFG_EXTI_LINE5
  499. * @arg @ref LL_SYSCFG_EXTI_LINE6
  500. * @arg @ref LL_SYSCFG_EXTI_LINE7
  501. * @arg @ref LL_SYSCFG_EXTI_LINE8
  502. * @arg @ref LL_SYSCFG_EXTI_LINE9
  503. * @arg @ref LL_SYSCFG_EXTI_LINE10
  504. * @arg @ref LL_SYSCFG_EXTI_LINE11
  505. * @arg @ref LL_SYSCFG_EXTI_LINE12
  506. * @arg @ref LL_SYSCFG_EXTI_LINE13
  507. * @arg @ref LL_SYSCFG_EXTI_LINE14
  508. * @arg @ref LL_SYSCFG_EXTI_LINE15
  509. * @retval Returned value can be one of the following values:
  510. * @arg @ref LL_SYSCFG_EXTI_PORTA
  511. * @arg @ref LL_SYSCFG_EXTI_PORTB
  512. * @arg @ref LL_SYSCFG_EXTI_PORTC
  513. * @arg @ref LL_SYSCFG_EXTI_PORTD
  514. * @arg @ref LL_SYSCFG_EXTI_PORTE
  515. * @arg @ref LL_SYSCFG_EXTI_PORTF
  516. * @arg @ref LL_SYSCFG_EXTI_PORTG
  517. * @arg @ref LL_SYSCFG_EXTI_PORTH
  518. * @arg @ref LL_SYSCFG_EXTI_PORTI
  519. * @arg @ref LL_SYSCFG_EXTI_PORTJ
  520. * @arg @ref LL_SYSCFG_EXTI_PORTK
  521. * (*) value not defined in all devices
  522. */
  523. __STATIC_INLINE uint32_t LL_SYSCFG_GetEXTISource(uint32_t Line)
  524. {
  525. return (uint32_t)(READ_BIT(SYSCFG->EXTICR[Line & 0xFFU], (Line >> 16U)) >> POSITION_VAL(Line >> 16U));
  526. }
  527. #if defined(SYSCFG_CBR_CLL)
  528. /**
  529. * @brief Set connections to TIM1/8/15/16/17 Break inputs
  530. * SYSCFG_CBR CLL LL_SYSCFG_SetTIMBreakInputs\n
  531. * SYSCFG_CBR PVDL LL_SYSCFG_SetTIMBreakInputs
  532. * @param Break This parameter can be a combination of the following values:
  533. * @arg @ref LL_SYSCFG_TIMBREAK_LOCKUP
  534. * @arg @ref LL_SYSCFG_TIMBREAK_PVD
  535. * @retval None
  536. */
  537. __STATIC_INLINE void LL_SYSCFG_SetTIMBreakInputs(uint32_t Break)
  538. {
  539. MODIFY_REG(SYSCFG->CBR, SYSCFG_CBR_CLL | SYSCFG_CBR_PVDL, Break);
  540. }
  541. /**
  542. * @brief Get connections to TIM1/8/15/16/17 Break inputs
  543. * SYSCFG_CBR CLL LL_SYSCFG_GetTIMBreakInputs\n
  544. * SYSCFG_CBR PVDL LL_SYSCFG_GetTIMBreakInputs
  545. * @retval Returned value can be can be a combination of the following values:
  546. * @arg @ref LL_SYSCFG_TIMBREAK_LOCKUP
  547. * @arg @ref LL_SYSCFG_TIMBREAK_PVD
  548. */
  549. __STATIC_INLINE uint32_t LL_SYSCFG_GetTIMBreakInputs(void)
  550. {
  551. return (uint32_t)(READ_BIT(SYSCFG->CBR, SYSCFG_CBR_CLL | SYSCFG_CBR_PVDL));
  552. }
  553. #endif /* SYSCFG_CBR_CLL */
  554. /**
  555. * @}
  556. */
  557. /** @defgroup SYSTEM_LL_EF_DBGMCU DBGMCU
  558. * @{
  559. */
  560. /**
  561. * @brief Return the device identifier
  562. * @note For STM32F75xxx and STM32F74xxx devices, the device ID is 0x449
  563. * @note For STM32F77xxx and STM32F76xxx devices, the device ID is 0x451
  564. * @note For STM32F72xxx and STM32F73xxx devices, the device ID is 0x452
  565. * @rmtoll DBGMCU_IDCODE DEV_ID LL_DBGMCU_GetDeviceID
  566. * @retval Values between Min_Data=0x00 and Max_Data=0xFFF
  567. */
  568. __STATIC_INLINE uint32_t LL_DBGMCU_GetDeviceID(void)
  569. {
  570. return (uint32_t)(READ_BIT(DBGMCU->IDCODE, DBGMCU_IDCODE_DEV_ID));
  571. }
  572. /**
  573. * @brief Return the device revision identifier
  574. * @note This field indicates the revision of the device.
  575. For example, it is read as RevA -> 0x1000, Cat 2 revZ -> 0x1001
  576. * @rmtoll DBGMCU_IDCODE REV_ID LL_DBGMCU_GetRevisionID
  577. * @retval Values between Min_Data=0x00 and Max_Data=0xFFFF
  578. */
  579. __STATIC_INLINE uint32_t LL_DBGMCU_GetRevisionID(void)
  580. {
  581. return (uint32_t)(READ_BIT(DBGMCU->IDCODE, DBGMCU_IDCODE_REV_ID) >> DBGMCU_IDCODE_REV_ID_Pos);
  582. }
  583. /**
  584. * @brief Enable the Debug Module during SLEEP mode
  585. * @rmtoll DBGMCU_CR DBG_SLEEP LL_DBGMCU_EnableDBGSleepMode
  586. * @retval None
  587. */
  588. __STATIC_INLINE void LL_DBGMCU_EnableDBGSleepMode(void)
  589. {
  590. SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
  591. }
  592. /**
  593. * @brief Disable the Debug Module during SLEEP mode
  594. * @rmtoll DBGMCU_CR DBG_SLEEP LL_DBGMCU_DisableDBGSleepMode
  595. * @retval None
  596. */
  597. __STATIC_INLINE void LL_DBGMCU_DisableDBGSleepMode(void)
  598. {
  599. CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_SLEEP);
  600. }
  601. /**
  602. * @brief Enable the Debug Module during STOP mode
  603. * @rmtoll DBGMCU_CR DBG_STOP LL_DBGMCU_EnableDBGStopMode
  604. * @retval None
  605. */
  606. __STATIC_INLINE void LL_DBGMCU_EnableDBGStopMode(void)
  607. {
  608. SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
  609. }
  610. /**
  611. * @brief Disable the Debug Module during STOP mode
  612. * @rmtoll DBGMCU_CR DBG_STOP LL_DBGMCU_DisableDBGStopMode
  613. * @retval None
  614. */
  615. __STATIC_INLINE void LL_DBGMCU_DisableDBGStopMode(void)
  616. {
  617. CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STOP);
  618. }
  619. /**
  620. * @brief Enable the Debug Module during STANDBY mode
  621. * @rmtoll DBGMCU_CR DBG_STANDBY LL_DBGMCU_EnableDBGStandbyMode
  622. * @retval None
  623. */
  624. __STATIC_INLINE void LL_DBGMCU_EnableDBGStandbyMode(void)
  625. {
  626. SET_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
  627. }
  628. /**
  629. * @brief Disable the Debug Module during STANDBY mode
  630. * @rmtoll DBGMCU_CR DBG_STANDBY LL_DBGMCU_DisableDBGStandbyMode
  631. * @retval None
  632. */
  633. __STATIC_INLINE void LL_DBGMCU_DisableDBGStandbyMode(void)
  634. {
  635. CLEAR_BIT(DBGMCU->CR, DBGMCU_CR_DBG_STANDBY);
  636. }
  637. /**
  638. * @brief Set Trace pin assignment control
  639. * @rmtoll DBGMCU_CR TRACE_IOEN LL_DBGMCU_SetTracePinAssignment\n
  640. * DBGMCU_CR TRACE_MODE LL_DBGMCU_SetTracePinAssignment
  641. * @param PinAssignment This parameter can be one of the following values:
  642. * @arg @ref LL_DBGMCU_TRACE_NONE
  643. * @arg @ref LL_DBGMCU_TRACE_ASYNCH
  644. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE1
  645. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE2
  646. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE4
  647. * @retval None
  648. */
  649. __STATIC_INLINE void LL_DBGMCU_SetTracePinAssignment(uint32_t PinAssignment)
  650. {
  651. MODIFY_REG(DBGMCU->CR, DBGMCU_CR_TRACE_IOEN | DBGMCU_CR_TRACE_MODE, PinAssignment);
  652. }
  653. /**
  654. * @brief Get Trace pin assignment control
  655. * @rmtoll DBGMCU_CR TRACE_IOEN LL_DBGMCU_GetTracePinAssignment\n
  656. * DBGMCU_CR TRACE_MODE LL_DBGMCU_GetTracePinAssignment
  657. * @retval Returned value can be one of the following values:
  658. * @arg @ref LL_DBGMCU_TRACE_NONE
  659. * @arg @ref LL_DBGMCU_TRACE_ASYNCH
  660. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE1
  661. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE2
  662. * @arg @ref LL_DBGMCU_TRACE_SYNCH_SIZE4
  663. */
  664. __STATIC_INLINE uint32_t LL_DBGMCU_GetTracePinAssignment(void)
  665. {
  666. return (uint32_t)(READ_BIT(DBGMCU->CR, DBGMCU_CR_TRACE_IOEN | DBGMCU_CR_TRACE_MODE));
  667. }
  668. /**
  669. * @brief Freeze APB1 peripherals (group1 peripherals)
  670. * @rmtoll DBGMCU_APB1_FZ DBG_TIM2_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  671. * DBGMCU_APB1_FZ DBG_TIM3_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  672. * DBGMCU_APB1_FZ DBG_TIM4_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  673. * DBGMCU_APB1_FZ DBG_TIM5_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  674. * DBGMCU_APB1_FZ DBG_TIM6_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  675. * DBGMCU_APB1_FZ DBG_TIM7_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  676. * DBGMCU_APB1_FZ DBG_TIM12_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  677. * DBGMCU_APB1_FZ DBG_TIM13_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  678. * DBGMCU_APB1_FZ DBG_TIM14_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  679. * DBGMCU_APB1_FZ DBG_LPTIM1_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  680. * DBGMCU_APB1_FZ DBG_RTC_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  681. * DBGMCU_APB1_FZ DBG_WWDG_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  682. * DBGMCU_APB1_FZ DBG_IWDG_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  683. * DBGMCU_APB1_FZ DBG_I2C1_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  684. * DBGMCU_APB1_FZ DBG_I2C2_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  685. * DBGMCU_APB1_FZ DBG_I2C3_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  686. * DBGMCU_APB1_FZ DBG_I2C4_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  687. * DBGMCU_APB1_FZ DBG_CAN1_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  688. * DBGMCU_APB1_FZ DBG_CAN2_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph\n
  689. * DBGMCU_APB1_FZ DBG_CAN3_STOP LL_DBGMCU_APB1_GRP1_FreezePeriph
  690. * @param Periphs This parameter can be a combination of the following values:
  691. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM2_STOP
  692. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM3_STOP
  693. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM4_STOP
  694. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM5_STOP
  695. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM6_STOP
  696. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM7_STOP
  697. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM12_STOP
  698. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM13_STOP
  699. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM14_STOP
  700. * @arg @ref LL_DBGMCU_APB1_GRP1_LPTIM1_STOP
  701. * @arg @ref LL_DBGMCU_APB1_GRP1_RTC_STOP
  702. * @arg @ref LL_DBGMCU_APB1_GRP1_WWDG_STOP
  703. * @arg @ref LL_DBGMCU_APB1_GRP1_IWDG_STOP
  704. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C1_STOP
  705. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C2_STOP
  706. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C3_STOP
  707. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C4_STOP (*)
  708. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN1_STOP
  709. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN2_STOP (*)
  710. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN3_STOP (*)
  711. *
  712. * (*) value not defined in all devices.
  713. * @retval None
  714. */
  715. __STATIC_INLINE void LL_DBGMCU_APB1_GRP1_FreezePeriph(uint32_t Periphs)
  716. {
  717. SET_BIT(DBGMCU->APB1FZ, Periphs);
  718. }
  719. /**
  720. * @brief Unfreeze APB1 peripherals (group1 peripherals)
  721. * @rmtoll DBGMCU_APB1_FZ DBG_TIM2_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  722. * DBGMCU_APB1_FZ DBG_TIM3_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  723. * DBGMCU_APB1_FZ DBG_TIM4_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  724. * DBGMCU_APB1_FZ DBG_TIM5_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  725. * DBGMCU_APB1_FZ DBG_TIM6_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  726. * DBGMCU_APB1_FZ DBG_TIM7_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  727. * DBGMCU_APB1_FZ DBG_TIM12_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  728. * DBGMCU_APB1_FZ DBG_TIM13_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  729. * DBGMCU_APB1_FZ DBG_TIM14_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  730. * DBGMCU_APB1_FZ DBG_LPTIM1_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  731. * DBGMCU_APB1_FZ DBG_RTC_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  732. * DBGMCU_APB1_FZ DBG_WWDG_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  733. * DBGMCU_APB1_FZ DBG_IWDG_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  734. * DBGMCU_APB1_FZ DBG_I2C1_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  735. * DBGMCU_APB1_FZ DBG_I2C2_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  736. * DBGMCU_APB1_FZ DBG_I2C3_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  737. * DBGMCU_APB1_FZ DBG_I2C4_SMBUS_TIMEOUT LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  738. * DBGMCU_APB1_FZ DBG_CAN1_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  739. * DBGMCU_APB1_FZ DBG_CAN2_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph\n
  740. * DBGMCU_APB1_FZ DBG_CAN3_STOP LL_DBGMCU_APB1_GRP1_UnFreezePeriph
  741. * @param Periphs This parameter can be a combination of the following values:
  742. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM2_STOP
  743. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM3_STOP
  744. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM4_STOP
  745. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM5_STOP
  746. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM6_STOP
  747. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM7_STOP
  748. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM12_STOP
  749. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM13_STOP
  750. * @arg @ref LL_DBGMCU_APB1_GRP1_TIM14_STOP
  751. * @arg @ref LL_DBGMCU_APB1_GRP1_LPTIM1_STOP
  752. * @arg @ref LL_DBGMCU_APB1_GRP1_RTC_STOP
  753. * @arg @ref LL_DBGMCU_APB1_GRP1_WWDG_STOP
  754. * @arg @ref LL_DBGMCU_APB1_GRP1_IWDG_STOP
  755. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C1_STOP
  756. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C2_STOP
  757. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C3_STOP
  758. * @arg @ref LL_DBGMCU_APB1_GRP1_I2C4_STOP (*)
  759. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN1_STOP
  760. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN2_STOP (*)
  761. * @arg @ref LL_DBGMCU_APB1_GRP1_CAN3_STOP (*)
  762. * (*) value not defined in all devices.
  763. * @retval None
  764. */
  765. __STATIC_INLINE void LL_DBGMCU_APB1_GRP1_UnFreezePeriph(uint32_t Periphs)
  766. {
  767. CLEAR_BIT(DBGMCU->APB1FZ, Periphs);
  768. }
  769. /**
  770. * @brief Freeze APB2 peripherals
  771. * @rmtoll DBGMCU_APB2_FZ DBG_TIM1_STOP LL_DBGMCU_APB2_GRP1_FreezePeriph\n
  772. * DBGMCU_APB2_FZ DBG_TIM8_STOP LL_DBGMCU_APB2_GRP1_FreezePeriph\n
  773. * DBGMCU_APB2_FZ DBG_TIM9_STOP LL_DBGMCU_APB2_GRP1_FreezePeriph\n
  774. * DBGMCU_APB2_FZ DBG_TIM10_STOP LL_DBGMCU_APB2_GRP1_FreezePeriph\n
  775. * DBGMCU_APB2_FZ DBG_TIM11_STOP LL_DBGMCU_APB2_GRP1_FreezePeriph
  776. * @param Periphs This parameter can be a combination of the following values:
  777. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM1_STOP
  778. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM8_STOP
  779. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM9_STOP
  780. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM10_STOP
  781. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM11_STOP
  782. *
  783. * (*) value not defined in all devices.
  784. * @retval None
  785. */
  786. __STATIC_INLINE void LL_DBGMCU_APB2_GRP1_FreezePeriph(uint32_t Periphs)
  787. {
  788. SET_BIT(DBGMCU->APB2FZ, Periphs);
  789. }
  790. /**
  791. * @brief Unfreeze APB2 peripherals
  792. * @rmtoll DBGMCU_APB2_FZ DBG_TIM1_STOP LL_DBGMCU_APB2_GRP1_UnFreezePeriph\n
  793. * DBGMCU_APB2_FZ DBG_TIM8_STOP LL_DBGMCU_APB2_GRP1_UnFreezePeriph\n
  794. * DBGMCU_APB2_FZ DBG_TIM9_STOP LL_DBGMCU_APB2_GRP1_UnFreezePeriph\n
  795. * DBGMCU_APB2_FZ DBG_TIM10_STOP LL_DBGMCU_APB2_GRP1_UnFreezePeriph\n
  796. * DBGMCU_APB2_FZ DBG_TIM11_STOP LL_DBGMCU_APB2_GRP1_UnFreezePeriph
  797. * @param Periphs This parameter can be a combination of the following values:
  798. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM1_STOP
  799. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM8_STOP
  800. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM9_STOP
  801. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM10_STOP
  802. * @arg @ref LL_DBGMCU_APB2_GRP1_TIM11_STOP
  803. *
  804. * (*) value not defined in all devices.
  805. * @retval None
  806. */
  807. __STATIC_INLINE void LL_DBGMCU_APB2_GRP1_UnFreezePeriph(uint32_t Periphs)
  808. {
  809. CLEAR_BIT(DBGMCU->APB2FZ, Periphs);
  810. }
  811. /**
  812. * @}
  813. */
  814. /** @defgroup SYSTEM_LL_EF_FLASH FLASH
  815. * @{
  816. */
  817. /**
  818. * @brief Set FLASH Latency
  819. * @rmtoll FLASH_ACR LATENCY LL_FLASH_SetLatency
  820. * @param Latency This parameter can be one of the following values:
  821. * @arg @ref LL_FLASH_LATENCY_0
  822. * @arg @ref LL_FLASH_LATENCY_1
  823. * @arg @ref LL_FLASH_LATENCY_2
  824. * @arg @ref LL_FLASH_LATENCY_3
  825. * @arg @ref LL_FLASH_LATENCY_4
  826. * @arg @ref LL_FLASH_LATENCY_5
  827. * @arg @ref LL_FLASH_LATENCY_6
  828. * @arg @ref LL_FLASH_LATENCY_7
  829. * @arg @ref LL_FLASH_LATENCY_8
  830. * @arg @ref LL_FLASH_LATENCY_9
  831. * @arg @ref LL_FLASH_LATENCY_10
  832. * @arg @ref LL_FLASH_LATENCY_11
  833. * @arg @ref LL_FLASH_LATENCY_12
  834. * @arg @ref LL_FLASH_LATENCY_13
  835. * @arg @ref LL_FLASH_LATENCY_14
  836. * @arg @ref LL_FLASH_LATENCY_15
  837. * @retval None
  838. */
  839. __STATIC_INLINE void LL_FLASH_SetLatency(uint32_t Latency)
  840. {
  841. MODIFY_REG(FLASH->ACR, FLASH_ACR_LATENCY, Latency);
  842. }
  843. /**
  844. * @brief Get FLASH Latency
  845. * @rmtoll FLASH_ACR LATENCY LL_FLASH_GetLatency
  846. * @retval Returned value can be one of the following values:
  847. * @arg @ref LL_FLASH_LATENCY_0
  848. * @arg @ref LL_FLASH_LATENCY_1
  849. * @arg @ref LL_FLASH_LATENCY_2
  850. * @arg @ref LL_FLASH_LATENCY_3
  851. * @arg @ref LL_FLASH_LATENCY_4
  852. * @arg @ref LL_FLASH_LATENCY_5
  853. * @arg @ref LL_FLASH_LATENCY_6
  854. * @arg @ref LL_FLASH_LATENCY_7
  855. * @arg @ref LL_FLASH_LATENCY_8
  856. * @arg @ref LL_FLASH_LATENCY_9
  857. * @arg @ref LL_FLASH_LATENCY_10
  858. * @arg @ref LL_FLASH_LATENCY_11
  859. * @arg @ref LL_FLASH_LATENCY_12
  860. * @arg @ref LL_FLASH_LATENCY_13
  861. * @arg @ref LL_FLASH_LATENCY_14
  862. * @arg @ref LL_FLASH_LATENCY_15
  863. */
  864. __STATIC_INLINE uint32_t LL_FLASH_GetLatency(void)
  865. {
  866. return (uint32_t)(READ_BIT(FLASH->ACR, FLASH_ACR_LATENCY));
  867. }
  868. /**
  869. * @brief Enable Prefetch
  870. * @rmtoll FLASH_ACR PRFTEN LL_FLASH_EnablePrefetch
  871. * @retval None
  872. */
  873. __STATIC_INLINE void LL_FLASH_EnablePrefetch(void)
  874. {
  875. SET_BIT(FLASH->ACR, FLASH_ACR_PRFTEN);
  876. }
  877. /**
  878. * @brief Disable Prefetch
  879. * @rmtoll FLASH_ACR PRFTEN LL_FLASH_DisablePrefetch
  880. * @retval None
  881. */
  882. __STATIC_INLINE void LL_FLASH_DisablePrefetch(void)
  883. {
  884. CLEAR_BIT(FLASH->ACR, FLASH_ACR_PRFTEN);
  885. }
  886. /**
  887. * @brief Check if Prefetch buffer is enabled
  888. * @rmtoll FLASH_ACR PRFTEN LL_FLASH_IsPrefetchEnabled
  889. * @retval State of bit (1 or 0).
  890. */
  891. __STATIC_INLINE uint32_t LL_FLASH_IsPrefetchEnabled(void)
  892. {
  893. return (READ_BIT(FLASH->ACR, FLASH_ACR_PRFTEN) == (FLASH_ACR_PRFTEN));
  894. }
  895. /**
  896. * @brief Enable ART Accelerator
  897. * @rmtoll FLASH_ACR ARTEN LL_FLASH_EnableART
  898. * @retval None
  899. */
  900. __STATIC_INLINE void LL_FLASH_EnableART(void)
  901. {
  902. SET_BIT(FLASH->ACR, FLASH_ACR_ARTEN);
  903. }
  904. /**
  905. * @brief Disable ART Accelerator
  906. * @rmtoll FLASH_ACR ARTEN LL_FLASH_DisableART
  907. * @retval None
  908. */
  909. __STATIC_INLINE void LL_FLASH_DisableART(void)
  910. {
  911. CLEAR_BIT(FLASH->ACR, FLASH_ACR_ARTEN);
  912. }
  913. /**
  914. * @brief Enable ART Reset
  915. * @rmtoll FLASH_ACR ARTRST LL_FLASH_EnableARTReset
  916. * @retval None
  917. */
  918. __STATIC_INLINE void LL_FLASH_EnableARTReset(void)
  919. {
  920. SET_BIT(FLASH->ACR, FLASH_ACR_ARTRST);
  921. }
  922. /**
  923. * @brief Disable ART Reset
  924. * @rmtoll FLASH_ACR ARTRST LL_FLASH_DisableARTReset
  925. * @retval None
  926. */
  927. __STATIC_INLINE void LL_FLASH_DisableARTReset(void)
  928. {
  929. CLEAR_BIT(FLASH->ACR, FLASH_ACR_ARTRST);
  930. }
  931. /**
  932. * @}
  933. */
  934. /**
  935. * @}
  936. */
  937. /**
  938. * @}
  939. */
  940. #endif /* defined (FLASH) || defined (SYSCFG) || defined (DBGMCU) */
  941. /**
  942. * @}
  943. */
  944. #ifdef __cplusplus
  945. }
  946. #endif
  947. #endif /* __STM32F7xx_LL_SYSTEM_H */
  948. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/