sphings-dev.de

Home Assistant

BLE LED Pixel Display

HACS

Home-Assistant-Integration für Bluetooth-LED-Pixelpanels (BGLight, B.K. Light von Action, iPixel Color): Text, Bilder, GIFs, Icons und Layouts lokal per Bluetooth LE, ohne Cloud und ohne Hersteller-App.

Repository (öffnet in neuem Tab)

Steckbrief

Sprache
Python
Lizenz
GPL-3.0
Aktuelle Version
2.3.3
Projektstart

Diese LED-Matrix-Panels werden als Spielzeug verkauft: Eine Handy-App stellt über Bluetooth eine Nachricht ein. Die Integration macht daraus ein Ausgabegerät für Home Assistant, mit einer text-Entität, in die jede Automation schreiben kann, und Aktionen für Bilder, GIFs, Icons und Layouts. Sie setzt ha-ipixel-color von Christian Grund fort und übernimmt Arbeit von tigers75; die Domain ble_led_pixel erlaubt den Parallelbetrieb mit dem Original.

Typische Einsätze

  • Energieanzeige an der Wand: PV-Leistung, Ladezustand, Hausverbrauch
  • Statusticker: Wer ist zuhause, nächster Termin, Garagentor offen
  • Warnungen, etwa ein rotes Panel bei offenem Fenster, während die Heizung läuft
  • Wetter-Icon samt Temperatur als ein Layout

Unterstützte Geräte

Jedes Panel, das als LED_BLE_* mit dem Service-UUID 0000fa01-0000-1000-8000-00805f9b34fb wirbt und das iPIXEL-Color-Protokoll spricht. Bekannte Marken sind B.K. Light (Action, „LED pixel board“ 32×32 und „LED fun screen“ 64×16), HYPERLITE, EZYEVY und BGLight. Die Auflösung liest die Integration vom Gerät; gesehen wurden 32×32, 64×16, 64×20 und 96×16. Alle diese Panels stammen vom selben Hersteller, Shenzhen Heaton Technology Co., Ltd., der auch die iPixel-Color-App veröffentlicht. Ein nicht gelistetes Panel funktioniert trotzdem; ein Reparaturhinweis führt zu einem vorausgefüllten Fehlerbericht.

Funktionen

  • Aktionen send_text, send_image_file, send_mdi_icon, send_layout, send_test_pattern, show_emoji, Speicherplätze mit show_slot und delete_slot
  • Panelinterne Funktionen, wo das Modell sie hat: Presets, Anzeigetafel, Countdown, Stoppuhr
  • benannte Texteffekte und Textverläufe, Schriftauswahl, Uhrmodus
  • Einfärben einzelner Wörter mit Tags wie [#ff0000]ALARM[/]
  • automatische Wiederverbindung, wenn das Panel wieder funkt
  • Unterstützung für passwortgeschützte Panels, auch Setzen und Entfernen per Aktion
  • Diagnosesensoren für Gerätetyp, Größe, Product-ID, Marke, Firmwareversionen und unterstützte Funktionen
  • Bluetooth-Proxys werden unterstützt

Installation

Voraussetzung ist Home Assistant 2024.1 oder neuer. In HACS https://github.com/sphings79/ha-ble-led-pixel-display als benutzerdefiniertes Repository der Kategorie „Integration“ hinzufügen, „BLE LED Pixel Display“ installieren und Home Assistant neu starten. Das Panel einschalten und sicherstellen, dass kein Handy verbunden ist, denn ein mit der App verbundenes Panel funkt nicht mehr. Home Assistant bietet es meist selbst an. Alternativ custom_components/ble_led_pixel manuell kopieren.

Grenzen

Der Einschaltzustand lässt sich nicht auslesen, weil das Protokoll keinen Abfragebefehl dafür hat; der Schalter zeigt, was Home Assistant zuletzt gesendet hat. Mit „Auto Update“ an kann das Panel zwischen Text und Farbe flackern, die Abhilfe beschreibt das README. Die Vorabversionen 2.4.0 mit einer Bildergalerie sind in HACS nur mit aktivierten Beta-Versionen sichtbar. Die Integration steht unter GPL-3.0 und ist inoffiziell.