gr55xx_ll_clk.h
Go to the documentation of this file.
1 /**
2  ****************************************************************************************
3  *
4  * @file gr55xx_ll_clk.h
5  * @author BLE Driver Team
6  * @brief Header file containing functions prototypes of CLOCK LL 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 LL_DRIVER LL Driver
43  * @{
44  */
45 
46 /** @defgroup LL_CLK CLK
47  * @brief CLOCK CALIBRATION LL module driver.
48  * @{
49  */
50 
51 /* Define to prevent recursive inclusion -------------------------------------*/
52 #ifndef __GR55XX_LL_CLK_H_
53 #define __GR55XX_LL_CLK_H_
54 
55 #ifdef __cplusplus
56 extern "C" {
57 #endif
58 
59 /* Includes ------------------------------------------------------------------*/
60 #include "gr55xx_hal.h"
61 
62 /**
63  * @defgroup LL_CLK_MACRO Defines
64  * @{
65  */
66 
67 /* Exported constants --------------------------------------------------------*/
68 /** @defgroup CLK_Exported_Constants CLK Exported Constants
69  * @{
70  */
71 
72 /** @defgroup CLK_SOURCE Clock source select
73  * @{
74  */
75 
76 #define LL_CLK_SEL_SOURCE_CPLL_CLK (0UL) /**< Select CPLL clk as the source of the 192MHz clock */
77 #define LL_CLK_SEL_SOURCE_HF_OSC_CLK (1UL) /**< Select hf osc clk as the source of the 192MHz clock */
78 #define LL_CLK_SEL_FAST_WAKEUP_CPLL_CLK (0UL) /**< Select CPLL clk as fast wakeup clk */
79 #define LL_CLK_SEL_FAST_WAKEUP_HF_OSC_CLK (AON_CTL_AON_CLK_WAKUP_FAST_CLK_SEL_Msk) /**< Select hf osc clk as fast wakeup clk */
80 
81 /** @} */
82 
83 /** @defgroup CLK_SELECT System clock frequency select
84  * @{
85  */
86 #define LL_CLK_CPLL_S96M_CLK AON_CTL_MCU_CLK_CTRL_SEL_96M /**< Select PLL/HF_OSC 96MHz clk as system clock */
87 #define LL_CLK_CPLL_S64M_CLK AON_CTL_MCU_CLK_CTRL_SEL_64M /**< Select PLL/HF_OSC 64MHz clk as system clock */
88 #define LL_CLK_XO_S16M_CLK AON_CTL_MCU_CLK_CTRL_SEL_XO_16M /**< Select XO 16MHz clk as system clock */
89 #define LL_CLK_CPLL_F48M_CLK AON_CTL_MCU_CLK_CTRL_SEL_48M /**< Select PLL/HF_OSC 48MHz clk as system clock */
90 #define LL_CLK_CPLL_T24M_CLK AON_CTL_MCU_CLK_CTRL_SEL_24M /**< Select PLL/HF_OSC 24MHz clk as system clock */
91 #define LL_CLK_CPLL_S16M_CLK AON_CTL_MCU_CLK_CTRL_SEL_16M /**< Select PLL/HF_OSC 16MHz clk as system clock */
92 #define LL_CLK_CPLL_T32M_CLK AON_CTL_MCU_CLK_CTRL_SEL_32M /**< Select PLL/HF_OSC 32MHz clk as system clock */
93 
94 #define LL_CLK_AON_CLK_WAKUP_CLK_EN (1 << AON_CTL_AON_CLK_WAKUP_CLK_EN_Pos) /**< wakeup clock enable */
95 #define LL_CLK_AON_CLK_WAKUP_CLK_DIS 0 /**< wakeup clock disable */
96 /** @} */
97 
98 /** @defgroup XO_PLL_STATE XO PLL state
99  * @{
100  */
101 #define LL_CLK_XO_PLL_PLL_STAT (1UL) /**< XO PLL state, PLL */
102 #define LL_CLK_XO_PLL_XO_STAT (2UL) /**< XO PLL state, XO */
103 #define LL_CLK_XO_PLL_HF_STAT (4UL) /**< XO PLL state, HF */
104 /** @} */
105 
106 /** @} */
107 /** @} */
108 
109 /** @defgroup CLK_LL_DRIVER_FUNCTIONS Functions
110  * @{
111  */
112 
113 /**
114  * @brief Get system clock.
115  *
116  * Register|BitsName
117  * --------|--------
118  * MCU_CLK_CTRL | CLK_CTRL_SEL
119  *
120  * @retval None
121  *
122  */
123 __STATIC_INLINE uint32_t ll_clk_get_sys_clk(void)
124 {
125  return READ_BITS(AON_CTL->MCU_CLK_CTRL, AON_CTL_MCU_CLK_CTRL_SEL);
126 }
127 
128 /**
129  * @brief Set system clock.
130  *
131  * Register|BitsName
132  * --------|--------
133  * MCU_CLK_CTRL | CLK_CTRL_SEL
134  *
135  * @param clk_sel This parameter can be a combination of the following values:
136  * @arg @ref LL_CLK_CPLL_S96M_CLK
137  * @arg @ref LL_CLK_CPLL_S64M_CLK
138  * @arg @ref LL_CLK_XO_S16M_CLK
139  * @arg @ref LL_CLK_CPLL_F48M_CLK
140  * @arg @ref LL_CLK_CPLL_T24M_CLK
141  * @arg @ref LL_CLK_CPLL_S16M_CLK
142  * @arg @ref LL_CLK_CPLL_T32M_CLK
143  *
144  */
145 __STATIC_INLINE void ll_clk_set_sys_clk(uint32_t clk_sel)
146 {
147  MODIFY_REG(AON_CTL->MCU_CLK_CTRL, AON_CTL_MCU_CLK_CTRL_SEL, clk_sel);
148 }
149 
150 /**
151  * @brief Set slow clock.
152  *
153  * Register|BitsName
154  * --------|--------
155  * MCU_CLK_CTRL | AON_CTL_MCU_CLK_CTRL_SLOW_CLK_SEL
156  *
157  * @param clk_sel This parameter can be a combination of the following values:
158  * 0 choose 250K
159  * 1 choose 2M
160  *
161  */
162 __STATIC_INLINE void ll_clk_set_slow_clk(uint32_t clk_sel)
163 {
164  MODIFY_REG(AON_CTL->MCU_CLK_CTRL, AON_CTL_MCU_CLK_CTRL_SLOW_CLK_SEL, clk_sel << AON_CTL_MCU_CLK_CTRL_SLOW_CLK_SEL_Pos);
165 }
166 
167 /**
168  * @brief set AON_CTL_AON_CLK_WAKUP_CLK_EN bit
169  *
170  * Register|BitsName
171  * --------|--------
172  * AON_CLK | AON_CTL_AON_CLK_WAKUP_CLK_EN
173  *
174  * @param wakeup_clk_en This parameter can be a combination of the following values:
175  * @arg @ref LL_CLK_AON_CLK_WAKUP_CLK_EN
176  * @arg @ref LL_CLK_AON_CLK_WAKUP_CLK_DIS
177  *
178  */
179 __STATIC_INLINE void ll_clk_set_aon_clk_wakeup_clk_en(uint32_t wakeup_clk_en)
180 {
181  MODIFY_REG(AON_CTL->AON_CLK, AON_CTL_AON_CLK_WAKUP_CLK_EN, wakeup_clk_en);
182 }
183 /**
184  * @brief Select clock source.
185  *
186  * Register|BitsName
187  * --------|--------
188  * AON_CLK | CAL_FST_CLK
189  *
190  * @param src_sel This parameter can be a combination of the following values:
191  * @arg @ref LL_CLK_SEL_SOURCE_CPLL_CLK
192  * @arg @ref LL_CLK_SEL_SOURCE_HF_OSC_CLK
193  *
194  */
195 __STATIC_INLINE void ll_clk_select_source(uint32_t src_sel)
196 {
197  // Need twice writing to ensure success for this register
198  MODIFY_REG(AON_CTL->AON_CLK, AON_CTL_AON_CLK_CAL_FST_CLK, src_sel);
199  MODIFY_REG(AON_CTL->AON_CLK, AON_CTL_AON_CLK_CAL_FST_CLK, src_sel);
200 }
201 /**
202  * @brief Select clock source.
203  *
204  * Register|BitsName
205  * --------|--------
206  * AON_CLK | WAKUP_FAST_CLK_SEL
207  *
208  * @param src_sel This parameter can be a combination of the following values:
209  * @arg @ref LL_CLK_SEL_SOURCE_CPLL_CLK
210  * @arg @ref LL_CLK_SEL_SOURCE_HF_OSC_CLK
211  *
212  */
213 __STATIC_INLINE void ll_clk_select_fast_wakeup_source(uint32_t src_sel)
214 {
215  MODIFY_REG(AON_CTL->AON_CLK, AON_CTL_AON_CLK_WAKUP_FAST_CLK_SEL, src_sel);
216 }
217 
218 /**
219  * @brief start XO and PLL
220  *
221  * Register|BitsName
222  * --------|--------
223  * AON_PWR | XO_PLL_SET
224  *
225  * @retval void.
226  *
227  */
228 __STATIC_INLINE void ll_clk_start_xo_pll(void)
229 {
230  MODIFY_REG(AON_PWR->XO_PLL_SET, AON_PWR_XO_PLL_SET_PLL_SET_Msk | AON_PWR_XO_PLL_SET_XO_SET_Msk, AON_PWR_XO_PLL_SET_PLL_SET | AON_PWR_XO_PLL_SET_XO_SET);
231 }
232 
233 /**
234  * @brief stop XO and PLL
235  *
236  * Register|BitsName
237  * --------|--------
238  * AON_PWR | XO_PLL_CLR
239  *
240  * @retval void.
241  *
242  */
243 __STATIC_INLINE void ll_clk_stop_xo_pll(void)
244 {
245  MODIFY_REG(AON_PWR->XO_PLL_CLR, AON_PWR_XO_PLL_SET_PLL_SET_Msk | AON_PWR_XO_PLL_SET_XO_SET_Msk, AON_PWR_XO_PLL_SET_PLL_SET | AON_PWR_XO_PLL_SET_XO_SET);
246 }
247 
248 /**
249  * @brief Get XO PLL status.
250  *
251  * Register|BitsName
252  * --------|--------
253  * AON_PWR | XO_PLL_STAT
254  *
255  * @retval xo pll status value.
256  *
257  */
258 __STATIC_INLINE uint32_t ll_clk_get_hf_status(void)
259 {
260  return READ_BITS(AON_PWR->XO_PLL_STAT, AON_PWR_XO_PLL_STAT_PLL_STAT |
261  AON_PWR_XO_PLL_STAT_XO_STAT |
262  AON_PWR_XO_PLL_STAT_HF_STAT);
263 }
264 
265 /**
266  * @brief set AON_CTL_AON_PWR_SAVING_EN bit
267  *
268  * Register|BitsName
269  * --------|--------
270  * AON_PWR_SAVING | AON_CTL_AON_PWR_SAVING_EN
271  *
272  * @param en This parameter can be a combination of the following values:
273  * 1 enable pwr saving mode
274  * 0 disable pwr saving mode
275  *
276  */
277 __STATIC_INLINE void ll_clk_set_aon_pwr_saving_en(uint32_t en)
278 {
279  MODIFY_REG(AON_CTL->AON_PWR_SAVING, AON_CTL_AON_PWR_SAVING_EN, (en << AON_CTL_AON_PWR_SAVING_EN_Pos));
280 }
281 
282 /** @} */
283 
284 #ifdef __cplusplus
285 }
286 #endif
287 
288 #endif
289 
290 /** @} */
291 
292 /** @} */
293 
294 /** @} */
ll_clk_set_aon_pwr_saving_en
__STATIC_INLINE void ll_clk_set_aon_pwr_saving_en(uint32_t en)
set AON_CTL_AON_PWR_SAVING_EN bit
Definition: gr55xx_ll_clk.h:277
ll_clk_select_source
__STATIC_INLINE void ll_clk_select_source(uint32_t src_sel)
Select clock source.
Definition: gr55xx_ll_clk.h:195
ll_clk_set_sys_clk
__STATIC_INLINE void ll_clk_set_sys_clk(uint32_t clk_sel)
Set system clock.
Definition: gr55xx_ll_clk.h:145
ll_clk_select_fast_wakeup_source
__STATIC_INLINE void ll_clk_select_fast_wakeup_source(uint32_t src_sel)
Select clock source.
Definition: gr55xx_ll_clk.h:213
ll_clk_start_xo_pll
__STATIC_INLINE void ll_clk_start_xo_pll(void)
start XO and PLL
Definition: gr55xx_ll_clk.h:228
ll_clk_stop_xo_pll
__STATIC_INLINE void ll_clk_stop_xo_pll(void)
stop XO and PLL
Definition: gr55xx_ll_clk.h:243
ll_clk_set_aon_clk_wakeup_clk_en
__STATIC_INLINE void ll_clk_set_aon_clk_wakeup_clk_en(uint32_t wakeup_clk_en)
set AON_CTL_AON_CLK_WAKUP_CLK_EN bit
Definition: gr55xx_ll_clk.h:179
gr55xx_hal.h
This file contains all the functions prototypes for the HAL module driver.
ll_clk_set_slow_clk
__STATIC_INLINE void ll_clk_set_slow_clk(uint32_t clk_sel)
Set slow clock.
Definition: gr55xx_ll_clk.h:162
ll_clk_get_hf_status
__STATIC_INLINE uint32_t ll_clk_get_hf_status(void)
Get XO PLL status.
Definition: gr55xx_ll_clk.h:258
ll_clk_get_sys_clk
__STATIC_INLINE uint32_t ll_clk_get_sys_clk(void)
Get system clock.
Definition: gr55xx_ll_clk.h:123