yield_system()

void fl::task::yield_system

(

fl::u32

microseconds

)

OS-level yield only: same behavior as run(us, ExecFlags::SYSTEM).

Prefer this in driver/DMA wait loops. run() dispatches on its flags at runtime, so even a SYSTEM-only call links the task Scheduler and Executor into every sketch; this entry point references neither (#4797). microseconds > 0 deep-yields (>= 1 FreeRTOS tick on ESP32) until the budget is spent; 0 is a single lightweight fl::yield().

Definition at line 172 of file executor.cpp.hpp.

                                                   {
    // Mirrors the SYSTEM branch of run() without naming Scheduler/Executor.
    const fl::u32 begin_time = fl::micros();
    do {
        if (microseconds > 0) {
            const fl::u32 e = fl::micros() - begin_time;
            if (e < microseconds) {
                fl::platforms::ICoroutineRuntime::instance().pumpCoroutines(
                    fl::min(1000u, microseconds - e));
            }
        } else {
            fl::yield();
        }
    } while (fl::micros() - begin_time < microseconds);
}

References fl::FL_NO_EXCEPT, fl::micros(), fl::min(), and fl::yield().

Referenced by throttleToMaxRefreshRate(), fl::ChannelManager::waitForCondition(), and fl::IChannelDriver::waitForCondition().

Here is the call graph for this function:

Here is the caller graph for this function: