channel_typed.h

Go to the documentation of this file.

#pragma once

 
#include "fl/channels/bus.h"
#include "fl/channels/bus_traits.h"
#include "fl/channels/channel.h"
#include "fl/channels/config.h"
#include "fl/stl/noexcept.h"
#include "fl/stl/static_assert.h"
#include "fl/stl/type_traits.h"
 
namespace fl {
 
namespace detail {

template<Bus B, typename Chipset>
struct resolve_bus {
    static constexpr Bus value = B;
};
 
template<typename Chipset>
struct resolve_bus<Bus::AUTO, Chipset> {
    static constexpr Bus value = DefaultBus<Chipset>::value;
};
 
}  // namespace detail

template<Bus B, typename Chipset, fl::u8 Which = 0>
class TypedChannel {
public:
    static constexpr Bus kBus = detail::resolve_bus<B, Chipset>::value;
 
    // Compile-time contract: the named bus must accept this chipset family.
    //
    // The diagnostic message (suppressed on pre-C++17 toolchains by
    // FL_STATIC_ASSERT) describes the contract: route ClocklessChipset to a
    // clockless bus (RMT/PARLIO/I2S/...) and SpiChipsetConfig to an SPI bus.
    FL_STATIC_ASSERT(
        BusSupports<kBus, Chipset, Which>::value,
        "TypedChannel: Bus does not support this Chipset family");

    static ChannelPtr create(const ChannelConfigOf<Chipset>& cfg) FL_NO_EXCEPT {
        // Register only the compile-time-selected bus specialization and its
        // associated driver(s). This retains the required translation unit(s)
        // without pulling in enableAllDrivers().
        BusTraits<kBus, Which>::registerWithManager();
        ChannelConfig erased = cfg.toErased();
        erased.options.mBus = kBus;
        erased.options.mBusWhich = Which;
        return Channel::create(erased);
    }

    static ChannelPtr create(const ChannelConfig& cfg) FL_NO_EXCEPT {
        BusTraits<kBus, Which>::registerWithManager();
        ChannelConfig erased = cfg;
        erased.options.mBus = kBus;
        erased.options.mBusWhich = Which;
        return Channel::create(erased);
    }
 
private:
    TypedChannel() FL_NO_EXCEPT = delete;
};
 
}  // namespace fl