SP108E WS2815 LED Controller Integration for Home Assistant

This is a custom Home Assistant integration for controlling SP108E-based LED strip controllers like the ALITOVE SP108E over Wi-Fi.

Tested with:

• ✅ SP108E controller in STA mode
• ✅ BTF-LIGHTING WS2815 (Upgraded WS2812B) LED strip: Amazon link

---

✨ Features

• On/Off
• Brightness control
• RGB + HS color support
• Mono-color effects (e.g. solid, breathing, wave, etc.)
• 100+ preset effects (color chase, fire, rainbow, etc.)
• Default effect and speed configuration via the UI
• Supports multiple controllers

---

🧠 Built With

• Based on example_light
• LED command logic powered by kylezimmerman/pyledshop
• Modern Home Assistant config flow (config_flow and options_flow) included

---

🛠 Installation

Manual

1. Copy or clone this repository into:

<config_dir>/custom_components/sp108e_ws2815/

2. Restart Home Assistant

3. Go to Settings → Devices & Services → + Add Integration → Search for SP108E WS2815

HACS (Recommended)

1. In HACS, go to Integrations → + Explore & Add Repositories
2. Click "⋮" → Custom repositories
3. Add your GitHub repo URL
4. Select Category: Integration
5. Install and restart Home Assistant

---

⚙️ Configuration

This integration supports setting the following:

• host: IP address of the controller (required)
• name: Friendly name (required)
• default effect: Any of the mono or preset effects
• default speed: 0–255

Once configured, you can change the default effect and speed later via:

Settings → Devices & Services → Your Controller → ⋮ → Configure

---

🔄 Upgrading

If upgrading from a version using configuration.yaml, remove the old config first. This integration now supports UI-based setup only.

---

🙏 Thanks

Built on the shoulders of:

• @kylezimmerman for pyledshop
• The Home Assistant community and custom integration ecosystem

---

💬 Feedback

Feel free to open an issue or pull request if you find bugs or have ideas!