Intégration domotique eufy Security, gratuite et open source
Caméras, sonnettes, serrures, capteurs et mode d'armement HomeBase eufy Security.
Publiée par cicoub13
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Intégrez vos appareils eufy Security dans Gladys : caméras, sonnettes vidéo, serrures connectées, capteurs (ouverture, mouvement, fuite, fumée, CO) et mode d'armement des HomeBase. L'intégration passe par le cloud eufy, avec la librairie eufy-sdk.
Fonctionnalités
- Caméras et sonnettes : l'image publiée est la miniature envoyée par eufy à chaque détection ou appui sur la sonnette. Elle s'affiche dans la boîte caméra du tableau de bord. Une scène qui envoie l'image de la caméra sur un appui sonnette attend quelques secondes son arrivée.
- Sonnette : un appui passe la fonctionnalité « sonnette » à 1, puis elle revient à 0 au bout de 5 s.
- Mouvement : chaque détection passe le capteur de mouvement à 1, puis il revient à 0 au bout de 30 s sans nouvelle détection. Sont concernés les mouvements, personnes, inconnus, véhicules et animaux, sur les caméras comme sur les capteurs PIR.
- Serrures : verrouiller depuis Gladys, avec leur niveau de batterie. Le déverrouillage demande d'activer Autoriser le déverrouillage depuis Gladys dans la configuration : tout utilisateur, toute scène ou tout assistant vocal relié à Gladys pourrait alors ouvrir la porte.
- Capteurs : ouverture de porte ou de fenêtre, fuite d'eau, fumée, monoxyde de carbone, sirène active.
- HomeBase : lire et changer le mode d'armement (absent, à la maison, planning, personnalisé 1 à 3, désarmé…). Désarmé et Off demandent d'activer Autoriser le désarmement depuis Gladys dans la configuration.
- Batterie : niveau, charge en cours, alerte de batterie faible.
- Scènes : déclencheurs « Sonnette eufy pressée », « Mouvement détecté par eufy » (filtrable par personne, inconnu, véhicule ou animal), « Colis livré » et « Alarme eufy déclenchée ».
Prérequis
- Gladys 5.1 ou supérieur.
- Un compte eufy dédié à Gladys. eufy ne garde qu'une session par compte : utiliser votre compte principal vous déconnecterait de l'application. Créez un second compte, puis partagez-lui vos appareils depuis l'application eufy Security de votre compte principal (Paramètres > Famille et invités). Donnez-lui les droits administrateur pour piloter les serrures et le mode d'armement. Connectez-vous ensuite une fois avec le compte dédié dans l'application eufy Security pour accepter l'invitation, puis déconnectez-vous : vous connecter plus tard avec ce compte dans l'application déconnecterait Gladys.
Configuration
- Ouvrez l'onglet Configuration.
- Saisissez l'email, le mot de passe et le pays (code à 2 lettres, par exemple FR) du compte dédié, puis enregistrez.
- Lisez le statut de connexion en haut de l'écran :
- Connecté : passez à l'étape 4.
- Code de vérification : eufy vous a envoyé un code par email. Saisissez-le dans le champ Code de vérification, puis enregistrez.
- Captcha : ouvrez les Logs de l'intégration et copiez la ligne qui commence par
data:image/png;base64,dans la barre d'adresse de votre navigateur pour afficher l'image. Saisissez ensuite les 4 caractères dans le champ Réponse captcha, puis enregistrez. eufy peut demander ensuite un code de vérification. - Code non reçu, ou captcha illisible : enregistrez de nouveau le formulaire avec le champ vide, eufy en envoie un nouveau.
- L'intégration vide elle-même les champs code et captcha une fois utilisés. La session est conservée : un redémarrage ne redemande rien.
- Ouvrez l'onglet Découverte et créez les appareils souhaités.
Le bouton Tester la connexion indique l'état et le nombre d'appareils trouvés. Lister les appareils bruts écrit le modèle et les capacités de chaque appareil dans les logs : c'est utile pour signaler un appareil non pris en charge.
Dépannage
- Connecté, mais aucun appareil : les appareils ne sont pas partagés avec le compte dédié, ou l'invitation n'a pas été acceptée. Partagez-les depuis l'application eufy Security de votre compte principal, connectez-vous une fois avec le compte dédié dans l'application pour accepter, puis cliquez sur Tester la connexion.
- Code de vérification non reçu, ou captcha illisible : enregistrez de nouveau le formulaire avec le champ vide, eufy en envoie un nouveau.
- « eufy a refusé le code de vérification » : le code était erroné ou expiré. Enregistrez de nouveau le formulaire avec le champ vide pour en recevoir un nouveau.
- « Le compte eufy est temporairement bloqué » : trop de tentatives. Patientez sans enregistrer le formulaire (chaque tentative prolonge le blocage), puis enregistrez-le de nouveau.
- « Connecté à eufy, mais les événements temps réel n'ont pas pu démarrer » : l'intégration réessaie d'elle-même, avec un délai croissant. Si cela dure, vérifiez l'accès à internet du serveur Gladys.
- Déverrouillage ou désarmement refusé : activez Autoriser le déverrouillage depuis Gladys ou Autoriser le désarmement depuis Gladys dans la configuration.
- Pas d'image de caméra, ou une image ancienne : une image n'arrive qu'avec un événement de mouvement ou de sonnette. Une scène qui envoie l'image l'attend quelques secondes.
- Un appareil est absent : utilisez Lister les appareils bruts et ouvrez une issue avec ce qu'elle écrit. Ce contenu comprend les numéros de série de vos appareils : anonymisez-les avant de le partager.
Limites
- Pas de vidéo en direct : Gladys n'affiche que des images fixes.
- L'image d'une caméra n'est mise à jour qu'après un événement (mouvement ou sonnette). Gladys la considère comme expirée au bout d'une heure.
- La détection de fuite, de fumée et de CO dépend de ce qu'eufy remonte pour chaque modèle. Ces valeurs ne sont pas encore confirmées sur tous les appareils.
- Si la session eufy expire (par exemple parce que le compte s'est connecté ailleurs), l'intégration se reconnecte d'elle-même. eufy peut alors redemander un code ou un captcha.
Paramètres de configuration
Voici les paramètres demandés par eufy Security dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte eufy | section | Non | Utilisez un compte eufy dédié : créez-en un, puis partagez-lui vos appareils depuis l'application eufy Security (Paramètres > Famille et invités, avec les droits administrateur pour piloter serrures et mode d'armement), et connectez-vous une fois avec le nouveau compte dans l'application pour accepter l'invitation. eufy ne garde qu'une session par compte : se connecter avec votre compte principal vous déconnecterait de l'application. Le pays doit être celui du compte eufy. |
string | Oui | ||
| Mot de passe | secret | Oui | |
| Pays (code à 2 lettres) | string | Oui | |
| Autoriser le déverrouillage depuis Gladys | boolean | Non | Désactivé : les serrures peuvent être verrouillées depuis Gladys, pas déverrouillées. Activé : tout utilisateur, toute scène ou tout assistant vocal relié à Gladys peut ouvrir la porte. |
| Autoriser le désarmement depuis Gladys | boolean | Non | Désactivé : le mode d'armement ne peut pas passer à Désarmé ou Off depuis Gladys. Activé : tout utilisateur, toute scène ou tout assistant vocal relié à Gladys peut désarmer la HomeBase. |
| Uniquement si le statut de connexion le demande | section | Non | eufy peut demander un code de vérification (envoyé par email) ou un captcha à la première connexion. Saisissez la réponse dans le champ correspondant, puis enregistrez : l'intégration la transmet à la connexion en attente et vide le champ. Captcha : l'image est écrite dans les Logs de l'intégration, sur une ligne commençant par data:image/png;base64, — collez cette ligne dans la barre d'adresse de votre navigateur pour la voir. Code non reçu ou captcha illisible : enregistrez de nouveau avec le champ vide pour en recevoir un nouveau. |
| Code de vérification | string | Non | |
| Réponse captcha | string | Non |
Comment installer eufy Security dans Gladys
- Dans Gladys, ouvrez Intégrations : eufy Security apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/cicoub13/gladys-eufy:1.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/cicoub13/gladys-eufy.
eufy Security nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
eufy Security est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par cicoub13, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation