maybeRegisterStubAutorun()

void autoresearch::maybeRegisterStubAutorun ( AutoResearchRemoteControl & , fl::shared_ptr< AutoResearchState > state )

inline

On FL_IS_STUB: register a one-shot async task that drives autoresearch.

On the stub (native/host) platform, this registers an async task that:

1. Discovers available drivers
2. Tests each driver with autoResearchChipsetTiming()
3. Collects results and exits 0 (all passed) or 1 (failure/no tests)

On all other platforms (ESP32, etc.), this is a no-op.

Parameters

remote	Reference to RemoteControl singleton (unused on non-stub)
state	Shared autoresearch state (contains driver list, pins, RX channel)

Definition at line 62 of file AutoResearchAsync.h.

                                               {
#ifdef FL_IS_STUB
    // Register a task that runs on the next async_run() cycle (during loop()).
    fl::task::every_ms(0, FL_TRACE).then([state]() {
        if (!state || state->drivers_available.empty()) {
            FL_ERROR("[STUB CLIENT] No drivers discovered — autoresearch cannot run");
            exit(1);
        }
 
        FL_PRINT("\n[STUB CLIENT] ============================================");
        FL_PRINT("[STUB CLIENT] Simulated host client — running autoresearch");
        FL_PRINT("[STUB CLIENT] Drivers: " << state->drivers_available.size());
        FL_PRINT("[STUB CLIENT] ============================================");
 
        // WS2812B-V5 timing (same as the Python client default)
        fl::NamedTimingConfig timing_cfg(
            fl::makeTimingConfig<fl::TIMING_WS2812B_V5>(), "WS2812B-V5");
 
        // Static LED storage — span must remain valid for the entire call
        CRGB* stub_leds = stubAutorunLedState().leds;
        const int num_leds = 10;
 
        // ChannelConfig stores timing by value internally, so passing a local ref is fine
        fl::ChannelConfig stub_tx_cfg(
            state->pin_tx,
            timing_cfg.timing,
            fl::span<CRGB>(stub_leds, num_leds),
            RGB);
 
        int grand_total = 0, grand_passed = 0;
 
        for (fl::size di = 0; di < state->drivers_available.size(); di++) {
            const auto& drv = state->drivers_available[di];
 
            // BIT_BANG is the cycle-counted GPIO fallback. On the stub/host
            // platform there is no actual GPIO toggling, so its TX output
            // can't be captured by the loopback RX path the stub uses for
            // self-verification. Skip it in the stub autorun (#2469) — it's
            // still available for explicit selection by name on real hardware.
            if (drv.name == "BIT_BANG") {
                FL_PRINT("\n[STUB CLIENT] Driver: " << drv.name.c_str() << "  (skipped — no loopback in host stub)");
                continue;
            }
 
            FL_PRINT("\n[STUB CLIENT] Driver: " << drv.name.c_str());
 
            if (!autoResearchSetExclusiveDriverByName(drv.name.c_str())) {
                FL_ERROR("[STUB CLIENT] Failed to activate driver: " << drv.name.c_str());
                grand_total++;  // count as a failure
                continue;
            }
 
            // AutoResearchConfig holds timing by reference — timing_cfg is in scope
            fl::AutoResearchConfig vcfg(
                timing_cfg.timing,
                timing_cfg.name,
                fl::span<fl::ChannelConfig>(&stub_tx_cfg, 1),
                drv.name.c_str(),
                state->rx_channel,
                state->rx_buffer,
                num_leds,
                fl::RxDeviceType::RMT);
 
            int driver_total = 0, driver_passed = 0;
            uint32_t driver_duration_ms = 0;
            autoResearchChipsetTiming(vcfg, driver_total, driver_passed, driver_duration_ms);
 
            FL_PRINT("[STUB CLIENT] " << drv.name.c_str()
                     << ": " << driver_passed << "/" << driver_total << " passed");
 
            grand_total  += driver_total;
            grand_passed += driver_passed;
        }
 
        FL_PRINT("\n[STUB CLIENT] ============================================");
        FL_PRINT("[STUB CLIENT] TOTAL: " << grand_passed << "/" << grand_total);
 
        if (grand_total == 0) {
            FL_ERROR("[STUB CLIENT] No tests ran — exiting 1");
            exit(1);
        } else if (grand_passed == grand_total) {
            FL_PRINT("[STUB CLIENT] ALL TESTS PASSED ✓ — exiting 0");
            exit(0);
        } else {
            FL_ERROR("[STUB CLIENT] " << (grand_total - grand_passed)
                     << " TESTS FAILED — exiting 1");
            exit(1);
        }
    });
#endif
}

References autoResearchChipsetTiming(), autoResearchSetExclusiveDriverByName(), fl::task::every_ms(), FL_ERROR, FL_PRINT, FL_TRACE, autoresearch::StubAutorunLedState::leds, fl::makeTimingConfig(), fl::NamedTimingConfig::name, RGB, fl::RMT, state, stubAutorunLedState(), fl::task::Handle::then(), and fl::NamedTimingConfig::timing.

Here is the call graph for this function: