Suche

    Blink Home Client

    Dokumentation direkt aus GitHub Wilkware/BlinkHomeSystem ↗

    Version Product Version License Actions

    Symcon Modul für die zentrale Kommunikation mit den Blink Servern.

    1. Funktionsumfang

    Dieses Modul bildet die zentrale Kommunikation mit den Blink Servern ab.
    Dies erfolgt auf Basis der inoffizielle dokumentierten Client-API

    Derzeit unterstützt das Modul folgende Funktionalität:

    • Login, Verify (2FA) und Renewal
    • Zeitliche und manuelle Erstellung von Snapshots
    • Aktivieren und Deaktivieren von Motion Detection (Bewegungserkennung)
    • Arm (Scharf) und Disarm (Unscharf) stellen der Aufzeichnung bei Bewegungserkennung
    • Auslesen von gerätespezifischen Informationen (Homescreen)
    • Download von Videos/Clips (Cloud & Lokal)
    • Liveview (experimentell)

    Folgende Geräte wurden getestet:

    • Blink Sync Modul 2 (1st Gen & 2nd Gen)
    • Blink Outdoor (3rd Gen & 4th Gen)
    • Blink Indoor (1st Gen & 3rd Gen)
    • Blink Mini (1st Gen & 2nd Gen)
    • Blink Doorbell

    Wenn jemand noch andere Geräte im Einsatz hat, bitte einfach bei mir melden!

    2. Voraussetzungen

    • Symcon ab Version 8.1

    3. Installation

    • Über den Modul Store die Bibliothek Blink Home System installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/BlinkHomeSystem oder git://github.com/Wilkware/BlinkHomeSystem.git

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Blink Home Client-Modul unter dem Hersteller ‘Amazon’ aufgeführt.

    Konfigurationsseite:

    Einstellungsbereich:

    🔐 Konto-Informationen …

    NameBeschreibung
    Blink Account eMailRegistrierte Mail-Adresse bei Blink
    Blink Account KennwortHinterlegtes Kennwort

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Automatisch angemeldet bleibenAktiviert die automatische Verlängerung des Zugriffs-Tokens

    Aktionsbereich:

    🗝️ Anmelden und verifizieren am Blink Server …

    AktionBeschreibung
    ANMELDENSenden der Logindaten an Blink Server
    ÜBERPRÜFENSenden eines Codes zur Verifizierung der Login-Daten
    AKTUALISIERENZugriffs-Token erneut anfragen, aktualisieren und Ablaufzeit neu starten

    ❓ Abfrage von …

    AktionBeschreibung
    BenachrichtigungsoptionenAbrufen und Anzeigen der eingestellten Optionen

    5. Statusvariablen

    Es werden keine Statusvariablen angelegt.

    6. Darstellungen

    Es werden keine Darstellungen oder Profile benötigt.

    7. Visualisierung

    Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.

    8. Befehlsreferenz

    int BHS_Login(int $InstanzID);
    

    Versucht den Client mit den Account-Daten an den Blink-Servern anzumelden.
    Die Funktion liefert ‘0’ im Fehlerfall, ‘1’ im Erfolgsfall und ‘2’ im Verifizierungsfall.

    int BHS_Verify(int $InstanzID, string $Pin);
    

    Sendet den per Telefon oder Mail erhaltenen Verifizierungscode an die Blink-Server. Die Funktion liefert ‘1’ im Erfolgsfall, sonst ‘0’.

    int BHS_Refresh(int $InstanzID);
    

    Erneuert den Login Status des Clients (Refresh Token). Die Funktion liefert ‘1’ im Erfolgsfall, sonst ‘0’.

    bool BHS_Notification(int $InstanzID);
    

    Gibt im angemeldeten Zusatnd die Benachrichtigungsoptionen aus. Die Funktion liefert true im Erfolgsfall, sonst false.

    9. Versionshistorie

    v2.7.20260929

    • NEU: Support von Blink Outdoor 2K+
    • NEU: Namespaces eingeführt
    • NEU: Versionierung vereinheitlicht
    • FIX: Darstellungsparameter korrigiert
    • FIX: Interne Bibliotheken erweitert und vereinheitlicht

    v2.6.20260526

    • NEU: Konfiguration vereinheitlicht
    • FIX: Login Status Code angepasst
    • FIX: Liveview API Endpoint
    • FIX: Kleinere Übersetzungsfehler korrigiert

    v2.5.20260526

    • NEU: Support von Blink Sync Modul Core
    • FIX: Kleinere Anpassungen in Bibliotheken

    v2.4.20260428

    • NEU: Liveview via eigenem NodeJS Service
    • NEU: AccountID wird an Geräte weitergegeben

    v2.3.20260108

    • NEU: Umstellung auf wiederholt neues OAuth2 Authentifizierungsverfahren
    • NEU: Modulversion wird in Quellcodesektion angezeigt
    • FIX: Konfigurationsmeldungen auf Popup-Element umgestellt

    v2.2.20251224

    • FIX: Kombatibilität v8.1 und v8.2 korriegiert

    • NEU: Support für Blink Mini 2K+

    • NEU: Umstellung der Flutlichschaltung

    v2.1.20251125

    • NEU: Support für Blink Mini 2K+
    • NEU: Umstellung der Flutlichschaltung

    v2.0.20251013

    • NEU: Umstellung auf neues OAuth2 Authentifizierungsverfahren
    • NEU: Umstellung des ‘Heartbeat’-Verfahrens (Refresh Token)
    • NEU: Support für Liveview (Distributed AUTH Data)
    • NEU: Blink Outdoor 4 Support
    • NEU: Globaler Support für Abgleich des Batterie-Ladezustandes aller Geräte im Netzwerk
    • NEU: Umstellung auf Strict-Modus (IPSModuleStrict)
    • NEU: Umstellung auf globale einheitliche Versionsnummer
    • NEU: Kompatibilität auf IPS 8.1 vereinheitlicht
    • FIX: Interne Bibliotheken und Konfiguration überarbeitet und vereinheitlicht
    • FIX: Inline-Dokumentation komplett überarbeitet

    v1.8.20241024

    • NEU: Blink API Layer für Directaufnamen (Record) erweitert
    • FIX: Rechenfehler bei Zeiteinstellung (Heartbeat) korrigiert

    v1.7.20240628

    • NEU: Blink API Layer für Zubehör erweitert
    • FIX: Konfigurationsformular überarbeitet und vereinheitlicht

    v1.6.20240606

    • FIX: Downloads von Videos verbessert
    • FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
    • FIX: Dokumentation überarbeitet

    v1.5.20231013

    • FIX: Übersetzungen ausgebaut bzw. vervollständigt
    • FIX: Blink API Layer erweitert, aktualisiert und neu dokumentiert
    • FIX: Style-Checks aktualisiert
    • FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
    • FIX: Dokumentation überarbeitet

    v1.4.20220815

    • FIX: API für Blink Doorbells angeasst

    v1.3.20220620

    • NEU: Login überarbeitet, jeder Client hat jetzt eigene UUID
    • NEU: Verarbeitung von Binärdaten (Bilder) für spätere IPS Versionen vorbereitet
    • FIX: Fehlerhafter Login wird jetzt abgefangen

    v1.2.20220214

    • FIX: Kennwort Validation Pattern um Minus-Zeichen erweitert

    v1.1.20220130

    • NEU: Blink Mini Support
    • FIX: Mail Validation Pattern angepasst
    • FIX: Kennwort Validation Pattern angepasst

    v1.0.20220110

    • NEU: Initialversion

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence