Releases: smartmacherei/Loxone-Integration
Release list
1.3.6 – Reload lifecycle cleanup
Fix a lifecycle error found during the final HA review: after the startup event had fired, reloading the integration tried to remove its listener a second time. Listener cleanup now runs exactly once, and queued events after unloading are ignored. Normal WebSocket task cancellation is logged at debug level.
Validation: 107 automated tests passed, Python compilation and release archive checks passed. Installed on the demo HA and checked repeated integration reloads with 96 stable entities and healthy UDP reception. Existing project backups are retained.
Restart Home Assistant after updating through HACS.
1.3.5 – Deleted-device reconciliation
Deleting a device in Loxone Config previously left stale HA registry entries and could block automatic setup because its logger input was disconnected.
- Reconcile deleted project UUIDs during setup/reload, with verified registry backups and safeguards for existing/offline, shared and active devices.
- Remove only integration-generated disconnected logger references whose source signal was deleted. Preserve customer content and the mandatory project backup.
- Clean up lifecycle listeners and the WebSocket task when unloading.
- Document the update workflow in English and German.
Validation: 105 automated tests; the current demo project identified exactly 6 deleted devices/35 entities. The automatic logger repair preserved customer blocks, activated successfully and restored healthy UDP reception. Integration reload retained 96 entities. This does not constitute a physical acceptance test of every device.
After updating through HACS, restart Home Assistant. After saving device changes to the Miniserver, reload the Loxone integration; automatic setup also checks program changes when enabled. Registry backups are stored under /config/loxone_registry_backups/.
1.3.4 – Fix Miniserver HTTP port default
Fix new-installation connection timeouts
New connections now default to HTTP port 80 instead of 8080. Existing saved ports are preserved.
A fresh demo installation used the old 8080 default and failed with connection timeouts. Correcting it to port 80 restored the integration and healthy UDP reception. If your installation is affected, open the integration options and set the actual Miniserver HTTP port; upgrading does not rewrite saved connection settings.
81 regression tests passed. Other capabilities and validation limits remain as documented for 1.3.3.
Deutsch
Neue Verbindungen verwenden jetzt standardm??ig HTTP-Port 80 statt 8080. Bestehende Port-Einstellungen werden nicht ?berschrieben.
Beim erneuten Einrichten f?hrte die alte Vorgabe am Demokoffer zu Zeit?berschreitungen. Nach der Korrektur auf Port 80 funktionieren Verbindung und UDP-Empfang wieder. Betroffene bestehende Eintr?ge bitte in den Integrationsoptionen auf den tats?chlichen Miniserver-Port umstellen.
1.3.3 – Automatic real-time setup and device coverage
Loxone for Home Assistant 1.3.3
Automatic real-time setup for eligible Loxone signals, with a verified original-project backup before every program change. Existing installations keep automatic program modification disabled until explicitly enabled.
- Broader Air, Tree and Link terminal discovery and device grouping.
- Explicit source mapping for equivalent states, including supported Wallbox target charging power; corrected HTTP watts/kW conversion.
- UDP heartbeat monitoring, WebSocket fallback, bounded polling and protection against stale responses.
- Fixes for ventilation sensor platform/identity handling and integration reload cleanup.
- English/German documentation and 43 screenshots covering 20 different HA devices.
Setup can modify and briefly restart the Miniserver program. Verified original ZIP and .Loxone backups are mandatory. Keep a copy outside HA and load the current program from the Miniserver before further Config edits.
Validation: 81 automated tests; isolated HA 2026.7.2 runtime checks; demo Miniserver 17.2.8.28 backup, activation, live UDP heartbeat and reload without duplicate entities. Physical transitions for every device and actual backup restoration remain untested. The demo has unavailable special/raw channels; screenshots are not proof of full hardware support. Automatic network discovery of Miniservers is not included; provide an address and credentials.
Install/update through HACS using smartmacherei/Loxone-Integration as a custom integration repository, then restart HA. This uses the same loxone domain as PyLoxone; install only one implementation. HACS installs from the release tag. The attached installation ZIP is for manual installation; the screenshot ZIP is documentation material.
Deutsch
Automatische Echtzeiteinrichtung f?r geeignete Signale mit verpflichtender, gepr?fter Projektsicherung. Verbesserte Ger?teerkennung und Signalzuordnung, korrigierte Wallbox-Einheiten sowie Fehlerbehebungen f?r L?fter-Sensoren und erneutes Laden.
Die automatische Einrichtung kann das Miniserver-Programm ?ndern und kurz neu starten. Bei bestehenden Installationen bleibt sie bis zur ausdr?cklichen Aktivierung ausgeschaltet. Physische Zustandswechsel aller Ger?te und Wiederherstellung sind noch nicht vollst?ndig abgenommen. Miniserver-Adressen werden noch nicht automatisch erkannt.
Update ?ber das benutzerdefinierte HACS-Repository; danach HA neu starten. Deutsche und englische Ger?teansichten stehen im Repository unter docs/screenshots/1.3.3/ sowie im angeh?ngten Bilderpaket.
1.2.1 – Versions-Sensor mit fester unique_id
Behoben
- Der Sensor „Loxone Software Version" verdoppelte sich nach jedem Miniserver-Update. Seine
unique_identhielt die Firmware-Version (<Seriennummer>-17.1.6.30). Nach einem Update legte
Home Assistant deshalb einen neuen Sensorsensor.loxone_software_version_2an, der alte blieb
für immerunavailableim Entitätsregister. Dieunique_idist jetzt fest
(<Seriennummer>-loxone_software_version); beim Start werden vorhandene alte Einträge auf die
neue ID umgezogen (Entity-ID und Verlauf bleiben) und Duplikate entfernt. Aufgefallen am
Demo-Koffer beim Update 17.1.6.30 → 17.2.8.28.
1.2.0 – UDP-Push für auto-entdeckte Klemmen
Echtzeit für auto-entdeckte Klemmen. Bisher wurden sie alle 30 s per HTTP nachgezogen, weil
der Miniserver über den WebSocket nur Bausteine mit Visu-Häkchen pusht. Jetzt gibt es einen
zweiten Weg, den der Miniserver selbst anbietet: ein Logger-Objekt mit UDP-Adresse.
Hinzugefügt
-
UDP-Push-Kanal (
udp_push.py). Die Integration lauscht auf einem UDP-Port (Option
„UDP-Port für Echtzeitwerte", Vorgabe55555,0= aus) und speist jedes Datagramm
<Zeit>;<Logger>;<Klemmen-UUID>;<Wert>in denselben Event-Bus, den der WebSocket-Stream
nutzt. Die Entities merken keinen Unterschied. Angenommen werden nur UUIDs, die als
Control bekannt sind; unveränderte Werte werden verworfen (analoge Eingänge melden auch
Rauschen unterhalb der Anzeigeauflösung — ein unbelegter 0-10-V-Eingang lieferte ~1
Datagramm je Sekunde).Gemessen am Demo-Koffer (Miniserver Gen 2, FW 17.1.6.30):
Latenz Schaltbefehl → Datagramm in HA 12–20 ms Impulse 20 ms und länger vollständig (Ein und Aus) Impulse 10 ms (ein SPS-Zyklus) teils verloren — SPS-Grenze, kein Logger-Problem Broadcast-Ziel ( 192.168.0.255,255.255.255.255)funktioniert — der Miniserver muss die HA-Adresse nicht kennen SD-Karte kein Schreibzugriff, /logbleibt unverändert -
Einrichtung im Miniserver-Programm übernimmt das Skript
ha_udp_logger.pyaus dem
Loxone-Config-Skill: Es zieht das Programm
aus dem Miniserver, legt ein Logger-Objekt/dev/udp/<HA-IP>/<Port>und eine Seite
„HA UDP" mit einer Logger-Referenz je Klemme an und lädt das Programm zurück — genau so,
wie Loxone Config speichert (/prog/sps_new.zip+dev/sps/restart). Wichtig: Die
Zuweisung direkt an der Klemme (<LoggerMailer>im Klemmenobjekt) wertet der Miniserver
nicht aus; nur die Referenz auf einer Seite (OutputRefLM) sendet. -
Tests für Parser und Protokoll (
tests/test_udp_push.py, ohne Home Assistant lauffähig).
Geändert
- Das 30-s-Polling bleibt als Rückfallebene bestehen: Es fängt verlorene Datagramme und
Klemmen ohne Logger-Referenz (unverdrahtete Ausgänge haben keine Quelle, die man
referenzieren könnte).
Bekannte Grenzen
- Beim Programmstart schickt der Miniserver kein Gesamtabbild, nur Klemmen, deren Wert sich
beim Start ändert. Die Startwerte kommen weiterhin per HTTP. - Farbwerte (
<v.col>) rendert der Logger als0; solche Ausgänge legt die Discovery ohnehin
nicht an.