Erste Schritte

Voraussetzungen

Benötigt werden Home Assistant 2026.7+, die RustyHAMA-Integration, ein HTTPS-Endpunkt und ein Android-Gerät ab API 17. HA und Gerät müssen sich gegenseitig erreichen können; bevorzuge die direkte lokale HA-Adresse. Kamera und Voice benötigen Kamera- beziehungsweise Mikrofonrecht. Standort wird nicht angefordert.

Installation

Füge https://github.com/narolinus/RustyHAMA-integration in HACS als benutzerdefiniertes Repository der Kategorie Integration hinzu. Installiere RustyHAMA, starte HA neu und füge RustyHAMA unter Einstellungen → Geräte & Dienste hinzu. Installiere anschließend die signierte APK aus dem RustyHAMA-F-Droid-Repository. Eine Debug-APK hat eine andere Signatur und ersetzt eine Release-APK nicht ohne Deinstallation.

Pairing

Lege im Panel unter Devices ein Gerät mit Name, Profil und HA-Bereich an. Der achtstellige Code ist zehn Minuten gültig und nach fünf Fehlversuchen gesperrt. Gib HA-URL und Code ein oder scanne den QR-Code. Kann ein altes Gerät den HA-Namen nicht auflösen oder routen, trage zusätzlich unter Verbindungs-IP/Host überschreiben die erreichbare IP ein. Die URL bleibt für Host-Header und TLS-SNI erhalten; nur das Verbindungsziel ändert sich. Ein erfolgreiches Pairing aktiviert den Foreground-Service und lädt die veröffentlichte Konfiguration atomar. Dashboard, Kamera, Voice, MediaPlayer und Gerätename werden danach ausschließlich in HA konfiguriert.

HA-URL, Verbindungs-IP/Host-Override und die lokale Zertifikatsausnahme bleiben auch nach dem Pairing unter Einstellungen → Lokale Verbindungswiederherstellung editierbar. Das ist insbesondere für geroutete Geräte- und Telefonienetze gedacht. Verbindung speichern und vollständig neu starten beendet alle bestehenden HA-, Assist- und Provider-Verbindungen und baut sie mit dem neuen Ziel neu auf; erneutes Pairing ist nicht erforderlich. Verwende nach Möglichkeit weiterhin den zertifizierten HTTPS-Namen als HA-URL und nur die im Gerätenetz erreichbare HA-IP als Override. Dann bleiben Host-Header, TLS-SNI und Zertifikatsname korrekt.

Zertifikat

Auf alten Android-Versionen verwendet die App einen eigenen Conscrypt-/OkHttp-Stack mit TLS 1.2 und kompatiblen Cipher Suites. Ist die Trustchain oder der Zertifikatsname nicht verwendbar, zeigt Trust and pin den SHA-256-Fingerprint des aktuellen Leaf-Zertifikats, speichert nach Bestätigung aber den stabileren SPKI-Pin des öffentlichen Schlüssels. Ein echter Schlüsselwechsel pausiert die Verbindung und fordert eine neue Bestätigung. Falls selbst dieser Ablauf scheitert, kann Unsicheres Zertifikat akzeptieren aktiviert werden. Diese ausdrücklich unsichere Option deaktiviert Trustchain- und Hostnamenprüfung und darf nur in einem vertrauenswürdigen lokalen Netz verwendet werden.

Erster Start

Öffne Dashboard, wähle Profil und Gerät, bearbeite den Entwurf und veröffentliche ihn. Die App lädt eine neue Revision sofort; ein manueller Neustart ist nicht nötig. Die Vorschau verwendet die zuletzt gemeldete Gerätegeometrie und lässt sich separat vergrößern. Prüfe danach Online/Last Seen, einen HA-Schalter, Verlauf, Provider und Assist. Zusätzliche Hardware-Sensoren und MediaPlayer bleiben standardmäßig deaktiviert.