大家好，今天分享一款轻量级的定时器调度器 -- SmartTimer，在单片机”裸跑”的情况下，可以很方便的实现异步编程。
虽然此项目是基于STM32进行开发的，但是它可以很方便的移植到其他的单片机上。
项目的 git 地址为（复制在浏览器打开）:
https://github.com/lmooml/SmartTimerSmartTimer 可以应用在对实时性要求没那么高的场合，比如说一个空气检测装置，每 200ms 收集一次甲醛数据，这个任务显然对实时性要求没那么高，如果时间上相差几毫秒，甚至几十毫秒也没关系，那么使用SmartTimer非常适合。
而如果开发一个四轴飞行器，无论是对陀螺仪数据的采集、计算，以及对 4 个电机的控制，在时间的控制上都需要非常精确。那么这种场合下 SmartTimer 无法胜任，你需要一个带有抢占优先级机制的实时系统。
不同的场景，选择不同的工具和架构才是最合理的，SmartTimer 只能做它力所能及的事情。
Runlater
在单片机编程中，想实现在 ”xxx毫秒后调用xxx函数” 的功能，一般有3种方法：
用阻塞的，非精确的方式，就是用for(i=0;i<0xffff;i++);这种循环等待的方式，来非精确的延迟一段时间，然后再顺序执行下面的程序；
利用硬件定时器实现异步的精确延时，把 XXX 函数在定时器中断里执行；
同样是利用硬件定时器，但是只在定时器中断里设置标志位，在系统的主 While 循环中检测这个标志位，当检测到标志置位后，去运行 XXX 函数。
从理论上来说，以上 3 种方式中，第 3 种采用定时器设定标志位的方法最好。因为首先主程序不用阻塞，在等待的时间里，MCU 完全可以去做其他的事情，其次 在定时器中断里不用占用太多的时间，节约中断资源。
但这种方式有个缺点，就是实现起来相对麻烦一些。因为，如果你要有 N 个runlater的需求，那么就得设置N个标志位，还要考虑定时器的分配、设定。在程序主While循环里也会遍布N个查询标志位的if语句。如果N足够多，其实大于5个，就会比较头疼。这样会使主While循环看起来很乱。这样的实现不够简洁、优雅。
SmartTimer 首先解决的就是这个问题，它可以优雅地延迟调用某函数。
Runloop
在定时器编程方面还有另一个典型需求，就是“每隔xxx毫秒运行一次XXX函数,一共运行XXX次”。这个实现起来和 runlater差不多，就是加一个运行次数的技术标志。我就不再赘述了。还是那句话：
SmartTimer 可以优雅地实现 Runloop 功能。
Delay
并不是说非阻塞就一定比阻塞好，因为在某些场景下，必须得用到阻塞，使单片机停下来等待某个事件。那么，SmartTimer也可以提供这个功能。
所谓的高级用法，并不是说 SmartTimer 有隐藏模式，能开启黑科技。而是说，如果你能转变思路，举一反三地话，可以利用 SmartTimer 提供的简单功能实现更加优化、合理的系统结构。
传统的单片机裸跑一般采用状态机模式，就是在主While循环里设定一些标志位或是设定好程序进行的步骤，根据事件的进程来跳转程序。
简单的说来，这是一种顺序执行的程序结构。其灵活性和实时性并不高，尤其是当需要处理的业务越来越多，越来越复杂时，状态机会臃肿不堪，一不留神（其实是一定以及肯定）就会深埋bug于其中，调试解决BUG时也会异常痛苦。
如果转换一下思路，不再把业务逻辑中各个模块的关系看成基于因果（顺序），而是基于时间，模块间如果需要确定次序可以采用标志位进行同步。
那么恭喜你，你已经有了采用实时系统的思想，可以尝试使用RT-thread等操作系统来完成你的项目了。
但是，使用操作系统有几个问题：
其实 利用 SmartTimer 中的 Runloop 功能可以简单的实现基于时间的主程序框架。
与源码一起提供的，还有一个 Demo 程序。这个 Demo比较简单，主要是为了测试SmartTimer的功能。Demo 程序基本可以体现 Runlater，Runloop，Delay 功能。
同时也能基本体现基于时间的编程思想（单片机裸跑程序框架）。
SmartTimer.h 中声明的公开函数并不多，总共有8个：
void stim_init ( void );
void stim_tick (void);
void stim_mainloop ( void );
int8_t stim_loop ( uint16_t delayms, void (*callback)(void), uint16_t times);
int8_t stim_runlater ( uint16_t delayms, void (*callback)(void));
void stim_delay ( uint16_t delayms);
void stim_kill_event(int8_t id);
void stim_remove_event(int8_t id);
下面将逐一介绍。
前提
SmartTimer 能够工作的必要条件是:
使用 SmartTimer
做好以上的搭建工作后，就可以开始使用SmartTimer了。
函数 stim_runlater
int8_t stim_runlater ( uint16_t delayms, void (*callback)(void))；
该函数接受两个参数，返回定时事件的id。
参数 delayms 传入延迟多长时间，注意这里的单位是根据之前 A 步骤里，你设置的时间滴答来确定的(默认单位是1ms)；第二个参数是回调函数的函数指针，目前只支持没有参数，且无返回值的回调函数，未来会考虑加入带参数和返回值的回调。
举例：
timer_runlater(100,ledflash); //100豪秒(100*1ms=100ms)后,执行void ledflash(void)函数
如果在 stim_init() 中，设置的时钟滴答为 10ms 执行一次，那么传入同样的参数，意义就会改变：
timer_runlater(100,ledflash); //1秒(100*10ms=1000ms=1S)后,执行void ledflash(void)函数
函数 stim_loop
int8_t stim_loop ( uint16_t delayms, void (*callback)(void), uint16_t times);
这个函数的参数意义同 runlater 差不多，就不详细说明了。
该函数接收 3 个参数，delayms 为延迟时间，callback 为回调函数指针，times是循环次数。举例(以1ms滴答为例)：
timer_runloop(50,ledflash,5); // 每50ms，执行一次ledflash()，总共执行5次
timer_runloop(80,ledflash, TIMER_LOOP_FOREVER); // 每80ms，执行一次ledflash(),无限循环。
函数 timer_delay
void timer_delay ( uint16_t delayms); //延迟xx ms
这个函数会阻塞主程序，并延迟一段时间。
void stim_kill_event(int8_t id);
void stim_remove_event(int8_t id);
这两个函数，可以将之前设定的定时事件取消。比如之前用stim_loop无限循环了一个事件，当获取某个指令后，需要取消这个任务，则可以用这两个函数取消事件调度。
这两个函数的区别是：
void stim_kill_event(int8_t id); //直接取消事件，忽略未处理完成的调度任务。
void stim_remove_event(int8_t id);//将已经完成计时的调度任务处理完毕之后，再取消事件
SmartTimer 可接受的 Timer event 数量是有上限的，这个上限由 smarttimer.h 中的宏定义来决定的：
#define TIMEREVENT_MAX_SIZE 20
默认为20个，你可以根据实际情况增加或减少。但不可多于 128 个。
资源获取：
（1）自己从 git 仓库拉取。
（2）公众号后台回复【2012】，获取打包好的项目文件。
觉得文章不错，点击“分享”、“赞”、“在看” 呗！
