Intégration de l'assistant à domicile

⚠️ Il s'agit d'une intégration officiellement prise en charge, disponible via HACS.
Elle nécessite un système in.touch 3 ou in.touch 3+ actif ainsi qu'un compte Gecko.

Avant de commencer

• Une installation Home Assistant opérationnelle (version 2023.1 ou ultérieure recommandée)

• HACS (Home Assistant Community Store) installé sur votre instance Home Assistant

• Un module in.touch 3 ou in.touch 3+ installé et appairé, et votre spa visible et en ligne dans l'Gecko app

• Un compte Gecko avec votre spa déjà configuré

⚠️ Remarque sur la compatibilité : cette intégration fonctionne uniquement avec les systèmes in.touch 3. Elle n'est pas compatible avec in.touch 2. Si vous ne savez pas quelle version vous possédez, consultez Comment faire la différence entre un in.touch 2 EN et un in.touch 3 EN ?.

Étape 1 : Ajoutez l'intégration à HACS

1. Ouvrez HACS depuis la barre latérale de Home Assistant.

2. Accédez à Intégrations.

3. Cliquez sur le menu ⋮ dans le coin supérieur droit, puis sélectionnez Référentiels personnalisés.

4. Dans le champ Référentiel, collez :
   https://github.com/geckoal/ha-gecko-integration

5. Définissez la Catégorie sur Intégration, puis cliquez sur Ajouter.

6. Recherchez Gecko dans la liste des intégrations HACS et cliquez sur Télécharger.

7. Redémarrez Home Assistant pour terminer l'installation.

Étape 2 : Ajouter l'intégration dans Home Assistant

1. Allez dans Paramètres → Appareils et services.

2. Cliquez sur + Ajouter une intégration et recherchez Gecko.

3. Cliquez sur l'intégration Gecko pour ouvrir la procédure de configuration.

Étape 3 : Connectez-vous à votre compte Gecko

1. Cliquez sur Continuer pour lancer la procédure de connexion.

2. Vous serez redirigé vers la page de connexion de Gecko. Saisissez l'adresse e-mail et le mot de passe de votre compte Gecko.

3. Autorisez Home Assistant à accéder à votre compte.

4. Vous serez automatiquement redirigé vers Home Assistant une fois la connexion terminée.

💡 Astuce : une fois connecté, votre spa est détecté automatiquement. Toutes les commandes et tous les capteurs apparaissent sous Paramètres → Appareils et services → Gecko.

🎉 C'est tout !

Ce que vous pouvez contrôler

L'intégration crée des entités dans Home Assistant pour chaque fonctionnalité contrôlable de votre spa :

• Température — Définissez votre température cible, surveillez la température actuelle de l'eau et suivez l'état du chauffage

• Éclairage — Contrôlez l'éclairage LED multizone indépendamment pour chaque zone disponible

• Pompes et soufflerie — Réglez la vitesse des pompes sur plusieurs zones et contrôlez la soufflerie

• Modes de traitement de l'eau — Basculez entre les modes Absent, Standard, Économie d'énergie et Week-end

• État de la connexion — Surveillez la connexion de votre passerelle et la puissance du signal RF

• État du cloud — Vérifiez si votre spa est connecté au cloud Gecko et reçoit les mises à jour

Dépannage

Si vous rencontrez des problèmes après l'installation, les étapes ci-dessous permettent de résoudre les problèmes les plus courants :

• L'intégration n'apparaît pas après l'installation — Redémarrez Home Assistant. Vérifiez également que le dossier custom_components/gecko existe bien dans votre répertoire config.

• Échec de la connexion — Vérifiez d'abord vos identifiants dans l'Gecko app. Si cela fonctionne, vérifiez que votre instance Home Assistant dispose d'un accès à Internet.

• Aucun spa détecté après la connexion — Assurez-vous que votre spa est en ligne dans l'Gecko app avant de commencer. La détection peut prendre 1 à 2 minutes.

• Les entités ne se mettent pas à jour ou affichent des valeurs obsolètes — Vérifiez le capteur de puissance du signal RF. Vous pouvez également recharger l'intégration sans redémarrage complet : Paramètres → Appareils et services → Gecko → ⋮ → Recharger.

💡 Astuce : la plupart des problèmes sont dus à un signal RF faible entre les modules CO (Spa) et EN (Home), ou à une coupure temporaire de la connexion au cloud. Vérifiez d'abord ces deux points sur Gecko app.

Pour les problèmes spécifiques à l'intégration elle-même, vous pouvez ouvrir un ticket sur l'Page GitHub Issues. Pour obtenir de l'aide concernant la configuration de votre in.touch 3 ou l'Gecko app, rendez-vous sur contacter le support Gecko.