Files
Dual-PID/Home Assistant Erweiterung/Home Assistant-Anleitung.txt
T
raw-designs 453644816f Initiale Bereitstellung
Initiale Bereitstellung der aktuellen Version auf Gitea
2026-07-10 18:13:43 +02:00

96 lines
2.3 KiB
Plaintext

Home Assistant Anleitung fuer die Dual PID Custom Integration
1. Dateien kopieren
Kopiere den Ordner
custom_components\dual_pid
nach Home Assistant in:
/config/custom_components/dual_pid
Am Ende sollte es dort z.B. so aussehen:
- /config/custom_components/dual_pid/manifest.json
- /config/custom_components/dual_pid/__init__.py
- /config/custom_components/dual_pid/config_flow.py
2. Home Assistant neu starten
Danach Home Assistant komplett neu starten.
Ein reines "Automationen neu laden" reicht nicht, weil custom_components nur beim Start geladen werden.
3. Integration hinzufuegen
Dann in Home Assistant:
1. Einstellungen
2. Geraete & Dienste
3. Integration hinzufuegen
4. nach "Dual PID Espresso" suchen
Falls die Integration dort nicht auftaucht:
- pruefen, ob der Ordnername exakt dual_pid heisst
- pruefen, ob wirklich unter /config/custom_components/dual_pid kopiert wurde
- Home Assistant Protokoll oeffnen und nach dual_pid suchen
4. Konfiguration in der UI
Im Dialog eintragen:
- Name: frei waehlbar, z.B. "Espressomaschine"
- Host / IP-Adresse: z.B. 192.168.178.50
- Port: normalerweise 80
- Aktualisierungsintervall: z.B. 10 Sekunden
Wichtig:
Die Maschine muss im Netzwerk erreichbar sein und bereits die neue Firmware mit der API haben, also mindestens:
- GET /api/status
- POST /api/start
- POST /api/standby/on
- POST /api/standby/off
5. Nach erfolgreicher Einrichtung
Dann sollte in Home Assistant ein neues Geraet erscheinen mit Entitaeten wie:
- Standby
- Jetzt aufheizen
- Status
- Wasser Temperatur
- Wasser Sollwert
- Dampf Temperatur
- Dampf Sollwert
- diverse Binaersensoren wie Eco aktiv, Dampfverzoegerung aktiv, Zeit synchronisiert
6. Ins Dashboard aufnehmen
Am einfachsten:
1. Geraet oeffnen
2. "Zum Dashboard hinzufuegen"
3. gewuenschte Entitaeten auswaehlen
Oder manuell in einer Entities-Karte.
7. Wenn etwas nicht funktioniert
Zuerst diese Punkte pruefen:
- Browser-Test: http://DEINE-IP/api/status
- Es muss JSON zurueckkommen
- Wenn dort nichts kommt, liegt es an der Maschine/API, nicht an Home Assistant
Zusaetzlich in Home Assistant:
- Einstellungen > System > Protokolle
- nach dual_pid suchen
8. Typische Fehlerursachen
- falscher Zielpfad beim Kopieren
- falscher Ordnername
- Home Assistant nicht neu gestartet
- Maschine noch mit aelterer Firmware
- IP-Adresse geaendert
- Firewall oder Netzwerk blockiert den Zugriff