Integrationen
Home-Assistant-Integration
SpacePC-Integration installieren, lokale Geräte erkennen und die Verbindung mit Home Assistant einrichten und prüfen.
Aufgabe der Integration
Die SpacePC-Integration verbindet kompatible Firmware direkt über das lokale Netzwerk mit Home Assistant. Geräte kündigen _spacepc._tcp.local. per mDNS an und stellen die versionierte SpacePC Local API bereit. Weder Cloudkonto noch MQTT-Broker sind erforderlich. MQTT kann für andere Systeme unabhängig aktiviert werden.
Eine Integration unterstützt unterschiedliche SpacePC-Projekte. Home Assistant erzeugt die Entitäten aus den gemeldeten Gerätefunktionen, darunter Sensoren, Binärsensoren, Schalter, Leuchten, Lüfter, Diagnosewerte und Firmware-Updates, sofern die Firmware sie bereitstellt.
Voraussetzungen
Home Assistant 2026.5 oder neuer
SpacePC-Integration 0.1.3 oder neuer
SpacePC-Firmware mit Local API v1 und mDNS-Erkennung
Netzwerk mit lokalem HTTP- und mDNS-Verkehr zwischen Home Assistant und Gerät
Abgeschlossene WLAN-Einrichtung des SpacePC-Geräts
Installation mit HACS
HACS in Home Assistant öffnen.
https://github.com/spacepc-de/home-assistant-spacepc als benutzerdefiniertes Repository der Kategorie Integration hinzufügen oder https://my.home-assistant.io/redirect/hacs_repository/?owner=spacepc-de&repository=home-assistant-spacepc&category=integration öffnen.
Die neueste stabile SpacePC-Version installieren.
Home Assistant neu starten, sobald HACS dazu auffordert.
Einstellungen → Geräte & Dienste öffnen und das gefundene Gerät bestätigen.
Manuelle Installation
custom_components/spacepc aus dem Repository nach config/custom_components/spacepc kopieren und Home Assistant neu starten. Danach Einstellungen → Geräte & Dienste → Integration hinzufügen → SpacePC öffnen. HACS wird wegen der Update-Hinweise empfohlen. Nicht beide Installationsarten gleichzeitig verwenden.
Gerät vorbereiten und erkennen
Kompatible SpacePC-Firmware über den Browser-Flasher installieren.
WLAN-Einrichtung des Geräts abschließen und den Neustart abwarten.
Gerät und Home Assistant in einem Netzwerk betreiben, das lokalen HTTP- und mDNS-Verkehr erlaubt.
Das gefundene SpacePC-Gerät unter Einstellungen → Geräte & Dienste bestätigen.
Die Integration speichert den stabilen mDNS-Hostnamen. Vergibt DHCP eine neue IP-Adresse, aktualisiert Discovery die Verbindung und baut den lokalen API-Client neu auf.
Manuelle Einrichtung
Integration hinzufügen → SpacePC wählen und Hostnamen oder aktuelle IP-Adresse eintragen. Wenn möglich den Hostnamen verwenden. Die SpacePC Local API muss auch bei manueller Einrichtung erreichbar sein.
Entitäten und Geräteseite
Die Entitäten hängen von den Firmware-Funktionen ab. Das DS18B20-Projekt erzeugt pro aktiviertem Fühler eine Temperatur-Entität. Andere Projekte können Binärsensoren, Schalter, Leuchten, Lüfter, Diagnosewerte und Firmware-Updates bereitstellen. Die Geräteseite enthält die aktuelle IP-Adresse und einen Link zur lokalen SpacePC-Weboberfläche, sofern die Firmware diese Angaben liefert.
Lokaler Betrieb und MQTT
Die native Integration benötigt weder Cloudzugang noch Broker. MQTT bleibt für andere Systeme optional. Doppelte MQTT-Discovery-Entitäten vermeiden, wenn nicht bewusst beide Integrationswege benötigt werden.
Aktualisierungen
Updates der Integration über HACS installieren und Home Assistant neu starten, wenn dies verlangt wird. Firmware bleibt projekt- und hardwarespezifisch. Die richtige ESP32-Familie auswählen und prüfen, ob Einstellungen gelöscht werden.
Fehlerbehebung
Gerät wird nicht gefunden
Prüfen, ob die Einrichtung abgeschlossen ist und mDNS erlaubt wird. Gastnetze, Client-Isolation und manche VLAN-Regeln blockieren Multicast-Erkennung.
Manuelle Einrichtung kann keine Verbindung herstellen
Die lokale Geräteoberfläche im selben Netzwerk öffnen, die aktuelle IP im Router prüfen und lokalen HTTP-Verkehr erlauben. Ein erfolgreicher Ping beweist nicht, dass die Local API verfügbar ist.
Gerät ist nach einem IP-Wechsel nicht verfügbar
Die aktuelle Integrationsversion verwenden und mDNS im Netzwerksegment ermöglichen. Discovery aktualisiert veraltete Verbindungsdaten automatisch.
Eine Sensor-Entität ist nicht verfügbar
GPIO und physischen Sensor in der lokalen Geräteoberfläche prüfen. Bei DS18B20-Fühlern VDD, GND, DATA und den externen 4,7-kΩ-Pull-up kontrollieren. Fehlende Sensoren werden bewusst als nicht verfügbar gemeldet.
Entfernen oder neu installieren
Den SpacePC-Eintrag unter Einstellungen → Geräte & Dienste entfernen und über Discovery oder manuell erneut hinzufügen. Home Assistant nach Entfernen oder erneuter Installation des HACS-Pakets neu starten.