Skip to content

Releases: smartmacherei/Loxone-Integration

1.3.6 – Reload lifecycle cleanup

Choose a tag to compare

@DFRNT691 DFRNT691 released this 09 Sep 12:29

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

Choose a tag to compare

@DFRNT691 DFRNT691 released this 09 Sep 12:24

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

Choose a tag to compare

@DFRNT691 DFRNT691 released this 09 Sep 12:05

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

Choose a tag to compare

@DFRNT691 DFRNT691 released this 09 Sep 12:00

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

Choose a tag to compare

@DFRNT691 DFRNT691 released this 05 Sep 15:59

Behoben

  • Der Sensor „Loxone Software Version" verdoppelte sich nach jedem Miniserver-Update. Seine
    unique_id enthielt die Firmware-Version (<Seriennummer>-17.1.6.30). Nach einem Update legte
    Home Assistant deshalb einen neuen Sensor sensor.loxone_software_version_2 an, der alte blieb
    für immer unavailable im Entitätsregister. Die unique_id ist 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

Choose a tag to compare

@DFRNT691 DFRNT691 released this 05 Sep 14:51

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", Vorgabe 55555, 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, /log bleibt unverändert
  • Einrichtung im Miniserver-Programm übernimmt das Skript ha_udp_logger.py aus 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 als 0; solche Ausgänge legt die Discovery ohnehin
    nicht an.