Need help with TaskScheduler?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

Global Rank
#69,384
Topics of expertise
attiny
teensy
esp8266
Arduino
C++
Location
Brooklyn, NY
660 Stars 150 Forks BSD 3-Clause "New" or "Revised" License 158 Commits 4 Opened issues

Description

Cooperative multitasking for Arduino, ESPx and STM32 microcontrollers

Services available

!
?

Need anything else?

Contributors list

# 69,384
C++
attiny
teensy
Arduino
129 commits
# 174,259
Shell
TeX
attiny
teensy
4 commits
# 60,140
C++
attiny
teensy
vscode
1 commit
# 419,691
C++
attiny
teensy
Arduino
1 commit

Task Scheduler

Cooperative multitasking for Arduino, ESPx, STM32 and other microcontrollers

Version 3.3.0: 2021-05-12 Latest updates

arduino-library-badgexscode

Get expedited support or integration consultation for TaskScheduler from xs:code

xscode

OVERVIEW:

A lightweight implementation of cooperative multitasking (task scheduling). An easier alternative to preemptive programming and frameworks like FreeRTOS.

Why cooperative?

You mostly do not need to worry about pitfalls of concurrent processing (races, deadlocks, livelocks, resource sharing, etc.). The fact of cooperative processing takes care of such issues by design.

“Everybody who learns concurrency and thinks they understand it, ends up finding mysterious races they thought weren’t possible, and discovers that they didn’t actually understand it yet after all.” Herb Sutter, chair of the ISO C++ standards committee, Microsoft.

Main features: 1. Periodic task execution, with dynamic execution period in

milliseconds
(default) or
microseconds
(if explicitly enabled) – frequency of execution 2. Number of iterations (limited or infinite number of iterations) 3. Execution of tasks in predefined sequence 4. Dynamic change of task execution parameters (frequency, number of iterations, callback methods) 5. Power saving via entering IDLE sleep mode when tasks are not scheduled to run 6. Support for event-driven task invocation via Status Request object 7. Support for task IDs and Control Points for error handling and watchdog timer 8. Support for Local Task Storage pointer (allowing use of same callback code for multiple tasks) 9. Support for layered task prioritization 10. Support for
std::functions
(tested on
ESPx
and
STM32
only) 11. Overall task timeout 12. Static and dynamic callback method binding 13. CPU load / idle statistics for time critical applications 14. Scheduling options with priotity for original schedule (with and without catchup) and interval

Scheduling overhead: between

15
and
18
microseconds per scheduling pass (Arduino UNO rev 3 @
16MHz
clock, single scheduler w/o prioritization)

TaskScheduler was tested on the following platforms: * Arduino Uno R3 * Arduino Nano * Arduino Micro * ATtiny85 * ESP8266 (Node MCU v2.0) * ESP32 * Teensy (tested on Teensy 3.5) * STM32F1 (tested on Mini USB STM32F103RCBT6 ARM Cortex-M3 leaflabs Leaf maple mini module F) * MSP430 and MSP432 boards * Raspberry Pi (requires external

Arduino.h
and
millis()
implementation)

Don't just take my word for it - try it for yourself on Wokwi


TaskScheduler process diagram

Changelog is located here.

For detailed functionality overview please refer to TaskScheduler documentation in the 'extras' folder or in the Wiki page.

User Feedback:

"I've used https://github.com/arkhipenko/TaskScheduler with great success. Running LED patterns, monitoring button presses, reading data from an accelerometer, auto advancing to the next pattern, reading data from Serial. All at the same time." - here

"There are libraries that do this automatically on Arduino too, allowing you to schedule [cooperative] multitasking and sleep the uC between tasks. E.g. https://github.com/arkhipenko/TaskScheduler is really good, I've used it before. You basically queue up a list of task callbacks and a schedule in your

setup()
and then do a call to
tasks.execute()
in
loop()
, which pops off the next task that is due in a queue or sleeps otherwise. It's simple, but much more straightforward than manually using
if millis() - last > delta1... else sleep()
and not as rigid as using the timer ISRs (which really serve a different purpose)." - here

"I took the controller with me on a business trip and spend the night getting the basic code framework out. It is going to run on top of Arkhipenko’s TaskScheduler. (https://github.com/arkhipenko/TaskScheduler) This should help me isolate any issues between the different control systems while managing the different task’s timing requirements." - here

"it's really cool and useful, for whenver you want your MCU to do more than 1 task" - here

"I encourage you to use it in the Arduino environment, it allows you to save a lot of time (and code lines) wherever you need to schedule, i.e. run many tasks that should to perform at different frequencies and when we want to have the greatest control over the performance of these tasks and we want good diagnostic of errors." - here

"arkhipenko/TaskScheduler is still my choice for now, especially when I get my pull request in, so we can have that idle 1 ms sleep feature for free." - here

Check out what TaskScheduler can do:

Around the world:

  • Ninja Timer: Giant 7-Segment Display at Adafruit.com https://learn.adafruit.com/ninja-timer-giant-7-segment-display/timer-code
  • Playing with NeoPixel to create a nice #smartBulb IoT https://www.zerozone.it/linux-e-open-source/giocare-con-i-neopixel-per-realizzare-un-simpatico-smartbulb-iot/16760
  • Adding a timer to XK X6 Transmitter https://www.elvinplay.com/adding-a-timer-to-xk-x6-transmitter-en/
  • Arduino Bluetooth remote control + ultrasonic anti-collision car https://xie.infoq.cn/article/0f27dbbebcc2b99b35132b262
  • WEMOS D1 Mini로 Ad-hoc WIFI network https://m.blog.naver.com/sonyi/221330334326
  • 3 Devo - Quality 3D printing filament, now made accessible and affordable (http://3devo.eu/license-information/)

  • Houston midi clock project - TaskScheduler with microseconds resolution

    by chaffneue:

    My first arduino project. It's a multi-master midi controller with a shared clock and auto count in behaviour.

    youtube: https://www.youtube.com/watch?v=QRof550TtXo

  • Hackabot Nano by Funnyvale - Compact Plug and Play Arduino compatible robotic kit https://www.kickstarter.com/projects/hackarobot/hackabot-nano-compact-plug-and-play-arduino-robot

  • Discrete Time Systems Wiki - https://sistemas-en-tiempo-discreto.fandom.com/es/wiki/Tiempo_Real

My projects:

  • Interactive "Do Not Disturb" sign in a shape of Minecraft Sword (ESP32) (https://www.instructables.com/id/Interactive-Minecraft-Do-Not-Enter-SwordSign-ESP32/)
  • Interactive Predator Costume with Real-Time Head Tracking Plasma Cannon (Teensy, Arduino Nano) (https://www.instructables.com/id/Interactive-Predator-Costume-With-Head-Tracking-Pl/)
  • IoT APIS v2 - Autonomous IoT-enabled Automated Plant Irrigation System (ESP8266) (http://www.instructables.com/id/IoT-APIS-V2-Autonomous-IoT-enabled-Automated-Plant/)
  • APIS - Automated Plant Irrigation System (Arduino Uno) (http://www.instructables.com/id/APIS-Automated-Plant-Irrigation-System/)

  • Party Lights LEDs music visualization (Leaf Maple Mini) (https://www.instructables.com/id/Portable-Party-Lights/)

  • Arduino Nano based Hexbug Scarab Robotic Spider (Arduino Nano) (http://www.instructables.com/id/Arduino-Nano-based-Hexbug-Scarab-Robotic-Spider/)

  • Wave your hand to control OWI Robotic Arm... no strings attached (Arduino Uno and Nano) (http://www.instructables.com/id/Wave-your-hand-to-control-OWI-Robotic-Arm-no-strin/)

  • Interactive Halloween Pumpkin (Arduino Uno) (http://www.instructables.com/id/Interactive-Halloween-Pumpkin/)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.