", "7" => "Setup Email Shipping
". "====================
". - "Snapshots can be sent by Email alltogether after creation. For this purpose the module contains
". - "its own Email client.
". - "Before you can use this function you have to install the Perl-module MIME::Lite. On debian systems it can be ". - "installed with command:". - "
- ".
- "sudo apt-get install libmime-lite-perl".
- "
". - "At first the Credentials for access the Email outgoing server must be set by command \"set <name> smtpcredentials <user> <password>\"
". - "The connection to the server is initially established unencrypted and switches to an encrypted connection if SSL
". - "encryption is available. In that case the transmission of User/Password takes place encrypted too.
". - "If attribute \"smtpSSLPort\" is defined, the established connection to the Email server will be encrypted immediately.
". + "Snapshots can be sent by Email alltogether after creation. For this purpose the module contains
". + "its own Email client.
". + "Before you can use this function you have to install the Perl-module MIME::Lite. On debian systems it can be ". + "installed with command:". + "
- ".
+ "sudo apt-get install libmime-lite-perl".
+ "
". + "At first the Credentials for access the Email outgoing server must be set by command \"set <name> smtpcredentials <user> <password>\"
". + "The connection to the server is initially established unencrypted and switches to an encrypted connection if SSL
". + "encryption is available. In that case the transmission of User/Password takes place encrypted too.
". + "If attribute \"smtpSSLPort\" is defined, the established connection to the Email server will be encrypted immediately.
". "Attributes which are optional are marked:
". - "
- ".
- "
- snapEmailTxt - Activates the Email shipping. This attribute has the format:
". - "- subject => <subject text>, body => <message text>
". - "\$CAM is replaced by the device name, device alias or the name of camera in SVS if alias is not defined.
". - "\$DATE and \$TIME are replaced with the current date and time. ".
- " - smtpHost - Hostname or IP-address of outgoing Email server (e.g. securesmtp.t-online.de) ". - "
- smtpFrom - Return address (<name>@<domain>) ". - "
- smtpTo - Receiving address(es) (<name>@<domain>) ". - "
- smtpPort - (optional) Port of outgoing Email server (default: 25) ". - "
- smtpCc - (optional) carbon-copy receiving address(es) (<name>@<domain>) ". - "
- smtpNoUseSSL - (optional) \"1\" if no SSL encryption should be used for Email shipping (default: 0) ". - "
- smtpSSLPort - (optional) Port for SSL encrypted connection (default: 465) ". - "
- smtpDebug - (optional) switch on the debugging of SMTP connection ". - "
- ".
+ "
- snapEmailTxt - Activates the Email shipping. This attribute has the format:
". + "- subject => <subject text>, body => <message text>
". + "\$CAM is replaced by the device name, device alias or the name of camera in SVS if alias is not defined.
". + "\$DATE and \$TIME are replaced with the current date and time. ".
+ " - smtpHost - Hostname or IP-address of outgoing Email server (e.g. securesmtp.t-online.de) ". + "
- smtpFrom - Return address (<name>@<domain>) ". + "
- smtpTo - Receiving address(es) (<name>@<domain>) ". + "
- smtpPort - (optional) Port of outgoing Email server (default: 25) ". + "
- smtpCc - (optional) carbon-copy receiving address(es) (<name>@<domain>) ". + "
- smtpNoUseSSL - (optional) \"1\" if no SSL encryption should be used for Email shipping (default: 0) ". + "
- smtpSSLPort - (optional) Port for SSL encrypted connection (default: 465) ". + "
- smtpDebug - (optional) switch on the debugging of SMTP connection ". + "
", "6" => "There are some Icons in directory www/images/sscam available for SSCam. Thereby the system can use the icons please do:
". @@ -745,7 +751,7 @@ my %vHintsExt_en = ( "
", "3" => "Link to SSCam english commandRef ". "
", - "2" => "You can create own PTZ-control icons with a template available in SVN which can be downloaded here: contrib/sscam/black_btn_CAM_Template.pdn.\n". + "2" => "You can create own PTZ-control icons with a template available in SVN which can be downloaded here: contrib/sscam/black_btn_CAM_Template.pdn.\n". "This template can be edited with Paint.Net for example. ". "
", "1" => "Some helpful FHEM-Wiki notes". @@ -753,7 +759,7 @@ my %vHintsExt_en = ( ); ############################################################################################# -# Hint Hash DE +# Hint Hash DE ############################################################################################# my %vHintsExt_de = ( "9" => "Weitere Informationen zum Versand von Schnappschüssen und Aufnahmen mit dem Synology Chat Server findet man im ". @@ -764,36 +770,36 @@ my %vHintsExt_de = ( "
", "7" => "Einstellung Email-Versand
". "=========================
". - "Schnappschüsse können nach der Erstellung per Email gemeinsam versendet werden. Dazu enthält das Modul einen
". - "eigenen Email-Client.
". - "Zur Verwendung dieser Funktion muss das Perl-Modul MIME::Lite installiert sein. Auf Debian-Systemen kann ". - "es mit". - "
- ".
- "sudo apt-get install libmime-lite-perl".
- "
". - "Für die Verwendung des Email-Versands müssen einige Attribute gesetzt oder können optional genutzt werden.
". - "Die Credentials für den Zugang zum Email-Server müssen mit dem Befehl \"set <name> smtpcredentials <user> <password>\"
". - "gesetzt werden. Der Verbindungsaufbau zum Postausgangsserver erfolgt initial unverschüsselt und wechselt zu einer verschlüsselten
". - "Verbindung wenn SSL zur Verfügung steht. In diesem Fall erfolgt auch die Übermittlung von User/Password verschlüsselt.
". - "Ist das Attribut \"smtpSSLPort\" definiert, erfolgt der Verbindungsaufbau zum Email-Server sofort verschlüsselt.
". + "Schnappschüsse können nach der Erstellung per Email gemeinsam versendet werden. Dazu enthält das Modul einen
". + "eigenen Email-Client.
". + "Zur Verwendung dieser Funktion muss das Perl-Modul MIME::Lite installiert sein. Auf Debian-Systemen kann ". + "es mit". + "
- ".
+ "sudo apt-get install libmime-lite-perl".
+ "
". + "Für die Verwendung des Email-Versands müssen einige Attribute gesetzt oder können optional genutzt werden.
". + "Die Credentials für den Zugang zum Email-Server müssen mit dem Befehl \"set <name> smtpcredentials <user> <password>\"
". + "gesetzt werden. Der Verbindungsaufbau zum Postausgangsserver erfolgt initial unverschüsselt und wechselt zu einer verschlüsselten
". + "Verbindung wenn SSL zur Verfügung steht. In diesem Fall erfolgt auch die Übermittlung von User/Password verschlüsselt.
". + "Ist das Attribut \"smtpSSLPort\" definiert, erfolgt der Verbindungsaufbau zum Email-Server sofort verschlüsselt.
". "Optionale Attribute sind gekennzeichnet:
". - "
- ".
- "
- snapEmailTxt - Aktiviert den Email-Versand. Das Attribut hat das Format:
". - "- subject => <Betreff-Text>, body => <Mitteilung-Text>
". - "\$CAM wird durch den Device-Namen, Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der
". - "Device-Alias nicht gesetzt ist.
". - "\$DATE und \$TIME werden durch das aktuelle Datum und Zeit ersetzt. ".
- " - smtpHost - Hostname oder IP-Adresse des Postausgangsservers (z.B. securesmtp.t-online.de) ". - "
- smtpFrom - Absenderadresse (<name>\@<domain>) ". - "
- smtpTo - Empfängeradresse(n) (<name>\@<domain>) ". - "
- smtpPort - (optional) Port des Postausgangsservers (default: 25) ". - "
- smtpCc - (optional) Carbon-Copy Empfängeradresse(n) (<name>\@<domain>) ". - "
- smtpNoUseSSL - (optional) \"1\" wenn kein SSL beim Email-Versand verwendet werden soll (default: 0) ". - "
- smtpSSLPort - (optional) SSL-Port des Postausgangsservers (default: 465) ". - "
- smtpDebug - (optional) zum Debugging der SMTP-Verbindung setzen ". - "
- ".
+ "
- snapEmailTxt - Aktiviert den Email-Versand. Das Attribut hat das Format:
". + "- subject => <Betreff-Text>, body => <Mitteilung-Text>
". + "\$CAM wird durch den Device-Namen, Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der
". + "Device-Alias nicht gesetzt ist.
". + "\$DATE und \$TIME werden durch das aktuelle Datum und Zeit ersetzt. ".
+ " - smtpHost - Hostname oder IP-Adresse des Postausgangsservers (z.B. securesmtp.t-online.de) ". + "
- smtpFrom - Absenderadresse (<name>\@<domain>) ". + "
- smtpTo - Empfängeradresse(n) (<name>\@<domain>) ". + "
- smtpPort - (optional) Port des Postausgangsservers (default: 25) ". + "
- smtpCc - (optional) Carbon-Copy Empfängeradresse(n) (<name>\@<domain>) ". + "
- smtpNoUseSSL - (optional) \"1\" wenn kein SSL beim Email-Versand verwendet werden soll (default: 0) ". + "
- smtpSSLPort - (optional) SSL-Port des Postausgangsservers (default: 465) ". + "
- smtpDebug - (optional) zum Debugging der SMTP-Verbindung setzen ". + "
", "6" => "Für SSCam wird ein Satz Icons im Verzeichnis www/images/sscam zur Verfügung gestellt. Damit das System sie findet bitte setzen:
". @@ -821,10 +827,10 @@ my %vHintsExt_de = ( ################################################################ sub Initialize { my $hash = shift; - + $hash->{DefFn} = \&Define; $hash->{UndefFn} = \&Undef; - $hash->{DeleteFn} = \&Delete; + $hash->{DeleteFn} = \&Delete; $hash->{SetFn} = \&Set; $hash->{GetFn} = \&Get; $hash->{AttrFn} = \&Attr; @@ -833,9 +839,9 @@ sub Initialize { $hash->{FW_summaryFn} = \&FWsummaryFn; $hash->{FW_detailFn} = \&FWdetailFn; $hash->{FW_deviceOverview} = 1; - - my $simver = join ",", @simus; - + + my $simver = join ",", @simus; + $hash->{AttrList} = "disable:1,0 ". "debugactivetoken:1,0 ". "debugCachetime:1,0 ". @@ -880,62 +886,62 @@ sub Initialize { "simu_SVSversion:$simver ". "videofolderMap ". "webCmd ". - $readingFnAttributes; - + $readingFnAttributes; + eval { FHEM::Meta::InitMod( __FILE__, $hash ) }; ## no critic 'eval' # für Meta.pm (https://forum.fhem.de/index.php/topic,97589.0.html) -return; +return; } ################################################################ sub Define { - # Die Define-Funktion eines Moduls wird von Fhem aufgerufen wenn der Define-Befehl für ein Gerät ausgeführt wird + # Die Define-Funktion eines Moduls wird von Fhem aufgerufen wenn der Define-Befehl für ein Gerät ausgeführt wird # Welche und wie viele Parameter akzeptiert werden ist Sache dieser Funktion. Die Werte werden nach dem übergebenen Hash in ein Array aufgeteilt - # define CamCP1 SSCAM Carport 192.168.2.20 [5000] - # ($hash) [1] [2] [3] [4] + # define CamCP1 SSCAM Carport 192.168.2.20 [5000] + # ($hash) [1] [2] [3] [4] # my ($hash, $def) = @_; my $name = $hash->{NAME}; - + return "Error: Perl module ".$MMJSON." is missing. Install it on Debian with: sudo apt-get install libjson-perl" if($MMJSON); - + my @a = split m{\s+}x, $def; - + if(int(@a) < 4) { return "You need to specify more parameters.\n". "Format: define
![](\"$FW_ME/www/images/sscam/black_btn_CAMBLANK.png\"){kind=spacer}
"; # nicht sichtbare Leertaste
my $cmdstop = "cmd=set $d stopView"; # Stream deaktivieren
my $imgstop = "![](\"$FW_ME/www/images/default/remotecontrol/black_btn_POWEROFF3.png\")
";
my $cmdhlsreact = "cmd=set $d hlsreactivate"; # HLS Stream reaktivieren
my $imghlsreact = "![](\"$FW_ME/www/images/default/remotecontrol/black_btn_BACKDroid.png\")
";
- my $cmdmjpegrun = "cmd=set $d runView live_fw"; # MJPEG Stream aktivieren
+ my $cmdmjpegrun = "cmd=set $d runView live_fw"; # MJPEG Stream aktivieren
my $imgmjpegrun = "![](\"$FW_ME/www/images/sscam/black_btn_MJPEG.png\")
";
- my $cmdhlsrun = "cmd=set $d runView live_fw_hls"; # HLS Stream aktivieren
+ my $cmdhlsrun = "cmd=set $d runView live_fw_hls"; # HLS Stream aktivieren
my $imghlsrun = "![](\"$FW_ME/www/images/sscam/black_btn_HLS.png\")
";
- my $cmdlrirun = "cmd=set $d runView lastrec_fw"; # Last Record IFrame
+ my $cmdlrirun = "cmd=set $d runView lastrec_fw"; # Last Record IFrame
my $imglrirun = "![](\"$FW_ME/www/images/sscam/black_btn_LASTRECIFRAME.png\")
";
- my $cmdlh264run = "cmd=set $d runView lastrec_fw_MPEG4/H.264"; # Last Record H.264
+ my $cmdlh264run = "cmd=set $d runView lastrec_fw_MPEG4/H.264"; # Last Record H.264
my $imglh264run = "![](\"$FW_ME/www/images/sscam/black_btn_LRECH264.png\")
";
- my $cmdlmjpegrun = "cmd=set $d runView lastrec_fw_MJPEG"; # Last Record MJPEG
+ my $cmdlmjpegrun = "cmd=set $d runView lastrec_fw_MJPEG"; # Last Record MJPEG
my $imglmjpegrun = "![](\"$FW_ME/www/images/sscam/black_btn_LRECMJPEG.png\")
";
- my $cmdlsnaprun = "cmd=set $d runView lastsnap_fw STRM"; # Last SNAP
+ my $cmdlsnaprun = "cmd=set $d runView lastsnap_fw STRM"; # Last SNAP
my $imglsnaprun = "![](\"$FW_ME/www/images/sscam/black_btn_LSNAP.png\")
";
- my $cmdrecendless = "cmd=set $d on 0"; # Endlosaufnahme Start
+ my $cmdrecendless = "cmd=set $d on 0"; # Endlosaufnahme Start
my $imgrecendless = "![](\"$FW_ME/www/images/sscam/black_btn_RECSTART.png\")
";
- my $cmdrecstop = "cmd=set $d off"; # Aufnahme Stop
+ my $cmdrecstop = "cmd=set $d off"; # Aufnahme Stop
my $imgrecstop = "![](\"$FW_ME/www/images/sscam/black_btn_RECSTOP.png\")
";
my $cmddosnap = "cmd=set $d snap 1 2 STRM"; # Snapshot auslösen mit Kennzeichnung "by STRM-Device"
my $imgdosnap = "![](\"$FW_ME/www/images/sscam/black_btn_DOSNAP.png\")
";
-
+
my $attr = AttrVal($d, "htmlattr", " ");
Log3($name, 4, "$name - FWsummaryFn called - FW_wname: $FW_wname, device: $d, room: $room, attributes: $attr");
-
+
my $calias = $hash->{CAMNAME}; # Alias der Kamera
my ($ttrefresh, $ttrecstart, $ttrecstop, $ttsnap, $ttcmdstop, $tthlsreact, $ttmjpegrun, $tthlsrun, $ttlrrun, $tth264run, $ttlmjpegrun, $ttlsnaprun);
@@ -1093,7 +1099,7 @@ sub FWsummaryFn {
$ttsnap = $ttips_en{"ttsnap"}; $ttsnap =~ s/§NAME§/$calias/gx;
$ttcmdstop = $ttips_en{"ttcmdstop"}; $ttcmdstop =~ s/§NAME§/$calias/gx;
$tthlsreact = $ttips_en{"tthlsreact"}; $tthlsreact =~ s/§NAME§/$calias/gx;
- }
+ }
else {
$ttrecstart = $ttips_de{"ttrecstart"}; $ttrecstart =~ s/§NAME§/$calias/gx;
$ttrecstop = $ttips_de{"ttrecstop"}; $ttrecstop =~ s/§NAME§/$calias/gx;
@@ -1101,38 +1107,38 @@ sub FWsummaryFn {
$ttcmdstop = $ttips_de{"ttcmdstop"}; $ttcmdstop =~ s/§NAME§/$calias/gx;
$tthlsreact = $ttips_de{"tthlsreact"}; $tthlsreact =~ s/§NAME§/$calias/gx;
}
-
+
if($wltype eq "image") {
- if(ReadingsVal($name, "SVSversion", "") eq "8.2.3-5828" && ReadingsVal($name, "CamVideoType", "") !~ /MJPEG/x) {
+ if(ReadingsVal($name, "SVSversion", "") eq "8.2.3-5828" && ReadingsVal($name, "CamVideoType", "") !~ /MJPEG/x) {
$ret .= "Because SVS version 8.2.3-5828 is running you cannot see the MJPEG-Stream. Please upgrade to a higher SVS version !
"; - } + } else { $ret .= "
"; } - + $ret .= "$imgstop "; - $ret .= $imgblank; - + $ret .= $imgblank; + if($hash->{HELPER}{RUNVIEW} =~ /live_fw/x) { if(ReadingsVal($d, "Record", "Stop") eq "Stop") { # Aufnahmebutton endlos Start $ret .= "$imgrecendless "; - } + } else { # Aufnahmebutton Stop $ret .= "$imgrecstop "; - } - $ret .= "$imgdosnap "; + } + $ret .= "$imgdosnap "; } - + $ret .= "
"; - + if($hash->{HELPER}{AUDIOLINK} && ReadingsVal($d, "CamAudioType", "Unknown") !~ /Unknown/x) { $ret .= ""; - } - } + } + } elsif($wltype eq "iframe") { $ret .= "
" if($link); - } + } else { $ret .= "
" if($link); + "
" if($link); } $streamHash->{HELPER}{STREAM} = ""; # Stream für "set
"; - + $streamHash->{HELPER}{STREAM} = ""; # Stream für "set
')\">" if($link); - } + } else { $ret .= "
" if($link); } $streamHash->{HELPER}{STREAM} = "
"; # Stream für "get "; - + $streamHash->{HELPER}{STREAM} = ""; # Stream für "set
";
-
+
# bei Aufruf durch FTUI Kommandosyntax anpassen
if($ftui) {
- $cmddosnap = "ftui.setFhemStatus('set $name snap 1 2 STRM:$uuid')";
+ $cmddosnap = "ftui.setFhemStatus('set $name snap 1 2 STRM:$uuid')";
}
-
+
my $ha = AttrVal($name, "snapGalleryHtmlAttr", AttrVal($name, "htmlattr", 'width="500" height="325"'));
-
+
# falls "composeGallery" durch ein SSCamSTRM-Device aufgerufen wird
my $pws = "";
if ($strmdev) {
$pws = AttrVal($strmdev, "popupWindowSize", ""); # Größe eines Popups (umgelegt: Forum:https://forum.fhem.de/index.php/topic,45671.msg927912.html#msg927912)
$pws =~ s/"//xg if($pws);
- $ha = AttrVal($strmdev, "htmlattr", $ha); # htmlattr vom SSCamSTRM-Device übernehmen falls von SSCamSTRM-Device aufgerufen und gesetzt
+ $ha = AttrVal($strmdev, "htmlattr", $ha); # htmlattr vom SSCamSTRM-Device übernehmen falls von SSCamSTRM-Device aufgerufen und gesetzt
$hb = AttrVal($strmdev, "hideButtons", 0); # Drucktasten im unteren Bereich ausblenden ?
if($ftui) {
- $ha = AttrVal($strmdev, "htmlattrFTUI", $ha); # wenn aus FTUI aufgerufen divers setzen
+ $ha = AttrVal($strmdev, "htmlattrFTUI", $ha); # wenn aus FTUI aufgerufen divers setzen
}
}
-
+
# wenn SSCamSTRM-device genutzt wird und attr "snapGalleryBoost" nicht gesetzt ist -> Warnung in Gallerie ausgeben
my $sgbnote = " ";
if($strmdev && !AttrVal($name,"snapGalleryBoost",0)) {
$sgbnote = "CAUTION - The gallery is not updated automatically. Please set the attribute \"snapGalleryBoost=1\" in device $name";
$sgbnote = "ACHTUNG - Die Galerie wird nicht automatisch aktualisiert. Dazu bitte das Attribut \"snapGalleryBoost=1\" im Device $name setzen." if ($lang eq "DE");
}
-
+
my $ttsnap = $ttips_en{"ttsnap"}; $ttsnap =~ s/§NAME§/$camname/xg;
if(AttrVal("global","language","EN") =~ /DE/x) {
$ttsnap = $ttips_de{"ttsnap"}; $ttsnap =~ s/§NAME§/$camname/xg;
}
-
+
# Header Generierung
my $header;
if($strmdev) { # Forum: https://forum.fhem.de/index.php/topic,45671.msg975610.html#msg975610
if($ftui) {
$header .= "$dlink " if(!AttrVal($strmdev,"hideDisplayNameFTUI",0)); - } + } else { $header .= "$dlink
" if(!AttrVal($strmdev,"hideDisplayName",0)); - } - } - + } + } + if ($lang eq "EN") { $header .= "Snapshots (_LIMIT_/$totalcnt) of camera $camname - newest Snapshot: $lss
"; $header .= " (Possibly another snapshots are available. Last recall: $lupt)
" if(AttrVal($name,"snapGalleryBoost",0)); - } + } else { $header .= "Schnappschüsse (_LIMIT_/$totalcnt) von Kamera $camname - neueste Aufnahme: $lss
"; $lupt =~ /(\d+)-(\d\d)-(\d\d)\s+(.*)/x; @@ -8888,9 +8894,9 @@ sub composeGallery { $header .= " (Eventuell sind neuere Aufnahmen verfügbar. Letzter Abruf: $lupt)
" if(AttrVal($name,"snapGalleryBoost",0)); } $header .= $sgbnote; - - my $gattr = (AttrVal($name,"snapGallerySize","Icon") eq "Full")?$ha:""; - + + my $gattr = (AttrVal($name,"snapGallerySize","Icon") eq "Full")?$ha:""; + # Ausgabetabelle erstellen my $htmlCode; $htmlCode = ""; @@ -8898,28 +8904,28 @@ sub composeGallery { $htmlCode .= '
| $data{SSCam}{$name}{SNAPHASH}{$key}{createdTm} | " );
}
-
+
$idata = "";
$i++;
}
- }
+ }
else {
my @as;
for my $ck (cache($name, "c_getkeys")) { # relevant keys aus allen vorkommenden selektieren
@@ -8946,22 +8952,22 @@ sub composeGallery {
$ck =~ s/\{SNAPHASH\}\{(\d+)\}\{.*\}/$1/x;
push @as,$ck if($ck =~ /^\d+$/x);
}
-
+
my %seen;
- my @unique = sort{$a<=>$b} grep { !$seen{$_}++ } @as; # distinct / unique the keys
+ my @unique = sort{$a<=>$b} grep { !$seen{$_}++ } @as; # distinct / unique the keys
$count = scalar @unique // 0; # Anzahl Bilddaten im Cache
- $htmlCode =~ s{_LIMIT_}{$count}xms; # Platzhalter Snapanzahl im Header mit realem Wert ersetzen
+ $htmlCode =~ s{_LIMIT_}{$count}xms; # Platzhalter Snapanzahl im Header mit realem Wert ersetzen
my $i = 1;
-
+
for my $key (@unique) {
if($i > $limit) {
$count = $limit;
last;
}
-
+
$imgdat = cache($name, "c_read", "{SNAPHASH}{$key}{imageData}");
$imgTm = cache($name, "c_read", "{SNAPHASH}{$key}{createdTm}");
-
+
if(!$ftui) {
$idata = "onClick=\"FW_okDialog('|||||||||
| $imgTm | " );
}
-
+
$idata = "";
$i++;
- }
+ }
}
if ( $cell == 2 ) {
$htmlCode .= ""; } - + $htmlCode .= " | ||||||||
| "; @@ -8995,16 +9001,16 @@ sub composeGallery { $htmlCode .= " | "; $htmlCode .= "|||||||||
')\"" if(AttrVal($name,"snapGalleryBoost",0));
}
@@ -8930,15 +8936,15 @@ sub composeGallery {
$htmlCode .= "
')\"" if(AttrVal($name,"snapGalleryBoost",0));
}
@@ -8972,22 +8978,22 @@ sub composeGallery {
$htmlCode .= "| ";
if ($btn[$btnnr] ne "") {
my ($cmd,$img);
-
+
if ($btn[$btnnr] =~ /(.*?):(.*)/x) { # enthält Komando -> | ";
- $ptz_ret .= "\n";
+ $ptz_ret .= "\n";
}
- $ptz_ret .= "|||||||||
| "; - - my $img = $zd{$cmd}{panimg}; + + my $img = $zd{$cmd}{panimg}; if(!$img) { $ptz_ret .= $cmd; - $ptz_ret .= " | "; + $ptz_ret .= ""; next; } - + if ($img =~ m/\.svg/x) { # Verwendung für SVG's $img = FW_makeImage($img, $cmd, "rc-button"); - } + } else { # $FW_ME = URL-Pfad unter dem der FHEMWEB-Server via HTTP erreichbar ist, z.B. /fhem my $iPath = FW_iconPath($img); # automatisches Suchen der Icons im FHEMWEB iconPath - + if($iPath) { $iPath = "$FW_ME/$FW_icondir/$iPath"; - } + } else { $iPath = "$FW_ME/$iconpath/$img"; } - + if($ftui) { $img = "|||||||||
| Preset: | $Presets | "; - $ptz_ret .= "Preset: | $Presets | "; + $ptz_ret .= ""; } - + if($valPatrols) { $ptz_ret .= "
| Patrol: | $Patrols | "; $ptz_ret .= "
SSCam
-
- Using this Module you are able to operate cameras which are defined in Synology Surveillance Station (SVS) and execute
+ Using this Module you are able to operate cameras which are defined in Synology Surveillance Station (SVS) and execute
functions of the SVS. It is based on the SVS API and supports the SVS version 7 and above.
- + At present the following functions are available:
-
@@ -11972,31 +11987,31 @@ return;
The recordings and snapshots will be stored in Synology Surveillance Station (SVS) and are managed like the other (normal) recordings / snapshots defined by Surveillance Station rules.
For example the recordings are stored for a defined time in Surveillance Station and will be deleted after that period.
- + If you like to discuss or help to improve this module please use FHEM-Forum with link:
49_SSCam: Fragen, Hinweise, Neuigkeiten und mehr rund um dieses Modul.
- + Integration into FHEM TabletUI:
There is a widget provided for integration of SSCam-Streaming devices (Type SSCamSTRM) into FTUI. For further information please be informed by the (german) FHEM Wiki article:
FTUI Widget für SSCam Streaming Devices (SSCamSTRM).
- + Prerequisites
-
This module uses the Perl-modules JSON and MIME::Lite which are usually have to be installed in addition.
On Debian-Linux based systems these modules can be installed by:
- +
sudo apt-get install libjson-perl sudo apt-get install libmime-lite-perl - - SSCam is completely using the nonblocking functions of HttpUtils respectively HttpUtils_NonblockingGet.
- In DSM respectively in Synology Surveillance Station an User has to be created. The login credentials are needed later when using a set-command to assign the login-data to a device.
+ + SSCam is completely using the nonblocking functions of HttpUtils respectively HttpUtils_NonblockingGet.
+ In DSM respectively in Synology Surveillance Station an User has to be created. The login credentials are needed later when using a set-command to assign the login-data to a device.
Further informations could be find among Credentials.
- + Overview which Perl-modules SSCam is using:
- +
| JSON | |
| CHI | (if Cache is used) |
| CHI::Driver::Redis | (if Cache is used) |
| Cache::Cache | (if Cache is used) |
- - SSCam uses its own icons. + + SSCam uses its own icons. In order for the system to find the icons, the attribute iconPath must be supplemented with sscam in the FHEMWEB device.
- +
-
- Example
- attr WEB iconPath default:fhemSVG:openautomation:sscam + Example
+ attr WEB iconPath default:fhemSVG:openautomation:sscam
-
- There is a distinction between the definition of a camera-device and the definition of a Surveillance Station (SVS) - device, that means the application on the discstation itself. - Dependend on the type of defined device the internal MODEL will be set to "<vendor> - <camera type>" + There is a distinction between the definition of a camera-device and the definition of a Surveillance Station (SVS) + device, that means the application on the discstation itself. + Dependend on the type of defined device the internal MODEL will be set to "<vendor> - <camera type>" or "SVS" and a proper subset of the described set/get-commands are assigned to the device.
The scope of application of set/get-commands is denoted to every particular command (valid for CAM, SVS, CAM/SVS).
- The cameras can be defined manually discrete, but alternatively with an automatical procedure by set "autocreateCams" + The cameras can be defined manually discrete, but alternatively with an automatical procedure by set "autocreateCams" command in a previously defined SVS device.
- + A camera device is defined by:
define <Name> SSCAM <camera name in SVS> <ServerAddr> [Port] [Protocol] - + A SVS-device to control functions of the Surveillance Station (SVS) is defined by:
define <Name> SSCAM SVS <ServerAddr> [Port] [Protocol] - Is the SVS defined and after setting the appropriate creadentials ready for use, all cameras available in SVS can be created - automatically in FHEM with the set command "autocreateCams". + Is the SVS defined and after setting the appropriate creadentials ready for use, all cameras available in SVS can be created + automatically in FHEM with the set command "autocreateCams".
- + The Modul SSCam ist based on functions of Synology Surveillance Station API.
The parameters are in detail:
-
- +
+
| Name | the name of the new device to use in FHEM |
| Cameraname | camera name as defined in Synology Surveillance Station if camera-device, "SVS" if SVS-Device. Spaces are not allowed in camera name. |
| ServerAddr | IP-address of Synology Surveillance Station Host. Note: avoid using hostnames because of DNS-Calls are not unblocking in FHEM |
| Port | optional - the port of synology disc station. If not set, the default "5000" is used |
| Protocol | optional - the protocol (http or https) to access the synology disc station. If not set, the default "http" is used |
| Protocol | optional - the protocol (http or https) to access the synology disc station. If not set, the default "http" is used |
@@ -12082,71 +12097,71 @@ return;
define DS1 SSCAM SVS 192.168.2.20 [5000] [http]
define DS1 SSCAM SVS 192.168.2.20 [5001] [https]
- # creares a new SVS device DS1
+ # creares a new SVS device DS1
-
+
When a new Camera is defined, as a start the recordingtime of 15 seconds will be assigned to the device.Using the attribute "rectime" you can adapt the recordingtime for every camera individually.
The value of "0" for rectime will lead to an endless recording which has to be stopped by a "set <name> off" command.
Due to a Log-Entry with a hint to that circumstance will be written.
- + If the attribute "rectime" would be deleted again, the default-value for recording-time (15s) become active.
With command "set <name> on [rectime]" a temporary recordingtime is determinded which would overwrite the dafault-value of recordingtime
and the attribute "rectime" (if it is set) uniquely.
In that case the command "set <name> on 0" leads also to an endless recording as well.
- + If you have specified a pre-recording time in SVS it will be considered too.
- - If the module recognizes the defined camera as a PTZ-device (Reading "DeviceType = PTZ"), then a control panel is - created automatically in the detal view. This panel requires SVS >= 7.1. The properties and the behave of the + + If the module recognizes the defined camera as a PTZ-device (Reading "DeviceType = PTZ"), then a control panel is + created automatically in the detal view. This panel requires SVS >= 7.1. The properties and the behave of the panel can be affected by attributes "ptzPanel_.*".
Please see also command "set <name> createPTZcontrol" in this context.
- +
- +
-
After a camera-device is defined, firstly it is needed to save the credentials. This will be done with command:
-
-
+ +set <name> credentials <username> <password>- - The password length has a maximum of 20 characters.
- The operator can, dependend on what functions are planned to execute, create an user in DSM respectively in Synology + + The password length has a maximum of 20 characters.
+ The operator can, dependend on what functions are planned to execute, create an user in DSM respectively in Synology Surveillance Station as well.
- If the user is member of admin-group, he has access to all module functions. Without this membership the user can only + If the user is member of admin-group, he has access to all module functions. Without this membership the user can only execute functions with lower need of rights.
- Is 2-step verification + Is 2-step verification activated in DSM, the setup to a session with Surveillance Station is necessary (attribute "session = SurveillanceStation").
The required minimum rights to execute functions are listed in a table further down.
- - Alternatively to DSM-user a user created in SVS can be used. Also in that case a user of type "manager" has the right to + + Alternatively to DSM-user a user created in SVS can be used. Also in that case a user of type "manager" has the right to execute all functions,
- whereat the access to particular cameras can be restricted by the privilege profile (please see help function in SVS for + whereat the access to particular cameras can be restricted by the privilege profile (please see help function in SVS for details).
As best practice it is proposed to create an user in DSM as well as in SVS too:
- +
- DSM-User as member of admin group: unrestricted test of all module functions -> session: DSM
- SVS-User as Manager or observer: adjusted privilege profile -> session: SurveillanceStation
- - Using the Attribute "session" can be selected, if the session should be established to DSM or the - SVS instead. Further informations about user management in SVS are available by execute + + Using the Attribute "session" can be selected, if the session should be established to DSM or the + SVS instead. Further informations about user management in SVS are available by execute "get <name> versionNotes 5".
- If the session will be established to DSM, SVS Web-API methods are available as well as further API methods of other API's + If the session will be established to DSM, SVS Web-API methods are available as well as further API methods of other API's what possibly needed for processing.
- + After device definition the default is "login to DSM", that means credentials with admin rights can be used to test all camera-functions firstly.
After this the credentials can be switched to a SVS-session with a restricted privilege profile as needed on dependency what module functions are want to be executed.
- + The following list shows the minimum rights that the particular module function needs.
- set ... runView
- set ... setHome
- set ... setPreset
- set ... snap
- set ... snap
- set ... snapGallery
- set ... stopView
- set ... credentials
- get ... svsinfo
- get ... snapfileinfo
- get ... snapinfo
- get ... stmUrlPath
- get ... stmUrlPath
| session: ServeillanceStation - observer with privilege liveview of camera | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| - | |
| - | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer | |
| session: ServeillanceStation - observer |
- + HTTP-Timeout Settings
- -
-
+
+
- autocreateCams (valid for SVS)
- createStreamDev [generic | hls | lastsnap | mjpeg | switched] (valid for CAM)
respectively
createStreamDev [master] (valid for SVS)
- - A separate Streaming-Device (type SSCamSTRM) will be created. This device can be used as a discrete device in a dashboard + + A separate Streaming-Device (type SSCamSTRM) will be created. This device can be used as a discrete device in a dashboard for example. The current room of the parent camera device is assigned to the new device if it is set there.
- +master - with the master device another defined streaming device can be adopted and its content displayed
- - You can control the design with HTML tags in attribute htmlattr of the camera device or by +
+ + You can control the design with HTML tags in attribute htmlattr of the camera device or by specific attributes of the SSCamSTRM-device itself.
-
+
Streaming device "hls" - createPTZcontrol (valid for PTZ-CAM)
- createReadingsGroup [<name of readingsGroup>] (valid for CAM/SVS)
- createSnapGallery (valid for CAM)
- credentials <username> <password> (valid for CAM/SVS)
- delPreset <PresetName> (valid for PTZ-CAM)
- expmode [day|night|auto] (valid for CAM)
- extevent [ 1-10 ] (valid for SVS)
- goAbsPTZ [ X Y | up | down | left | right ] (valid for CAM)
-
All functions of SSCam use HTTP-calls to SVS Web API.
- You can set the attribute httptimeout > 0 to adjust + You can set the attribute httptimeout > 0 to adjust the value as needed in your technical environment.
- +
- - + + Set -
-
+
- The specified set-commands are available for CAM/SVS-devices or only valid for CAM-devices or rather for SVS-Devices. + The specified set-commands are available for CAM/SVS-devices or only valid for CAM-devices or rather for SVS-Devices. They can be selected in the drop-down-menu of the particular device.
- +
- - If a SVS device is defined, all in SVS integrated cameras are able to be created automatically in FHEM by this command. If the camera is already defined, - it is overleaped. - The new created camera devices are created in the same room as the used SVS device (default SSCam). Further helpful attributes are preset as well. + + If a SVS device is defined, all in SVS integrated cameras are able to be created automatically in FHEM by this command. If the camera is already defined, + it is overleaped. + The new created camera devices are created in the same room as the used SVS device (default SSCam). Further helpful attributes are preset as well.
- + The Streaming-device of type "hls" uses the library hls.js to playback the video stream and is executable on most current - browsers with MediaSource extensions (MSE). With attribuet "hlsNetScript" can be specified, whether - the local installed version of hls.js (./www/pgm2/sscam_hls.js) or the newest online library version from the hls.js + browsers with MediaSource extensions (MSE). With attribuet "hlsNetScript" can be specified, whether + the local installed version of hls.js (./www/pgm2/sscam_hls.js) or the newest online library version from the hls.js project site should be used. This attribute has to be set centrally in a device of type "SVS" !
- If this kind of streaming device is used, the attribute "hlsStrmObject" must be set in the parent + If this kind of streaming device is used, the attribute "hlsStrmObject" must be set in the parent camera device (see Internal PARENT).
- + Streaming device "switched hls"
- + This type of streaming device uses the HLS video stream native delivered by Synology Surveillance Station. If HLS (HTTP Live Streaming) is used in Streaming-Device of type "switched", then the camera has to be set to video format - H.264 in the Synology Surveillance Station and the SVS-Version has to support the HLS format. - Therefore the selection button of HLS is only provided by the Streaming-Device if the Reading "CamStreamFormat" contains + H.264 in the Synology Surveillance Station and the SVS-Version has to support the HLS format. + Therefore the selection button of HLS is only provided by the Streaming-Device if the Reading "CamStreamFormat" contains "HLS".
- HTTP Live Streaming is currently only available on Mac Safari or modern mobile iOS/Android devices. + HTTP Live Streaming is currently only available on Mac Safari or modern mobile iOS/Android devices.
Streaming device "generic"
- - A streaming device of type "generic" needs the complete definition of HTML-Tags by the attribute "genericStrmHtmlTag". + + A streaming device of type "generic" needs the complete definition of HTML-Tags by the attribute "genericStrmHtmlTag". These tags specify the content to playback.
-
@@ -12275,85 +12290,85 @@ attr <name> genericStrmHtmlTag <video $HTMLATTR controls autoplay>
<source src='http://192.168.2.10:32000/$NAME.m3u8' type='application/x-mpegURL'>
</video>
-attr <name> genericStrmHtmlTag <img $HTMLATTR
+attr <name> genericStrmHtmlTag <img $HTMLATTR
src="http://192.168.2.10:32774"
onClick="FW_okDialog('<img src=http://192.168.2.10:32774 $PWS>')"
- >
+ >
- The variables $HTMLATTR, $NAME and $PWS are placeholders and absorb the attribute "htmlattr" (if set), the SSCam-Devicename
+ The variables $HTMLATTR, $NAME and $PWS are placeholders and absorb the attribute "htmlattr" (if set), the SSCam-Devicename
respectively the value of attribute "popupWindowSize" in streamin-device, which specify the windowsize of a popup window.
- + Streaming device "lastsnap"
- - This type of streaming device playback the last (newest) snapshot. - As default the snapshot is retrieved in a reduced resolution. In order to use the original resolution, the attribute - "snapGallerySize = Full" has to be set in the associated camera device (compare Internal PARENT). - There also the attribute "pollcaminfoall" should be set to retrieve the newest snapshot regularly. -
- + + This type of streaming device playback the last (newest) snapshot. + As default the snapshot is retrieved in a reduced resolution. In order to use the original resolution, the attribute + "snapGallerySize = Full" has to be set in the associated camera device (compare Internal PARENT). + There also the attribute "pollcaminfoall" should be set to retrieve the newest snapshot regularly. +
+ Streaming Device "master"
- - This type cannot play back streams itself. Switching the playback of the content of another defined + + This type cannot play back streams itself. Switching the playback of the content of another defined Streaming Devices is done by the Set command adopt in the Master Streaming Device.
-
- - A separate PTZ control panel will be created (type SSCamSTRM). The current room of the parent camera device is - assigned if it is set there (default "SSCam"). + + A separate PTZ control panel will be created (type SSCamSTRM). The current room of the parent camera device is + assigned if it is set there (default "SSCam"). With the "ptzPanel_.*"-attributes or respectively the specific attributes of the SSCamSTRM-device - the properties of the control panel can be affected.
+ the properties of the control panel can be affected.
- - This command creates a readingsGroup device to display an overview of all defined SSCam devices. - A name for the new readingsGroup device can be specified. Is no own name specified, the readingsGroup device will be + + This command creates a readingsGroup device to display an overview of all defined SSCam devices. + A name for the new readingsGroup device can be specified. Is no own name specified, the readingsGroup device will be created with name "RG.SSCam". -
+
- - A snapshot gallery will be created as a separate device (type SSCamSTRM). The device will be provided in + + A snapshot gallery will be created as a separate device (type SSCamSTRM). The device will be provided in room "SSCam". With the "snapGallery..."-attributes respectively the specific attributes of the SSCamSTRM-device - you are able to manipulate the properties of the new snapshot gallery device. + you are able to manipulate the properties of the new snapshot gallery device.
- + Note
The camera names in Synology SVS should not be very similar, otherwise the retrieval of snapshots could come to inaccuracies.
- - set username / password combination for access the Synology Surveillance Station. + + set username / password combination for access the Synology Surveillance Station. See Credentials
for further informations. - +
- + Deletes a preset "<PresetName>". In FHEMWEB a drop-down list with current available presets is provieded.
- +
- +
- +
- - With this command you are able to control the exposure mode and can set it to day, night or automatic mode. - Thereby, for example, the behavior of camera LED's will be suitable controlled. + + With this command you are able to control the exposure mode and can set it to day, night or automatic mode. + Thereby, for example, the behavior of camera LED's will be suitable controlled. The successful switch will be reported by the reading CamExposureMode (command "get ... caminfoall").
- + Note:
The successfully execution of this function depends on if SVS supports that functionality of the connected camera. - Is the field for the Day/Night-mode shown greyed in SVS -> IP-camera -> optimization -> exposure mode, this function will be probably unsupported. + Is the field for the Day/Night-mode shown greyed in SVS -> IP-camera -> optimization -> exposure mode, this function will be probably unsupported.
- +
- - This command triggers an external event (1-10) in SVS. + + This command triggers an external event (1-10) in SVS. The actions which will are used have to be defined in the actionrule editor of SVS at first. There are the events 1-10 possible. In the message application of SVS you may select Email, SMS or Mobil (DS-Cam) messages to release if an external event has been triggerd. Further informations can be found in the online help of the actionrule editor. The used user needs to be a member of the admin-group and DSM-session is needed too.
- +
- - This command can be used to move a PTZ-camera to an arbitrary absolute X/Y-coordinate, or to absolute position using up/down/left/right. + + This command can be used to move a PTZ-camera to an arbitrary absolute X/Y-coordinate, or to absolute position using up/down/left/right. The option is only available for cameras which are having the Reading "CapPTZAbs=true". The property of a camera can be requested with "get <name> caminfoall" .
@@ -12406,13 +12421,13 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
set <name> goAbsPTZ 120 450
-
+
In this example the camera lense moves to position X=120 und Y=450. The valuation is:
X = 0 - 640 (0 - 319 moves lense left, 321 - 640 moves lense right, 320 don't move lense)
- Y = 0 - 480 (0 - 239 moves lense down, 241 - 480 moves lense up, 240 don't move lense)
+ Y = 0 - 480 (0 - 239 moves lense down, 241 - 480 moves lense up, 240 don't move lense)
The lense can be moved in smallest steps to very large steps into the desired direction.
@@ -12425,35 +12440,35 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
In this case the lense will be moved with largest possible increment into the given absolute position.
- Also in this case the procedure has to be repeated to bring the lense into the desired position if necessary.
+ Also in this case the procedure has to be repeated to bring the lense into the desired position if necessary.
- +
- goPreset <Preset> (valid for CAM)
- + Using this command you can move PTZ-cameras to a predefined position.
The Preset-positions have to be defined first of all in the Synology Surveillance Station. This usually happens in the PTZ-control of IP-camera setup in SVS. The Presets will be read ito FHEM with command "get <name> caminfoall" (happens automatically when FHEM restarts). The import process can be repeated regular by camera polling. - A long polling interval is recommendable in this case because of the Presets are only will be changed if the user change it in the IP-camera setup itself. + A long polling interval is recommendable in this case because of the Presets are only will be changed if the user change it in the IP-camera setup itself.
- + Here it is an example of a PTZ-control depended on IR-motiondetector event: - +
define CamFL.Preset.Wandschrank notify MelderTER:on.* set CamFL goPreset Wandschrank, ;; define CamFL.Preset.record at +00:00:10 set CamFL on 5 ;;;; define s3 at +*{3}00:00:05 set CamFL snap ;; define CamFL.Preset.back at +00:00:30 set CamFL goPreset Home
-
+
Operating Mode: - - The IR-motiondetector registers a motion. Hereupon the camera "CamFL" moves to Preset-posion "Wandschrank". A recording with the length of 5 seconds starts 10 seconds later. + + The IR-motiondetector registers a motion. Hereupon the camera "CamFL" moves to Preset-posion "Wandschrank". A recording with the length of 5 seconds starts 10 seconds later. Because of the prerecording time of the camera is set to 10 seconds (cf. Reading "CamPreRecTime"), the effectice recording starts when the camera move begins.
When the recording starts 3 snapshots with an interval of 5 seconds will be taken as well.
After a time of 30 seconds in position "Wandschrank" the camera moves back to postion "Home".
- + An extract of the log illustrates the process: - -
+
+
2016.02.04 15:02:14 2: CamFL - Camera Flur_Vorderhaus has moved to position "Wandschrank"
2016.02.04 15:02:24 2: CamFL - Camera Flur_Vorderhaus Recording with Recordtime 5s started
2016.02.04 15:02:29 2: CamFL - Snapshot of Camera Flur_Vorderhaus has been done successfully
@@ -12467,21 +12482,21 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
- homeMode [on|off] (valid for SVS)
- - Switch the HomeMode of the Surveillance Station on or off. + + Switch the HomeMode of the Surveillance Station on or off. Further informations about HomeMode you can find in the Synology Onlinehelp.
- motdetsc [camera|SVS|disable] (valid for CAM)
- + The command "motdetsc" (stands for "motion detection source") switchover the motion detection to the desired mode. If motion detection will be done by camera / SVS without any parameters, the original camera motion detection settings are kept. The successful execution of that opreration one can retrace by the state in SVS -> IP-camera -> event detection -> motion.
- + For the motion detection further parameter can be specified. The available options for motion detection by SVS are "sensitivity" and "threshold".
- +
- + If the motion detection is used by camera, there are the options "sensitivity", "object size", "percentage for release" available.
- +
- + Please consider always the sequence of parameters. Unwanted options have to be set to "0" if further options which have to be changed are follow (see example above). The numerical values are between 1 - 99 (except special case "0").
- - The each available options are dependend of camera type respectively the supported functions by SVS. Only the options can be used they are available in + + The each available options are dependend of camera type respectively the supported functions by SVS. Only the options can be used they are available in SVS -> edit camera -> motion detection. Further informations please read in SVS online help.
- - With the command "get <name> caminfoall" the Reading "CamMotDetSc" also will be updated which documents the current setup of motion detection. + + With the command "get <name> caminfoall" the Reading "CamMotDetSc" also will be updated which documents the current setup of motion detection. Only the parameters and parameter values supported by SVS at present will be shown. The camera itself may offer further options to adjust.
- + Example:
CamMotDetSc SVS, sensitivity: 76, threshold: 55
- +
- move [ right | up | down | left | dir_X ] [Sekunden] (valid for CAM up to SVS version 7.1) move [ right | upright | up | upleft | left | downleft | down | downright ] [Sekunden] (valid for CAM and SVS Version 7.2 and above)
- - With this command a continuous move of a PTZ-camera will be started. In addition to the four basic directions up/down/left/right is it possible to use angular dimensions + + With this command a continuous move of a PTZ-camera will be started. In addition to the four basic directions up/down/left/right is it possible to use angular dimensions "dir_X". The grain size of graduation depends on properties of the camera and can be identified by the Reading "CapPTZDirections".
- The radian measure of 360 degrees will be devided by the value of "CapPTZDirections" and describes the move drections starting with "0=right" counterclockwise. - That means, if a camera Reading is "CapPTZDirections = 8" it starts with dir_0 = right, dir_2 = top, dir_4 = left, dir_6 = bottom and respectively dir_1, dir_3, dir_5 and dir_7 + The radian measure of 360 degrees will be devided by the value of "CapPTZDirections" and describes the move drections starting with "0=right" counterclockwise. + That means, if a camera Reading is "CapPTZDirections = 8" it starts with dir_0 = right, dir_2 = top, dir_4 = left, dir_6 = bottom and respectively dir_1, dir_3, dir_5 and dir_7 the appropriate directions between. The possible moving directions of cameras with "CapPTZDirections = 32" are correspondingly divided into smaller sections.
In opposite to the "set <name> goAbsPTZ"-command starts "set <name> move" a continuous move until a stop-command will be received. The stop-command will be generated after the optional assignable time of [seconds]. If that retention period wouldn't be set by the command, a time of 1 second will be set implicit.
- + Examples:
- +
set <name> move up 0.5 : moves PTZ 0,5 Sek. (plus processing time) to the top
- set <name> move dir_1 1.5 : moves PTZ 1,5 Sek. (plus processing time) to top-right
+ set <name> move dir_1 1.5 : moves PTZ 1,5 Sek. (plus processing time) to top-right
set <name> move dir_20 0.7 : moves PTZ 1,5 Sek. (plus processing time) to left-bottom ("CapPTZDirections = 32)"
- +
- off (valid for CAM)
- Stops the current recording. + Stops the current recording.
- +
- on [<rectime>]
[recEmailTxt:"subject => <subject text>, body => <message text>"]
- [recTelegramTxt:"tbot => <TelegramBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>], option => [silent]"]
- [recChatTxt:"chatbot => <SSChatBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>]"]
+ [recTelegramTxt:"tbot => <TelegramBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>], option => [silent]"]
+ [recChatTxt:"chatbot => <SSChatBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>]"]
(valid for CAM) - a before started recording will be extend by the recording time "rectime" if a new start command is received. That means, the timer for the automatic stop-command will be - renewed to "rectime" given bei the command, attribute or default value. This procedure will be repeated every time a new start command for recording is received. + renewed to "rectime" given bei the command, attribute or default value. This procedure will be repeated every time a new start command for recording is received. Therefore a running recording will be extended until no start command will be get. -
- a before started endless-recording will be stopped after recordingtime 2rectime" if a new "set
on"-command is received (new set of timer). If it is unwanted make sure you + - a before started endless-recording will be stopped after recordingtime 2rectime" if a new "set
on"-command is received (new set of timer). If it is unwanted make sure you don't set the attribute "recextend" in case of endless-recordings. - a before started endless-recording will be stopped after recordingtime 2rectime" if a new "set
- - A recording will be started. The default recording time is 15 seconds. It can be individually changed by - the attribute "rectime". + + A recording will be started. The default recording time is 15 seconds. It can be individually changed by + the attribute "rectime". The recording time can be overwritten on-time by "set <name> on <rectime>" for the current recording. The recording will be stopped after processing time "rectime"automatically.
- A special case is start recording by "set <name> on 0" respectively the attribute value "rectime = 0". In this case + A special case is start recording by "set <name> on 0" respectively the attribute value "rectime = 0". In this case an endless-recording will be started. One have to explicitely stop this recording with command "set <name> off".
- Furthermore the recording behavior can be impacted with attribute "recextend" as explained as + Furthermore the recording behavior can be impacted with attribute "recextend" as explained as follows.
Attribute "recextend = 0" or not set (default):
@@ -12581,68 +12596,68 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Attribute "recextend = 1" is set:
- - The shipping of recording by Synology Chat can be activated permanently by setting attribute recChatTxt - Of course, the SSChatBot device which is + + The shipping of recording by Synology Chat can be activated permanently by setting attribute recChatTxt + Of course, the SSChatBot device which is used for send data, must be defined and fully functional before.
- If you want temporary overwrite the message text as set in attribute "recChatTxt", you can optionally specify the + If you want temporary overwrite the message text as set in attribute "recChatTxt", you can optionally specify the "recChatTxt:"-tag as shown above. If the attribute "recChatTxt" is not set, the shipping by Telegram is activated one-time. (the tag-syntax is equivalent to the "recChatTxt" attribute)
- - The Email shipping of recordings can be activated by setting attribute "recEmailTxt". - Before you have to prepare the Email shipping as described in section Setup Email shipping. + + The Email shipping of recordings can be activated by setting attribute "recEmailTxt". + Before you have to prepare the Email shipping as described in section Setup Email shipping. (for further information execute "get <name> versionNotes 7")
Alternatively you can activate the Email-shipping one-time when you specify the "recEmailTxt:"-tag in the "on"-command. In this case the tag-text is used for creating the Email instead the text specified in "recEmailTxt"-attribute. (the tag syntax is identical to the "recEmailTxt" attribute)
- - The shipping of the last recording by Telegram can be activated permanently by setting attribute - "recTelegramTxt". Of course, the TelegramBot device which is + + The shipping of the last recording by Telegram can be activated permanently by setting attribute + "recTelegramTxt". Of course, the TelegramBot device which is used, must be defined and fully functional before.
- If you want temporary overwrite the message text as set with attribute "recTelegramTxt", you can optionally specify the + If you want temporary overwrite the message text as set with attribute "recTelegramTxt", you can optionally specify the "recTelegramTxt:"-tag as shown above. If the attribute "recTelegramTxt" is not set, the shipping by Telegram is activated one-time. (the tag-syntax is equivalent to the "recTelegramTxt" attribute)
- + Examples:
set <name> on [rectime]
# starts a recording, stops automatically after [rectime]
- +
set <name> on 0 # starts a permanent record which must be stopped with the "off"-command.
- +
set <name> on recEmailTxt:"subject => New recording for $CAM created, body => The last recording of $CAM is atteched." # starts a recording and send it after completion by Email.
- +
set <name> on recTelegramTxt:"tbot => teleBot, peers => @xxxx , subject => Movement alarm by $CAM. The snapshot $FILE was created at $CTIME, option => silent" # starts a recording and send it after completion by Telegram in silent-mode.
- +
set <name> on recChatTxt:"chatbot => SynChatBot, peers => , subject => Movement alarm by $CAM. The snapshot $FILE was created at $CTIME." # starts a recording and send it after completion by Synology Chat.
- +
- optimizeParams [mirror:<value>] [flip:<value>] [rotate:<value>] [ntp:<value>] (gilt für CAM)
- mirror, flip, rotate: true | false -
- ntp: the name or the IP-address of time server +
- ntp: the name or the IP-address of time server
- - Set one or several properties of the camera. The video can be mirrored (mirror), turned upside down (flip) or - rotated (rotate). Specified properties must be supported by the camera type. With "ntp" you can set a time server the camera + + Set one or several properties of the camera. The video can be mirrored (mirror), turned upside down (flip) or + rotated (rotate). Specified properties must be supported by the camera type. With "ntp" you can set a time server the camera use for time synchronization.
- + <value> can be for:
- + Examples:
set <name> optimizeParams mirror:true flip:true ntp:time.windows.com # The video will be mirrored, turned upside down and the time server is set to "time.windows.com".
@@ -12650,32 +12665,32 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR # The Surveillance Station is set as time server. (NTP-service has to be activated in DSM)
set <name> optimizeParams mirror:true flip:false rotate:true # The video will be mirrored and rotated round 90 degrees.
- +
- pirSensor [activate | deactivate] (valid for CAM)
- - Activates / deactivates the infrared sensor of the camera (only posible if the camera has got a PIR sensor). + + Activates / deactivates the infrared sensor of the camera (only posible if the camera has got a PIR sensor).
- +
- runPatrol <Patrolname> (valid for CAM)
- + This commans starts a predefined patrol (tour) of a PTZ-camera.
At first the patrol has to be predefined in the Synology Surveillance Station. It can be done in the PTZ-control of IP-Kamera Setup -> PTZ-control -> patrol. The patrol tours will be read with command "get <name> caminfoall" which is be executed automatically when FHEM restarts. - The import process can be repeated regular by camera polling. A long polling interval is recommendable in this case because of the patrols are only will be changed - if the user change it in the IP-camera setup itself. + The import process can be repeated regular by camera polling. A long polling interval is recommendable in this case because of the patrols are only will be changed + if the user change it in the IP-camera setup itself. Further informations for creating patrols you can get in the online-help of Surveillance Station.
- +
- runView [live_fw | live_link | live_open [<room>] | lastrec_fw | lastrec_fw_MJPEG | lastrec_fw_MPEG4/H.264 | lastrec_open [<room>] | lastsnap_fw] (valid for CAM)
- +
- - With "live_fw, live_link" a MJPEG-Livestream will be started, either as an embedded image + + With "live_fw, live_link" a MJPEG-Livestream will be started, either as an embedded image or as a generated link.
- The option "live_open" starts a new browser window with a MJPEG-Livestream. If the optional "<room>" is set, the + The option "live_open" starts a new browser window with a MJPEG-Livestream. If the optional "<room>" is set, the window will only be started if the specified room is currently opened in a FHEMWEB-session.
- If a HLS-Stream by "live_fw_hls" is requested, the camera has to be setup to video format H.264 (not MJPEG) in the + If a HLS-Stream by "live_fw_hls" is requested, the camera has to be setup to video format H.264 (not MJPEG) in the Synology Surveillance Station and the SVS-Version has to support the HLS format. Therefore this possibility is only present if the Reading "CamStreamFormat" is set to "HLS". -
- +
+ Access to the last recording of a camera can be done using "lastrec_fw.*" respectively "lastrec_open". By "lastrec_fw" the recording will be opened in an iFrame. There are some control elements provided if available.
- The "lastrec_open" command can be extended optionally by a room. In this case the new window opens only, if the - room is the same as a FHEMWEB-session has currently opened.
+ The "lastrec_open" command can be extended optionally by a room. In this case the new window opens only, if the + room is the same as a FHEMWEB-session has currently opened.
The command "set <name> runView lastsnap_fw" shows the last snapshot of the camera embedded.
- The Streaming-Device properties can be affected by HTML-tags in attribute "htmlattr". + The Streaming-Device properties can be affected by HTML-tags in attribute "htmlattr".
- + Examples:
attr <name> htmlattr width="500" height="375"
attr <name> htmlattr width="700",height="525",top="200",left="300"
-
- The command "set <name> runView live_open" starts the stream immediately in a new browser window.
- A browser window will be initiated to open for every FHEMWEB-session which is active. If you want to change this behavior,
- you can use command "set <name> runView live_open <room>". In this case the new window opens only, if the
- room is the same as a FHEMWEB-session has currently opened. - The settings of attribute "livestreamprefix" overwrite the data for protocol, servername and + + The command "set <name> runView live_open" starts the stream immediately in a new browser window. + A browser window will be initiated to open for every FHEMWEB-session which is active. If you want to change this behavior, + you can use command "set <name> runView live_open <room>". In this case the new window opens only, if the + room is the same as a FHEMWEB-session has currently opened.
+ The settings of attribute "livestreamprefix" overwrite the data for protocol, servername and port in reading "LiveStreamUrl". - By "livestreamprefix" the LivestreamURL (is shown if attribute "showStmInfoFull" is set) can + By "livestreamprefix" the LivestreamURL (is shown if attribute "showStmInfoFull" is set) can be modified and used for distribution and external access to the Livestream.
- + Example:
attr <name> livestreamprefix https://<Servername>:<Port>
-
+
The livestream can be stopped again by command "set <name> stopView".
The "runView" function also switches Streaming-Devices of type "switched" into the appropriate mode. - + Dependend of the content to playback, different control buttons are provided:
-
-
-
- setHome <PresetName> (valid for PTZ-CAM)
- setPreset <PresetNumber> [<PresetName>] [<Speed>] (valid for PTZ-CAM)
- setZoom < .++ | + | stop | - | --. > (valid for PTZ-CAM)
- snap [<number>] [<time difference>]
- + [snapEmailTxt:"subject => <subject text>, body => <message text>"]
[snapTelegramTxt:"tbot => <TelegramBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>], option => [silent]"]
[snapChatTxt:"chatbot => <SSChatBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>]"]
(valid for CAM) - snapCams [<number>] [<time difference>] [CAM:"<camera>, <camera>, ..."] (valid for SVS)
- snapGallery [1-10] (valid for CAM)
- startTracking (valid for CAM with tracking capability)
- stopTracking (valid for CAM with tracking capability)
- apiInfo
- + Retrieves the API information of the Synology Surveillance Station and open a popup window with its data.
- caminfoall (valid for CAM/SVS) +
- caminfoall (valid for CAM/SVS) caminfo (valid for CAM)
- eventlist (valid for CAM)
- homeModeState (valid for SVS)
- listLog [severity:<Loglevel>] [limit:<Number of lines>] [match:<Searchstring>] (valid for SVS)
- + Fetches the Surveillance Station Log from Synology server. Without any further options the whole log will be retrieved.
You can specify all or any of the following options:
- +- <Loglevel> - Information, Warning or Error. Only datasets having this severity are retrieved (default: all)
- <Number of lines> - the specified number of lines (newest) of the log are retrieved (default: all) @@ -12959,7 +12974,7 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
-
+
Examples - listPresets (valid for PTZ-CAM)
- saveLastSnap [<Pfad>] (gilt für CAM)
- saveRecording [<path>] (valid for CAM)
- scanVirgin (valid for CAM/SVS)
- snapGallery [1-10] (valid for CAM)
- snapGalleryBoost -
- snapGalleryColumns -
- snapGalleryHtmlAttr -
- snapGalleryNumber -
- snapGallerySize +
- snapGalleryBoost +
- snapGalleryColumns +
- snapGalleryHtmlAttr +
- snapGalleryNumber +
- snapGallerySize
- snapfileinfo (valid for CAM)
- snapinfo (valid for CAM)
- stmUrlPath (valid for CAM)
- storedCredentials (valid for CAM/SVS)
- svsinfo (valid for CAM/SVS)
- versionNotes [hints | rel | <key>] (valid for CAM/SVS)
- PollState = Active - automatic polling will be executed with interval correspondig value of attribute "pollcaminfoall"
- PollState = Inactive - automatic polling won't be executed
- CAMID - the ID of camera defined in SVS, the value will be retrieved automatically on the basis of SVS-cameraname
- CAMNAME - the name of the camera in SVS
- COMPATIBILITY - information up to which SVS-version the module version is currently released/tested (see also Reading "compstate") -
- CREDENTIALS - the value is "Set" if Credentials are set +
- CREDENTIALS - the value is "Set" if Credentials are set
- NAME - the cameraname in FHEM
- MODEL - distinction between camera device (CAM) and Surveillance Station device (SVS) -
- OPMODE - the last executed operation of the module +
- OPMODE - the last executed operation of the module
- SERVERADDR - IP-Address of SVS Host
- SERVERPORT - SVS-Port
- cacheServerParam
+ - cacheServerParam
Specification of connection parameters to a central data cache.
-+
- +redis : if network connection is used: <IP-address>:<port> / if Unix-Socket is used: <unix>:</path/to/socket>
-
- +
+- cacheType
- Defines the used Cache for storage of snapshots, recordings und other mass data. + Defines the used Cache for storage of snapshots, recordings und other mass data. (Default: internal).
Maybe further perl modules have to be installed, e.g. with help of the FHEM Installer.
The data are saved in "Namespaces" to permit the usage of central Caches (e.g. redis).
- The cahe types "file" and "redis" are convenient if the data shouldn't be hold in the RAM of the FHEM-Server. + The cahe types "file" and "redis" are convenient if the data shouldn't be hold in the RAM of the FHEM-Server. For the usage of Redis at first a the Redis Key-Value Store has to be provide, e.g. in a Docker image on the Synology Diskstation (redis).
-+
- +internal : use the module internal storage (Default) mem : very fast Cache, copy data into the RAM file : create and use a file structure in subdirectory "FhemUtils" redis : use a external Redis Key-Value Store over TCP/IP or Unix-Socket. Please see also attribute "cacheServerParam".
-
- +
+- debugactivetoken
- If set, the state of active token will be logged - only for debugging, don't use it in normal operation ! + If set, the state of active token will be logged - only for debugging, don't use it in normal operation !
- + -- debugCachetime
- Shows the consumed time of cache operations. +- debugCachetime
+ Shows the consumed time of cache operations.
- +- disable
- deactivates the device definition + deactivates the device definition
- +- genericStrmHtmlTag
- +
- This attribute contains HTML-Tags for video-specification in a Streaming-Device of type "generic". - (see also "set <name> createStreamDev generic")
- + This attribute contains HTML-Tags for video-specification in a Streaming-Device of type "generic". + (see also "set <name> createStreamDev generic")
+-
Examples:
attr <name> genericStrmHtmlTag <video $HTMLATTR controls autoplay> <source src='http://192.168.2.10:32000/$NAME.m3u8' type='application/x-mpegURL'> - </video> - -attr <name> genericStrmHtmlTag <img $HTMLATTR + </video> + +attr <name> genericStrmHtmlTag <img $HTMLATTR src="http://192.168.2.10:32774" onClick="FW_okDialog('<img src=http://192.168.2.10:32774 $PWS>')" - > + >- The variables $HTMLATTR, $NAME and $PWS are placeholders and absorb the attribute "htmlattr" (if set), the SSCam-Devicename + The variables $HTMLATTR, $NAME and $PWS are placeholders and absorb the attribute "htmlattr" (if set), the SSCam-Devicename respectively the value of attribute "popupWindowSize" in streaming-device, which specify the windowsize of a popup window.
- hlsNetScript (settable in device model "SVS")
- If set, the latest hls.js library version from the project site is used (internet connection is needed). + If set, the latest hls.js library version from the project site is used (internet connection is needed).
- In default the local installed library version (./www/pgm2/sscam_hls.js) is uses for playback in all streaming devices + In default the local installed library version (./www/pgm2/sscam_hls.js) is uses for playback in all streaming devices of type "hls" (please see also "set <name> createStreamDev hls"). This attribute has to be set in a device model "SVS" and applies to all streaming devices !
- +- hlsStrmObject
- +
- If a streaming device was defined by "set <name> createStreamDev hls", this attribute has to be set and must contain the + If a streaming device was defined by "set <name> createStreamDev hls", this attribute has to be set and must contain the link to the video object to play back.
The attribute must specify a HTTP Live Streaming object with the extension ".m3u8".
The variable $NAME can be used as a placeholder and will be replaced by the camera device name. -
- +
+-
Examples:
attr <name> hlsStrmObject https://bitdash-a.akamaihd.net/content/MI201109210084_1/m3u8s/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8
attr <name> hlsStrmObject https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8
# Sample video streams used for testing the streaming device function (internet connection is needed)
- + attr <name> hlsStrmObject http://192.168.2.10:32000/CamHE1.m3u8
# playback a HLS video stream of a camera witch is delivered by e.g. a ffmpeg conversion process
- + attr <name> hlsStrmObject http://192.168.2.10:32000/$NAME.m3u8
- # Same as example above, but use the replacement with variable $NAME for "CamHE1" + # Same as example above, but use the replacement with variable $NAME for "CamHE1"
- httptimeout
- Timeout-Value of HTTP-Calls to Synology Surveillance Station.
+ Timeout-Value of HTTP-Calls to Synology Surveillance Station.
(default: 20 seconds)
- +- htmlattr
additional specifications to inline oictures to manipulate the behavior of stream, e.g. size of the image.
- +-
Example:
attr <name> htmlattr width="500" height="325" top="200" left="300"
- +- livestreamprefix
- Overwrites the specifications of protocol, servername and port for further use in livestream address and + Overwrites the specifications of protocol, servername and port for further use in livestream address and StmKey.*-readings , e.g. as a link for external use.
- It can be specified of two ways as follows:
+ It can be specified of two ways as follows:
-+
DEF : the protocol, servername and port as specified in device + DEF : the protocol, servername and port as specified in device definition is used http(s)://<servername>:<port> : your own address specification is used
- Servername can be the name or the IP-address of your Synology Surveillance Station. + Servername can be the name or the IP-address of your Synology Surveillance Station.
- loginRetries
set the amount of login-repetitions in case of failure (default = 3)
- +- noQuotesForSID
- This attribute delete the quotes for SID and for StmKeys. - The attribute may be helpful in some cases to avoid errormessages "402 - permission denied" or "105 - + This attribute delete the quotes for SID and for StmKeys. + The attribute may be helpful in some cases to avoid errormessages "402 - permission denied" or "105 - Insufficient user privilege" and makes login possible.
- (default: 0) + (default: 0)
- +- pollcaminfoall
- Interval of automatic polling the Camera properties (<= 10: no polling, > 10: polling with interval) + Interval of automatic polling the Camera properties (<= 10: no polling, > 10: polling with interval)
- pollnologging
"0" resp. not set = Logging device polling active (default), "1" = Logging device polling inactive
- - + +- ptzNoCapPrePat
- Some PTZ cameras cannot store presets and patrols despite their PTZ capabilities. - To avoid errors and corresponding log messages, the attribute ptzNoCapPrePat can be set in these cases. + Some PTZ cameras cannot store presets and patrols despite their PTZ capabilities. + To avoid errors and corresponding log messages, the attribute ptzNoCapPrePat can be set in these cases. The system will be notified of a missing preset / patrol capability. -
- +
+- ptzPanel_Home
- In the PTZ-control panel the Home-Icon (in attribute "ptzPanel_row02") is automatically assigned to the value of + In the PTZ-control panel the Home-Icon (in attribute "ptzPanel_row02") is automatically assigned to the value of Reading "PresetHome". - With "ptzPanel_Home" you can change the assignment to another preset from the available Preset list. -
- - + With "ptzPanel_Home" you can change the assignment to another preset from the available Preset list. +
+ +- ptzPanel_iconPath
- Path for icons used in PTZ-control panel, default is "www/images/sscam". + Path for icons used in PTZ-control panel, default is "www/images/sscam". The attribute value will be used for all icon-files except *.svg.
For further information execute "get <name> versionNotes 2,6". -
+
- ptzPanel_iconPrefix
- Prefix for icons used in PTZ-control panel, default is "black_btn_". + Prefix for icons used in PTZ-control panel, default is "black_btn_". The attribute value will be used for all icon-files except *.svg.
If the used icon-files begin with e.g. "black_btn_" ("black_btn_CAMDOWN.png"), the icon needs to be defined in attributes "ptzPanel_row[00-09]" just with the subsequent part of name, e.g. "CAMDOWN.png". -
+
- ptzPanel_row[00-09] <command>:<icon>,<command>:<icon>,...
- For PTZ-cameras the attributes "ptzPanel_row00" to "ptzPanel_row04" are created automatically for usage by + For PTZ-cameras the attributes "ptzPanel_row00" to "ptzPanel_row04" are created automatically for usage by the PTZ-control panel.
- The attributes contain a comma spareated list of command:icon-combinations (buttons) each panel line. - One panel line can contain a random number of buttons. The attributes "ptzPanel_row00" to "ptzPanel_row04" can't be + The attributes contain a comma spareated list of command:icon-combinations (buttons) each panel line. + One panel line can contain a random number of buttons. The attributes "ptzPanel_row00" to "ptzPanel_row04" can't be deleted because of they are created automatically again in that case. The user can change or complement the attribute values. These changes are conserved.
If needed the assignment for Home-button in "ptzPanel_row02" can be changed by attribute "ptzPanel_Home".
The icons are searched in path "ptzPanel_iconPath". The value of "ptzPanel_iconPrefix" is prepend to the icon filename. - Own extensions of the PTZ-control panel can be done using the attributes "ptzPanel_row05" to "ptzPanel_row09". - For creation of own icons a template is provided in the SVN. Further information can be get by "get <name> versionNotes 2". + Own extensions of the PTZ-control panel can be done using the attributes "ptzPanel_row05" to "ptzPanel_row09". + For creation of own icons a template is provided in the SVN. Further information can be get by "get <name> versionNotes 2".
- + Note:
- For an empty field please use ":CAMBLANK.png" respectively ":CAMBLANK.png,:CAMBLANK.png,:CAMBLANK.png,..." for an empty + For an empty field please use ":CAMBLANK.png" respectively ":CAMBLANK.png,:CAMBLANK.png,:CAMBLANK.png,..." for an empty line.
- +-
Example:
attr <name> ptzPanel_row00 move upleft:CAMUPLEFTFAST.png,:CAMBLANK.png,move up:CAMUPFAST.png,:CAMBLANK.png,move upright:CAMUPRIGHTFAST.png
# The command "move upleft" is transmitted to the camera by pressing the button(icon) "CAMUPLEFTFAST.png".
-
+
- ptzPanel_use
- Switch the usage of a PTZ-control panel in detail view respectively a created StreamDevice off or on + Switch the usage of a PTZ-control panel in detail view respectively a created StreamDevice off or on (default: on).
- The PTZ panel use its own icons. - Thereby the system find the icons, in FHEMWEB device the attribute "iconPath" has to be completed by "sscam" - (e.g. "attr WEB iconPath default:fhemSVG:openautomation:sscam"). -
- + The PTZ panel use its own icons. + Thereby the system find the icons, in FHEMWEB device the attribute "iconPath" has to be completed by "sscam" + (e.g. "attr WEB iconPath default:fhemSVG:openautomation:sscam"). +
+- recChatTxt chatbot => <SSChatBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>]
Activates the permanent shipping of recordings by Synology Chat after its creation.
- Before activating the attribute videofolderMap has to be set. It must contain an URL to the + Before activating the attribute videofolderMap has to be set. It must contain an URL to the root directory of your SVS recordings and snapshots ( e.g. http://server.me:8081/surveillance ).
- The attribute recChatTxt has to be defined in the form as described. With key "chatbot" the SSChatBot device is specified, - which is used for sending the data. Of course, the SSChatBot device - must be available and work well.
- The setting of "peers" is optional, but the keys must be (empty) specified. + The attribute recChatTxt has to be defined in the form as described. With key "chatbot" the SSChatBot device is specified, + which is used for sending the data. Of course, the SSChatBot device + must be available and work well.
+ The setting of "peers" is optional, but the keys must be (empty) specified. If "peer" is empty, the defaultPeer of the SSChatBot device is used.
- + You can use the following placeholders within "subject".
- --
-
- recEmailTxt subject => <subject text>, body => <message text>
Activates the Email shipping of recordings after whose creation.
- The attribute must be defined in the specified form.
+ The attribute must be defined in the specified form.
The following placeholders can be used in the subject or body.
- --
-
- recTelegramTxt tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Text>], option => [silent]
Enables permanent sending of recordings after their creation via TelegramBot.
- The attribute must be defined in the specified form. + The attribute must be defined in the specified form. For optional specifications, the key must be specified >empty<.
- + Meaning of the keys:
- --
-
- rectime
- determines the recordtime when a recording starts. If rectime = 0 an endless recording will be started. If + determines the recordtime when a recording starts. If rectime = 0 an endless recording will be started. If it isn't defined, the default recordtime of 15s is activated - recextend
- "rectime" of a started recording will be set new. Thereby the recording time of the running recording will be + "rectime" of a started recording will be set new. Thereby the recording time of the running recording will be extended - session
- selection of login-Session. Not set or set to "DSM" -> session will be established to DSM (Sdefault). + selection of login-Session. Not set or set to "DSM" -> session will be established to DSM (Sdefault). "SurveillanceStation" -> session will be established to SVS.
For establish a sesion with Surveillance Station you have to create a user with suitable privilege profile in SVS. If you need more infomations please execute "get <name> versionNotes 5". - simu_SVSversion
- A logical "downgrade" to the specified SVS version is performed. The attribute is useful to temporarily eliminate + A logical "downgrade" to the specified SVS version is performed. The attribute is useful to temporarily eliminate incompatibilities that may occur when updating/upgrading Synology Surveillance Station. - Incompatibilities should be reported to the maitainer in a timely manner. + Incompatibilities should be reported to the maitainer in a timely manner. - smtpHost <Hostname>
The name or IP-address of outgoing email server (e.g. securesmtp.t-online.de). @@ -13622,61 +13639,61 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Optional you can enter a carbon-copy receiving address. Several receiving addresses are separated by ",". - smtpDebug
Switch the debugging mode for SMTP connection on (if Email shipping is used). - smtpFrom <name>@<domain>
Return address if Email shipping is used. - smtpPort <Port>
Optional setting of default SMTP port of outgoing email server (default: 25). - smtpSSLPort <Port>
- Optional setting of SSL port of outgoing email server (default: 465). If set, the established connection to the Email + Optional setting of SSL port of outgoing email server (default: 465). If set, the established connection to the Email server will be encrypted immediately. - smtpTo <name>@<domain>[, <name>@<domain>][, <name>@<domain>]...
Receiving address for emal shipping. Several receiving addresses are separated by ",". - smtpNoUseSSL
If no Email SSL encryption should be used, set this attribute to "1" (default: 0). - snapChatTxt chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<subject text>]
- Activates the permanent shipping of snapshots by Synology Chat after their creation. If several snapshots were triggert, + Activates the permanent shipping of snapshots by Synology Chat after their creation. If several snapshots were triggert, they will be sequentially delivered.
- Before activating the attribute videofolderMap has to be set. It must contain an URL to the + Before activating the attribute videofolderMap has to be set. It must contain an URL to the root directory of your SVS recordings and snapshots ( e.g. http://server.me:8081/surveillance ).
- The attribute snapChatTxt has to be defined in the form as described. With key "chatbot" the SSChatBot device is specified, - which is used for sending the data. Of course, the SSChatBot device + The attribute snapChatTxt has to be defined in the form as described. With key "chatbot" the SSChatBot device is specified, + which is used for sending the data. Of course, the SSChatBot device must be available and work well.
The key "peers" contains valid names of Synology Chat Users who should receive the message.
- The setting of "peers" is optional, but the keys must (empty) specified. + The setting of "peers" is optional, but the keys must (empty) specified. If "peer" is empty, the defaultPeer of the SSChatBot device is used.
- + You can use the following placeholders within "subject".
- --
-
- snapEmailTxt subject => <subject text>, body => <message text>
Activates the Email shipping of snapshots after whose creation.
The attribute must be defined in the specified form.
The following placeholders can be used in the subject or body.
- --
-
- snapTelegramTxt tbot => <TelegramBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>], option => [silent]
- Enables permanent sending of snapshots after their creation via TelegramBot. + Enables permanent sending of snapshots after their creation via TelegramBot. If several snapshots were triggered, they are sent sequentially.
- The attribute must be defined in the specified form. + The attribute must be defined in the specified form. For optional specifications, the key must be specified >empty<.
- + Meaning of the keys:
- --
-
- snapGalleryBoost
If set, the last snapshots (default 3) will be retrieved by Polling, will be stored in the FHEM-servers main memory and can be displayed by the "set/get ... snapGallery" command.
- This mode is helpful if many or full size images shall be displayed. - If the attribute is set, you can't specify arguments in addition to the "set/get ... snapGallery" command. + This mode is helpful if many or full size images shall be displayed. + If the attribute is set, you can't specify arguments in addition to the "set/get ... snapGallery" command. (see also attribut "snapGalleryNumber") - snapGalleryColumns
The number of snapshots which shall appear in one row of the gallery popup (default 3). - snapGalleryHtmlAttr
the image parameter can be controlled by this attribute.
If the attribute isn't set, the value of attribute "htmlattr" will be used.
If "htmlattr" is also not set, default parameters are used instead (width="500" height="325").
- +-
Example:
attr <name> snapGalleryHtmlAttr width="325" height="225"
-
-
+
+
- snapGalleryNumber
The number of snapshots to retrieve (default 3). - snapGallerySize
By this attribute the quality of the snapshot images can be controlled (default "Icon").
- If mode "Full" is set, the images are retrieved with their original available resolution. That requires more ressources + If mode "Full" is set, the images are retrieved with their original available resolution. That requires more ressources and may slow down the display. By setting attribute "snapGalleryBoost=1" the display may accelerated, because in that case the images will be retrieved by continuous polling and need only bring to display. - snapReadingRotate 0...10
- Activates the version control of snapshot readings (default: 0). A consecutive number of readings "LastSnapFilename", + Activates the version control of snapshot readings (default: 0). A consecutive number of readings "LastSnapFilename", "LastSnapId" and "LastSnapTime" until to the specified value of snapReadingRotate will be created and contain the data of the last X snapshots. - showStmInfoFull
additional stream informations like LiveStreamUrl, StmKeyUnicst, StmKeymjpegHttp will be created - showPassInLog
if set the used password will be shown in logfile with verbose 4. (default = 0) - videofolderMap
- Replaces the content of reading "VideoFolder". Use it if e.g. folders are mountet with different names than original + Replaces the content of reading "VideoFolder". Use it if e.g. folders are mountet with different names than original in SVS or providing an URL for acces the snapshots / recordings by a web server. - verbose
- readingFnAttributes - - + +
- CamAudioType
- Availability
- HomeModeState
- LastLogEntry
- LastSnapFilename[x]
- LastSnapId[x]
- LastSnapTime[x]
- LastUpdateTime
- LiveStreamUrl
- LastSnapId[x]
- LastSnapTime[x]
- LastUpdateTime
- LiveStreamUrl
- Patrols
- PollState
- PollState
- PresetHome
- Presets
- Record
- StmKey
- StmKeyUnicst
- StmKeymjpegHttp
- SVScustomPortHttp
- Record
- StmKey
- StmKeyUnicst
- StmKeymjpegHttp
- SVScustomPortHttp
- SVScustomPortHttps
- SVSlicenseNumber
- SVSuserPriv
- compstate
- lokales Abspeichern der letzten Kamera-Aufnahme bzw. des letzten Schnappschusses
- Auswahl unterschiedlicher Cache-Typen zur Bilddatenspeicherung (Attribut cacheType)
- ausführen von Zoom-Aktionen (bei PTZ-Kameras die Zoom unterstützen) -
- DSM-User als Mitglied der Admin-Gruppe: uneingeschränkter Test aller Modulfunktionen -> session: DSM
- SVS-User als Manager oder Betrachter: angepasstes Privilegienprofil -> session: SurveillanceStation
- autocreateCams (gilt für SVS)
- createStreamDev [generic | hls | lastsnap | mjpeg | switched] (gilt für CAM)
@@ -14232,11 +14251,11 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR createStreamDev [master] (gilt für SVS)
- Es wird ein separates Streaming-Device (Typ SSCamSTRM) erstellt. Dieses Device kann z.B. als separates Device + Es wird ein separates Streaming-Device (Typ SSCamSTRM) erstellt. Dieses Device kann z.B. als separates Device in einem Dashboard genutzt werden. - Dem Streaming-Device wird der aktuelle Raum des Kameradevice zugewiesen sofern dort gesetzt. + Dem Streaming-Device wird der aktuelle Raum des Kameradevice zugewiesen sofern dort gesetzt.
- +
- - Die Gestaltung kann durch HTML-Tags im Attribut htmlattr im Kameradevice oder mit den + + Die Gestaltung kann durch HTML-Tags im Attribut htmlattr im Kameradevice oder mit den spezifischen Attributen im Streaming-Device beeinflusst werden.
-
-
+
+
Streaming Device "hls" - createPTZcontrol (gilt für PTZ-CAM)
- createReadingsGroup [<Name der readingsGroup>] (gilt für CAM/SVS)
- createSnapGallery (gilt für CAM)
- credentials <username> <password> (gilt für CAM/SVS)
- delPreset <PresetName> (gilt für PTZ-CAM)
- expmode [day|night|auto] (gilt für CAM)
- extevent [ 1-10 ] (gilt für SVS)
- goAbsPTZ [ X Y | up | down | left | right ] (gilt für CAM)
- - Mit diesem Kommando wird eine PTZ-Kamera in Richtung einer wählbaren absoluten X/Y-Koordinate bewegt, oder zur maximalen - Absolutposition in Richtung up/down/left/right. - Die Option ist nur für Kameras verfügbar die das Reading "CapPTZAbs=true" (die Fähigkeit für PTZAbs-Aktionen) besitzen. Die + + Mit diesem Kommando wird eine PTZ-Kamera in Richtung einer wählbaren absoluten X/Y-Koordinate bewegt, oder zur maximalen + Absolutposition in Richtung up/down/left/right. + Die Option ist nur für Kameras verfügbar die das Reading "CapPTZAbs=true" (die Fähigkeit für PTZAbs-Aktionen) besitzen. Die Eigenschaften der Kamera kann mit "get <name> caminfoall" abgefragt werden.
@@ -14422,17 +14441,17 @@ attr <name> genericStrmHtmlTag <img $HTMLATTRset <name> goAbsPTZ 120 450- + Dieses Beispiel bewegt die Kameralinse in die Position X=120 und Y=450.
Der Wertebereich ist dabei:X = 0 - 640 (0 - 319 bewegt nach links, 321 - 640 bewegt nach rechts, 320 bewegt die Linse nicht) - Y = 0 - 480 (0 - 239 bewegt nach unten, 241 - 480 bewegt nach oben, 240 bewegt die Linse nicht) + Y = 0 - 480 (0 - 239 bewegt nach unten, 241 - 480 bewegt nach oben, 240 bewegt die Linse nicht)- Die Linse kann damit in kleinsten bis sehr großen Schritten in die gewünschte Richtung bewegt werden. - Dieser Vorgang muß ggf. mehrfach wiederholt werden um die Kameralinse in die gewünschte Position zu bringen. + Die Linse kann damit in kleinsten bis sehr großen Schritten in die gewünschte Richtung bewegt werden. + Dieser Vorgang muß ggf. mehrfach wiederholt werden um die Kameralinse in die gewünschte Position zu bringen. - goPreset <Preset> (gilt für CAM)
- homeMode [on|off] (gilt für SVS)
- motdetsc [camera [<options>] | SVS [<options>] | disable] (gilt für CAM)
- - Der Befehl schaltet die Bewegungserkennung in den gewünschten Modus. - Wird die Bewegungserkennung durch die Kamera / SVS ohne weitere Optionen eingestellt, werden die momentan gültigen Bewegungserkennungsparameter der + + Der Befehl schaltet die Bewegungserkennung in den gewünschten Modus. + Wird die Bewegungserkennung durch die Kamera / SVS ohne weitere Optionen eingestellt, werden die momentan gültigen Bewegungserkennungsparameter der Kamera / SVS beibehalten. Optionen können in einem Script verwendet werden. - move [ right | up | down | left | dir_X ] [Sekunden] (gilt für CAM bis SVS Version 7.1) +
- move [ right | up | down | left | dir_X ] [Sekunden] (gilt für CAM bis SVS Version 7.1) move [ right | upright | up | upleft | left | downleft | down | downright ] [Sekunden] (gilt für CAM ab SVS Version 7.2)
- off (gilt für CAM)
- on [<rectime>]
[recEmailTxt:"subject => <Betreff-Text>, body => <Mitteilung-Text>"]
[recTelegramTxt:"tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>], option => [silent]"]
- [recChatTxt:"chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>]"]
+ [recChatTxt:"chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>]"]
(gilt für CAM) - Eine zuvor gestartete Aufnahme wird bei einem erneuten "set
on" -Befehl um die Aufnahmezeit "rectime" verlängert. Das bedeutet, dass der Timer für - den automatischen Stop auf den Wert "rectime" neu gesetzt wird. Dieser Vorgang wiederholt sich mit jedem Start-Befehl. Dadurch verlängert sich eine laufende + - Eine zuvor gestartete Aufnahme wird bei einem erneuten "set
-on" -Befehl um die Aufnahmezeit "rectime" verlängert. Das bedeutet, dass der Timer für + den automatischen Stop auf den Wert "rectime" neu gesetzt wird. Dieser Vorgang wiederholt sich mit jedem Start-Befehl. Dadurch verlängert sich eine laufende Aufnahme bis kein Start-Inpuls mehr registriert wird. - eine zuvor gestartete Endlos-Aufnahme wird mit einem erneuten "set
on"-Befehl nach der Aufnahmezeit "rectime" gestoppt (Timerneustart). Ist dies + - eine zuvor gestartete Endlos-Aufnahme wird mit einem erneuten "set
on"-Befehl nach der Aufnahmezeit "rectime" gestoppt (Timerneustart). Ist dies nicht gewünscht, ist darauf zu achten dass bei der Verwendung einer Endlos-Aufnahme das Attribut "recextend" nicht verwendet wird. - Eine zuvor gestartete Aufnahme wird bei einem erneuten "set
- optimizeParams [mirror:<value>] [flip:<value>] [rotate:<value>] [ntp:<value>] (gilt für CAM)
- mirror, flip, rotate: true | false -
- ntp: der Name oder die IP-Adresse des Zeitservers +
- ntp: der Name oder die IP-Adresse des Zeitservers
- pirSensor [activate | deactivate] (gilt für CAM)
- runPatrol <Patrolname> (gilt für CAM)
- runView [live_fw | live_fw_hls | live_link | live_open [<room>] | lastrec_fw | lastrec_fw_MJPEG | lastrec_fw_MPEG4/H.264 | lastrec_open [<room>] | lastsnap_fw] (gilt für CAM)
- setHome <PresetName> (gilt für PTZ-CAM)
- setPreset <PresetNummer> [<PresetName>] [<Speed>] (gilt für PTZ-CAM)
- setZoom < .++ | + | stop | - | --. > (gilt für PTZ-CAM)
- smtpcredentials <user> <password> (gilt für CAM)
- snap [<Anzahl>] [<Zeitabstand>]
[snapEmailTxt:"subject => <Betreff-Text>, body => <Mitteilung-Text>"]
[snapTelegramTxt:"tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>], option => [silent]"]
[snapChatTxt:"chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>]"]
(gilt für CAM) - snapCams [<Anzahl>] [<Zeitabstand>] [CAM:"<Kamera>, <Kamera>, ..."] (gilt für SVS)
- snapGallery [1-10] (gilt für CAM)
- startTracking (gilt für CAM mit Tracking Fähigkeit)
- stopTracking (gilt für CAM mit Tracking Fähigkeit)
- apiInfo
- + Ruft die API Informationen der Synology Surveillance Station ab und öffnet ein Popup mit diesen Informationen.
- caminfoall (gilt für CAM/SVS) caminfo (gilt für CAM)
- eventlist (gilt für CAM)
- homeModeState (gilt für SVS)
- listLog [severity:<Loglevel>] [limit:<Zeilenzahl>] [match:<Suchstring>] (gilt für SVS)
- + Ruft das Surveillance Station Log vom Synology Server ab. Ohne Angabe der optionalen Zusätze wird das gesamte Log abgerufen.
Es können alle oder eine Auswahl der folgenden Optionen angegeben werden:
- +- <Loglevel> - Information, Warning oder Error. Nur Sätze mit dem Schweregrad werden abgerufen (default: alle)
- <Zeilenzahl> - die angegebene Anzahl der Logzeilen (neueste) wird abgerufen (default: alle) @@ -15006,225 +15025,225 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
-
+
Beispiele - listPresets (gilt für PTZ-CAM)
- saveLastSnap [<Pfad>] (gilt für CAM)
- saveRecording [<Pfad>] (gilt für CAM)
- scanVirgin (gilt für CAM/SVS)
- snapGallery [1-10] (gilt für CAM)
- snapGalleryBoost -
- snapGalleryColumns -
- snapGalleryHtmlAttr -
- snapGalleryNumber -
- snapGallerySize +
- snapGalleryBoost +
- snapGalleryColumns +
- snapGalleryHtmlAttr +
- snapGalleryNumber +
- snapGallerySize
- snapfileinfo (gilt für CAM)
- snapinfo (gilt für CAM)
- stmUrlPath (gilt für CAM)
- storedCredentials (gilt für CAM/SVS)
- svsinfo (gilt für CAM/SVS)
- versionNotes [hints | rel | <key>] (gilt für CAM/SVS)
- PollState = Active - automatisches Polling wird mit Intervall entsprechend "pollcaminfoall" ausgeführt
- PollState = Inactive - automatisches Polling wird nicht ausgeführt
- CREDENTIALS - der Wert ist "Set" wenn die Credentials gesetzt wurden
- MODEL - Unterscheidung von Kamera-Device (Hersteller - Kameratyp) und Surveillance Station Device (SVS)
- NAME - der Kameraname in FHEM -
- OPMODE - die zuletzt ausgeführte Operation des Moduls +
- OPMODE - die zuletzt ausgeführte Operation des Moduls
- SERVERADDR - IP-Adresse des SVS Hostes
- SERVERPORT - der SVS-Port - +
- cacheServerParam
+ - cacheServerParam
Angabe der Verbindungsparameter zu einem zentralen Datencache.
-+
- +redis : bei Netzwerkverbindung: <IP-Adresse>:<Port> / bei Unix-Socket: <unix>:</path/zum/socket>
-
- +
+ -- cacheType
- Legt den zu verwendenden Cache für die Speicherung von Schnappschüssen, Aufnahmen und anderen Massendaten fest. +- cacheType
+ Legt den zu verwendenden Cache für die Speicherung von Schnappschüssen, Aufnahmen und anderen Massendaten fest. (Default: internal).
Es müssen eventuell weitere Module installiert werden, z.B. mit Hilfe des FHEM Installers.
Die Daten werden in "Namespaces" gespeichert um die Nutzung zentraler Caches (redis) zu ermöglichen.
- Die Cache Typen "file" und "redis" bieten sich an, wenn die Daten nicht im RAM des FHEM-Servers gehalten werden sollen. + Die Cache Typen "file" und "redis" bieten sich an, wenn die Daten nicht im RAM des FHEM-Servers gehalten werden sollen. Für die Verwendung von Redis ist zunächst ein Redis Key-Value Store bereitzustellen, z.B. in einem Docker-Image auf der Synology Diskstation (redis).
-+
- +internal : verwendet modulinterne Speicherung (Default) mem : sehr schneller Cache, kopiert Daten in den RAM file : erstellt und verwendet eine Verzeichnisstruktur im Directory "FhemUtils" redis : Verwendet einen externen Redis Key-Value Store per TCP oder Unix-Socket. Siehe dazu Attribut "cacheServerParam".
-
- +
+ -- debugactivetoken
- Wenn gesetzt, wird der Status des Active-Tokens gelogged - nur für Debugging, nicht im - normalen Betrieb benutzen ! +- debugactivetoken
+ Wenn gesetzt, wird der Status des Active-Tokens gelogged - nur für Debugging, nicht im + normalen Betrieb benutzen !
- + -- debugCachetime
- Zeigt die verbrauchte Zeit für Cache-Operationen an. +- debugCachetime
+ Zeigt die verbrauchte Zeit für Cache-Operationen an.
- +- disable
deaktiviert das Gerätemodul bzw. die Gerätedefinition
- - + +- genericStrmHtmlTag
- +
- Das Attribut enthält HTML-Tags zur Video-Spezifikation in einem Streaming-Device von Typ "generic". - (siehe "set <name> createStreamDev generic")
- + Das Attribut enthält HTML-Tags zur Video-Spezifikation in einem Streaming-Device von Typ "generic". + (siehe "set <name> createStreamDev generic")
+-
Beispiele:
attr <name> genericStrmHtmlTag <video $HTMLATTR controls autoplay> <source src='http://192.168.2.10:32000/$NAME.m3u8' type='application/x-mpegURL'> </video> - -attr <name> genericStrmHtmlTag <img $HTMLATTR + +attr <name> genericStrmHtmlTag <img $HTMLATTR src="http://192.168.2.10:32774" onClick="FW_okDialog('<img src=http://192.168.2.10:32774 $PWS >')" - > + >Die Variablen $HTMLATTR, $NAME und $PWS sind Platzhalter und übernehmen ein gesetztes Attribut "htmlattr", den SSCam- - Devicenamen bzw. das Attribut "popupWindowSize" im Streaming-Device, welches die Größe eines Popup-Windows festlegt. + Devicenamen bzw. das Attribut "popupWindowSize" im Streaming-Device, welches die Größe eines Popup-Windows festlegt.
- httptimeout
- Timeout-Wert für HTTP-Aufrufe zur Synology Surveillance Station.
+ Timeout-Wert für HTTP-Aufrufe zur Synology Surveillance Station.
(default: 20 Sekunden)
- +- hlsNetScript (setzbar in Device Model "SVS")
- Wenn gesetzt, wird die aktuellste hls.js Version von der Projektseite verwendet (Internetverbindung nötig). + Wenn gesetzt, wird die aktuellste hls.js Version von der Projektseite verwendet (Internetverbindung nötig).
- Im Standard wird die lokal installierte Version (./fhem/www/pgm2/sscam_hls.js) zur Wiedergabe von Daten in allen + Im Standard wird die lokal installierte Version (./fhem/www/pgm2/sscam_hls.js) zur Wiedergabe von Daten in allen Streaming Devices vom Typ "hls" genutzt (siehe "set <name> createStreamDev hls"). Dieses Attribut wird in einem Device vom Model "SVS" gesetzt und gilt zentral für alle Streaming Devices !
- +- hlsStrmObject
- - + +
- Wurde ein Streaming Device mit "set <name> createStreamDev hls" definiert, muss mit diesem Attribut der Link zum + Wurde ein Streaming Device mit "set <name> createStreamDev hls" definiert, muss mit diesem Attribut der Link zum Wiedergabeobjekt bekannt gemacht werden.
Die Angabe muss ein HTTP Live Streaming Objekt mit der Endung ".m3u8" enthalten.
Die Variable $NAME kann als Platzhalter genutzt werden und übernimmt den SSCam-Devicenamen. -
- +
+-
Beispiele:
attr <name> hlsStrmObject https://bitdash-a.akamaihd.net/content/MI201109210084_1/m3u8s/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8
attr <name> hlsStrmObject https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8
# Beispielstreams der zum Test des Streaming Devices verwendet werden kann (Internetverbindung nötig)
- + attr <name> hlsStrmObject http://192.168.2.10:32000/CamHE1.m3u8
# Wiedergabe eines Kamera HLS-Streams der z.B. durch ffmpeg bereitgestellt wird
- + attr <name> hlsStrmObject http://192.168.2.10:32000/$NAME.m3u8
- # Wie obiges Beispiel mit der Variablennutzung für "CamHE1" + # Wie obiges Beispiel mit der Variablennutzung für "CamHE1"
- htmlattr
- +
- ergänzende Angaben zur Inline-Bilddarstellung um das Verhalten wie Bildgröße zu beeinflussen.
- + ergänzende Angaben zur Inline-Bilddarstellung um das Verhalten wie Bildgröße zu beeinflussen.
+-
Beispiel:
attr <name> htmlattr width="500" height="325" top="200" left="300"
- livestreamprefix
- Überschreibt die Angaben zu Protokoll, Servernamen und Port in StmKey.*-Readings bzw. der Livestreamadresse zur + Überschreibt die Angaben zu Protokoll, Servernamen und Port in StmKey.*-Readings bzw. der Livestreamadresse zur Weiterverwendung z.B. als externer Link.
- Die Spezifikation kann auf zwei Arten erfolgen:
+ Die Spezifikation kann auf zwei Arten erfolgen:
-+
DEF : es wird Protokoll, Servername und Port aus der Definition des SSCam-Devices verwendet
Servername kann der Name oder die IP-Adresse der Synology Surveillance Station sein. - +
- +- loginRetries
Setzt die Anzahl der Login-Wiederholungen im Fehlerfall (default = 3)
- +- noQuotesForSID
- Dieses Attribut entfernt Quotes für SID bzw. der StmKeys. + Dieses Attribut entfernt Quotes für SID bzw. der StmKeys. Es kann in bestimmten Fällen die Fehlermeldung "402 - permission denied" oder "105 - Insufficient user privilege" vermeiden und ein login ermöglichen.
(default: 0) -
- +
+- pollcaminfoall
Intervall der automatischen Eigenschaftsabfrage (Polling) einer Kamera (<= 10: kein Polling, > 10: Polling mit Intervall)
- +- pollnologging
- "0" bzw. nicht gesetzt = Logging Gerätepolling aktiv (default), "1" = Logging + "0" bzw. nicht gesetzt = Logging Gerätepolling aktiv (default), "1" = Logging Gerätepolling inaktiv
- - + +- ptzNoCapPrePat
- Manche PTZ-Kameras können trotz ihrer PTZ-Fähigkeiten keine Presets und Patrols speichern. - Um Fehler und entsprechende Logmeldungen zu vermeiden, kann in diesen Fällen das Attribut ptzNoCapPrePat gesetzt - werden. Dem System wird eine fehlende Preset / Patrol Fähigkeit mitgeteilt. -
- - + Manche PTZ-Kameras können trotz ihrer PTZ-Fähigkeiten keine Presets und Patrols speichern. + Um Fehler und entsprechende Logmeldungen zu vermeiden, kann in diesen Fällen das Attribut ptzNoCapPrePat gesetzt + werden. Dem System wird eine fehlende Preset / Patrol Fähigkeit mitgeteilt. +
+ +- ptzPanel_Home
- Im PTZ-Steuerungspaneel wird dem Home-Icon (im Attribut "ptzPanel_row02") automatisch der Wert des Readings + Im PTZ-Steuerungspaneel wird dem Home-Icon (im Attribut "ptzPanel_row02") automatisch der Wert des Readings "PresetHome" zugewiesen. - Mit "ptzPanel_Home" kann diese Zuweisung mit einem Preset aus der verfügbaren Preset-Liste geändert werden. -
- - + Mit "ptzPanel_Home" kann diese Zuweisung mit einem Preset aus der verfügbaren Preset-Liste geändert werden. +
+ +- ptzPanel_iconPath
- Pfad für Icons im PTZ-Steuerungspaneel, default ist "www/images/sscam". + Pfad für Icons im PTZ-Steuerungspaneel, default ist "www/images/sscam". Der Attribut-Wert wird für alle Icon-Dateien außer *.svg verwendet.
Für weitere Information bitte "get <name> versionNotes 2,6" ausführen. -
+
- ptzPanel_iconPrefix
- Prefix für Icon-Dateien im PTZ-Steuerungspaneel, default ist "black_btn_". + Prefix für Icon-Dateien im PTZ-Steuerungspaneel, default ist "black_btn_". Der Attribut-Wert wird für alle Icon-Dateien außer *.svg verwendet.
Beginnen die verwendeten Icon-Dateien z.B. mit "black_btn_" ("black_btn_CAMDOWN.png"), braucht das Icon in den Attributen "ptzPanel_row[00-09]" nur noch mit dem darauf folgenden Teilstring, z.B. "CAMDOWN.png" benannt zu werden. -
+
- ptzPanel_row[00-09] <command>:<icon>,<command>:<icon>,...
Für PTZ-Kameras werden automatisch die Attribute "ptzPanel_row00" bis "ptzPanel_row04" zur Verwendung im PTZ-Steuerungspaneel angelegt.
- Die Attribute enthalten eine Komma-separarierte Liste von Befehl:Icon-Kombinationen (Tasten) je Paneelzeile. + Die Attribute enthalten eine Komma-separarierte Liste von Befehl:Icon-Kombinationen (Tasten) je Paneelzeile. Eine Paneelzeile kann beliebig viele Tasten enthalten. Die Attribute "ptzPanel_row00" bis "ptzPanel_row04" können nicht gelöscht werden da sie in diesem Fall automatisch wieder angelegt werden. Der User kann die Attribute ändern und ergänzen. Diese Änderungen bleiben erhalten.
Bei Bedarf kann die Belegung der Home-Taste in "ptzPanel_row02" geändert werden mit dem Attribut "ptzPanel_Home".
Die Icons werden im Pfad "ptzPanel_iconPath" gesucht. Dem Icon-Namen wird "ptzPanel_iconPrefix" vorangestellt. - Eigene Erweiterungen des PTZ-Steuerungspaneels können über die Attribute "ptzPanel_row05" bis "ptzPanel_row09" + Eigene Erweiterungen des PTZ-Steuerungspaneels können über die Attribute "ptzPanel_row05" bis "ptzPanel_row09" vorgenommen werden. Zur Erstellung eigener Icons gibt es eine Vorlage im SVN. Für weitere Informationen bitte "get <name> versionNotes 2" ausführen.
- + Hinweis
- Für eine Leerfeld verwenden sie bitte ":CAMBLANK.png" bzw. ":CAMBLANK.png,:CAMBLANK.png,:CAMBLANK.png,..." für eine + Für eine Leerfeld verwenden sie bitte ":CAMBLANK.png" bzw. ":CAMBLANK.png,:CAMBLANK.png,:CAMBLANK.png,..." für eine Leerzeile.
- +-
Beispiel:
attr <name> ptzPanel_row00 move upleft:CAMUPLEFTFAST.png,:CAMBLANK.png,move up:CAMUPFAST.png,:CAMBLANK.png,move upright:CAMUPRIGHTFAST.png
# Der Befehl "move upleft" wird der Kamera beim Druck auf Tastenicon "CAMUPLEFTFAST.png" übermittelt.
-
+
- ptzPanel_use
- Die Anzeige des PTZ-Steuerungspaneels in der Detailanzeige bzw. innerhalb eines generierten Streamdevice wird + Die Anzeige des PTZ-Steuerungspaneels in der Detailanzeige bzw. innerhalb eines generierten Streamdevice wird ein- bzw. ausgeschaltet (default ein).
- Das PTZ-Panel benutzt einen eigenen Satz Icons. - Damit das System sie finden kann, ist im FHEMWEB Device das Attribut "iconPath" um "sscam" zu ergänzen + Das PTZ-Panel benutzt einen eigenen Satz Icons. + Damit das System sie finden kann, ist im FHEMWEB Device das Attribut "iconPath" um "sscam" zu ergänzen (z.B. "attr WEB iconPath default:fhemSVG:openautomation:sscam"). -
- +
+- recChatTxt chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>]
Aktiviert den permanenten Versand von Aufnahmen nach deren Erstellung per Synology Chat.
- Vor der Aktivierung ist das Attribut videofolderMap zu setzen. Es muß eine URL zum + Vor der Aktivierung ist das Attribut videofolderMap zu setzen. Es muß eine URL zum root-Verzeichnis der Aufnahmen und Schnappschüsse enthalten ( z.B. http://server.mein:8081/surveillance ).
- Das Attribut recChatTxt muß in der angegebenen Form definiert werden. Im Schlüssel "chatbot" ist das SSChatBot-Device + Das Attribut recChatTxt muß in der angegebenen Form definiert werden. Im Schlüssel "chatbot" ist das SSChatBot-Device anzugeben, welches für den Versand der Daten verwendet werden soll. Das SSChatBot-Device muss natürlich vorhanden und funktionstüchtig sein.
Der Schlüssel "peers" enthält gültige Namen von Synology Chat Nutzern an die die Nachricht gesendet werden soll.
- Die Angabe von "peers" ist optional, jedoch muß der Schlüssel (leer) angegeben werden. + Die Angabe von "peers" ist optional, jedoch muß der Schlüssel (leer) angegeben werden. Wurde "peers" leer gelassen, wird der defaultPeer des SSChatBot-Devices verwendet.
- + Es können die folgenden Platzhalter im subject verwendet werden.
- --
-
- recTelegramTxt tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Text>], option => [silent]
Aktiviert den permanenten Versand von Aufnahmen nach deren Erstellung per TelegramBot.
- Das Attribut muß in der angegebenen Form definiert werden. + Das Attribut muß in der angegebenen Form definiert werden. Bei optionalen Angaben muß der Schlüssel >leer< angegeben werden.
- + Bedeutung der Schlüssel:
- --
-
- rectime
- festgelegte Aufnahmezeit wenn eine Aufnahme gestartet wird. Mit rectime = 0 wird eine - Endlosaufnahme gestartet. Ist "rectime" nicht gesetzt, wird der Defaultwert von 15s + festgelegte Aufnahmezeit wenn eine Aufnahme gestartet wird. Mit rectime = 0 wird eine + Endlosaufnahme gestartet. Ist "rectime" nicht gesetzt, wird der Defaultwert von 15s verwendet. - recextend
- "rectime" einer gestarteten Aufnahme wird neu gesetzt. Dadurch verlängert sich die + "rectime" einer gestarteten Aufnahme wird neu gesetzt. Dadurch verlängert sich die Aufnahemzeit einer laufenden Aufnahme - session
- Auswahl der Login-Session. Nicht gesetzt oder "DSM" -> session wird mit DSM aufgebaut + Auswahl der Login-Session. Nicht gesetzt oder "DSM" -> session wird mit DSM aufgebaut (Standard). "SurveillanceStation" -> Session-Aufbau erfolgt mit SVS.
Um eine Session mit der Surveillance Station aufzubauen muss ein Nutzer mit passenden Privilegien Profil in der SVS angelegt werden. Für weitere Informationen bitte "get <name> versionNotes 5" ausführen. - simu_SVSversion
- Es wird ein logisches "Downgrade" auf die angegebene SVS-Version ausgeführt. Das Attribut ist hilfreich um eventuell + Es wird ein logisches "Downgrade" auf die angegebene SVS-Version ausgeführt. Das Attribut ist hilfreich um eventuell bei einem Update/Upgrade der Synology Surveillance Station auftretende Inkompatibilitäten temporär zu eliminieren. Auftretende Inkompatibilitäten sollten zeitnah dem Maitainer mitgeteilt werden. - smtpHost <Hostname>
Gibt den Hostnamen oder die IP-Adresse des Postausgangsservers für den Emailversand an (z.B. securesmtp.t-online.de). - smtpCc <name>@<domain>[, <name>@<domain>][, <name>@<domain>]...
Optionale zusätzliche Empfängeradresse(n) für den Email-Versand. Mehrere Adressen müssen durch "," getrennt werden. - smtpDebug
Schaltet den Debugging-Modus der Verbindung zum Email-Server ein (wenn Email Versand verwendet wird). - smtpFrom <name>@<domain>
Absenderadresse bei Verwendung des Emailversands. - smtpPort <Port>
Optionale Angabe Standard-SMTP-Port des Postausgangsservers (default: 25). - smtpSSLPort <Port>
Optionale Angabe SSL Port des Postausgangsservers (default: 465). Ist dieses Attribut gesetzt, erfolgt die Verbindung zum Email-Server sofort verschlüsselt.
- - smtpTo <name>@<domain>[, <name>@<domain>][, <name>@<domain>]...
Empfängeradresse(n) für den Email-Versand. Mehrere Adressen müssen durch "," getrennt werden. - smtpNoUseSSL
Soll keine Email SSL-Verschlüsselung genutzt werden, ist dieses Attribut auf "1" zu setzen (default: 0). - snapChatTxt chatbot => <SSChatBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>]
- Aktiviert den permanenten Versand von Schnappschüssen nach deren Erstellung per Synology Chat. Wurden mehrere Schnappschüsse ausgelöst, + Aktiviert den permanenten Versand von Schnappschüssen nach deren Erstellung per Synology Chat. Wurden mehrere Schnappschüsse ausgelöst, werden sie sequentiell versendet.
- Vor der Aktivierung ist das Attribut videofolderMap zu setzen. Es muß eine URL zum + Vor der Aktivierung ist das Attribut videofolderMap zu setzen. Es muß eine URL zum root-Verzeichnis der Aufnahmen und Schnappschüsse enthalten ( z.B. http://server.mein:8081/surveillance ).
- Das Attribut snapChatTxt muß in der angegebenen Form definiert werden. Im Schlüssel "chatbot" ist das SSChatBot-Device - anzugeben, welches für den Versand der Daten verwendet werden soll. + Das Attribut snapChatTxt muß in der angegebenen Form definiert werden. Im Schlüssel "chatbot" ist das SSChatBot-Device + anzugeben, welches für den Versand der Daten verwendet werden soll. Das SSChatBot-Device muss natürlich vorhanden und funktionstüchtig sein.
Der Schlüssel "peers" enthält gültige Namen von Synology Chat Nutzern an die die Nachricht gesendet werden soll.
- Die Angabe von "peers" ist optional, jedoch muß der Schlüssel (leer) angegeben werden. + Die Angabe von "peers" ist optional, jedoch muß der Schlüssel (leer) angegeben werden. Wurde "peers" leer gelassen, wird der defaultPeer des SSChatBot-Devices verwendet.
- + Es können folgende Platzhalter im subject verwendet werden.
- --
-
- snapEmailTxt subject => <Betreff-Text>, body => <Mitteilung-Text>
- Aktiviert den Emailversand von Schnappschüssen nach deren Erstellung. Wurden mehrere Schnappschüsse ausgelöst, + Aktiviert den Emailversand von Schnappschüssen nach deren Erstellung. Wurden mehrere Schnappschüsse ausgelöst, werden sie gemeinsam in einer Mail versendet.
Das Attribut muß in der angegebenen Form definiert werden.
Es können die folgenden Platzhalter im subject bzw. body verwendet werden.
- --
-
- snapTelegramTxt tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>], option => [silent]
- Aktiviert den permanenten Versand von Schnappschüssen nach deren Erstellung per TelegramBot. + Aktiviert den permanenten Versand von Schnappschüssen nach deren Erstellung per TelegramBot. Wurden mehrere Schnappschüsse ausgelöst, werden sie sequentiell versendet.
- Das Attribut muß in der angegebenen Form definiert werden. + Das Attribut muß in der angegebenen Form definiert werden. Bei optionalen Angaben muß der Schlüssel >leer< angegeben werden.
- + Bedeutung der Schlüssel:
- --
-
- snapGalleryBoost
- Wenn gesetzt, werden die letzten Schnappschüsse (default 3) über Polling im Speicher gehalten und mit "set/get snapGallery" - aufbereitet angezeigt. Dieser Modus bietet sich an wenn viele bzw. Fullsize Images angezeigt werden sollen. - Ist das Attribut eingeschaltet, können bei "set/get snapGallery" keine Argumente mehr mitgegeben werden. + Wenn gesetzt, werden die letzten Schnappschüsse (default 3) über Polling im Speicher gehalten und mit "set/get snapGallery" + aufbereitet angezeigt. Dieser Modus bietet sich an wenn viele bzw. Fullsize Images angezeigt werden sollen. + Ist das Attribut eingeschaltet, können bei "set/get snapGallery" keine Argumente mehr mitgegeben werden. (siehe Attribut "snapGalleryNumber") - snapGalleryColumns
Die Anzahl der Snaps die in einer Reihe im Popup erscheinen sollen (default 3). - snapGalleryHtmlAttr
hiermit kann die Bilddarstellung beeinflusst werden.
Ist das Attribut nicht gesetzt, wird das Attribut "htmlattr" verwendet.
Ist auch dieses nicht gesetzt, wird eine Standardvorgabe verwendet (width="500" height="325").
- +-
Beispiel:
attr <name> snapGalleryHtmlAttr width="325" height="225"
-
+
- snapGalleryNumber
Die Anzahl der abzurufenden Schnappschüsse (default 3). - snapGallerySize
Mit diesem Attribut kann die Qualität der Images eingestellt werden (default "Icon").
- Im Modus "Full" wird die original vorhandene Auflösung der Images abgerufen. Dies erfordert mehr Ressourcen und kann die - Anzeige verlangsamen. Mit "snapGalleryBoost=1" kann die Ausgabe beschleunigt werden, da in diesem Fall die Aufnahmen über + Im Modus "Full" wird die original vorhandene Auflösung der Images abgerufen. Dies erfordert mehr Ressourcen und kann die + Anzeige verlangsamen. Mit "snapGalleryBoost=1" kann die Ausgabe beschleunigt werden, da in diesem Fall die Aufnahmen über Polling abgerufen und nur noch zur Anzeige gebracht werden. - snapReadingRotate 0...10
- Aktiviert die Versionierung von Schnappschußreadings (default: 0). Es wird eine fortlaufende Nummer der Readings - "LastSnapFilename", "LastSnapId" und "LastSnapTime" bis zum eingestellten Wert von snapReadingRotate erzeugt und enthält + Aktiviert die Versionierung von Schnappschußreadings (default: 0). Es wird eine fortlaufende Nummer der Readings + "LastSnapFilename", "LastSnapId" und "LastSnapTime" bis zum eingestellten Wert von snapReadingRotate erzeugt und enthält die Daten der letzten X Schnappschüsse. - showStmInfoFull
- zusaätzliche Streaminformationen wie LiveStreamUrl, StmKeyUnicst, StmKeymjpegHttp werden + zusaätzliche Streaminformationen wie LiveStreamUrl, StmKeyUnicst, StmKeymjpegHttp werden ausgegeben - showPassInLog
- Wenn gesetzt, wird das verwendete Passwort im Logfile mit verbose 4 angezeigt. + Wenn gesetzt, wird das verwendete Passwort im Logfile mit verbose 4 angezeigt. (default = 0) - videofolderMap
- Ersetzt den Inhalt des Readings "VideoFolder". Verwendung z.B. bei gemounteten + Ersetzt den Inhalt des Readings "VideoFolder". Verwendung z.B. bei gemounteten Verzeichnissen oder URL-Bereitstellung durch einen Webserver. - verbose
- readingFnAttributes
- CamAudioType
- Availability
- CamLastRec
- CamLastRecId
- CamLastRecTime
- CamLiveFps
- CamLiveFps
- CamLiveMode
- camLiveQuality
- camLiveResolution
- LastSnapFilename[x]
- LastSnapId[x]
- LastSnapTime[x]
- LastUpdateTime
- LiveStreamUrl
- LastUpdateTime
- LiveStreamUrl
- Patrols
- PollState
- PresetHome
- PresetHome
- Presets
- Record
- StmKey
- StmKeyUnicst
- Record
- StmKey
- StmKeyUnicst
- StmKeymjpegHttp
- SVScustomPortHttp
- SVScustomPortHttp
- SVScustomPortHttps
- SVSlicenseNumber
- SVSuserPriv
- compstate
+ +
-
+
-tbot Name des TelegramBot-Device peers Durch Leerzeichen getrennte Liste der Empfänger (optional). Ist peers nicht angegeben, wird der Default-Peer des TelegramBot-Device verwendet. subject der zu übermittelnde Text (optional) option mögliche nachfolgend beschriebene TelegramBot Sendeoptionen (optional) silent : die Signalisierung beim Empfänger wird unterdrückt tbot Name des TelegramBot-Device peers Durch Leerzeichen getrennte Liste der Empfänger (optional). Es kann r:<Reading> angegeben werden um die Empfänger aus dem <Reading> zu lesen. Ist peers nicht angegeben, wird der Default-Peer des TelegramBot-Device verwendet. subject der zu übermittelnde Text (optional) option mögliche nachfolgend beschriebene TelegramBot Sendeoptionen (optional) silent : die Signalisierung beim Empfänger wird unterdrückt
- + +
+ Es können folgende Platzhalter im subject verwendet werden.
- --
-
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename des Schnappschusses $CTIME (#CTIME) - Erstellungszeit des Schnappschusses
- + +
+ Beispiele:
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => Bewegungsalarm ($FILE)
attr <device> snapTelegramTxt tbot => teleBot, peers => @nabuko @foo @bar, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => #nabugroup, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => -123456, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject =>
+ attr <device> snapTelegramTxt tbot => teleBot, peers => r:peerTelegram, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => ohne Signalisierung, option => silent
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => Bewegungsalarm bei $CAM. Es wurde $CTIME der Schnappschuss $FILE erstellt
- +
- +
- +
- - + +
- +
- +
- +
- +
- +-
Es werden verschiedene Verbose-Level unterstützt.
Dies sind im Einzelnen:
-
-
+ +
- +0 - Start/Stop-Ereignisse werden geloggt 1 - Fehlermeldungen 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!
@@ -15921,7 +15944,7 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Über den Pollingmechanismus bzw. durch Abfrage mit "Get" werden Readings bereitgestellt, deren Bedeutung in der nachfolgenden Tabelle dargestellt sind.
Die übermittelten Readings können in Abhängigkeit des Kameratyps variieren.
-
-
+
-- listet den eingestellten Audiocodec auf wenn verwendet - Verfügbarkeit der Kamera (disabled, enabled, disconnected, other) - Pfad / Name der letzten Aufnahme - die ID der letzten Aufnahme - Datum / Startzeit - Stopzeit der letzten Aufnahme (Format abhängig vom global Attribut "language") - Frames pro Sekunde des Live-Streams - Frames pro Sekunde des Live-Streams - Quelle für Live-Ansicht (DS, Camera) - in SVS eingestellte Live-Stream Qualität - in SVS eingestellte Live-Stream Auflösung - der Filename des/der letzten Schnapschüsse - die ID des/der letzten Schnapschüsse - Zeitstempel des/der letzten Schnapschüsse (Format abhängig vom global Attribut "language") - Datum / Zeit der letzten Aktualisierung durch "caminfoall" (Format abhängig vom global Attribut "language") - die LiveStream-Url wenn der Stream gestartet ist. (Attribut "showStmInfoFull" muss gesetzt sein) - Datum / Zeit der letzten Aktualisierung durch "caminfoall" (Format abhängig vom global Attribut "language") - die LiveStream-Url wenn der Stream gestartet ist. (Attribut "showStmInfoFull" muss gesetzt sein) - in Surveillance Station voreingestellte Überwachungstouren (bei PTZ-Kameras) - zeigt den Status des automatischen Pollings an - Name der Home-Position (bei PTZ-Kameras) - Name der Home-Position (bei PTZ-Kameras) - in Surveillance Station voreingestellte Positionen (bei PTZ-Kameras) - Aufnahme läuft = Start, keine Aufnahme = Stop - aktueller StreamKey. Kann zum öffnen eines Livestreams ohne Session Id genutzt werden. - Uni-cast Stream Pfad der Kamera. (Attribut "showStmInfoFull" muss gesetzt sein) - Aufnahme läuft = Start, keine Aufnahme = Stop - aktueller StreamKey. Kann zum öffnen eines Livestreams ohne Session Id genutzt werden. - Uni-cast Stream Pfad der Kamera. (Attribut "showStmInfoFull" muss gesetzt sein) - Mjpeg Stream Pfad (über http) der Kamera. (Attribut "showStmInfoFull" muss gesetzt sein) - benutzerdefinierter Port der Surveillance Station (HTTP) im DSM-Anwendungsportal (get mit "svsinfo") - benutzerdefinierter Port der Surveillance Station (HTTP) im DSM-Anwendungsportal (get mit "svsinfo") - benutzerdefinierter Port der Surveillance Station (HTTPS) im DSM-Anwendungsportal (get mit "svsinfo") - die Anzahl der installierten Kameralizenzen (get mit "svsinfo") - die effektiven Rechte des verwendeten Users nach dem Login (get mit "svsinfo") - Kompatibilitätsstatus (Vergleich von eingesetzter/simulierter SVS-Version zum Internal COMPATIBILITY)
+
- +
@@ -16047,9 +16070,9 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR "HttpUtils": 0, "Blocking": 0, "Encode": 0, - "FHEM::SynoModules::API": 0, - "FHEM::SynoModules::SMUtils": 0, - "FHEM::SynoModules::ErrCodes": 0 + "FHEM::SynoModules::API": 0, + "FHEM::SynoModules::SMUtils": 0, + "FHEM::SynoModules::ErrCodes": 0 }, "recommends": { "FHEM::Meta": 0, @@ -16074,7 +16097,7 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR "x_branch": "dev", "x_filepath": "fhem/contrib/", "x_raw": "https://svn.fhem.de/fhem/trunk/fhem/contrib/DS_Starter/49_SSCam.pm" - } + } } } } - snapGalleryBoost
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. der Name der Kamera in der SVS falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename des (letzten) Schnappschusses (nur in body verwendbar) $CTIME (#CTIME) - Erstellungszeit des (letzten) Schnappschusses (nur in body verwendbar)
- + +
+-
Beispiel:
snapEmailTxt subject => Bewegungsalarm $CAM, body => Eine Bewegung wurde an der $CAM registriert.
- + - snapTelegramTxt tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Betreff-Text>], option => [silent]
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename des Schnappschusses $CTIME (#CTIME) - Erstellungszeit des Schnappschusses
- + +
+ Beispiele:
attr <device> snapChatTxt chatbot => SynChatBot, peers => , subject => Bewegungsalarm ($FILE)
attr <device> snapChatTxt chatbot => SynChatBot, peers => Aragorn Frodo Sam, subject => Ein Schnappschuss wurde ausgelöst
@@ -15761,16 +15782,16 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR attr <device> snapChatTxt chatbot => SynChatBot, peers => Frodo, subject => Bewegungsalarm bei $CAM. Es wurde $CTIME der Schnappschuss $FILE erstellt
- + - snapEmailTxt subject => <Betreff-Text>, body => <Mitteilung-Text>
+ +
-
+
-tbot Name des TelegramBot-Device peers Durch Leerzeichen getrennte Liste der Empfänger (optional). Ist peers nicht angegeben, wird der Default-Peer des TelegramBot-Device verwendet. subject der zu übermittelnde Text (optional) option mögliche nachfolgend beschriebene TelegramBot Sendeoptionen (optional) silent : die Signalisierung beim Empfänger wird unterdrückt tbot Name des TelegramBot-Device peers Durch Leerzeichen getrennte Liste der Empfänger (optional). Es kann r:<Reading> angegeben werden um die Empfänger aus dem <Reading> zu lesen. Ist peers nicht angegeben, wird der Default-Peer des TelegramBot-Device verwendet. subject der zu übermittelnde Text (optional) option mögliche nachfolgend beschriebene TelegramBot Sendeoptionen (optional) silent : die Signalisierung beim Empfänger wird unterdrückt
- + +
+ Es können die folgenden Platzhalter im subject verwendet werden.
- --
-
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename $CTIME (#CTIME) - Erstellungszeit der Aufnahme
- + +
+ Beispiele:
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => Bewegungsalarm ($FILE)
attr <device> recTelegramTxt tbot => teleBot, peers => @nabuko @foo @bar, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => #nabugroup, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => -123456, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => , subject =>
+ attr <device> recTelegramTxt tbot => teleBot, peers => r:peerTelegram, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => ohne Signalisierung, option => silent
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => Bewegungsalarm bei $CAM. Es wurde $CTIME die Aufnahme $FILE erstellt. Jetzt ist es $TIME.
- - + +
- +
- +
- +
- +
- +
- +
- +
- +
- +
- +
+
- +
- + - rectime
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename $CTIME (#CTIME) - Erstellungszeit der Aufnahme
- + +
+ Beispiele:
attr <device> recChatTxt chatbot => SynChatBot, peers => , subject => Bewegungsalarm ($FILE)
attr <device> recChatTxt chatbot => SynChatBot, peers => Frodo Sam Gollum, subject => Achtung
@@ -15586,9 +15605,9 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Aktiviert den Emailversand von Aufnahmen nach deren Erstellung.
Das Attribut muß in der angegebenen Form definiert werden.
Es können die folgenden Platzhalter im subject bzw. body verwendet werden.
- --
-
+ +
-
+
-$CAM (#CAM) - Device-Alias bzw. der Name der Kamera in der SVS falls der Device-Alias nicht vorhanden ist $DATE (#DATE) - aktuelles Datum $FILE (#FILE) - Filename der (letzten) Aufnahme (nur in body verwendbar) $CTIME (#CTIME) - Erstellungszeit des (letzten) Aufnahme (nur in body verwendbar)
- +-
Beispiel:
recEmailTxt subject => Neue Aufnahme $CAM, body => Die aktuelle Aufnahme von $CAM ist angehängt.
- - + + - cacheType
+ +
-
+
-tbot Name of the TelegramBot-Device peers List of recipients separated by spaces (optional). If peers is not specified, the default peer of the TelegramBot device is used. subject the text to be transmitted (optional) option possible TelegramBot sending options described below (optional) silent : the signaling at the receiver is suppressed tbot Name of the TelegramBot-Device peers List of recipients separated by spaces (optional). It can be specified r:<Reading> to read the recipients from the <Reading>. If peers is not specified, the default peer of the TelegramBot device is used. subject the text to be transmitted (optional) option possible TelegramBot sending options described below (optional) silent : the signaling at the receiver is suppressed
- + You can use the following placeholders within "subject".
- --
-
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Name of snapshot file $CTIME (#CTIME) - creation time of the snapshot
+ +
Examples:
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => Motion alarm ($FILE)
@@ -13762,90 +13780,91 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR attr <device> snapTelegramTxt tbot => teleBot, peers => #nabugroup, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => -123456, subject =>
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject =>
- attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => without signalization, option => silent
+ attr <device> snapTelegramTxt tbot => teleBot, peers => r:peerTelegram, subject =>
+ attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => without signalization, option => silent
attr <device> snapTelegramTxt tbot => teleBot, peers => , subject => Motion alarm from $CAM. At $CTIME the snapshot $FILE was created
-
- +
+
- +
- +
- +
- +
- +
- +
- +
- +
- +-
Different Verbose-Level are supported.
Those are in detail: - -+ +
- -0 - Start/Stop-Event will be logged 1 - Error messages will be logged 2 - messages according to important events were logged 3 - sended commands 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 logfile !
+ +
- + Readings-
@@ -13853,7 +13872,7 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
Using the polling mechanism or retrieval by "get"-call readings are provieded, The meaning of the readings are listed in subsequent table:
The transfered Readings can be deversified dependend on the type of camera.
-
-
+
-- Indicating audio type - Availability of Camera (disabled, enabled, disconnected, other) - HomeMode-state (SVS-version 8.1.0 and above) - the neweset entry of Surveillance Station Log (only if SVS-device and if attribute pollcaminfoall is set) - the filename of the last snapshot or snapshots - the ID of the last snapshot or snapshots - timestamp of the last snapshot or snapshots (format depends of global attribute "language") - date / time the last update of readings by "caminfoall" (format depends of global attribute "language") - the livestream URL if stream is started (is shown if attribute "showStmInfoFull" is set) - the ID of the last snapshot or snapshots - timestamp of the last snapshot or snapshots (format depends of global attribute "language") - date / time the last update of readings by "caminfoall" (format depends of global attribute "language") - the livestream URL if stream is started (is shown if attribute "showStmInfoFull" is set) - in Synology Surveillance Station predefined patrols (at PTZ-Cameras) - shows the state of automatic polling - shows the state of automatic polling - Name of Home-position (at PTZ-Cameras) - in Synology Surveillance Station predefined Presets (at PTZ-Cameras) - if recording is running = Start, if no recording is running = Stop - current streamkey. it can be used to open livestreams without session id - Uni-cast stream path of the camera. (attribute "showStmInfoFull" has to be set) - Mjpeg stream path(over http) of the camera (attribute "showStmInfoFull" has to be set) - Customized port of Surveillance Station (HTTP) (to get with "svsinfo") - if recording is running = Start, if no recording is running = Stop - current streamkey. it can be used to open livestreams without session id - Uni-cast stream path of the camera. (attribute "showStmInfoFull" has to be set) - Mjpeg stream path(over http) of the camera (attribute "showStmInfoFull" has to be set) - Customized port of Surveillance Station (HTTP) (to get with "svsinfo") - Customized port of Surveillance Station (HTTPS) (to get with "svsinfo") - The total number of installed licenses (to get with "svsinfo") - The effective rights of the user used for log in (to get with "svsinfo") - state of compatibility (compares current/simulated SVS-version with Internal COMPATIBILITY)
+
@@ -13938,7 +13957,7 @@ attr <name> genericStrmHtmlTag <img $HTMLATTRSSCam
-
- Mit diesem Modul können Operationen von in der Synology Surveillance Station (SVS) definierten Kameras und Funktionen
+ Mit diesem Modul können Operationen von in der Synology Surveillance Station (SVS) definierten Kameras und Funktionen
der SVS ausgeführt werden. Es basiert auf der SVS API und unterstützt die SVS ab Version 7.
Zur Zeit werden folgende Funktionen unterstützt:
-
@@ -13976,43 +13995,43 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
- + Die Aufnahmen stehen in der Synology Surveillance Station (SVS) 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 gespeichert und dann gelöscht.
- + Wenn sie über dieses Modul diskutieren oder zur Verbesserung des Moduls beitragen möchten, ist im FHEM-Forum ein Sammelplatz unter:
49_SSCam: Fragen, Hinweise, Neuigkeiten und mehr rund um dieses Modul.
Weitere Infomationen zum Modul sind im FHEM-Wiki zu finden:
SSCAM - Steuerung von Kameras in Synology Surveillance Station.
- + Integration in FHEM TabletUI:
- Zur Integration von SSCam Streaming Devices (Typ SSCamSTRM) wird ein Widget bereitgestellt. + Zur Integration von SSCam Streaming Devices (Typ SSCamSTRM) wird ein Widget bereitgestellt. Für weitere Information dazu bitte den Artikel im Wiki durchlesen:
FTUI Widget für SSCam Streaming Devices (SSCamSTRM).
- - + + Vorbereitung
- +-
Dieses Modul nutzt die Perl-Module JSON und MIME::Lite die üblicherweise nachinstalliert werden müssen.
Auf Debian-Linux basierenden Systemen können sie installiert werden mit:
- +sudo apt-get install libjson-perl
sudo apt-get install libmime-lite-perl
- - Das Modul verwendet für HTTP-Calls die nichtblockierenden Funktionen von HttpUtils bzw. HttpUtils_NonblockingGet.
- Im DSM bzw. der Synology Surveillance Station muß ein Nutzer angelegt sein. Die Zugangsdaten werden später über ein Set-Kommando dem + + Das Modul verwendet für HTTP-Calls die nichtblockierenden Funktionen von HttpUtils bzw. HttpUtils_NonblockingGet.
+ Im DSM bzw. der Synology Surveillance Station muß ein Nutzer angelegt sein. Die Zugangsdaten werden später über ein Set-Kommando dem angelegten Gerät zugewiesen.
Nähere Informationen dazu unter Credentials
- + Überblick über die Perl-Module welche von SSCam genutzt werden:
- +
- +JSON CHI::Driver::Redis (wenn Cache verwendet wird) Cache::Cache (wenn Cache verwendet wird)
- - SSCam benutzt einen eigenen Satz Icons. + + SSCam benutzt einen eigenen Satz Icons. Damit das System sie findet, ist im FHEMWEB Device das Attribut iconPath um sscam zu ergänzen.
-
Beispiel
attr WEB iconPath default:fhemSVG:openautomation:sscam
+
Bei der Definition wird zwischen einer Kamera-Definition und der Definition einer Surveillance Station (SVS), d.h. - der Applikation selbst auf der Diskstation, unterschieden. - Abhängig von der Art des definierten Devices wird das Internal MODEL auf "<Hersteller> - <Kameramodell>" oder + der Applikation selbst auf der Diskstation, unterschieden. + Abhängig von der Art des definierten Devices wird das Internal MODEL auf "<Hersteller> - <Kameramodell>" oder SVS gesetzt und eine passende Teilmenge der beschriebenen set/get-Befehle dem Device zugewiesen.
Der Gültigkeitsbereich von set/get-Befehlen ist nach dem jeweiligen Befehl angegeben "gilt für CAM, SVS, CAM/SVS".
Die Kameras können einzeln manuell, alternativ auch automatisiert mittels einem vorher definierten SVS-Device angelegt werden.
- + Eine Kamera wird definiert mit:
define <Name> SSCAM <Kameraname in SVS> <ServerAddr> [Port] [Protocol]
- + Ein SVS-Device zur Steuerung von Funktionen der Surveillance Station wird definiert mit:
define <Name> SSCAM SVS <ServerAddr> [Port] [Protocol]
- - Das Modul SSCam basiert auf Funktionen der Synology Surveillance Station API.
- + + Das Modul SSCam basiert auf Funktionen der Synology Surveillance Station API.
+ Die Parameter beschreiben im Einzelnen:
-
- +
+Name der Name des neuen Gerätes in FHEM define DS1 SSCAM SVS 192.168.2.20 [5001] [https]# erstellt ein neues SVS-Device DS1 - + Wird eine neue Kamera definiert, wird diesem Device zunächst eine Standardaufnahmedauer von 15 zugewiesen.
Über das Attribut "rectime" kann die Aufnahmedauer für jede Kamera individuell angepasst werden. Der Wert "0" für "rectime" führt zu einer Endlosaufnahme, die durch "set <name> off" wieder gestoppt werden muß.
Ein Logeintrag mit einem entsprechenden Hinweis auf diesen Umstand wird geschrieben.
@@ -14110,54 +14129,54 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Auch in diesem Fall führt "set <name> on 0" zu einer Daueraufnahme.
Eine eventuell in der SVS eingestellte Dauer der Voraufzeichnung wird weiterhin berücksichtigt.
- - Erkennt das Modul die definierte Kamera als PTZ-Device (Reading "DeviceType = PTZ"), wird automatisch ein - Steuerungspaneel in der Detailansicht erstellt. Dieses Paneel setzt SVS >= 7.1 voraus. Die Eigenschaften und das + + Erkennt das Modul die definierte Kamera als PTZ-Device (Reading "DeviceType = PTZ"), wird automatisch ein + Steuerungspaneel in der Detailansicht erstellt. Dieses Paneel setzt SVS >= 7.1 voraus. Die Eigenschaften und das Verhalten des Paneels können mit den Attributen "ptzPanel_.*" beeinflusst werden.
Siehe dazu auch den Befehl "set <name> createPTZcontrol". - +
- + Credentials
- +-
Nach dem Definieren des Gerätes müssen zuerst die Zugangsparameter gespeichert werden. Das geschieht mit dem Befehl:
-
-
+ +
set <name> credentials <Username> <Passwort>- - Die Passwortlänge beträgt maximal 20 Zeichen.
- Der Anwender kann in Abhängigkeit der beabsichtigten einzusetzenden Funktionen einen Nutzer im DSM bzw. in der Surveillance - Station einrichten. Sollte im DSM die 2-Stufen Verifizierung + + Die Passwortlänge beträgt maximal 20 Zeichen.
+ Der Anwender kann in Abhängigkeit der beabsichtigten einzusetzenden Funktionen einen Nutzer im DSM bzw. in der Surveillance + Station einrichten. Sollte im DSM die 2-Stufen Verifizierung aktiviert sein, ist die Session mit der Surveillance Station aufzubauen (Attribut "session = SurveillanceStation").
- Ist der DSM-Nutzer der Gruppe Administratoren zugeordnet, hat er auf alle Funktionen Zugriff. Ohne diese Gruppenzugehörigkeit - können nur Funktionen mit niedrigeren Rechtebedarf ausgeführt werden. Die benötigten Mindestrechte der Funktionen sind in + Ist der DSM-Nutzer der Gruppe Administratoren zugeordnet, hat er auf alle Funktionen Zugriff. Ohne diese Gruppenzugehörigkeit + können nur Funktionen mit niedrigeren Rechtebedarf ausgeführt werden. Die benötigten Mindestrechte der Funktionen sind in der Tabelle weiter unten aufgeführt.
- - Alternativ zum DSM-Nutzer kann ein in der SVS angelegter Nutzer verwendet werden. Auch in diesem Fall hat ein Nutzer vom - Typ Manager das Recht alle Funktionen auszuführen, wobei der Zugriff auf bestimmte Kameras/Funktionen im Privilegienprofil beschränkt + + Alternativ zum DSM-Nutzer kann ein in der SVS angelegter Nutzer verwendet werden. Auch in diesem Fall hat ein Nutzer vom + Typ Manager das Recht alle Funktionen auszuführen, wobei der Zugriff auf bestimmte Kameras/Funktionen im Privilegienprofil beschränkt werden kann (siehe Hilfefunktion in SVS).
Als Best Practice wird vorgeschlagen, jeweils einen User im DSM und einen in der SVS anzulegen:
- +
- - Über das Attribut "session" kann ausgewählt werden, ob die Session mit dem DSM oder der SVS - aufgebaut werden soll. Weitere Informationen zum Usermanagement in der SVS sind verfügbar mit + + Über das Attribut "session" kann ausgewählt werden, ob die Session mit dem DSM oder der SVS + aufgebaut werden soll. Weitere Informationen zum Usermanagement in der SVS sind verfügbar mit "get <name> versionNotes 5".
Erfolgt der Session-Aufbau mit dem DSM, stehen neben der SVS Web-API auch darüber hinausgehende API-Zugriffe zur Verfügung, die unter Umständen zur Verarbeitung benötigt werden.
- - Nach der Gerätedefinition ist die Grundeinstellung "Login in das DSM", d.h. es können Credentials mit Admin-Berechtigungen - genutzt werden um zunächst alle Funktionen der Kameras testen zu können. Danach können die Credentials z.B. in Abhängigkeit + + Nach der Gerätedefinition ist die Grundeinstellung "Login in das DSM", d.h. es können Credentials mit Admin-Berechtigungen + genutzt werden um zunächst alle Funktionen der Kameras testen zu können. Danach können die Credentials z.B. in Abhängigkeit der benötigten Funktionen auf eine SVS-Session mit entsprechend beschränkten Privilegienprofil umgestellt werden.
- + Die nachfolgende Aufstellung zeigt die Mindestanforderungen der jeweiligen Modulfunktionen an die Nutzerrechte.
@@ -14196,35 +14215,35 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
- + HTTP-Timeout setzen
- +-
Alle Funktionen dieses Moduls verwenden HTTP-Aufrufe gegenüber der SVS Web API.
- Durch Setzen des Attributes httptimeout > 0 kann dieser Wert bei Bedarf entsprechend - den technischen Gegebenheiten angepasst werden.
- + Durch Setzen des Attributes httptimeout > 0 kann dieser Wert bei Bedarf entsprechend + den technischen Gegebenheiten angepasst werden.
+
- + Set
- Die aufgeführten set-Befehle sind für CAM/SVS-Devices oder nur für CAM-Devices bzw. nur für SVS-Devices gültig. Sie stehen im + Die aufgeführten set-Befehle sind für CAM/SVS-Devices oder nur für CAM-Devices bzw. nur für SVS-Devices gültig. Sie stehen im Drop-Down-Menü des jeweiligen Devices zur Auswahl zur Verfügung.
- +
- - Ist ein SVS-Device definiert, können mit diesem Befehl alle in der SVS integrierten Kameras automatisiert angelegt werden. Bereits definierte - Kameradevices werden übersprungen. - Die neu erstellten Kameradevices werden im gleichen Raum wie das SVS-Device definiert (default SSCam). Weitere sinnvolle Attribute werden ebenfalls - voreingestellt. + + Ist ein SVS-Device definiert, können mit diesem Befehl alle in der SVS integrierten Kameras automatisiert angelegt werden. Bereits definierte + Kameradevices werden übersprungen. + Die neu erstellten Kameradevices werden im gleichen Raum wie das SVS-Device definiert (default SSCam). Weitere sinnvolle Attribute werden ebenfalls + voreingestellt.
- + Das Streaming-Device vom Typ "hls" verwendet die Bibliothek hls.js zur Bildverarbeitung und ist auf allen Browsern mit - MediaSource extensions (MSE) lauffähig. Mit dem Attribut "hlsNetScript" kann bestimmt werden, ob - die lokal installierte hls.js (./www/pgm2/sscam_hls.js) oder immer die aktuellste Bibliotheksversion von der hls.js Projektseite + MediaSource extensions (MSE) lauffähig. Mit dem Attribut "hlsNetScript" kann bestimmt werden, ob + die lokal installierte hls.js (./www/pgm2/sscam_hls.js) oder immer die aktuellste Bibliotheksversion von der hls.js Projektseite verwendet werden soll. Dieses Attribut ist zentral in einem Device vom Typ "SVS" zu setzen !
- Bei Verwendung dieses Streamingdevices ist zwingend das Attribut "hlsStrmObject" im verbundenen + Bei Verwendung dieses Streamingdevices ist zwingend das Attribut "hlsStrmObject" im verbundenen Kamera-Device (siehe Internal PARENT) anzugeben.
- + Streaming Device "switched hls"
- + Dieser Typ nutzt den von der Synology Surveillance Station gelieferten HLS Videostream. - Soll ein HLS-Stream im Streaming-Device vom Typ "switched" gestartet werden, muss die Kamera in der Synology Surveillance - Station auf das Videoformat H.264 eingestellt und HLS von der eingesetzten SVS-Version unterstützt sein. + Soll ein HLS-Stream im Streaming-Device vom Typ "switched" gestartet werden, muss die Kamera in der Synology Surveillance + Station auf das Videoformat H.264 eingestellt und HLS von der eingesetzten SVS-Version unterstützt sein. Diese Auswahltaste wird deshalb im nur dann im Streaming-Device angeboten, wenn das Reading "CamStreamFormat = HLS" beinhaltet.
- HLS (HTTP Live Streaming) kann momentan nur auf Mac Safari oder mobilen iOS/Android-Geräten wiedergegeben werden. + HLS (HTTP Live Streaming) kann momentan nur auf Mac Safari oder mobilen iOS/Android-Geräten wiedergegeben werden.
- + Streaming Device "generic"
- + Ein Streaming-Device vom Typ "generic" benötigt die Angabe von HTML-Tags im Attribut "genericStrmHtmlTag". Diese Tags spezifizieren den wiederzugebenden Content.
- +-
Beispiele:
@@ -14285,86 +14304,86 @@ attr <name> genericStrmHtmlTag <video $HTMLATTR controls autoplay> <source src='http://192.168.2.10:32000/$NAME.m3u8' type='application/x-mpegURL'> </video> -attr <name> genericStrmHtmlTag <img $HTMLATTR +attr <name> genericStrmHtmlTag <img $HTMLATTR src="http://192.168.2.10:32774" onClick="FW_okDialog('<img src=http://192.168.2.10:32774 $PWS >')" - > + >Die Variablen $HTMLATTR, $NAME und $PWS sind Platzhalter und übernehmen ein gesetztes Attribut "htmlattr", den SSCam- Devicenamen bzw. das Attribut "popupWindowSize" im Streaming-Device, welches die Größe eines Popup-Windows festlegt.
- + Streaming Device "lastsnap"
- + Dieser Typ gibt den neuesten Schnappschuß wieder. Der Schnappschuss wird per default als Icon, d.h. in einer verminderten - Auflösung abgerufen. Um die Originalauflösung zu verwenden, ist im zugehörigen Kameradevice (Internal PARENT) das Attribut - "snapGallerySize = Full" zu setzen. + Auflösung abgerufen. Um die Originalauflösung zu verwenden, ist im zugehörigen Kameradevice (Internal PARENT) das Attribut + "snapGallerySize = Full" zu setzen. Dort sollte ebenfalls das Attribut "pollcaminfoall" gesetzt sein, um regelmäßig die neuesten Schnappschußdaten abzurufen.
- + Streaming Device "master"
- - Dieser Typ kann selbst keine Streams wiedergeben. Die Umschaltung der Wiedergabe des Contents eines anderen definierten + + Dieser Typ kann selbst keine Streams wiedergeben. Die Umschaltung der Wiedergabe des Contents eines anderen definierten Streaming Devices erfolgt durch den Set-Befehl adopt im Master Streaming Device.
- +
- - Es wird ein separates PTZ-Steuerungspaneel (Type SSCamSTRM) erstellt. Es wird der aktuelle Raum des Kameradevice - zugewiesen sofern dort gesetzt (default "SSCam"). - Mit den "ptzPanel_.*"-Attributen bzw. den spezifischen Attributen des erzeugten - SSCamSTRM-Devices können die Eigenschaften des PTZ-Paneels beeinflusst werden.
+ + Es wird ein separates PTZ-Steuerungspaneel (Type SSCamSTRM) erstellt. Es wird der aktuelle Raum des Kameradevice + zugewiesen sofern dort gesetzt (default "SSCam"). + Mit den "ptzPanel_.*"-Attributen bzw. den spezifischen Attributen des erzeugten + SSCamSTRM-Devices können die Eigenschaften des PTZ-Paneels beeinflusst werden.
- - Es wird ein readingsGroup-Device zur Übersicht aller vorhandenen SSCam-Devices erstellt. Es kann ein eigener Name angegeben + + Es wird ein readingsGroup-Device zur Übersicht aller vorhandenen SSCam-Devices erstellt. Es kann ein eigener Name angegeben werden. Ist kein Name angegeben, wird eine readingsGroup mit dem Namen "RG.SSCam" erzeugt. -
+
- - Es wird eine Schnappschußgallerie als separates Device (Type SSCamSTRM) erzeugt. Das Device wird im Raum + + Es wird eine Schnappschußgallerie als separates Device (Type SSCamSTRM) erzeugt. Das Device wird im Raum "SSCam" erstellt. - Mit den "snapGallery..."-Attributen bzw. den spezifischen Attributen des erzeugten SSCamSTRM-Devices - können die Eigenschaften der Schnappschußgallerie beeinflusst werden. + Mit den "snapGallery..."-Attributen bzw. den spezifischen Attributen des erzeugten SSCamSTRM-Devices + können die Eigenschaften der Schnappschußgallerie beeinflusst werden.
Hinweis
- Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu Ungenauigkeiten beim Abruf der + Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu Ungenauigkeiten beim Abruf der Schnappschußgallerie kommen kann.
- +
- - Setzt Username / Passwort für den Zugriff auf die Synology Surveillance Station. + + Setzt Username / Passwort für den Zugriff auf die Synology Surveillance Station. Siehe Credentials
- +
- - Löscht einen Preset "<PresetName>". Im FHEMWEB wird eine Drop-Down Liste der aktuell vorhandenen + + Löscht einen Preset "<PresetName>". Im FHEMWEB wird eine Drop-Down Liste der aktuell vorhandenen Presets angeboten.
- +
- +
- +
- - Mit diesem Befehl kann der Belichtungsmodus der Kameras gesetzt werden. Dadurch wird z.B. das Verhalten der Kamera-LED's entsprechend gesteuert. + + Mit diesem Befehl kann der Belichtungsmodus der Kameras gesetzt werden. Dadurch wird z.B. das Verhalten der Kamera-LED's entsprechend gesteuert. Die erfolgreiche Umschaltung wird durch das Reading CamExposureMode ("get ... caminfoall") reportet.
- + Hinweis:
- Die erfolgreiche Ausführung dieser Funktion ist davon abhängig ob die SVS diese Funktionalität der Kamera unterstützt. - Ist in SVS -> IP-Kamera -> Optimierung -> Belichtungsmodus das Feld für den Tag/Nachtmodus grau hinterlegt, ist nicht von einer lauffähigen Unterstützung dieser - Funktion auszugehen. + Die erfolgreiche Ausführung dieser Funktion ist davon abhängig ob die SVS diese Funktionalität der Kamera unterstützt. + Ist in SVS -> IP-Kamera -> Optimierung -> Belichtungsmodus das Feld für den Tag/Nachtmodus grau hinterlegt, ist nicht von einer lauffähigen Unterstützung dieser + Funktion auszugehen.
- - Dieses Kommando triggert ein externes Ereignis (1-10) in der SVS. - Die Aktionen, die dieses Ereignis auslöst, sind zuvor in dem Aktionsregeleditor der SVS einzustellen. Es stehen die Ereignisse + + Dieses Kommando triggert ein externes Ereignis (1-10) in der SVS. + Die Aktionen, die dieses Ereignis auslöst, sind zuvor in dem Aktionsregeleditor der SVS einzustellen. Es stehen die Ereignisse 1-10 zur Verfügung. - In der Benachrichtigungs-App der SVS können auch Email, SMS oder Mobil (DS-Cam) Nachrichten ausgegeben werden wenn ein externes + In der Benachrichtigungs-App der SVS können auch Email, SMS oder Mobil (DS-Cam) Nachrichten ausgegeben werden wenn ein externes Ereignis ausgelöst wurde. Nähere Informationen dazu sind in der Hilfe zum Aktionsregeleditor zu finden. Der verwendete User benötigt Admin-Rechte in einer DSM-Session.
- +
@@ -14442,35 +14461,35 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR set <name> goAbsPTZ [up|down|left|right] - verwendet werden. Die Optik wird in diesem Fall mit der größt möglichen Schrittweite zur Absolutposition in der angegebenen Richtung bewegt. + verwendet werden. Die Optik wird in diesem Fall mit der größt möglichen Schrittweite zur Absolutposition in der angegebenen Richtung bewegt. Auch in diesem Fall muß der Vorgang ggf. mehrfach wiederholt werden um die Kameralinse in die gewünschte Position zu bringen.
- +
- + Mit diesem Kommando können PTZ-Kameras in eine vordefininierte Position bewegt werden.
Die Preset-Positionen müssen dazu zunächst in der Synology Surveillance Station angelegt worden sein. Das geschieht in der PTZ-Steuerung im IP-Kamera Setup. Die Presets werden über das Kommando "get <name> caminfoall" eingelesen (geschieht bei restart von FHEM automatisch). Der Einlesevorgang kann durch ein Kamerapolling - regelmäßig wiederholt werden. Ein langes Pollingintervall ist in diesem Fall empfehlenswert, da sich die Presetpositionen nur im Fall der Neuanlage bzw. Änderung verändern werden. + regelmäßig wiederholt werden. Ein langes Pollingintervall ist in diesem Fall empfehlenswert, da sich die Presetpositionen nur im Fall der Neuanlage bzw. Änderung verändern werden.
- + Hier ein Beispiel einer PTZ-Steuerung in Abhängigkeit eines IR-Melder Events: - +define CamFL.Preset.Wandschrank notify MelderTER:on.* set CamFL goPreset Wandschrank, ;; define CamFL.Preset.record at +00:00:10 set CamFL on 5 ;;;; define s3 at +*{3}00:00:05 set CamFL snap ;; define CamFL.Preset.back at +00:00:30 set CamFL goPreset Home- + Funktionsweise:
Der IR-Melder "MelderTER" registriert eine Bewegung. Daraufhin wird die Kamera CamFL in die Preset-Position "Wandschrank" gebracht. Eine Aufnahme mit Dauer von 5 Sekunden startet 10 Sekunden später. Da die Voraufnahmezeit der Kamera 10s beträgt (vgl. Reading "CamPreRecTime"), startet die effektive Aufnahme wenn der Kameraschwenk beginnt.
Mit dem Start der Aufnahme werden drei Schnappschüsse im Abstand von 5 Sekunden angefertigt.
Nach einer Zeit von 30 Sekunden fährt die Kamera wieder zurück in die "Home"-Position.
- + Ein Auszug aus dem Log verdeutlicht den Ablauf: - -+ +
2016.02.04 15:02:14 2: CamFL - Camera Flur_Vorderhaus has moved to position "Wandschrank" 2016.02.04 15:02:24 2: CamFL - Camera Flur_Vorderhaus Recording with Recordtime 5s started 2016.02.04 15:02:29 2: CamFL - Snapshot of Camera Flur_Vorderhaus has been done successfully @@ -14481,29 +14500,29 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
- +
- - Schaltet den HomeMode der Surveillance Station ein bzw. aus. - Informationen zum HomeMode sind in der Synology Onlinehilfe + + Schaltet den HomeMode der Surveillance Station ein bzw. aus. + Informationen zum HomeMode sind in der Synology Onlinehilfe enthalten.
- - Für die Bewegungserkennung durch SVS bzw. durch Kamera können weitere Optionen angegeben werden. + + Für die Bewegungserkennung durch SVS bzw. durch Kamera können weitere Optionen angegeben werden. Die verfügbaren Optionen bezüglich der Bewegungserkennung durch SVS sind "Empfindlichkeit" und "Schwellenwert".
- +
- + Wird die Bewegungserkennung durch die Kamera genutzt, stehen die Optionen "Empfindlichkeit", "Objektgröße" und "Prozentsatz für Auslösung" zur Verfügung.
@@ -14524,73 +14543,73 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
-set <name> motdetsc camera 0 40 10 # behält gesetzten Wert für Empfindlichkeit bei, setzt Schwellwert auf 40, Prozentsatz auf 10 set <name> motdetsc camera 30 # setzt die Empfindlichkeit auf 30, andere Werte bleiben unverändert
- Es ist immer die Reihenfolge der Optionswerte zu beachten. Nicht gewünschte Optionen sind mit "0" zu besetzen sofern danach Optionen folgen + Es ist immer die Reihenfolge der Optionswerte zu beachten. Nicht gewünschte Optionen sind mit "0" zu besetzen sofern danach Optionen folgen deren Werte verändert werden sollen (siehe Beispiele oben). Der Zahlenwert der Optionen beträgt 1 - 99 (außer Sonderfall "0").
- - Die jeweils verfügbaren Optionen unterliegen der Funktion der Kamera und der Unterstützung durch die SVS. Es können jeweils nur die Optionen genutzt werden die in + + Die jeweils verfügbaren Optionen unterliegen der Funktion der Kamera und der Unterstützung durch die SVS. Es können jeweils nur die Optionen genutzt werden die in SVS -> Kamera bearbeiten -> Ereigniserkennung zur Verfügung stehen. Weitere Infos sind der Online-Hilfe zur SVS zu entnehmen.
- - Über den Befehl "get <name> caminfoall" wird auch das Reading "CamMotDetSc" aktualisiert welches die gegenwärtige Einstellung der Bewegungserkennung dokumentiert. + + Über den Befehl "get <name> caminfoall" wird auch das Reading "CamMotDetSc" aktualisiert welches die gegenwärtige Einstellung der Bewegungserkennung dokumentiert. Es werden nur die Parameter und Parameterwerte angezeigt, welche die SVS aktiv unterstützt. Die Kamera selbst kann weiterführende Einstellmöglichkeiten besitzen.
- + Beipiel:CamMotDetSc SVS, sensitivity: 76, threshold: 55
- +-
-
- - Mit diesem Kommando wird eine kontinuierliche Bewegung der PTZ-Kamera gestartet. Neben den vier Grundrichtungen up/down/left/right stehen auch + + Mit diesem Kommando wird eine kontinuierliche Bewegung der PTZ-Kamera gestartet. Neben den vier Grundrichtungen up/down/left/right stehen auch Zwischenwinkelmaße "dir_X" zur Verfügung. Die Feinheit dieser Graduierung ist von der Kamera abhängig und kann dem Reading "CapPTZDirections" entnommen werden.
- Das Bogenmaß von 360 Grad teilt sich durch den Wert von "CapPTZDirections" und beschreibt die Bewegungsrichtungen beginnend mit "0=rechts" entgegen dem - Uhrzeigersinn. D.h. bei einer Kamera mit "CapPTZDirections = 8" bedeutet dir_0 = rechts, dir_2 = oben, dir_4 = links, dir_6 = unten bzw. dir_1, dir_3, dir_5 und dir_7 + Das Bogenmaß von 360 Grad teilt sich durch den Wert von "CapPTZDirections" und beschreibt die Bewegungsrichtungen beginnend mit "0=rechts" entgegen dem + Uhrzeigersinn. D.h. bei einer Kamera mit "CapPTZDirections = 8" bedeutet dir_0 = rechts, dir_2 = oben, dir_4 = links, dir_6 = unten bzw. dir_1, dir_3, dir_5 und dir_7 die entsprechenden Zwischenrichtungen. Die möglichen Bewegungsrichtungen bei Kameras mit "CapPTZDirections = 32" sind dementsprechend kleinteiliger.
- Im Gegensatz zum "set <name> goAbsPTZ"-Befehl startet der Befehl "set <name> move" eine kontinuierliche Bewegung bis ein Stop-Kommando empfangen wird. + Im Gegensatz zum "set <name> goAbsPTZ"-Befehl startet der Befehl "set <name> move" eine kontinuierliche Bewegung bis ein Stop-Kommando empfangen wird. Das Stop-Kommando wird nach Ablauf der optional anzugebenden Zeit [Sekunden] ausgelöst. Wird diese Laufzeit nicht angegeben, wird implizit Sekunde = 1 gesetzt.
- + Beispiele:
- -+ +
set <name> move up 0.5 : bewegt PTZ 0,5 Sek. (zzgl. Prozesszeit) nach oben - set <name> move dir_1 1.5 : bewegt PTZ 1,5 Sek. (zzgl. Prozesszeit) nach rechts-oben + set <name> move dir_1 1.5 : bewegt PTZ 1,5 Sek. (zzgl. Prozesszeit) nach rechts-oben set <name> move dir_20 0.7 : bewegt PTZ 1,5 Sek. (zzgl. Prozesszeit) nach links-unten ("CapPTZDirections = 32)"
- +
- Stoppt eine laufende Aufnahme. + Stoppt eine laufende Aufnahme.
- +
- Startet eine Aufnahme. Die Standardaufnahmedauer beträgt 15 Sekunden. Sie kann mit dem - Attribut "rectime" individuell festgelegt werden. - Die im Attribut (bzw. im Standard) hinterlegte Aufnahmedauer kann einmalig mit "set <name> on <rectime>" + Startet eine Aufnahme. Die Standardaufnahmedauer beträgt 15 Sekunden. Sie kann mit dem + Attribut "rectime" individuell festgelegt werden. + Die im Attribut (bzw. im Standard) hinterlegte Aufnahmedauer kann einmalig mit "set <name> on <rectime>" überschrieben werden. Die Aufnahme stoppt automatisch nach Ablauf der Zeit "rectime".
- Ein Sonderfall ist der Start einer Daueraufnahme mit "set <name> on 0" bzw. dem Attributwert "rectime = 0". - In diesem Fall wird eine Daueraufnahme gestartet, die explizit wieder mit dem Befehl "set <name> off" gestoppt + Ein Sonderfall ist der Start einer Daueraufnahme mit "set <name> on 0" bzw. dem Attributwert "rectime = 0". + In diesem Fall wird eine Daueraufnahme gestartet, die explizit wieder mit dem Befehl "set <name> off" gestoppt werden muß.
Das Aufnahmeverhalten kann weiterhin mit dem Attribut "recextend" beeinflusst werden.
@@ -14604,70 +14623,70 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR Attribut "recextend = 1" gesetzt:
-
-
- + Ein Synology Chat Versand der Aufnahme kann durch Setzen des recChatTxt Attributs permanent aktiviert - werden. Das zu verwendende SSChatBot-Device muss natürlich + werden. Das zu verwendende SSChatBot-Device muss natürlich funktionstüchtig eingerichtet sein.
- Der Text im Attribut "recChatTxt" kann durch die Spezifikation des optionalen "recChatTxt:"-Tags, wie oben + Der Text im Attribut "recChatTxt" kann durch die Spezifikation des optionalen "recChatTxt:"-Tags, wie oben gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "recChatTxt" nicht gesetzt sein, wird durch Angabe dieses Tags der Versand mit Synology Chat einmalig aktiviert. (die Tag-Syntax entspricht dem "recChatTxt"-Attribut)
- - Ein Email-Versand der letzten Aufnahme kann durch Setzen des Attributs "recEmailTxt" + + Ein Email-Versand der letzten Aufnahme kann durch Setzen des Attributs "recEmailTxt" aktiviert werden. Zuvor ist der Email-Versand, wie im Abschnitt Einstellung Email-Versand beschrieben, einzustellen. (Für weitere Informationen "get <name> versionNotes 7" ausführen)
Alternativ kann durch Verwendung des optionalen "recEmailTxt:"-Tags der Email-Versand der gestarteten Aufnahme nach deren - Beendigung aktiviert werden. Sollte das Attribut "recEmailTxt" bereits gesetzt sein, wird der Text des "recEmailTxt:"-Tags + Beendigung aktiviert werden. Sollte das Attribut "recEmailTxt" bereits gesetzt sein, wird der Text des "recEmailTxt:"-Tags anstatt des Attribut-Textes verwendet.
- + Ein Telegram-Versand der letzten Aufnahme kann durch Setzen des Attributs "recTelegramTxt" permanent aktiviert - werden. Das zu verwendende TelegramBot-Device muss natürlich + werden. Das zu verwendende TelegramBot-Device muss natürlich funktionstüchtig eingerichtet sein.
- Der Text im Attribut "recTelegramTxt" kann durch die Spezifikation des optionalen "recTelegramTxt:"-Tags, wie oben + Der Text im Attribut "recTelegramTxt" kann durch die Spezifikation des optionalen "recTelegramTxt:"-Tags, wie oben gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "recTelegramTxt" nicht gesetzt sein, wird durch Angabe dieses Tags der Telegram-Versand einmalig aktiviert. (die Tag-Syntax entspricht dem "recTelegramTxt"-Attribut)
- + Beispiele :
set <name> on [rectime]
- # startet die Aufnahme der Kamera <name>, automatischer Stop der Aufnahme nach Ablauf der Zeit [rectime] + # startet die Aufnahme der Kamera <name>, automatischer Stop der Aufnahme nach Ablauf der Zeit [rectime] (default 15s oder wie im Attribut "rectime" angegeben)
- +set <name> on 0
# startet eine Daueraufnahme die mit "off" gestoppt werden muss.
- +set <name> on recEmailTxt:"subject => Neue Aufnahme $CAM, body => Die aktuelle Aufnahme von $CAM ist angehängt."
# startet eine Aufnahme und versendet sie nach Beendigung per Email.
- +set <name> on recTelegramTxt:"tbot => teleBot, peers => @xxxx , subject => Bewegungsalarm bei $CAM. Es wurde $CTIME die Aufnahme $FILE erstellt, option => silent"
# startet eine Aufnahme und versendet sie nach Beendigung per Telegram im Silent-Mode.
- +set <name> on recChatTxt:"chatbot => SynChatBot, peers => , subject => Bewegungsalarm bei $CAM. Es wurde $CTIME die Aufnahme $FILE erstellt. Jetzt ist es $TIME."
# startet eine Aufnahme und versendet sie nach Beendigung per Synology Chat.
- +
- - Setzt eine oder mehrere Eigenschaften für die Kamera. Das Video kann gespiegelt (mirror), auf den Kopf gestellt (flip) oder - gedreht (rotate) werden. Die jeweiligen Eigenschaften müssen von der Kamera unterstützt werden. Mit "ntp" wird der Zeitserver + + Setzt eine oder mehrere Eigenschaften für die Kamera. Das Video kann gespiegelt (mirror), auf den Kopf gestellt (flip) oder + gedreht (rotate) werden. Die jeweiligen Eigenschaften müssen von der Kamera unterstützt werden. Mit "ntp" wird der Zeitserver eingestellt den die Kamera zur Zeitsynchronisation verwendet.
- + <value> kann sein für:
- + Beispiele:
set <name> optimizeParams mirror:true flip:true ntp:time.windows.com
# Das Bild wird gespiegelt, auf den Kopf gestellt und der Zeitserver auf "time.windows.com" eingestellt.
@@ -14675,33 +14694,33 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR # Die Surveillance Station wird als Zeitserver eingestellt. (NTP-Dienst muss im DSM aktiviert sein)
set <name> optimizeParams mirror:true flip:false rotate:true
# Das Bild wird gespiegelt und um 90 Grad gedreht.
- +
- - Aktiviert / deaktiviert den Infrarot-Sensor der Kamera (sofern die Kamera einen PIR-Sensor enthält). + + Aktiviert / deaktiviert den Infrarot-Sensor der Kamera (sofern die Kamera einen PIR-Sensor enthält).
- +
- + Dieses Kommando startet die vordefinierterte Überwachungstour einer PTZ-Kamera.
- Die Überwachungstouren müssen dazu zunächst in der Synology Surveillance Station angelegt worden sein. + Die Überwachungstouren müssen dazu zunächst in der Synology Surveillance Station angelegt worden sein. Das geschieht in der PTZ-Steuerung im IP-Kamera Setup -> PTZ-Steuerung -> Überwachung. - Die Überwachungstouren (Patrols) werden über das Kommando "get <name> caminfoall" eingelesen, welches beim Restart von FHEM automatisch abgearbeitet wird. - Der Einlesevorgang kann durch ein Kamerapolling regelmäßig wiederholt werden. Ein langes Pollingintervall ist in diesem Fall empfehlenswert, da sich die + Die Überwachungstouren (Patrols) werden über das Kommando "get <name> caminfoall" eingelesen, welches beim Restart von FHEM automatisch abgearbeitet wird. + Der Einlesevorgang kann durch ein Kamerapolling regelmäßig wiederholt werden. Ein langes Pollingintervall ist in diesem Fall empfehlenswert, da sich die Überwachungstouren nur im Fall der Neuanlage bzw. Änderung verändern werden. - Nähere Informationen zur Anlage von Überwachungstouren sind in der Hilfe zur Surveillance Station enthalten. + Nähere Informationen zur Anlage von Überwachungstouren sind in der Hilfe zur Surveillance Station enthalten.
- +
- +
- - Mit "live_fw, live_link, live_open" wird ein MJPEG-Livestream, entweder als eingebettetes Image + + Mit "live_fw, live_link, live_open" wird ein MJPEG-Livestream, entweder als eingebettetes Image oder als generierter Link, gestartet.
Der Befehl "live_open" öffnet ein separates Browserfenster mit dem MJPEG-Livestream. Wird dabei optional der Raum mit angegeben, wird das Browserfenster nur dann gestartet, wenn dieser Raum aktuell im Browser geöffnet ist.
Soll mit "live_fw_hls" ein HLS-Stream verwendet werden, muss die Kamera in der Synology Surveillance Station auf - das Videoformat H.264 (nicht MJPEG) eingestellt und HLS durch die eingesetzte SVS-Version unterstützt sein. + das Videoformat H.264 (nicht MJPEG) eingestellt und HLS durch die eingesetzte SVS-Version unterstützt sein. Diese Möglichkeit wird deshalb nur dann angeboten wenn das Reading "CamStreamFormat" den Wert "HLS" hat. -
- +
+ Der Zugriff auf die letzte Aufnahme einer Kamera kann über die Optionen "lastrec_fw.*" bzw. "lastrec_open" erfolgen. Bei Verwendung von "lastrec_fw.*" wird die letzte Aufnahme als eingebettetes iFrame-Objekt abgespielt. Es werden entsprechende Steuerungselemente zur Wiedergabegeschwindigkeit usw. angeboten wenn verfügbar.
- + Der Befehl "set <name> runView lastsnap_fw" zeigt den letzten Schnappschuss der Kamera eingebettet an.
Durch Angabe des optionalen Raumes bei "lastrec_open" erfolgt die gleiche Einschränkung wie bei "live_open".
- Die Gestaltung der Fenster im FHEMWEB kann durch HTML-Tags im Attribut "htmlattr" beeinflusst werden. + Die Gestaltung der Fenster im FHEMWEB kann durch HTML-Tags im Attribut "htmlattr" beeinflusst werden.
- + Beispiel:
attr <name> htmlattr width="500" height="375" attr <name> htmlattr width="500" height="375" top="200" left="300"- + Wird der Stream als live_fw gestartet, ändert sich die Größe entsprechend der Angaben von Width und Hight.
- Das Kommando "set <name> runView live_open" startet den Livestreamlink sofort in einem neuen - Browserfenster. - Dabei wird für jede aktive FHEMWEB-Session eine Fensteröffnung initiiert. Soll dieses Verhalten geändert werden, kann - "set <name> runView live_open <room>" verwendet werden um das Öffnen des Browserfensters in einem + Das Kommando "set <name> runView live_open" startet den Livestreamlink sofort in einem neuen + Browserfenster. + Dabei wird für jede aktive FHEMWEB-Session eine Fensteröffnung initiiert. Soll dieses Verhalten geändert werden, kann + "set <name> runView live_open <room>" verwendet werden um das Öffnen des Browserfensters in einem beliebigen, in einer FHEMWEB-Session aktiven Raum "<room>", zu initiieren.
- Das gesetzte Attribut "livestreamprefix" überschreibt im Reading "LiveStreamUrl" - die Angaben für Protokoll, Servername und Port. Damit kann z.B. die LiveStreamUrl für den Versand und externen Zugriff + Das gesetzte Attribut "livestreamprefix" überschreibt im Reading "LiveStreamUrl" + die Angaben für Protokoll, Servername und Port. Damit kann z.B. die LiveStreamUrl für den Versand und externen Zugriff auf die SVS modifiziert werden.
- + Beispiel:
attr <name> livestreamprefix https://<Servername>:<Port>- + Der Livestream wird über das Kommando "set <name> stopView" wieder beendet.
Die "runView" Funktion schaltet ebenfalls Streaming-Devices vom Typ "switched" in den entsprechenden Modus.
- + Abhängig vom wiedergegebenen Content werden unterschiedliche Steuertasten angeboten:
--
-
+
-
+
-Start Recording - startet eine Endlosaufnahme Stop Recording - stoppt eine Aufnahme Take Snapshot - löst einen Schnappschuß aus Switch off - stoppt eine laufende Wiedergabe
- + Hinweis zu HLS (HTTP Live Streaming):
- Das Video startet mit einer technologisch bedingten Verzögerung. Jeder Stream wird in eine Reihe sehr kleiner Videodateien - (mit etwa 10 Sekunden Länge) segmentiert und an den Client ausgeliefert. - Die Kamera muss in der SVS auf das Videoformat H.264 eingestellt sein und nicht jeder Kameratyp ist gleichermassen für + Das Video startet mit einer technologisch bedingten Verzögerung. Jeder Stream wird in eine Reihe sehr kleiner Videodateien + (mit etwa 10 Sekunden Länge) segmentiert und an den Client ausgeliefert. + Die Kamera muss in der SVS auf das Videoformat H.264 eingestellt sein und nicht jeder Kameratyp ist gleichermassen für HLS-Streaming geeignet. Momentan kann HLS nur durch den Mac Safari Browser sowie auf mobilen iOS/Android-Geräten wiedergegeben werden.
- + Hinweis zu MJPEG:
Der MJPEG Stream wird innerhalb der SVS aus anderen Codecs (H.264) transkodiert und beträgt normalerweise ca. 1 Fps. - +
- - + +
- - Setzt die Home-Position der Kamera auf einen vordefinierten Preset "<PresetName>" oder auf die aktuell angefahrene + + Setzt die Home-Position der Kamera auf einen vordefinierten Preset "<PresetName>" oder auf die aktuell angefahrene Position.
- +
- + Setzt einen Preset mit dem Namen "<PresetName>" auf die aktuell angefahrene Position der Kamera. Optional kann die Geschwindigkeit angegeben werden (<Speed>). Ist kein PresetName angegeben, wird die PresetNummer als Name verwendet. Aus diesem Grund ist <PresetName> optional definiert, sollte jedoch im Normalfall gesetzt werden.
- +
- + Stellt Bedienelemte für Zoomfunktionen zur Verfügung sofern die Kamera dieses Merkmal unterstützt.
- +
- + Setzt die Credentials für den Zugang zum Postausgangsserver wenn Email-Versand genutzt wird.
- +
- + Ein oder mehrere Schnappschüsse werden ausgelöst. Es kann die Anzahl der auszulösenden Schnappschüsse und deren zeitlicher Abstand in Sekunden optional angegeben werden. Ohne Angabe wird ein Schnappschuß getriggert.
- Es wird die ID und der Filename des letzten Snapshots als Wert der Readings "LastSnapId" bzw. "LastSnapFilename" in + Es wird die ID und der Filename des letzten Snapshots als Wert der Readings "LastSnapId" bzw. "LastSnapFilename" in der Kamera gespeichert.
Um die Daten der letzen 1-10 Schnappschüsse zu versionieren, kann das Attribut "snapReadingRotate" verwendet werden.
- + Ein Synology Chat Versand der Schnappschüsse kann durch Setzen des Attributs snapChatTxt permanent aktiviert - werden. Das zu verwendende SSChatBot-Device muss natürlich + werden. Das zu verwendende SSChatBot-Device muss natürlich funktionstüchtig eingerichtet sein.
- Der Text im Attribut "snapChatTxt" kann durch die Spezifikation des optionalen "snapChatTxt:"-Tags, wie oben + Der Text im Attribut "snapChatTxt" kann durch die Spezifikation des optionalen "snapChatTxt:"-Tags, wie oben gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "snapChatTxt" nicht gesetzt sein, wird durch Angabe dieses Tags der SSChatBot-Versand einmalig aktiviert (die Syntax entspricht dem "snapChatTxt"-Attribut).
- In jedem Fall ist vorher das Attribut videofolderMap zu setzen. Es muß eine URL zum + In jedem Fall ist vorher das Attribut videofolderMap zu setzen. Es muß eine URL zum root-Verzeichnis der Aufnahmen und Schnappschüssen enthalten ( z.B. http://server.mein:8081/surveillance ).
- + Ein Email-Versand der Schnappschüsse kann durch Setzen des Attributs snapEmailTxt permanent aktiviert werden. Zuvor ist der Email-Versand, wie im Abschnitt Einstellung Email-Versand beschrieben, einzustellen. (Für weitere Informationen "get <name> versionNotes 7" ausführen)
- Der Text im Attribut "snapEmailTxt" kann durch die Spezifikation des optionalen "snapEmailTxt:"-Tags, wie oben + Der Text im Attribut "snapEmailTxt" kann durch die Spezifikation des optionalen "snapEmailTxt:"-Tags, wie oben gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "snapEmailTxt" nicht gesetzt sein, wird durch Angabe dieses Tags der Email-Versand einmalig aktiviert. (die Tag-Syntax entspricht dem "snapEmailTxt"-Attribut)
- - Ein Telegram-Versand der Schnappschüsse kann durch Setzen des Attributs - snapTelegramTxt permanent aktiviert werden. - Das zu verwendende TelegramBot-Device muss natürlich + + Ein Telegram-Versand der Schnappschüsse kann durch Setzen des Attributs + snapTelegramTxt permanent aktiviert werden. + Das zu verwendende TelegramBot-Device muss natürlich funktionstüchtig eingerichtet sein.
- Der Text im Attribut "snapTelegramTxt" kann durch die Spezifikation des optionalen "snapTelegramTxt:"-Tags, wie oben - gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "snapTelegramTxt" nicht gesetzt sein, wird - durch Angabe dieses Tags der Telegram-Versand einmalig aktiviert. + Der Text im Attribut "snapTelegramTxt" kann durch die Spezifikation des optionalen "snapTelegramTxt:"-Tags, wie oben + gezeigt, temporär überschrieben bzw. geändert werden. Sollte das Attribut "snapTelegramTxt" nicht gesetzt sein, wird + durch Angabe dieses Tags der Telegram-Versand einmalig aktiviert. (die Tag-Syntax entspricht dem "snapTelegramTxt"-Attribut)
- + Beispiele:set <name> snap - set <name> snap 4 + set <name> snap 4 set <name> snap 3 3 snapEmailTxt:"subject => Bewegungsalarm $CAM, body => Eine Bewegung wurde am Carport registriert" set <name> snap 2 snapTelegramTxt:"tbot => teleBot, peers => , subject => Bewegungsalarm bei $CAM. Es wurde $CTIME der Schnappschuss $FILE erstellt, option => silent" set <name> snap 2 snapChatTxt:"chatbot => SynChatBot , peers => Frodo Sam, subject => Bewegungsalarm bei $CAM. Es wurde $CTIME der Schnappschuss $FILE erstellt. Jetzt ist es: $TIME."
- +
- - Ein oder mehrere Schnappschüsse der angegebenen Kamera-Devices werden ausgelöst. Sind keine Kamera-Devices angegeben, - werden die Schnappschüsse bei allen in FHEM definierten Kamera-Devices getriggert. + + Ein oder mehrere Schnappschüsse der angegebenen Kamera-Devices werden ausgelöst. Sind keine Kamera-Devices angegeben, + werden die Schnappschüsse bei allen in FHEM definierten Kamera-Devices getriggert. Optional kann die Anzahl der auszulösenden Schnappschüsse (default: 1) und deren zeitlicher Abstand in Sekunden (default: 2) angegeben werden.
- Es wird die ID und der Filename des letzten Snapshots als Wert der Readings "LastSnapId" bzw. "LastSnapFilename" + Es wird die ID und der Filename des letzten Snapshots als Wert der Readings "LastSnapId" bzw. "LastSnapFilename" der entsprechenden Kamera gespeichert.
- Ein Email-Versand der Schnappschüsse kann durch Setzen des Attributs "snapEmailTxt" im - SVS-Device UND in den Kamera-Devices, deren Schnappschüsse versendet werden sollen, aktiviert werden. + Ein Email-Versand der Schnappschüsse kann durch Setzen des Attributs "snapEmailTxt" im + SVS-Device UND in den Kamera-Devices, deren Schnappschüsse versendet werden sollen, aktiviert werden. Bei Kamera-Devices die kein Attribut "snapEmailTxt" gesetzt haben, werden die Schnappschüsse ausgelöst, aber nicht versendet. Zuvor ist der Email-Versand, wie im Abschnitt Einstellung Email-Versand beschrieben, einzustellen. (Für weitere Informationen "get <name> versionNotes 7" ausführen)
- Es wird ausschließlich der im Attribut "snapEmailTxt" des SVS-Devices hinterlegte Email-Text in der erstellten Email + Es wird ausschließlich der im Attribut "snapEmailTxt" des SVS-Devices hinterlegte Email-Text in der erstellten Email verwendet. Der Text im Attribut "snapEmailTxt" der einzelnen Kameras wird ignoriert !!
- + Beispiele:- set <name> snapCams 4 + set <name> snapCams 4 set <name> snapCams 3 3 CAM:"CamHE1, CamCarport"- +
- +
- + Der Befehl ist nur vorhanden wenn das Attribut "snapGalleryBoost=1" gesetzt wurde. Er erzeugt eine Ausgabe der letzten [x] Schnappschüsse ebenso wie "get <name> snapGallery". Abweichend von "get" wird mit Attribut Attribut "snapGalleryBoost=1" kein Popup erzeugt, sondern die Schnappschußgalerie als Browserseite dargestellt. Alle weiteren Funktionen und Attribute entsprechen dem "get <name> snapGallery" Kommando.
- Wenn die Ausgabe einer Schnappschußgalerie, z.B. über ein "at oder "notify", getriggert wird, sollte besser das + Wenn die Ausgabe einer Schnappschußgalerie, z.B. über ein "at oder "notify", getriggert wird, sollte besser das "get <name> snapGallery" Kommando anstatt "set" verwendet werden.
- + Hinweis
- Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu Ungenauigkeiten beim Abruf der + Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu Ungenauigkeiten beim Abruf der Schnappschußgallerie kommen kann. - +
- +
- + Startet Objekt Tracking der Kamera. Der Befehl ist nur vorhanden wenn die Surveillance Station die Fähigkeit der Kamera zum Objekt Tracking erkannt hat (Reading "CapPTZObjTracking").
- +
- + Stoppt Objekt Tracking der Kamera. Der Befehl ist nur vorhanden wenn die Surveillance Station die Fähigkeit der Kamera zum Objekt Tracking erkannt hat (Reading "CapPTZObjTracking"). @@ -14943,62 +14962,62 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
Mit SSCam können die Eigenschaften der Surveillance Station und der Kameras abgefragt werden.
- Die aufgeführten get-Befehle sind für CAM/SVS-Devices oder nur für CAM-Devices bzw. nur für SVS-Devices gültig. Sie stehen im + Die aufgeführten get-Befehle sind für CAM/SVS-Devices oder nur für CAM-Devices bzw. nur für SVS-Devices gültig. Sie stehen im Drop-Down-Menü des jeweiligen Devices zur Auswahl zur Verfügung.
- +
- - Es werden SVS-Parameter und abhängig von der Art der Kamera (z.B. Fix- oder PTZ-Kamera) die verfügbaren Kamera-Eigenschaften + + Es werden SVS-Parameter und abhängig von der Art der Kamera (z.B. Fix- oder PTZ-Kamera) die verfügbaren Kamera-Eigenschaften ermittelt und als Readings zur Verfügung gestellt.
- So wird zum Beispiel das Reading "Availability" auf "disconnected" gesetzt falls die Kamera von der Surveillance Station + So wird zum Beispiel das Reading "Availability" auf "disconnected" gesetzt falls die Kamera von der Surveillance Station getrennt ist.
"getcaminfo" ruft eine Teilmenge von "getcaminfoall" ab.
- +
+
- - Es wird das Reading "CamEventNum" und "CamLastRec" + + Es wird das Reading "CamEventNum" und "CamLastRec" aktualisiert, welches die Gesamtanzahl der registrierten Kameraevents und den Pfad / Namen der letzten Aufnahme enthält. Dieser Befehl wird implizit mit "get <name> caminfoall" ausgeführt.
- Mit dem Attribut "videofolderMap" kann der Inhalt des Readings "VideoFolder" überschrieben werden. - Dies kann von Vortel sein wenn das Surveillance-Verzeichnis der SVS an dem lokalen PC unter anderem Pfadnamen gemountet ist + Mit dem Attribut "videofolderMap" kann der Inhalt des Readings "VideoFolder" überschrieben werden. + Dies kann von Vortel sein wenn das Surveillance-Verzeichnis der SVS an dem lokalen PC unter anderem Pfadnamen gemountet ist und darüber der Zugriff auf die Aufnahmen erfolgen soll (z.B. Verwendung bei Email-Versand).
- + Ein DOIF-Beispiel für den Email-Versand von Snapshot und Aufnahmelink per non-blocking sendmail:- define CamHE1.snap.email DOIF ([CamHE1:"LastSnapFilename"]) - ({DebianMailnbl ('Recipient@Domain','Bewegungsalarm CamHE1','Eine Bewegung wurde an der Haustür registriert. Aufnahmelink: \ + define CamHE1.snap.email DOIF ([CamHE1:"LastSnapFilename"]) + ({DebianMailnbl ('Recipient@Domain','Bewegungsalarm CamHE1','Eine Bewegung wurde an der Haustür registriert. Aufnahmelink: \ \[CamHE1:VideoFolder]\[CamHE1:CamLastRec]','/media/sf_surveillance/@Snapshot/[CamHE1:LastSnapFilename]')})- +
- - HomeMode-Status der Surveillance Station wird abgerufen. + + HomeMode-Status der Surveillance Station wird abgerufen.
- +
+
get <name> listLog severity:Error limit:5
- Zeigt die letzten 5 Logeinträge mit dem Schweregrad "Error"
+ Zeigt die letzten 5 Logeinträge mit dem Schweregrad "Error"
get <name> listLog severity:Information match:Carport
- Zeigt alle Logeinträge mit dem Schweregrad "Information" die den String "Carport" enthalten
+ Zeigt alle Logeinträge mit dem Schweregrad "Information" die den String "Carport" enthalten
get <name> listLog severity:Warning
Zeigt alle Logeinträge mit dem Schweregrad "Warning"
- Im Protokoll-Setup der SVS kann man einstellen was protokolliert werden soll. Für weitere Informationen + Im Protokoll-Setup der SVS kann man einstellen was protokolliert werden soll. Für weitere Informationen siehe Synology Online-Hlfe.
- +
+
- + Die für die Kamera gespeicherten Presets werden in einem Popup ausgegeben.
- +
+
- - Der aktuell im Reading "LastSnapId" angegebene (letzte) Schnappschuß wird lokal als jpg-File gespeichert. + + Der aktuell im Reading "LastSnapId" angegebene (letzte) Schnappschuß wird lokal als jpg-File gespeichert. Optional kann der Pfad zur Speicherung des Files im Befehl angegeben werden (default: modpath im global Device).
Das File erhält lokal den gleichen Namen wie im Reading "LastSnapFilename" enthalten.
Die Auflösung des Schnappschusses wird durch das Attribut "snapGallerySize" bestimmt. - +
- +-
Beispiel:
get <name> saveLastSnap /opt/fhem/log
- +
+
- - Die aktuell im Reading "CamLastRec" angegebene Aufnahme wird lokal als MP4-File gespeichert. Optional kann der Pfad zur + + Die aktuell im Reading "CamLastRec" angegebene Aufnahme wird lokal als MP4-File gespeichert. Optional kann der Pfad zur Speicherung des Files im Befehl angegeben werden (default: modpath im global Device).
Das File erhält lokal den gleichen Namen wie im Reading "CamLastRec" angegeben.
- +-
Beispiel:
get <name> saveRecording /opt/fhem/log
- - Wie mit get caminfoall werden alle Informationen der SVS und Kamera abgerufen. Allerdings wird in jedem Fall eine - neue Session ID generiert (neues Login), die Kamera-ID neu ermittelt und es werden alle notwendigen API-Parameter neu - eingelesen. + + Wie mit get caminfoall werden alle Informationen der SVS und Kamera abgerufen. Allerdings wird in jedem Fall eine + neue Session ID generiert (neues Login), die Kamera-ID neu ermittelt und es werden alle notwendigen API-Parameter neu + eingelesen.
- +
+
- - Es wird ein Popup mit den letzten [x] Schnapschüssen erzeugt. Ist das Attribut "snapGalleryBoost" gesetzt, + + Es wird ein Popup mit den letzten [x] Schnapschüssen erzeugt. Ist das Attribut "snapGalleryBoost" gesetzt, werden die letzten Schnappschüsse (default 3) über Polling abgefragt und im Speicher gehalten. Das Verfahren hilft die Ausgabe zu beschleunigen, kann aber möglicherweise nicht den letzten Schnappschuß anzeigen, falls dieser NICHT über das Modul ausgelöst wurde.
- Diese Funktion kann ebenfalls, z.B. mit "at" oder "notify", getriggert werden. Dabei wird die Schnappschußgalerie auf allen + Diese Funktion kann ebenfalls, z.B. mit "at" oder "notify", getriggert werden. Dabei wird die Schnappschußgalerie auf allen verbundenen FHEMWEB-Instanzen als Popup angezeigt.
- + Zur weiteren Steuerung dieser Funktion stehen die Attribute:
- +-
-
zur Verfügung.
- +-
Hinweis:
Abhängig von der Anzahl und Auflösung (Qualität) der Schnappschuß-Images werden entsprechend ausreichende CPU und/oder - RAM-Ressourcen benötigt. Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu + RAM-Ressourcen benötigt. Die Namen der Kameras in der SVS sollten sich nicht stark ähneln, da es ansonsten zu Ungnauigkeiten beim Abruf der Schnappschußgallerie kommen kann.
- +
- - Es wird der Filename des letzten Schnapschusses ermittelt. Der Befehl wird implizit mit "get <name> snap" + + Es wird der Filename des letzten Schnapschusses ermittelt. Der Befehl wird implizit mit "get <name> snap" ausgeführt.
- +
+
- - Es werden Schnappschussinformationen gelesen. Hilfreich wenn Schnappschüsse nicht durch SSCam, sondern durch die Bewegungserkennung der Kamera + + Es werden Schnappschussinformationen gelesen. Hilfreich wenn Schnappschüsse nicht durch SSCam, sondern durch die Bewegungserkennung der Kamera oder Surveillance Station erzeugt werden.
- +
+
- - Mit diesem Kommando wird der aktuelle Streamkey der Kamera abgerufen und das Reading mit dem Key-Wert gefüllt. + + Mit diesem Kommando wird der aktuelle Streamkey der Kamera abgerufen und das Reading mit dem Key-Wert gefüllt. Dieser Streamkey kann verwendet werden um eigene Aufrufe eines Livestreams aufzubauen (siehe Beispiel). Wenn das Attribut "showStmInfoFull" gesetzt ist, werden zusaätzliche Stream-Informationen wie "StmKeyUnicst", "StmKeymjpegHttp" ausgegeben. - Diese Readings enthalten die gültigen Stream-Pfade zu einem Livestream und können z.B. versendet und von einer entsprechenden Anwendung ohne session Id geöffnet werden. + Diese Readings enthalten die gültigen Stream-Pfade zu einem Livestream und können z.B. versendet und von einer entsprechenden Anwendung ohne session Id geöffnet werden. Wenn das Attribut "livestreamprefix" (Format: "http(s)://<hostname><port>) gesetzt ist, wird der Servername und Port überschrieben soweit es sinnvoll ist. Wird Polling der Kameraeigenschaften genutzt, wird die stmUrlPath-Funktion automatisch mit ausgeführt.
- - Beispiel für den Aufbau eines Http-Calls zu einem Livestream mit StmKey: - + + Beispiel für den Aufbau eines Http-Calls zu einem Livestream mit StmKey: +http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceStation.VideoStreaming&version=1&method=Stream&format=mjpeg&cameraId=5&StmKey="31fd87279976d89bb98409728cced890"
- + cameraId (Internal CAMID), StmKey müssen durch gültige Werte ersetzt werden.
- + Hinweis:
- - Falls der Stream-Aufruf versendet und von extern genutzt wird sowie hostname / port durch gültige Werte ersetzt und die - Routerports entsprechend geöffnet werden, ist darauf zu achten, dass diese sensiblen Daten nicht durch unauthorisierte Personen + + Falls der Stream-Aufruf versendet und von extern genutzt wird sowie hostname / port durch gültige Werte ersetzt und die + Routerports entsprechend geöffnet werden, ist darauf zu achten, dass diese sensiblen Daten nicht durch unauthorisierte Personen für den Zugriff genutzt werden können !
- +
- + Die gespeicherten Anmeldeinformationen (Credentials) werden in einem Popup als Klartext angezeigt.
- +
+
- + Ermittelt allgemeine Informationen zur installierten SVS-Version und andere Eigenschaften.
- +
+
- - Zeigt Release Informationen und/oder Hinweise zum Modul an. Es sind nur Release Informationen mit Bedeutung für den + + Zeigt Release Informationen und/oder Hinweise zum Modul an. Es sind nur Release Informationen mit Bedeutung für den Modulnutzer enthalten.
Sind keine Optionen angegben, werden sowohl Release Informationen als auch Hinweise angezeigt. "rel" zeigt nur Release - Informationen und "hints" nur Hinweise an. Mit der <key>-Angabe wird der Hinweis mit der angegebenen Nummer + Informationen und "hints" nur Hinweise an. Mit der <key>-Angabe wird der Hinweis mit der angegebenen Nummer angezeigt. Ist das Attribut "language = DE" im global Device gesetzt, erfolgt die Ausgabe der Hinweise in deutscher Sprache.
- +
+
- + Einstellung Email-Versand
-
- Schnappschüsse und Aufnahmen können nach der Erstellung per Email versendet werden. Dazu enthält das
- Modul einen eigenen Email-Client.
- Zur Verwendung dieser Funktion muss das Perl-Modul MIME::Lite installiert sein. Auf Debian-Systemen kann
+ Schnappschüsse und Aufnahmen können nach der Erstellung per Email versendet werden. Dazu enthält das
+ Modul einen eigenen Email-Client.
+ Zur Verwendung dieser Funktion muss das Perl-Modul MIME::Lite installiert sein. Auf Debian-Systemen kann
es mit
- +-
sudo apt-get install libmime-lite-perl
- + installiert werden.
- + Für die Verwendung des Email-Versands müssen einige Attribute gesetzt oder können optional genutzt werden.
Die Credentials für den Zugang zum Email-Server müssen mit dem Befehl "set <name> smtpcredentials <user> <password>" hinterlegt werden. Der Verbindungsaufbau zum Postausgangsserver erfolgt initial unverschüsselt und wechselt zu einer verschlüsselten Verbindung wenn SSL zur Verfügung steht. In diesem Fall erfolgt auch die Übermittlung von User/Password verschlüsselt. - Ist das Attribut smtpSSLPort definiert, erfolgt der Verbindungsaufbau zum Email-Server sofort verschlüsselt. + Ist das Attribut smtpSSLPort definiert, erfolgt der Verbindungsaufbau zum Email-Server sofort verschlüsselt.
- + Optionale Attribute sind gekennzeichnet:
- --
-
+ +
-
+
-snapEmailTxt - Aktiviert den Email-Versand von Schnappschüssen. + snapEmailTxt - Aktiviert den Email-Versand von Schnappschüssen. Das Attribut hat das Format:
subject => <Betreff-Text>, body => <Mitteilung-Text>
- Der Email-Versand des letzten Schnappschusses wird einmalig aktiviert falls der "snapEmailTxt:"-Tag - beim "snap"-Kommando verwendet wird bzw. der in diesem Tag definierte Text statt des Textes im + Der Email-Versand des letzten Schnappschusses wird einmalig aktiviert falls der "snapEmailTxt:"-Tag + beim "snap"-Kommando verwendet wird bzw. der in diesem Tag definierte Text statt des Textes im Attribut "snapEmailTxt" verwendet.recEmailTxt - Aktiviert den Email-Versand von Aufnahmen. + recEmailTxt - Aktiviert den Email-Versand von Aufnahmen. Das Attribut hat das Format:
subject => <Betreff-Text>, body => <Mitteilung-Text>
- Der Email-Versand der letzten Aufnahme wird einamlig aktiviert falls der "recEmailTxt:"-Tag beim - "on"-Kommando verwendet wird bzw. der in diesem Tag definierte Text statt des Textes im + Der Email-Versand der letzten Aufnahme wird einamlig aktiviert falls der "recEmailTxt:"-Tag beim + "on"-Kommando verwendet wird bzw. der in diesem Tag definierte Text statt des Textes im Attribut "recEmailTxt" verwendet.smtpHost - Hostname oder IP-Adresse des Postausgangsservers (z.B. securesmtp.t-online.de) smtpFrom - Absenderadresse (<name>@<domain>) smtpTo - Empfängeradresse(n) (<name>@<domain>) smtpSSLPort - (optional) SSL-Port des Postausgangsservers (default: 465) smtpDebug - (optional) zum Debugging der SMTP-Verbindung setzen
- + Zur näheren Erläuterung siehe Beschreibung der Attribute.
Erläuterung der Platzhalter:
- --
-
+ +
-
+
-$CAM - Device-Alias bzw. den Namen der Kamera in der SVS ersetzt falls der Device-Alias nicht vorhanden ist $DATE - aktuelles Datum $FILE - Filename des Schnappschusses $CTIME - Erstellungszeit des Schnappschusses
- +
- + Polling der Kamera/SVS-Eigenschaften:
-
@@ -15271,13 +15290,13 @@ http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceSta
Wird FHEM neu gestartet, wird bei aktivierten Polling der ersten Datenabruf innerhalb 60s nach dem Start ausgeführt.
Der Status des automatischen Pollings wird durch das Reading "PollState" signalisiert:
- +
- + Die Bedeutung der Readingwerte ist unter Readings beschrieben.
Hinweise:
@@ -15291,9 +15310,9 @@ http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceSta Sind mehrere Kameras in SSCam definiert, sollte "pollcaminfoall" nicht bei allen Kameras auf exakt den gleichen Wert gesetzt werden um Verarbeitungsengpässe
und dadurch versursachte potentielle Fehlerquellen bei der Abfrage der Synology Surveillance Station zu vermeiden.
- Ein geringfügiger Unterschied zwischen den Pollingintervallen der definierten Kameras von z.B. 1s kann bereits als ausreichend angesehen werden. + Ein geringfügiger Unterschied zwischen den Pollingintervallen der definierten Kameras von z.B. 1s kann bereits als ausreichend angesehen werden.
+
Internals
@@ -15306,10 +15325,10 @@ http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceSta
@@ -15320,30 +15339,30 @@ http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceSta
-
-
+
-
- snapGalleryBoost
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Filename of the (last) snapshot (only usable in body) $CTIME (#CTIME) - Creation time of the (last) snapshot (only usable in body)
- +-
Example:
snapEmailTxt subject => Motion alarm $CAM, body => A motion was recognized at $CAM.
- + - snapTelegramTxt tbot => <TelegramBot device>, peers => [<peer1 peer2 ...>], subject => [<subject text>], option => [silent]
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Name of snapshot file $CTIME (#CTIME) - creation time of the snapshot
+ +
Examples:
attr <device> snapChatTxt chatbot => SynChatBot, peers => , subject => Motion alarm ($FILE)
@@ -13693,16 +13710,16 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR attr <device> snapChatTxt chatbot => SynChatBot, peers => , subject => Caution !
attr <device> snapChatTxt chatbot => SynChatBot, peers => Frodo, subject => Motion alarm from $CAM. At $CTIME the snapshot $FILE was created
-
- +
+ - snapEmailTxt subject => <subject text>, body => <message text>
+ +
-
+
-tbot Name of the TelegramBot-Device peers List of recipients separated by spaces (optional). If peers is not specified, the default peer of the TelegramBot device is used. subject the text to be transmitted (optional) option possible TelegramBot sending options described below (optional) silent : the signaling at the receiver is suppressed tbot Name of the TelegramBot-Device peers List of recipients separated by spaces (optional). It can be specified r:<Reading> to read the recipients from the <Reading>. If peers is not specified, the default peer of the TelegramBot device is used. subject the text to be transmitted (optional) option possible TelegramBot sending options described below (optional) silent : the signaling at the receiver is suppressed
- + +
+ You can use the following placeholders within "subject".
- --
-
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Name of recording file $CTIME (#CTIME) - recording creation time
- + +
+ Examples:
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => Motion alarm ($FILE)
attr <device> recTelegramTxt tbot => teleBot, peers => @nabuko @foo @bar, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => #nabugroup, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => -123456, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => , subject =>
+ attr <device> recTelegramTxt tbot => teleBot, peers => r:peerTelegram, subject =>
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => without signalization, option => silent
attr <device> recTelegramTxt tbot => teleBot, peers => , subject => Motion alarm from $CAM. At $CTIME the recording $FILE was created. Now it is $TIME.
-
- +
+
- +
- +
- +
- +
- +
- +
- +
- +
- +
- +
- + - rectime
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Filename of the (last) recording (only usable in body) $CTIME (#CTIME) - Creation time of the (last) recording (only usable in body)
- +-
Example:
recEmailTxt subject => New recording $CAM, body => A new recording of $CAM is created and atteched.
- + - recTelegramTxt tbot => <TelegramBot-Device>, peers => [<peer1 peer2 ...>], subject => [<Text>], option => [silent]
+ +
-
+
-$CAM (#CAM) - Device alias respectively the name of the camera in SVS if the device alias isn't set $DATE (#DATE) - current date $FILE (#FILE) - Name of recording file $CTIME (#CTIME) - recording creation time
- + +
+ Examples:
attr <device> recChatTxt chatbot => teleBot, peers => , subject => Motion alarm ($FILE)
attr <device> recChatTxt chatbot => teleBot, peers => Frodo Sam Gollum, subject => Motion alarm
attr <device> recChatTxt chatbot => teleBot, peers => , subject => Motion alarm
attr <device> recChatTxt chatbot => teleBot, peers => , subject => Motion alarm from $CAM. At $CTIME the recording $FILE was created. Now it is $TIME.
-
- +
+ - cacheType
| Start Recording | - starts an endless recording |
| Stop Recording | - stopps the recording |
| Take Snapshot | - take a snapshot |
| Switch off | - stops a running playback |
- + Note for HLS (HTTP Live Streaming):
- The video starts with a technology caused delay. Every stream will be segemented into some little video files - (with a lenth of approximately 10 seconds) and is than delivered to the client. + The video starts with a technology caused delay. Every stream will be segemented into some little video files + (with a lenth of approximately 10 seconds) and is than delivered to the client. The video format of the camera has to be set to H.264 in the Synology Surveillance Station and not every camera type is a proper device for HLS-Streaming. - At the time only the Mac Safari Browser and modern mobile iOS/Android-Devices are able to playback HLS-Streams. + At the time only the Mac Safari Browser and modern mobile iOS/Android-Devices are able to playback HLS-Streams.
- + Note for MJPEG:
The MJPEG stream is SVS internal transcoded from other codec and is usally only about 1 fps. - +
- +
- + Set the Home-preset to a predefined preset name "<PresetName>" or the current position of the camera.
- +
- - Sets a Preset with name "<PresetName>" to the current postion of the camera. The speed can be defined + + Sets a Preset with name "<PresetName>" to the current postion of the camera. The speed can be defined optionally (<Speed>). If no PresetName is specified, the PresetNummer is used as name. For this reason <PresetName> is defined as optional, but should usually be set.
- +
- + Provides controls for zoom functions if the camera supports this feature.
- +
- + One or multiple snapshots are triggered. The number of snapshots to trigger and the time difference (in seconds) between each snapshot can be optionally specified. Without any specification only one snapshot is triggered.
- The ID and the filename of the last snapshot will be displayed in Reading "LastSnapId" respectively + The ID and the filename of the last snapshot will be displayed in Reading "LastSnapId" respectively "LastSnapFilename".
To get data of the last 1-10 snapshots in various versions, the attribute snapReadingRotate can be used.
- - A snapshot shipping by Synology Chat can be permanently activated by setting attribute snapChatTxt. - Of course, the SSChatBot device which is + + A snapshot shipping by Synology Chat can be permanently activated by setting attribute snapChatTxt. + Of course, the SSChatBot device which is used must be defined and fully functional before.
- If you want temporary overwrite the subject set in attribute "snapChatTxt", you can optionally specify the + If you want temporary overwrite the subject set in attribute "snapChatTxt", you can optionally specify the "snapChatTxt:"-tag as shown above. If the attribute "snapChatTxt" is not set, the shipping by SSChatBot is activated one-time (the tag-syntax is equivalent to the "snapChatTxt" attribute).
- In either case the attribute videofolderMap has to be set before. It must contain an URL to the + In either case the attribute videofolderMap has to be set before. It must contain an URL to the root directory of recordings and snapshots (e.g. http://server.me:8081/surveillance).
- - The snapshot Email shipping can be activated by setting attribute snapEmailTxt. - Before you have to prepare the Email shipping as described in section Setup Email shipping. + + The snapshot Email shipping can be activated by setting attribute snapEmailTxt. + Before you have to prepare the Email shipping as described in section Setup Email shipping. (for further information execute "get <name> versionNotes 7")
- If you want temporary overwrite the message text set in attribute "snapEmailTxt", you can optionally specify the + If you want temporary overwrite the message text set in attribute "snapEmailTxt", you can optionally specify the "snapEmailTxt:"-tag as shown above. If the attribute "snapEmailTxt" is not set, the Email shipping is activated one-time. (the tag-syntax is equivalent to the "snapEmailTxt" attribut)
- - A snapshot shipping by Telegram can be permanently activated by setting attribute snapTelegramTxt. - Of course, the TelegramBot device which is + + A snapshot shipping by Telegram can be permanently activated by setting attribute snapTelegramTxt. + Of course, the TelegramBot device which is used must be defined and fully functional before.
- If you want temporary overwrite the message text set in attribute "snapTelegramTxt", you can optionally specify the + If you want temporary overwrite the message text set in attribute "snapTelegramTxt", you can optionally specify the "snapTelegramTxt:"-tag as shown above. If the attribute "snapTelegramTxt" is not set, the shipping by Telegram is activated one-time. (the tag-syntax is equivalent to the "snapTelegramTxt" attribut)
- + Examples:
set <name> snap
- set <name> snap 4
+ set <name> snap 4
set <name> snap 3 3 snapEmailTxt:"subject => Movement alarm $CAM, body => A movement was recognised at Carport"
set <name> snap 2 snapTelegramTxt:"tbot => teleBot, peers => , subject => Movement alarm by $CAM. The snapshot $FILE was created at $CTIME, option => silent"
set <name> snap 2 snapChatTxt:"chatbot => SynChatBot , peers => Frodo Sam, subject => Movement alarm by $CAM. At $CTIME the snapshot $FILE was created. Now it is: $TIME."
- +
- - One or multiple snapshots of denoted cameras are triggered. If no cameras are denoted, the snapshots are triggered in all + + One or multiple snapshots of denoted cameras are triggered. If no cameras are denoted, the snapshots are triggered in all of the defined cameras in FHEM. Optionally the number of snapshots to trigger (default: 1) and the time difference (in seconds) between each snapshot (default: 2) can be specified.
The ID and the filename of the last snapshot will be displayed in Reading "LastSnapId" respectively "LastSnapFilename" of the appropriate camera device.
- - The snapshot Email shipping can be activated by setting attribute "snapEmailTxt" in the - SVS device AND in the camera devices whose snapshots should be shipped. - Before you have to prepare the Email shipping as described in section Setup Email shipping. + + The snapshot Email shipping can be activated by setting attribute "snapEmailTxt" in the + SVS device AND in the camera devices whose snapshots should be shipped. + Before you have to prepare the Email shipping as described in section Setup Email shipping. (for further information execute "get <name> versionNotes 7")
- Only the message text set in attribute "snapEmailTxt" of the SVS device is used in the created Email. The settings of + Only the message text set in attribute "snapEmailTxt" of the SVS device is used in the created Email. The settings of those attribute in the camera devices is ignored !!
- + Examples:
- set <name> snapCams 4
+ set <name> snapCams 4
set <name> snapCams 3 3 CAM:"CamHE1, CamCarport"
- +
- + The command is only available if the attribute "snapGalleryBoost=1" is set.
It creates an output of the last [x] snapshots as well as "get ... snapGallery". But differing from "get" with attribute "snapGalleryBoost=1" no popup will be created. The snapshot gallery will be depicted as an browserpage instead. All further functions and attributes are appropriate the "get <name> snapGallery" command.
- If you want create a snapgallery output by triggering, e.g. with an "at" or "notify", you should use the + If you want create a snapgallery output by triggering, e.g. with an "at" or "notify", you should use the "get <name> snapGallery" command instead of "set".
- + Note
The camera names in Synology SVS should not be very similar, otherwise the retrieval of snapshots could come to inaccuracies.
- +
- + Starts object tracking of camera. The command is only available if surveillance station has recognised the object tracking capability of camera (Reading "CapPTZObjTracking").
- +
- + Stops object tracking of camera. The command is only available if surveillance station has recognised the object tracking capability of camera (Reading "CapPTZObjTracking").
- +
@@ -12904,54 +12919,54 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
With SSCam the properties of SVS and defined Cameras could be retrieved.
- The specified get-commands are available for CAM/SVS-devices or only valid for CAM-devices or rather for SVS-Devices. + The specified get-commands are available for CAM/SVS-devices or only valid for CAM-devices or rather for SVS-Devices. They can be selected in the drop-down-menu of the particular device.
- +
-
-
- + Dependend of the type of camera (e.g. Fix- or PTZ-Camera) the available properties are retrieved and provided as Readings.
- For example the Reading "Availability" will be set to "disconnected" if the camera would be disconnected from Synology + For example the Reading "Availability" will be set to "disconnected" if the camera would be disconnected from Synology Surveillance Station and can't be used for further processing like creating events.
"getcaminfo" retrieves a subset of "getcaminfoall".
- +
+
- - The Reading "CamEventNum" and "CamLastRecord" will be refreshed which containes the total number - of in SVS registered camera events and the path/name of the last recording. + + The Reading "CamEventNum" and "CamLastRecord" will be refreshed which containes the total number + of in SVS registered camera events and the path/name of the last recording. This command will be implicit executed when "get <name> caminfoall" is running.
- The attribute "videofolderMap" replaces the content of reading "VideoFolder". You can use it for - example if you have mounted the videofolder of SVS under another name or path and want to access by your local pc. + The attribute "videofolderMap" replaces the content of reading "VideoFolder". You can use it for + example if you have mounted the videofolder of SVS under another name or path and want to access by your local pc.
- - HomeMode-state of the Surveillance Station will be retrieved. + + HomeMode-state of the Surveillance Station will be retrieved.
get <name> listLog severity:Error limit:5 @@ -12969,188 +12984,188 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
get <name> listLog severity:Warning Reports all Log entries with severity "Warning"
In the protocol-setup of the SVS you can adjust what data you want to log. For further informations please have a look at Synology Online-Help.
+
- + Get a popup with a lists of presets saved for the camera.
- +
- - The (last) snapshot currently specified in the reading "LastSnapId" is saved locally as a jpg file. + + The (last) snapshot currently specified in the reading "LastSnapId" is saved locally as a jpg file. Optionally, the path to save the file can be specified in the command (default: modpath in global Device).
The file is locally given the same name as contained in the reading "LastSnapFilename".
The resolution of the snapshot is determined by the attribute "snapGallerySize". - +
- +
-
Example:
get <name> saveLastSnap /opt/fhem/log
- - The current recording present in Reading "CamLastRec" is saved lcally as a MP4 file. Optionally you can specify the path + + The current recording present in Reading "CamLastRec" is saved lcally as a MP4 file. Optionally you can specify the path for the file to save (default: modpath in global device).
The name of the saved local file is the same as displayed in Reading "CamLastRec".
- +
-
Example:
get <name> saveRecording /opt/fhem/log
- +
+
- - This command is similar to get caminfoall, informations relating to SVS and the camera will be retrieved. + + This command is similar to get caminfoall, informations relating to SVS and the camera will be retrieved. In difference to caminfoall in either case a new session ID will be generated (do a new login), the camera ID will be - new identified and all necessary API-parameters will be new investigated. + new identified and all necessary API-parameters will be new investigated.
- +
+
- - A popup with the last [x] snapshots will be created. If the attribute "snapGalleryBoost" is set, - the last snapshots (default 3) are requested by polling and they will be stored in the FHEM-servers main memory. - This method is helpful to speed up the output especially in case of full size images, but it can be possible + + A popup with the last [x] snapshots will be created. If the attribute "snapGalleryBoost" is set, + the last snapshots (default 3) are requested by polling and they will be stored in the FHEM-servers main memory. + This method is helpful to speed up the output especially in case of full size images, but it can be possible that NOT the newest snapshots are be shown if they have not be initialized by the SSCAm-module itself.
- The function can also be triggered, e.g. by an "at" or "notify". In that case the snapshotgallery will be displayed on all + The function can also be triggered, e.g. by an "at" or "notify". In that case the snapshotgallery will be displayed on all connected FHEMWEB instances as a popup.
- + To control this function behavior there are further attributes:
- +
-
-
available.
- +
-
Note:
Depended from quantity and resolution (quality) of the snapshot images adequate CPU and/or main memory - ressources are needed. The camera names in Synology SVS should not be very similar, otherwise the retrieval of + ressources are needed. The camera names in Synology SVS should not be very similar, otherwise the retrieval of snapshots could come to inaccuracies.
- +
- - The filename of the last snapshot will be retrieved. This command will be executed with "get <name> snap" + + The filename of the last snapshot will be retrieved. This command will be executed with "get <name> snap" automatically.
- +
+
- + Informations about snapshots will be retrieved. Heplful if snapshots are not triggerd by SSCam, but by motion detection of the camera or surveillance station instead.
- +
+
- - This command is to fetch the streamkey information and streamurl using that streamkey. The reading "StmKey" will be filled when this command will be executed and can be used + + This command is to fetch the streamkey information and streamurl using that streamkey. The reading "StmKey" will be filled when this command will be executed and can be used to send it and run by your own application like a browser (see example). - If the attribute "showStmInfoFull" is set, additional stream readings like "StmKeyUnicst", "StmKeymjpegHttp" will be shown and can be used to run the + If the attribute "showStmInfoFull" is set, additional stream readings like "StmKeyUnicst", "StmKeymjpegHttp" will be shown and can be used to run the appropriate livestream without session id. Is the attribute "livestreamprefix" (usage: "http(s)://<hostname><port>) used, the servername / port will be replaced if necessary. The strUrlPath function will be included automatically if polling is used.
- + Example to create an http-call to a livestream using StmKey:
- +
http(s)://<hostname><port>/webapi/entry.cgi?api=SYNO.SurveillanceStation.VideoStreaming&version=1&method=Stream&format=mjpeg&cameraId=5&StmKey="31fd87279976d89bb98409728cced890"
-
+
cameraId (Internal CAMID) and StmKey has to be replaced by valid values. - + Note:
- - If you use the stream-call from external and replace hostname / port with valid values and open your router ip ports, please - make shure that no unauthorized person could get this sensible data ! + + If you use the stream-call from external and replace hostname / port with valid values and open your router ip ports, please + make shure that no unauthorized person could get this sensible data !
- +
- + Shows the stored login credentials in a popup as plain text.
- +
+
- + Determines common informations about the installed SVS-version and other properties.
+
- + Shows realease informations and/or hints about the module. It contains only main release informations for module users.
If no options are specified, both release informations and hints will be shown. "rel" shows only release informations and "hints" shows only hints. By the <key>-specification only the hint with the specified number is shown.
+
Setup Email shipping
- +
-
- Snapshots and recordings can be sent by Email after creation. For this purpose the module contains its
- own Email client. Before you can use this function you have to install the Perl-module MIME::Lite. On debian
+ Snapshots and recordings can be sent by Email after creation. For this purpose the module contains its
+ own Email client. Before you can use this function you have to install the Perl-module MIME::Lite. On debian
systems it can be installed with command:
- +
-
sudo apt-get install libmime-lite-perl
- + There are some attributes must be set or can be used optionally.
At first the Credentials for access the Email outgoing server must be set by command "set <name> smtpcredentials <user> <password>". - The connection establishment to the server is initially done unencrypted and switches to an encrypted connection if SSL - encryption is available. In that case the transmission of User/Password takes place encrypted too. + The connection establishment to the server is initially done unencrypted and switches to an encrypted connection if SSL + encryption is available. In that case the transmission of User/Password takes place encrypted too. If attribute "smtpSSLPort" is defined, the established connection to the Email server will be encrypted immediately. Attributes which are optional are marked:
- -
-
-
| snapEmailTxt | - Activates the Email shipping of snapshots. This attribute has the format: subject => <subject text>, body => <message text>
+ The placeholder $CAM, $DATE and $TIME can be used. Optionally you can specify the "snapEmailTxt:"-tag when trigger a snapshot with the "snap"-command. - In this case the Email shipping is activated one-time for the snapshot or the tag-text + In this case the Email shipping is activated one-time for the snapshot or the tag-text is used instead of the text defined in the "snapEmailTxt"-attribute. |
| smtpSSLPort | - (optional) Port for SSL encrypted connection (default: 465) |
| smtpDebug | - (optional) switch on the debugging of SMTP connection |
- + For further information please see description of the attributes.
- + Description of the placeholders:
- -
-
-
| $CAM | - Device alias respectively the name of the camera in SVS if the device alias isn't set |
| $DATE | - current date |
| $FILE | - name of the snapshot file |
| $CTIME | - creation time of the snapshot |
- -
- + +
+ +
+ Polling of Camera/SVS-Properties
-
@@ -13210,13 +13225,13 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
If FHEM will be restarted, the first data retrieval will be done within 60 seconds after start.
The state of automatic polling will be displayed by reading "PollState":
- +
- + The readings are described here.
Notes:
@@ -13229,9 +13244,9 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR If several Cameras are defined in SSCam, attribute "pollcaminfoall" of every Cameras shouldn't be set exactly to the same value to avoid processing bottlenecks
and thereby caused potential source of errors during request Synology Surveillance Station.
- A marginal difference between the polling intervals of the defined cameras, e.g. 1 second, can already be faced as + A marginal difference between the polling intervals of the defined cameras, e.g. 1 second, can already be faced as sufficient value.
-
@@ -13258,30 +13273,30 @@ attr <name> genericStrmHtmlTag <img $HTMLATTR
-
-
+
-