August / Yale Smart-Home-Integration, kostenlos und Open Source

Smarte Schlösser und Video-Türklingeln von August und Yale über die August-/Yale-Cloud.

• Veröffentlicht von gboulvin
• Geräte
• Version 1.0.0
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Diese Integration bringt Ihre smarten Schlösser und Video-Türklingeln von August und Yale in Gladys Assistant — über die August-/Yale-Cloud, die auch die offiziellen Apps verwenden.

Was Sie erhalten

Gerät	In Gladys
Smartes Schloss	Verriegeln / Entriegeln, Batterie, Tür offen / geschlossen (DoorSense), Batterie der Tastatur
Video-Türklingel	Letztes Bild (Kamera), Klingeln, Bewegung, Batterie

Zusätzlich zu den Geräten:

• Szenen-Auslöser: Schloss betätigt (Filter nach Schloss, Aktion — verriegelt, entriegelt, geöffnet — und Art: App, aus der Ferne, Tastatur, von Hand, automatische Verriegelung, Fingerabdruck, Schlüsselanhänger; der Benutzername steht als Variable zur Verfügung), Schloss blockiert, Türklingel gedrückt, Bewegung an der Türklingel.
• Szenen-Aktionen: Eine Tür verriegeln, Eine Tür entriegeln, Eine Tür öffnen (Falle ziehen), Bild der Türklingel aufnehmen. Jede meldet, ob sie erfolgreich war, damit die folgenden Aktionen davon abhängen können.
• Dashboard-Widgets: Smart Lock (ein Schloss mit seinen Tasten oder eine Übersicht aller Schlösser mit der Taste „Alles verriegeln“), Video-Türklingel (letztes Bild, letztes Klingeln und letzte Bewegung), Türaktivität (wer was wie und wann getan hat).

Unterstützte Modelle: alle Schlösser und Türklingeln der Apps August, Yale Access und Yale Home — August Smart Lock (alle Generationen), 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…

Voraussetzungen

• Gladys Assistant 5.1 oder neuer.
• Ein Konto in der App August, Yale Access oder Yale Home, in dem Ihre Geräte bereits eingerichtet sind.
• Um den Zustand live zu sehen und ein Schloss über Gladys zu steuern, muss das Schloss für die Cloud erreichbar sein: über eine WLAN-Bridge (August Connect, Yale Connect Wi-Fi Bridge) oder ein Schloss mit integriertem WLAN. Ohne Bridge wird das Schloss mit einem orangefarbenen Punkt angezeigt: Sein Zustand wird nur aktualisiert, wenn ein Telefon mit der App es per Bluetooth erreicht.

Die Integration arbeitet nur über die Cloud: Der Gladys-Container hat keinen Bluetooth-Zugriff, eine lokale Steuerung ist daher nicht möglich.

Einrichtung

1. Öffnen Sie Integrationen → August / Yale → Konfiguration.
2. Wählen Sie die App, in der Ihre Schlösser registriert sind:
   • August — die August-App;
   • Yale Access — die Yale-Access-App (Nordamerika);
   • Yale Home — die Yale-Home-App (Europa und übrige Welt).
3. Wählen Sie die Anmeldemethode (E-Mail oder Telefonnummer), geben Sie Benutzername und Passwort Ihres Kontos ein und speichern Sie.
4. Beim ersten Mal sendet die Cloud einen Bestätigungscode per E-Mail oder SMS. Geben Sie ihn in der Aktion Code bestätigen der Konfigurationsseite ein. Nicht erhalten? Verwenden Sie Neuen Code senden.
5. Öffnen Sie den Tab Erkennung: Ihre Schlösser und Türklingeln werden aufgelistet. Legen Sie sie an.

Der Code wird nur einmal abgefragt: Die Sitzung wird im Speicher der Integration aufbewahrt. Ein Wechsel des Kontos oder der App erfordert einen neuen Code.

Optionen

• Echtzeit-Ereignisse (standardmäßig an): Die Ereignisse (Schloss betätigt, Türklingel gedrückt…) kommen über den Kanal der Apps in wenigen Sekunden an. Ausgeschaltet wird die Aktivität jede Minute gelesen.
• Entriegeln über Gladys erlauben (standardmäßig an): Schalten Sie es aus, damit Gladys verriegeln, aber niemals entriegeln oder eine Tür öffnen kann — die Widgets zeigen dann nur die Taste „Verriegeln“, und die Entriegelungs-Aktionen werden abgelehnt.
• Aktualisierungsintervall: wie oft alle Geräte neu gelesen werden (standardmäßig 5 Minuten, mindestens 1 Minute).

Werte

• Schloss: 1 = verriegelt, 0 = entriegelt (eine geöffnete Falle ergibt 0).
• Tür: 1 = geschlossen, 0 = offen.
• Klingeln und Bewegung: 1 für einige Sekunden, dann zurück auf 0.

Fehlerbehebung

• „Anmeldung abgelehnt“: Prüfen Sie die App (August / Yale Access / Yale Home), die Anmeldemethode und das Passwort. Melden Sie sich zur Kontrolle mit denselben Daten in der App an.
• Kein Code erhalten: Prüfen Sie den Spam-Ordner und verwenden Sie dann Neuen Code senden. Eine Telefonnummer muss im internationalen Format angegeben werden (z. B. +4915112345678).
• Ein Schloss ist nicht erreichbar: Seine WLAN-Bridge ist offline. Prüfen Sie Stromversorgung und WLAN.
• Yale-Home-Konten: Yale stellt die Yale-Home-Konten schrittweise auf ein neues Anmeldesystem um. Wird die Anmeldung abgelehnt, obwohl die Daten in der App funktionieren, eröffnen Sie bitte ein Issue im Repository.
• Mit Verbindung testen wird das Konto neu gelesen und angezeigt, wie viele Schlösser und Türklingeln gefunden wurden. Die Protokolle der Integration (Gladys → Einstellungen → System → Integrationen) verraten mehr; sie enthalten niemals Ihr Passwort oder Ihr Token.

Datenschutz und Sicherheit

Das Passwort bleibt in der Gladys-Konfiguration; das Sitzungstoken wird im privaten Volume der Integration gespeichert. Kontaktiert werden nur die August-/Yale-Cloud, ihr Echtzeitdienst (PubNub) und der Bild-Host der Türklingeln (Cloudinary). Melden Sie Sicherheitsprobleme vertraulich, siehe SECURITY.md im Repository.

Konfigurationseinstellungen

Diese Einstellungen fragt August / Yale in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Ihr August-/Yale-Konto	section	Nein	Verwenden Sie das Konto der App August, Yale Access oder Yale Home. Bei der ersten Verbindung sendet Ihnen die Cloud einen Bestätigungscode per E-Mail oder SMS: Geben Sie ihn unten mit der Aktion „Code bestätigen“ ein. Eine WLAN-Bridge (August Connect, Yale Connect) oder ein WLAN-Schloss ist nötig, um den Zustand live zu sehen und das Schloss über Gladys zu steuern.
App	select	Ja	Die App, in der Ihre Schlösser registriert sind.
Anmeldemethode	select	Ja
E-Mail oder Telefonnummer	string	Ja	Eine Telefonnummer im internationalen Format, z. B. +4915112345678.
Passwort	secret	Ja
Optionen	section	Nein	Der Echtzeitkanal liefert die Ereignisse (Schloss betätigt, Türklingel gedrückt) in wenigen Sekunden; das Aktualisierungsintervall liest alle Geräte im Hintergrund neu ein.
Echtzeit-Ereignisse	boolean	Nein
Entriegeln über Gladys erlauben	boolean	Nein	Ausgeschaltet kann Gladys verriegeln, aber nie entriegeln oder eine Tür öffnen.
Aktualisierungsintervall (s)	number	Nein	Wie oft alle Geräte neu gelesen werden, in Sekunden (mindestens eine Minute).

So installierst du August / Yale in Gladys

1. Öffne in Gladys Integrationen: August / Yale erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gboulvin/gladys-august-yale:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-August-Yale.

August / Yale benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

August / Yale ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂