selectDriverForChannel()

fl::shared_ptr< IChannelDriver > fl::ChannelManager::selectDriverForChannel	(	const ChannelDataPtr &	data,
		const fl::string &	affinity )

Select best driver for channel data (used by Channel::showPixels)

Parameters

data	Channel data to route (chipset configuration)
affinity	Engine affinity name (empty = no affinity, dynamic selection)

Returns

Shared pointer to selected driver, or nullptr if none compatible

Note

Iterates drivers by priority (already sorted descending) and returns first that canHandle()

This is called lazily in Channel::showPixels() if no driver is bound

Definition at line 418 of file manager.cpp.hpp.

                                                                                                                                     {
    if (!data) {
        FL_ERROR("ChannelManager::selectDriverForChannel() - Null channel data");
        return fl::shared_ptr<IChannelDriver>();
    }
 
    // If affinity is specified, look up by name. Misses fall through to
    // priority dispatch below — per-frame logging is intentionally silent
    // here because `Channel::showPixels` now emits a one-shot, actionable
    // FL_ERROR with the enableDrivers<...>() / enableAllDrivers() hint
    // (#2455). Use `findDriverByName` (silent) rather than `getDriverByName`
    // (logs on miss) so the silent fall-through actually IS silent.
    do {
        if (affinity.empty()) {
            break;
        }
        auto driver = findDriverByName(affinity);
        if (!driver) {
            break;  // diagnostic emitted at the channel layer
        }
        if (!driver->canHandle(data)) {
            FL_WARN_ONCE("ChannelManager: Affinity driver '" << affinity << "' cannot handle channel data (chipset/bus mismatch). Falling back to AUTO/priority dispatch.");
            break;
        }
        return driver;
    } while (false);
    
 
    // No affinity: iterate drivers by priority (already sorted descending)
    for (const auto& entry : mDrivers) {
        if (!entry.enabled) continue;
        if (entry.driver->canHandle(data)) {
            return entry.driver;  // Return shared_ptr
        }
    }
 
    FL_ERROR("ChannelManager: No compatible driver found for channel data");
    return fl::shared_ptr<IChannelDriver>();
}

References findDriverByName(), FL_ERROR, fl::FL_NO_EXCEPT, FL_WARN_ONCE, and mDrivers.

Referenced by fl::SlimSpiBridgeController< CHIPSET, RGB_ORDER, B, B_WHICH >::resolveDriver(), and fl::Channel::resolveDynamicDriver().

Here is the call graph for this function:

Here is the caller graph for this function: