Blink Home Device

Dokumentation direkt aus GitHub Wilkware/BlinkHomeSystem ↗

Version Product Version License Actions

Ermöglicht die Kommunikation mit einem Blink Endgerät, derzeit vornehmlich Kameras.

1. Funktionsumfang

Das Modul ermöglicht die Integration von Blink-Kameras in Symcon und stellt zentrale Steuerungs- und Anzeigeoptionen bereit.
Der aktuelle Funktionsumfang umfasst:

  • Auslösen und Anzeigen von Momentaufnahmen (Snapshot)
  • Aktivieren und Deaktivieren der Bewegungserkennung
  • Live-View-Anzeige über einen Middleware-WebSocket-Service
  • Anzeige des Batterieladezustands der Geräte

Das Modul wird kontinuierlich weiterentwickelt und kann künftig um zusätzliche Funktionen erweitert werden.

2. Voraussetzungen

  • Symcon ab Version 8.1

3. Installation

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

4. Einrichten der Instanzen in Symcon

  • Unter “Instanz hinzufügen” ist das ‘Blink Home Device’-Modul unter dem Hersteller ‘Amazon’ aufgeführt.
  • Über den ‘Blink Home Configurator’ kann eine einfache Installation vorgenommen werden.
    Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen

Konfigurationsseite:

Einstellungsbereich:

📳 Geräteinformationen …

NameBeschreibung
GerätetypTypbezeichnung (Kamera)
GerätemodellModellbezeichnung
Geräte-IDInterne Gerätenummer
Netwerk-IDInterne Netwerknummer

🖼️ Bilder …

NameBeschreibung
Erstellen einer Medienvariablen für Momentausnahmen!Schalter für Anlegen eines Medienobjektes (Image) für das Speichern der Aufnahmen
Benutze In-Memory Cache!Schalter zum direkten Speichern des Medienobjektes im Speicher (Cache)
Erstellen eines Zeitstempels auf jeder Momentaufnahme!Schalter zum Aktivieren eines Zeitstemples auf jeder Aufnahme
Seitenrand ObenAbstand des Zeitstempels vom oberen Bildrand
Seitenrand LinksAbstand des Zeitstempels vom linken Bildrand
SchriftgrößeSchriftgröße des Zeitstempels
SchriftfarbeFarbliche Gestaltung des Zeitstempels
Pfad zu der TrueType-SchriftartAngabe welcher Truetype-Font verwendet werden soll (voller Dateipfad)

⏱️ Zeitsteuerung …

NameBeschreibung
AktualisierungsintervallZeit zwischen 2 Aufnahmen (Standard 60 Minuten), 0 deaktiviert die Aufnahmen. ACHTUNG: zu kurzes Intervall geht auf die Lebensdauer der Batterie!
ZeitplanZeitraum in dem Aufnahmen im angeegebenen Intervall erfolgen sollen.
ZEITPLAN HINZUFÜGENEs wird ein Wochenplan mit 2 Zuständen (Aktiv & Inaktiv) angelegt und in den Einstellung hinterlegt.

🎥 Liveansicht …

NameBeschreibung
Live-Ansicht über Middleware-Server aktivieren!Dadurch wird eine spezielle Kachel-Darstellung aktiviert, welche das Starten und Stoppen der Live-Ansicht in der Visualisierung ermöglicht
Url des Middleware-Servers (IP:PORT)Url (IP-Adresse + eingestellten Port) zum Server

⚙️ Erweiterte Einstellungen …

NameBeschreibung
Anlegen einer Variabel zur Auslösung einer Momentaufnahme der aktuellen Ansicht der Kamera!Variable für’s Webfront zum Auslösen einer Aufnahme
Erstellen einer Variable zur Anzeige des Ladezustands der Batterie!Variable für’s Webfront zum Anzeigen des Ladezustandes
Automatisches Zurücksetzen des Kommando-Stacks!Automatisches Zurücksetzen der Kommando ID beim auftretten von Fehlern.

Aktionsbereich:

🚀 Aktion ausführen …

AktionBeschreibung
AUSLÖSERLöst eine Momentaufnahme(Snapshot) aus.
AUFNEHMENLöst eine manuelle Live-Aufnahme (Clip) aus.

🛟Entwicklungs- und Debuginformationen …

AktionBeschreibung
LIVEVIEWAnzeige der LiveView Anfrageantwort
SIGNALEAnzeige von verschiedenen Signalen (WiFi usw.)
KONFIGURATIONAnzeige der Geräte-Konfigurationsdaten
ZURÜCKSETZENReset des Kommando-Stacks um Kommunikation wieder zu synchronisieren.

5. Statusvariablen und Darstellungen

Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Statusvariablen

IdentNameTypDarstellungBeschreibung
circuit_snapshotZeitplan SnapshoteventWochenplan für Momentaufnahmen
thumbnailBildmediaMedienobject zum Speichern der Aufnahme
motion_detectionBewegungserkennungbooleanSchalterVariable zum an- und ausschalten der Bewegungserkennung
snapshotAuslöserintegerSchalterVariable zum Auslösen einer Momentaufnahme
batteryBatterieintegerWertanzeigeVariable zur Anzeige des Ladezustands (nur wenn batteriebetrieben)

Darstellungen

Folgende Dartsellungen werden hinterlegt:

Template-NameTypBeschreibung
<direkte Assoziazion>SchalterAn-/Ausschalter
<direkte Assoziazion>WertanzeigeFarbliche Batterieladezustandsanzeige von 0 (Unbekannt) bis 3 (Gut)

6. Visualisierung

Man kann sowohl das gesamte Modul (HTML-SDK Support) als auch nur die Statusvariablen direkt in der Visualisierung verlinken.

Wird das ganze Modul verlinkt, dann wird die letzte Momentaufnahme vollflächig in der Kachel angezeigt. In der rechten unteren Ecke werden Buttons für das Aktivieren der Bewegungserkennung und das Auslösen eines neuen Snapshots eingeblendet.
Wenn Die Option “Liveview” aktiviert ist, wird zusätzlich ein Play/Stop-Button kurz in der Mitte des Bildes eingeblendet. Dieser kann durch einfachen Mouseklick auf die Kachel wieder angezeigt werden. Über diesen lässt sich dann der LiveView starten bzw. wieder stoppen.

7. PHP-Befehlsreferenz

Ein direkter Aufruf von öffentlichen Funktionen ist nicht notwendig!

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
  • NEU: Darstellungen werden jetzt lokalisiert
  • FIX: Liveview API Endpoint
  • FIX: Kleinere Übersetzungsfehler korrigiert
  • FIX: Dokumentation korrigiert

v2.5.20260526

  • FIX: Kleinere Anpassungen in Bibliotheken

v2.4.20260428

  • NEU: Liveview via eigenem NodeJS Service

v2.3.20260108

  • NEU: Umstellung auf Darstellungen
  • NEU: Modulversion wird in Quellcodesektion angezeigt

v2.1.20251125

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

v2.0.20251013

  • NEU: Support für TileVisu (Kachel-Visualisierung)
  • NEU: Support für Liveview über externen Middleware-Server
  • NEU: Support für Blink Outdoor 4
  • NEU: Neue Entwickleroption (Konfiguration) um gesamte Gerätedaten anzuzeigen
  • NEU: Umstellung auf Strict-Modus (IPSModuleStrict)
  • NEU: Umstellung auf globale einheitliche Versionsnummer
  • NEU: Kompatibilität auf IPS 8.1 vereinheitlicht
  • FIX: Umbau der Ermittlung des Ladezustandes bei Batteriebetrieb
  • FIX: Interne Bibliotheken und Konfiguration überarbeitet und vereinheitlicht
  • FIX: Inline-Dokumentation komplett überarbeitet

v1.8.20241024

  • NEU: Auslösen einer Direktaufnahme (Clip aufnehmen)
  • NEU: Neue Option zum automatischen Zurücksetzen des Kommando-Stacks
  • NEU: Zufälliger Zeit-Offset bei Neustart (un damit auch bei Konfigurationsänderungen)
  • FIX: Konfigurationsformular vereinheitlicht

v1.7.20240628

  • NEU: Support für Blink Mini 2
  • NEU: Support für Anzeige des Ladezustandes von batteriebetriebenen Geräten
  • NEU: Neue Entwickleroption (Signale) um einige Sensordaten anzuzeigen
  • FIX: Anzeige-Popup ausgetauscht für fehlerfreie Auflistung

v1.6.20240606

  • NEU: Support für Blink Indoor Kamera (3rd Gen)
  • NEU: Ausgabe ins Log wenn Kamera nicht mehr auf Kommandos reagiert (Zombies)
  • NEU: Neue Entwickleroption (Zurücksetzen) um Kommunikation mit Kameras wieder zu synchronisieren
  • FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
  • FIX: Dokumentation überarbeitet

v1.5.20231013

  • NEU: Bewegungserkennung jetzt auch für Blink Mini verfügbar
  • 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: Anpassungen für Blink Doorbells
  • FIX: Logging verbessert

v1.3.20220620

  • NEU: Unterstütztung für Blink Doorbells
  • FIX: Bildverarbeitung überarbeitet
  • FIX: Logging verbessert

v1.2.20220214

  • NEU: Bewegungserkennung für Blink Mini deaktiviert
  • FIX: Hintergrundrahmen für Zeitstempel optimiert
  • FIX: Übersetzungen korrigiert

v1.1.20220130

  • NEU: Blink Mini Support
  • NEU: Format für Zeitstempel hinzugefügt
  • NEU: Hintergrundfarbe für Zeitstempel hinzugefügt
  • FIX: Bugfix Zeitplan

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