0x1abin / multitimer

Software timers extend module for embedded

MultiTimer

简介

MultiTimer 是一个软件定时器扩展模块，可无限扩展你所需的定时器任务，取代传统的标志位判断方式， 更优雅更便捷地管理程序的时间触发时序。

使用方法

1. 配置系统时间基准接口，安装定时器驱动；

uint64_t PlatformTicksGetFunc(void)
{
    /* Platform implementation */
}

MultiTimerInstall(PlatformTicksGetFunc);

2. 实例化一个定时器对象；

MultiTimer timer1;

3. 设置定时时间，超时回调处理函数， 用户上下指针，启动定时器；

int MultiTimerStart(&timer1, uint64_t timing, MultiTimerCallback_t callback, void* userData);

4. 在主循环调用定时器后台处理函数

int main(int argc, char *argv[])
{
    ...
    while (1) {
        ...
        MultiTimerYield();
    }
}

功能限制

1.定时器的时钟频率直接影响定时器的精确度，尽可能采用1ms/5ms/10ms这几个精度较高的tick;

2.定时器的回调函数内不应执行耗时操作，否则可能因占用过长的时间，导致其他定时器无法正常超时；

3.由于定时器的回调函数是在 MultiTimerYield 内执行的，需要注意栈空间的使用不能过大，否则可能会导致栈溢出。

Examples

见example目录下的测试代码，main.c为普通平台测试demo，test_linux.c为linux平台的测试demo。

#include <stdio.h>
#include <sys/time.h>
#include <time.h>
#include "MultiTimer.h"

MultiTimer timer1;
MultiTimer timer2;
MultiTimer timer3;

uint64_t PlatformTicksGetFunc(void)
{
    struct timespec current_time;
    clock_gettime(CLOCK_MONOTONIC, &current_time);
    return (uint64_t)((current_time.tv_sec * 1000) + (current_time.tv_nsec / 1000000));
}

void exampleTimer1Callback(MultiTimer* timer, void *userData)
{
    printf("exampleTimer1Callback-> %s.\r\n", (char*)userData);
    MultiTimerStart(timer, 1000, exampleTimer1Callback, userData);
}

void exampleTimer2Callback(MultiTimer* timer, void *userData)
{
    printf("exampleTimer2Callback-> %s.\r\n", (char*)userData);
}

void exampleTimer3Callback(MultiTimer* timer, void *userData)
{
    printf("exampleTimer3Callback-> %s.\r\n", (char*)userData);
    MultiTimerStart(timer, 4567, exampleTimer3Callback, userData);
}

int main(int argc, char *argv[])
{
    MultiTimerInstall(PlatformTicksGetFunc);

    MultiTimerStart(&timer1, 1000, exampleTimer1Callback, "1000ms CYCLE timer");
    MultiTimerStart(&timer2, 5000, exampleTimer2Callback, "5000ms ONCE timer");
    MultiTimerStart(&timer3, 3456, exampleTimer3Callback, "3456ms delay start, 4567ms CYCLE timer");

    while (1) {
        MultiTimerYield();
    }
}

multitimer's Issues

PlatformTicksGetFunc() 系统时间溢出怎么处理

用的8位机不支持uint64_t,只支持uint32_t,用的ms定时器累加计时tick
uint32_t tick;
void Timer0_IRQHandler(void) interrupt TMR0_VECTOR
{
tick++;
TH0 =(65536-4000)>>8 ;
TL0 = 65536-4000;
}
请问tick溢出时,PlatformTicksGetFunc中需要做何种处理,
还是说我只需要将tick置0

提点需求，希望能完善该项目

1. 支持其他线程在我这个定时器里创建任务
2. 支持定时任务的循环执行，每隔一个timeout就执行一次
3. 支持在定时器任务回调里创建新的定时器任务

如果作者允许的话，我可以为该工程实现以上需求，谢谢！

platformTicksFunction 指针未做判空处理

BUG

main.c没上传吗？

如题，没看到main.c文件

不用的定时器资源无法回收

目前是使用静态分配的方式，一个timer在被stop之后，是不会释放ram的。
是否可以考虑使用动态分配方式？

超时溢出有问题

_timer_ticks 是一个无符号数， 假如是一个无符号8位，当_timer_ticks为254，我超时为2m, target->timeout此时为0吧，这时候判断感觉出现问题了，会立马导致超时事件发生

MultiTimer

为什么重复执行的定时器不在MultiTimerYield执行重新启动，在回调函数容易漏掉

为什么重复执行的定时器不在MultiTimerYield执行重新启动，在回调函数容易漏掉
增加排序功能很好，但是去掉了重复执行功能啊，单片机又很多都是要重复执行的定时器
增加可重复执行功能
struct MultiTimerHandle {
MultiTimer* next;
uint64_t deadline;
MultiTimerCallback_t callback;
void* userData;
uint64_t interval; //记录间隔
uint8_t repeat; //重复执行标记
};
//根据repeat标志重新启动定时器
if (entry->repeat) {
MultiTimerStart(entry, entry->interval, entry->callback, entry->userData, entry->repeat)
}

会消耗100%的cpu

timer_tick是否考虑添加形参，由外部指定tick 频率

timer_ticks(const uint32_t out_tick)

如何解决带参函数的定时

这个软定时器个人觉得很不错啊，但是带参函数的定时似乎没法做到，有办法解决吗