arduino / Arduino

Arduino IDE 1.x
https://www.arduino.cc/en/software
Other
14.16k stars 7.01k forks source link

[Library Manager] Please add SAMDUE_TimerInterrupt Library #10934

Closed khoih-prog closed 3 years ago

khoih-prog commented 3 years ago

Please add SAMDUE_TimerInterrupt library to Library Manager. Thanks and Regards.


Features

This library enables you to use Interrupt from Hardware Timers on an SAM-DUE-based board.

As Hardware Timers are rare, and very precious assets of any board, this library now enables you to use up to 16 ISR-based Timers, while consuming only 1 Hardware Timer. Timers' interval is very long (ulong millisecs).

Why do we need this Hardware Timer Interrupt?

Imagine you have a system with a mission-critical function, measuring water level and control the sump pump or doing something much more important. You normally use a software timer to poll, or even place the function in loop(). But what if another function is blocking the loop() or setup().

So your function might not be executed on-time or not at all, and the result would be disastrous.

You'd prefer to have your function called, no matter what happening with other functions (busy loop, bug, etc.).

The correct choice is to use a Hardware Timer with Interrupt to call your function.

These hardware timers, using interrupt, still work even if other functions are blocking. Moreover, they are much more precise (certainly depending on clock frequency accuracy) than other software timers using millis() or micros(). That's necessary if you need to measure some data requiring better accuracy.

Functions using normal software timers, relying on loop() and calling millis(), won't work if the loop() or setup() is blocked by certain operation. For example, certain function is blocking while it's connecting to WiFi or some services.



Releases v1.0.1

  1. Permit up to 16 super-long-time, super-accurate ISR-based timers to avoid being blocked
  2. Using cpp code besides Impl.h code to use if Multiple-Definition linker error3.
  3. Add complicated example ISR_16_Timers_Array utilizing and demonstrating the full usage of 16 independent ISR Timers based on just 1 Hardware Timer.

Supported Boards

cmaglie commented 3 years ago

Done.