painlessTaskOptions.h

Go to the documentation of this file.

//  The following compile options are required for painlessMesh
#define _TASK_PRIORITY      // Support for layered scheduling priority
#define _TASK_STD_FUNCTION  // Support for std::function (ESP8266 and ESP32)
                            // Required for painlessMesh lambda callbacks
#define _TASK_SELF_DESTRUCT // Scheduler-managed deletion of heap-allocated
                            // one-shot tasks. The Scheduler deletes the Task
                            // in execute(), after disable() has returned, so
                            // a task never has to delete itself from inside
                            // its own onDisable callback (which is a
                            // use-after-free: Task::disable() writes to the
                            // task object after onDisable returns). Used by
                            // scheduleAsyncClientDeletion() in
                            // connection.hpp. See issue #373.
 
// NOTE: _TASK_THREAD_SAFE is currently DISABLED due to incompatibility
// with _TASK_STD_FUNCTION in TaskScheduler v4.0.x
// 
// The thread-safe mode would prevent FreeRTOS assertion failures on ESP32,
// but TaskScheduler's implementation has bugs when trying to cast function
// pointers to std::function objects in processRequests().
//
// Workaround: Use semaphore timeout increase (mesh.hpp line 544: 10ms -> 100ms)
// See: docs/troubleshooting/SENSOR_NODE_CONNECTION_CRASH.md
//
// #ifdef ESP32
// #define _TASK_THREAD_SAFE   // DISABLED - Incompatible with _TASK_STD_FUNCTION
// #endif