Blink Home Client
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 Module Store das ‘Blink Home System’-Modul installieren.
- Alternativ Über das Modul-Control folgende URL hinzufügen.
https://github.com/Wilkware/BlinkHomeSystemodergit://github.com/Wilkware/BlinkHomeSystem.git
4. Einrichten der Instanzen in Symcon
- Unter “Instanz hinzufügen” ist das ‘Blink Home Client’-Modul unter dem Hersteller ‘Amazon’ aufgeführt.
Konfigurationsseite:
Einstellungsbereich:
🔐 Konto-Informationen …
| Name | Beschreibung |
|---|---|
| Blink Account eMail | Registrierte Mail-Adresse bei Blink |
| Blink Account Kennwort | Hinterlegtes Kennwort |
⚙️ Erweiterte Einstellungen …
| Name | Beschreibung |
|---|---|
| Automatisch angemeldet bleiben | Aktiviert die automatische Verlängerung des Zugriffs-Tokens |
Aktionsbereich:
🗝️ Anmelden und verifizieren am Blink Server …
| Aktion | Beschreibung |
|---|---|
| ANMELDEN | Senden der Logindaten an Blink Server |
| ÜBERPRÜFEN | Senden eines Codes zur Verifizierung der Login-Daten |
| AKTUALISIEREN | Zugriffs-Token erneut anfragen, aktualisieren und Ablaufzeit neu starten |
❓ Abfrage von …
| Aktion | Beschreibung |
|---|---|
| Benachrichtigungsoptionen | Abrufen und Anzeigen der eingestellten Optionen |
5. Statusvariablen und Darstellungen
Es werden keine zusätzlichen Statusvariablen oder Darstellungen benötigt.
6. Visualisierung
Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.
7. PHP-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.
8. 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 Netwerk
- 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 ;-)
Spenden
Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.
Lizenz
Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International