Bien démarrer

Prérequis

Il faut Home Assistant 2026.7+, l’intégration RustyHAMA, un point d’accès HTTPS et un appareil Android à partir de l’API 17. HA et l’appareil doivent pouvoir se joindre ; préférez l’adresse HA locale directe. Caméra et voix exigent les autorisations caméra et microphone. La localisation n’est pas demandée.

Installation

Ajoutez https://github.com/narolinus/RustyHAMA-integration à HACS comme dépôt personnalisé de catégorie Intégration. Installez RustyHAMA, redémarrez HA et ajoutez RustyHAMA dans Paramètres → Appareils et services. Installez ensuite l’APK signée du dépôt F-Droid RustyHAMA. Une APK de débogage a une autre signature et ne remplace pas une APK de publication sans désinstallation.

Association

Sous Devices dans le panneau, créez un appareil avec nom, profil et zone HA. Le code à huit chiffres dure dix minutes et se verrouille après cinq erreurs. Saisissez l’URL HA et le code ou scannez le QR code. Si un ancien appareil ne peut pas résoudre ou router le nom HA, saisissez aussi l’IP joignable sous Remplacer l’IP/l’hôte de connexion. L’URL reste utilisée pour l’en-tête Host et le SNI TLS ; seule la cible change. L’association réussie active le service de premier plan et charge atomiquement la configuration publiée. Tableau de bord, caméra, voix, lecteur multimédia et nom de l’appareil sont ensuite configurés exclusivement dans HA.

L’URL HA, le remplacement de l’IP/l’hôte de connexion et l’exception locale de certificat restent modifiables après l’association sous Paramètres → Rétablissement local de la connexion. Cette fonction est notamment destinée aux réseaux d’appareils et de téléphonie routés. Enregistrer la connexion et redémarrer complètement ferme toutes les connexions HA, Assist et fournisseur existantes, puis les rétablit avec la nouvelle cible ; une nouvelle association n’est pas nécessaire. Dans la mesure du possible, conservez le nom HTTPS certifié comme URL HA et saisissez uniquement comme remplacement l’IP HA joignable depuis le réseau de l’appareil. L’en-tête Host, le SNI TLS et le nom du certificat restent ainsi corrects.

Certificat

Sur les anciennes versions Android, l’application utilise sa propre pile Conscrypt/OkHttp avec TLS 1.2 et des suites compatibles. Si la chaîne ou le nom est inutilisable, Trust and pin affiche l’empreinte SHA-256 du certificat feuille courant mais conserve après confirmation l’empreinte SPKI plus stable de la clé publique. Un vrai changement de clé suspend la connexion et demande une nouvelle confirmation. Si même ce parcours échoue, activez Accepter un certificat non sécurisé. Cette option explicitement dangereuse désactive chaîne et nom d’hôte et ne doit servir que sur un réseau local fiable.

Premier démarrage

Ouvrez Dashboard, sélectionnez profil et appareil, modifiez le brouillon puis publiez-le. L’application charge immédiatement une nouvelle révision ; aucun redémarrage manuel n’est nécessaire. L’aperçu utilise la dernière géométrie signalée et peut être agrandi séparément. Vérifiez ensuite Online/Last Seen, une commande HA, l’historique, les fournisseurs et Assist. Les capteurs matériels supplémentaires et le lecteur restent désactivés par défaut.