Mercurial > pub > halpp
comparison l476rg/Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal_pwr_ex.c @ 0:32a3b1785697
a rough draft of Hardware Abstraction Layer for C++
STM32L476RG drivers
author | cin |
---|---|
date | Thu, 12 Jan 2017 02:45:43 +0300 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:32a3b1785697 |
---|---|
1 /** | |
2 ****************************************************************************** | |
3 * @file stm32l4xx_hal_pwr_ex.c | |
4 * @author MCD Application Team | |
5 * @version V1.6.0 | |
6 * @date 28-October-2016 | |
7 * @brief Extended PWR HAL module driver. | |
8 * This file provides firmware functions to manage the following | |
9 * functionalities of the Power Controller (PWR) peripheral: | |
10 * + Extended Initialization and de-initialization functions | |
11 * + Extended Peripheral Control functions | |
12 * | |
13 ****************************************************************************** | |
14 * @attention | |
15 * | |
16 * <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2> | |
17 * | |
18 * Redistribution and use in source and binary forms, with or without modification, | |
19 * are permitted provided that the following conditions are met: | |
20 * 1. Redistributions of source code must retain the above copyright notice, | |
21 * this list of conditions and the following disclaimer. | |
22 * 2. Redistributions in binary form must reproduce the above copyright notice, | |
23 * this list of conditions and the following disclaimer in the documentation | |
24 * and/or other materials provided with the distribution. | |
25 * 3. Neither the name of STMicroelectronics nor the names of its contributors | |
26 * may be used to endorse or promote products derived from this software | |
27 * without specific prior written permission. | |
28 * | |
29 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
30 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
31 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
32 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE | |
33 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
34 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR | |
35 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER | |
36 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |
37 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
39 * | |
40 ****************************************************************************** | |
41 */ | |
42 | |
43 /* Includes ------------------------------------------------------------------*/ | |
44 #include "stm32l4xx_hal.h" | |
45 | |
46 /** @addtogroup STM32L4xx_HAL_Driver | |
47 * @{ | |
48 */ | |
49 | |
50 /** @defgroup PWREx PWREx | |
51 * @brief PWR Extended HAL module driver | |
52 * @{ | |
53 */ | |
54 | |
55 #ifdef HAL_PWR_MODULE_ENABLED | |
56 | |
57 /* Private typedef -----------------------------------------------------------*/ | |
58 /* Private define ------------------------------------------------------------*/ | |
59 | |
60 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) | |
61 #define PWR_PORTH_AVAILABLE_PINS ((uint32_t)0x0000000B) /* PH0/PH1/PH3 */ | |
62 #elif defined (STM32L451xx) || defined (STM32L452xx) || defined (STM32L462xx) | |
63 #define PWR_PORTH_AVAILABLE_PINS ((uint32_t)0x0000000B) /* PH0/PH1/PH3 */ | |
64 #elif defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) | |
65 #define PWR_PORTH_AVAILABLE_PINS ((uint32_t)0x00000003) /* PH0/PH1 */ | |
66 #endif | |
67 | |
68 /** @defgroup PWR_Extended_Private_Defines PWR Extended Private Defines | |
69 * @{ | |
70 */ | |
71 | |
72 /** @defgroup PWREx_PVM_Mode_Mask PWR PVM Mode Mask | |
73 * @{ | |
74 */ | |
75 #define PVM_MODE_IT ((uint32_t)0x00010000) /*!< Mask for interruption yielded by PVM threshold crossing */ | |
76 #define PVM_MODE_EVT ((uint32_t)0x00020000) /*!< Mask for event yielded by PVM threshold crossing */ | |
77 #define PVM_RISING_EDGE ((uint32_t)0x00000001) /*!< Mask for rising edge set as PVM trigger */ | |
78 #define PVM_FALLING_EDGE ((uint32_t)0x00000002) /*!< Mask for falling edge set as PVM trigger */ | |
79 /** | |
80 * @} | |
81 */ | |
82 | |
83 /** @defgroup PWREx_TimeOut_Value PWR Extended Flag Setting Time Out Value | |
84 * @{ | |
85 */ | |
86 #define PWR_FLAG_SETTING_DELAY_US 50 /*!< Time out value for REGLPF and VOSF flags setting */ | |
87 /** | |
88 * @} | |
89 */ | |
90 | |
91 | |
92 | |
93 /** | |
94 * @} | |
95 */ | |
96 | |
97 | |
98 | |
99 /* Private macro -------------------------------------------------------------*/ | |
100 /* Private variables ---------------------------------------------------------*/ | |
101 /* Private function prototypes -----------------------------------------------*/ | |
102 /* Exported functions --------------------------------------------------------*/ | |
103 | |
104 /** @defgroup PWREx_Exported_Functions PWR Extended Exported Functions | |
105 * @{ | |
106 */ | |
107 | |
108 /** @defgroup PWREx_Exported_Functions_Group1 Extended Peripheral Control functions | |
109 * @brief Extended Peripheral Control functions | |
110 * | |
111 @verbatim | |
112 =============================================================================== | |
113 ##### Extended Peripheral Initialization and de-initialization functions ##### | |
114 =============================================================================== | |
115 [..] | |
116 | |
117 @endverbatim | |
118 * @{ | |
119 */ | |
120 | |
121 | |
122 /** | |
123 * @brief Return Voltage Scaling Range. | |
124 * @retval VOS bit field (PWR_REGULATOR_VOLTAGE_RANGE1 or PWR_REGULATOR_VOLTAGE_RANGE2) | |
125 */ | |
126 uint32_t HAL_PWREx_GetVoltageRange(void) | |
127 { | |
128 return (PWR->CR1 & PWR_CR1_VOS); | |
129 } | |
130 | |
131 | |
132 | |
133 /** | |
134 * @brief Configure the main internal regulator output voltage. | |
135 * @param VoltageScaling: specifies the regulator output voltage to achieve | |
136 * a tradeoff between performance and power consumption. | |
137 * This parameter can be one of the following values: | |
138 * @arg @ref PWR_REGULATOR_VOLTAGE_SCALE1 Regulator voltage output range 1 mode, | |
139 * typical output voltage at 1.2 V, | |
140 * system frequency up to 80 MHz. | |
141 * @arg @ref PWR_REGULATOR_VOLTAGE_SCALE2 Regulator voltage output range 2 mode, | |
142 * typical output voltage at 1.0 V, | |
143 * system frequency up to 26 MHz. | |
144 * @note When moving from Range 1 to Range 2, the system frequency must be decreased to | |
145 * a value below 26 MHz before calling HAL_PWREx_ControlVoltageScaling() API. | |
146 * When moving from Range 2 to Range 1, the system frequency can be increased to | |
147 * a value up to 80 MHz after calling HAL_PWREx_ControlVoltageScaling() API. | |
148 * @note When moving from Range 2 to Range 1, the API waits for VOSF flag to be | |
149 * cleared before returning the status. If the flag is not cleared within | |
150 * 50 microseconds, HAL_TIMEOUT status is reported. | |
151 * @retval HAL Status | |
152 */ | |
153 HAL_StatusTypeDef HAL_PWREx_ControlVoltageScaling(uint32_t VoltageScaling) | |
154 { | |
155 uint32_t wait_loop_index = 0; | |
156 | |
157 assert_param(IS_PWR_VOLTAGE_SCALING_RANGE(VoltageScaling)); | |
158 | |
159 /* If Set Range 1 */ | |
160 if (VoltageScaling == PWR_REGULATOR_VOLTAGE_SCALE1) | |
161 { | |
162 if (READ_BIT(PWR->CR1, PWR_CR1_VOS) != PWR_REGULATOR_VOLTAGE_SCALE1) | |
163 { | |
164 /* Set Range 1 */ | |
165 MODIFY_REG(PWR->CR1, PWR_CR1_VOS, PWR_REGULATOR_VOLTAGE_SCALE1); | |
166 | |
167 /* Wait until VOSF is cleared */ | |
168 wait_loop_index = (PWR_FLAG_SETTING_DELAY_US * (SystemCoreClock / 1000000)); | |
169 while ((wait_loop_index != 0) && (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_VOSF))) | |
170 { | |
171 wait_loop_index--; | |
172 } | |
173 if (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_VOSF)) | |
174 { | |
175 return HAL_TIMEOUT; | |
176 } | |
177 } | |
178 } | |
179 else | |
180 { | |
181 if (READ_BIT(PWR->CR1, PWR_CR1_VOS) != PWR_REGULATOR_VOLTAGE_SCALE2) | |
182 { | |
183 /* Set Range 2 */ | |
184 MODIFY_REG(PWR->CR1, PWR_CR1_VOS, PWR_REGULATOR_VOLTAGE_SCALE2); | |
185 /* No need to wait for VOSF to be cleared for this transition */ | |
186 } | |
187 } | |
188 | |
189 return HAL_OK; | |
190 } | |
191 | |
192 | |
193 /** | |
194 * @brief Enable battery charging. | |
195 * When VDD is present, charge the external battery on VBAT thru an internal resistor. | |
196 * @param ResistorSelection: specifies the resistor impedance. | |
197 * This parameter can be one of the following values: | |
198 * @arg @ref PWR_BATTERY_CHARGING_RESISTOR_5 5 kOhms resistor | |
199 * @arg @ref PWR_BATTERY_CHARGING_RESISTOR_1_5 1.5 kOhms resistor | |
200 * @retval None | |
201 */ | |
202 void HAL_PWREx_EnableBatteryCharging(uint32_t ResistorSelection) | |
203 { | |
204 assert_param(IS_PWR_BATTERY_RESISTOR_SELECT(ResistorSelection)); | |
205 | |
206 /* Specify resistor selection */ | |
207 MODIFY_REG(PWR->CR4, PWR_CR4_VBRS, ResistorSelection); | |
208 | |
209 /* Enable battery charging */ | |
210 SET_BIT(PWR->CR4, PWR_CR4_VBE); | |
211 } | |
212 | |
213 | |
214 /** | |
215 * @brief Disable battery charging. | |
216 * @retval None | |
217 */ | |
218 void HAL_PWREx_DisableBatteryCharging(void) | |
219 { | |
220 CLEAR_BIT(PWR->CR4, PWR_CR4_VBE); | |
221 } | |
222 | |
223 | |
224 #if defined(PWR_CR2_USV) | |
225 /** | |
226 * @brief Enable VDDUSB supply. | |
227 * @note Remove VDDUSB electrical and logical isolation, once VDDUSB supply is present. | |
228 * @retval None | |
229 */ | |
230 void HAL_PWREx_EnableVddUSB(void) | |
231 { | |
232 SET_BIT(PWR->CR2, PWR_CR2_USV); | |
233 } | |
234 | |
235 | |
236 /** | |
237 * @brief Disable VDDUSB supply. | |
238 * @retval None | |
239 */ | |
240 void HAL_PWREx_DisableVddUSB(void) | |
241 { | |
242 CLEAR_BIT(PWR->CR2, PWR_CR2_USV); | |
243 } | |
244 #endif /* PWR_CR2_USV */ | |
245 | |
246 #if defined(PWR_CR2_IOSV) | |
247 /** | |
248 * @brief Enable VDDIO2 supply. | |
249 * @note Remove VDDIO2 electrical and logical isolation, once VDDIO2 supply is present. | |
250 * @retval None | |
251 */ | |
252 void HAL_PWREx_EnableVddIO2(void) | |
253 { | |
254 SET_BIT(PWR->CR2, PWR_CR2_IOSV); | |
255 } | |
256 | |
257 | |
258 /** | |
259 * @brief Disable VDDIO2 supply. | |
260 * @retval None | |
261 */ | |
262 void HAL_PWREx_DisableVddIO2(void) | |
263 { | |
264 CLEAR_BIT(PWR->CR2, PWR_CR2_IOSV); | |
265 } | |
266 #endif /* PWR_CR2_IOSV */ | |
267 | |
268 | |
269 /** | |
270 * @brief Enable Internal Wake-up Line. | |
271 * @retval None | |
272 */ | |
273 void HAL_PWREx_EnableInternalWakeUpLine(void) | |
274 { | |
275 SET_BIT(PWR->CR3, PWR_CR3_EIWF); | |
276 } | |
277 | |
278 | |
279 /** | |
280 * @brief Disable Internal Wake-up Line. | |
281 * @retval None | |
282 */ | |
283 void HAL_PWREx_DisableInternalWakeUpLine(void) | |
284 { | |
285 CLEAR_BIT(PWR->CR3, PWR_CR3_EIWF); | |
286 } | |
287 | |
288 | |
289 | |
290 /** | |
291 * @brief Enable GPIO pull-up state in Standby and Shutdown modes. | |
292 * @note Set the relevant PUy bits of PWR_PUCRx register to configure the I/O in | |
293 * pull-up state in Standby and Shutdown modes. | |
294 * @note This state is effective in Standby and Shutdown modes only if APC bit | |
295 * is set through HAL_PWREx_EnablePullUpPullDownConfig() API. | |
296 * @note The configuration is lost when exiting the Shutdown mode due to the | |
297 * power-on reset, maintained when exiting the Standby mode. | |
298 * @note To avoid any conflict at Standby and Shutdown modes exits, the corresponding | |
299 * PDy bit of PWR_PDCRx register is cleared unless it is reserved. | |
300 * @note Even if a PUy bit to set is reserved, the other PUy bits entered as input | |
301 * parameter at the same time are set. | |
302 * @param GPIO: Specify the IO port. This parameter can be PWR_GPIO_A, ..., PWR_GPIO_H | |
303 * (or PWR_GPIO_I depending on the devices) to select the GPIO peripheral. | |
304 * @param GPIONumber: Specify the I/O pins numbers. | |
305 * This parameter can be one of the following values: | |
306 * PWR_GPIO_BIT_0, ..., PWR_GPIO_BIT_15 (except for the port where less | |
307 * I/O pins are available) or the logical OR of several of them to set | |
308 * several bits for a given port in a single API call. | |
309 * @retval HAL Status | |
310 */ | |
311 HAL_StatusTypeDef HAL_PWREx_EnableGPIOPullUp(uint32_t GPIO, uint32_t GPIONumber) | |
312 { | |
313 assert_param(IS_PWR_GPIO(GPIO)); | |
314 assert_param(IS_PWR_GPIO_BIT_NUMBER(GPIONumber)); | |
315 | |
316 switch (GPIO) | |
317 { | |
318 case PWR_GPIO_A: | |
319 SET_BIT(PWR->PUCRA, (GPIONumber & (~(PWR_GPIO_BIT_14)))); | |
320 CLEAR_BIT(PWR->PDCRA, (GPIONumber & (~(PWR_GPIO_BIT_13|PWR_GPIO_BIT_15)))); | |
321 break; | |
322 case PWR_GPIO_B: | |
323 SET_BIT(PWR->PUCRB, GPIONumber); | |
324 CLEAR_BIT(PWR->PDCRB, (GPIONumber & (~(PWR_GPIO_BIT_4)))); | |
325 break; | |
326 case PWR_GPIO_C: | |
327 SET_BIT(PWR->PUCRC, GPIONumber); | |
328 CLEAR_BIT(PWR->PDCRC, GPIONumber); | |
329 break; | |
330 #if defined(GPIOD) | |
331 case PWR_GPIO_D: | |
332 SET_BIT(PWR->PUCRD, GPIONumber); | |
333 CLEAR_BIT(PWR->PDCRD, GPIONumber); | |
334 break; | |
335 #endif | |
336 #if defined(GPIOE) | |
337 case PWR_GPIO_E: | |
338 SET_BIT(PWR->PUCRE, GPIONumber); | |
339 CLEAR_BIT(PWR->PDCRE, GPIONumber); | |
340 break; | |
341 #endif | |
342 #if defined(GPIOF) | |
343 case PWR_GPIO_F: | |
344 SET_BIT(PWR->PUCRF, GPIONumber); | |
345 CLEAR_BIT(PWR->PDCRF, GPIONumber); | |
346 break; | |
347 #endif | |
348 #if defined(GPIOG) | |
349 case PWR_GPIO_G: | |
350 SET_BIT(PWR->PUCRG, GPIONumber); | |
351 CLEAR_BIT(PWR->PDCRG, GPIONumber); | |
352 break; | |
353 #endif | |
354 case PWR_GPIO_H: | |
355 SET_BIT(PWR->PUCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
356 CLEAR_BIT(PWR->PDCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
357 break; | |
358 default: | |
359 return HAL_ERROR; | |
360 } | |
361 | |
362 return HAL_OK; | |
363 } | |
364 | |
365 | |
366 /** | |
367 * @brief Disable GPIO pull-up state in Standby mode and Shutdown modes. | |
368 * @note Reset the relevant PUy bits of PWR_PUCRx register used to configure the I/O | |
369 * in pull-up state in Standby and Shutdown modes. | |
370 * @note Even if a PUy bit to reset is reserved, the other PUy bits entered as input | |
371 * parameter at the same time are reset. | |
372 * @param GPIO: Specifies the IO port. This parameter can be PWR_GPIO_A, ..., PWR_GPIO_H | |
373 * (or PWR_GPIO_I depending on the devices) to select the GPIO peripheral. | |
374 * @param GPIONumber: Specify the I/O pins numbers. | |
375 * This parameter can be one of the following values: | |
376 * PWR_GPIO_BIT_0, ..., PWR_GPIO_BIT_15 (except for the port where less | |
377 * I/O pins are available) or the logical OR of several of them to reset | |
378 * several bits for a given port in a single API call. | |
379 * @retval HAL Status | |
380 */ | |
381 HAL_StatusTypeDef HAL_PWREx_DisableGPIOPullUp(uint32_t GPIO, uint32_t GPIONumber) | |
382 { | |
383 assert_param(IS_PWR_GPIO(GPIO)); | |
384 assert_param(IS_PWR_GPIO_BIT_NUMBER(GPIONumber)); | |
385 | |
386 switch (GPIO) | |
387 { | |
388 case PWR_GPIO_A: | |
389 CLEAR_BIT(PWR->PUCRA, (GPIONumber & (~(PWR_GPIO_BIT_14)))); | |
390 break; | |
391 case PWR_GPIO_B: | |
392 CLEAR_BIT(PWR->PUCRB, GPIONumber); | |
393 break; | |
394 case PWR_GPIO_C: | |
395 CLEAR_BIT(PWR->PUCRC, GPIONumber); | |
396 break; | |
397 #if defined(GPIOD) | |
398 case PWR_GPIO_D: | |
399 CLEAR_BIT(PWR->PUCRD, GPIONumber); | |
400 break; | |
401 #endif | |
402 #if defined(GPIOE) | |
403 case PWR_GPIO_E: | |
404 CLEAR_BIT(PWR->PUCRE, GPIONumber); | |
405 break; | |
406 #endif | |
407 #if defined(GPIOF) | |
408 case PWR_GPIO_F: | |
409 CLEAR_BIT(PWR->PUCRF, GPIONumber); | |
410 break; | |
411 #endif | |
412 #if defined(GPIOG) | |
413 case PWR_GPIO_G: | |
414 CLEAR_BIT(PWR->PUCRG, GPIONumber); | |
415 break; | |
416 #endif | |
417 case PWR_GPIO_H: | |
418 CLEAR_BIT(PWR->PUCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
419 break; | |
420 default: | |
421 return HAL_ERROR; | |
422 } | |
423 | |
424 return HAL_OK; | |
425 } | |
426 | |
427 | |
428 | |
429 /** | |
430 * @brief Enable GPIO pull-down state in Standby and Shutdown modes. | |
431 * @note Set the relevant PDy bits of PWR_PDCRx register to configure the I/O in | |
432 * pull-down state in Standby and Shutdown modes. | |
433 * @note This state is effective in Standby and Shutdown modes only if APC bit | |
434 * is set through HAL_PWREx_EnablePullUpPullDownConfig() API. | |
435 * @note The configuration is lost when exiting the Shutdown mode due to the | |
436 * power-on reset, maintained when exiting the Standby mode. | |
437 * @note To avoid any conflict at Standby and Shutdown modes exits, the corresponding | |
438 * PUy bit of PWR_PUCRx register is cleared unless it is reserved. | |
439 * @note Even if a PDy bit to set is reserved, the other PDy bits entered as input | |
440 * parameter at the same time are set. | |
441 * @param GPIO: Specify the IO port. This parameter can be PWR_GPIO_A..PWR_GPIO_H | |
442 * (or PWR_GPIO_I depending on the devices) to select the GPIO peripheral. | |
443 * @param GPIONumber: Specify the I/O pins numbers. | |
444 * This parameter can be one of the following values: | |
445 * PWR_GPIO_BIT_0, ..., PWR_GPIO_BIT_15 (except for the port where less | |
446 * I/O pins are available) or the logical OR of several of them to set | |
447 * several bits for a given port in a single API call. | |
448 * @retval HAL Status | |
449 */ | |
450 HAL_StatusTypeDef HAL_PWREx_EnableGPIOPullDown(uint32_t GPIO, uint32_t GPIONumber) | |
451 { | |
452 assert_param(IS_PWR_GPIO(GPIO)); | |
453 assert_param(IS_PWR_GPIO_BIT_NUMBER(GPIONumber)); | |
454 | |
455 switch (GPIO) | |
456 { | |
457 case PWR_GPIO_A: | |
458 SET_BIT(PWR->PDCRA, (GPIONumber & (~(PWR_GPIO_BIT_13|PWR_GPIO_BIT_15)))); | |
459 CLEAR_BIT(PWR->PUCRA, (GPIONumber & (~(PWR_GPIO_BIT_14)))); | |
460 break; | |
461 case PWR_GPIO_B: | |
462 SET_BIT(PWR->PDCRB, (GPIONumber & (~(PWR_GPIO_BIT_4)))); | |
463 CLEAR_BIT(PWR->PUCRB, GPIONumber); | |
464 break; | |
465 case PWR_GPIO_C: | |
466 SET_BIT(PWR->PDCRC, GPIONumber); | |
467 CLEAR_BIT(PWR->PUCRC, GPIONumber); | |
468 break; | |
469 #if defined(GPIOD) | |
470 case PWR_GPIO_D: | |
471 SET_BIT(PWR->PDCRD, GPIONumber); | |
472 CLEAR_BIT(PWR->PUCRD, GPIONumber); | |
473 break; | |
474 #endif | |
475 #if defined(GPIOE) | |
476 case PWR_GPIO_E: | |
477 SET_BIT(PWR->PDCRE, GPIONumber); | |
478 CLEAR_BIT(PWR->PUCRE, GPIONumber); | |
479 break; | |
480 #endif | |
481 #if defined(GPIOF) | |
482 case PWR_GPIO_F: | |
483 SET_BIT(PWR->PDCRF, GPIONumber); | |
484 CLEAR_BIT(PWR->PUCRF, GPIONumber); | |
485 break; | |
486 #endif | |
487 #if defined(GPIOG) | |
488 case PWR_GPIO_G: | |
489 SET_BIT(PWR->PDCRG, GPIONumber); | |
490 CLEAR_BIT(PWR->PUCRG, GPIONumber); | |
491 break; | |
492 #endif | |
493 case PWR_GPIO_H: | |
494 SET_BIT(PWR->PDCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
495 CLEAR_BIT(PWR->PUCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
496 break; | |
497 default: | |
498 return HAL_ERROR; | |
499 } | |
500 | |
501 return HAL_OK; | |
502 } | |
503 | |
504 | |
505 /** | |
506 * @brief Disable GPIO pull-down state in Standby and Shutdown modes. | |
507 * @note Reset the relevant PDy bits of PWR_PDCRx register used to configure the I/O | |
508 * in pull-down state in Standby and Shutdown modes. | |
509 * @note Even if a PDy bit to reset is reserved, the other PDy bits entered as input | |
510 * parameter at the same time are reset. | |
511 * @param GPIO: Specifies the IO port. This parameter can be PWR_GPIO_A..PWR_GPIO_H | |
512 * (or PWR_GPIO_I depending on the devices) to select the GPIO peripheral. | |
513 * @param GPIONumber: Specify the I/O pins numbers. | |
514 * This parameter can be one of the following values: | |
515 * PWR_GPIO_BIT_0, ..., PWR_GPIO_BIT_15 (except for the port where less | |
516 * I/O pins are available) or the logical OR of several of them to reset | |
517 * several bits for a given port in a single API call. | |
518 * @retval HAL Status | |
519 */ | |
520 HAL_StatusTypeDef HAL_PWREx_DisableGPIOPullDown(uint32_t GPIO, uint32_t GPIONumber) | |
521 { | |
522 assert_param(IS_PWR_GPIO(GPIO)); | |
523 assert_param(IS_PWR_GPIO_BIT_NUMBER(GPIONumber)); | |
524 | |
525 switch (GPIO) | |
526 { | |
527 case PWR_GPIO_A: | |
528 CLEAR_BIT(PWR->PDCRA, (GPIONumber & (~(PWR_GPIO_BIT_13|PWR_GPIO_BIT_15)))); | |
529 break; | |
530 case PWR_GPIO_B: | |
531 CLEAR_BIT(PWR->PDCRB, (GPIONumber & (~(PWR_GPIO_BIT_4)))); | |
532 break; | |
533 case PWR_GPIO_C: | |
534 CLEAR_BIT(PWR->PDCRC, GPIONumber); | |
535 break; | |
536 #if defined(GPIOD) | |
537 case PWR_GPIO_D: | |
538 CLEAR_BIT(PWR->PDCRD, GPIONumber); | |
539 break; | |
540 #endif | |
541 #if defined(GPIOE) | |
542 case PWR_GPIO_E: | |
543 CLEAR_BIT(PWR->PDCRE, GPIONumber); | |
544 break; | |
545 #endif | |
546 #if defined(GPIOF) | |
547 case PWR_GPIO_F: | |
548 CLEAR_BIT(PWR->PDCRF, GPIONumber); | |
549 break; | |
550 #endif | |
551 #if defined(GPIOG) | |
552 case PWR_GPIO_G: | |
553 CLEAR_BIT(PWR->PDCRG, GPIONumber); | |
554 break; | |
555 #endif | |
556 case PWR_GPIO_H: | |
557 CLEAR_BIT(PWR->PDCRH, (GPIONumber & PWR_PORTH_AVAILABLE_PINS)); | |
558 break; | |
559 default: | |
560 return HAL_ERROR; | |
561 } | |
562 | |
563 return HAL_OK; | |
564 } | |
565 | |
566 | |
567 | |
568 /** | |
569 * @brief Enable pull-up and pull-down configuration. | |
570 * @note When APC bit is set, the I/O pull-up and pull-down configurations defined in | |
571 * PWR_PUCRx and PWR_PDCRx registers are applied in Standby and Shutdown modes. | |
572 * @note Pull-up set by PUy bit of PWR_PUCRx register is not activated if the corresponding | |
573 * PDy bit of PWR_PDCRx register is also set (pull-down configuration priority is higher). | |
574 * HAL_PWREx_EnableGPIOPullUp() and HAL_PWREx_EnableGPIOPullDown() API's ensure there | |
575 * is no conflict when setting PUy or PDy bit. | |
576 * @retval None | |
577 */ | |
578 void HAL_PWREx_EnablePullUpPullDownConfig(void) | |
579 { | |
580 SET_BIT(PWR->CR3, PWR_CR3_APC); | |
581 } | |
582 | |
583 | |
584 /** | |
585 * @brief Disable pull-up and pull-down configuration. | |
586 * @note When APC bit is cleared, the I/O pull-up and pull-down configurations defined in | |
587 * PWR_PUCRx and PWR_PDCRx registers are not applied in Standby and Shutdown modes. | |
588 * @retval None | |
589 */ | |
590 void HAL_PWREx_DisablePullUpPullDownConfig(void) | |
591 { | |
592 CLEAR_BIT(PWR->CR3, PWR_CR3_APC); | |
593 } | |
594 | |
595 | |
596 | |
597 /** | |
598 * @brief Enable SRAM2 content retention in Standby mode. | |
599 * @note When RRS bit is set, SRAM2 is powered by the low-power regulator in | |
600 * Standby mode and its content is kept. | |
601 * @retval None | |
602 */ | |
603 void HAL_PWREx_EnableSRAM2ContentRetention(void) | |
604 { | |
605 SET_BIT(PWR->CR3, PWR_CR3_RRS); | |
606 } | |
607 | |
608 | |
609 /** | |
610 * @brief Disable SRAM2 content retention in Standby mode. | |
611 * @note When RRS bit is reset, SRAM2 is powered off in Standby mode | |
612 * and its content is lost. | |
613 * @retval None | |
614 */ | |
615 void HAL_PWREx_DisableSRAM2ContentRetention(void) | |
616 { | |
617 CLEAR_BIT(PWR->CR3, PWR_CR3_RRS); | |
618 } | |
619 | |
620 | |
621 | |
622 | |
623 #if defined(PWR_CR2_PVME1) | |
624 /** | |
625 * @brief Enable the Power Voltage Monitoring 1: VDDUSB versus 1.2V. | |
626 * @retval None | |
627 */ | |
628 void HAL_PWREx_EnablePVM1(void) | |
629 { | |
630 SET_BIT(PWR->CR2, PWR_PVM_1); | |
631 } | |
632 | |
633 /** | |
634 * @brief Disable the Power Voltage Monitoring 1: VDDUSB versus 1.2V. | |
635 * @retval None | |
636 */ | |
637 void HAL_PWREx_DisablePVM1(void) | |
638 { | |
639 CLEAR_BIT(PWR->CR2, PWR_PVM_1); | |
640 } | |
641 #endif /* PWR_CR2_PVME1 */ | |
642 | |
643 | |
644 #if defined(PWR_CR2_PVME2) | |
645 /** | |
646 * @brief Enable the Power Voltage Monitoring 2: VDDIO2 versus 0.9V. | |
647 * @retval None | |
648 */ | |
649 void HAL_PWREx_EnablePVM2(void) | |
650 { | |
651 SET_BIT(PWR->CR2, PWR_PVM_2); | |
652 } | |
653 | |
654 /** | |
655 * @brief Disable the Power Voltage Monitoring 2: VDDIO2 versus 0.9V. | |
656 * @retval None | |
657 */ | |
658 void HAL_PWREx_DisablePVM2(void) | |
659 { | |
660 CLEAR_BIT(PWR->CR2, PWR_PVM_2); | |
661 } | |
662 #endif /* PWR_CR2_PVME2 */ | |
663 | |
664 | |
665 /** | |
666 * @brief Enable the Power Voltage Monitoring 3: VDDA versus 1.62V. | |
667 * @retval None | |
668 */ | |
669 void HAL_PWREx_EnablePVM3(void) | |
670 { | |
671 SET_BIT(PWR->CR2, PWR_PVM_3); | |
672 } | |
673 | |
674 /** | |
675 * @brief Disable the Power Voltage Monitoring 3: VDDA versus 1.62V. | |
676 * @retval None | |
677 */ | |
678 void HAL_PWREx_DisablePVM3(void) | |
679 { | |
680 CLEAR_BIT(PWR->CR2, PWR_PVM_3); | |
681 } | |
682 | |
683 | |
684 /** | |
685 * @brief Enable the Power Voltage Monitoring 4: VDDA versus 2.2V. | |
686 * @retval None | |
687 */ | |
688 void HAL_PWREx_EnablePVM4(void) | |
689 { | |
690 SET_BIT(PWR->CR2, PWR_PVM_4); | |
691 } | |
692 | |
693 /** | |
694 * @brief Disable the Power Voltage Monitoring 4: VDDA versus 2.2V. | |
695 * @retval None | |
696 */ | |
697 void HAL_PWREx_DisablePVM4(void) | |
698 { | |
699 CLEAR_BIT(PWR->CR2, PWR_PVM_4); | |
700 } | |
701 | |
702 | |
703 | |
704 | |
705 /** | |
706 * @brief Configure the Peripheral Voltage Monitoring (PVM). | |
707 * @param sConfigPVM: pointer to a PWR_PVMTypeDef structure that contains the | |
708 * PVM configuration information. | |
709 * @note The API configures a single PVM according to the information contained | |
710 * in the input structure. To configure several PVMs, the API must be singly | |
711 * called for each PVM used. | |
712 * @note Refer to the electrical characteristics of your device datasheet for | |
713 * more details about the voltage thresholds corresponding to each | |
714 * detection level and to each monitored supply. | |
715 * @retval HAL status | |
716 */ | |
717 HAL_StatusTypeDef HAL_PWREx_ConfigPVM(PWR_PVMTypeDef *sConfigPVM) | |
718 { | |
719 /* Check the parameters */ | |
720 assert_param(IS_PWR_PVM_TYPE(sConfigPVM->PVMType)); | |
721 assert_param(IS_PWR_PVM_MODE(sConfigPVM->Mode)); | |
722 | |
723 | |
724 /* Configure EXTI 35 to 38 interrupts if so required: | |
725 scan thru PVMType to detect which PVMx is set and | |
726 configure the corresponding EXTI line accordingly. */ | |
727 switch (sConfigPVM->PVMType) | |
728 { | |
729 #if defined(PWR_CR2_PVME1) | |
730 case PWR_PVM_1: | |
731 /* Clear any previous config. Keep it clear if no event or IT mode is selected */ | |
732 __HAL_PWR_PVM1_EXTI_DISABLE_EVENT(); | |
733 __HAL_PWR_PVM1_EXTI_DISABLE_IT(); | |
734 __HAL_PWR_PVM1_EXTI_DISABLE_FALLING_EDGE(); | |
735 __HAL_PWR_PVM1_EXTI_DISABLE_RISING_EDGE(); | |
736 | |
737 /* Configure interrupt mode */ | |
738 if((sConfigPVM->Mode & PVM_MODE_IT) == PVM_MODE_IT) | |
739 { | |
740 __HAL_PWR_PVM1_EXTI_ENABLE_IT(); | |
741 } | |
742 | |
743 /* Configure event mode */ | |
744 if((sConfigPVM->Mode & PVM_MODE_EVT) == PVM_MODE_EVT) | |
745 { | |
746 __HAL_PWR_PVM1_EXTI_ENABLE_EVENT(); | |
747 } | |
748 | |
749 /* Configure the edge */ | |
750 if((sConfigPVM->Mode & PVM_RISING_EDGE) == PVM_RISING_EDGE) | |
751 { | |
752 __HAL_PWR_PVM1_EXTI_ENABLE_RISING_EDGE(); | |
753 } | |
754 | |
755 if((sConfigPVM->Mode & PVM_FALLING_EDGE) == PVM_FALLING_EDGE) | |
756 { | |
757 __HAL_PWR_PVM1_EXTI_ENABLE_FALLING_EDGE(); | |
758 } | |
759 break; | |
760 #endif /* PWR_CR2_PVME1 */ | |
761 | |
762 #if defined(PWR_CR2_PVME2) | |
763 case PWR_PVM_2: | |
764 /* Clear any previous config. Keep it clear if no event or IT mode is selected */ | |
765 __HAL_PWR_PVM2_EXTI_DISABLE_EVENT(); | |
766 __HAL_PWR_PVM2_EXTI_DISABLE_IT(); | |
767 __HAL_PWR_PVM2_EXTI_DISABLE_FALLING_EDGE(); | |
768 __HAL_PWR_PVM2_EXTI_DISABLE_RISING_EDGE(); | |
769 | |
770 /* Configure interrupt mode */ | |
771 if((sConfigPVM->Mode & PVM_MODE_IT) == PVM_MODE_IT) | |
772 { | |
773 __HAL_PWR_PVM2_EXTI_ENABLE_IT(); | |
774 } | |
775 | |
776 /* Configure event mode */ | |
777 if((sConfigPVM->Mode & PVM_MODE_EVT) == PVM_MODE_EVT) | |
778 { | |
779 __HAL_PWR_PVM2_EXTI_ENABLE_EVENT(); | |
780 } | |
781 | |
782 /* Configure the edge */ | |
783 if((sConfigPVM->Mode & PVM_RISING_EDGE) == PVM_RISING_EDGE) | |
784 { | |
785 __HAL_PWR_PVM2_EXTI_ENABLE_RISING_EDGE(); | |
786 } | |
787 | |
788 if((sConfigPVM->Mode & PVM_FALLING_EDGE) == PVM_FALLING_EDGE) | |
789 { | |
790 __HAL_PWR_PVM2_EXTI_ENABLE_FALLING_EDGE(); | |
791 } | |
792 break; | |
793 #endif /* PWR_CR2_PVME2 */ | |
794 | |
795 case PWR_PVM_3: | |
796 /* Clear any previous config. Keep it clear if no event or IT mode is selected */ | |
797 __HAL_PWR_PVM3_EXTI_DISABLE_EVENT(); | |
798 __HAL_PWR_PVM3_EXTI_DISABLE_IT(); | |
799 __HAL_PWR_PVM3_EXTI_DISABLE_FALLING_EDGE(); | |
800 __HAL_PWR_PVM3_EXTI_DISABLE_RISING_EDGE(); | |
801 | |
802 /* Configure interrupt mode */ | |
803 if((sConfigPVM->Mode & PVM_MODE_IT) == PVM_MODE_IT) | |
804 { | |
805 __HAL_PWR_PVM3_EXTI_ENABLE_IT(); | |
806 } | |
807 | |
808 /* Configure event mode */ | |
809 if((sConfigPVM->Mode & PVM_MODE_EVT) == PVM_MODE_EVT) | |
810 { | |
811 __HAL_PWR_PVM3_EXTI_ENABLE_EVENT(); | |
812 } | |
813 | |
814 /* Configure the edge */ | |
815 if((sConfigPVM->Mode & PVM_RISING_EDGE) == PVM_RISING_EDGE) | |
816 { | |
817 __HAL_PWR_PVM3_EXTI_ENABLE_RISING_EDGE(); | |
818 } | |
819 | |
820 if((sConfigPVM->Mode & PVM_FALLING_EDGE) == PVM_FALLING_EDGE) | |
821 { | |
822 __HAL_PWR_PVM3_EXTI_ENABLE_FALLING_EDGE(); | |
823 } | |
824 break; | |
825 | |
826 case PWR_PVM_4: | |
827 /* Clear any previous config. Keep it clear if no event or IT mode is selected */ | |
828 __HAL_PWR_PVM4_EXTI_DISABLE_EVENT(); | |
829 __HAL_PWR_PVM4_EXTI_DISABLE_IT(); | |
830 __HAL_PWR_PVM4_EXTI_DISABLE_FALLING_EDGE(); | |
831 __HAL_PWR_PVM4_EXTI_DISABLE_RISING_EDGE(); | |
832 | |
833 /* Configure interrupt mode */ | |
834 if((sConfigPVM->Mode & PVM_MODE_IT) == PVM_MODE_IT) | |
835 { | |
836 __HAL_PWR_PVM4_EXTI_ENABLE_IT(); | |
837 } | |
838 | |
839 /* Configure event mode */ | |
840 if((sConfigPVM->Mode & PVM_MODE_EVT) == PVM_MODE_EVT) | |
841 { | |
842 __HAL_PWR_PVM4_EXTI_ENABLE_EVENT(); | |
843 } | |
844 | |
845 /* Configure the edge */ | |
846 if((sConfigPVM->Mode & PVM_RISING_EDGE) == PVM_RISING_EDGE) | |
847 { | |
848 __HAL_PWR_PVM4_EXTI_ENABLE_RISING_EDGE(); | |
849 } | |
850 | |
851 if((sConfigPVM->Mode & PVM_FALLING_EDGE) == PVM_FALLING_EDGE) | |
852 { | |
853 __HAL_PWR_PVM4_EXTI_ENABLE_FALLING_EDGE(); | |
854 } | |
855 break; | |
856 | |
857 default: | |
858 return HAL_ERROR; | |
859 | |
860 } | |
861 | |
862 | |
863 return HAL_OK; | |
864 } | |
865 | |
866 | |
867 | |
868 /** | |
869 * @brief Enter Low-power Run mode | |
870 * @note In Low-power Run mode, all I/O pins keep the same state as in Run mode. | |
871 * @note When Regulator is set to PWR_LOWPOWERREGULATOR_ON, the user can optionally configure the | |
872 * Flash in power-down monde in setting the RUN_PD bit in FLASH_ACR register. | |
873 * Additionally, the clock frequency must be reduced below 2 MHz. | |
874 * Setting RUN_PD in FLASH_ACR then appropriately reducing the clock frequency must | |
875 * be done before calling HAL_PWREx_EnableLowPowerRunMode() API. | |
876 * @retval None | |
877 */ | |
878 void HAL_PWREx_EnableLowPowerRunMode(void) | |
879 { | |
880 /* Set Regulator parameter */ | |
881 SET_BIT(PWR->CR1, PWR_CR1_LPR); | |
882 } | |
883 | |
884 | |
885 /** | |
886 * @brief Exit Low-power Run mode. | |
887 * @note Before HAL_PWREx_DisableLowPowerRunMode() completion, the function checks that | |
888 * REGLPF has been properly reset (otherwise, HAL_PWREx_DisableLowPowerRunMode | |
889 * returns HAL_TIMEOUT status). The system clock frequency can then be | |
890 * increased above 2 MHz. | |
891 * @retval HAL Status | |
892 */ | |
893 HAL_StatusTypeDef HAL_PWREx_DisableLowPowerRunMode(void) | |
894 { | |
895 uint32_t wait_loop_index = 0; | |
896 | |
897 /* Clear LPR bit */ | |
898 CLEAR_BIT(PWR->CR1, PWR_CR1_LPR); | |
899 | |
900 /* Wait until REGLPF is reset */ | |
901 wait_loop_index = (PWR_FLAG_SETTING_DELAY_US * (SystemCoreClock / 1000000)); | |
902 while ((wait_loop_index != 0) && (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_REGLPF))) | |
903 { | |
904 wait_loop_index--; | |
905 } | |
906 if (HAL_IS_BIT_SET(PWR->SR2, PWR_SR2_REGLPF)) | |
907 { | |
908 return HAL_TIMEOUT; | |
909 } | |
910 | |
911 return HAL_OK; | |
912 } | |
913 | |
914 | |
915 /** | |
916 * @brief Enter Stop 0 mode. | |
917 * @note In Stop 0 mode, main and low voltage regulators are ON. | |
918 * @note In Stop 0 mode, all I/O pins keep the same state as in Run mode. | |
919 * @note All clocks in the VCORE domain are stopped; the PLL, the MSI, | |
920 * the HSI and the HSE oscillators are disabled. Some peripherals with the wakeup capability | |
921 * (I2Cx, USARTx and LPUART) can switch on the HSI to receive a frame, and switch off the HSI | |
922 * after receiving the frame if it is not a wakeup frame. In this case, the HSI clock is propagated | |
923 * only to the peripheral requesting it. | |
924 * SRAM1, SRAM2 and register contents are preserved. | |
925 * The BOR is available. | |
926 * @note When exiting Stop 0 mode by issuing an interrupt or a wakeup event, | |
927 * the HSI RC oscillator is selected as system clock if STOPWUCK bit in RCC_CFGR register | |
928 * is set; the MSI oscillator is selected if STOPWUCK is cleared. | |
929 * @note By keeping the internal regulator ON during Stop 0 mode, the consumption | |
930 * is higher although the startup time is reduced. | |
931 * @param STOPEntry specifies if Stop mode in entered with WFI or WFE instruction. | |
932 * This parameter can be one of the following values: | |
933 * @arg @ref PWR_STOPENTRY_WFI Enter Stop mode with WFI instruction | |
934 * @arg @ref PWR_STOPENTRY_WFE Enter Stop mode with WFE instruction | |
935 * @retval None | |
936 */ | |
937 void HAL_PWREx_EnterSTOP0Mode(uint8_t STOPEntry) | |
938 { | |
939 /* Check the parameters */ | |
940 assert_param(IS_PWR_STOP_ENTRY(STOPEntry)); | |
941 | |
942 /* Stop 0 mode with Main Regulator */ | |
943 MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, PWR_CR1_LPMS_STOP0); | |
944 | |
945 /* Set SLEEPDEEP bit of Cortex System Control Register */ | |
946 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
947 | |
948 /* Select Stop mode entry --------------------------------------------------*/ | |
949 if(STOPEntry == PWR_STOPENTRY_WFI) | |
950 { | |
951 /* Request Wait For Interrupt */ | |
952 __WFI(); | |
953 } | |
954 else | |
955 { | |
956 /* Request Wait For Event */ | |
957 __SEV(); | |
958 __WFE(); | |
959 __WFE(); | |
960 } | |
961 | |
962 /* Reset SLEEPDEEP bit of Cortex System Control Register */ | |
963 CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
964 } | |
965 | |
966 | |
967 /** | |
968 * @brief Enter Stop 1 mode. | |
969 * @note In Stop 1 mode, only low power voltage regulator is ON. | |
970 * @note In Stop 1 mode, all I/O pins keep the same state as in Run mode. | |
971 * @note All clocks in the VCORE domain are stopped; the PLL, the MSI, | |
972 * the HSI and the HSE oscillators are disabled. Some peripherals with the wakeup capability | |
973 * (I2Cx, USARTx and LPUART) can switch on the HSI to receive a frame, and switch off the HSI | |
974 * after receiving the frame if it is not a wakeup frame. In this case, the HSI clock is propagated | |
975 * only to the peripheral requesting it. | |
976 * SRAM1, SRAM2 and register contents are preserved. | |
977 * The BOR is available. | |
978 * @note When exiting Stop 1 mode by issuing an interrupt or a wakeup event, | |
979 * the HSI RC oscillator is selected as system clock if STOPWUCK bit in RCC_CFGR register | |
980 * is set; the MSI oscillator is selected if STOPWUCK is cleared. | |
981 * @note Due to low power mode, an additional startup delay is incurred when waking up from Stop 1 mode. | |
982 * @param STOPEntry specifies if Stop mode in entered with WFI or WFE instruction. | |
983 * This parameter can be one of the following values: | |
984 * @arg @ref PWR_STOPENTRY_WFI Enter Stop mode with WFI instruction | |
985 * @arg @ref PWR_STOPENTRY_WFE Enter Stop mode with WFE instruction | |
986 * @retval None | |
987 */ | |
988 void HAL_PWREx_EnterSTOP1Mode(uint8_t STOPEntry) | |
989 { | |
990 /* Check the parameters */ | |
991 assert_param(IS_PWR_STOP_ENTRY(STOPEntry)); | |
992 | |
993 /* Stop 1 mode with Low-Power Regulator */ | |
994 MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, PWR_CR1_LPMS_STOP1); | |
995 | |
996 /* Set SLEEPDEEP bit of Cortex System Control Register */ | |
997 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
998 | |
999 /* Select Stop mode entry --------------------------------------------------*/ | |
1000 if(STOPEntry == PWR_STOPENTRY_WFI) | |
1001 { | |
1002 /* Request Wait For Interrupt */ | |
1003 __WFI(); | |
1004 } | |
1005 else | |
1006 { | |
1007 /* Request Wait For Event */ | |
1008 __SEV(); | |
1009 __WFE(); | |
1010 __WFE(); | |
1011 } | |
1012 | |
1013 /* Reset SLEEPDEEP bit of Cortex System Control Register */ | |
1014 CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
1015 } | |
1016 | |
1017 | |
1018 /** | |
1019 * @brief Enter Stop 2 mode. | |
1020 * @note In Stop 2 mode, only low power voltage regulator is ON. | |
1021 * @note In Stop 2 mode, all I/O pins keep the same state as in Run mode. | |
1022 * @note All clocks in the VCORE domain are stopped, the PLL, the MSI, | |
1023 * the HSI and the HSE oscillators are disabled. Some peripherals with wakeup capability | |
1024 * (LCD, LPTIM1, I2C3 and LPUART) can switch on the HSI to receive a frame, and switch off the HSI after | |
1025 * receiving the frame if it is not a wakeup frame. In this case the HSI clock is propagated only | |
1026 * to the peripheral requesting it. | |
1027 * SRAM1, SRAM2 and register contents are preserved. | |
1028 * The BOR is available. | |
1029 * The voltage regulator is set in low-power mode but LPR bit must be cleared to enter stop 2 mode. | |
1030 * Otherwise, Stop 1 mode is entered. | |
1031 * @note When exiting Stop 2 mode by issuing an interrupt or a wakeup event, | |
1032 * the HSI RC oscillator is selected as system clock if STOPWUCK bit in RCC_CFGR register | |
1033 * is set; the MSI oscillator is selected if STOPWUCK is cleared. | |
1034 * @param STOPEntry specifies if Stop mode in entered with WFI or WFE instruction. | |
1035 * This parameter can be one of the following values: | |
1036 * @arg @ref PWR_STOPENTRY_WFI Enter Stop mode with WFI instruction | |
1037 * @arg @ref PWR_STOPENTRY_WFE Enter Stop mode with WFE instruction | |
1038 * @retval None | |
1039 */ | |
1040 void HAL_PWREx_EnterSTOP2Mode(uint8_t STOPEntry) | |
1041 { | |
1042 /* Check the parameter */ | |
1043 assert_param(IS_PWR_STOP_ENTRY(STOPEntry)); | |
1044 | |
1045 /* Set Stop mode 2 */ | |
1046 MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, PWR_CR1_LPMS_STOP2); | |
1047 | |
1048 /* Set SLEEPDEEP bit of Cortex System Control Register */ | |
1049 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
1050 | |
1051 /* Select Stop mode entry --------------------------------------------------*/ | |
1052 if(STOPEntry == PWR_STOPENTRY_WFI) | |
1053 { | |
1054 /* Request Wait For Interrupt */ | |
1055 __WFI(); | |
1056 } | |
1057 else | |
1058 { | |
1059 /* Request Wait For Event */ | |
1060 __SEV(); | |
1061 __WFE(); | |
1062 __WFE(); | |
1063 } | |
1064 | |
1065 /* Reset SLEEPDEEP bit of Cortex System Control Register */ | |
1066 CLEAR_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
1067 } | |
1068 | |
1069 | |
1070 | |
1071 | |
1072 | |
1073 /** | |
1074 * @brief Enter Shutdown mode. | |
1075 * @note In Shutdown mode, the PLL, the HSI, the MSI, the LSI and the HSE oscillators are switched | |
1076 * off. The voltage regulator is disabled and Vcore domain is powered off. | |
1077 * SRAM1, SRAM2 and registers contents are lost except for registers in the Backup domain. | |
1078 * The BOR is not available. | |
1079 * @note The I/Os can be configured either with a pull-up or pull-down or can be kept in analog state. | |
1080 * @retval None | |
1081 */ | |
1082 void HAL_PWREx_EnterSHUTDOWNMode(void) | |
1083 { | |
1084 | |
1085 /* Set Shutdown mode */ | |
1086 MODIFY_REG(PWR->CR1, PWR_CR1_LPMS, PWR_CR1_LPMS_SHUTDOWN); | |
1087 | |
1088 /* Set SLEEPDEEP bit of Cortex System Control Register */ | |
1089 SET_BIT(SCB->SCR, ((uint32_t)SCB_SCR_SLEEPDEEP_Msk)); | |
1090 | |
1091 /* This option is used to ensure that store operations are completed */ | |
1092 #if defined ( __CC_ARM) | |
1093 __force_stores(); | |
1094 #endif | |
1095 /* Request Wait For Interrupt */ | |
1096 __WFI(); | |
1097 } | |
1098 | |
1099 | |
1100 | |
1101 | |
1102 /** | |
1103 * @brief This function handles the PWR PVD/PVMx interrupt request. | |
1104 * @note This API should be called under the PVD_PVM_IRQHandler(). | |
1105 * @retval None | |
1106 */ | |
1107 void HAL_PWREx_PVD_PVM_IRQHandler(void) | |
1108 { | |
1109 /* Check PWR exti flag */ | |
1110 if(__HAL_PWR_PVD_EXTI_GET_FLAG() != RESET) | |
1111 { | |
1112 /* PWR PVD interrupt user callback */ | |
1113 HAL_PWR_PVDCallback(); | |
1114 | |
1115 /* Clear PVD exti pending bit */ | |
1116 __HAL_PWR_PVD_EXTI_CLEAR_FLAG(); | |
1117 } | |
1118 /* Next, successively check PVMx exti flags */ | |
1119 #if defined(PWR_CR2_PVME1) | |
1120 if(__HAL_PWR_PVM1_EXTI_GET_FLAG() != RESET) | |
1121 { | |
1122 /* PWR PVM1 interrupt user callback */ | |
1123 HAL_PWREx_PVM1Callback(); | |
1124 | |
1125 /* Clear PVM1 exti pending bit */ | |
1126 __HAL_PWR_PVM1_EXTI_CLEAR_FLAG(); | |
1127 } | |
1128 #endif /* PWR_CR2_PVME1 */ | |
1129 #if defined(PWR_CR2_PVME2) | |
1130 if(__HAL_PWR_PVM2_EXTI_GET_FLAG() != RESET) | |
1131 { | |
1132 /* PWR PVM2 interrupt user callback */ | |
1133 HAL_PWREx_PVM2Callback(); | |
1134 | |
1135 /* Clear PVM2 exti pending bit */ | |
1136 __HAL_PWR_PVM2_EXTI_CLEAR_FLAG(); | |
1137 } | |
1138 #endif /* PWR_CR2_PVME2 */ | |
1139 if(__HAL_PWR_PVM3_EXTI_GET_FLAG() != RESET) | |
1140 { | |
1141 /* PWR PVM3 interrupt user callback */ | |
1142 HAL_PWREx_PVM3Callback(); | |
1143 | |
1144 /* Clear PVM3 exti pending bit */ | |
1145 __HAL_PWR_PVM3_EXTI_CLEAR_FLAG(); | |
1146 } | |
1147 if(__HAL_PWR_PVM4_EXTI_GET_FLAG() != RESET) | |
1148 { | |
1149 /* PWR PVM4 interrupt user callback */ | |
1150 HAL_PWREx_PVM4Callback(); | |
1151 | |
1152 /* Clear PVM4 exti pending bit */ | |
1153 __HAL_PWR_PVM4_EXTI_CLEAR_FLAG(); | |
1154 } | |
1155 } | |
1156 | |
1157 | |
1158 #if defined(PWR_CR2_PVME1) | |
1159 /** | |
1160 * @brief PWR PVM1 interrupt callback | |
1161 * @retval None | |
1162 */ | |
1163 __weak void HAL_PWREx_PVM1Callback(void) | |
1164 { | |
1165 /* NOTE : This function should not be modified; when the callback is needed, | |
1166 HAL_PWREx_PVM1Callback() API can be implemented in the user file | |
1167 */ | |
1168 } | |
1169 #endif /* PWR_CR2_PVME1 */ | |
1170 | |
1171 #if defined(PWR_CR2_PVME2) | |
1172 /** | |
1173 * @brief PWR PVM2 interrupt callback | |
1174 * @retval None | |
1175 */ | |
1176 __weak void HAL_PWREx_PVM2Callback(void) | |
1177 { | |
1178 /* NOTE : This function should not be modified; when the callback is needed, | |
1179 HAL_PWREx_PVM2Callback() API can be implemented in the user file | |
1180 */ | |
1181 } | |
1182 #endif /* PWR_CR2_PVME2 */ | |
1183 | |
1184 /** | |
1185 * @brief PWR PVM3 interrupt callback | |
1186 * @retval None | |
1187 */ | |
1188 __weak void HAL_PWREx_PVM3Callback(void) | |
1189 { | |
1190 /* NOTE : This function should not be modified; when the callback is needed, | |
1191 HAL_PWREx_PVM3Callback() API can be implemented in the user file | |
1192 */ | |
1193 } | |
1194 | |
1195 /** | |
1196 * @brief PWR PVM4 interrupt callback | |
1197 * @retval None | |
1198 */ | |
1199 __weak void HAL_PWREx_PVM4Callback(void) | |
1200 { | |
1201 /* NOTE : This function should not be modified; when the callback is needed, | |
1202 HAL_PWREx_PVM4Callback() API can be implemented in the user file | |
1203 */ | |
1204 } | |
1205 | |
1206 | |
1207 /** | |
1208 * @} | |
1209 */ | |
1210 | |
1211 /** | |
1212 * @} | |
1213 */ | |
1214 | |
1215 #endif /* HAL_PWR_MODULE_ENABLED */ | |
1216 /** | |
1217 * @} | |
1218 */ | |
1219 | |
1220 /** | |
1221 * @} | |
1222 */ | |
1223 | |
1224 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |