stm32l4xx_ll_pwr.h 54 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675
  1. /**
  2. ******************************************************************************
  3. * @file stm32l4xx_ll_pwr.h
  4. * @author MCD Application Team
  5. * @brief Header file of PWR LL 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
  13. * in the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. *
  16. ******************************************************************************
  17. */
  18. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef STM32L4xx_LL_PWR_H
  20. #define STM32L4xx_LL_PWR_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32l4xx.h"
  26. /** @addtogroup STM32L4xx_LL_Driver
  27. * @{
  28. */
  29. #if defined(PWR)
  30. /** @defgroup PWR_LL PWR
  31. * @{
  32. */
  33. /* Private types -------------------------------------------------------------*/
  34. /* Private variables ---------------------------------------------------------*/
  35. /* Private constants ---------------------------------------------------------*/
  36. /* Private macros ------------------------------------------------------------*/
  37. /* Exported types ------------------------------------------------------------*/
  38. /* Exported constants --------------------------------------------------------*/
  39. /** @defgroup PWR_LL_Exported_Constants PWR Exported Constants
  40. * @{
  41. */
  42. /** @defgroup PWR_LL_EC_CLEAR_FLAG Clear Flags Defines
  43. * @brief Flags defines which can be used with LL_PWR_WriteReg function
  44. * @{
  45. */
  46. #define LL_PWR_SCR_CSBF PWR_SCR_CSBF
  47. #define LL_PWR_SCR_CWUF PWR_SCR_CWUF
  48. #define LL_PWR_SCR_CWUF5 PWR_SCR_CWUF5
  49. #define LL_PWR_SCR_CWUF4 PWR_SCR_CWUF4
  50. #define LL_PWR_SCR_CWUF3 PWR_SCR_CWUF3
  51. #define LL_PWR_SCR_CWUF2 PWR_SCR_CWUF2
  52. #define LL_PWR_SCR_CWUF1 PWR_SCR_CWUF1
  53. /**
  54. * @}
  55. */
  56. /** @defgroup PWR_LL_EC_GET_FLAG Get Flags Defines
  57. * @brief Flags defines which can be used with LL_PWR_ReadReg function
  58. * @{
  59. */
  60. #define LL_PWR_SR1_WUFI PWR_SR1_WUFI
  61. #if defined(PWR_SR1_EXT_SMPS_RDY)
  62. #define LL_PWR_SR1_EXT_SMPS_RDY PWR_SR1_EXT_SMPS_RDY
  63. #endif /* PWR_SR1_EXT_SMPS_RDY */
  64. #define LL_PWR_SR1_SBF PWR_SR1_SBF
  65. #define LL_PWR_SR1_WUF5 PWR_SR1_WUF5
  66. #define LL_PWR_SR1_WUF4 PWR_SR1_WUF4
  67. #define LL_PWR_SR1_WUF3 PWR_SR1_WUF3
  68. #define LL_PWR_SR1_WUF2 PWR_SR1_WUF2
  69. #define LL_PWR_SR1_WUF1 PWR_SR1_WUF1
  70. #if defined(PWR_SR2_PVMO4)
  71. #define LL_PWR_SR2_PVMO4 PWR_SR2_PVMO4
  72. #endif /* PWR_SR2_PVMO4 */
  73. #if defined(PWR_SR2_PVMO3)
  74. #define LL_PWR_SR2_PVMO3 PWR_SR2_PVMO3
  75. #endif /* PWR_SR2_PVMO3 */
  76. #if defined(PWR_SR2_PVMO2)
  77. #define LL_PWR_SR2_PVMO2 PWR_SR2_PVMO2
  78. #endif /* PWR_SR2_PVMO2 */
  79. #if defined(PWR_SR2_PVMO1)
  80. #define LL_PWR_SR2_PVMO1 PWR_SR2_PVMO1
  81. #endif /* PWR_SR2_PVMO1 */
  82. #define LL_PWR_SR2_PVDO PWR_SR2_PVDO
  83. #define LL_PWR_SR2_VOSF PWR_SR2_VOSF
  84. #define LL_PWR_SR2_REGLPF PWR_SR2_REGLPF
  85. #define LL_PWR_SR2_REGLPS PWR_SR2_REGLPS
  86. /**
  87. * @}
  88. */
  89. /** @defgroup PWR_LL_EC_REGU_VOLTAGE REGU VOLTAGE
  90. * @{
  91. */
  92. #define LL_PWR_REGU_VOLTAGE_SCALE1 (PWR_CR1_VOS_0)
  93. #define LL_PWR_REGU_VOLTAGE_SCALE2 (PWR_CR1_VOS_1)
  94. /**
  95. * @}
  96. */
  97. /** @defgroup PWR_LL_EC_MODE_PWR MODE PWR
  98. * @{
  99. */
  100. #define LL_PWR_MODE_STOP0 (PWR_CR1_LPMS_STOP0)
  101. #define LL_PWR_MODE_STOP1 (PWR_CR1_LPMS_STOP1)
  102. #define LL_PWR_MODE_STOP2 (PWR_CR1_LPMS_STOP2)
  103. #define LL_PWR_MODE_STANDBY (PWR_CR1_LPMS_STANDBY)
  104. #define LL_PWR_MODE_SHUTDOWN (PWR_CR1_LPMS_SHUTDOWN)
  105. /**
  106. * @}
  107. */
  108. /** @defgroup PWR_LL_EC_PVM_VDDUSB_1 Peripheral voltage monitoring
  109. * @{
  110. */
  111. #if defined(PWR_CR2_PVME1)
  112. #define LL_PWR_PVM_VDDUSB_1_2V (PWR_CR2_PVME1) /* Monitoring VDDUSB vs. 1.2V */
  113. #endif
  114. #if defined(PWR_CR2_PVME2)
  115. #define LL_PWR_PVM_VDDIO2_0_9V (PWR_CR2_PVME2) /* Monitoring VDDIO2 vs. 0.9V */
  116. #endif
  117. #if defined(PWR_CR2_PVME3)
  118. #define LL_PWR_PVM_VDDA_1_62V (PWR_CR2_PVME3) /* Monitoring VDDA vs. 1.62V */
  119. #endif
  120. #if defined(PWR_CR2_PVME4)
  121. #define LL_PWR_PVM_VDDA_2_2V (PWR_CR2_PVME4) /* Monitoring VDDA vs. 2.2V */
  122. #endif
  123. /**
  124. * @}
  125. */
  126. /** @defgroup PWR_LL_EC_PVDLEVEL PVDLEVEL
  127. * @{
  128. */
  129. #define LL_PWR_PVDLEVEL_0 (PWR_CR2_PLS_LEV0) /* VPVD0 around 2.0 V */
  130. #define LL_PWR_PVDLEVEL_1 (PWR_CR2_PLS_LEV1) /* VPVD1 around 2.2 V */
  131. #define LL_PWR_PVDLEVEL_2 (PWR_CR2_PLS_LEV2) /* VPVD2 around 2.4 V */
  132. #define LL_PWR_PVDLEVEL_3 (PWR_CR2_PLS_LEV3) /* VPVD3 around 2.5 V */
  133. #define LL_PWR_PVDLEVEL_4 (PWR_CR2_PLS_LEV4) /* VPVD4 around 2.6 V */
  134. #define LL_PWR_PVDLEVEL_5 (PWR_CR2_PLS_LEV5) /* VPVD5 around 2.8 V */
  135. #define LL_PWR_PVDLEVEL_6 (PWR_CR2_PLS_LEV6) /* VPVD6 around 2.9 V */
  136. #define LL_PWR_PVDLEVEL_7 (PWR_CR2_PLS_LEV7) /* External input analog voltage (Compare internally to VREFINT) */
  137. /**
  138. * @}
  139. */
  140. /** @defgroup PWR_LL_EC_WAKEUP WAKEUP
  141. * @{
  142. */
  143. #define LL_PWR_WAKEUP_PIN1 (PWR_CR3_EWUP1)
  144. #define LL_PWR_WAKEUP_PIN2 (PWR_CR3_EWUP2)
  145. #define LL_PWR_WAKEUP_PIN3 (PWR_CR3_EWUP3)
  146. #define LL_PWR_WAKEUP_PIN4 (PWR_CR3_EWUP4)
  147. #define LL_PWR_WAKEUP_PIN5 (PWR_CR3_EWUP5)
  148. /**
  149. * @}
  150. */
  151. /** @defgroup PWR_LL_EC_BATT_CHARG_RESISTOR BATT CHARG RESISTOR
  152. * @{
  153. */
  154. #define LL_PWR_BATT_CHARG_RESISTOR_5K (0x00000000U)
  155. #define LL_PWR_BATT_CHARGRESISTOR_1_5K (PWR_CR4_VBRS)
  156. /**
  157. * @}
  158. */
  159. /** @defgroup PWR_LL_EC_SRAM2_CONTENT_RETENTION SRAM2 CONTENT RETENTION
  160. * @{
  161. */
  162. #define LL_PWR_NO_SRAM2_RETENTION (0x00000000U)
  163. #if defined(PWR_CR3_RRS_1)
  164. #define LL_PWR_FULL_SRAM2_RETENTION PWR_CR3_RRS_0
  165. #define LL_PWR_4KBYTES_SRAM2_RETENTION PWR_CR3_RRS_1
  166. #else
  167. #define LL_PWR_FULL_SRAM2_RETENTION PWR_CR3_RRS
  168. #endif /* PWR_CR3_RRS_1 */
  169. /**
  170. * @}
  171. */
  172. /** @defgroup PWR_LL_EC_GPIO GPIO
  173. * @{
  174. */
  175. #define LL_PWR_GPIO_A ((uint32_t)(&(PWR->PUCRA)))
  176. #define LL_PWR_GPIO_B ((uint32_t)(&(PWR->PUCRB)))
  177. #define LL_PWR_GPIO_C ((uint32_t)(&(PWR->PUCRC)))
  178. #define LL_PWR_GPIO_D ((uint32_t)(&(PWR->PUCRD)))
  179. #define LL_PWR_GPIO_E ((uint32_t)(&(PWR->PUCRE)))
  180. #if defined(GPIOF)
  181. #define LL_PWR_GPIO_F ((uint32_t)(&(PWR->PUCRF)))
  182. #endif
  183. #if defined(GPIOG)
  184. #define LL_PWR_GPIO_G ((uint32_t)(&(PWR->PUCRG)))
  185. #endif
  186. #if defined(GPIOH)
  187. #define LL_PWR_GPIO_H ((uint32_t)(&(PWR->PUCRH)))
  188. #endif
  189. #if defined(GPIOI)
  190. #define LL_PWR_GPIO_I ((uint32_t)(&(PWR->PUCRI)))
  191. #endif
  192. /**
  193. * @}
  194. */
  195. /** @defgroup PWR_LL_EC_GPIO_BIT GPIO BIT
  196. * @{
  197. */
  198. #define LL_PWR_GPIO_BIT_0 (0x00000001U)
  199. #define LL_PWR_GPIO_BIT_1 (0x00000002U)
  200. #define LL_PWR_GPIO_BIT_2 (0x00000004U)
  201. #define LL_PWR_GPIO_BIT_3 (0x00000008U)
  202. #define LL_PWR_GPIO_BIT_4 (0x00000010U)
  203. #define LL_PWR_GPIO_BIT_5 (0x00000020U)
  204. #define LL_PWR_GPIO_BIT_6 (0x00000040U)
  205. #define LL_PWR_GPIO_BIT_7 (0x00000080U)
  206. #define LL_PWR_GPIO_BIT_8 (0x00000100U)
  207. #define LL_PWR_GPIO_BIT_9 (0x00000200U)
  208. #define LL_PWR_GPIO_BIT_10 (0x00000400U)
  209. #define LL_PWR_GPIO_BIT_11 (0x00000800U)
  210. #define LL_PWR_GPIO_BIT_12 (0x00001000U)
  211. #define LL_PWR_GPIO_BIT_13 (0x00002000U)
  212. #define LL_PWR_GPIO_BIT_14 (0x00004000U)
  213. #define LL_PWR_GPIO_BIT_15 (0x00008000U)
  214. /**
  215. * @}
  216. */
  217. /**
  218. * @}
  219. */
  220. /* Exported macro ------------------------------------------------------------*/
  221. /** @defgroup PWR_LL_Exported_Macros PWR Exported Macros
  222. * @{
  223. */
  224. /** @defgroup PWR_LL_EM_WRITE_READ Common Write and read registers Macros
  225. * @{
  226. */
  227. /**
  228. * @brief Write a value in PWR register
  229. * @param __REG__ Register to be written
  230. * @param __VALUE__ Value to be written in the register
  231. * @retval None
  232. */
  233. #define LL_PWR_WriteReg(__REG__, __VALUE__) WRITE_REG(PWR->__REG__, (__VALUE__))
  234. /**
  235. * @brief Read a value in PWR register
  236. * @param __REG__ Register to be read
  237. * @retval Register value
  238. */
  239. #define LL_PWR_ReadReg(__REG__) READ_REG(PWR->__REG__)
  240. /**
  241. * @}
  242. */
  243. /**
  244. * @}
  245. */
  246. /* Exported functions --------------------------------------------------------*/
  247. /** @defgroup PWR_LL_Exported_Functions PWR Exported Functions
  248. * @{
  249. */
  250. /** @defgroup PWR_LL_EF_Configuration Configuration
  251. * @{
  252. */
  253. /**
  254. * @brief Switch the regulator from main mode to low-power mode
  255. * @rmtoll CR1 LPR LL_PWR_EnableLowPowerRunMode
  256. * @retval None
  257. */
  258. __STATIC_INLINE void LL_PWR_EnableLowPowerRunMode(void)
  259. {
  260. SET_BIT(PWR->CR1, PWR_CR1_LPR);
  261. }
  262. /**
  263. * @brief Switch the regulator from low-power mode to main mode
  264. * @rmtoll CR1 LPR LL_PWR_DisableLowPowerRunMode
  265. * @retval None
  266. */
  267. __STATIC_INLINE void LL_PWR_DisableLowPowerRunMode(void)
  268. {
  269. CLEAR_BIT(PWR->CR1, PWR_CR1_LPR);
  270. }
  271. /**
  272. * @brief Switch from run main mode to run low-power mode.
  273. * @rmtoll CR1 LPR LL_PWR_EnterLowPowerRunMode
  274. * @retval None
  275. */
  276. __STATIC_INLINE void LL_PWR_EnterLowPowerRunMode(void)
  277. {
  278. LL_PWR_EnableLowPowerRunMode();
  279. }
  280. /**
  281. * @brief Switch from run main mode to low-power mode.
  282. * @rmtoll CR1 LPR LL_PWR_ExitLowPowerRunMode
  283. * @retval None
  284. */
  285. __STATIC_INLINE void LL_PWR_ExitLowPowerRunMode(void)
  286. {
  287. LL_PWR_DisableLowPowerRunMode();
  288. }
  289. /**
  290. * @brief Check if the regulator is in low-power mode
  291. * @rmtoll CR1 LPR LL_PWR_IsEnabledLowPowerRunMode
  292. * @retval State of bit (1 or 0).
  293. */
  294. __STATIC_INLINE uint32_t LL_PWR_IsEnabledLowPowerRunMode(void)
  295. {
  296. return ((READ_BIT(PWR->CR1, PWR_CR1_LPR) == (PWR_CR1_LPR)) ? 1UL : 0UL);
  297. }
  298. /**
  299. * @brief Set the main internal regulator output voltage
  300. * @note This configuration may be completed with LL_PWR_EnableRange1BoostMode() on STM32L4Rx/STM32L4Sx devices.
  301. * @rmtoll CR1 VOS LL_PWR_SetRegulVoltageScaling
  302. * @param VoltageScaling This parameter can be one of the following values:
  303. * @arg @ref LL_PWR_REGU_VOLTAGE_SCALE1
  304. * @arg @ref LL_PWR_REGU_VOLTAGE_SCALE2
  305. * @retval None
  306. */
  307. __STATIC_INLINE void LL_PWR_SetRegulVoltageScaling(uint32_t VoltageScaling)
  308. {
  309. MODIFY_REG(PWR->CR1, PWR_CR1_VOS, VoltageScaling);
  310. }
  311. /**
  312. * @brief Get the main internal regulator output voltage
  313. * @rmtoll CR1 VOS LL_PWR_GetRegulVoltageScaling
  314. * @retval Returned value can be one of the following values:
  315. * @arg @ref LL_PWR_REGU_VOLTAGE_SCALE1
  316. * @arg @ref LL_PWR_REGU_VOLTAGE_SCALE2
  317. */
  318. __STATIC_INLINE uint32_t LL_PWR_GetRegulVoltageScaling(void)
  319. {
  320. return (uint32_t)(READ_BIT(PWR->CR1, PWR_CR1_VOS));
  321. }
  322. #if defined(PWR_CR5_R1MODE)
  323. /**
  324. * @brief Enable main regulator voltage range 1 boost mode
  325. * @rmtoll CR5 R1MODE LL_PWR_EnableRange1BoostMode
  326. * @retval None
  327. */
  328. __STATIC_INLINE void LL_PWR_EnableRange1BoostMode(void)
  329. {
  330. CLEAR_BIT(PWR->CR5, PWR_CR5_R1MODE);
  331. }
  332. /**
  333. * @brief Disable main regulator voltage range 1 boost mode
  334. * @rmtoll CR5 R1MODE LL_PWR_DisableRange1BoostMode
  335. * @retval None
  336. */
  337. __STATIC_INLINE void LL_PWR_DisableRange1BoostMode(void)
  338. {
  339. SET_BIT(PWR->CR5, PWR_CR5_R1MODE);
  340. }
  341. /**
  342. * @brief Check if the main regulator voltage range 1 boost mode is enabled
  343. * @rmtoll CR5 R1MODE LL_PWR_IsEnabledRange1BoostMode
  344. * @retval Inverted state of bit (0 or 1).
  345. */
  346. __STATIC_INLINE uint32_t LL_PWR_IsEnabledRange1BoostMode(void)
  347. {
  348. return ((READ_BIT(PWR->CR5, PWR_CR5_R1MODE) == 0x0U) ? 1UL : 0UL);
  349. }
  350. #endif /* PWR_CR5_R1MODE */
  351. /**
  352. * @brief Enable access to the backup domain
  353. * @rmtoll CR1 DBP LL_PWR_EnableBkUpAccess
  354. * @retval None
  355. */
  356. __STATIC_INLINE void LL_PWR_EnableBkUpAccess(void)
  357. {
  358. SET_BIT(PWR->CR1, PWR_CR1_DBP);
  359. }
  360. /**
  361. * @brief Disable access to the backup domain
  362. * @rmtoll CR1 DBP LL_PWR_DisableBkUpAccess
  363. * @retval None
  364. */
  365. __STATIC_INLINE void LL_PWR_DisableBkUpAccess(void)
  366. {
  367. CLEAR_BIT(PWR->CR1, PWR_CR1_DBP);
  368. }
  369. /**
  370. * @brief Check if the backup domain is enabled
  371. * @rmtoll CR1 DBP LL_PWR_IsEnabledBkUpAccess
  372. * @retval State of bit (1 or 0).
  373. */
  374. __STATIC_INLINE uint32_t LL_PWR_IsEnabledBkUpAccess(void)
  375. {
  376. return ((READ_BIT(PWR->CR1, PWR_CR1_DBP) == (PWR_CR1_DBP)) ? 1UL : 0UL);
  377. }
  378. /**
  379. * @brief Set Low-Power mode
  380. * @rmtoll CR1 LPMS LL_PWR_SetPowerMode
  381. * @param LowPowerMode This parameter can be one of the following values:
  382. * @arg @ref LL_PWR_MODE_STOP0
  383. * @arg @ref LL_PWR_MODE_STOP1
  384. * @arg @ref LL_PWR_MODE_STOP2
  385. * @arg @ref LL_PWR_MODE_STANDBY
  386. * @arg @ref LL_PWR_MODE_SHUTDOWN
  387. * @retval None
  388. */
  389. __STATIC_INLINE void LL_PWR_SetPowerMode(uint32_t LowPowerMode)
  390. {
  391. MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, LowPowerMode);
  392. }
  393. /**
  394. * @brief Get Low-Power mode
  395. * @rmtoll CR1 LPMS LL_PWR_GetPowerMode
  396. * @retval Returned value can be one of the following values:
  397. * @arg @ref LL_PWR_MODE_STOP0
  398. * @arg @ref LL_PWR_MODE_STOP1
  399. * @arg @ref LL_PWR_MODE_STOP2
  400. * @arg @ref LL_PWR_MODE_STANDBY
  401. * @arg @ref LL_PWR_MODE_SHUTDOWN
  402. */
  403. __STATIC_INLINE uint32_t LL_PWR_GetPowerMode(void)
  404. {
  405. return (uint32_t)(READ_BIT(PWR->CR1, PWR_CR1_LPMS));
  406. }
  407. #if defined(PWR_CR1_RRSTP)
  408. /**
  409. * @brief Enable SRAM3 content retention in Stop mode
  410. * @rmtoll CR1 RRSTP LL_PWR_EnableSRAM3Retention
  411. * @retval None
  412. */
  413. __STATIC_INLINE void LL_PWR_EnableSRAM3Retention(void)
  414. {
  415. SET_BIT(PWR->CR1, PWR_CR1_RRSTP);
  416. }
  417. /**
  418. * @brief Disable SRAM3 content retention in Stop mode
  419. * @rmtoll CR1 RRSTP LL_PWR_DisableSRAM3Retention
  420. * @retval None
  421. */
  422. __STATIC_INLINE void LL_PWR_DisableSRAM3Retention(void)
  423. {
  424. CLEAR_BIT(PWR->CR1, PWR_CR1_RRSTP);
  425. }
  426. /**
  427. * @brief Check if SRAM3 content retention in Stop mode is enabled
  428. * @rmtoll CR1 RRSTP LL_PWR_IsEnabledSRAM3Retention
  429. * @retval State of bit (1 or 0).
  430. */
  431. __STATIC_INLINE uint32_t LL_PWR_IsEnabledSRAM3Retention(void)
  432. {
  433. return ((READ_BIT(PWR->CR1, PWR_CR1_RRSTP) == (PWR_CR1_RRSTP)) ? 1UL : 0UL);
  434. }
  435. #endif /* PWR_CR1_RRSTP */
  436. #if defined(PWR_CR3_DSIPDEN)
  437. /**
  438. * @brief Enable pull-down activation on DSI pins
  439. * @rmtoll CR3 DSIPDEN LL_PWR_EnableDSIPinsPDActivation
  440. * @retval None
  441. */
  442. __STATIC_INLINE void LL_PWR_EnableDSIPinsPDActivation(void)
  443. {
  444. SET_BIT(PWR->CR3, PWR_CR3_DSIPDEN);
  445. }
  446. /**
  447. * @brief Disable pull-down activation on DSI pins
  448. * @rmtoll CR3 DSIPDEN LL_PWR_DisableDSIPinsPDActivation
  449. * @retval None
  450. */
  451. __STATIC_INLINE void LL_PWR_DisableDSIPinsPDActivation(void)
  452. {
  453. CLEAR_BIT(PWR->CR3, PWR_CR3_DSIPDEN);
  454. }
  455. /**
  456. * @brief Check if pull-down activation on DSI pins is enabled
  457. * @rmtoll CR3 DSIPDEN LL_PWR_IsEnabledDSIPinsPDActivation
  458. * @retval State of bit (1 or 0).
  459. */
  460. __STATIC_INLINE uint32_t LL_PWR_IsEnabledDSIPinsPDActivation(void)
  461. {
  462. return ((READ_BIT(PWR->CR3, PWR_CR3_DSIPDEN) == (PWR_CR3_DSIPDEN)) ? 1UL : 0UL);
  463. }
  464. #endif /* PWR_CR3_DSIPDEN */
  465. #if defined(PWR_CR2_USV)
  466. /**
  467. * @brief Enable VDDUSB supply
  468. * @rmtoll CR2 USV LL_PWR_EnableVddUSB
  469. * @retval None
  470. */
  471. __STATIC_INLINE void LL_PWR_EnableVddUSB(void)
  472. {
  473. SET_BIT(PWR->CR2, PWR_CR2_USV);
  474. }
  475. /**
  476. * @brief Disable VDDUSB supply
  477. * @rmtoll CR2 USV LL_PWR_DisableVddUSB
  478. * @retval None
  479. */
  480. __STATIC_INLINE void LL_PWR_DisableVddUSB(void)
  481. {
  482. CLEAR_BIT(PWR->CR2, PWR_CR2_USV);
  483. }
  484. /**
  485. * @brief Check if VDDUSB supply is enabled
  486. * @rmtoll CR2 USV LL_PWR_IsEnabledVddUSB
  487. * @retval State of bit (1 or 0).
  488. */
  489. __STATIC_INLINE uint32_t LL_PWR_IsEnabledVddUSB(void)
  490. {
  491. return ((READ_BIT(PWR->CR2, PWR_CR2_USV) == (PWR_CR2_USV)) ? 1UL : 0UL);
  492. }
  493. #endif
  494. #if defined(PWR_CR2_IOSV)
  495. /**
  496. * @brief Enable VDDIO2 supply
  497. * @rmtoll CR2 IOSV LL_PWR_EnableVddIO2
  498. * @retval None
  499. */
  500. __STATIC_INLINE void LL_PWR_EnableVddIO2(void)
  501. {
  502. SET_BIT(PWR->CR2, PWR_CR2_IOSV);
  503. }
  504. /**
  505. * @brief Disable VDDIO2 supply
  506. * @rmtoll CR2 IOSV LL_PWR_DisableVddIO2
  507. * @retval None
  508. */
  509. __STATIC_INLINE void LL_PWR_DisableVddIO2(void)
  510. {
  511. CLEAR_BIT(PWR->CR2, PWR_CR2_IOSV);
  512. }
  513. /**
  514. * @brief Check if VDDIO2 supply is enabled
  515. * @rmtoll CR2 IOSV LL_PWR_IsEnabledVddIO2
  516. * @retval State of bit (1 or 0).
  517. */
  518. __STATIC_INLINE uint32_t LL_PWR_IsEnabledVddIO2(void)
  519. {
  520. return ((READ_BIT(PWR->CR2, PWR_CR2_IOSV) == (PWR_CR2_IOSV)) ? 1UL : 0UL);
  521. }
  522. #endif
  523. /**
  524. * @brief Enable the Power Voltage Monitoring on a peripheral
  525. * @rmtoll CR2 PVME1 LL_PWR_EnablePVM\n
  526. * CR2 PVME2 LL_PWR_EnablePVM\n
  527. * CR2 PVME3 LL_PWR_EnablePVM\n
  528. * CR2 PVME4 LL_PWR_EnablePVM
  529. * @param PeriphVoltage This parameter can be one of the following values:
  530. * @arg @ref LL_PWR_PVM_VDDUSB_1_2V (*)
  531. * @arg @ref LL_PWR_PVM_VDDIO2_0_9V (*)
  532. * @arg @ref LL_PWR_PVM_VDDA_1_62V
  533. * @arg @ref LL_PWR_PVM_VDDA_2_2V
  534. *
  535. * (*) value not defined in all devices
  536. * @retval None
  537. */
  538. __STATIC_INLINE void LL_PWR_EnablePVM(uint32_t PeriphVoltage)
  539. {
  540. SET_BIT(PWR->CR2, PeriphVoltage);
  541. }
  542. /**
  543. * @brief Disable the Power Voltage Monitoring on a peripheral
  544. * @rmtoll CR2 PVME1 LL_PWR_DisablePVM\n
  545. * CR2 PVME2 LL_PWR_DisablePVM\n
  546. * CR2 PVME3 LL_PWR_DisablePVM\n
  547. * CR2 PVME4 LL_PWR_DisablePVM
  548. * @param PeriphVoltage This parameter can be one of the following values:
  549. * @arg @ref LL_PWR_PVM_VDDUSB_1_2V (*)
  550. * @arg @ref LL_PWR_PVM_VDDIO2_0_9V (*)
  551. * @arg @ref LL_PWR_PVM_VDDA_1_62V
  552. * @arg @ref LL_PWR_PVM_VDDA_2_2V
  553. *
  554. * (*) value not defined in all devices
  555. * @retval None
  556. */
  557. __STATIC_INLINE void LL_PWR_DisablePVM(uint32_t PeriphVoltage)
  558. {
  559. CLEAR_BIT(PWR->CR2, PeriphVoltage);
  560. }
  561. /**
  562. * @brief Check if Power Voltage Monitoring is enabled on a peripheral
  563. * @rmtoll CR2 PVME1 LL_PWR_IsEnabledPVM\n
  564. * CR2 PVME2 LL_PWR_IsEnabledPVM\n
  565. * CR2 PVME3 LL_PWR_IsEnabledPVM\n
  566. * CR2 PVME4 LL_PWR_IsEnabledPVM
  567. * @param PeriphVoltage This parameter can be one of the following values:
  568. * @arg @ref LL_PWR_PVM_VDDUSB_1_2V (*)
  569. * @arg @ref LL_PWR_PVM_VDDIO2_0_9V (*)
  570. * @arg @ref LL_PWR_PVM_VDDA_1_62V
  571. * @arg @ref LL_PWR_PVM_VDDA_2_2V
  572. *
  573. * (*) value not defined in all devices
  574. * @retval State of bit (1 or 0).
  575. */
  576. __STATIC_INLINE uint32_t LL_PWR_IsEnabledPVM(uint32_t PeriphVoltage)
  577. {
  578. return ((READ_BIT(PWR->CR2, PeriphVoltage) == (PeriphVoltage)) ? 1UL : 0UL);
  579. }
  580. /**
  581. * @brief Configure the voltage threshold detected by the Power Voltage Detector
  582. * @rmtoll CR2 PLS LL_PWR_SetPVDLevel
  583. * @param PVDLevel This parameter can be one of the following values:
  584. * @arg @ref LL_PWR_PVDLEVEL_0
  585. * @arg @ref LL_PWR_PVDLEVEL_1
  586. * @arg @ref LL_PWR_PVDLEVEL_2
  587. * @arg @ref LL_PWR_PVDLEVEL_3
  588. * @arg @ref LL_PWR_PVDLEVEL_4
  589. * @arg @ref LL_PWR_PVDLEVEL_5
  590. * @arg @ref LL_PWR_PVDLEVEL_6
  591. * @arg @ref LL_PWR_PVDLEVEL_7
  592. * @retval None
  593. */
  594. __STATIC_INLINE void LL_PWR_SetPVDLevel(uint32_t PVDLevel)
  595. {
  596. MODIFY_REG(PWR->CR2, PWR_CR2_PLS, PVDLevel);
  597. }
  598. /**
  599. * @brief Get the voltage threshold detection
  600. * @rmtoll CR2 PLS LL_PWR_GetPVDLevel
  601. * @retval Returned value can be one of the following values:
  602. * @arg @ref LL_PWR_PVDLEVEL_0
  603. * @arg @ref LL_PWR_PVDLEVEL_1
  604. * @arg @ref LL_PWR_PVDLEVEL_2
  605. * @arg @ref LL_PWR_PVDLEVEL_3
  606. * @arg @ref LL_PWR_PVDLEVEL_4
  607. * @arg @ref LL_PWR_PVDLEVEL_5
  608. * @arg @ref LL_PWR_PVDLEVEL_6
  609. * @arg @ref LL_PWR_PVDLEVEL_7
  610. */
  611. __STATIC_INLINE uint32_t LL_PWR_GetPVDLevel(void)
  612. {
  613. return (uint32_t)(READ_BIT(PWR->CR2, PWR_CR2_PLS));
  614. }
  615. /**
  616. * @brief Enable Power Voltage Detector
  617. * @rmtoll CR2 PVDE LL_PWR_EnablePVD
  618. * @retval None
  619. */
  620. __STATIC_INLINE void LL_PWR_EnablePVD(void)
  621. {
  622. SET_BIT(PWR->CR2, PWR_CR2_PVDE);
  623. }
  624. /**
  625. * @brief Disable Power Voltage Detector
  626. * @rmtoll CR2 PVDE LL_PWR_DisablePVD
  627. * @retval None
  628. */
  629. __STATIC_INLINE void LL_PWR_DisablePVD(void)
  630. {
  631. CLEAR_BIT(PWR->CR2, PWR_CR2_PVDE);
  632. }
  633. /**
  634. * @brief Check if Power Voltage Detector is enabled
  635. * @rmtoll CR2 PVDE LL_PWR_IsEnabledPVD
  636. * @retval State of bit (1 or 0).
  637. */
  638. __STATIC_INLINE uint32_t LL_PWR_IsEnabledPVD(void)
  639. {
  640. return ((READ_BIT(PWR->CR2, PWR_CR2_PVDE) == (PWR_CR2_PVDE)) ? 1UL : 0UL);
  641. }
  642. /**
  643. * @brief Enable Internal Wake-up line
  644. * @rmtoll CR3 EIWF LL_PWR_EnableInternWU
  645. * @retval None
  646. */
  647. __STATIC_INLINE void LL_PWR_EnableInternWU(void)
  648. {
  649. SET_BIT(PWR->CR3, PWR_CR3_EIWF);
  650. }
  651. /**
  652. * @brief Disable Internal Wake-up line
  653. * @rmtoll CR3 EIWF LL_PWR_DisableInternWU
  654. * @retval None
  655. */
  656. __STATIC_INLINE void LL_PWR_DisableInternWU(void)
  657. {
  658. CLEAR_BIT(PWR->CR3, PWR_CR3_EIWF);
  659. }
  660. /**
  661. * @brief Check if Internal Wake-up line is enabled
  662. * @rmtoll CR3 EIWF LL_PWR_IsEnabledInternWU
  663. * @retval State of bit (1 or 0).
  664. */
  665. __STATIC_INLINE uint32_t LL_PWR_IsEnabledInternWU(void)
  666. {
  667. return ((READ_BIT(PWR->CR3, PWR_CR3_EIWF) == (PWR_CR3_EIWF)) ? 1UL : 0UL);
  668. }
  669. /**
  670. * @brief Enable pull-up and pull-down configuration
  671. * @rmtoll CR3 APC LL_PWR_EnablePUPDCfg
  672. * @retval None
  673. */
  674. __STATIC_INLINE void LL_PWR_EnablePUPDCfg(void)
  675. {
  676. SET_BIT(PWR->CR3, PWR_CR3_APC);
  677. }
  678. /**
  679. * @brief Disable pull-up and pull-down configuration
  680. * @rmtoll CR3 APC LL_PWR_DisablePUPDCfg
  681. * @retval None
  682. */
  683. __STATIC_INLINE void LL_PWR_DisablePUPDCfg(void)
  684. {
  685. CLEAR_BIT(PWR->CR3, PWR_CR3_APC);
  686. }
  687. /**
  688. * @brief Check if pull-up and pull-down configuration is enabled
  689. * @rmtoll CR3 APC LL_PWR_IsEnabledPUPDCfg
  690. * @retval State of bit (1 or 0).
  691. */
  692. __STATIC_INLINE uint32_t LL_PWR_IsEnabledPUPDCfg(void)
  693. {
  694. return ((READ_BIT(PWR->CR3, PWR_CR3_APC) == (PWR_CR3_APC)) ? 1UL : 0UL);
  695. }
  696. #if defined(PWR_CR3_DSIPDEN)
  697. /**
  698. * @brief Enable pull-down activation on DSI pins
  699. * @rmtoll CR3 DSIPDEN LL_PWR_EnableDSIPullDown
  700. * @retval None
  701. */
  702. __STATIC_INLINE void LL_PWR_EnableDSIPullDown(void)
  703. {
  704. SET_BIT(PWR->CR3, PWR_CR3_DSIPDEN);
  705. }
  706. /**
  707. * @brief Disable pull-down activation on DSI pins
  708. * @rmtoll CR3 DSIPDEN LL_PWR_DisableDSIPullDown
  709. * @retval None
  710. */
  711. __STATIC_INLINE void LL_PWR_DisableDSIPullDown(void)
  712. {
  713. CLEAR_BIT(PWR->CR3, PWR_CR3_DSIPDEN);
  714. }
  715. /**
  716. * @brief Check if pull-down activation on DSI pins is enabled
  717. * @rmtoll CR3 DSIPDEN LL_PWR_IsEnabledDSIPullDown
  718. * @retval State of bit (1 or 0).
  719. */
  720. __STATIC_INLINE uint32_t LL_PWR_IsEnabledDSIPullDown(void)
  721. {
  722. return ((READ_BIT(PWR->CR3, PWR_CR3_DSIPDEN) == (PWR_CR3_DSIPDEN)) ? 1UL : 0UL);
  723. }
  724. #endif /* PWR_CR3_DSIPDEN */
  725. #if defined(PWR_CR3_ENULP)
  726. /**
  727. * @brief Enable Ultra Low Power BORL, BORH and PVD for STOP2 and Standby modes
  728. * @rmtoll CR3 ENULP LL_PWR_EnableBORPVD_ULP
  729. * @retval None
  730. */
  731. __STATIC_INLINE void LL_PWR_EnableBORPVD_ULP(void)
  732. {
  733. SET_BIT(PWR->CR3, PWR_CR3_ENULP);
  734. }
  735. /**
  736. * @brief Disable Ultra Low Power BORL, BORH and PVD for STOP2 and Standby modes
  737. * @rmtoll CR3 ENULP LL_PWR_DisableBORPVD_ULP
  738. * @retval None
  739. */
  740. __STATIC_INLINE void LL_PWR_DisableBORPVD_ULP(void)
  741. {
  742. CLEAR_BIT(PWR->CR3, PWR_CR3_ENULP);
  743. }
  744. /**
  745. * @brief Check if Ultra Low Power BORL, BORH and PVD for STOP2 and Standby modes is enabled
  746. * @rmtoll CR3 ENULP LL_PWR_IsEnabledBORPVD_ULP
  747. * @retval State of bit (1 or 0).
  748. */
  749. __STATIC_INLINE uint32_t LL_PWR_IsEnabledBORPVD_ULP(void)
  750. {
  751. return ((READ_BIT(PWR->CR3, PWR_CR3_ENULP) == (PWR_CR3_ENULP)) ? 1UL : 0UL);
  752. }
  753. #endif /* PWR_CR3_ENULP */
  754. /**
  755. * @brief Enable SRAM2 full content retention in Standby mode
  756. * @rmtoll CR3 RRS LL_PWR_EnableSRAM2Retention
  757. * @retval None
  758. */
  759. __STATIC_INLINE void LL_PWR_EnableSRAM2Retention(void)
  760. {
  761. MODIFY_REG(PWR->CR3, PWR_CR3_RRS, LL_PWR_FULL_SRAM2_RETENTION);
  762. }
  763. /**
  764. * @brief Disable SRAM2 content retention in Standby mode
  765. * @rmtoll CR3 RRS LL_PWR_DisableSRAM2Retention
  766. * @retval None
  767. */
  768. __STATIC_INLINE void LL_PWR_DisableSRAM2Retention(void)
  769. {
  770. CLEAR_BIT(PWR->CR3, PWR_CR3_RRS);
  771. }
  772. /**
  773. * @brief Check if SRAM2 full content retention in Standby mode is enabled
  774. * @rmtoll CR3 RRS LL_PWR_IsEnabledSRAM2Retention
  775. * @retval State of bit (1 or 0).
  776. */
  777. __STATIC_INLINE uint32_t LL_PWR_IsEnabledSRAM2Retention(void)
  778. {
  779. return ((READ_BIT(PWR->CR3, PWR_CR3_RRS) == (LL_PWR_FULL_SRAM2_RETENTION)) ? 1UL : 0UL);
  780. }
  781. /**
  782. * @brief Set SRAM2 content retention in Standby mode
  783. * @rmtoll CR3 RRS LL_PWR_SetSRAM2ContentRetention
  784. * @param SRAM2Size This parameter can be one of the following values:
  785. * @arg @ref LL_PWR_NO_SRAM2_RETENTION
  786. * @arg @ref LL_PWR_FULL_SRAM2_RETENTION
  787. * @arg @ref LL_PWR_4KBYTES_SRAM2_RETENTION
  788. * @note LL_PWR_4KBYTES_SRAM2_RETENTION parameter is not available on all devices
  789. * @note Setting LL_PWR_NO_SRAM2_RETENTION is same as calling LL_PWR_DisableSRAM2Retention()
  790. * @note Setting LL_PWR_FULL_SRAM2_RETENTION is same as calling LL_PWR_EnableSRAM2Retention()
  791. * @retval None
  792. */
  793. __STATIC_INLINE void LL_PWR_SetSRAM2ContentRetention(uint32_t SRAM2Size)
  794. {
  795. MODIFY_REG(PWR->CR3, PWR_CR3_RRS, SRAM2Size);
  796. }
  797. /**
  798. * @brief Get SRAM2 content retention in Standby mode
  799. * @rmtoll CR3 RRS LL_PWR_GetSRAM2ContentRetention
  800. * @retval Returned value can be one of the following values:
  801. * @arg @ref LL_PWR_NO_SRAM2_RETENTION
  802. * @arg @ref LL_PWR_FULL_SRAM2_RETENTION
  803. * @arg @ref LL_PWR_4KBYTES_SRAM2_RETENTION
  804. * @note LL_PWR_4KBYTES_SRAM2_RETENTION parameter is not available on all devices
  805. */
  806. __STATIC_INLINE uint32_t LL_PWR_GetSRAM2ContentRetention(void)
  807. {
  808. return (uint32_t)(READ_BIT(PWR->CR3, PWR_CR3_RRS));
  809. }
  810. /**
  811. * @brief Enable the WakeUp PINx functionality
  812. * @rmtoll CR3 EWUP1 LL_PWR_EnableWakeUpPin\n
  813. * CR3 EWUP2 LL_PWR_EnableWakeUpPin\n
  814. * CR3 EWUP3 LL_PWR_EnableWakeUpPin\n
  815. * CR3 EWUP4 LL_PWR_EnableWakeUpPin\n
  816. * CR3 EWUP5 LL_PWR_EnableWakeUpPin\n
  817. * @param WakeUpPin This parameter can be one of the following values:
  818. * @arg @ref LL_PWR_WAKEUP_PIN1
  819. * @arg @ref LL_PWR_WAKEUP_PIN2
  820. * @arg @ref LL_PWR_WAKEUP_PIN3
  821. * @arg @ref LL_PWR_WAKEUP_PIN4
  822. * @arg @ref LL_PWR_WAKEUP_PIN5
  823. * @retval None
  824. */
  825. __STATIC_INLINE void LL_PWR_EnableWakeUpPin(uint32_t WakeUpPin)
  826. {
  827. SET_BIT(PWR->CR3, WakeUpPin);
  828. }
  829. /**
  830. * @brief Disable the WakeUp PINx functionality
  831. * @rmtoll CR3 EWUP1 LL_PWR_DisableWakeUpPin\n
  832. * CR3 EWUP2 LL_PWR_DisableWakeUpPin\n
  833. * CR3 EWUP3 LL_PWR_DisableWakeUpPin\n
  834. * CR3 EWUP4 LL_PWR_DisableWakeUpPin\n
  835. * CR3 EWUP5 LL_PWR_DisableWakeUpPin\n
  836. * @param WakeUpPin This parameter can be one of the following values:
  837. * @arg @ref LL_PWR_WAKEUP_PIN1
  838. * @arg @ref LL_PWR_WAKEUP_PIN2
  839. * @arg @ref LL_PWR_WAKEUP_PIN3
  840. * @arg @ref LL_PWR_WAKEUP_PIN4
  841. * @arg @ref LL_PWR_WAKEUP_PIN5
  842. * @retval None
  843. */
  844. __STATIC_INLINE void LL_PWR_DisableWakeUpPin(uint32_t WakeUpPin)
  845. {
  846. CLEAR_BIT(PWR->CR3, WakeUpPin);
  847. }
  848. /**
  849. * @brief Check if the WakeUp PINx functionality is enabled
  850. * @rmtoll CR3 EWUP1 LL_PWR_IsEnabledWakeUpPin\n
  851. * CR3 EWUP2 LL_PWR_IsEnabledWakeUpPin\n
  852. * CR3 EWUP3 LL_PWR_IsEnabledWakeUpPin\n
  853. * CR3 EWUP4 LL_PWR_IsEnabledWakeUpPin\n
  854. * CR3 EWUP5 LL_PWR_IsEnabledWakeUpPin\n
  855. * @param WakeUpPin This parameter can be one of the following values:
  856. * @arg @ref LL_PWR_WAKEUP_PIN1
  857. * @arg @ref LL_PWR_WAKEUP_PIN2
  858. * @arg @ref LL_PWR_WAKEUP_PIN3
  859. * @arg @ref LL_PWR_WAKEUP_PIN4
  860. * @arg @ref LL_PWR_WAKEUP_PIN5
  861. * @retval State of bit (1 or 0).
  862. */
  863. __STATIC_INLINE uint32_t LL_PWR_IsEnabledWakeUpPin(uint32_t WakeUpPin)
  864. {
  865. return ((READ_BIT(PWR->CR3, WakeUpPin) == (WakeUpPin)) ? 1UL : 0UL);
  866. }
  867. #if defined(PWR_CR4_EXT_SMPS_ON)
  868. /**
  869. * @brief Enable the CFLDO working @ 0.95V
  870. * @note When external SMPS is used & CFLDO operating in Range 2, the regulated voltage of the
  871. * internal CFLDO can be reduced to 0.95V.
  872. * @rmtoll CR4 EXT_SMPS_ON LL_PWR_EnableExtSMPS_0V95
  873. * @retval None
  874. */
  875. __STATIC_INLINE void LL_PWR_EnableExtSMPS_0V95(void)
  876. {
  877. SET_BIT(PWR->CR4, PWR_CR4_EXT_SMPS_ON);
  878. }
  879. /**
  880. * @brief Disable the CFLDO working @ 0.95V
  881. * @note When external SMPS is used & CFLDO operating in Range 2, the regulated voltage of the
  882. * internal CFLDO can be reduced to 0.95V.
  883. * @rmtoll CR4 EXT_SMPS_ON LL_PWR_DisableExtSMPS_0V95
  884. * @retval None
  885. */
  886. __STATIC_INLINE void LL_PWR_DisableExtSMPS_0V95(void)
  887. {
  888. CLEAR_BIT(PWR->CR4, PWR_CR4_EXT_SMPS_ON);
  889. }
  890. /**
  891. * @brief Check if CFLDO is working @ 0.95V
  892. * @note When external SMPS is used & CFLDO operating in Range 2, the regulated voltage of the
  893. * internal CFLDO can be reduced to 0.95V.
  894. * @rmtoll CR4 EXT_SMPS_ON LL_PWR_IsEnabledExtSMPS_0V95
  895. * @retval State of bit (1 or 0).
  896. */
  897. __STATIC_INLINE uint32_t LL_PWR_IsEnabledExtSMPS_0V95(void)
  898. {
  899. return ((READ_BIT(PWR->CR4, PWR_CR4_EXT_SMPS_ON) == (PWR_CR4_EXT_SMPS_ON)) ? 1UL : 0UL);
  900. }
  901. #endif /* PWR_CR4_EXT_SMPS_ON */
  902. /**
  903. * @brief Set the resistor impedance
  904. * @rmtoll CR4 VBRS LL_PWR_SetBattChargResistor
  905. * @param Resistor This parameter can be one of the following values:
  906. * @arg @ref LL_PWR_BATT_CHARG_RESISTOR_5K
  907. * @arg @ref LL_PWR_BATT_CHARGRESISTOR_1_5K
  908. * @retval None
  909. */
  910. __STATIC_INLINE void LL_PWR_SetBattChargResistor(uint32_t Resistor)
  911. {
  912. MODIFY_REG(PWR->CR4, PWR_CR4_VBRS, Resistor);
  913. }
  914. /**
  915. * @brief Get the resistor impedance
  916. * @rmtoll CR4 VBRS LL_PWR_GetBattChargResistor
  917. * @retval Returned value can be one of the following values:
  918. * @arg @ref LL_PWR_BATT_CHARG_RESISTOR_5K
  919. * @arg @ref LL_PWR_BATT_CHARGRESISTOR_1_5K
  920. */
  921. __STATIC_INLINE uint32_t LL_PWR_GetBattChargResistor(void)
  922. {
  923. return (uint32_t)(READ_BIT(PWR->CR4, PWR_CR4_VBRS));
  924. }
  925. /**
  926. * @brief Enable battery charging
  927. * @rmtoll CR4 VBE LL_PWR_EnableBatteryCharging
  928. * @retval None
  929. */
  930. __STATIC_INLINE void LL_PWR_EnableBatteryCharging(void)
  931. {
  932. SET_BIT(PWR->CR4, PWR_CR4_VBE);
  933. }
  934. /**
  935. * @brief Disable battery charging
  936. * @rmtoll CR4 VBE LL_PWR_DisableBatteryCharging
  937. * @retval None
  938. */
  939. __STATIC_INLINE void LL_PWR_DisableBatteryCharging(void)
  940. {
  941. CLEAR_BIT(PWR->CR4, PWR_CR4_VBE);
  942. }
  943. /**
  944. * @brief Check if battery charging is enabled
  945. * @rmtoll CR4 VBE LL_PWR_IsEnabledBatteryCharging
  946. * @retval State of bit (1 or 0).
  947. */
  948. __STATIC_INLINE uint32_t LL_PWR_IsEnabledBatteryCharging(void)
  949. {
  950. return ((READ_BIT(PWR->CR4, PWR_CR4_VBE) == (PWR_CR4_VBE)) ? 1UL : 0UL);
  951. }
  952. /**
  953. * @brief Set the Wake-Up pin polarity low for the event detection
  954. * @rmtoll CR4 WP1 LL_PWR_SetWakeUpPinPolarityLow\n
  955. * CR4 WP2 LL_PWR_SetWakeUpPinPolarityLow\n
  956. * CR4 WP3 LL_PWR_SetWakeUpPinPolarityLow\n
  957. * CR4 WP4 LL_PWR_SetWakeUpPinPolarityLow\n
  958. * CR4 WP5 LL_PWR_SetWakeUpPinPolarityLow
  959. * @param WakeUpPin This parameter can be one of the following values:
  960. * @arg @ref LL_PWR_WAKEUP_PIN1
  961. * @arg @ref LL_PWR_WAKEUP_PIN2
  962. * @arg @ref LL_PWR_WAKEUP_PIN3
  963. * @arg @ref LL_PWR_WAKEUP_PIN4
  964. * @arg @ref LL_PWR_WAKEUP_PIN5
  965. * @retval None
  966. */
  967. __STATIC_INLINE void LL_PWR_SetWakeUpPinPolarityLow(uint32_t WakeUpPin)
  968. {
  969. SET_BIT(PWR->CR4, WakeUpPin);
  970. }
  971. /**
  972. * @brief Set the Wake-Up pin polarity high for the event detection
  973. * @rmtoll CR4 WP1 LL_PWR_SetWakeUpPinPolarityHigh\n
  974. * CR4 WP2 LL_PWR_SetWakeUpPinPolarityHigh\n
  975. * CR4 WP3 LL_PWR_SetWakeUpPinPolarityHigh\n
  976. * CR4 WP4 LL_PWR_SetWakeUpPinPolarityHigh\n
  977. * CR4 WP5 LL_PWR_SetWakeUpPinPolarityHigh
  978. * @param WakeUpPin This parameter can be one of the following values:
  979. * @arg @ref LL_PWR_WAKEUP_PIN1
  980. * @arg @ref LL_PWR_WAKEUP_PIN2
  981. * @arg @ref LL_PWR_WAKEUP_PIN3
  982. * @arg @ref LL_PWR_WAKEUP_PIN4
  983. * @arg @ref LL_PWR_WAKEUP_PIN5
  984. * @retval None
  985. */
  986. __STATIC_INLINE void LL_PWR_SetWakeUpPinPolarityHigh(uint32_t WakeUpPin)
  987. {
  988. CLEAR_BIT(PWR->CR4, WakeUpPin);
  989. }
  990. /**
  991. * @brief Get the Wake-Up pin polarity for the event detection
  992. * @rmtoll CR4 WP1 LL_PWR_IsWakeUpPinPolarityLow\n
  993. * CR4 WP2 LL_PWR_IsWakeUpPinPolarityLow\n
  994. * CR4 WP3 LL_PWR_IsWakeUpPinPolarityLow\n
  995. * CR4 WP4 LL_PWR_IsWakeUpPinPolarityLow\n
  996. * CR4 WP5 LL_PWR_IsWakeUpPinPolarityLow
  997. * @param WakeUpPin This parameter can be one of the following values:
  998. * @arg @ref LL_PWR_WAKEUP_PIN1
  999. * @arg @ref LL_PWR_WAKEUP_PIN2
  1000. * @arg @ref LL_PWR_WAKEUP_PIN3
  1001. * @arg @ref LL_PWR_WAKEUP_PIN4
  1002. * @arg @ref LL_PWR_WAKEUP_PIN5
  1003. * @retval State of bit (1 or 0).
  1004. */
  1005. __STATIC_INLINE uint32_t LL_PWR_IsWakeUpPinPolarityLow(uint32_t WakeUpPin)
  1006. {
  1007. return ((READ_BIT(PWR->CR4, WakeUpPin) == (WakeUpPin)) ? 1UL : 0UL);
  1008. }
  1009. /**
  1010. * @brief Enable GPIO pull-up state in Standby and Shutdown modes
  1011. * @rmtoll PUCRA PU0-15 LL_PWR_EnableGPIOPullUp\n
  1012. * PUCRB PU0-15 LL_PWR_EnableGPIOPullUp\n
  1013. * PUCRC PU0-15 LL_PWR_EnableGPIOPullUp\n
  1014. * PUCRD PU0-15 LL_PWR_EnableGPIOPullUp\n
  1015. * PUCRE PU0-15 LL_PWR_EnableGPIOPullUp\n
  1016. * PUCRF PU0-15 LL_PWR_EnableGPIOPullUp\n
  1017. * PUCRG PU0-15 LL_PWR_EnableGPIOPullUp\n
  1018. * PUCRH PU0-15 LL_PWR_EnableGPIOPullUp\n
  1019. * PUCRI PU0-11 LL_PWR_EnableGPIOPullUp
  1020. * @param GPIO This parameter can be one of the following values:
  1021. * @arg @ref LL_PWR_GPIO_A
  1022. * @arg @ref LL_PWR_GPIO_B
  1023. * @arg @ref LL_PWR_GPIO_C
  1024. * @arg @ref LL_PWR_GPIO_D
  1025. * @arg @ref LL_PWR_GPIO_E
  1026. * @arg @ref LL_PWR_GPIO_F (*)
  1027. * @arg @ref LL_PWR_GPIO_G (*)
  1028. * @arg @ref LL_PWR_GPIO_H
  1029. * @arg @ref LL_PWR_GPIO_I (*)
  1030. *
  1031. * (*) value not defined in all devices
  1032. * @param GPIONumber This parameter can be one of the following values:
  1033. * @arg @ref LL_PWR_GPIO_BIT_0
  1034. * @arg @ref LL_PWR_GPIO_BIT_1
  1035. * @arg @ref LL_PWR_GPIO_BIT_2
  1036. * @arg @ref LL_PWR_GPIO_BIT_3
  1037. * @arg @ref LL_PWR_GPIO_BIT_4
  1038. * @arg @ref LL_PWR_GPIO_BIT_5
  1039. * @arg @ref LL_PWR_GPIO_BIT_6
  1040. * @arg @ref LL_PWR_GPIO_BIT_7
  1041. * @arg @ref LL_PWR_GPIO_BIT_8
  1042. * @arg @ref LL_PWR_GPIO_BIT_9
  1043. * @arg @ref LL_PWR_GPIO_BIT_10
  1044. * @arg @ref LL_PWR_GPIO_BIT_11
  1045. * @arg @ref LL_PWR_GPIO_BIT_12
  1046. * @arg @ref LL_PWR_GPIO_BIT_13
  1047. * @arg @ref LL_PWR_GPIO_BIT_14
  1048. * @arg @ref LL_PWR_GPIO_BIT_15
  1049. * @retval None
  1050. */
  1051. __STATIC_INLINE void LL_PWR_EnableGPIOPullUp(uint32_t GPIO, uint32_t GPIONumber)
  1052. {
  1053. SET_BIT(*((__IO uint32_t *)GPIO), GPIONumber);
  1054. }
  1055. /**
  1056. * @brief Disable GPIO pull-up state in Standby and Shutdown modes
  1057. * @rmtoll PUCRA PU0-15 LL_PWR_DisableGPIOPullUp\n
  1058. * PUCRB PU0-15 LL_PWR_DisableGPIOPullUp\n
  1059. * PUCRC PU0-15 LL_PWR_DisableGPIOPullUp\n
  1060. * PUCRD PU0-15 LL_PWR_DisableGPIOPullUp\n
  1061. * PUCRE PU0-15 LL_PWR_DisableGPIOPullUp\n
  1062. * PUCRF PU0-15 LL_PWR_DisableGPIOPullUp\n
  1063. * PUCRG PU0-15 LL_PWR_DisableGPIOPullUp\n
  1064. * PUCRH PU0-15 LL_PWR_DisableGPIOPullUp\n
  1065. * PUCRI PU0-11 LL_PWR_DisableGPIOPullUp
  1066. * @param GPIO This parameter can be one of the following values:
  1067. * @arg @ref LL_PWR_GPIO_A
  1068. * @arg @ref LL_PWR_GPIO_B
  1069. * @arg @ref LL_PWR_GPIO_C
  1070. * @arg @ref LL_PWR_GPIO_D
  1071. * @arg @ref LL_PWR_GPIO_E
  1072. * @arg @ref LL_PWR_GPIO_F (*)
  1073. * @arg @ref LL_PWR_GPIO_G (*)
  1074. * @arg @ref LL_PWR_GPIO_H
  1075. * @arg @ref LL_PWR_GPIO_I (*)
  1076. *
  1077. * (*) value not defined in all devices
  1078. * @param GPIONumber This parameter can be one of the following values:
  1079. * @arg @ref LL_PWR_GPIO_BIT_0
  1080. * @arg @ref LL_PWR_GPIO_BIT_1
  1081. * @arg @ref LL_PWR_GPIO_BIT_2
  1082. * @arg @ref LL_PWR_GPIO_BIT_3
  1083. * @arg @ref LL_PWR_GPIO_BIT_4
  1084. * @arg @ref LL_PWR_GPIO_BIT_5
  1085. * @arg @ref LL_PWR_GPIO_BIT_6
  1086. * @arg @ref LL_PWR_GPIO_BIT_7
  1087. * @arg @ref LL_PWR_GPIO_BIT_8
  1088. * @arg @ref LL_PWR_GPIO_BIT_9
  1089. * @arg @ref LL_PWR_GPIO_BIT_10
  1090. * @arg @ref LL_PWR_GPIO_BIT_11
  1091. * @arg @ref LL_PWR_GPIO_BIT_12
  1092. * @arg @ref LL_PWR_GPIO_BIT_13
  1093. * @arg @ref LL_PWR_GPIO_BIT_14
  1094. * @arg @ref LL_PWR_GPIO_BIT_15
  1095. * @retval None
  1096. */
  1097. __STATIC_INLINE void LL_PWR_DisableGPIOPullUp(uint32_t GPIO, uint32_t GPIONumber)
  1098. {
  1099. CLEAR_BIT(*((__IO uint32_t *)GPIO), GPIONumber);
  1100. }
  1101. /**
  1102. * @brief Check if GPIO pull-up state is enabled
  1103. * @rmtoll PUCRA PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1104. * PUCRB PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1105. * PUCRC PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1106. * PUCRD PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1107. * PUCRE PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1108. * PUCRF PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1109. * PUCRG PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1110. * PUCRH PU0-15 LL_PWR_IsEnabledGPIOPullUp\n
  1111. * PUCRI PU0-11 LL_PWR_IsEnabledGPIOPullUp
  1112. * @param GPIO This parameter can be one of the following values:
  1113. * @arg @ref LL_PWR_GPIO_A
  1114. * @arg @ref LL_PWR_GPIO_B
  1115. * @arg @ref LL_PWR_GPIO_C
  1116. * @arg @ref LL_PWR_GPIO_D
  1117. * @arg @ref LL_PWR_GPIO_E
  1118. * @arg @ref LL_PWR_GPIO_F (*)
  1119. * @arg @ref LL_PWR_GPIO_G (*)
  1120. * @arg @ref LL_PWR_GPIO_H
  1121. * @arg @ref LL_PWR_GPIO_I (*)
  1122. *
  1123. * (*) value not defined in all devices
  1124. * @param GPIONumber This parameter can be one of the following values:
  1125. * @arg @ref LL_PWR_GPIO_BIT_0
  1126. * @arg @ref LL_PWR_GPIO_BIT_1
  1127. * @arg @ref LL_PWR_GPIO_BIT_2
  1128. * @arg @ref LL_PWR_GPIO_BIT_3
  1129. * @arg @ref LL_PWR_GPIO_BIT_4
  1130. * @arg @ref LL_PWR_GPIO_BIT_5
  1131. * @arg @ref LL_PWR_GPIO_BIT_6
  1132. * @arg @ref LL_PWR_GPIO_BIT_7
  1133. * @arg @ref LL_PWR_GPIO_BIT_8
  1134. * @arg @ref LL_PWR_GPIO_BIT_9
  1135. * @arg @ref LL_PWR_GPIO_BIT_10
  1136. * @arg @ref LL_PWR_GPIO_BIT_11
  1137. * @arg @ref LL_PWR_GPIO_BIT_12
  1138. * @arg @ref LL_PWR_GPIO_BIT_13
  1139. * @arg @ref LL_PWR_GPIO_BIT_14
  1140. * @arg @ref LL_PWR_GPIO_BIT_15
  1141. * @retval State of bit (1 or 0).
  1142. */
  1143. __STATIC_INLINE uint32_t LL_PWR_IsEnabledGPIOPullUp(uint32_t GPIO, uint32_t GPIONumber)
  1144. {
  1145. return ((READ_BIT(*((__IO uint32_t *)GPIO), GPIONumber) == (GPIONumber)) ? 1UL : 0UL);
  1146. }
  1147. /**
  1148. * @brief Enable GPIO pull-down state in Standby and Shutdown modes
  1149. * @rmtoll PDCRA PD0-15 LL_PWR_EnableGPIOPullDown\n
  1150. * PDCRB PD0-15 LL_PWR_EnableGPIOPullDown\n
  1151. * PDCRC PD0-15 LL_PWR_EnableGPIOPullDown\n
  1152. * PDCRD PD0-15 LL_PWR_EnableGPIOPullDown\n
  1153. * PDCRE PD0-15 LL_PWR_EnableGPIOPullDown\n
  1154. * PDCRF PD0-15 LL_PWR_EnableGPIOPullDown\n
  1155. * PDCRG PD0-15 LL_PWR_EnableGPIOPullDown\n
  1156. * PDCRH PD0-15 LL_PWR_EnableGPIOPullDown\n
  1157. * PDCRI PD0-11 LL_PWR_EnableGPIOPullDown
  1158. * @param GPIO This parameter can be one of the following values:
  1159. * @arg @ref LL_PWR_GPIO_A
  1160. * @arg @ref LL_PWR_GPIO_B
  1161. * @arg @ref LL_PWR_GPIO_C
  1162. * @arg @ref LL_PWR_GPIO_D
  1163. * @arg @ref LL_PWR_GPIO_E
  1164. * @arg @ref LL_PWR_GPIO_F (*)
  1165. * @arg @ref LL_PWR_GPIO_G (*)
  1166. * @arg @ref LL_PWR_GPIO_H
  1167. * @arg @ref LL_PWR_GPIO_I (*)
  1168. *
  1169. * (*) value not defined in all devices
  1170. * @param GPIONumber This parameter can be one of the following values:
  1171. * @arg @ref LL_PWR_GPIO_BIT_0
  1172. * @arg @ref LL_PWR_GPIO_BIT_1
  1173. * @arg @ref LL_PWR_GPIO_BIT_2
  1174. * @arg @ref LL_PWR_GPIO_BIT_3
  1175. * @arg @ref LL_PWR_GPIO_BIT_4
  1176. * @arg @ref LL_PWR_GPIO_BIT_5
  1177. * @arg @ref LL_PWR_GPIO_BIT_6
  1178. * @arg @ref LL_PWR_GPIO_BIT_7
  1179. * @arg @ref LL_PWR_GPIO_BIT_8
  1180. * @arg @ref LL_PWR_GPIO_BIT_9
  1181. * @arg @ref LL_PWR_GPIO_BIT_10
  1182. * @arg @ref LL_PWR_GPIO_BIT_11
  1183. * @arg @ref LL_PWR_GPIO_BIT_12
  1184. * @arg @ref LL_PWR_GPIO_BIT_13
  1185. * @arg @ref LL_PWR_GPIO_BIT_14
  1186. * @arg @ref LL_PWR_GPIO_BIT_15
  1187. * @retval None
  1188. */
  1189. __STATIC_INLINE void LL_PWR_EnableGPIOPullDown(uint32_t GPIO, uint32_t GPIONumber)
  1190. {
  1191. SET_BIT(*((__IO uint32_t *)(GPIO + 4U)), GPIONumber);
  1192. }
  1193. /**
  1194. * @brief Disable GPIO pull-down state in Standby and Shutdown modes
  1195. * @rmtoll PDCRA PD0-15 LL_PWR_DisableGPIOPullDown\n
  1196. * PDCRB PD0-15 LL_PWR_DisableGPIOPullDown\n
  1197. * PDCRC PD0-15 LL_PWR_DisableGPIOPullDown\n
  1198. * PDCRD PD0-15 LL_PWR_DisableGPIOPullDown\n
  1199. * PDCRE PD0-15 LL_PWR_DisableGPIOPullDown\n
  1200. * PDCRF PD0-15 LL_PWR_DisableGPIOPullDown\n
  1201. * PDCRG PD0-15 LL_PWR_DisableGPIOPullDown\n
  1202. * PDCRH PD0-15 LL_PWR_DisableGPIOPullDown\n
  1203. * PDCRI PD0-11 LL_PWR_DisableGPIOPullDown
  1204. * @param GPIO This parameter can be one of the following values:
  1205. * @arg @ref LL_PWR_GPIO_A
  1206. * @arg @ref LL_PWR_GPIO_B
  1207. * @arg @ref LL_PWR_GPIO_C
  1208. * @arg @ref LL_PWR_GPIO_D
  1209. * @arg @ref LL_PWR_GPIO_E
  1210. * @arg @ref LL_PWR_GPIO_F (*)
  1211. * @arg @ref LL_PWR_GPIO_G (*)
  1212. * @arg @ref LL_PWR_GPIO_H
  1213. * @arg @ref LL_PWR_GPIO_I (*)
  1214. *
  1215. * (*) value not defined in all devices
  1216. * @param GPIONumber This parameter can be one of the following values:
  1217. * @arg @ref LL_PWR_GPIO_BIT_0
  1218. * @arg @ref LL_PWR_GPIO_BIT_1
  1219. * @arg @ref LL_PWR_GPIO_BIT_2
  1220. * @arg @ref LL_PWR_GPIO_BIT_3
  1221. * @arg @ref LL_PWR_GPIO_BIT_4
  1222. * @arg @ref LL_PWR_GPIO_BIT_5
  1223. * @arg @ref LL_PWR_GPIO_BIT_6
  1224. * @arg @ref LL_PWR_GPIO_BIT_7
  1225. * @arg @ref LL_PWR_GPIO_BIT_8
  1226. * @arg @ref LL_PWR_GPIO_BIT_9
  1227. * @arg @ref LL_PWR_GPIO_BIT_10
  1228. * @arg @ref LL_PWR_GPIO_BIT_11
  1229. * @arg @ref LL_PWR_GPIO_BIT_12
  1230. * @arg @ref LL_PWR_GPIO_BIT_13
  1231. * @arg @ref LL_PWR_GPIO_BIT_14
  1232. * @arg @ref LL_PWR_GPIO_BIT_15
  1233. * @retval None
  1234. */
  1235. __STATIC_INLINE void LL_PWR_DisableGPIOPullDown(uint32_t GPIO, uint32_t GPIONumber)
  1236. {
  1237. CLEAR_BIT(*((__IO uint32_t *)(GPIO + 4U)), GPIONumber);
  1238. }
  1239. /**
  1240. * @brief Check if GPIO pull-down state is enabled
  1241. * @rmtoll PDCRA PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1242. * PDCRB PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1243. * PDCRC PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1244. * PDCRD PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1245. * PDCRE PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1246. * PDCRF PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1247. * PDCRG PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1248. * PDCRH PD0-15 LL_PWR_IsEnabledGPIOPullDown\n
  1249. * PDCRI PD0-11 LL_PWR_IsEnabledGPIOPullDown
  1250. * @param GPIO This parameter can be one of the following values:
  1251. * @arg @ref LL_PWR_GPIO_A
  1252. * @arg @ref LL_PWR_GPIO_B
  1253. * @arg @ref LL_PWR_GPIO_C
  1254. * @arg @ref LL_PWR_GPIO_D
  1255. * @arg @ref LL_PWR_GPIO_E
  1256. * @arg @ref LL_PWR_GPIO_F (*)
  1257. * @arg @ref LL_PWR_GPIO_G (*)
  1258. * @arg @ref LL_PWR_GPIO_H
  1259. * @arg @ref LL_PWR_GPIO_I (*)
  1260. *
  1261. * (*) value not defined in all devices
  1262. * @param GPIONumber This parameter can be one of the following values:
  1263. * @arg @ref LL_PWR_GPIO_BIT_0
  1264. * @arg @ref LL_PWR_GPIO_BIT_1
  1265. * @arg @ref LL_PWR_GPIO_BIT_2
  1266. * @arg @ref LL_PWR_GPIO_BIT_3
  1267. * @arg @ref LL_PWR_GPIO_BIT_4
  1268. * @arg @ref LL_PWR_GPIO_BIT_5
  1269. * @arg @ref LL_PWR_GPIO_BIT_6
  1270. * @arg @ref LL_PWR_GPIO_BIT_7
  1271. * @arg @ref LL_PWR_GPIO_BIT_8
  1272. * @arg @ref LL_PWR_GPIO_BIT_9
  1273. * @arg @ref LL_PWR_GPIO_BIT_10
  1274. * @arg @ref LL_PWR_GPIO_BIT_11
  1275. * @arg @ref LL_PWR_GPIO_BIT_12
  1276. * @arg @ref LL_PWR_GPIO_BIT_13
  1277. * @arg @ref LL_PWR_GPIO_BIT_14
  1278. * @arg @ref LL_PWR_GPIO_BIT_15
  1279. * @retval State of bit (1 or 0).
  1280. */
  1281. __STATIC_INLINE uint32_t LL_PWR_IsEnabledGPIOPullDown(uint32_t GPIO, uint32_t GPIONumber)
  1282. {
  1283. return ((READ_BIT(*((__IO uint32_t *)(GPIO + 4U)), GPIONumber) == (GPIONumber)) ? 1UL : 0UL);
  1284. }
  1285. /**
  1286. * @}
  1287. */
  1288. /** @defgroup PWR_LL_EF_FLAG_Management FLAG_Management
  1289. * @{
  1290. */
  1291. /**
  1292. * @brief Get Internal Wake-up line Flag
  1293. * @rmtoll SR1 WUFI LL_PWR_IsActiveFlag_InternWU
  1294. * @retval State of bit (1 or 0).
  1295. */
  1296. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_InternWU(void)
  1297. {
  1298. return ((READ_BIT(PWR->SR1, PWR_SR1_WUFI) == (PWR_SR1_WUFI)) ? 1UL : 0UL);
  1299. }
  1300. #if defined(PWR_SR1_EXT_SMPS_RDY)
  1301. /**
  1302. * @brief Get Ready Flag for switching to external SMPS
  1303. * @rmtoll SR1 EXT_SMPS_RDY LL_PWR_IsActiveFlag_ExtSMPSReady
  1304. * @retval State of bit (1 or 0).
  1305. */
  1306. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_ExtSMPSReady(void)
  1307. {
  1308. return ((READ_BIT(PWR->SR1, PWR_SR1_EXT_SMPS_RDY) == (PWR_SR1_EXT_SMPS_RDY)) ? 1UL : 0UL);
  1309. }
  1310. #endif /* PWR_SR1_EXT_SMPS_RDY */
  1311. /**
  1312. * @brief Get Stand-By Flag
  1313. * @rmtoll SR1 SBF LL_PWR_IsActiveFlag_SB
  1314. * @retval State of bit (1 or 0).
  1315. */
  1316. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_SB(void)
  1317. {
  1318. return ((READ_BIT(PWR->SR1, PWR_SR1_SBF) == (PWR_SR1_SBF)) ? 1UL : 0UL);
  1319. }
  1320. /**
  1321. * @brief Get Wake-up Flag 5
  1322. * @rmtoll SR1 WUF5 LL_PWR_IsActiveFlag_WU5
  1323. * @retval State of bit (1 or 0).
  1324. */
  1325. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_WU5(void)
  1326. {
  1327. return ((READ_BIT(PWR->SR1, PWR_SR1_WUF5) == (PWR_SR1_WUF5)) ? 1UL : 0UL);
  1328. }
  1329. /**
  1330. * @brief Get Wake-up Flag 4
  1331. * @rmtoll SR1 WUF4 LL_PWR_IsActiveFlag_WU4
  1332. * @retval State of bit (1 or 0).
  1333. */
  1334. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_WU4(void)
  1335. {
  1336. return ((READ_BIT(PWR->SR1, PWR_SR1_WUF4) == (PWR_SR1_WUF4)) ? 1UL : 0UL);
  1337. }
  1338. /**
  1339. * @brief Get Wake-up Flag 3
  1340. * @rmtoll SR1 WUF3 LL_PWR_IsActiveFlag_WU3
  1341. * @retval State of bit (1 or 0).
  1342. */
  1343. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_WU3(void)
  1344. {
  1345. return ((READ_BIT(PWR->SR1, PWR_SR1_WUF3) == (PWR_SR1_WUF3)) ? 1UL : 0UL);
  1346. }
  1347. /**
  1348. * @brief Get Wake-up Flag 2
  1349. * @rmtoll SR1 WUF2 LL_PWR_IsActiveFlag_WU2
  1350. * @retval State of bit (1 or 0).
  1351. */
  1352. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_WU2(void)
  1353. {
  1354. return ((READ_BIT(PWR->SR1, PWR_SR1_WUF2) == (PWR_SR1_WUF2)) ? 1UL : 0UL);
  1355. }
  1356. /**
  1357. * @brief Get Wake-up Flag 1
  1358. * @rmtoll SR1 WUF1 LL_PWR_IsActiveFlag_WU1
  1359. * @retval State of bit (1 or 0).
  1360. */
  1361. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_WU1(void)
  1362. {
  1363. return ((READ_BIT(PWR->SR1, PWR_SR1_WUF1) == (PWR_SR1_WUF1)) ? 1UL : 0UL);
  1364. }
  1365. /**
  1366. * @brief Clear Stand-By Flag
  1367. * @rmtoll SCR CSBF LL_PWR_ClearFlag_SB
  1368. * @retval None
  1369. */
  1370. __STATIC_INLINE void LL_PWR_ClearFlag_SB(void)
  1371. {
  1372. WRITE_REG(PWR->SCR, PWR_SCR_CSBF);
  1373. }
  1374. /**
  1375. * @brief Clear Wake-up Flags
  1376. * @rmtoll SCR CWUF LL_PWR_ClearFlag_WU
  1377. * @retval None
  1378. */
  1379. __STATIC_INLINE void LL_PWR_ClearFlag_WU(void)
  1380. {
  1381. WRITE_REG(PWR->SCR, PWR_SCR_CWUF);
  1382. }
  1383. /**
  1384. * @brief Clear Wake-up Flag 5
  1385. * @rmtoll SCR CWUF5 LL_PWR_ClearFlag_WU5
  1386. * @retval None
  1387. */
  1388. __STATIC_INLINE void LL_PWR_ClearFlag_WU5(void)
  1389. {
  1390. WRITE_REG(PWR->SCR, PWR_SCR_CWUF5);
  1391. }
  1392. /**
  1393. * @brief Clear Wake-up Flag 4
  1394. * @rmtoll SCR CWUF4 LL_PWR_ClearFlag_WU4
  1395. * @retval None
  1396. */
  1397. __STATIC_INLINE void LL_PWR_ClearFlag_WU4(void)
  1398. {
  1399. WRITE_REG(PWR->SCR, PWR_SCR_CWUF4);
  1400. }
  1401. /**
  1402. * @brief Clear Wake-up Flag 3
  1403. * @rmtoll SCR CWUF3 LL_PWR_ClearFlag_WU3
  1404. * @retval None
  1405. */
  1406. __STATIC_INLINE void LL_PWR_ClearFlag_WU3(void)
  1407. {
  1408. WRITE_REG(PWR->SCR, PWR_SCR_CWUF3);
  1409. }
  1410. /**
  1411. * @brief Clear Wake-up Flag 2
  1412. * @rmtoll SCR CWUF2 LL_PWR_ClearFlag_WU2
  1413. * @retval None
  1414. */
  1415. __STATIC_INLINE void LL_PWR_ClearFlag_WU2(void)
  1416. {
  1417. WRITE_REG(PWR->SCR, PWR_SCR_CWUF2);
  1418. }
  1419. /**
  1420. * @brief Clear Wake-up Flag 1
  1421. * @rmtoll SCR CWUF1 LL_PWR_ClearFlag_WU1
  1422. * @retval None
  1423. */
  1424. __STATIC_INLINE void LL_PWR_ClearFlag_WU1(void)
  1425. {
  1426. WRITE_REG(PWR->SCR, PWR_SCR_CWUF1);
  1427. }
  1428. /**
  1429. * @brief Indicate whether VDDA voltage is below or above PVM4 threshold
  1430. * @rmtoll SR2 PVMO4 LL_PWR_IsActiveFlag_PVMO4
  1431. * @retval State of bit (1 or 0).
  1432. */
  1433. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_PVMO4(void)
  1434. {
  1435. return ((READ_BIT(PWR->SR2, PWR_SR2_PVMO4) == (PWR_SR2_PVMO4)) ? 1UL : 0UL);
  1436. }
  1437. /**
  1438. * @brief Indicate whether VDDA voltage is below or above PVM3 threshold
  1439. * @rmtoll SR2 PVMO3 LL_PWR_IsActiveFlag_PVMO3
  1440. * @retval State of bit (1 or 0).
  1441. */
  1442. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_PVMO3(void)
  1443. {
  1444. return ((READ_BIT(PWR->SR2, PWR_SR2_PVMO3) == (PWR_SR2_PVMO3)) ? 1UL : 0UL);
  1445. }
  1446. #if defined(PWR_SR2_PVMO2)
  1447. /**
  1448. * @brief Indicate whether VDDIO2 voltage is below or above PVM2 threshold
  1449. * @rmtoll SR2 PVMO2 LL_PWR_IsActiveFlag_PVMO2
  1450. * @retval State of bit (1 or 0).
  1451. */
  1452. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_PVMO2(void)
  1453. {
  1454. return ((READ_BIT(PWR->SR2, PWR_SR2_PVMO2) == (PWR_SR2_PVMO2)) ? 1UL : 0UL);
  1455. }
  1456. #endif /* PWR_SR2_PVMO2 */
  1457. #if defined(PWR_SR2_PVMO1)
  1458. /**
  1459. * @brief Indicate whether VDDUSB voltage is below or above PVM1 threshold
  1460. * @rmtoll SR2 PVMO1 LL_PWR_IsActiveFlag_PVMO1
  1461. * @retval State of bit (1 or 0).
  1462. */
  1463. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_PVMO1(void)
  1464. {
  1465. return ((READ_BIT(PWR->SR2, PWR_SR2_PVMO1) == (PWR_SR2_PVMO1)) ? 1UL : 0UL);
  1466. }
  1467. #endif /* PWR_SR2_PVMO1 */
  1468. /**
  1469. * @brief Indicate whether VDD voltage is below or above the selected PVD threshold
  1470. * @rmtoll SR2 PVDO LL_PWR_IsActiveFlag_PVDO
  1471. * @retval State of bit (1 or 0).
  1472. */
  1473. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_PVDO(void)
  1474. {
  1475. return ((READ_BIT(PWR->SR2, PWR_SR2_PVDO) == (PWR_SR2_PVDO)) ? 1UL : 0UL);
  1476. }
  1477. /**
  1478. * @brief Indicate whether the regulator is ready in the selected voltage range or if its output voltage is still changing to the required voltage level
  1479. * @rmtoll SR2 VOSF LL_PWR_IsActiveFlag_VOS
  1480. * @retval State of bit (1 or 0).
  1481. */
  1482. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_VOS(void)
  1483. {
  1484. return ((READ_BIT(PWR->SR2, PWR_SR2_VOSF) == (PWR_SR2_VOSF)) ? 1UL : 0UL);
  1485. }
  1486. /**
  1487. * @brief Indicate whether the regulator is ready in main mode or is in low-power mode
  1488. * @note Take care, return value "0" means the regulator is ready. Return value "1" means the output voltage range is still changing.
  1489. * @rmtoll SR2 REGLPF LL_PWR_IsActiveFlag_REGLPF
  1490. * @retval State of bit (1 or 0).
  1491. */
  1492. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_REGLPF(void)
  1493. {
  1494. return ((READ_BIT(PWR->SR2, PWR_SR2_REGLPF) == (PWR_SR2_REGLPF)) ? 1UL : 0UL);
  1495. }
  1496. /**
  1497. * @brief Indicate whether or not the low-power regulator is ready
  1498. * @rmtoll SR2 REGLPS LL_PWR_IsActiveFlag_REGLPS
  1499. * @retval State of bit (1 or 0).
  1500. */
  1501. __STATIC_INLINE uint32_t LL_PWR_IsActiveFlag_REGLPS(void)
  1502. {
  1503. return ((READ_BIT(PWR->SR2, PWR_SR2_REGLPS) == (PWR_SR2_REGLPS)) ? 1UL : 0UL);
  1504. }
  1505. /**
  1506. * @}
  1507. */
  1508. #if defined(USE_FULL_LL_DRIVER)
  1509. /** @defgroup PWR_LL_EF_Init De-initialization function
  1510. * @{
  1511. */
  1512. ErrorStatus LL_PWR_DeInit(void);
  1513. /**
  1514. * @}
  1515. */
  1516. #endif /* USE_FULL_LL_DRIVER */
  1517. /** @defgroup PWR_LL_EF_Legacy_Functions Legacy functions name
  1518. * @{
  1519. */
  1520. /* Old functions name kept for legacy purpose, to be replaced by the */
  1521. /* current functions name. */
  1522. #define LL_PWR_IsActiveFlag_VOSF LL_PWR_IsActiveFlag_VOS
  1523. /**
  1524. * @}
  1525. */
  1526. /**
  1527. * @}
  1528. */
  1529. /**
  1530. * @}
  1531. */
  1532. #endif /* defined(PWR) */
  1533. /**
  1534. * @}
  1535. */
  1536. #ifdef __cplusplus
  1537. }
  1538. #endif
  1539. #endif /* STM32L4xx_LL_PWR_H */