Integrationen

Loxone Miniserver einrichten

Miniserver und ausgewählte Statuswerte ohne Weitergabe lokaler Zugangsdaten prüfen.

Voraussetzungen

• Loxone Miniserver im lokalen Netz
• Lokaler, dauerhaft laufender Connector oder ausgehender virtueller HTTP-Ausgang
• HomePulse-Loxone-Integration und API-Key

Schritt für Schritt

1. Lege einen lokalen technischen Loxone-Benutzer mit reinen Leserechten an, falls Werte abgefragt werden.
2. Speichere Token/Zugang nur lokal in einer geschützten Environment-Datei.
3. Prüfe lokal die dokumentierte Miniserver-Schnittstelle beziehungsweise den Webhook.
4. Sende Heartbeat und ausgewählte virtuelle Ein-/Ausgänge an HomePulse.
5. Teste anschließend die Integration und einen bewusst ungefährlichen Testwert.

Beispielkonfiguration

# Lokaler Bridge-Ablauf (Pseudocode)
every 60 seconds:
  miniserver = GET http://MINISERVER/jdev/sys/getversion
  POST https://www.homepulse.at/api/ingest/loxone/heartbeat
    X-HomePulse-Key: hp_live_DEIN_KEY
    {"apiVersion":"2026-08-01","siteId":"DEINE-STANDORT-GUID",
     "source":"loxone","sourceVersion":"bridge-1.0",
     "sentAtUtc":"2026-08-07T18:30:00Z","status":"online","uptimeSeconds":583920}

# Snapshot-Elemente
{"externalId":"loxone.miniserver","name":"Miniserver","type":"gateway","status":"online","isCritical":true}
{"externalId":"loxone.heating.fault","name":"Heizung Status","type":"virtual-output","status":"online"}

Testschritt

POST /api/ingest/loxone/verify mit dem HomePulse-Key testen, dann lokalen Miniserver-Zugriff unterbrechen und kontrolliert einen offline-Heartbeat senden.

Erwartetes Ergebnis

Letzte Übertragung ist aktuell; Miniserver und ausgewählte Controls erscheinen getrennt, ohne Benutzername/Token.

Fehlerbehebung

• Miniserver antwortet 401: lokalen Token-/Berechtigungsstatus prüfen, nicht in HomePulse ändern.
• Webhook kommt nicht an: DNS, TLS und virtuelle Ausgangsbefehle kontrollieren.
• Wert fehlt: UUID/Control-Bezeichnung und reine Leseberechtigung prüfen.

Sicherheitshinweise

• Miniserver-Zugangsdaten niemals in Snapshot oder HomePulse-Einstellungen eintragen.
• Lese-Benutzer und Netzwerkzugriff auf Connector-IP begrenzen.
• Keine Präsenz-, Tür- oder Bewegungswerte übertragen, sofern sie nicht zwingend für den Healthcheck nötig sind.