blob: 0e37fbc87d508a8645657a6d117d0b279ee6df1e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
/* SPDX-License-Identifier: BSD-3-Clause */
/*
* Copyright (c) 2020-2021 Rockchip Electronics Co., Ltd.
*/
#include "hal_base.h"
#ifdef HAL_SYSTICK_MODULE_ENABLED
/** @addtogroup RK_HAL_Driver
* @{
*/
/** @addtogroup SYSTICK
* @{
*/
/** @defgroup SYSTICK_How_To_Use How To Use
* @{
The SYSTICK driver can be used as follows:
Reset SysTick in default setting:
- Resgister HAL_SYSTICK_IRQHandler();
- Reset HAL_BASE tick frequency value by calling HAL_SetTickFreq() if needed;
- Reset SysTick by calling HAL_SYSTICK_Init().
Reset SysTick by user:
- Resgister HAL_SYSTICK_IRQHandler();
- Choose SysTick clock source by calling HAL_SYSTICK_CLKSourceConfig();
- Config SysTick reload value by calling HAL_SYSTICK_Config();
- Configure the SysTick frequency by calling by calling HAL_SetTickFreq().
Reinit SysTick when system core clock and clock source is changed;
- Reset core rate by calling CRU module interface;
- Update HAL global variable systemCoreClock by calling HAL_UpdateWithNewCoreRate();
- Change SysTick clock source by calling HAL_SYSTICK_CLKSourceConfig();
- Update SysTick reloader num in default frequency by calling
HAL_SYSTICK_Config(rate / (1000 / HAL_GetTickFreq())).
@} */
/** @defgroup SYSTICK_Private_Definition Private Definition
* @{
*/
/********************* Private MACRO Definition ******************************/
#define SYSTICK_INT_PRIORITY 0x0FU
/********************* Private Structure Definition **************************/
/********************* Private Variable Definition ***************************/
/********************* Private Function Definition ***************************/
/** @} */
/********************* Public Function Definition ****************************/
/** @defgroup SYSTICK_Exported_Functions_Group4 Init and DeInit Functions
* @{
*/
/**
* @brief Init SysTick and enable SysTick.
* @return HAL_Status: HAL_OK.
* Reset SysTick to default setting.
*/
HAL_Status HAL_SYSTICK_Init(void)
{
uint32_t ret, rate = SystemCoreClock;
ret = HAL_SYSTICK_CLKSourceConfig(HAL_SYSTICK_CLKSRC_EXT); /* Choose external clock source */
if (ret == HAL_OK) {
rate = PLL_INPUT_OSC_RATE;
}
HAL_SYSTICK_Config(rate / (1000 / HAL_GetTickFreq())); /* Configure the SysTick to have interrupt in TickFreq time basis */
/*Configure the SysTick IRQ priority */
#ifdef HAL_NVIC_MODULE_ENABLED
HAL_NVIC_SetPriority(SysTick_IRQn, SYSTICK_INT_PRIORITY, 0);
#endif
HAL_SYSTICK_Enable();
return HAL_OK;
}
/** @} */
/** @defgroup SYSTICK_Exported_Functions_Group5 Other Functions
* @{
*/
/**
* @brief Config SysTick reload value.
* @param ticksNumb: SysTick reload value.
* @return HAL_Status.
*/
HAL_Status HAL_SYSTICK_Config(uint32_t ticksNumb)
{
if ((ticksNumb - 1UL) > SysTick_LOAD_RELOAD_Msk) {
return HAL_INVAL; /* Reload value impossible */
}
SysTick->LOAD = (uint32_t)(ticksNumb - 1UL); /* set reload register */
NVIC_SetPriority(SysTick_IRQn, (1UL << __NVIC_PRIO_BITS) - 1UL); /* set Priority for SysTick Interrupt */
SysTick->VAL = 0UL; /* Load the SysTick Counter Value */
return HAL_OK;
}
/**
* @brief Config clock source type for SysTick.
* @param clkSource: HAL_SYSTICK_CLKSRC_CORE clock source is from core clk,
* HAL_SYSTICK_CLKSRC_EXT clock source is from external reference
* @return HAL_OK if successful, HAL_INVAL if soc not support.
*/
HAL_Status HAL_SYSTICK_CLKSourceConfig(eHAL_systickClkSource clkSource)
{
if (clkSource == HAL_SYSTICK_CLKSRC_CORE) {
SysTick->CTRL |= SysTick_CTRL_CLKSOURCE_Msk;
} else {
if (SysTick->CALIB & SysTick_CALIB_NOREF_Msk) {
return HAL_INVAL;
} else {
SysTick->CTRL &= ~SysTick_CTRL_CLKSOURCE_Msk;
}
}
return HAL_OK;
}
/**
* @brief System Tick, Is the externalreferance clock enabled as a source clock.
* @return HAL_TRUE if external referance clock is enabled
*/
HAL_Check HAL_SYSTICK_IsExtRefClockEnabled(void)
{
if (SysTick->CTRL & SysTick_CTRL_CLKSOURCE_Msk) {
return HAL_FALSE;
} else {
HAL_ASSERT(!(SysTick->CALIB & SysTick_CALIB_NOREF_Msk));
return HAL_TRUE;
}
}
/**
* @brief Core internal SysTick IRQ handler
* Count plus 1.
*/
__WEAK void HAL_SYSTICK_IRQHandler(void)
{
HAL_IncTick();
}
/**
* @brief Enable SysTick.
* @return HAL_Status.
*/
HAL_Status HAL_SYSTICK_Enable(void)
{
SysTick->CTRL |= (SysTick_CTRL_TICKINT_Msk |
SysTick_CTRL_ENABLE_Msk); /* Enable SysTick IRQ and SysTick Timer */
return HAL_OK;
}
/** @} */
/** @} */
/** @} */
#endif /* HAL_SYSTICK_MODULE_ENABLED */
|
