Class ChannelEngineUART

src/platforms/esp/32/drivers/uart/channel_driver_uart.h:49–105

@brief UART-based channel driver for single-lane LED control Implements IChannelDriver interface using ESP32 UART peripheral for LED data transmission. Uses wave10 encoding with dynamic LUT generation.

/// Implements IChannelDriver interface using ESP32 UART peripheral for
/// LED data transmission. Uses wave10 encoding with dynamic LUT generation.
class ChannelEngineUART : public IChannelDriver {
public:
    explicit ChannelEngineUART(fl::shared_ptr<IUartPeripheral> peripheral) FL_NOEXCEPT;
    ~ChannelEngineUART() override;

    bool canHandle(const ChannelDataPtr& data) const FL_NOEXCEPT override;

    void enqueue(ChannelDataPtr channelData) FL_NOEXCEPT override;
    void show() FL_NOEXCEPT override;
    DriverState poll() FL_NOEXCEPT override;

    fl::string getName() const FL_NOEXCEPT override { return fl::string::from_literal("UART"); }

    Capabilities getCapabilities() const FL_NOEXCEPT override {
        return Capabilities(true, false);  // Clockless only
    }

private:
    void beginTransmission(fl::span<const ChannelDataPtr> channelData) FL_NOEXCEPT;

    void prepareScratchBuffer(fl::span<const ChannelDataPtr> channelData,
                              size_t maxChannelSize) FL_NOEXCEPT;

    /// @brief Get or create a Wave10Lut for the given timing
    /// @param timing Chipset timing configuration
    /// @return Reference to cached Wave10Lut
    const Wave10Lut& getOrBuildLut(const ChipsetTimingConfig& timing) FL_NOEXCEPT;

private:
    struct ChipsetGroup {
        ChipsetTimingConfig mTiming;
        fl::vector<ChannelDataPtr> mChannels;
    };

    /// @brief Cached LUT entry (timing → LUT mapping)
    struct LutCacheEntry {
        ChipsetTimingConfig mTiming;
        Wave10Lut mLut;
        u32 mBaudRate;
    };

    fl::shared_ptr<IUartPeripheral> mPeripheral;
    bool mInitialized;
    u32 mCurrentBaudRate; ///< Currently configured baud rate

    fl::vector<u8> mScratchBuffer;
    fl::vector<u8> mEncodedBuffer;

    fl::vector<ChannelDataPtr> mEnqueuedChannels;
    fl::vector<ChannelDataPtr> mTransmittingChannels;

    fl::vector<ChipsetGroup> mChipsetGroups;
    size_t mCurrentGroupIndex;

    /// @brief LUT cache for multi-timing support
    fl::vector<LutCacheEntry> mLutCache;
};