-
Notifications
You must be signed in to change notification settings - Fork 13
/
Copy pathctimer.h
139 lines (104 loc) · 7.3 KB
/
ctimer.h
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
/*
* Copyright (c) 2022-2023, smartmx - [email protected]
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* This file is part of the tiny-macro-os Library.
* <https://github.com/smartmx/tiny-macro-os>
*
*/
#ifndef _CTIMER_H_
#define _CTIMER_H_
#include "tiny-macro-os.h"
/* 如果准备使用ctimer，需要在tiny-macro-os.h中的任务枚举中添加os_ctimer，并在主任务循环中，调用OS_RUN_TASK(os_ctimer)。 */
/* 用于用户自己更改全局变量名称，方便一个程序包含多个tiny macro os进行调度 */
#define TASK_CTIMERS os_task_ctimers
/* 准备使用几个ctimer就在这里加上枚举 */
enum
{
ctimer_test1 = 0,
ctimer_test2,
CTIMER_MAX_NUM,
};
#define CTIMER_SEC_TICK 100 /* ctimer任务1秒钟的ticks数量 */
#define CTIMER_PERIOD_TICKS (OS_SEC_TICKS / CTIMER_SEC_TICK) /* ctimer更新自身时间的周期 */
/* callback timer */
typedef struct _ctimer_struct
{
TINY_MACRO_OS_TIME_t (*f)(TINY_MACRO_OS_LINE_t *, void *);
void *ptr;
TINY_MACRO_OS_TIME_t ticks;
TINY_MACRO_OS_LINE_t line;
} ctimer_t;
extern ctimer_t TASK_CTIMERS[CTIMER_MAX_NUM];
/* 初始化ctimer参数 */
#define OS_CTIMER_INIT(NAME, FUNC, TICKS, PTR) do{TASK_CTIMERS[NAME].f=(FUNC);TASK_CTIMERS[NAME].ptr=(PTR);TASK_CTIMERS[NAME].ticks=TICKS;TASK_CTIMERS[NAME].line=0;}while(0)
/* ctimer任务定义，和OS_TASK不同，必须不可和枚举变量名称一样 */
#define OS_CTIMER_TASK(FUNC) TINY_MACRO_OS_TIME_t (FUNC)(TINY_MACRO_OS_LINE_t *lc, void *p)
/* 函数任务系统调度开始定义 */
#define OS_CTIMER_TASK_START() switch(*lc){default:
/* 函数任务系统调度结束定义 */
#define OS_CTIMER_TASK_END() break;}(*lc)=0;return (TINY_MACRO_OS_TIME_MAX)
/* 函数任务系统调度重新开始定义 */
#define OS_CTIMER_TASK_RESTART() do{(*lc)=0;return 0;}while(0)
/* 退出当前任务，并等待对应时间，保存当前运行位置，时间单位CTIMER_PERIOD_TICKS。 */
#define OS_CTIMER_TASK_WAITX(TICKS) do{(*lc)=(((TINY_MACRO_OS_LINE_t)(__LINE__)%(TINY_MACRO_OS_LINE_MAX))+1U);return(TICKS);case (((TINY_MACRO_OS_LINE_t)(__LINE__)%(TINY_MACRO_OS_LINE_MAX))+1U):;}while(0)
/* 跳出当前任务，保存当前运行位置，等下一次执行时继续运行 */
#define OS_CTIMER_TASK_YIELD() OS_CTIMER_TASK_WAITX(0)
/* 设置函数状态 */
#define OS_CTIMER_TASK_SET_STATE() do{(*lc)=(((TINY_MACRO_OS_LINE_t)(__LINE__)%(TINY_MACRO_OS_LINE_MAX))+1U);case (((TINY_MACRO_OS_LINE_t)(__LINE__)%(TINY_MACRO_OS_LINE_MAX))+1U):;}while(0)
/* 等待时间，不改变上一次函数跳转位置 */
#define OS_CTIMER_TASK_CWAITX(TICKS) return (TICKS)
/* 挂起当前任务 */
#define OS_CTIMER_TASK_SUSPEND() OS_CTIMER_TASK_WAITX(TINY_MACRO_OS_TIME_MAX)
/* 复位当前任务，在指定时间后开始下一次运行，并从头开始 */
#define OS_CTIMER_TASK_RESET(TICKS) do{(*lc)=0;return (TICKS);}while(0)
/* 等待条件 C 满足再继续向下执行，查询频率为每ticks个时钟一次 */
#define OS_CTIMER_TASK_WAIT_UNTIL(C, TICKS) do{OS_CTIMER_TASK_WAITX(TICKS); if(!(C)) return (TICKS);} while(0)
/* 等待条件 C 满足再继续向下执行，查询频率为每ticks个时钟一次，带有超时次数，需要用户自己提供一个变量进行超时计算，不可为局部变量，必须为全局变量或者函数内静态变量 */
#define OS_CTIMER_TASK_WAIT_UNTILX(C, TICKS, TIMES, VAR) do{(VAR)=(TIMES);OS_CTIMER_TASK_WAITX((TICKS));if(!(C)&&((VAR)>0)){(VAR)--;return (TICKS);}} while(0)
/* 判断任务是否在运行 */
#define OS_CTIMER_TASK_IS_RUNNING(NAME) (TASK_CTIMERS[NAME].ticks!=TINY_MACRO_OS_TIME_MAX)
/* 判断任务是否已经退出 */
#define OS_CTIMER_TASK_IS_EXITED(NAME) (TASK_CTIMERS[NAME].ticks==TINY_MACRO_OS_TIME_MAX)
/*************************************信号量*******************************************/
/* 等待信号量，查询频率为每ticks个时钟一次 */
#define OS_CTIMER_WAIT_SEM(SEM, TICKS) do{(SEM)=1;OS_CTIMER_TASK_WAITX(TICKS);if((SEM)>0){return (TICKS);}}while(0)
/* 等待信号量，并有超时次数，查询频率为每ticks个时钟一次，超时时间为ticks*TIMES，所以ticks最好不要为0 */
#define OS_CTIMER_WAIT_SEMX(SEM, TICKS, TIMES) do{(SEM)=(TIMES)+1;OS_CTIMER_TASK_WAITX(TICKS); if((SEM)>1){(SEM)--;return (TICKS);}else{if((SEM)!=0){(SEM)=(OS_SEM_TIMEOUT);}}}while(0)
/*************************************以下函数只可以在其他任务函数中调用，不可以在自身函数中调用*******************************/
/* 挂起另一个指定任务，不可挂起自身 */
#define OS_CTIMER_TASK_SUSPEND_ANOTHER(ANAME) do{TASK_CTIMERS[(ANAME)].ticks=(TINY_MACRO_OS_TIME_MAX);}while(0)
/* 复位另一个任务，在下次运行时从头开始，可以和OS_CTIMER_TASK_CALL_ANOTHER配合使用来立刻重新开始运行另一个任务 */
#define OS_CTIMER_TASK_RESET_ANOTHER(ANAME) do{TASK_CTIMERS[(ANAME)].line=0;}while(0)
/* 在指定时间后重新启动另一个已经停止运行的任务*/
#define OS_CTIMER_TASK_RESTART_ANOTHER(ANAME, TICKS) do{if(TASK_CTIMERS[(ANAME)].ticks==(TINY_MACRO_OS_TIME_MAX)){TASK_CTIMERS[(ANAME)].ticks=(TICKS);}}while(0)
/* 更新另一个任务的时间，以便突发事件运行任务 */
#define OS_CTIMER_TASK_UPDATE_ANOTHER(ANAME, TICKS) do{TASK_CTIMERS[(ANAME)].ticks=(TICKS);}while(0)
/* 停止并且再不运行运行另一个任务，复位任务状态，下一次运行从头开始。 */
#define OS_CTIMER_TASK_EXIT_ANOTHER(ANAME) do{TASK_CTIMERS[(ANAME)].line=0U;TASK_CTIMERS[(ANAME)].ticks=(TINY_MACRO_OS_TIME_MAX);}while(0)
/* 运行任务，不管任务时间状态立刻调用任务函数运行。 */
#define OS_CTIMER_TASK_CALL_ANOTHER(ANAME) do{TASK_CTIMERS[ANAME].ticks=TASK_CTIMERS[ANAME].f(&TASK_CTIMERS[ANAME].line,TASK_CTIMERS[ANAME].ptr);}while(0)
/*在主任务中需要循环添加的任务*/
#if COMPILER_SUPPORT_VA_ARGS
extern OS_TASK(os_ctimer, void);
#else
extern OS_TASK(os_ctimer);
#endif
#endif /* _CTIMER_H_ */