canMatch()

HandleResult fl::canMatch	(	const DriverCapabilities &	caps,
		fl::span< const PinGroup >	groups,
		const ChannelRequest &	request )

Test a request (single-pin OR multi-pin ganged) against a driver's published capability data.

Parameters

caps	Driver-wide descriptor (protocol gates, freq ranges, clockless timing model, flags).
groups	The driver's per-resource group list.
request	Channel request — data_pins bitset + clock_pin + chipset timing windows + optional frequency override. A single-pin request has exactly one bit set in data_pins.

Returns

HandleResult::Yes if any group accepts the request; otherwise the strongest rejection reason observed across all groups.

Definition at line 194 of file can_match.cpp.hpp.

                                                    {
    if (!can_match_detail::driverProtocolGate(caps, request.protocol)) {
        return HandleResult::NoProtocol;
    }
    if (groups.empty()) {
        // No groups published; nothing this driver can match concretely.
        return HandleResult::NoPin;
    }
    if (request.data_pins.none()) {
        // No pins requested — nothing to match against.
        return HandleResult::NoPin;
    }
    // Driver-wide aggregate cap: a bulk request with N pins can't be
    // served by a driver that publishes max_total_channels < N, even if
    // an individual group's max_concurrent would otherwise fit it
    // (CodeRabbit #3197).
    const fl::u32 requested_count = request.data_pins.count();
    if (caps.max_total_channels != 0u &&
        requested_count > static_cast<fl::u32>(caps.max_total_channels)) {
        return HandleResult::NoCapacity;
    }
 
    HandleResult best = HandleResult::NoProtocol;
    for (fl::size i = 0; i < groups.size(); ++i) {
        HandleResult r = can_match_detail::checkOneGroup(caps, groups[i], request);
        if (r == HandleResult::Yes) {
            return r;
        }
        if (can_match_detail::strength(r) > can_match_detail::strength(best)) {
            best = r;
        }
    }
    return best;
}

References fl::can_match_detail::checkOneGroup(), fl::can_match_detail::driverProtocolGate(), FL_NO_EXCEPT, NoCapacity, NoPin, NoProtocol, fl::can_match_detail::strength(), and Yes.

Referenced by fl::IChannelDriver::canMatch().

Here is the call graph for this function:

Here is the caller graph for this function: