wled.cpp.hpp

Go to the documentation of this file.

// ok no header
#include "fl/fx/wled.h"
#include "fl/log/log.h"
#include "fl/log/log.h"
#include "fl/stl/compiler_control.h"  // IWYU pragma: keep - FL_UNUSED
#include "fl/stl/noexcept.h"
namespace fl {
 
// WLED Constructor and Stub Implementations
 
WLED::WLED() FL_NO_EXCEPT
    : Remote(
        [this]() { return stubRequestSource(); },
        [this](const fl::json& response) { stubResponseSink(response); }
    ) {}
 
fl::optional<fl::json> WLED::stubRequestSource() FL_NO_EXCEPT {
    FL_ERROR("WLED::stubRequestSource: Not implemented - provide a real RequestSource callback");
    return fl::nullopt;
}
 
void WLED::stubResponseSink(const fl::json& response) FL_NO_EXCEPT {
    FL_UNUSED(response);  // only consumed by FL_ERROR, a no-op on small platforms
    FL_ERROR("WLED::stubResponseSink: Not implemented - provide a real ResponseSink callback");
}
 
// WLED State Management
 
void WLED::setState(const fl::json& wledState) FL_NO_EXCEPT {
    if (!wledState.has_value()) {
        FL_WARN("WLED: setState called with invalid JSON");
        return;
    }
 
    // Extract "on" field (bool) - optional, keep existing if missing
    if (wledState.contains("on") && wledState["on"].is_bool()) {
        bool newOn = wledState["on"] | mWledOn;
        if (newOn != mWledOn) {
            mWledOn = newOn;
            FL_DBG("WLED: on=" << ((mWledOn ? "true" : "false")));
        }
    }
 
    // Extract "bri" field (0-255) - optional, keep existing if missing
    if (wledState.contains("bri")) {
        if (wledState["bri"].is_int()) {
            i64 briInt = wledState["bri"] | static_cast<i64>(mWledBri);
            // Clamp to valid range 0-255
            if (briInt < 0) {
                FL_WARN("WLED: brightness " << briInt << " out of range, clamping to 0");
                briInt = 0;
            } else if (briInt > 255) {
                FL_WARN("WLED: brightness " << briInt << " out of range, clamping to 255");
                briInt = 255;
            }
            u8 newBri = static_cast<u8>(briInt);
            if (newBri != mWledBri) {
                mWledBri = newBri;
                FL_DBG("WLED: bri=" << (static_cast<int>(mWledBri)));
            }
        } else {
            FL_WARN("WLED: 'bri' field has invalid type (expected int)");
        }
    }
 
    // Extract "transition" field (0-65535) - optional, keep existing if missing
    if (wledState.contains("transition")) {
        if (wledState["transition"].is_int()) {
            i64 transInt = wledState["transition"] | static_cast<i64>(mTransition);
            // Clamp to valid range 0-65535
            if (transInt < 0) {
                FL_WARN("WLED: transition " << transInt << " out of range, clamping to 0");
                transInt = 0;
            } else if (transInt > 65535) {
                FL_WARN("WLED: transition " << transInt << " out of range, clamping to 65535");
                transInt = 65535;
            }
            u16 newTransition = static_cast<u16>(transInt);
            if (newTransition != mTransition) {
                mTransition = newTransition;
                FL_DBG("WLED: transition=" << mTransition);
            }
        } else {
            FL_WARN("WLED: 'transition' field has invalid type (expected int)");
        }
    }
 
    // Extract "ps" field (preset ID: -1 to 250) - optional, keep existing if missing
    if (wledState.contains("ps")) {
        if (wledState["ps"].is_int()) {
            i64 psInt = wledState["ps"] | static_cast<i64>(mPreset);
            // Clamp to valid range -1 to 250
            if (psInt < -1) {
                FL_WARN("WLED: preset " << psInt << " out of range, clamping to -1");
                psInt = -1;
            } else if (psInt > 250) {
                FL_WARN("WLED: preset " << psInt << " out of range, clamping to 250");
                psInt = 250;
            }
            i16 newPreset = static_cast<i16>(psInt);
            if (newPreset != mPreset) {
                mPreset = newPreset;
                FL_DBG("WLED: ps=" << mPreset);
            }
        } else {
            FL_WARN("WLED: 'ps' field has invalid type (expected int)");
        }
    }
 
    // Extract "pl" field (playlist ID: -1 to 250) - optional, keep existing if missing
    if (wledState.contains("pl")) {
        if (wledState["pl"].is_int()) {
            i64 plInt = wledState["pl"] | static_cast<i64>(mPlaylist);
            // Clamp to valid range -1 to 250
            if (plInt < -1) {
                FL_WARN("WLED: playlist " << plInt << " out of range, clamping to -1");
                plInt = -1;
            } else if (plInt > 250) {
                FL_WARN("WLED: playlist " << plInt << " out of range, clamping to 250");
                plInt = 250;
            }
            i16 newPlaylist = static_cast<i16>(plInt);
            if (newPlaylist != mPlaylist) {
                mPlaylist = newPlaylist;
                FL_DBG("WLED: pl=" << mPlaylist);
            }
        } else {
            FL_WARN("WLED: 'pl' field has invalid type (expected int)");
        }
    }
 
    // Extract "lor" field (live override: 0-2) - optional, keep existing if missing
    if (wledState.contains("lor")) {
        if (wledState["lor"].is_int()) {
            i64 lorInt = wledState["lor"] | static_cast<i64>(mLiveOverride);
            // Clamp to valid range 0-2
            if (lorInt < 0) {
                FL_WARN("WLED: live override " << lorInt << " out of range, clamping to 0");
                lorInt = 0;
            } else if (lorInt > 2) {
                FL_WARN("WLED: live override " << lorInt << " out of range, clamping to 2");
                lorInt = 2;
            }
            u8 newLiveOverride = static_cast<u8>(lorInt);
            if (newLiveOverride != mLiveOverride) {
                mLiveOverride = newLiveOverride;
                FL_DBG("WLED: lor=" << (static_cast<int>(mLiveOverride)));
            }
        } else {
            FL_WARN("WLED: 'lor' field has invalid type (expected int)");
        }
    }
 
    // Extract "mainseg" field (main segment: 0-255) - optional, keep existing if missing
    if (wledState.contains("mainseg")) {
        if (wledState["mainseg"].is_int()) {
            i64 mainsegInt = wledState["mainseg"] | static_cast<i64>(mMainSegment);
            // Clamp to valid range 0-255
            if (mainsegInt < 0) {
                FL_WARN("WLED: main segment " << mainsegInt << " out of range, clamping to 0");
                mainsegInt = 0;
            } else if (mainsegInt > 255) {
                FL_WARN("WLED: main segment " << mainsegInt << " out of range, clamping to 255");
                mainsegInt = 255;
            }
            u8 newMainSegment = static_cast<u8>(mainsegInt);
            if (newMainSegment != mMainSegment) {
                mMainSegment = newMainSegment;
                FL_DBG("WLED: mainseg=" << (static_cast<int>(mMainSegment)));
            }
        } else {
            FL_WARN("WLED: 'mainseg' field has invalid type (expected int)");
        }
    }
 
    // Extract "nl" field (nightlight object) - optional
    if (wledState.contains("nl")) {
        if (wledState["nl"].is_object()) {
            const fl::json& nl = wledState["nl"];
 
            // Extract "on" field (bool)
            if (nl.contains("on") && nl["on"].is_bool()) {
                bool newNlOn = nl["on"] | mNightlightOn;
                if (newNlOn != mNightlightOn) {
                    mNightlightOn = newNlOn;
                    FL_DBG("WLED: nl.on=" << ((mNightlightOn ? "true" : "false")));
                }
            }
 
            // Extract "dur" field (1-255 minutes)
            if (nl.contains("dur")) {
                if (nl["dur"].is_int()) {
                    i64 durInt = nl["dur"] | static_cast<i64>(mNightlightDuration);
                    // Clamp to valid range 1-255
                    if (durInt < 1) {
                        FL_WARN("WLED: nl.dur " << durInt << " out of range, clamping to 1");
                        durInt = 1;
                    } else if (durInt > 255) {
                        FL_WARN("WLED: nl.dur " << durInt << " out of range, clamping to 255");
                        durInt = 255;
                    }
                    u8 newDur = static_cast<u8>(durInt);
                    if (newDur != mNightlightDuration) {
                        mNightlightDuration = newDur;
                        FL_DBG("WLED: nl.dur=" << (static_cast<int>(mNightlightDuration)));
                    }
                } else {
                    FL_WARN("WLED: 'nl.dur' field has invalid type (expected int)");
                }
            }
 
            // Extract "mode" field (0-3)
            if (nl.contains("mode")) {
                if (nl["mode"].is_int()) {
                    i64 modeInt = nl["mode"] | static_cast<i64>(mNightlightMode);
                    // Clamp to valid range 0-3
                    if (modeInt < 0) {
                        FL_WARN("WLED: nl.mode " << modeInt << " out of range, clamping to 0");
                        modeInt = 0;
                    } else if (modeInt > 3) {
                        FL_WARN("WLED: nl.mode " << modeInt << " out of range, clamping to 3");
                        modeInt = 3;
                    }
                    u8 newMode = static_cast<u8>(modeInt);
                    if (newMode != mNightlightMode) {
                        mNightlightMode = newMode;
                        FL_DBG("WLED: nl.mode=" << (static_cast<int>(mNightlightMode)));
                    }
                } else {
                    FL_WARN("WLED: 'nl.mode' field has invalid type (expected int)");
                }
            }
 
            // Extract "tbri" field (0-255 target brightness)
            if (nl.contains("tbri")) {
                if (nl["tbri"].is_int()) {
                    i64 tbriInt = nl["tbri"] | static_cast<i64>(mNightlightTargetBrightness);
                    // Clamp to valid range 0-255
                    if (tbriInt < 0) {
                        FL_WARN("WLED: nl.tbri " << tbriInt << " out of range, clamping to 0");
                        tbriInt = 0;
                    } else if (tbriInt > 255) {
                        FL_WARN("WLED: nl.tbri " << tbriInt << " out of range, clamping to 255");
                        tbriInt = 255;
                    }
                    u8 newTbri = static_cast<u8>(tbriInt);
                    if (newTbri != mNightlightTargetBrightness) {
                        mNightlightTargetBrightness = newTbri;
                        FL_DBG("WLED: nl.tbri=" << (static_cast<int>(mNightlightTargetBrightness)));
                    }
                } else {
                    FL_WARN("WLED: 'nl.tbri' field has invalid type (expected int)");
                }
            }
        } else {
            FL_WARN("WLED: 'nl' field has invalid type (expected object)");
        }
    }
 
    // Extract "udpn" field (UDP sync settings) - optional
    if (wledState.contains("udpn")) {
        if (wledState["udpn"].is_object()) {
            const fl::json& udpn = wledState["udpn"];
 
            // Extract "send" field (bool)
            if (udpn.contains("send") && udpn["send"].is_bool()) {
                bool newSend = udpn["send"] | mUdpSend;
                if (newSend != mUdpSend) {
                    mUdpSend = newSend;
                    FL_DBG("WLED: udpn.send=" << ((mUdpSend ? "true" : "false")));
                }
            }
 
            // Extract "recv" field (bool)
            if (udpn.contains("recv") && udpn["recv"].is_bool()) {
                bool newRecv = udpn["recv"] | mUdpReceive;
                if (newRecv != mUdpReceive) {
                    mUdpReceive = newRecv;
                    FL_DBG("WLED: udpn.recv=" << ((mUdpReceive ? "true" : "false")));
                }
            }
        } else {
            FL_WARN("WLED: 'udpn' field has invalid type (expected object)");
        }
    }
 
    // Extract "playlist" field (playlist configuration) - optional
    if (wledState.contains("playlist")) {
        if (wledState["playlist"].is_object()) {
            const fl::json& pl = wledState["playlist"];
 
            // Extract "ps" field (array of preset IDs)
            if (pl.contains("ps") && pl["ps"].is_array()) {
                mPlaylistPresets.clear();
                for (size_t i = 0; i < pl["ps"].size(); i++) {
                    if (pl["ps"][i].is_int()) {
                        i64 psInt = pl["ps"][i] | -1;
                        // Clamp to valid range -1 to 250
                        if (psInt < -1) psInt = -1;
                        if (psInt > 250) psInt = 250;
                        mPlaylistPresets.push_back(static_cast<i16>(psInt));
                    }
                }
                FL_DBG("WLED: playlist.ps count=" << mPlaylistPresets.size());
            }
 
            // Extract "dur" field (array of durations in seconds)
            if (pl.contains("dur") && pl["dur"].is_array()) {
                mPlaylistDurations.clear();
                for (size_t i = 0; i < pl["dur"].size(); i++) {
                    if (pl["dur"][i].is_int()) {
                        i64 durInt = pl["dur"][i] | 0;
                        if (durInt < 0) durInt = 0;
                        if (durInt > 65535) durInt = 65535;
                        mPlaylistDurations.push_back(static_cast<u16>(durInt));
                    }
                }
            }
 
            // Extract "transition" field (array of transitions in ×100ms)
            if (pl.contains("transition") && pl["transition"].is_array()) {
                mPlaylistTransitions.clear();
                for (size_t i = 0; i < pl["transition"].size(); i++) {
                    if (pl["transition"][i].is_int()) {
                        i64 transInt = pl["transition"][i] | 0;
                        if (transInt < 0) transInt = 0;
                        if (transInt > 65535) transInt = 65535;
                        mPlaylistTransitions.push_back(static_cast<u16>(transInt));
                    }
                }
            }
 
            // Extract "repeat" field
            if (pl.contains("repeat") && pl["repeat"].is_int()) {
                i64 repeatInt = pl["repeat"] | 0;
                if (repeatInt < 0) repeatInt = 0;
                if (repeatInt > 65535) repeatInt = 65535;
                mPlaylistRepeat = static_cast<u16>(repeatInt);
                FL_DBG("WLED: playlist.repeat=" << mPlaylistRepeat);
            }
 
            // Extract "end" field
            if (pl.contains("end") && pl["end"].is_int()) {
                i64 endInt = pl["end"] | -1;
                if (endInt < -1) endInt = -1;
                if (endInt > 250) endInt = 250;
                mPlaylistEnd = static_cast<i16>(endInt);
                FL_DBG("WLED: playlist.end=" << mPlaylistEnd);
            }
 
            // Extract "r" field (randomize)
            if (pl.contains("r") && pl["r"].is_bool()) {
                mPlaylistRandomize = pl["r"] | false;
                FL_DBG("WLED: playlist.r=" << ((mPlaylistRandomize ? "true" : "false")));
            }
        } else {
            FL_WARN("WLED: 'playlist' field has invalid type (expected object)");
        }
    }
 
    // Extract "seg" field (segment array) - optional
    if (wledState.contains("seg")) {
        if (wledState["seg"].is_array()) {
            for (size_t i = 0; i < wledState["seg"].size(); i++) {
                const fl::json& segJson = wledState["seg"][i];
                if (!segJson.is_object()) {
                    FL_WARN("WLED: segment at index " << i << " is not an object");
                    continue;
                }
 
                // Extract segment ID (required for updates)
                u8 segId = 0;
                if (segJson.contains("id") && segJson["id"].is_int()) {
                    i64 idInt = segJson["id"] | 0;
                    if (idInt < 0) idInt = 0;
                    if (idInt > 255) idInt = 255;
                    segId = static_cast<u8>(idInt);
                } else {
                    // If no ID provided, use index
                    segId = static_cast<u8>(i);
                }
 
                // Find existing segment or create new one
                WLEDSegment* seg = nullptr;
                for (size_t j = 0; j < mSegments.size(); j++) {
                    if (mSegments[j].mId == segId) {
                        seg = &mSegments[j];
                        break;
                    }
                }
                if (!seg) {
                    // Create new segment
                    WLEDSegment newSeg;
                    newSeg.mId = segId;
                    mSegments.push_back(newSeg);
                    seg = &mSegments[mSegments.size() - 1];
                }
 
                // Parse segment fields using helper function
                wled::parseSegmentFields(segJson, *seg);
            }
        } else {
            FL_WARN("WLED: 'seg' field has invalid type (expected array)");
        }
    }
}
 
fl::json WLED::getState() const FL_NO_EXCEPT {
    fl::json state = fl::json::object();
    state.set("on", mWledOn);
    state.set("bri", static_cast<i64>(mWledBri));
    state.set("transition", static_cast<i64>(mTransition));
    state.set("ps", static_cast<i64>(mPreset));
    state.set("pl", static_cast<i64>(mPlaylist));
    state.set("lor", static_cast<i64>(mLiveOverride));
    state.set("mainseg", static_cast<i64>(mMainSegment));
 
    // Nightlight object
    fl::json nl = fl::json::object();
    nl.set("on", mNightlightOn);
    nl.set("dur", static_cast<i64>(mNightlightDuration));
    nl.set("mode", static_cast<i64>(mNightlightMode));
    nl.set("tbri", static_cast<i64>(mNightlightTargetBrightness));
    state.set("nl", nl);
 
    // UDP sync settings
    fl::json udpn = fl::json::object();
    udpn.set("send", mUdpSend);
    udpn.set("recv", mUdpReceive);
    state.set("udpn", udpn);
 
    // Playlist configuration (if present)
    if (hasPlaylistConfig()) {
        state.set("playlist", getPlaylistConfig());
    }
 
    // Segments
    if (!mSegments.empty()) {
        fl::json segments = fl::json::array();
        for (const auto& seg : mSegments) {
            fl::json segJson = fl::json::object();
 
            segJson.set("id", static_cast<i64>(seg.mId));
            segJson.set("start", static_cast<i64>(seg.mStart));
            segJson.set("stop", static_cast<i64>(seg.mStop));
            segJson.set("len", static_cast<i64>(seg.mLen));
            segJson.set("grp", static_cast<i64>(seg.mGrp));
            segJson.set("spc", static_cast<i64>(seg.mSpc));
            segJson.set("of", static_cast<i64>(seg.mOf));
            segJson.set("on", seg.mOn);
            segJson.set("bri", static_cast<i64>(seg.mBri));
            segJson.set("cct", static_cast<i64>(seg.mCct));
 
            // Effect properties
            segJson.set("fx", static_cast<i64>(seg.mFx));
            segJson.set("sx", static_cast<i64>(seg.mSx));
            segJson.set("ix", static_cast<i64>(seg.mIx));
            segJson.set("pal", static_cast<i64>(seg.mPal));
            segJson.set("c1", static_cast<i64>(seg.mC1));
            segJson.set("c2", static_cast<i64>(seg.mC2));
            segJson.set("c3", static_cast<i64>(seg.mC3));
 
            // Boolean flags
            segJson.set("sel", seg.mSel);
            segJson.set("rev", seg.mRev);
            segJson.set("mi", seg.mMi);
            segJson.set("o1", seg.mO1);
            segJson.set("o2", seg.mO2);
            segJson.set("o3", seg.mO3);
            segJson.set("si", static_cast<i64>(seg.mSi));
            segJson.set("m12", static_cast<i64>(seg.mM12));
            segJson.set("rpt", seg.mRpt);
 
            if (!seg.mName.empty()) {
                segJson.set("n", seg.mName);
            }
 
            // Colors
            if (!seg.mColors.empty()) {
                fl::json colors = fl::json::array();
                for (const auto& color : seg.mColors) {
                    if (color.size() >= 3) {
                        fl::json colorArray = fl::json::array();
                        for (size_t i = 0; i < color.size(); i++) {
                            colorArray.push_back(fl::json(static_cast<i64>(color[i])));
                        }
                        colors.push_back(colorArray);
                    }
                }
                segJson.set("col", colors);
            }
 
            // Individual LEDs
            if (!seg.mIndividualLeds.empty()) {
                fl::json leds = fl::json::array();
                for (const auto& led : seg.mIndividualLeds) {
                    if (led.size() >= 3) {
                        fl::string hexColor = wled::rgbToHex(led[0], led[1], led[2]);
                        leds.push_back(fl::json(hexColor.c_str()));
                    }
                }
                segJson.set("i", leds);
            }
 
            segments.push_back(segJson);
        }
        state.set("seg", segments);
    }
 
    return state;
}
 
fl::json WLED::getPlaylistConfig() const FL_NO_EXCEPT {
    fl::json playlist = fl::json::object();
 
    // Preset IDs
    if (!mPlaylistPresets.empty()) {
        fl::json ps = fl::json::array();
        for (const auto& preset : mPlaylistPresets) {
            ps.push_back(fl::json(static_cast<i64>(preset)));
        }
        playlist.set("ps", ps);
    }
 
    // Durations
    if (!mPlaylistDurations.empty()) {
        fl::json dur = fl::json::array();
        for (const auto& duration : mPlaylistDurations) {
            dur.push_back(fl::json(static_cast<i64>(duration)));
        }
        playlist.set("dur", dur);
    }
 
    // Transitions
    if (!mPlaylistTransitions.empty()) {
        fl::json trans = fl::json::array();
        for (const auto& transition : mPlaylistTransitions) {
            trans.push_back(fl::json(static_cast<i64>(transition)));
        }
        playlist.set("transition", trans);
    }
 
    // Other properties
    playlist.set("repeat", static_cast<i64>(mPlaylistRepeat));
    playlist.set("end", static_cast<i64>(mPlaylistEnd));
    playlist.set("r", mPlaylistRandomize);
 
    return playlist;
}
 
const WLEDSegment* WLED::findSegmentById(u8 id) const FL_NO_EXCEPT {
    for (const auto& seg : mSegments) {
        if (seg.mId == id) {
            return &seg;
        }
    }
    return nullptr;
}
 
} // namespace fl