node-red-contrib-mrsmart-ihost-wled 0.1.12

Capability-driven WLED integration for SONOFF iHost/eWeLink CUBE with automatic device discovery, metadata-driven effects, audio-reactive badges, Web + responsive CAST custom UI and real-time state sync.

npm install node-red-contrib-mrsmart-ihost-wled

Mr Smart iHost WLED

node-red-contrib-mrsmart-ihost-wled is a local, capability-driven WLED integration for SONOFF iHost / eWeLink CUBE using Node-RED.

Features

• Local WLED discovery from /json, /json/fxdata, /json/cfg and /presets.json.
• Automatic per-segment capability detection from WLED lc / seglc bitfields.
• Adaptive RGB, White, CCT, RGBW and RGB+CCT controls.
• Multi-segment-aware data model.
• Metadata-driven WLED effect controls (sx, ix, c1..c3, o1..o3).
• Filtering of unsupported/reserved and incompatible 2D-only effects on 1D devices.
• Audio-reactive effect identification from WLED effect metadata.
• Palette and preset selectors with automatic preset-catalog refresh.
• Real-time WLED WebSocket state synchronization with HTTP reconciliation/fallback.
• Three-way synchronization between native WLED, iHost Web UI and iHost CAST UI.
• iHost Custom UI registration with separate Web and responsive 2×2 CAST views.
• Offline-state handling and automatic recovery.
• iHost Open API access token stored as a Node-RED credential.
• Stable per-device public route based on a unique Device Key.

Installation

Node-RED Palette

Search for node-red-contrib-mrsmart-ihost-wled in Manage Palette → Install.

Local package

A packaged .tgz can also be installed through Manage Palette → Install → Upload module file. Restart/reload Node-RED if requested.

Configuration

1. Add an iHost WLED node to a flow.
2. Create/select the iHost connection and request an Open API access token.
3. Enter the UI name, a unique Device Key, and the WLED IP address/hostname.
4. Deploy the flow.
5. Open the node and click Discover WLED.
6. Confirm the detected WLED capabilities.
7. Click Register / Refresh iHost to register or refresh the Web + CAST custom UI.

WebSocket is used automatically when available. HTTP remains active for reconciliation, reconnect and fallback synchronization.

Capability-driven UI

The integration does not assume a fixed LED-strip type. It reads the capabilities reported by WLED and builds the available controls accordingly. For example, White and Colour Temperature controls are exposed only when the active WLED configuration reports those capabilities.

Tested release

v0.1.11 has been functionally validated on SONOFF iHost/eWeLink CUBE with WLED 0.16.1, including:

• Power, brightness and RGB colour control.
• WLED effects and palettes.
• Preset discovery and live preset-catalog refresh.
• Native WLED → iHost Web → CAST state synchronization.
• iHost/CAST → WLED command synchronization.
• Offline indication and recovery.
• Capability adaptation between RGB-only and White/CCT-capable WLED configurations.
• White and Colour Temperature controls, including valid cct: 0 handling.

Notes

WLED capabilities and available effects depend on the WLED version, hardware configuration, LED bus type and installed WLED build. The node exposes what WLED reports rather than assuming every controller has the same features.

License

MIT