waitForCondition()

template<typename Condition>

bool fl::IChannelDriver::waitForCondition ( Condition condition, u32 timeoutMs = 1000 )

protected

Definition at line 13 of file driver.cpp.hpp.

                                                                                     {
    const u32 startTime = timeoutMs > 0 ? millis() : 0;
 
    // Tier 1: instant non-blocking check.
    if (condition()) {
        return true;
    }
 
    // Tier 2: bounded microsecond spin (#2818). Catches short DMA tails
    // without paying the >=1-tick floor below. Budget runtime-tunable via
    // FastLED.setWaitSpinBudgetUs(N); 0 disables.
    {
        const u32 spinBudget = fl::detail::getWaitSpinBudgetUs();
        if (spinBudget > 0) {
            const u32 spinStart = fl::micros();
            while ((fl::micros() - spinStart) < spinBudget) {
                if (condition()) {
                    return true;
                }
                if (timeoutMs > 0 && (millis() - startTime) >= timeoutMs) {
                    FL_ERROR("Timeout occurred while waiting for condition");
                    return false;
                }
            }
        }
    }
 
    while (!condition()) {
        // Check timeout if specified
        if (timeoutMs > 0 && (millis() - startTime >= timeoutMs)) {
            FL_ERROR("Timeout occurred while waiting for condition");
            return false;  // Timeout occurred
        }
 
        // Adaptive yield (refs #2815, generalizes the #2493 ESP32-P4 carve-out):
        // see the matching comment in ChannelManager::waitForCondition for the
        // full rationale. The deep yield is only needed when a radio is
        // actually up; otherwise the FreeRTOS tick floor is pure timing drift.
        if (fl::NetworkDetector::isAnyNetworkActive()) {
            // Radio active: keep WiFi/lwIP/BT alive with the deep yield.
            task::yield_system(250);
        } else {
            // No radio: fast yield, no FreeRTOS tick floor.
            task::yield_system(0);
        }
    }
 
    return true;  // Condition met
}

References FL_ERROR, fl::FL_NO_EXCEPT, fl::detail::getWaitSpinBudgetUs(), fl::net::NetworkDetector::isAnyNetworkActive(), fl::micros(), fl::millis(), and fl::task::yield_system().

Referenced by operator=(), waitForReady(), and waitForReadyOrDraining().

Here is the call graph for this function:

Here is the caller graph for this function: