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 {
89 #if defined SOC_GR5515 || defined SOC_GR5X25 || defined SOC_GR5526
90  QSPI_PWR_ID,
91  I2S_PWR_ID,
92  PKC_PWR_ID,
93  HMAC_PWR_ID,
94  AES_PWR_ID,
95 #endif
96 #if defined SOC_GR5515 || defined SOC_GR5526
97  ISO7816_PWR_ID,
98 #endif
99 #if defined SOC_GR5X25 || defined SOC_GR5526
100  DSPI_PWR_ID,
101  PDM_PWR_ID,
102 #endif
104 #if defined SOC_GR5410
105  SPIS_PWR_ID,
106  CAN_PWR_ID,
107  LIN_PWR_ID,
108 #endif
110 } pwr_id_t;
111 /** @} */
112 
113 /** @addtogroup APP_PWR_STRUCTURES Structures
114  * @{
115  */
116 /**
117  * @brief PWR sleep check function Structure
118  */
119 typedef struct
120 {
121  bool (*app_prepare_for_sleep)(void); /**< Peripherals prepare sleep fuction. */
122  void (*app_wake_up_ind)(void); /**< Resume peripherals when chip wakeup. */
124 
125 /** @} */
126 
127 
128 /* Exported functions --------------------------------------------------------*/
129 /** @addtogroup APP_PWR_DRIVER_FUNCTIONS Functions
130  * @{
131  */
132 /**
133  ****************************************************************************************
134  * @brief Initialize the app power management module
135  ****************************************************************************************
136  */
137 void app_pwr_mgmt_init(void);
138 
139 /**
140  ****************************************************************************************
141  * @brief set PWR sleep callback function
142  * @param p_cb : Device check callback function
143  * @param wakeup_priority : Device wakeup priority
144  * @param id : which id want to register
145  *
146  * @return ID
147  ****************************************************************************************
148  */
150 
151 /**
152  ****************************************************************************************
153  * @brief Unregister PWR sleep callback function
154  * @param id : which id want to unregister
155  ****************************************************************************************
156  */
158 
159 /**
160  ****************************************************************************************
161  * @brief Things to do after waking up.
162  ****************************************************************************************
163  */
164 void pwr_wake_up_ind(void);
165 
166 /**
167  ****************************************************************************************
168  * @brief Check peripheral status before going to sleep.
169  ****************************************************************************************
170  */
172 /** @} */
173 
174 #endif
175 
176 /** @} */
177 /** @} */
178 /** @} */
SYSTEM_PWR_ID
@ SYSTEM_PWR_ID
Definition: app_pwr_mgmt.h:77
SPI_PWR_ID
@ SPI_PWR_ID
Definition: app_pwr_mgmt.h:82
ADC_PWR_ID
@ ADC_PWR_ID
Definition: app_pwr_mgmt.h:86
wakeup_priority_t
wakeup_priority_t
APP driver peripheral wakeup priority define.
Definition: app_drv_config.h:501
PWM_PWR_ID
@ PWM_PWR_ID
Definition: app_pwr_mgmt.h:83
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:80
DMA_PWR_ID
@ DMA_PWR_ID
Definition: app_pwr_mgmt.h:79
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:109
I2C_PWR_ID
@ I2C_PWR_ID
Definition: app_pwr_mgmt.h:81
MPU_PWR_ID
@ MPU_PWR_ID
Definition: app_pwr_mgmt.h:103
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:87
TIM_PWR_ID
@ TIM_PWR_ID
Definition: app_pwr_mgmt.h:84
RNG_PWR_ID
@ RNG_PWR_ID
Definition: app_pwr_mgmt.h:88
pwr_id_t
pwr_id_t
PWR ID Enumerations definition.
Definition: app_pwr_mgmt.h:76
grx_sys.h
System API.
DUAL_TIM_PWR_ID
@ DUAL_TIM_PWR_ID
Definition: app_pwr_mgmt.h:85
USER_PWR_ID
@ USER_PWR_ID
Definition: app_pwr_mgmt.h:78
pwr_mgmt_dev_state_t
pwr_mgmt_dev_state_t
power manager device work state.
Definition: gr5405_pwr.h:132
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:120