Class ClocklessController

src/platforms/stub/clockless_channel_stub.h:36–117

/// for testing. It mirrors the architecture of ESP32's ClocklessIdf5.
template <int DATA_PIN, typename TIMING, EOrder RGB_ORDER = RGB, int XTRA0 = 0, bool FLIP = false, int WAIT_TIME = 0>
class ClocklessController : public CPixelLEDController<RGB_ORDER> {
private:
    // Channel data for transmission
    ChannelDataPtr mChannelData;

    // Channel driver reference (weak pointer for lifetime safety)
    fl::weak_ptr<IChannelDriver> mDriver;

    // LED capture tracker for simulation/testing
    ActiveStripTracker mTracker;
    fl::vector<u8> mCaptureData;

public:
    ClocklessController()
 FL_NOEXCEPT {
        // Create channel data with pin and timing configuration
        ChipsetTimingConfig timing = makeTimingConfig<TIMING>();
        mChannelData = ChannelData::create(DATA_PIN, timing);
        // Phase 5b of #2428: pre-bind to the stub driver singleton so
        // showPixels() bypasses ChannelManager entirely. Naming
        // BusTraits<Bus::STUB>::instancePtr() here is the ODR-use that
        // lets the linker keep ONLY the stub driver TU -- post-#2428
        // drivers do not auto-register, so this pre-bind is what links
        // the stub singleton.
        mDriver = BusTraits<Bus::STUB>::instancePtr();
    }

    virtual void init() FL_NOEXCEPT override { }

protected:
    virtual void showPixels(PixelController<RGB_ORDER>& pixels) FL_NOEXCEPT override
    {
        // Phase 5b of #2428: use the pre-bound driver directly. Legacy
        // `addLeds<>`-style controllers name `BusTraits<Bus::STUB>::instancePtr()`
        // in their constructor so this is the platform-default stub driver.
        // For runtime overrides, sketches use `FastLED.add(cfg)` (Channel API)
        // with `cfg.options.mBus` -- the manager-driven Channel path stays.
        fl::shared_ptr<IChannelDriver> driver = mDriver.lock();
        if (!driver) {
            FL_ERROR("ClocklessController(stub): No compatible driver found - cannot transmit");
            return;
        }

        // Wait for previous transmission to complete and release buffer
        // This prevents race conditions when show() is called faster than hardware can transmit
        u32 startTime = fl::millis();
        u32 lastWarnTime = startTime;
        while (mChannelData->isInUse()) {
            driver->poll();  // Keep polling until buffer is released

            // Warn every second if still waiting (possible deadlock or hardware issue)
            u32 elapsed = fl::millis() - startTime;
            if (elapsed > 1000 && (fl::millis() - lastWarnTime) >= 1000) {
                FL_WARN("ClocklessController(stub): Buffer still busy after " << elapsed << "ms total - possible deadlock or slow hardware");
                lastWarnTime = fl::millis();
            }
        }