config.h

Go to the documentation of this file.

#pragma once
 
#include "crgb.h"  // IWYU pragma: keep
#include "fl/gfx/rgbw.h"  // IWYU pragma: keep
#include "fl/stl/span.h"
#include "fl/stl/vector.h"
#include "fl/stl/shared_ptr.h"
#include "fl/stl/variant.h"
#include "fl/math/screenmap.h"
#include "fl/chipsets/chipset_timing_config.h"
#include "fl/chipsets/clockless_encoder.h"
#include "fl/chipsets/spi.h"
#include "fl/gfx/eorder.h"
#include "fl/channels/options.h"
#include "fl/spi_bus.h"
#include "fl/stl/optional.h"
#include "fl/stl/string.h"  // fl::string must be complete for Optional<fl::string> below  // IWYU pragma: keep
#include "color.h"  // IWYU pragma: keep
#include "dither_mode.h"  // IWYU pragma: keep
#include "fl/stl/noexcept.h"
 
namespace fl {

struct ClocklessChipset {
    int pin;                        
    ChipsetTimingConfig timing;     
    ClocklessEncoder encoder;       

    constexpr ClocklessChipset(int pin, const ChipsetTimingConfig& timing,
                               ClocklessEncoder encoder) FL_NO_EXCEPT
        : pin(pin), timing(timing), encoder(encoder) {}

    constexpr ClocklessChipset(int pin, const ChipsetTimingConfig& timing) FL_NO_EXCEPT
        : pin(pin), timing(timing), encoder(ClocklessEncoder::CLOCKLESS_ENCODER_WS2812) {}

    constexpr ClocklessChipset() FL_NO_EXCEPT
        : pin(-1), timing(0, 0, 0, 0), encoder(ClocklessEncoder::CLOCKLESS_ENCODER_WS2812) {}

    ClocklessChipset(const ClocklessChipset&) FL_NO_EXCEPT = default;

    ClocklessChipset(ClocklessChipset&&) FL_NO_EXCEPT = default;

    ClocklessChipset& operator=(const ClocklessChipset&) FL_NO_EXCEPT = default;

    ClocklessChipset& operator=(ClocklessChipset&&) FL_NO_EXCEPT = default;

    bool operator==(const ClocklessChipset& other) const FL_NO_EXCEPT {
        return pin == other.pin &&
               timing == other.timing &&
               encoder == other.encoder;
    }

    bool operator!=(const ClocklessChipset& other) const FL_NO_EXCEPT {
        return !(*this == other);
    }
};

template <typename TIMING>
constexpr ClocklessChipset makeClockless(int pin) FL_NO_EXCEPT {
    return ClocklessChipset(pin, makeTimingConfig<TIMING>(), encoder_for<TIMING>());
}

struct SpiChipsetConfig {
    int dataPin;                    
    int clockPin;                   
    SpiEncoder timing;              
    Esp32SpiBus spiBus;             

    SpiChipsetConfig(int dataPin, int clockPin, const SpiEncoder& timing,
                     Esp32SpiBus spiBus = Esp32SpiBus::AUTO) FL_NO_EXCEPT
        : dataPin(dataPin), clockPin(clockPin), timing(timing), spiBus(spiBus) {}

    SpiChipsetConfig() FL_NO_EXCEPT : dataPin(-1), clockPin(-1), timing{fl::SpiChipset::APA102, 6000000}, spiBus(Esp32SpiBus::AUTO) {}

    SpiChipsetConfig(const SpiChipsetConfig&) FL_NO_EXCEPT = default;

    SpiChipsetConfig(SpiChipsetConfig&&) FL_NO_EXCEPT = default;

    SpiChipsetConfig& operator=(const SpiChipsetConfig&) FL_NO_EXCEPT = default;

    SpiChipsetConfig& operator=(SpiChipsetConfig&&) FL_NO_EXCEPT = default;

    bool operator==(const SpiChipsetConfig& other) const FL_NO_EXCEPT {
        return dataPin == other.dataPin &&
               clockPin == other.clockPin &&
               timing == other.timing &&
               spiBus == other.spiBus;
    }

    bool operator!=(const SpiChipsetConfig& other) const FL_NO_EXCEPT {
        return !(*this == other);
    }
};

using ChipsetVariant = fl::variant<ClocklessChipset, SpiChipsetConfig>;

struct ChannelConfig {
 
    // ========== New Variant-Based Constructors ==========

    ChannelConfig(const fl::string& name, const ChipsetVariant& chipset, fl::span<CRGB> leds,
                  EOrder rgbOrder = RGB, const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT;

    ChannelConfig(const ChipsetVariant& chipset, fl::span<CRGB> leds,
                  EOrder rgbOrder = RGB, const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT;

    ChannelConfig(const ClocklessChipset& clockless, fl::span<CRGB> leds,
                  EOrder rgbOrder = RGB, const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT;

    ChannelConfig(const SpiChipsetConfig& spi, fl::span<CRGB> leds,
                  EOrder rgbOrder = RGB, const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT;
 
    // ========== Backwards-Compatible Constructors (Deprecated) ==========

    template<typename TIMING>
    ChannelConfig(int pin, fl::span<CRGB> leds, EOrder rgbOrder = RGB,
                  const ChannelOptions& options = ChannelOptions())
 FL_NO_EXCEPT : ChannelConfig(makeClockless<TIMING>(pin), leds, rgbOrder, options) {}

    ChannelConfig(int pin, const ChipsetTimingConfig& timing, fl::span<CRGB> leds,
                  EOrder rgbOrder = RGB, const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT;
 
    // Copy constructor (needed because of variant)
    ChannelConfig(const ChannelConfig& other) FL_NO_EXCEPT;
 
    // Move constructor (needed because of variant)
    ChannelConfig(ChannelConfig&& other) FL_NO_EXCEPT;
 
    // Note: Assignment operators deleted because const members cannot be reassigned
    ChannelConfig& operator=(const ChannelConfig&) FL_NO_EXCEPT = delete;
    ChannelConfig& operator=(ChannelConfig&&) FL_NO_EXCEPT = delete;
 
    // ========== Accessors ==========

    const ChipsetVariant& getChipset() const FL_NO_EXCEPT { return chipset; }

    bool isClockless() const FL_NO_EXCEPT { return chipset.is<ClocklessChipset>(); }

    bool isSpi() const FL_NO_EXCEPT { return chipset.is<SpiChipsetConfig>(); }

    const ClocklessChipset* getClocklessChipset() const FL_NO_EXCEPT { return chipset.ptr<ClocklessChipset>(); }

    const SpiChipsetConfig* getSpiChipset() const FL_NO_EXCEPT { return chipset.ptr<SpiChipsetConfig>(); }

    int getDataPin() const FL_NO_EXCEPT;

    int getClockPin() const FL_NO_EXCEPT;

    void setScreenMap(const fl::ScreenMap& map) FL_NO_EXCEPT { mScreenMap = map; }

    const fl::ScreenMap& getScreenMap() const FL_NO_EXCEPT { return mScreenMap; }

    bool hasScreenMap() const FL_NO_EXCEPT { return mScreenMap.getLength() > 0; }
 
    // ========== Data Members ==========

    ChipsetVariant chipset;

    fl::span<CRGB> mLeds;

    EOrder rgb_order = RGB;

    ChannelOptions options;

    fl::ScreenMap mScreenMap;

    fl::optional<fl::string> mName;
};
 
FASTLED_SHARED_PTR_STRUCT(ChannelConfig);

template<typename Chipset>
struct ChannelConfigOf {
    ChannelConfigOf(const Chipset& chipset, fl::span<CRGB> leds,
                    EOrder rgbOrder = RGB,
                    const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT
        : chipset(chipset), mLeds(leds), rgb_order(rgbOrder), options(options) {}

    ChannelConfigOf(const fl::string& name, const Chipset& chipset,
                    fl::span<CRGB> leds, EOrder rgbOrder = RGB,
                    const ChannelOptions& options = ChannelOptions()) FL_NO_EXCEPT
        : chipset(chipset), mLeds(leds), rgb_order(rgbOrder), options(options), mName(name) {}

    operator ChannelConfig() const FL_NO_EXCEPT {
        ChannelConfig cfg(chipset, mLeds, rgb_order, options);
        cfg.mScreenMap = mScreenMap;
        if (mName.has_value()) {
            cfg.mName = mName;
        }
        return cfg;
    }

    ChannelConfig toErased() const FL_NO_EXCEPT { return static_cast<ChannelConfig>(*this); }
 
    // ---- Data members (mirror ChannelConfig, but with typed `chipset`) ----

    Chipset chipset;

    fl::span<CRGB> mLeds;

    EOrder rgb_order = RGB;

    ChannelOptions options;

    fl::ScreenMap mScreenMap;

    fl::optional<fl::string> mName;
};

struct MultiChannelConfig {
    MultiChannelConfig() FL_NO_EXCEPT = default;
    MultiChannelConfig(const MultiChannelConfig&) FL_NO_EXCEPT = default;
    MultiChannelConfig(MultiChannelConfig&&) FL_NO_EXCEPT = default;
 
    MultiChannelConfig(fl::span<ChannelConfigPtr> channels) FL_NO_EXCEPT : mChannels(channels.begin(), channels.end()) {}
    MultiChannelConfig(fl::initializer_list<ChannelConfigPtr> channels) FL_NO_EXCEPT : mChannels(channels.begin(), channels.end()) {}

    MultiChannelConfig(fl::span<ChannelConfig> channels) FL_NO_EXCEPT;

    MultiChannelConfig(fl::initializer_list<ChannelConfig> channels) FL_NO_EXCEPT;
 
    MultiChannelConfig& operator=(const MultiChannelConfig&) FL_NO_EXCEPT = default;
    MultiChannelConfig& operator=(MultiChannelConfig&&) FL_NO_EXCEPT = default;
    ~MultiChannelConfig() FL_NO_EXCEPT = default;

    MultiChannelConfig& add(ChannelConfigPtr channel) FL_NO_EXCEPT;

    fl::vector<ChannelConfigPtr> mChannels;
};
 
}