setExclusiveDriverByName()

bool fl::ChannelManager::setExclusiveDriverByName

(

const char *

name

)

Enable only one driver exclusively (disables all others) — by-name escape hatch.

Parameters

name	Driver name to enable exclusively (case-sensitive, e.g., "MOCK_SPI")

Returns

true if driver was found and set as exclusive, false if name not found

Test / mock helper: works with drivers that have ALREADY been registered via addDriver() (typically ChannelEngineMock instances under unit tests), or for drivers whose names are NOT in the fl::Bus enum (custom third-party drivers, RPC-resolved names). Does NOT link or register new drivers.

For built-in drivers, prefer either:

• setExclusiveDriver(fl::Bus) (typed runtime form), or
• setExclusiveDriver<fl::Bus B>() (compile-time form that links the driver TU via ODR-use).

  Note

  Atomically disables all drivers, then enables the specified one

  Changes take effect immediately on next enqueue()

  If name is not found, all drivers remain disabled (defensive behavior)

  Use nullptr or empty string to disable all drivers (returns false)

  Warning

  This will disable ALL other registered drivers, including future additions

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

                                                                           {
    // Handle null or empty name: disable everything.
    if (!name || !name[0]) {
        FL_ERROR("ChannelManager::setExclusiveDriverByName() - Null or empty driver name provided");
        mExclusiveDriver.clear();
        for (auto& entry : mDrivers) {
            entry.enabled = false;
        }
        return false;
    }
 
    // Store exclusive driver name for forward compatibility.
    // When non-empty, addDriver() will auto-disable non-matching drivers.
    mExclusiveDriver = name;
 
    // Single-pass: enable only drivers matching the given name.
    bool found = false;
    for (auto& entry : mDrivers) {
        entry.enabled = (entry.name == name);
        found = found || entry.enabled;
    }
 
    if (!found) {
        FL_ERROR("ChannelManager::setExclusiveDriverByName() - Driver '" << name << "' not found in registry");
    }
    return found;
}

References FL_ERROR, fl::FL_NO_EXCEPT, mDrivers, and mExclusiveDriver.

Referenced by setExclusiveDriver().

Here is the caller graph for this function: