Aller au contenu principal

Intégration domotique August / Yale, gratuite et open source

Intégration August / Yale pour Gladys Assistant

Serrures connectées et sonnettes vidéo August et Yale, via le cloud August / Yale.

Voir sur GitHubToutes les intégrations

Cette intégration amène vos serrures connectées et sonnettes vidéo August et Yale dans Gladys Assistant, via le cloud August / Yale — celui qu'utilisent les applications officielles.

Ce que vous obtenez​

AppareilDans Gladys
Serrure connectéeCommande verrouiller / déverrouiller, batterie, porte ouverte / fermée (DoorSense), batterie du clavier
Sonnette vidéoDernière image (caméra), sonnerie, mouvement, batterie

En plus des appareils :

  • Déclencheurs de scène : Serrure manœuvrée (filtre sur la serrure, l'action — verrouillée, déverrouillée, ouverte — et la manière : application, à distance, clavier, à la main, verrouillage automatique, empreinte, badge ; le nom de l'utilisateur est disponible en variable), Serrure bloquée, Sonnette pressée, Mouvement devant la sonnette.
  • Actions de scène : Verrouiller une porte, Déverrouiller une porte, Ouvrir une porte (tirer le pêne), Capturer une image de la sonnette. Chacune indique si elle a réussi, pour conditionner les actions suivantes.
  • Widgets du tableau de bord : Serrure (une serrure et ses boutons, ou la vue d'ensemble de toutes les serrures avec un bouton « Tout verrouiller »), Sonnette vidéo (dernière image, dernier coup de sonnette et dernier mouvement), Activité des portes (qui a fait quoi, comment et quand).

Modèles pris en charge : toutes les serrures et sonnettes gérées par les applications August, Yale Access et Yale Home — August Smart Lock (toutes générations), August Wi-Fi Smart Lock, Yale Linus, Yale Linus L2, Yale Assure Lock / Assure Lock 2, Yale Conexis L2, Yale Unity, August View, Yale Smart Video Doorbell…

Prérequis​

  • Gladys Assistant 5.1 ou plus récent.
  • Un compte dans l'application August, Yale Access ou Yale Home, avec vos appareils déjà installés.
  • Pour suivre l'état en direct et piloter une serrure depuis Gladys, la serrure doit être joignable par le cloud : un pont Wi-Fi (August Connect, Yale Connect Wi-Fi Bridge) ou une serrure Wi-Fi intégrée. Sans pont, la serrure apparaît avec un point orange : son état n'est mis à jour que lorsqu'un téléphone équipé de l'application la croise en Bluetooth.

L'intégration fonctionne uniquement via le cloud : le conteneur de Gladys n'a pas accès au Bluetooth, le pilotage local n'est donc pas disponible.

Configuration​

  1. Ouvrez Intégrations → August / Yale → Configuration.
  2. Choisissez l'application dans laquelle vos serrures sont enregistrées :
    • August — l'application August ;
    • Yale Access — l'application Yale Access (Amérique du Nord) ;
    • Yale Home — l'application Yale Home (Europe et reste du monde).
  3. Choisissez la méthode de connexion (e-mail ou numéro de téléphone), saisissez l'identifiant et le mot de passe de votre compte, puis enregistrez.
  4. La première fois, le cloud envoie un code de vérification par e-mail ou SMS. Saisissez-le dans l'action Valider le code de l'écran de configuration. Pas reçu ? Utilisez Envoyer un nouveau code.
  5. Ouvrez l'onglet Découverte : vos serrures et sonnettes y sont listées. Créez-les.

Le code n'est demandé qu'une fois : la session est conservée dans le stockage de l'intégration. Changer de compte ou d'application redemande un code.

Options​

  • Événements en temps réel (activé par défaut) : les événements (serrure manœuvrée, sonnette pressée…) arrivent en quelques secondes par le canal qu'utilisent les applications. Désactivé, l'activité est lue chaque minute.
  • Autoriser le déverrouillage depuis Gladys (activé par défaut) : désactivez-le pour garantir que Gladys peut verrouiller mais jamais déverrouiller ni ouvrir une porte — les widgets n'affichent alors que le bouton « Verrouiller » et les actions de scène de déverrouillage sont refusées.
  • Intervalle de rafraîchissement : fréquence de relecture de tous les appareils (5 minutes par défaut, 1 minute minimum).

Valeurs​

  • Serrure : 1 = verrouillée, 0 = déverrouillée (une porte ouverte par le pêne vaut 0).
  • Porte : 1 = fermée, 0 = ouverte.
  • Sonnerie et mouvement : 1 pendant quelques secondes, puis retour à 0.

Dépannage​

  • « Connexion refusée » : vérifiez l'application (August / Yale Access / Yale Home), la méthode de connexion et le mot de passe. Connectez-vous à l'application avec les mêmes identifiants pour en avoir le cœur net.
  • Aucun code reçu : regardez dans les spams, puis utilisez Envoyer un nouveau code. Un numéro de téléphone doit être au format international (ex. +33612345678).
  • Une serrure apparaît injoignable : son pont Wi-Fi est hors ligne. Vérifiez son alimentation et son Wi-Fi.
  • Comptes Yale Home : Yale migre progressivement les comptes Yale Home vers un nouveau système de connexion. Si la connexion est refusée alors que les identifiants fonctionnent dans l'application, ouvrez une issue sur le dépôt.
  • Utilisez Tester la connexion pour relire le compte et voir combien de serrures et de sonnettes ont été trouvées. Les logs de l'intégration (Gladys → Paramètres → Système → Intégrations) en disent plus ; ils ne contiennent jamais votre mot de passe ni votre jeton.

Confidentialité et sécurité​

Le mot de passe reste dans la configuration de Gladys ; le jeton de session est stocké dans le volume privé de l'intégration. Seuls le cloud August / Yale, son service temps réel (PubNub) et l'hébergeur des images des sonnettes (Cloudinary) sont contactés. Signalez un problème de sécurité en privé, voir SECURITY.md dans le dépôt.

Paramètres de configuration​

Voici les paramètres demandés par August / Yale dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre compte August / YalesectionNonUtilisez le compte de l'application August, Yale Access ou Yale Home. À la première connexion, le cloud vous envoie un code de vérification par e-mail ou SMS : saisissez-le avec l'action « Valider le code » ci-dessous. Un pont Wi-Fi (August Connect, Yale Connect) ou une serrure Wi-Fi est nécessaire pour suivre l'état en direct et piloter la serrure depuis Gladys.
ApplicationselectOuiL'application dans laquelle vos serrures sont enregistrées.
Méthode de connexionselectOui
E-mail ou numéro de téléphonestringOuiUn numéro de téléphone au format international, ex. +33612345678.
Mot de passesecretOui
OptionssectionNonLe canal temps réel apporte les événements (serrure manœuvrée, sonnette pressée) en quelques secondes ; l'intervalle de rafraîchissement relit tous les appareils en arrière-plan.
Événements en temps réelbooleanNon
Autoriser le déverrouillage depuis GladysbooleanNonDésactivé, Gladys peut verrouiller mais jamais déverrouiller ni ouvrir une porte.
Intervalle de rafraîchissement (s)numberNonFréquence de relecture de tous les appareils, en secondes (une minute minimum).

Comment installer August / Yale dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : August / Yale apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/gboulvin/gladys-august-yale:1.0.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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/gboulvin/Gladys-August-Yale.

August / Yale 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​

August / Yale 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 gboulvin, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le