MultiTimer

MultiTimer

Introduction

MultiTimer is a software timer extension module that allows for the expansion of timer tasks as needed, replacing the traditional flag-checking method. It offers a more elegant and convenient way to manage the timing sequences of a program.

How to Use

1. Configure the system time base interface and install the timer driver:

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

multiTimerInstall(PlatformTicksGetFunc);

1. Instantiate a timer object:

MultiTimer timer1;

1. Set the timing, timeout callback function, user data pointer, and start the timer:

int multiTimerStart(MultiTimer* timer, uint64_t timing, MultiTimerCallback_t callback, void* userData);

1. Call the timer background processing function in the main loop:

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

Limitations

1. The clock frequency of the timer directly affects its accuracy. It is recommended to use ticks with higher precision such as 1ms, 5ms, or 10ms.

2. The callback function of the timer should not perform time-consuming operations, as this may occupy too much time, causing other timers to not timeout properly.

3. Since the timer's callback function is executed within multiTimerYield, care should be taken not to use too much stack space to avoid stack overflow.

Example

The test_linux.c file serves as a demo for Linux platforms, showcasing how to use MultiTimer for creating and managing multiple timers with different intervals and behaviors.

…