• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 软件定时器
2
3## 基本概念
4
5软件定时器，是基于系统Tick时钟中断且由软件来模拟的定时器，当经过设定的Tick时钟计数值后会触发用户定义的回调函数。定时精度与系统Tick时钟的周期有关。
6
7硬件定时器受硬件的限制，数量上不足以满足用户的实际需求，因此为了满足用户需求，提供更多的定时器，OpenHarmony LiteOS-A内核提供软件定时器功能。
8
9软件定时器扩展了定时器的数量，允许创建更多的定时业务。
10
11**软件定时器支持以下功能：**
12
13- 静态裁剪：能通过宏关闭软件定时器功能。
14
15- 软件定时器创建。
16
17- 软件定时器启动。
18
19- 软件定时器停止。
20
21- 软件定时器删除。
22
23- 软件定时器剩余Tick数获取。
24
25## 运行机制
26
27软件定时器是系统资源，在模块初始化的时候已经分配了一块连续的内存，系统支持的最大定时器个数由los_config.h中的LOSCFG_BASE_CORE_SWTMR_LIMIT宏配置。
28
29软件定时器使用了系统的一个队列和一个任务资源，软件定时器的触发遵循队列规则，先进先出。同一时刻设置的定时时间短的定时器总是比定时时间长的靠近队列头，满足优先被触发的准则。
30
31软件定时器以Tick为基本计时单位，当用户创建并启动一个软件定时器时，OpenHarmony系统会根据当前系统Tick时间及用户设置的定时间隔确定该定时器的到期Tick时间，并将该定时器控制结构挂入计时全局链表。
32
33当Tick中断到来时，在Tick中断处理函数中扫描软件定时器的计时全局链表，看是否有定时器超时，若有则将超时的定时器记录下来。
34
35Tick中断处理函数结束后，软件定时器任务（优先级为最高）被唤醒，在该任务中调用之前记录下来的定时器的超时回调函数。
36
37**定时器状态：**
38
39- OS_SWTMR_STATUS_UNUSED（未使用）
40  系统在定时器模块初始化的时候将系统中所有定时器资源初始化成该状态。
41
42- OS_SWTMR_STATUS_CREATED（创建未启动/停止）
43  在未使用状态下调用LOS_SwtmrCreate接口或者启动后调用LOS_SwtmrStop接口后，定时器将变成该状态。
44
45- OS_SWTMR_STATUS_TICKING（计数）
46  在定时器创建后调用LOS_SwtmrStart接口，定时器将变成该状态，表示定时器运行时的状态。
47
48**定时器模式：**
49
50- 第一类是单次触发定时器，这类定时器在启动后只会触发一次定时器事件，然后定时器自动删除。
51
52- 第二类是周期触发定时器，这类定时器会周期性的触发定时器事件，直到用户手动停止定时器，否则将永远持续执行下去。
53
54- 第三类也是单次触发定时器，但与第一类不同之处在于这类定时器超时后不会自动删除，需要调用定时器删除接口删除定时器。
55
56## 开发指导
57
58### 接口说明
59
60OpenHarmony LiteOS-A内核的软件定时器模块提供以下几种功能。
61
62  **表1** 软件定时器接口说明
63
64| 功能分类               | 接口描述                                                     |
65| ---------------------- | ------------------------------------------------------------ |
66| 创建、删除定时器。       | LOS_SwtmrCreate：创建软件定时器。<br/>LOS_SwtmrDelete：删除软件定时器。 |
67| 启动、停止定时器。       | LOS_SwtmrStart：启动软件定时器。<br/>LOS_SwtmrStop：停止软件定时器。 |
68| 获得软件定时剩余Tick数。 | LOS_SwtmrTimeGet：获得软件定时器剩余Tick数。                   |
69
70### 开发流程
71
72**软件定时器的典型开发流程：**
73
741. 配置软件定时器。
75   - 确认配置项LOSCFG_BASE_CORE_SWTMR和LOSCFG_BASE_IPC_QUEUE为打开状态；
76   - 配置LOSCFG_BASE_CORE_SWTMR_LIMIT最大支持的软件定时器数；
77   - 配置OS_SWTMR_HANDLE_QUEUE_SIZE软件定时器队列最大长度；
78
792. 创建定时器LOS_SwtmrCreate。
80   - 创建一个指定计时时长、指定超时处理函数、指定触发模式的软件定时器；
81   - 返回函数运行结果，成功或失败；
82
833. 启动定时器LOS_SwtmrStart。
84
854. 获得软件定时器剩余Tick数LOS_SwtmrTimeGet。
86
875. 停止定时器LOS_SwtmrStop。
88
896. 删除定时器LOS_SwtmrDelete。
90
91> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
92>
93> - 软件定时器的回调函数中不要做过多操作，不要使用可能引起任务挂起或者阻塞的接口或操作。
94>
95> - 软件定时器使用了系统的一个队列和一个任务资源，软件定时器任务的优先级设定为0，且不允许修改 。
96>
97> - 系统可配置的软件定时器资源个数是指：整个系统可使用的软件定时器资源总个数，而并非是用户可使用的软件定时器资源个数。例如：系统软件定时器多占用一个软件定时器资源数，那么用户能使用的软件定时器资源就会减少一个。
98>
99> - 创建单次软件定时器，该定时器超时执行完回调函数后，系统会自动删除该软件定时器，并回收资源。
100>
101> - 创建单次不自删除属性的定时器，用户需要调用定时器删除接口删除定时器，回收定时器资源，避免资源泄露。
102
103### 编程实例
104
105**前置条件**
106
107- 在los_config.h中，将LOSCFG_BASE_CORE_SWTMR配置项打开。
108
109- 配置好LOSCFG_BASE_CORE_SWTMR_LIMIT最大支持的软件定时器数。
110
111- 配置好OS_SWTMR_HANDLE_QUEUE_SIZE软件定时器队列最大长度。
112
113**编程示例**
114
115```
116#include "los_swtmr.h"
117
118void Timer1_Callback(uint32_t arg);
119void Timer2_Callback(uint32_t arg);
120
121UINT32 g_timercount1 = 0;
122UINT32 g_timercount2 = 0;
123
124void Timer1_Callback(uint32_t arg) // 回调函数1。
125{
126    unsigned long tick_last1;
127    g_timercount1++;
128    tick_last1=(UINT32)LOS_TickCountGet(); // 获取当前Tick数。
129    PRINTK("g_timercount1=%d\n",g_timercount1);
130    PRINTK("tick_last1=%d\n",tick_last1);
131}
132
133void Timer2_Callback(uint32_t arg) // 回调函数2。
134{
135    unsigned long tick_last2;
136    tick_last2=(UINT32)LOS_TickCountGet();
137    g_timercount2 ++;
138    PRINTK("g_timercount2=%d\n",g_timercount2);
139    PRINTK("tick_last2=%d\n",tick_last2);
140}
141
142void Timer_example(void)
143{
144    UINT16 id1;
145    UINT16 id2; // timer id.
146    UINT32 uwTick;
147
148    /* 创建单次软件定时器，Tick数为1000，启动到1000Tick数时执行回调函数1 */
149    LOS_SwtmrCreate (1000, LOS_SWTMR_MODE_ONCE, Timer1_Callback, &id1, 1);
150
151    /* 创建周期性软件定时器，每100Tick数执行回调函数2 */
152    LOS_SwtmrCreate(100, LOS_SWTMR_MODE_PERIOD, Timer2_Callback, &id2, 1);
153    PRINTK("create Timer1 success\n");
154
155    LOS_SwtmrStart (id1); //启动单次软件定时器。
156    dprintf("start Timer1 success\n");
157    LOS_TaskDelay(200); // 延时200Tick数。
158    LOS_SwtmrTimeGet(id1, &uwTick); // 获得单次软件定时器剩余Tick数。
159    PRINTK("uwTick =%d\n", uwTick);
160
161    LOS_SwtmrStop(id1); // 停止软件定时器。
162    PRINTK("stop Timer1 success\n");
163
164    LOS_SwtmrStart(id1);
165    LOS_TaskDelay(1000);
166    LOS_SwtmrDelete(id1); // 删除软件定时器。
167    PRINTK("delete Timer1 success\n");
168
169    LOS_SwtmrStart(id2); // 启动周期性软件定时器。
170    PRINTK("start Timer2\n");
171
172    LOS_TaskDelay(1000);
173    LOS_SwtmrStop(id2);
174    LOS_SwtmrDelete(id2);
175}
176```
177
178**运行结果**
179
180```
181create Timer1 success
182start Timer1 success
183uwTick =800
184stop Timer1 success
185g_timercount1=1
186tick_last1=1201
187delete Timer1 success
188start Timer2
189g_timercount2 =1
190tick_last1=1301
191g_timercount2 =2
192tick_last1=1401
193g_timercount2 =3
194tick_last1=1501
195g_timercount2 =4
196tick_last1=1601
197g_timercount2 =5
198tick_last1=1701
199g_timercount2 =6
200tick_last1=1801
201g_timercount2 =7
202tick_last1=1901
203g_timercount2 =8
204tick_last1=2001
205g_timercount2 =9
206tick_last1=2101
207g_timercount2 =10
208tick_last1=2201
209```