🚀 Release ELK-BLEDOM FastLink v1.3.15

🔧 Changes:

• Added support for MELK-OG10W model
• Implemented native Cold White command for MELK-OG10W
• Enhanced color temperature control with model-specific commands
• Improved device detection and initialization

📝 Details:

The MELK-OG10W model now uses dedicated BLE commands:

• Power ON: 0x7E, 0x07, 0x04, 0xFF, 0x00, 0x01, 0x02, 0x01, 0xEF
• Power OFF: 0x7E, 0x07, 0x04, 0x00, 0x00, 0x00, 0x02, 0x01, 0xEF
• Cold White: 0x7E, 0x07, 0x05, 0x01, intensity%, 0xFF, 0x02, 0x01, 0xEF

Special thanks to the community for BLE sniffing and testing! 🙏

🧩 Home Assistant custom integration for ELK-BLEDOM RGB controllers
💾 Fully compatible with HACS
🔗 https://github.com/Satimaro/elkbledom-fastlink

✨ ELK-BLEDOM FastLink v1.3.14

English / Русский

🇬🇧 English

🚀 Overview

A major modernization of the ELK-BLEDOM FastLink integration for Home Assistant.
This release focuses on improved UI clarity, stable Bluetooth performance, and cleaner internal logic.

🔧 Changes and Improvements

• 🌈 New effect system:
  All effects now have readable names, icons, and emoji labels for better recognition in the UI.
  Added detailed descriptions (hint) for each effect.

• 💡 Improved user interface:
  Removed redundant attribute fields from the state panel — effects are now displayed cleanly in the dropdown.
  The active effect color automatically tints the icon for visual feedback.

• ⚙️ Refactored core logic:
  light.py fully rewritten with async-safe operations and state synchronization.
  Fixed color and brightness restoration after power loss.

• 🔥 Color temperature emulation:
  Added smooth RGB-based emulation of color temperature in range 1800–7000 K,
  producing more natural warm–cool transitions.

• 🧩 Optimized codebase:
  const.py simplified — only necessary constants remain.
  Enum-based structure improved readability and maintainability.
  Full compliance with modern Home Assistant core (2025+).

🇷🇺 Русский

🚀 Обзор

Глобальное обновление интеграции ELK-BLEDOM FastLink для Home Assistant.
Основное внимание уделено визуальной чистоте, стабильности Bluetooth и улучшенной логике работы.

🔧 Что нового и улучшено

• 🌈 Новая система эффектов:
  Эффекты получили понятные названия, иконки и эмодзи для наглядности в интерфейсе.
  Добавлены короткие описания (hint) для каждого эффекта.

• 💡 Улучшенный интерфейс:
  Убраны лишние атрибуты из панели состояний — теперь эффекты отображаются аккуратно в списке.
  Цвет активного эффекта подсвечивает иконку устройства.

• ⚙️ Переписана логика ядра:
  Полностью обновлён light.py, теперь с безопасной асинхронностью.
  Исправлено восстановление цвета и яркости после перезапуска.

• 🔥 Эмуляция цветовой температуры:
  Реализована плавная RGB-эмуляция диапазона 1800–7000 K
  для более естественных переходов от тёплого к холодному свету.

• 🧩 Оптимизация структуры кода:
  Файл const.py упрощён, остались только реально используемые константы.
  Улучшена читаемость и соответствие стандартам Home Assistant 2025+.

🚀 ELK-BLEDOM FastLink v1.3.13

🌈 Brightness Mode Selector

• Added a new brightness control mode selector with three options:
  • AUTO – automatically detects if the controller supports native brightness commands.
  • RGB – uses RGB channel scaling for brightness emulation.
  • NATIVE – sends the original BLE brightness command (0x04 0x01 <percent>).
• Introduced a new Select entity in Home Assistant for switching modes directly from the UI.
• Instantly reconnects when the mode changes — no need to reload the integration.

⚙️ Smart Auto Fallback

• In AUTO mode, the integration now first tries native brightness and automatically falls back to RGB if the device doesn’t support it.
  → Fixes the issue where brightness stayed unchanged on certain RGBIC LED strips.

🔁 Improvements & Stability

• Added automatic reconnect after mode change or BLE disconnect.
• Faster reconnection during Home Assistant startup.
• Optimized async state file I/O (.storage/elkbledom_fastlink_state.json).
• Improved overall BLE write stability and error handling.
• Expanded config options — you can now manage brightness mode directly from integration settings.

🌍 New Translations

• Added full localization support for 17 languages:
  🇺🇸 English, 🇷🇺 Russian, 🇪🇸 Spanish, 🇫🇷 French, 🇵🇱 Polish, 🇸🇰 Slovak, 🇹🇷 Turkish, 🇺🇦 Ukrainian, 🇨🇿 Czech, 🇩🇪 German, 🇮🇹 Italian, 🇳🇱 Dutch, 🇧🇷 Portuguese (BR), 🇸🇪 Swedish, 🇩🇰 Danish, 🇳🇴 Norwegian, 🇨🇳 Simplified Chinese, 🇯🇵 Japanese, 🇰🇷 Korean.

🧩 Compatibility

• Fully compatible with all ELK-BLEDOM / MELK / LEDBLE controllers.
• Tested with Home Assistant 2025.10+ and Bleak ≥ 0.22.

💡 If your LED controller reacts only to native brightness commands — switch to Native mode in the Select entity or integration options.

🚀 ELK-BLEDOM FastLink v1.3.10

🔧 Major Changes

• 🧠 Smart Brightness Handling: fixed color reset when changing brightness — LED now keeps its current RGB color instead of turning white
• ⚙️ Full-Brightness Support: sends native 0x04 0x01 0x64 command at 100% brightness, plus automatic RGB fallback for unsupported devices
• ⚡ Async File I/O: state is now saved & loaded asynchronously — no more Home Assistant warnings about blocking calls
• 🔁 Safer Fallback Logic: if full-brightness command isn’t supported, controller automatically reverts to the correct RGB color
• 🧩 Improved Stability: cleaner BLE writes and better protection against reconnection race conditions

⚙️ Behavior Notes

• Color and brightness always persist correctly between restarts
• No more white flashes when adjusting brightness
• Compatible with all ELK-BLEDOM and FastLink devices
• Silent and safe auto-fallback for nonstandard controllers

🧠 Developer Notes

This release finalizes brightness and color handling — ensuring stability, async safety, and consistent color fidelity across all devices.

🧩 Updated Files

custom_components/elkbledom_fastlink/elkbledom.py

🚀 ELK-BLEDOM FastLink v1.3.9

🔧 Major Changes

• ✨ Added new “None” (Solid) effect to easily return from animations to static light mode
• 🌈 Selecting “None” stops any running effect and restores the last RGB color & brightness
• ⚙️ Improved internal logic for smoother effect switching and better stability
• 🧩 Enhanced compatibility with Home Assistant light controls

📁 Updated Files

• custom_components/elkbledom_fastlink/const.py
• custom_components/elkbledom_fastlink/light.py
• custom_components/elkbledom_fastlink/elkbledom.py

⚙️ Behavior Notes

• 🪄 “None” now appears at the top of the effects list in Home Assistant
• 💡 Works seamlessly with all existing color and brightness settings
• 🔄 Fully backward-compatible with version 1.3.8 state and configuration logic

🧠 Developer Notes

This update focuses on improving user experience and control flexibility,
allowing you to disable effects without resetting your light’s state.

🚀 ELK-BLEDOM FastLink v1.3.8

🔧 Major Changes

• Fully refactored elkbledom.py — improved BLE connection stability and auto-reconnect logic
• Fixed state loss after power-off — color & brightness now persist correctly
• Removed effect persistence to prevent unwanted white flashes on startup
• Brightness restoration now matches the exact previous level
• Added safe color-temperature emulation (warm ↔ cool white) through RGB blending
• Added device properties: is_on, brightness, rgb_color, color_temp_kelvin — ensures full compatibility with light.py and number.py
• Improved Bluetooth reconnection behavior with heartbeat + retry protection
• Fixed AttributeError: 'BLEDOMInstance' object has no attribute 'is_on'
• Restored working effect-speed slider (number.py) without startup errors

🧩 Updated Files

• custom_components/elkbledom_fastlink/elkbledom.py
• custom_components/elkbledom_fastlink/light.py
• custom_components/elkbledom_fastlink/number.py

⚙️ Behavior Notes

• On power-off → state saved to /config/.storage/elkbledom_fastlink_state.json
• On power-on → LED strip restores color & brightness instantly (no white blink)
• Effects are no longer stored in JSON — prevents unexpected transitions
• Fully compatible with Home Assistant UI for color, brightness, and color-temperature control

🧠 Developer Notes

This release focuses on state persistence and reliability rather than new features.

🚀 Release ELK-BLEDOM FastLink v1.3.7

🔧 Changes:
• Improved brightness control
• Optimized color and warm tone
• Restored effect animations
• Enhanced Bluetooth stability

🧩 Home Assistant custom integration for ELK-BLEDOM RGB controllers
💾 Fully compatible with HACS
🔗 https://github.com/Satimaro/elkbledom-fastlink