+
| name : | the name of the new device to use in FHEM |
| Servername : | the name or IP-address of Synology Surveillance Station Host. If Servername is used, make sure the name can be discovered in network by DNS |
| Port : | the Port Synology surveillance Station Host, normally 5000 (HTTP only) |
@@ -1058,43 +1203,80 @@ return;
- Examples:
+ Examples:
define CamDoor SSCAM ds1.myds.ds 5000 apiuser apipass Door 10
-
- Set
+
+
+
+Set
- There are two options for set.
-
- "on" : starts a recording. The recording will be stopped after the period given by the value of <RecordTime> in device definition.
-
- Command: set <name> on
-
- "off" : stops a running recording manually or other event (for example by using at, notify or others).
-
- Command: set <name> off
-
+ There are the following options for "Set" at present:
+
+
+
+ | "on": | starts a recording. The recording will be stopped automatically after a period of <RecordTime> as determined |
+ | "off" : | stopps a running recording manually or using other events (e.g. with at, notify) |
+ | "snap": | triggers a snapshot of the relevant camera and store it into Synology Surveillance Station |
+
+
+
+ Example for simple Start/Stop of Recording:
+
+
+
+ | set <name> on | starts a recording of camera <name>, stops automatically after the time <RecordTime> as determined in device-definition |
+ | set <name> off | stops the recording of camera <name> |
+
+
+
+ A snapshot can be triggered with:
+
+ set <name> snap
+
+
+ Subsequent some Examples for taking snapshots:
+
+ If a serial of snapshots should be released, it can be done using the following notify command.
+ For the example a serial of snapshots are to be triggerd if the recording of a camera starts.
+ When the recording of camera "CamHE1" starts (Attribut event-on-change-reading -> "Record" has to be set), then 3 snapshots at intervals of 2 seconds are triggered.
+
+
+ define he1_snap_3 notify CamHE1:Record.*Start define h3 at +*{3}00:00:02 set CamHE1 snap
+
+
+ Release of 2 Snapshots of camera "CamHE1" at intervals of 6 seconds after the motion sensor "MelderHE1" has sent an event,
+ can be done e.g. with following notify-command:
+
+
+ define he1_snap_2 notify MelderHE1:on.* define h2 at +*{2}00:00:06 set CamHE1 snap
+
+
+ The ID of the last snapshot will be displayed as value of variable "LastSnapId" in the device-Readings.
-
- Attributes
+
+
+
+Attributes
Different Verbose-Level are supported.
- Those are in detail:
+ Those are in detail:
-
- 0 - Start/Stop-Event will be logged
- 1 - Error messages will be logged
- 3 - sended commands will be logged
- 4 - sended and received informations will be logged
- 5 - all outputs will be logged for error-analyses. Please use it carefully, a lot of data could be written into the logfile !
-
+
+
+ | 0 | Start/Stop-Event will be logged |
+ | 1 | Error messages will be logged | |
+ | 3 | sended commands will be logged | |
+ | 4 | sended and received informations will be logged | |
+ | 5 | all outputs will be logged for error-analyses. Caution: a lot of data could be written into the logfile ! | |
+
@@ -1111,30 +1293,37 @@ return;
SSCam
- Mit diesem Modul kann die Aufnahme von in der Synology Surveillance Station definierten Kameras gestartet bzw. gestoppt werden.
+ Mit diesem Modul können Operationen von in der Synology Surveillance Station definierten Kameras ausgeführt werden.
+ Zur Zeit werden folgende Funktionen unterstützt:
+
+ - Start einer Aufnahme
+ - Stop einer Aufnahme
+ - Aufnehmen eines Schnappschusses und Ablage in der Synology Surveillance Station
+
Die Aufnahmen stehen in der Synology Surveillance Station zur Verfügung und unterliegen, wie jede andere Aufnahme, den in der Synology Surveillance Station eingestellten Regeln.
- So werden zum Beispiel die Aufnahmen entsprechend ihrer Archivierungsfrist gehalten und dann gelöscht.
+ So werden zum Beispiel die Aufnahmen entsprechend ihrer Archivierungsfrist gehalten und dann gelöscht.
+
Vorbereitung
Dieses Modul nutzt das CPAN Module JSON. Bitte darauf achten dieses Paket zu installieren. (Debian: libjson-perl).
Das CPAN-Modul LWP wird für SSCam nicht mehr benötigt. Das Modul verwendet für HTTP-Calls die nichtblockierenden Funktionen von HttpUtils bzw. HttpUtils_NonblockingGet.
- Im DSM muß ebenfalls ein Nutzer als Mitglied der Administratorgruppe angelegt sein. Die Daten werden beim define des Gerätes benötigt.
+ Im DSM muß ebenfalls ein Nutzer als Mitglied der Administratorgruppe angelegt sein. Die Daten werden bei der Definition des Gerätes benötigt.
-
- Define
+
+Define
+
define <name> SSCam <Servername> <Port> <Username> <Password> <Cameraname> <RecordTime>
Definiert eine neue Kamera für SSCam. Zunächst muß diese Kamera in der Synology Surveillance Station 7.0 oder höher eingebunden sein und entsprechend funktionieren.
- Der Parameter "RecordTime" beschreibt die Mindestaufnahmezeit. Abhängig von Faktoren wie Performance der Synology Diskstation und der Surveillance Station
+ Der Parameter "<RecordTime> beschreibt die Mindestaufnahmezeit. Abhängig von Faktoren wie Performance der Synology Diskstation und der Surveillance Station
kann die effektive Aufnahmezeit geringfügig länger sein.
Das Modul SSCam basiert auf Funktionen der Synology Surveillance Station API.
- Weitere Inforamtionen unter: Web API Guide.
+ Weitere Informationen unter: Web API Guide.
- Es müssen die Perl-Module LWP (Debian: libwww-perl) und JSON (Debian: libjson-perl) installiert sein.
Momentan wird nur das HTTP-Protokoll unterstützt um die Web-Services der Synology DS aufzurufen.
Die Parameter beschreiben im Einzelnen:
@@ -1142,56 +1331,91 @@ return;
- | name : | der Name des neuen Gerätes in FHEM |
- | Servername : | der Name oder die IP-Addresse des Synology Surveillance Station Host. Wenn der Servername benutzt wird ist sicherzustellen dass der Name im Netzwerk aufgelöst werden kann. |
- | Port : | der Port des Synology Surveillance Station Host. Normalerweise ist das 5000 (nur HTTP) |
- | Username : | Name des in der Diskstation definierten Nutzers. Er muß ein Mitglied der Admin-Gruppe sein |
- | Password : | das Passwort des Nutzers |
- | Cameraname : | Kameraname wie er in der Synology Surveillance Station angegeben ist. Leerzeichen im Namen sind nicht erlaubt ! |
- | Recordtime : | die definierte Aufnahmezeit |
+
+ | name: | der Name des neuen Gerätes in FHEM |
+ | Servername: | der Name oder die IP-Addresse des Synology Surveillance Station Host. Wenn der Servername benutzt wird ist sicherzustellen dass der Name im Netzwerk aufgelöst werden kann. |
+ | Port: | der Port des Synology Surveillance Station Host. Normalerweise ist das 5000 (nur HTTP) |
+ | Username: | Name des in der Diskstation definierten Nutzers. Er muß ein Mitglied der Admin-Gruppe sein |
+ | Password: | das Passwort des Nutzers |
+ | Cameraname: | Kameraname wie er in der Synology Surveillance Station angegeben ist. Leerzeichen im Namen sind nicht erlaubt ! |
+ | Recordtime: | die definierte Aufnahmezeit |
- Beispiel:
+ Beispiel:
define CamTür SSCAM ds1.myds.ds 5000 apiuser apipass Tür 10
-
- Set
-
-
- Es gibt zur Zeit zwei Optionen für "Set".
+
+
+Set
+
+ Es gibt zur Zeit folgende Optionen für "Set":
- "on" : startet eine Aufnahme. Die Aufnahme wird automatisch nach Ablauf der Zeit <RecordTime> gestoppt.
-
- Befehl: set <name> on
-
- "off" : stoppt eine laufende Aufnahme manuell oder durch die Nutzung anderer Events (z.B. durch at, notify oder andere)
-
- Befehl: set <name> off
-
+
+
+ | "on": | startet eine Aufnahme. Die Aufnahme wird automatisch nach Ablauf der Zeit <RecordTime> gestoppt. |
+ | "off" : | stoppt eine laufende Aufnahme manuell oder durch die Nutzung anderer Events (z.B. über at, notify) |
+ | "snap": | löst einen Schnappschuß der entsprechenden Kamera aus und speichert ihn in der Synology Surveillance Station |
+
+
+
+ Beispiele für einfachen Start/Stop einer Aufnahme:
-
+
+
+ | set <name> on | startet die Aufnahme der Kamera <name>, automatischer Stop der Aufnahme nach Ablauf der Zeit <RecordTime> wie im define angegeben |
+ | set <name> off | stoppt die Aufnahme der Kamera <name> |
+
-
- Attributes
+ Ein Schnappschuß kann ausgelöst werden durch:
+
+ set <name> snap
+
+
+ Nachfolgend einige Beispiele für die Auslösung von Schnappschüssen.
+
+ Soll eine Reihe von Schnappschüssen ausgelöst werden wenn eine Aufnahme startet, kann das z.B. durch folgendes notify geschehen.
+ Sobald der Start der Kamera CamHE1 ausgelöst wird (Attribut event-on-change-reading -> "Record" setzen), werden abhängig davon 3 Snapshots im Abstand von 2 Sekunden getriggert.
+
+
+ define he1_snap_3 notify CamHE1:Record.*Start define h3 at +*{3}00:00:02 set CamHE1 snap
+
+
+ Triggern von 2 Schnappschüssen der Kamera "CamHE1" im Abstand von 6 Sekunden nachdem der Bewegungsmelder "MelderHE1" einen Event gesendet hat,
+ kann z.B. mit folgendem notify geschehen:
+
+
+ define he1_snap_2 notify MelderHE1:on.* define h2 at +*{2}00:00:06 set CamHE1 snap
+
+
+ Es wird die ID des letzten Snapshots als Wert der Variable "LastSnapId" in den Readings der Kamera ausgegeben.
+
+
+
+
+
+
+
+Attributes
Es werden verschiedene Verbose-Level unterstützt.
- Dies sind im Einzelnen:
+ Dies sind im Einzelnen:
-
- 0 - Start/Stop-Ereignisse werden geloggt
- 1 - Fehlermeldungen werden geloggt
- 3 - gesendete Kommandos werden geloggt
- 4 - gesendete und empfangene Daten werden geloggt
- 5 - alle Ausgaben zur Fehleranalyse werden geloggt. ACHTUNG: unter Umständen sehr viele Daten im Logfile !
-
+
+
+ | 0 | Start/Stop-Ereignisse werden geloggt |
+ | 1 | Fehlermeldungen werden geloggt |
+ | 3 | gesendete Kommandos werden geloggt |
+ | 4 | gesendete und empfangene Daten werden geloggt |
+ | 5 | alle Ausgaben zur Fehleranalyse werden geloggt. ACHTUNG: möglicherweise werden sehr viele Daten in das Logfile geschrieben! |
+