Fehlersuche
Keine Verbindung
Prüfe zuerst, ob URL HTTPS verwendet, die Geräte-Entity online ist und Revision/ACK steigen. Bei Handshake failed: Datum/Uhrzeit des Geräts, CA-Vertrauen, DNS und Routing prüfen. Für geroutete Geräte den Connect-Host auf eine erreichbare HA-IP setzen. Nur im isolierten Altgerätenetz die unsichere Zertifikatsoption aktivieren. Meldet die App einen geänderten Schlüssel, den angezeigten Fingerprint prüfen und bestätigen; wiederholte Reconnects sind dann absichtlich pausiert.
Konfiguration oder Vorschau
Parse-Fehler erscheinen im JSON-Editor. Veröffentlichung scheitert bei doppelten IDs, unbekannter tab_order-ID, Secret-Feld oder fehlendem Provider. Bei falschem Layout Gerät, Orientierung und Zoom Anpassen wählen. Die Vorschau zeigt feste Android-Geometrie; Detailunterschiede in Schrift und nativer Steuerung sind normal. Fehlende Bilder werden neutral ersetzt und beeinflussen das Raster nicht.
Assist
Mikrofonberechtigung, voice_assistant.enabled, Pipeline, Wakeword-Engine und ausgewähltes active_wake_words prüfen. Erreicht ein langer Satz HA nicht, Kontrollkanal-Onlinezustand und separaten Voice-Stream prüfen; Transport-Pings sind deaktiviert, Anwendungs-Heartbeats müssen weiterlaufen. Bei sehr leiser Ausgabe Medienlautstärke, audio_route, TTS-Ausgabe und Statussound-Lautstärke prüfen.
Kamera, Immich und MA
Kamera benötigt Berechtigung und aktivierte Kamera-Konfiguration; eine physisch verdeckte Wandkamera liefert erwartungsgemäß Schwarz. Bei Tunnelproblemen direkten LAN-Modus testen. Immich-HTTP 400 weist meist auf URL/API-Version oder Suchfilter hin; Provider-Verbindung serverseitig testen. Bei MA zuerst prüfen, ob offizielle Integration, Zielplayer und Provider-Binding verfügbar sind.
Logs und Diagnose
HA: Einstellungen → System → Protokolle, Logger custom_components.rustyhama; Gerätestatus und redigierte Diagnose über die Integrationskarte. Android mit ADB: adb logcat --pid=$(adb shell pidof net.spittank.home.rustyhama). In Fehlerberichten keine Credentials, Pairing-Tokens, Provider-Keys oder vollständigen privaten URLs weitergeben.