Suche

    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 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 Gerät-Modul unter dem Hersteller ‘Amazon’ aufgeführt.
    • Über den Blink Home Konfigurator 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
    Netzwerk-IDInterne Netzwerknummer

    🖼️ 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 Variable 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

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

    NameTypBeschreibung
    BewegungserkennungBooleanVariable zum An- und Ausschalten der Bewegungserkennung
    AuslöserBooleanVariable zum Auslösen einer Momentaufnahme
    AufnehmenBooleanVariable zum Auslösen einer manuellen Aufnahme (Clip)
    BatterieIntegerVariable zur Anzeige des Ladezustands (nur wenn batteriebetrieben)

    Hinweis: Zusätzlich werden der Wochenplan Zeitplan Snapshot (Zeitplan für Momentaufnahmen) und das Medienobjekt Bild (Speichern der Aufnahme) angelegt.

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    BewegungserkennungSchalterAn / Aus
    AuslöserSchalterAn / Aus
    AufnehmenSchalterAn / Aus
    BatterieWertanzeigeUnbekannt (0), Niedrig (1), Mittel (2), Gut (3)

    7. 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.

    8. Befehlsreferenz

    Ein direkter Aufruf von öffentlichen Funktionen ist nicht notwendig!

    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
    • 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