appriff

HeimautomatisierungProjekteATI Straton

Integration für Home Assistant

ATI Straton

Lokale Integration für ATI-Straton-Aquarienleuchten. Ohne Cloud, ohne Hersteller-App: Home Assistant spricht direkt mit der Leuchte im eigenen Netz – mit Temperaturen, Intensität, Lichtprogrammen und einem Temperaturwächter.

Local Push HACS Keine Abhängigkeiten Hobbyprojekt
Schematische Darstellung der Bedienelemente in Home Assistant.

Privates Hobbyprojekt ohne Verbindung zu ATI Aquaristik – weder unterstützt noch geprüft noch genehmigt. Die Geräte-API ist nicht dokumentiert und wurde aus der Weboberfläche der Leuchte rekonstruiert. Entwickelt und geprüft mit einer Straton Flex G2 153, Firmware 3.0.4. Nutzung auf eigene Gefahr.

Ansicht

Die Tageskurve bleibt, nur die Helligkeit ändert sich.

Der Intensitätsregler wirkt wie der auf der Leuchte selbst: Jeder Stützpunkt des Tagesverlaufs wird relativ zu seinem Originalwert skaliert. Sonnenaufgang, Mittag und Abend behalten ihre Form.

  • Beleuchtung aus setzt die Intensität auf 0 – beim Einschalten kommt der letzte Wert zurück.
  • Lichtprogramm und Gewöhnungsstufe wählen, ohne das gewohnte Lichtfenster zu verschieben.
  • Gemessen am Testgerät: Intensität 60 → 490, 30 → 294, 15 → 166 (Rohwerte der Kanäle).
06:0014:0022:00 Intensität 60 % Intensität 30 % Intensität 100 %
Gestrichelt das Original, farbig die skalierte Kurve – die Form bleibt gleich.

Funktionen

Alles, was die Leuchte hergibt.

Überwachung

Temperatur und Online-Status je LED-Modul per Push (etwa alle 2 Sekunden), Stromaufnahme und Auslastung mit den Warnschwellen des Geräts.

Intensität

Schieberegler von 0 bis 100 % – die Änderung greift innerhalb weniger Sekunden, die Form der Tageskurve bleibt erhalten.

Lichtprogramme

Programme der Leuchte mit Gewöhnungsstufe: Eingewöhnung (30 %), lichtgewöhnt (60 %) oder starklichtgewöhnt (90 %).

Farben

Alle Farbvoreinstellungen mit ihrer spektralen Zusammensetzung – bearbeitbar über einen eigenen Dienst.

Temperaturwächter

Senkt die Intensität ab, wenn die Leuchte zu warm wird, und gibt sie schrittweise wieder frei – komplett in der Oberfläche einstellbar.

Betriebsmodus

Ein Sensor zeigt, wer den Tagesverlauf gerade bestimmt: der Zeitplan des Geräts, Home Assistant oder der Wächter.

Temperaturwächter

Kühler Kopf mit Hysterese.

Über der Abregeltemperatur senkt der Wächter Schritt für Schritt ab, zwischen den Schwellen hält er, unter der Freigabetemperatur nimmt er die Absenkung zurück. Regelschritte kommen höchstens alle fünf Minuten – so taktet nichts an der Schwelle.

bereit senkt ab hält gibt frei bereit 45 °C 42 °C Temperatur Intensität 100 % 80 % ≥ 5 min ≥ 5 min

Schalter

schaltet die Regelung ein und aus

Abregeltemperatur

ab diesem Wert wird abgesenkt

Freigabetemperatur

darunter wird die Absenkung zurückgenommen

Reduktionsschritt

Absenkung je Regelschritt in Prozent

Technik

Jeder Schreibvorgang ist abgesichert.

Eine Aquarienbeleuchtung ist lebenserhaltende Technik: Korallen hängen von einem stabilen Lichtregime ab. Und die Leuchte kennt nur ein Komplett-Ersetzen des Zeitplans. Deshalb läuft jede Änderung über denselben abgesicherten Weg.

Bereichsprüfung

Intensität 0 bis 100, Farbkanäle 0 bis 255, nur ganze Zahlen – alles andere wird abgelehnt, bevor eine Anfrage entsteht.

Obergrenze

Eine einstellbare maximale Intensität begrenzt jede Änderung über die Integration.

Sicherung vorher

Der Vorzustand wird gespeichert, bevor etwas gesendet wird.

Absturzsicherung

Stürzt Home Assistant ab, während der Wächter regelt, kommt beim nächsten Start die ursprüngliche Kurve zurück.

Nur ein Schreiber

Solange der Wächter eingreift, sind Intensität und Programmauswahl gesperrt.

Schlanker eigener Client

Die Leuchte spricht Socket.IO 2.x. Ein eigener Client auf Basis von aiohttp kommt ohne zusätzliche Python-Pakete aus.

Installation über HACS

  1. HACS → Integrationen → Benutzerdefinierte Repositories: https://github.com/benkrebs/ATIStraton, Kategorie Integration.
  2. „ATI Straton“ installieren und Home Assistant neu starten.
  3. Einstellungen → Geräte & Dienste → Integration hinzufügen: IP-Adresse, Benutzername und Passwort der Weboberfläche eintragen.

Gut zu wissen

  • Zugangsdaten liegen im verschlüsselten Speicher von Home Assistant und landen nie in Logs oder Diagnosedaten.
  • Einzelne Farbkanäle lassen sich nicht live steuern – das Gerät ignoriert diesen Weg. Steuerbar sind Gesamtintensität und gespeicherte Farben.
  • Wer gleichzeitig in der Weboberfläche der Leuchte speichert, überschreibt die andere Seite.

Open Source

Frei verfügbar auf GitHub.

Ausführliche Anleitung auf Deutsch und Englisch, alle Entitäten und die Warnhinweise stehen im Repository. Hilfe und Verbesserungen sind sehr willkommen.