FHEMWiki - Benutzerbeiträge [de]

HM-Sen-DB-PCB Klingelsignalsensor

2018-12-24T08:32:08Z

Docb: Link zum Gehäuse ergänzt

{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=BidCoS ([[HomeMatic]])
|HWType=Sensor
|HWCategory=Sensor
|HWComm=868,3 MHz
|HWChannels=1
|HWVoltage=3 V
|HWPowerConsumption=30 mA (max)
|HWPoweredBy=2x1,5 V (Micro/AAA/LR03)
|HWSize=68 x 127 x 23 mm (mit Antenne), 68 x 58 x 23 mm (ohne Antenne)
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}

[[HM-Sen-DB-PCB]] ist ein Funk-Klingelsignalsensor, der auf externe Signalspannung reagiert und angelernte HomeMatic-Geräte über Funk steuert.

== Features / Funktionen ==
Die auslösende Signalspannung kann sowohl Gleich- als auch Wechselspannung sein, die zwischen 5 und 12 V liegt. Das Gerät kann somit direkt in eine bestehende Klingelanlage integriert werden. Alternativ kann ein potentialfreier Taster zur Auslösung verwendet werden.
* Als Sensor zur Spannungserkennung oder als Taster-Sender einsetzbar
* Kann andere HomeMatic-Geräte direkt ansteuern oder Anbindung über FHEM möglich
* Lange Batterielebensdauer (ca. 5 Jahre)

== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie unter [[HomeMatic Devices pairen]] beschrieben durchgeführt werden.

== Bekannte Probleme ==
Der Klingelsignalsensor sendet keine zyklische Statusmeldung und Batterieüberwachung. Erst bei Signalerkennung sendet das Gerät den erkannten Tastendruck und liefert den aktuellen Status.

== Beispiel zu Auslesen ==
Das Beispiel zeigt, wie der Klingelsensor ausgelesen werden kann um damit Aktionen auszuführen.
Der Code wurde direkt aus dem fhem.cfg kopiert.

define 1OG.KLINGEL.DOIF DOIF ([1OG.KLINGEL:?Short]) \
(\
set 2OG.WHZ.CABTV1 msg yesno 15 1OG.KLINGEL - Es steht jemand vor der Tür, \
set 1OG.SZ.CABTV1 msg yesno 15 1OG.KLINGEL - Es steht jemand vor der Tür, \
set pushmsg.fhemapp.* message '1OG.KLINGEL Es steht jemand vor der Tür', \
set FritzBox ring 610 15 show:Türklingel\
)

== Gehäuse ==
Wer ein alternatives Gehäuse sucht, bitteschön:
https://www.thingiverse.com/thing:3310346

== Weblinks ==
* [http://www.elv.de/homematic-funk-klingelsignalsensor-bausatz.html Produktbeschreibung bei ELV]

[[Kategorie:HomeMatic Components]]
[[Kategorie:868MHz]]

SSCAM - Steuerung von Kameras in Synology Surveillance Station

2016-07-18T13:17:13Z

Docb: Neu eingefügt: Workaround bei DSM 2-Stufen Verifizierung

{{Infobox Modul
|ModPurpose=Steuerung von Kameras in Synology Surveillance Station
|ModType=d
|ModCmdRef=SSCam
|ModForumArea=Sonstiges
|ModTechName=49_SSCam.pm
|ModOwner=nasseeder1 (Forum: DS_Starter)}}

== Zweckbeschreibung ==

Mit diesem Modul können Operationen von in der Synology Surveillance Station (SVS) definierten Kameras ausgeführt werden.
Es basiert auf der SVS API und unterstützt die SVS ab Version 7.
Zur Zeit werden folgende Funktionen unterstützt:

* Start einer Aufnahme
* Stop einer Aufnahme (per Befehl bzw. automatisch nach Ablauf der Aufnahmedauer)
* Aufnehmen eines Schnappschusses und Ablage in der Synology Surveillance Station
* Deaktivieren einer Kamera in Synology Surveillance Station
* Aktivieren einer Kamera in Synology Surveillance Station
* Steuerung der Belichtungsmodi Tag, Nacht bzw. Automatisch
* Umschaltung der Ereigniserkennung durch Kamera, durch SVS oder deaktiviert
* Abfrage von Kameraeigenschaften (auch mit Polling) sowie den Eigenschaften des installierten SVS-Paketes
* Bewegen an eine vordefinierte Preset-Position (bei PTZ-Kameras)
* Start einer vordefinierten Überwachungstour (bei PTZ-Kameras)
* Positionieren von PTZ-Kameras zu absoluten X/Y-Koordinaten
* kontinuierliche Bewegung von PTZ-Kameras
* auslösen externer Ereignisse 1-10 (Aktionsregel SVS)
* starten und beenden von Kamera-Livestreams
* abspielen der letzten Aufnahme

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: 
{{Link2Forum|Topic=45671.0 |LinkText=49_SSCam: Fragen, Hinweise, Neuigkeiten und mehr rund um dieses Modul}}

 

== Vorbereitung ==

Dieses Modul nutzt das Perl-Modul JSON. Bitte darauf achten dieses Paket zu installieren. (Debian: apt-get install libjson-perl).
SSCAM verwendet für HTTP-Calls die nichtblockierenden Funktionen von HttpUtils bzw. HttpUtils_NonblockingGet.
Im DSM bzw. der Synology Surveillance Station muß ein Nutzer für den Zugriff aus FHEM angelegt sein. Die Zugangsdaten für diesen Nutzer werden später über ein Set-Kommando dem angelegten Gerät zugewiesen. 
Nähere Informationen dazu unter [[#Credentials | Credentials]].

 

== Define ==
<pre>
define <name> SSCam <Kameraname in SVS> <ServerAddr> [Port]
</pre>

Definiert eine neue Kamera für SSCam. Zunächst muß diese Kamera in der Synology Surveillance Station 7.0 oder höher eingebunden sein und entsprechend funktionieren.

Das Modul SSCam basiert auf Funktionen der Synology Surveillance Station API.
Weitere Informationen unter: [http://global.download.synology.com/download/Document/DeveloperGuide/Surveillance_Station_Web_API_v2.0.pdf Web API Guide].

Momentan wird nur das HTTP-Protokoll unterstützt um die Web-Services der Synology DS aufzurufen.

Die Parameter beschreiben im Einzelnen:

<pre>
name : der Name des neuen Gerätes in FHEM
Kameraname : Kameraname wie er in der Synology Surveillance Station angegeben ist. Leerzeichen im Namen sind nicht erlaubt !
ServerAddr : die IP-Addresse des Synology Surveillance Station Host.
Achtung: Es sollte kein Servername verwendet werden weil DNS-Aufrufe in FHEM blockierend sind
Port : optional - der Port des Synology Surveillance Station Host.
Wenn nicht angegeben, wird der Standardport 5000 gesetzt(nur HTTP)
</pre>

Beispiel:

define CamCP SSCAM Carport 192.168.2.20 [5000]

Wird eine neue Kamera definiert, wird diesem Device zunächst eine Standardaufnahmdauer 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"''' gestoppt werden muß. Ein Logeintrag mit einem entsprechenden Hinweis auf diesen Umstand wird geschrieben.

Wird das Attribut "rectime" gelöscht, greift wieder der Default-Wert (15s) für die Aufnahmedauer.

Mit dem Befehl '''"set <name> on [rectime]"''' wird die Aufnahmedauer temporär festgelegt und überschreibt einmalig sowohl den Defaultwert als auch den Wert des gesetzten Attributs "rectime". 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.

=== Credentials ===

Nach dem Definieren des Gerätes müssen zuerst die Zugangsrechte gespeichert werden. Das geschieht mit dem Befehl:

set <name> credentials <username> <password>

Der Anwender kann in Abhängigkeit der beabsichtigten einzusetzenden Funktionen einen Nutzer im DSM bzw. in der Surveillance Station einrichten.
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/ 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.

* DSM-User als Mitglied der Admin-Gruppe: uneingeschränkter Test aller Modulfunktionen -> session:DSM
* SVS-User als Manager oder Betrachter: angepasstes Privilegienprofil -> session: SurveillanceStation

Über das Attribut "session" kann ausgewählt werden, ob die Session mit dem DSM oder der SVS augebaut werden soll.
Erfolgt der Session-Aufbau mit dem DSM, stehen neben der SVS Web-API auch darüber hinaus gehende 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 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.
<pre>
* set ... on session: ServeillanceStation - Betrachter mit erweiterten Privileg "manuelle Aufnahme"
* set ... off session: ServeillanceStation - Betrachter mit erweiterten Privileg "manuelle Aufnahme"
* set ... snap session: ServeillanceStation - Betrachter
* set ... disable session: ServeillanceStation - Manager
* set ... enable session: ServeillanceStation - Manager
* set ... expmode session: ServeillanceStation - Manager
* set ... motdetsc session: ServeillanceStation - Manager
* set ... goPreset session: ServeillanceStation - Betrachter mit Privileg Objektivsteuerung der Kamera
* set ... runPatrol session: ServeillanceStation - Betrachter mit Privileg Objektivsteuerung der Kamera
* set ... goAbsPTZ session: ServeillanceStation - Betrachter mit Privileg Objektivsteuerung der Kamera
* set ... move session: ServeillanceStation - Betrachter mit Privileg Objektivsteuerung der Kamera
* set ... runView session: ServeillanceStation - Betrachter mit Privileg Liveansicht für Kamera
* set ... stopView -
* set ... credentials -
* set ... extevent session: DSM - Nutzer Mitglied von Admin-Gruppe
* get ... caminfoall session: ServeillanceStation - Betrachter
* get ... eventlist session: ServeillanceStation - Betrachter
* get ... svsinfo session: ServeillanceStation - Betrachter
* get ... svsinfo session: ServeillanceStation - Betrachter

</pre>

=== HTTP-Timeout setzen ===

Alle Funktionen dieses Moduls verwenden HTTP-Aufrufe gegenüber der SVS Web API. 
Der Standardwert für den HTTP-Timeout beträgt 4 Sekunden.
Durch Setzen des Attributes "httptimeout" > 0 kann dieser Wert bei Bedarf entsprechend den technischen Gegebenheiten angepasst werden.

 

== Set ==

Es gibt zur Zeit folgende Optionen für "set <name> ...".

<pre>
"on [rectime]": startet eine Aufnahme. Die Aufnahme wird automatisch nach Ablauf der Zeit [rectime]
gestoppt.
mit rectime = 0 wird eine Daueraufnahme gestartet die durch "set <name> off"
wieder gestoppt werden muß.
"off" : stoppt eine laufende Aufnahme manuell oder durch die Nutzung anderer Events
(z.B. über at, notify)
"snap": löst einen Schnappschuß der entsprechenden Kamera aus und speichert ihn in der SVS
"disable": deaktiviert eine Kamera in der Surveillance Station
"enable": aktiviert eine Kamera in der Surveillance Station
"credentials <username> <password>": speichert die Zugangsinformationen
"expmode [ day | night | auto ]": aktiviert den Belichtungsmodus Tag, Nacht oder Automatisch
"extevent [ 1-10 ]": löst das externe Ereignis 1-10 aus (Aktionsregeleditor in SVS)
"motdetsc [ by_camera | by_SVS | disable ]": schaltet die Bewegungserkennung in den gewünschten Modus
(durch Kamera, SVS, oder deaktiviert)
"goPreset <Presetname>": fährt eine PTZ-Kamera zu einer vordefinierten Preset-Position
"runPatrol <Patrolname>": startet eine vordefinierte Überwachungstour einer PTZ-Kamera
"goAbsPTZ [ X Y | up | down | left | right ]": positioniert eine PTZ-Kamera zu einer X/Y-Koordinate oder in Richtung up/down/left/right
"move [ up | down | left | right | dir_X ]": startet kontinuerliche Bewegung einer PTZ-Kamera in Richtung up/down/left/right bzw. dir_X
"runView [image | lastrec | lastrec_open |
link | link_open <room>]": startet einen Livestream bzw. die letzte Aufnahme als eingbettetes Image, als Link
oder öffnet diesen Medienstream sofort
"stopView": Gegenteil von "runView"
</pre>

=== set <name> [on [rectime] | off] ===

Der Befehl "set <name> on" 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 werden muß.

Das Aufnahmeverhalten kann weiterhin mit dem Attribut "recextend" wie folgt beeinflusst werden.

'''Attribut "recextend = 0" bzw. nicht gesetzt (Standard):'''
* wird eine Aufnahme mit z.B. rectime=22 gestartet, wird kein weiterer Startbefehl für eine Aufnahme akzeptiert bis diese gestartete Aufnahme nach 22 Sekunden beendet ist. Ein Hinweis wird bei verbose=3 im Logfile protokolliert.

'''Attribut "recextend = 1" gesetzt:'''
* eine zuvor gestartete Aufnahme wird bei einem erneuten "set <name> on"-Befehl mit der Aufnahmezeit "rectime" neu parametrisiert. 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 <name> 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.

Beispiele für einfache Operationen:

<pre>
set <name> on [rectime] : startet die Aufnahme der Kamera <name>.
set <name> off : stoppt die Aufnahme der Kamera <name>
set <name> disable : deaktiviert die Kamera <name> in der Surveillance Station
set <name> enable : aktiviert die Kamera <name> in der Surveillance Station
</pre>

'''Hinweis:'''

In der SVS kann unter Aufnahmeeinstellungen der Kamera eine Vor-Aufnahmezeit eingestellt werden. Die Einstellung wird von der SVS bezüglich der Gesamtaufnahmezeit automatisch mit berücksichtigt.

Eine eingestellte Vor-Aufnahmezeit von z.B. 10s und eine rectime von 20s führt zu einer Gesamtaufnahmezeit von 30s (zzgl. Prozesszeit zur Befehlsabarbeitung).

=== set <name> snap ===

Ein Schnappschuß kann ausgelöst werden durch:

<pre>
set <name> snap
</pre>

Soll eine Reihe Schnappschüsse ausgelöst werden wenn eine Aufnahme startet, kann das durch folgendes notify geschehen.
Wird der Start der Kamera CamHE1 ausgelöst (vorher Attribut event-on-change-reading -> "Record" setzen), werden 3 Snapshots im Abstand von 2 Sekunden getriggert.

<pre>
define he1_snap_3 notify CamHE1:Record.*on define h3 at +*{3}00:00:02 set CamHE1 snap
</pre>

Triggern von 2 Schnappschüssen der Kamera "CamHE1" im Abstand von 6 Sekunden nachdem der Bewegungsmelder "MelderHE1" einen Event gesendet hat, kann z.B. mit folgendem notify geschehen:

<pre>
define he1_snap_2 notify MelderHE1:on.* define h2 at +*{2}00:00:06 set CamHE1 snap
</pre>

Es wird die ID des letzten Snapshots als Wert der Variable "LastSnapId" in den Readings der Kamera ausgegeben.

=== set <name> [enable] [disable] ===

Um eine Liste von Kameras oder alle Kameras (mit Regex) zum Beispiel um 21:46 zu deaktivieren / zu aktivieren zwei Beispiele mit at:

<pre>
define a13 at 21:46 set CamCP1,CamFL,CamHE1,CamTER disable (enable)
define a14 at 21:46 set Cam.* disable (enable)
</pre>

Etwas komfortabler gelingt das Schalten aller Kameras über einen Dummy.
Zunächst wird der Dummy angelegt:

<pre>
define allcams dummy
attr allcams eventMap on:enable off:disable
attr allcams room Cams
attr allcams webCmd enable:disable
</pre>

Durch Verknüpfung mit zwei angelegten notify, jeweils ein notify für "enable" und "disable", kann man durch Schalten des Dummys auf "enable" bzw. "disable" alle Kameras auf einmal aktivieren bzw. deaktivieren.

<pre>
define all_cams_disable notify allcams:.*off set CamCP1,CamFL,CamHE1,CamTER disable
attr all_cams_disable room Cams

define all_cams_enable notify allcams:on set CamCP1,CamFL,CamHE1,CamTER enable
attr all_cams_enable room Cams
</pre>

 
=== set <name> expmode [day] [night] [auto] ===

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.

 
=== set <name> motdetsc [camera] [SVS] [disable] (geändert ab Rev 11284) ===

Der Befehl "motdetsc" (steht für "motion detection source") 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.
Die erfolgreiche Ausführung der Operation lässt sich u.a. anhand des Status von SVS -> IP-Kamera -> Ereigniserkennung -> Bewegung nachvollziehen.

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

<pre>
set <name> motdetsc SVS [Empfindlichkeit] [Schwellwert] # Befehlsmuster
set <name> motdetsc SVS 91 30 # setzt die Empfindlichkeit auf 91 und den Schwellwert auf 30
set <name> motdetsc SVS 0 40 # behält gesetzten Wert für Empfindlichkeit bei, setzt Schwellwert auf 40
set <name> motdetsc SVS 15 # setzt die Empfindlichkeit auf 15, Schwellwert bleibt unverändert
</pre>

Wird die Bewegungserkennung durch die Kamera genutzt, stehen die Optionen "Empfindlichkeit", "Objektgröße" und "Prozentsatz für Auslösung" zur Verfügung.

<pre>
set <name> motdetsc camera [Empfindlichkeit] [Schwellwert] [Prozentsatz] # Befehlsmuster
set <name> motdetsc camera 89 0 20 # setzt die Empfindlichkeit auf 89, Prozentsatz auf 20
set <name> motdetsc camera 90 40 10 # setzt Empfindlichkeit auf 90, Schwellwert auf 40,
Prozentsatz auf 10
set <name> motdetsc camera 30 # setzt die Empfindlichkeit auf 30, andere Werte bleiben
unverändert
</pre>

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 SVS -> Kamera bearbeiten -> Ereigniserkennung zur Verfügung stehen. Weitere Infos sind der Online-Hilfe zur SVS zu entnehmen.

Über den Befehl "get ... 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.

Beispiel:

<pre>
CamMotDetSc SVS, sensitivity: 76, threshold: 55
</pre>

 

=== set <name> goPreset <Preset> ===

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 "set <name> getinfo" 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 die Presetpositionen sich nur im Fall der Neuanlage bzw. Änderung verändern werden.
 

Hier ein Beispiel einer PTZ-Steuerung in Abhängigkeit eines IR-Melder Events:

<pre>
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
</pre>

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:

<pre>
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
2016.02.04 15:02:30 2: CamFL - Camera Flur_Vorderhaus Recording stopped
2016.02.04 15:02:34 2: CamFL - Snapshot of Camera Flur_Vorderhaus has been done successfully
2016.02.04 15:02:39 2: CamFL - Snapshot of Camera Flur_Vorderhaus has been done successfully
2016.02.04 15:02:44 2: CamFL - Camera Flur_Vorderhaus has moved to position "Home"
</pre>

 
=== set <name> runPatrol <Patrolname> ===

Dieses Kommando startet die vordefinierterte Überwachungstour einer PTZ-Kamera. 
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 Ü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.

 

=== set <name> goAbsPTZ [ X Y | up | down | left | right ] ===

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.
 

Beispiel für Ansteuerung absoluter X/Y-Koordinaten: 

<pre>
set <name> goAbsPTZ 120 450
</pre>

Dieses Beispiel bewegt die Kameralinse in die Position X=120 und Y=450. 
Der Wertebereich ist dabei:

<pre>
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)
</pre>

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. 

Soll die Bewegung mit der maximalen Schrittweite erfolgen, kann zur Vereinfachung der Befehl:

<pre>
set <name> goAbsPTZ up [down ] [left] [right]
</pre>

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.

=== set <name> move [ up | down | left | right | dir_X ] [Sekunden] ===

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 die entsprechenden Zwischenrichtungen. Die möglichen Bewegungsrichtungen bei Kameras mit "CapPTZDirections = 32" sind dementsprechend kleinteliger.

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:

<pre>
set <name> move up 0.5 : bewegt die Linse 0,5 Sekunden (zzgl. Prozesszeit) nach oben (zzgl. Prozesszeit)
set <name> move dir_1 1.5 : bewegt die Linse 1,5 Sekunden (zzgl. Prozesszeit) nach rechts-oben
set <name> move dir_20 0.7 : bewegt die Linse 1,5 Sekunden (zzgl. Prozesszeit) nach links-unten bei "CapPTZDirections = 32"
</pre>

 
=== set <name> runView [ image | lastrec | lastrec_open | link | link_open <room>] ===

Mit "image, link, link_open" Es wird ein Livestream (mjpeg-Stream) der Kamera, entweder als eingebettetes Image oder als generierter Link, gestartet.
Der Zugriff auf die letzte Aufnahme einer Kamera kann über die Zusätze "lastrec" bzw. "lastrec_open" erfolgen.

'''Beispiele:'''

<pre>
attr <name> htmlattr target=_blank width="500" height="375"
attr <name> htmlattr target=_blank width=500,height=375
attr <name> htmlattr width=700,height=525,top=200,left=300
</pre>

Das Verhalten des Livestreams im FHEMWEB kann durch Angaben im Attribut "htmlattr" beeinflusst werden.
Mit diesen Attributwerten öffnet der Link als weiteres Fenster/Browsertab. Wird der Stream als Image gestartet, ändert sich die Größe entsprechend der Angaben von Width und Height.
Das Kommando "set <name> runView link_open" startet den Livestreamlink sofort in einem neuen Browsertab (longpoll=1 muß für WEB gesetzt sein).
Dabei wird für jede aktive FHEM-Session eine Fensteröffnung initiiert. Soll dieses Verhalten geändert werden, kann "set <name> runView link_open <room>"
verwendet werden um das Öffnen des Browserwindows in einem beliebigen, in einer FHEM-Session angezeigten 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 auf die SVS modifiziert werden.

'''Beispiel:'''

<pre>
attr <name> livestreamprefix https://<Servername>:<Port>
</pre>

Der Livestream wird über das Kommando "set <name> stopView" wieder beendet.

 

=== set <name> extevent [ 1-10 ] ===

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

 

== Get ==

Mit SSCam können die Eigenschaften der Kameras aus der Surveillance Station abgefragt werden. Dazu steht der Befehl zur Verfügung:

<pre>
get <name> caminfoall
get <name> eventlist
get <name> svsinfo
get <name> snapfileinfo
</pre>

Mit dem Befehl "get <name> caminfoall" werden abhängig von der Art der Kamera (z.B. Fix- oder PTZ-Kamera) die verfügbaren 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 getrennt wird und kann für weitere Verarbeitungen genutzt werden.
Durch "get <name> eventlist" wird das Reading "CamEventNum" aktualisiert, welches die Gesamtanzahl der registrierten Kameraevents enthält.
Mit "get <name> snapfileinfo" wird der Filename des letzten Schnapschusses ermittelt. Der Befehl wird implizit mit "get <name> snap" ausgeführt.

Der Befehl "get <name> svsinfo" ist eigentlich nicht von der Kamera abhängig, sondern ermittelt vielmehr allgemeine Informationen zur installierten SVS-Version und andere Eigenschaften.
Die Funktionen "caminfoall" und "svsinfo" werden einmalig automatisch beim Start von FHEM ausgeführt um steuerungsrelevante Informationen zu sammeln.
Es ist darauf zu achten dass vorher die Credentials gespeichert wurden !
 
 

'''Polling der Kameraeigenschaften:''' 
Die Abfrage der Kameraeigenschaften erfolgt automatisch, wenn das Attribut "pollcaminfoall" (siehe Attribute) mit einem Wert > 10 gesetzt wird. Per Default ist das Attribut "pollcaminfoall" nicht gesetzt und das automatische Polling nicht aktiv. Der Wert dieses Attributes legt das Intervall der Abfrage in Sekunden fest. Ist das Attribut nicht gesetzt oder < 10 wird kein automatisches Polling gestartet bzw. gestoppt wenn vorher der Wert > 10 gesetzt war.

Das Attribut "pollcaminfoall" wird durch einen Watchdog-Timer überwacht. Änderungen des Attributwertes werden alle 90 Sekunden ausgewertet und entsprechend umgesetzt. Eine Änderung des Pollingstatus / Pollingintervalls wird im FHEM-Logfile protokolliert. Diese Protokollierung kann durch Setzen des Attributes "pollnologging" abgeschaltet werden. Dadurch kann ein unnötiges Anwachsen des Logs vermieden werden. Ab verbose=4 wird allerdings trotz gesetzten "pollnologging"-Attribut ein Log des Pollings zu Analysezwecken aktiviert.

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:

<pre>
PollState = Active - automatisches Polling wird mit Intervall entsprechend <pollcaminfoall> ausgeführt
PollState = Inactive - automatisches Polling wird nicht ausgeführt
</pre>

Die Bedeutung der Readingwerte ist unter Readings beschrieben.

'''Hinweise:'''

Wird Polling eingesetzt, sollte das Intervall nur so kurz wie benötigt eingestellt werden da die ermittelten Werte überwiegend statisch sind.
Das eingestellte Intervall sollte nicht kleiner sein als die Summe aller HTTP-Verarbeitungszeiten. Pro Pollingaufruf und Kamera werden ca. 10 - 20 Http-Calls gegen die Surveillance Station abgesetzt.

Bei einem eingestellten HTTP-Timeout (siehe Attribut) "httptimeout") von 4 Sekunden kann die theoretische Verarbeitungszeit nicht höher als 80 Sekunden betragen.
In dem Beispiel sollte man das Pollingintervall mit einem Sicherheitszuschlag auf nicht weniger 160 Sekunden setzen.
Ein praktikabler Richtwert könnte zwischen 600 - 1800 (s) liegen.

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.

 

== Readings ==

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

<pre>
* Availability - Verfügbarkeit der Kamera (disabled, enabled, disconnected, other)
* CamEventNum - liefert die Gesamtanzahl der in SVS registrierten Events der Kamera
* CamExposureControl - zeigt den aktuell eingestellten Typ der Belichtungssteuerung
* CamExposureMode - aktueller Belichtungsmodus (Day, Night, Auto, Schedule, Unknown)
* CamIP - IP-Adresse der Kamera
* CamLiveMode - Quelle für Live-Ansicht (DS, Camera)
* CamModel - Kameramodell
* CamPort - IP-Port der Kamera
* CamPreRecTime - Dauer der der Voraufzeichnung in Sekunden (Einstellung in SVS)
* CamRecShare - gemeinsamer Ordner auf der DS für Aufnahmen
* CamRecVolume - Volume auf der DS für Aufnahmen
* CamVendor - Kamerahersteller Bezeichnung
* CamVideoFlip - Ist das Video gedreht </td></tr>
* CamVideoMirror - Ist das Video gespiegelt </td></tr>
* CapAudioOut - Fähigkeit der Kamera zur Audioausgabe über Surveillance Station (false/true)
* CapChangeSpeed - Fähigkeit der Kamera verschiedene Bewegungsgeschwindigkeiten auszuführen
* CapPTZAbs - Fähigkeit der Kamera für absolute PTZ-Aktionen
* CapPTZAutoFocus - Fähigkeit der Kamera für Autofokus Aktionen
* CapPTZDirections - die verfügbaren PTZ-Richtungen der Kamera
* CapPTZFocus - Art der Kameraunterstützung für Fokussierung
* CapPTZHome - Unterstützung der Kamera für Home-Position
* CapPTZIris - Unterstützung der Kamera für Iris-Aktion
* CapPTZPan - Unterstützung der Kamera für Pan-Aktion
* CapPTZTilt - Unterstützung der Kamera für Tilt-Aktion
* CapPTZZoom - Unterstützung der Kamera für Zoom-Aktion
* DeviceType - Kameratyp (Camera, Video_Server, PTZ, Fisheye)
* Error - Meldungstext des letzten Fehlers
* Errorcode - Fehlercode des letzten Fehlers
* LastSnapFilename - der Filename des letzten Schnapschusses
* LastSnapId - die ID des letzten Schnapschusses
* LastUpdateTime - Datum / Zeit der letzten Aktualisierung durch "caminfoall"
* LiveStreamUrl - die LiveStream-Url wenn der Stream gestartet ist
* Patrols - in Surveillance Station voreingestellte Überwachungstouren (bei PTZ-Kameras)
* PollState - zeigt den Status des automatischen Pollings an
* Presets - in Surveillance Station voreingestellte Positionen (bei PTZ-Kameras)
* Record - Aufnahme läuft = Start, keine Aufnahme = Stop
* SVScustomPortHttp - benutzerdefinierter Port der Surveillance Station (HTTP) im DSM-Anwendungsportal (get mit "svsinfo")
* SVScustomPortHttps - benutzerdefinierter Port der Surveillance Station (HTTPS) im DSM-Anwendungsportal (get mit "svsinfo")
* SVSlicenseNumber - die Anzahl der installierten Kameralizenzen (get mit "svsinfo")
* SVSuserPriv - die effektiven Rechte des verwendeten Users nach dem Login (get mit "svsinfo")
* SVSversion - die Paketversion der installierten Surveillance Station (get mit "svsinfo")
* UsedSpaceMB - durch Aufnahmen der Kamera belegter Plattenplatz auf dem Volume
</pre>

 

== Attribute ==

* '''debugactivetoken''' - wenn gesetzt wird der Status des Active-Tokens gelogged - nur für Debuggung, nicht im normalen Betrieb benutzen

* '''httptimeout''' - Timeout-Wert für HTTP-Aufrufe zur Synology Surveillance Station, Default: 4 Sekunden (wenn httptimeout = "0" oder nicht gesetzt)

* '''htmlattr''' - ergänzende Angaben zur Livestream-Url um das Verhalten wie Bildgröße zu beeinflussen

* '''livestreamprefix''' - überschreibt die Angaben zu Protokoll, Servernamen und Port zur Weiterverwendung der Livestreamadresse als z.B. externer Link

* '''pollcaminfoall''' - Intervall der automatischen Eigenschaftsabfrage (Polling) einer Kamera (kleiner 10: kein Polling, größer 10: Polling mit Intervall)

* '''pollnologging''' - 0 bzw. nicht gesetzt = Logging Gerätepolling aktiv (default), 1 = Logging Gerätepolling inaktiv

* '''rectime''' - festgelegte Aufnahmezeit wenn eine Aufnahme gestartet wird. Mit rectime = 0 wird eine Endlosaufnahme gestartet. Ist "rectime" nicht gesetzt, wird der Defaultwert von 15s verwendet.

* '''session''' - Auswahl der Login-Session. Nicht gesetzt oder "DSM" -> session wird mit DSM aufgebaut (Standard). "SurveillanceStation" -> Session-Aufbau erfolgt mit SVS

* '''verbose'''
<pre>
Es werden verschiedene Verbose-Level unterstützt.
Dies sind im Einzelnen:

0 - Start/Stop-Ereignisse werden geloggt
1 - Fehlermeldungen werden geloggt
2 - Meldungen über wichtige Ereignisse oder Alarme
3 - gesendete Kommandos werden geloggt
4 - gesendete und empfangene Daten werden geloggt
5 - alle Ausgaben zur Fehleranalyse werden geloggt. ACHTUNG: unter Umständen werden sehr viele Daten in das Logfile geschrieben!
</pre>

weitere Attribute:

* [http://fhem.de/commandref_DE.html#readingFnAttributes readingFnAttributes]

 
== Das Modul bzw. eine Gerätedefinition deaktivieren (ab Rev 11296) ==

Mit dem Attribut "disable" kann das Modul bzw. eine Gerätedefinition deaktiviert werden. Im Gegensatz zum Befehl "set ... disable" wird nicht die Kamera an sich deaktiviert, sondern lediglich das Gerätemodul. In diesem Fall werden keine Funktionen mehr ausgeführt.
Wird das Modul deaktiviert, werden die folgenden Readings gesetzt:

<pre>
state: inactive
Availability: ???
PollState: Inactive
</pre>

Ist für eine Kamera Polling aktiviert, wird diese Aktivität abgeschaltet. Nach Reaktivierung des Gerätemoduls wird das Polling automatisch wieder fortgesetzt.

 

== Lösungsbeispiele und Ansätze für verschiedene Aufgabenstellungen ==

=== Eine Übersicht mit Hilfe von readingsGroup ===

Mit den umfangreichen Möglichkeiten des Moduls [[readingsGroup]] kann ein FHEM-Widget nach eigenen Vorstellungen erstellt werden. Hierbei ist es möglich sowohl einen Überblick über die Status der Kameras zu erhalten als auch Steuerungsaktivitäten vorzusehen. Das nachfolgende Beipiel soll als Anregung dafür dienen. Weitere Informationen unter der [http://fhem.de/commandref.html#readingsGroup commandref] zu readingsGroup.

'''Hinweis:'''
Die folgenden Beispiele enthalten keine Maskierungen oder Verdopplungen für ; und Zeilenende, sondern sind so angegeben, wie sie im Web Interface im Befehls-Eingabefeld, nach Klick auf DEF und im Attribut-Eingabefeld eingegeben werden. Mehrere Leerzeichen innerhalb von < > sind als <code><&nbsp;&nbsp;&nbsp;></code> zu kodieren.

{| class="wikitable"
! Definition !! Erläuterungen
|-
| colspan=2 | [[Bild:RgSSCam.jpg|thumb|500px|links|Kamerastatus und Steuerung]]
|-
| style="width:50%" |<code>define Cams_All_States readingsGroup <%it_camera>,<Verfügbar>,< >,<Status>,< >,<Erkennung>,< >,<letzte Aufnahme>,< >,<bel. Platz (MB)>,< >,<letzte Aktualisierung>,< >,<Modul Deaktivierung>,< >,<Image> TYPE=SSCam:Availability,
<&nbsp;&nbsp;&nbsp;>,state,<&nbsp;&nbsp;&nbsp;>,CamMotDetSc,<&nbsp;&nbsp;&nbsp;>,CamLastRecTime,<&nbsp;&nbsp;&nbsp;>,UsedSpaceMB,
<&nbsp;&nbsp;&nbsp;>,LastUpdateTime,<&nbsp;&nbsp;&nbsp;>,?!disable,<&nbsp;&nbsp;&nbsp;>,<%Start>,<%Stop></code>
| ReadingsGoup anlegen.
|-
| <code>attr Cams_All_States valueIcon {'Availability.enabled' => 'remotecontrol/black_btn_GREEN',
'Availability.disabled' => 'remotecontrol/black_btn_RED',
'state.inactive' => 'StandBy',
'state' => '%devStateIcon'}</code>
| In Abhängigkeit vom Wert der Kameraverfügbarkeit und des state-Readings entsprechende Icons anzeigen. Wird das Modul deaktiviert, wird ein Standby-Icon angezeigt unabhängig davon ob in der Kameradefinition ein devStateIcon hinterlegt wurde.
|-
| <code>attr Cams_All_States valueStyle {if($READING eq "Availability" && $VALUE eq "enabled"){ ' style="color:green" ' }
elsif( $READING eq "Availability" && $VALUE eq "disabled"){ ' style="color:red" ' }
elsif( $READING eq "CamMotDetSc" && $VALUE =~ /SVS.*/ ){ ' style="color:orange" ' }
elsif( $READING eq "CamMotDetSc" && $VALUE eq "disabled"){ ' style="color:LimeGreen" ' }
elsif( $READING eq "CamMotDetSc" && $VALUE =~ /Cam.*/ ){ ' style="color:SandyBrown" ' }}</code>
| Farbgestaltung der Texte in Anhängigkeit der Werte setzen.
|-
| <code>attr Cams_All_States valueFormat {($READING eq "CamMotDetSc" && $VALUE eq "disabled") ? "external" : $VALUE}</code>
| Wenn die Quelle der Bewegungserkennung auf "disabled" gestellt wurde, soll "external" in der Übersicht angezeigt werden weil die Bewegungserkennung in dem Fall durch IR-Melder durchgeführt wird.
|-
| <code>attr Cams_All_States valueColumns { 'Image' => 'colspan="2"'}</code>
| Die Überschrift "Image" soll sich über die letzten zwei Spalten strecken. Es gilt sowohl für "Start" und "Stop" .
|-
| <code>attr Cams_All_States nameStyle style="color:black;font-weight:bold"</code>
| Die Überschriften sollen schwarz und fett sein.
|-
| <code>attr Cams_All_States commands { 'Availability.enabled' => 'set $DEVICE disable',
'Availability.disabled' => 'set $DEVICE enable',
'Cams_All_States.Start' => 'set %DEVICE runView image',
'Cams_All_States.Stop' => 'set %DEVICE stopView',
disable => "disable:"}</code>
| Es sollen Kommandos bestimmten Readings / Werten unterlegt werden. Zum Beispiel kann die Kamera mit Klick auf das Availability-Icon disabled werden wenn der Readingswert "enabled" ist. Der Livestream kann mit "Start" in der letzten Spalte gestartet, oder das Modul über eine Auswahl in der Drop-Down-Liste unterhalb von "Modul Deaktivierung" deaktiviert/aktiviert werden.
|-
| <code>attr Cams_All_States cellStyle { "c:0" => 'style="text-align:left;color:green;font-weight:normal"',
"c:5" => 'style="text-align:center;color:green;font-weight:normal"',
"c:9" => 'style="text-align:center;font-weight:normal"'}</code>
| Formatierung bestimmter Spalten (0,5,9).
|-
| <code>attr Cams_All_States alias Status aller Kameras</code>
| Alias setzen.
|-
| <code>attr Cams_All_States group Kamerastatus</code>
| Gruppenzugehörigkeit setzen. Wird auch für die Anzeige im Dashboard benutzt.
|}

 

=== Mail mit Snapshot im Anhang und Aufnahmelink versenden (sendmail) ===

Nachfolgendes Beispiel zeigt eine Möglichkeit in Linux mit sendmail eine Mail mit einem Link zu einer Kameraaufnahme und bis zu drei Anhängen zu versenden.
Die Mail wird mit einem DOIF Kommando in Abhängigkeit von einer angefertigten Aufnahme angestoßen.

Zunächst die Mailfunktion in der 99_myUtils als Unterroutinen einfügen. Die Funktion ist nicht blockierend (mit Modul Blocking.pm) ausgeführt. Die "\" dienen nachfolgend nur
zur Kennzeichnung eines Zeilenumbruchs - den Code bitte auf eine Zeile schreiben.

<source lang=perl>
# Am Anfang von 99_myUtils hinzufügen
use Blocking;

##############################################################################
######## DebianMail Mail versenden nonblocking ############
##############################################################################

sub DebianMailnbl {

my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $attach = shift;
my $attach1 = shift;
my $attach2 = shift;
my $hash->{NAME_MAIL} = "Debianmail";
my $name = $hash->{NAME_MAIL};

if ($attach2) {
$hash->{helper}{RUNNING_PID} = BlockingCall("DebianMailnbl_send", $name."|".$rcpt."|".$subject."|".$text."|".$attach." \
|".$attach1."|".$attach2, "", "", "", "");
} elsif ($attach1) {
$hash->{helper}{RUNNING_PID} = BlockingCall("DebianMailnbl_send", $name."|".$rcpt."|".$subject."|".$text."|".$attach."|" \
.$attach1, "", "", "", "");
} else {
$hash->{helper}{RUNNING_PID} = BlockingCall("DebianMailnbl_send", $name."|".$rcpt."|".$subject."|".$text."|".$attach,
"", "", "", "");
}

}

######################################################
######## Mailfunktion nonblocking
######################################################

sub DebianMailnbl_send {
my ($string) = @_;
my ($name, $rcpt, $subject, $text, $attach, $attach1, $attach2) = split("\\|", $string);
my $ret = "";
my $sender = "<Sendername>\@<Domäne>";
my $konto = "<Mailkonto";
my $passwrd = "<Mailkontopasswort>";
my $provider = "<Mailserver>";

if ($attach2) {
$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -a '$attach' -a '$attach1' -a '$attach2' -s '$provider' \
-xu '$konto' -xp '$passwrd' -o tls=no -o message -charset=utf-8 -o message-content-type=text/plain );
} elsif ($attach1) {
$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -a '$attach' -a '$attach1' -s '$provider' -xu '$konto' \
-xp '$passwrd' -o tls=no -o message-charset=utf-8 -o message-content-type=text/plain );
} else {
$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -a '$attach' -s '$provider' -xu '$konto' -xp '$passwrd' \
-o tls=no -o message-charset=utf-8 -o message-content-type=text/plain );
}

# remove CR from return-string
$ret =~ s,[\r\n]*,,g;

Log3 $name, 3, "$name - sendEmail returned: $ret";
}
</source>

Um die TLS Verschlüsselung (ehem. SSL) zu nutzen, dann tls=auto verwenden.

Falls der Body-Text in einem (Android-)Mailer auf dem Handy nicht gezeigt wird, kann evtl. der Parameter '''-o message-content-type=html''' helfen.

 
==== Versand triggern - Beispiel mit DOIF ====
Der Mailversand wird in dem Beispiel mit einem DOIF angetriggert:

<pre>
define CamHE1.email DOIF ([CamHE1:"CamLastRec"]) ({DebianMailnbl ('<Empfänger>@<Domäne>','Bewegungsalarm CamHE1','Eine Bewegung wurde an der Haustür registriert.
Aufnahmelink: [CamHE1:VideoFolder]/[CamHE1:CamLastRec]','/media/sf_surveillance/@Snapshot/[CamHE1:LastSnapFilename]')})
</pre>

Wird eine Aufnahme der Kamera CamHE1 beendet, wird integriert der Befehl "get .. eventlist" ausgeführt. Dadurch aktualisiert sich das Reading "CamLastRec".
Dieser Event wird genutzt um eine Mail mit einem Link zur Aufnahme und einem während der Aufnahme angelegten Schnappschuß zu versenden.
Will man einen weiteren Anhang versenden, sähe das DOIF folgendermaßen aus:

<pre>
define CamHE1.email DOIF ([CamHE1:"CamLastRec"]) ({DebianMailnbl ('<Empfänger>@<Domäne>','Bewegungsalarm CamHE1','Eine Bewegung wurde an der Haustür registriert.
Aufnahmelink: [CamHE1:VideoFolder]/[CamHE1:CamLastRec]','/media/sf_surveillance/@Snapshot/[CamHE1:LastSnapFilename]','<weiteres File>')})
</pre>

Dss Reading "VideoFolder" muß, wie in dem Beispiel zu sehen, dem "CamLastRec" vorangestellt werden um den kompletten Pfad zur Aufnahme zu erhalten. Der versendete Link würde somit etwa den folgenden Aufbau haben:

<pre>
/volume1/surveillance/Carport/20160407PM/Carport20160407-221541-1460060141.mp4
</pre>

Wenn in einer Mail nach extern versendet wird, ist ein solcher Link wahrscheinlich über eine Anwendung nicht zugreifbar.
Um den Link dynamisch anzupassen und so den Zugriff von extern über z.B. einen Webserver zu ermöglichen, kann das Attribut "videofolderMap" verwendet werden.

Wird dieses Attribut auf zum Beispiel ...<pre>"http://<Server>:8083/fhem/svs/Carport/"</pre> ...gesetzt, ergibt sich folgender Link der in der Mail versendet wird:

<pre>
http://<Server>:8083/fhem/svs/Carport/20160407PM/Carport20160407-221541-1460060141.mp4
</pre>

In dem obigen Beispiel wird ein FHEM-Webserver verwendet, der zuvor über HTTPSRV (siehe Commandref) angelegt wurde,
WIe der Webserver angelegt werden kann ist [[SSCAM_-_Steuerung_von_Kameras_in_Synology_Surveillance_Station#Einsatz_FHEM_Webserver_zum_Zugriff_auf_Aufnahmen | hier]] beschrieben.

 
==== Versand triggern - Beispiel mit Notify ====

Mit diesem Notify wird das Snapshotfile angehängt und auch ein Link zu dem Snapshot mit eingefügt.

<pre>
define CamHE1.email NOTIFY CamHE1:LastSnapFilename.* {DebianMailnbl ('Heiko.Maaz@sds1.myds.me','Bewegungsalarm CamHE1',
'Eine Bewegung wurde an der Haustür registriert. Aufnahmelink: http://fhem.myds.me:8083/fhem/snap/'.(ReadingsVal("CamHE1","LastSnapFilename","")),
'/media/sf_surveillance/@Snapshot/'.(ReadingsVal("CamHE1","LastSnapFilename","")))}
</pre>

Um den Link in dieser Form aufrufen zu können ist erst ein HTTPSRV anzulegen mit:

<pre>
define snapweb HTTPSRV snap /media/sf_surveillance/@Snapshot SVS-Snapshots
</pre>

Natürlich muß dabei der Pfad "/media/sf_surveillance/" so angepasst werden dass er dem (gemounteten) SVS-Aufnahmeverzeichnis entspricht.

 

=== Einsatz FHEM Webserver zum Zugriff auf Aufnahmen ===

Ziel der nachfolgenden Beschreibung ist es, eine Möglichkeit darzustellen, um den FHEM Webserver für den Zugriff auf die Aufnahmen der Synology Surveillance Station zu nutzen.

Folgende Ausgangslage wird für das Beispiel als gegeben angenommen:

* der gemeinsame Ordner der Surveillance Station (normalerweise "surveillance") in der Diskstation ist am FHEM-Server gemountet. Für das Beipiel ist das gemountete Verzeichnis: /media/sf_surveillance
* FHEMWEB ist im Einsatz
* für das Beispiel ist eine Kamera CamHE1 (SVS-Name: Hauseingang) definiert

HTTPSRV ist ein Plug-in für FHEMWEB und stellt den Webserver für den Zugriff zur Verfügung. Diese Möglichkeit ist sicherlich für jene Fälle interessant bei denen der Zugriff über einen Verzeichnisdienst nicht möglich oder nicht gewünscht ist (zum Bespiel von extern).
Es steht auch eine Modul-interne Zugriffsmöglichkeit auf die letzte Aufnahme mit dem Befehl "set CamHE1 runView lastrec (oder lastrec_open)" zur Verfügung.

Der Webserver wird definiert mit:

define svsweb HTTPSRV svs /media/sf_surveillance WebServer SVS-Aufnahmen

Der definierte Webserver sollte nun links im Seitenmenü unter dem Namen "WebServer SVS-Aufnahmen" erscheinen. Ein Klick auf diesen Link sollte nun die Meldung zeigen:

File not found: /media/sf_surveillance/index.html

Die Datei index.html existiert natürlich normalerweise nicht im surveillance-Verzeichnis. Der Inhalt des Verzeichnisses "/media/sf_surveillance", also des surveillance-Stammordners, wird nun mit der Basisadresse ... <pre>http://<FHEM-Server>:8083/fhem/svs/</pre> ...erreicht.

Alle Aufnahmen der Kameras werden in Unterordnern des surveillance-Stammerzeichnisses gespeichert, die den gleichen Namen wie die Kamera in der Surveillance Station haben. Um den Pfad zu dem Aufnahmefile zu spezifizieren, ist die Basisadresse des erstellten Webservers mit dem Unterordner der entsprechenden Kamera zu ergänzen. Mit diesem zusammengesetzten Gesamtpfad ist ebenfalls das Reading "VideoFolder", welches den physikalischen Pfad von Aufnahmen der entsprechenden Kamera beschreibt, zu überschreiben.

Die wird mit dem Attribut "videofolderMap" erreicht. In dem Beispiel wird es gesetzt auf:

<pre>
attr CamHE1 videofolderMap http://<FHEM-Server>:8083/fhem/svs/Hauseingang/
</pre>

Jede Aufnahme der Kamera "Hauseingang" bzw. "CamHE1" wird somit durch die Webadresse ...

<pre>
http://<FHEM-Server>:8083/fhem/svs/Hauseingang/<Inhalt Reading CamLastRec>
</pre>

... erreicht.

Wie eine Mail mit diesem Link versendet werden kann ist [[SSCAM_-_Steuerung_von_Kameras_in_Synology_Surveillance_Station#Mail_mit_Snapshot_im_Anhang_und_Aufnahmelink_versenden_.28sendmail.29 | hier]] beschrieben.

Der komplette in der Mail versendete Aufnahmelink sieht folgendermaßen aus:
<pre>
http://<FHEM-Server>:8083/fhem/svs/Hauseingang//20160408PM/Hauseingang20160408-215150-1460145110.mp4
</pre>

 

=== Workaround bei DSM 2-Stufen Verifizierung ===
1. Benutzer in der SVS einrichten, zum Manager machen 
2. Benutzer wird automatisch auch in FHEM eingerichtet, dort zum Admin machen 
3. 2-Stufen Verifizierung ausschalten 
4. Modul / Kamera zum Laufen bringen 
5. Session im Modul auf SVS stellen 
6. Benutzer in der DSM aus der Admin-Gruppe rausnehmen 
7. 2-Stufen Verifizierung einschalten (Option nur für Admins)

Icons

2015-11-26T19:13:32Z

Docb: eine Zeile eingefügt bei den Tipps (Wenn die Grafik nicht angezeigt wird sondern nur Text: In einem Editor den Inhalt mit einer funktionierenden SVG-Datei vergleichen und anpassen.)

Icons - alles rund um die Icons in Fhem
= Fhem mit Icons verschönern =
== Geräten Icons zuweisen ==
Im FHEMWEB auf Detail-Ansicht des Gerätes gehen, danach in der attr Zeile per dropdown
# Icon auswählen, um das Icon zu wählen, das standardmäßig links vom Gerät gezeigt wird; alternativ ganz unten auf '''Select Icon''' klicken, dann bekommt ihr alle Bilder angezeigt
# '''devStateIcon auswählen''', um unterschiedliche Schaltzustände mit unterschiedlichen Icons zu versehen; alternativ ganz unten auf '''Extend devStateIcon''' klicken, dann bekommt ihr alle Bilder angezeigt und könnt sie dem jeweiligen Schaltzustand zuordnen.

Dabei gilt folgendes:
* Icon-Dateiname OHNE Dateiendung eingeben
* wenn es sich bei dem Icon um eine svg-Datei handelt, kann mit @farbe die Farbe beeinflusst werden, z.B. <code>attr Geraet devStateIcon an:general_an@green aus:general_aus@red</code>, wobei hier die beiden Dateien general_an.svg und general_aus.svg heißen.
* statt des Standardfarbnamens, kann übrigens auch der 6-stellige Hex-Code übergeben werden (ohne # am Anfang). Den Code könnt ihr z.B. hier bei [http://www.colorpicker.com Colorpicker] generieren
* Möchte man dass bei Klick auf das Icon auch eine Aktion ausgelöst wird, kann man dies als dritten Parameter mit angeben. Beispiel für einen Wechsel zwischen "arround" und "away": <code>arround:status_available:away away:status_away_2:arround</code>.

Wenn ihr die Änderungen wie oben beschrieben durchführt, könnt ihr das Ergebnis gleich betrachten. Wenn alles passt, dann noch '''Save config''' drücken, dann wird alles fest abgespeichert.

== Größe der Icons verändern ==
Auch das kein Problem. Öffnet einfach die für Eurer Template (wie sieht fhem bei Euch aus: rechts unten -> Select Style -> das was ihr dort gewählt habt ist Euer Template) zuständige css-Datei. Diese findet ihr im fhem-Verzeichnis unter www/pgm2. Dort fügt ihr einfach folgende Zeile ein und ändert ggf. die Größenangaben.
<pre>svg { height:32px; width:32px; }</pre>

== Mehr Icons zur Auswahl ==
Grundsätzlich sind bei aktuellen fhem-Installationen die meisten Icons standardmäßig aktiviert. Navigiert doch einfach mal im fhem Verzeichnis in den www Ordner und dort in images. Die Ordner default, openautomation und fhemSVG sind standardmäßig aktiviert, d.h., Icons aus diesen Ordnern werden in fhem angezeigt. Wenn ihr zusätzlich die Icons auch aus den anderen Ordnern (z.B. icons_small) verwenden wollt, dann ergänzt einfach die entsprechende Zeile "WEB iconPath" in der fhem.cfg:
<pre>attr WEB iconPath fhemSVG:openautomation:default:icons_small</pre>

Das gleiche gilt, wenn ihr eine ältere fhem-Installation habt und noch nicht die Bilder z.B. aus fhemSVG angezeigt bekommt.

== Weitere Tipps ==
Weitere Tipps zu Icons finden sich auch auf der Seite [[Slider für HM-Rolladensteuerung anzeigen]].

= Eigene Icons erstellen =
Falls ihr eigene Icons basteln wollt - sehr gerne. Umso besser, wenn ihr diese dann mit uns teilt. Der passende [http://forum.fhem.de/index.php/topic,12605.0.html Thread im Forum].

== SVG-Icons ==
Hier einige Tipps zum Erstellen von SVG-Icons. SVGs bieten einige Vorteile:
* SVGs sind vektorbasiert und somit frei skalierbar
* SVGs sind, wenn man sie genauer betrachtet, gut lesbarer und veränderbarer Quellcode und können deswegen leicht über css manipuliert werden

Wie geht es nun:
* [http://inkscape.org/download/?lang=de Inkscape] besorgen (Open Source)
* Loszeichnen

Jetzt wird es wichtig - fhem ist etwas sensibel, was svgs anbelangt und will diese zudem farblich umgestalten. Daher folgendes unbedingt beachten:

* fhem ersetzt bei allen fill:#000000 und fill="#000000" die sechs Nullen mit einem Farbcode, wenn dieser mit übergeben wurde (sh. Fhem mit Icons verschönern weiter oben) - das solltet ihr beim zeichnen beachten
* daher arbeite ich immer so, dass ich beispielsweise Rechtecke/Kreise zeichne und diese dann mit "Kontur in Pfad umwandeln" umwandle -> dann ist das Rechteck transparent, die Linie schwarz (und wird von fhem erstetzt) und alles klappt
* alle Texte müssen in Pfade umgewandelt werden
* das gesamte Bild muss als "Normales SVG" gespeichert werden (Standardeinstellung bei Inkscape ist "Inkscape SVG")
* Wenn die Grafik nicht angezeigt wird sondern nur Text: In einem Editor den Inhalt mit einer funktionierenden SVG-Datei vergleichen und anpassen.
* letzter wichtiger Tipp: Eine Zeile darf im SVG nicht fehlen, sonst zeigt fhem es nicht an. Wenn ihr Euer SVG in einem Texteditor öffnet (ich empfehle notepad++), schaut in in der <svg>-Definition, ob die Zeile mit viewBox dabei ist. Wenn nicht, dann nach unterem Format ergänzen.

<pre>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<svg
version="1.0"
width="585"
height="585"
viewBox="0 0 585 585"
id="svg2421"
sodipodi:docname="usb-stick.svg">
</pre>

== SVG-Icons für das Modul remotecontrol: Schriftvorlage ==
Wer beispielsweise für das Modul remotecontrol noch andere Beschriftungen braucht, der kann sich diese ganz fix selbst machen. Im Ordner fhem\www\images\fhemSVG findet ihr die Datei rc_templatebutton.svg. Mit der macht ihr folgendes:
Ganz einfach inkscape runterladen (http://inkscape.org/download/?lang=de), Datei öffnen, auf Text klicken, dann oben in der Leiste auf Text -> Schrift und Text -> Reiter Text, Text ändern. Ggf. Größe/Position anpassen, dann Pfad -> Objekt in Pfad umwandeln, dann Datei -> Speichern unter -> euer name und "Normales SVG" => FERTIG

[[Kategorie:HOWTOS]]

Backup

2014-12-14T21:51:41Z

Docb: Ergänzt um Anzeige der vorhandenen Backups im dummy

{{SEITENTITEL:backup}}
{{Infobox Modul
|ModPurpose=Datensicherung der Fhem-Installation
|ModType=c
|ModCmdRef=backup
|ModForumArea=Sonstiges
|ModTechName=98_backup.pm
|ModOwner=rudolfkoenig ([http://forum.fhem.de/index.php?action=profile;u=8 Forum] / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}
{{Randnotiz|RNTyp=Warn|RNText=Die Datensicherung kann je nach verwendeter Server Hardware recht lange dauern.}}
Für Datensicherungszwecke ist in Fhem der Befehl '''backup''' integriert.

Im Auslieferungszustand von fhem werden die erstellten Backups im Ordner <code>/var/opt/fhem/Backup</code> abgelegt. Die Datensicherung umfasst das komplette Fhem-Verzeichnis. Damit sind alle angepassten und selbst erstellten Dateien und Icons enthalten. Das Backup wird als .tar.gz Datei abgelegt und trägt dabei im Namen das Datum und die Uhrzeit, an dem das Backup ausgeführt wurde.

Weitere Details zu dem Befehl ''backup'' können der [http://fhem.de/commandref.html#backup commandref] entnommen werden.

== Backup manuell ausführen (Eingabefeld) ==
Um ein Backup zu erstellen genügt es, in der fhem [[PGM2|Benutzeroberfläche]] im Eingabefeld den Befehl ''backup'' zu schreiben und mit return auszuführen (nicht den Save-Button betätigen, das würde nämlich kein Backup erstellen).

Danach findet sich eine Backupdatei in dem oben genannten Verzeichnis. In der Fhem Logdatei sollte ein Eintrag
:<code>backup done: FHEM-<Datum>_<Build>.tar.gz (<Größe> Bytes)</code>
zu finden sein.

== Backup manuell ausführen (Weboberfläche) ==
Der Backup-Befehl kann in die Weboberfläche als manuell ausführbare Aktion eingebunden. Das lässt sich mit dem folgenden Code in der fhem.cfg erreichen:

#########################################################################
## Funktion......: FHEM Backup
## Besonderheiten: Manuelles Backup
#########################################################################
define SYS_Backup dummy
attr SYS_Backup alias FHEM Backup ausführen
attr SYS_Backup room Server
attr SYS_Backup webCmd Ausführen
define SYS_BackupRun notify SYS_Backup:* backup
attr SYS_BackupRun room Server
#########################################################################

Alternativ kann man das notify noch etwas weiter aufbohren, dann wird in der dummy-Variable angezeigt, welche Backups bereits gemacht wurden. Nicht vergessen, den Pfad einzutragen!
#########################################################################
## Funktion......: FHEM Backup
## Besonderheiten: Anzeige der vorhandenen Backups im dummy
#########################################################################
SYS_Backup:* {
fhem("backup");;
opendir DIR, "Hier_den_Pfad_zu_Eurem_Backupverzeichnis" or die $!;;
my $mybackups = "";;
while(my $file = readdir DIR){
next if($file eq "." || $file eq "..");;
$mybackups = $mybackups."$file ";;
}
closedir DIR;;
fhem("set SYS_Backup ".$mybackups);;
}
#########################################################################

== Backup automatisch ausführen ==
Die regelmäßige automatische Erstellung einer Datensicherung lässt sich mit folgenden Einträgen in der fhem.cfg erreichen:

#########################################################################
## Funktion......: FHEM Backup
## Besonderheiten: Autom. Backup
#########################################################################
define NTFY_BackupRun at *23:59:00 set SYS_Backup Ausführen
attr NTFY_BackupRun room Server
#########################################################################

Damit wird täglich um 23:59 ein Backup erstellt.

== Backup vor Update ==
Ist in der fhem.cfg der Eintrag
:<code>attr global backup_before_update 1</code>
enthalten, wird vor der Durchführung eines Update erst eine Datensicherung in das festgelegte Backup Verzeichnis durchgeführt.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

Synology Diskstation

2014-12-13T21:38:42Z

Docb: Bereich Net::Telnet ergänzt

== Fhem Installation auf der Synology Diskstation (ab DSM 5)==

Fhem auf einer Synology Diskstation (DS) zu installieren ist grundsätzlich nicht schwierig. Wichtig ist zunächst eine aktuelle DSM - also Systemupdates auf der DS installieren).
Zunächst installiert ihr Euch über das Paket-Zentrum der DS das Programm "Perl". Dann besorgt ihr Euch von Martin Fischer ein kompiliertes Fhem 5.3 - dort gibt es zwei Versionen:
Wenn Eure DS einen Marvell 6281 oder 9282 Prozessor hat, nehmt die fhem-5.3-mfr-1.1-syno-88f628x.spk (http://www.fischer-net.de/hausautomation/downloads/file/23-fhem-5-3-mfr-1-1-syno-88f628x-spk.html) ansonsten die fhem-5.3-mfr-1.1-syno-noarch.spk (http://www.fischer-net.de/hausautomation/downloads/file/24-fhem-5-3-mfr-1-1-syno-noarch-spk.html).

Dann wieder den Paket-Zentrum der DS aufrufen und "Manuelle Installation" -> entsprechende Datei auswählen -> weiter. Wenn es Mecker gibt wegen Signierung o.ä., dann Paket-Zentrum -> Einstellungen -> Vertrauensebene auf "Jeder Herausgeber".
Danach ist Fhem installiert und ihr könnt es über das Paket-Zentrum starten. Dann einfach Fhem aufrufen und als erstes mal ein Update durchführen. Viel Spaß mit Fhem!
Allerdings müsst ihr, um einen CUL damit zu betreiben oder HUEs anzusteuern noch etwas mehr tun.

Hier noch Links zu Wiki-Einträgen für ältere DSM-Versionen / Modelle:

http://www.fhemwiki.de/wiki/Synology_409:_Update_auf_4.0

http://www.fhemwiki.de/wiki/FHEM_auf_dem_Synology_DS408

== CUL zum laufen bringen | IPKG installieren ==
A.) Zunächst braucht ihr die USB-Treiber: http://forum.synology.com/enu/viewtopic.php?f=155&t=82843&hilit=usbserial - diese einfach über das Paket-Zentrum installieren.

B.) Dann braucht ihr das IPKG, damit ihr verschiedene Programme nachladen könnt, die ihr für den Betrieb des CUL benötigt:
1. Prozessor (CPU) Architektur heraussuchen - http://forum.synology.com/wiki/index.php/What_kind_of_CPU_does_my_NAS_have
2. Der Prozessor (CPU) Architektur entsprechendes Shell-Script herunterladen und in einem beliebigen Ordner auf der DiskStation speichern - http://forum.synology.com/wiki/index.php/Overview_on_modifying_the_Synology_Server,_bootstrap,_ipkg_etc#Bootstrap
Wenn ihr einen Marvel Armada XP Prozessor habt (z.B. DS 214+), dann schaut hier: https://gist.github.com/marlun78/9349792
3. Dieses How-to durch arbeiten - http://forum.synology.com/wiki/index.php/How_to_Install_Bootstrap (für die Armada XP nicht - da steht alles im o.g. Link)
4. DiskStation neustarten

C) Jetzt braucht ihr die SerialPort Modul
Das kann funktionieren mit:

<code>"ipkg install gcc"

"/usr/local/perl/bin/perl -MCPAN -e shell") / je nachdem wo Eure perl Installation liegt - bei mir war es "/usr/bin/perl -MCPAN -e shell"

"cpan install Device::SerialPort"</code>

Hat es bei mir nicht - ich habe es so geschafft:

<code>"ipkg install perl-device-serialport"

"cp /opt/lib/perl5/site_perl/5.10.0/arm-linux/Device/SerialPort.pm /volume1/@appstore/Perl/lib/perl5/site_perl/Device"

"cp /opt/lib/perl5/site_perl/5.10.0/arm-linux/auto/Device/SerialPort/SerialPort.bs /volume1/@appstore/Perl/lib/perl5/site_perl/auto/Device/SerialPort"

"cp /opt/lib/perl5/site_perl/5.10.0/arm-linux/auto/Device/SerialPort/SerialPort.so /volume1/@appstore/Perl/lib/perl5/site_perl/auto/Device/SerialPort"</code>

D) ganz wichtig - sonst schmiert Euch der CUL immer wieder ab - synousbmdemd deaktivieren - das habe ich wie folgt gemacht:

<code>mv /usr/syno/sbin/synousbmodemd /usr/syno/sbin/synousbmodemd_bkp</code>

Bei einem DSM update wird dieser Dienst vermutlich wieder installiert - daher nach einem Update same procedure as every year.

== Wichtig: Logfile auf USB auslagern ==
Damit die DS auch ab und zu mal die Platten zum schlafen schicken kann, solltet ihr die Logfiles auf ein USB-Laufwerk auslagern. Dazu einfach eines an die DS anschließen und im File-Explorer nachschauen, wie das Laufwerk benannt wurde (z.B. volumeUSB1). Dann Fhem runterfahren ("shutdown"), anschließend als root über z.B. putty mit der DS verbinden, das Log-Verzeichnis auf den Stick verschieben und einen Link anlegen - z.B. so:

<code>mv /usr/local/FHEM/var/log /volumeUSB1/usbshare/fhem

ln -s /volumeUSB1/usbshare/fhem/log /usr/local/FHEM/var/log</code>

Dann Fhem wieder starten und es sollte klappen.

== Inhalt von Fhem-Verzeichnissen aus Windows direkt bearbeiten ==
Hier gibt es mehrere Möglichkeiten. Entweder ihr verbindet Euch über WinSCP mit der DS. Oder aber ihr verschiebt und verknüpft noch weitere Teile der Fhem Installation auf den Stick (siehe Logfile auf USB auslagern). Hier wäre ich allerdings vorsichtig, da kann Fhem zickig werden. Ich persönlich habe mir die fhem.cfg auf diese Weise noch auf den Stick geschoben - also das /usr/local/FHEM/etc Verzeichnis analog obiger Beschreibung zum Logfile. Darüber hinaus könnt ihr auch einfach Dateien auf Eurem Stick ablegen und im entsprechenden Fhem-Verzeichnis einen Link dazu erstellen - so habe ich das z.B. mit meinen pm-Files gemacht - z.B.

<code>ln -s /volumeUSB1/usbshare/fhem/99_myUtils.pm /usr/local/FHEM/share/fhem/FHEM/99_myUtils.pm</code>

== HUE auf der Synology Diskstation ==
Da auf der DS standardmäßig kein JSON installiert ist, muss dies nachinstalliert werden (Danke an Patlinger für die Anleitung). Wichtig - ihr braucht IPKG (siehe CUL zum Laufen bringen):

1. Per SSH verbinden (Befehl "ssh <ip-adresse> -l root")

2. Superuser aktivieren (Befehl "su")

3. "make" installieren (Befehl "ipkg install make")

4. PERL und CPAN starten (Befehl "/usr/local/perl/bin/perl -MCPAN -e shell") / je nachdem wo Eure perl Installation liegt - bei mir war es "/usr/bin/perl -MCPAN -e shell"

5. CPAN updaten (Befehl "install CPAN")

6. JSON installieren (Befehl "install JSON")

7. Per telnet verbinden (Befehl "telnet <ip-adresse> <port (7072)>")

8. FHEM Update durchführen (Befehl "update")

9. FHEM Neustart (Befehl "shutdown restart")

10. Hue Bridge hinzufügen (Befehl "define <Name-für-die-Bridge> HUEBridge <ip-adresse-der-Hue-Bridge>")

11. Taste an der Hue Bridge drücken um das "Pairing" zu bestätigen.

12. GANZ WICHTIG - Wenn's jetzt einmal läuft, dann nicht vergessen die Konfiguration zu speichern! (Befehl "save")

== Net::Telnet installieren ==
Net::Telnet benötigt ihr beispielsweises für das geniale Modul FRITZBOX, dass Euch viele Möglichkeiten eröffnet, wenn ihr einen solchen Router besitzt.

Los gehts wie üblich mit
<code>"/usr/bin/perl -MCPAN -e shell"</code>
Der Pfad zu perl kann bei Euch auch anders lauten, siehe oben. Dann seid ihr fast fertig, nur noch folgendes eingeben - und fertig:
<code>install Net::Telnet</code>
[[Kategorie:HOWTOS]]
[[Kategorie:Server Hardware]]

Synology Diskstation

2014-12-11T17:38:02Z

Docb: /* HUE auf der Synology Diskstation */

Synology Diskstation

2014-12-11T17:03:06Z

Docb: /* CUL zum laufen bringen | IPKG installieren */

2013-07-26T13:08:30Z

Docb:

Hue

2013-07-26T10:03:26Z

Docb:

2013-07-15T09:03:38Z

Docb: /* Geräten Icons zuweisen */

Icons - alles rund um die Icons in Fhem
= Fhem mit Icons verschönern =
== Geräten Icons zuweisen ==
Im FHEMWEB auf Detail-Ansicht des Gerätes gehen, danach in der attr Zeile per dropdown 
a) icon auswählen, um das Icon zu wählen, dass standardmäßig links vom Gerät gezeigt wird; alternativ ganz unten auf Select icon klicken, dann bekommt ihr alle Bilder angezeigt 
b) devStateIcon auswählen, um unschiedliche Schaltzustände mit unterschiedlichen Icons zu versehen; alternativ ganz unten auf Extend devStateIcon klicken, dann bekommt ihr alle Bilder angezeigt und könnt sie dem jeweiligen Schaltzustand zuordnen.
 
Dabei gilt folgendes: 
- Icon-Dateiname OHNE Dateiendung eingeben 
- wenn es sich bei dem Icon um eine svg-Datei handelt, kann mit @farbe, die Farbe beeinflusst werden, z.B.
<pre>attr Geraet devStateIcon an:general_an@green aus:general_aus@red</pre>
wobei hier die beiden Dateien general_an.svg und general_aus.svg heißen.
- statt des Standardfarbnamens, kann übrigens auch der 6-stellige Hex-Code übergeben werden (ohne # am Anfang). Den Code könnt ihr z.B. hier http://www.colorpicker.com/ generieren 
Wenn ihr die Änderungen wie oben beschrieben durchführt, könnt ihr das Ergebnis gleich betrachten. Wenn alles passt, dann noch "Save config" drücken, dann wird alles fest abgespeichert.

== Mehr Icons zur Auswahl ==
Grundsätzlich habt ihr schöne Standardicons bei fhem mit dabei und aktiviert. Navigiert doch einfach mal im fhem Verzeichnis in den www Ordner und dort in images. Der Ordner default ist standardmäßig aktiviert, dh. icons aus diesem Ordner werden in fhem angezeigt. Wenn ihr zusätzlich die Icons auch aus den anderen Ordnern (z.B. openautomation oder fhemSVG) verwenden wollt, dann ergänzt einfach die entsprechende Zeile "WEB iconPath" in der fhem.cfg:
<pre>attr WEB iconPath fhemSVG:openautomation:default</pre>
== Weitere Tipps ==
Weitere Tipps zu Icons hier in der Wiki: 
http://www.fhemwiki.de/wiki/Slider_f%C3%BCr_HM-Rolladensteuerung_anzeigen

= Eigene Icons erstellen =
Falls ihr eigene Icons basteln wollt - sehr gerne. Umso besser, wenn ihr diese dann mit uns teilt. Der passende Thread im Forum: http://forum.fhem.de/index.php?t=msg&goto=85849
== SVG-Icons ==
Hier einige Tipps zum Erstellen von SVG-Icons. SVGs bieten einige Vorteile:
- SVGs sind vektorbasiert und somit frei skalierbar
- SVGs sind, wenn man sie genauer betrachtet, gut lesbarer und veränderbarer Quellcode und können deswegen leicht über css manipuliert werden

Wie geht es nun: 
- Inkscape (http://inkscape.org/download/?lang=de) besorgen (Open Source) 
- Loszeichnen 
Jetzt wird es wichtig - fhem ist etwas sensibel, was svgs anbelangt und will diese zudem farblich umgestalten. Daher folgendes unbedingt beachten: 
- fhem ersetzt bei allen fill:#000000 und fill="#000000" die sechs Nullen mit einem Farbcode, wenn dieser mit übergeben wurde (sh. Fhem mit Icons verschönern weiter oben) - das solltet ihr beim zeichnen beachten
- daher arbeite ich immer so, dass ich beispielsweise Rechtecke/Kreise zeichne und diese dann mit "Kontur in Pfad umwandeln" umwandle -> dann ist das Rechteck transparent, die Linie schwarz (und wird von fhem erstetzt) und alles klappt 
- alle Texte müssen in Pfade umgewandelt werden 
- das gesamte Bild muss als "Normales SVG" gespeichert werden (Standardeinstellung bei Inkscape ist "Inkscape SVG") 
- letzter wichtiger Tipp: Eine Zeile darf im SVG nicht fehlen, sonst zeigt fhem es nicht an. Wenn ihr Euer SVG in einem Texteditor öffnet (ich empfehle notepad++), schaut in in der <svg>-Definition, ob die Zeile mit viewBox dabei ist. Wenn nicht, dann nach unterem Format ergänzen. 

<pre>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<svg
version="1.0"
width="585"
height="585"
viewBox="0 0 585 585"
id="svg2421"
sodipodi:docname="usb-stick.svg"></pre>

[[Kategorie:Icons]]

Icons

2013-07-15T08:59:34Z

Docb: /* Fhem mit Icons verschönern */

2013-06-29T13:51:07Z

Docb: /* Editieren von Registerwerten */

Homematic Bewegungsmelder für Innen
== Features ==
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Der Sensor muss hierfür geöffnet und die Anlerntastebetätigt werden. Hierbei gibt es zwei Konfigurationsmöglichkeiten:

<nowiki>- Anlerntaste kurz betätigen, um den Bewegungsmelder ohne Helligkeitsschwelle anzulernen
- Anlernen mit Helligkeitsschwellle sh. Bedienungsanleitung S. 14f.)</nowiki>
=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der fhem.cfg:

<nowiki>define EG_Bewegungsmelder CUL_HM 19xxxx
attr EG_Bewegungsmelder .devInfo 810100
attr EG_Bewegungsmelder .stc 81
attr EG_Bewegungsmelder actCycle 000:10
attr EG_Bewegungsmelder actStatus alive
attr EG_Bewegungsmelder expert 2_full
attr EG_Bewegungsmelder firmware 1.0
attr EG_Bewegungsmelder model HM-SEC-MDIR
attr EG_Bewegungsmelder peerIDs
attr EG_Bewegungsmelder room Z_Alarm
attr EG_Bewegungsmelder serialNr JEQ00xxxxx
attr EG_Bewegungsmelder subType motionDetector</nowiki>
=== Konfiguration über Register ===
==== Anzeige aller dekodierten Register ====
<nowiki>get <name> regList</nowiki>
zeigt alle moeglichen 'dekodierten' Register an. Fuer mdir sind dies alle, sollte also komplett sein. Hier findet man sowohl den Wertebereich alsauch eine (sehr) kleine Beschreibung.
Ausgabe:

<nowiki>
list: register | range | peer |exp| description
0: intKeyVisib | - to - | |exp| visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | | pairing to central
0: sabotageMsg | - to - | | | enable sabotage message options:on,off
1: brightFilter | 0 to 7 | | | brightness filter - ignore light at night
1: captInInterval | - to - | | | capture within interval options:on,off
1: evtFltrNum | 1 to 15 | | | sensitivity - read sach n-th puls
1: evtFltrPeriod | 0.5 to 7.5s | | | event filter period
1: ledOnTime | 0 to 1.275s | |exp| LED ontime
1: minInterval | - to - | | | minimum interval in sec options:240,60,120,30,15
4: peerNeedsBurst | - to - | required | | peer expects burst options:on,off
</nowiki>
==== Auslesen der register aus dem device ====
<nowiki>set <name> getConfig</nowiki>
Einige Register werden direkt in den Readings angezeigt. das sind die Wichtigsten. Bei Anwendung auf ein "device" werden auch die Kanaele ausgelesen, bei Kanal nur der Kanal.
Die Anzeige der Register in den Readings ist R-<regname>. Der "R-" prefix dient zur Sortierung und auch zur einfacheren Identifizierung, dass es ein Register ist.

==== Editieren von Registerwerten ====
<nowiki>get EG_Bewegungsmelder regList
set EG_Bewegungsmelder getConfig
Anlernen drücken
get EG_Bewegungsmelder reg all
set EG_Bewegungsmelder regSet minInterval 60</nowiki>

um das Meldeintervall von standardmäßig 240sek. auf 60sek. herabzusetzen.
Dann wieder kurz anlernen drücken um die Daten auf den Sensor zu übertragen und mit
set EG_Bewegungsmelder getConfig
Daten wieder auslesen, ob alles geklappt hat und mit
get EG_Bewegungsmelder reg all
anzeigen lassen. Wenn noch vor den Werten ein set_ steht, z.B. set_60 wurde der Befehl noch nicht übertragen. Dann einfach nochmal kurz anlernen drücken und die letzten beiden Schritte wiederholen.
Die Einstellungen können mit
set <name> saveConfig <dateiname>
gespeichert werden.

== Mögliche Zustände ==
=== Log-Auszug ===
In FHEM sind folgende Zustände des HM-Sec-MDIR im Log zu sehen:

<nowiki>2012-05-30_16:17:26 EG_Bewegungsmelder motion
2012-05-30_16:17:26 EG_Bewegungsmelder motion: on (to broadcast)
2012-05-30_16:18:34 EG_Bewegungsmelder brightness: 43
2012-05-30_16:18:34 EG_Bewegungsmelder alive
2012-05-30_16:18:34 EG_Bewegungsmelder cover: closed</nowiki>

== Links ==
Anleitung [http://www.elv-downloads.de/service/manuals/76675_HM_Sec_MDIR_GE_V1_0.pdf] PDF

[[Kategorie:HomeMatic Components]]

HM-Sec-MDIR Funk-Bewegungsmelder innen

2013-06-29T13:50:57Z

Docb: /* Editieren von Registerwerten */

Homematic Bewegungsmelder für Innen
== Features ==
== Hinweise zum Betrieb mit FHEM ==
Das Pairing sollte wie in [[HomeMatic Devices pairen]] beschrieben durchgeführt werden. Der Sensor muss hierfür geöffnet und die Anlerntastebetätigt werden. Hierbei gibt es zwei Konfigurationsmöglichkeiten:

<nowiki>- Anlerntaste kurz betätigen, um den Bewegungsmelder ohne Helligkeitsschwelle anzulernen
- Anlernen mit Helligkeitsschwellle sh. Bedienungsanleitung S. 14f.)</nowiki>
=== FHEM Config-Auszug ===
Ein exemplarischer Auszug aus der fhem.cfg:

<nowiki>define EG_Bewegungsmelder CUL_HM 19xxxx
attr EG_Bewegungsmelder .devInfo 810100
attr EG_Bewegungsmelder .stc 81
attr EG_Bewegungsmelder actCycle 000:10
attr EG_Bewegungsmelder actStatus alive
attr EG_Bewegungsmelder expert 2_full
attr EG_Bewegungsmelder firmware 1.0
attr EG_Bewegungsmelder model HM-SEC-MDIR
attr EG_Bewegungsmelder peerIDs
attr EG_Bewegungsmelder room Z_Alarm
attr EG_Bewegungsmelder serialNr JEQ00xxxxx
attr EG_Bewegungsmelder subType motionDetector</nowiki>
=== Konfiguration über Register ===
==== Anzeige aller dekodierten Register ====
<nowiki>get <name> regList</nowiki>
zeigt alle moeglichen 'dekodierten' Register an. Fuer mdir sind dies alle, sollte also komplett sein. Hier findet man sowohl den Wertebereich alsauch eine (sehr) kleine Beschreibung.
Ausgabe:

<nowiki>
list: register | range | peer |exp| description
0: intKeyVisib | - to - | |exp| visibility of internal channel options:visib,invisib
0: pairCentral | 0 to 16777215 | | | pairing to central
0: sabotageMsg | - to - | | | enable sabotage message options:on,off
1: brightFilter | 0 to 7 | | | brightness filter - ignore light at night
1: captInInterval | - to - | | | capture within interval options:on,off
1: evtFltrNum | 1 to 15 | | | sensitivity - read sach n-th puls
1: evtFltrPeriod | 0.5 to 7.5s | | | event filter period
1: ledOnTime | 0 to 1.275s | |exp| LED ontime
1: minInterval | - to - | | | minimum interval in sec options:240,60,120,30,15
4: peerNeedsBurst | - to - | required | | peer expects burst options:on,off
</nowiki>
==== Auslesen der register aus dem device ====
<nowiki>set <name> getConfig</nowiki>
Einige Register werden direkt in den Readings angezeigt. das sind die Wichtigsten. Bei Anwendung auf ein "device" werden auch die Kanaele ausgelesen, bei Kanal nur der Kanal.
Die Anzeige der Register in den Readings ist R-<regname>. Der "R-" prefix dient zur Sortierung und auch zur einfacheren Identifizierung, dass es ein Register ist.

==== Editieren von Registerwerten ====
get EG_Bewegungsmelder regList
set EG_Bewegungsmelder getConfig
Anlernen drücken
get EG_Bewegungsmelder reg all
set EG_Bewegungsmelder regSet minInterval 60

um das Meldeintervall von standardmäßig 240sek. auf 60sek. herabzusetzen.
Dann wieder kurz anlernen drücken um die Daten auf den Sensor zu übertragen und mit
set EG_Bewegungsmelder getConfig
Daten wieder auslesen, ob alles geklappt hat und mit
get EG_Bewegungsmelder reg all
anzeigen lassen. Wenn noch vor den Werten ein set_ steht, z.B. set_60 wurde der Befehl noch nicht übertragen. Dann einfach nochmal kurz anlernen drücken und die letzten beiden Schritte wiederholen.
Die Einstellungen können mit
set <name> saveConfig <dateiname>
gespeichert werden.

== Mögliche Zustände ==
=== Log-Auszug ===
In FHEM sind folgende Zustände des HM-Sec-MDIR im Log zu sehen:

<nowiki>2012-05-30_16:17:26 EG_Bewegungsmelder motion
2012-05-30_16:17:26 EG_Bewegungsmelder motion: on (to broadcast)
2012-05-30_16:18:34 EG_Bewegungsmelder brightness: 43
2012-05-30_16:18:34 EG_Bewegungsmelder alive
2012-05-30_16:18:34 EG_Bewegungsmelder cover: closed</nowiki>

== Links ==
Anleitung [http://www.elv-downloads.de/service/manuals/76675_HM_Sec_MDIR_GE_V1_0.pdf] PDF

[[Kategorie:HomeMatic Components]]