app_pwr_mgmt.h
Go to the documentation of this file.
1 /**
2  ****************************************************************************************
3  *
4  * @file app_pwr_mgmt.h
5  * @author BLE Driver Team
6  * @brief Header file containing functions prototypes of UART PWR library.
7  *
8  ****************************************************************************************
9  * @attention
10  #####Copyright (c) 2019 GOODIX
11  All rights reserved.
12 
13  Redistribution and use in source and binary forms, with or without
14  modification, are permitted provided that the following conditions are met:
15  * Redistributions of source code must retain the above copyright
16  notice, this list of conditions and the following disclaimer.
17  * Redistributions in binary form must reproduce the above copyright
18  notice, this list of conditions and the following disclaimer in the
19  documentation and/or other materials provided with the distribution.
20  * Neither the name of GOODIX nor the names of its contributors may be used
21  to endorse or promote products derived from this software without
22  specific prior written permission.
23 
24  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
28  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34  POSSIBILITY OF SUCH DAMAGE.
35  ****************************************************************************************
36  */
37 
38 /** @addtogroup PERIPHERAL Peripheral Driver
39  * @{
40  */
41 
42 /** @addtogroup APP_DRIVER APP DRIVER
43  * @{
44  */
45 
46 /** @defgroup APP_PWR_MGMT PWR MGMT
47  * @brief PWR MGMT APP module driver.
48  * @{
49  */
50 
51 
52 #ifndef _APP_PWR_MGMT_H_
53 #define _APP_PWR_MGMT_H_
54 
55 #include "grx_sys.h"
56 #include "app_drv_config.h"
57 #include <stdint.h>
58 #include <stdbool.h>
59 
60 /** @addtogroup APP_PWR_DEFINE Defines
61  * @{
62  */
63 /**
64  * @brief PWR MAX value for sleep check
65  */
66 #define APP_SLEEP_CB_MAX PWR_ID_MAX
67 /** @} */
68 
69 /** @addtogroup APP_PWR_ENUMERATIONS Enumerations
70  * @{
71  */
72 /**
73  * @brief PWR ID Enumerations definition
74  */
75 typedef enum
76 {
87 #if defined SOC_GR5515 || defined SOC_GR5X25 || defined SOC_GR5526
88  QSPI_PWR_ID,
89  I2S_PWR_ID,
90  PKC_PWR_ID,
91  HMAC_PWR_ID,
92  AES_PWR_ID,
93 #endif
94 #if defined SOC_GR5515 || defined SOC_GR5526
95  ISO7816_PWR_ID,
96 #endif
97 #if defined SOC_GR5X25 || defined SOC_GR5526
98  DSPI_PWR_ID,
99  PDM_PWR_ID,
100 #endif
102 } pwr_id_t;
103 /** @} */
104 
105 /** @addtogroup APP_PWR_STRUCTURES Structures
106  * @{
107  */
108 /**
109  * @brief PWR sleep check function Structure
110  */
111 typedef struct
112 {
113  bool (*app_prepare_for_sleep)(void); /**< Peripherals prepare sleep fuction. */
114  void (*app_wake_up_ind)(void); /**< Resume peripherals when chip wakeup. */
116 
117 /** @} */
118 
119 
120 /* Exported functions --------------------------------------------------------*/
121 /** @addtogroup APP_PWR_DRIVER_FUNCTIONS Functions
122  * @{
123  */
124 /**
125  ****************************************************************************************
126  * @brief Initialize the app power management module
127  ****************************************************************************************
128  */
129 void app_pwr_mgmt_init(void);
130 
131 /**
132  ****************************************************************************************
133  * @brief set PWR sleep callback function
134  * @param p_cb : Device check callback function
135  * @param wakeup_priority : Device wakeup priority
136  * @param id : which id want to register
137  *
138  * @return ID
139  ****************************************************************************************
140  */
142 
143 /**
144  ****************************************************************************************
145  * @brief Unregister PWR sleep callback function
146  * @param id : which id want to unregister
147  ****************************************************************************************
148  */
150 
151 /**
152  ****************************************************************************************
153  * @brief Things to do after waking up.
154  ****************************************************************************************
155  */
156 void pwr_wake_up_ind(void);
157 
158 /**
159  ****************************************************************************************
160  * @brief Check peripheral status before going to sleep.
161  ****************************************************************************************
162  */
164 /** @} */
165 
166 #endif
167 
168 /** @} */
169 /** @} */
170 /** @} */
SPI_PWR_ID
@ SPI_PWR_ID
Definition: app_pwr_mgmt.h:80
ADC_PWR_ID
@ ADC_PWR_ID
Definition: app_pwr_mgmt.h:84
wakeup_priority_t
wakeup_priority_t
APP driver peripheral wakeup priority define.
Definition: app_drv_config.h:189
PWM_PWR_ID
@ PWM_PWR_ID
Definition: app_pwr_mgmt.h:81
pwr_register_sleep_cb
pwr_id_t pwr_register_sleep_cb(const app_sleep_callbacks_t *p_cb, wakeup_priority_t wakeup_priority, pwr_id_t id)
set PWR sleep callback function
UART_PWR_ID
@ UART_PWR_ID
Definition: app_pwr_mgmt.h:78
DMA_PWR_ID
@ DMA_PWR_ID
Definition: app_pwr_mgmt.h:77
pwr_enter_sleep_check
pwr_mgmt_dev_state_t pwr_enter_sleep_check(void)
Check peripheral status before going to sleep.
app_pwr_mgmt_init
void app_pwr_mgmt_init(void)
Initialize the app power management module.
PWR_ID_MAX
@ PWR_ID_MAX
Definition: app_pwr_mgmt.h:101
I2C_PWR_ID
@ I2C_PWR_ID
Definition: app_pwr_mgmt.h:79
pwr_unregister_sleep_cb
void pwr_unregister_sleep_cb(pwr_id_t id)
Unregister PWR sleep callback function.
pwr_wake_up_ind
void pwr_wake_up_ind(void)
Things to do after waking up.
COMP_PWR_ID
@ COMP_PWR_ID
Definition: app_pwr_mgmt.h:85
TIM_PWR_ID
@ TIM_PWR_ID
Definition: app_pwr_mgmt.h:82
RNG_PWR_ID
@ RNG_PWR_ID
Definition: app_pwr_mgmt.h:86
pwr_id_t
pwr_id_t
PWR ID Enumerations definition.
Definition: app_pwr_mgmt.h:76
grx_sys.h
DUAL_TIM_PWR_ID
@ DUAL_TIM_PWR_ID
Definition: app_pwr_mgmt.h:83
pwr_mgmt_dev_state_t
pwr_mgmt_dev_state_t
power manager device work state.
Definition: gr55xx_pwr.h:95
app_drv_config.h
Header file of app driver config code.
app_sleep_callbacks_t
PWR sleep check function Structure.
Definition: app_pwr_mgmt.h:112