IPCAM: Unterschied zwischen den Versionen

IPCAM
Zweck / Funktion
	Einbindung von Netzwerkkameras
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Sonstiges
Modulname	49_IPCAM.pm
Ersteller	mfr69bs (Martin Fischer )
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 5. Dezember 2019, 23:39 Uhr

IPCAM ermöglicht die ereignis- oder zeitgesteuerte Erzeugung von Mitschnitten bei Netzwerkkameras. Außerdem ist es möglich, die Kamera im PTZ-Modus oder über eigene Befehle zu steuern.

Voraussetzungen

Die Kamera(bilder) müssen über eine URL erreichbar sein.

Definition

Das IPCAM Objekt wird angelegt mit

define <name> IPCAM <ip[:port]>

Zusätzlich zum obigen Define muss zwingend noch das path Attribut gesetzt werden.

Attribute

Die wichtigsten Attribute von IPCAM werden im Folgenden aufgeführt, die komplette Liste findet sich in der commandref/IPCAMattr.

Authentifizierung

basicauth: Hinterlegung von Benutzernamen und Passwort

Eigene Befehle

cmd01, cmd02, ... cmd15: Festlegung von Befehlen, die nicht zu den vordefinierten gehören, z.B. attr ipcam cmd01 led_mode=0

Vordefinierte Befehle

cmdPanLeft, cmdPanRight, cmdTiltUp, cmdTiltDown, cmdStep: Diesen Befehlen können die Kameraspezifischen Werte zugeordnet werden, z.B. attr ipcam cmdTiltUp command=0

Pfade

path: ...

Unterstützte Netzwerkkameras

Die Aufzählungen der unterstützten und der problematischen Netzwerkkameras sollten ergänzt werden, sobald neue Erkenntnisse vorliegen; beide Listen sind nicht vollständig.

Bei den folgenden Netzwerkkameras ist gesichert, dass sie durch das IPCAM Modul unterstützt sind:

Foscam 9805W
Foscam FI9831P
Instar 2905
IN-8015 Full HD
IN-6001HD
Instar 6011, 6012, 2905
Instar IN-5905HD, IN-5907HD, IN-6014HD, IN-6012HD-PoE
WansView (Modell nicht näher spezifiziert)
Wansview 620, 625, 6012
Axis 205
D-Link DCS-933
Xiaomi Dafang (nur mit alternativer Firmware)

Nicht gesichert, ob die Kamera unterstützt wird bzw. ob alle Funktionen nutzbar sind:

Foscam FI9831W

Pfad-Parameter für Axis 205

attr Cam1 path /jpg/image.jpg

Pfad-Parameter für D-Link DCS-933

attr Cam1 path image.jpg

Parameter für Hikvision DS-2CD2032-I

Mit folgenden Parameter wurde (lt. diesem Forenbeitrag) die Hikvision DS-2CD2032-I erfolgreich betrieben:

define Cam1 IPCAM 192.168.xxx.xxx
attr Cam1 basicauth <username>:<passwort>
attr Cam1 delay 0
attr Cam1 group Kamera
attr Cam1 icon it_camera
attr Cam1 path Streaming/channels/1/picture?snapShotImageType=JPEG
attr Cam1 snapshots 1
attr Cam1 storage /opt/fhem/www/snapshots/cam1

Pfad-Parameter für Foscam FI9831P

Die Version ist ohne basicauth und hat Nutzer und Passwort direkt in der URL. Kann natürlich geändert werden. Sämtliche Befehle für die Foscam HD Kameras findet man hier

define IPKamera IPCAM <ip>:<port>
attr IPKamera cmd01 cmd=ptzStopRun&usr=xxx&pwd=xxx
attr IPKamera cmdPanLeft cmd=ptzMoveLeft&usr=xxx&pwd=xxx
attr IPKamera cmdPanRight cmd=ptzMoveRight&usr=xxx&pwd=xxx
attr IPKamera cmdPos01 cmd=ptzGotoPresetPoint&name=<Nameposition>&usr=xxx&pwd=xxx
attr IPKamera cmdTiltDown cmd=ptzMoveDown&usr=xxx&pwd=xxx
attr IPKamera cmdTiltUp cmd=ptzMoveUp&usr=xxx&pwd=xxx
attr IPKamera path cgi-bin/CGIProxy.fcgi?usr=xxx&pwd=xxx&cmd=snapPicture2
attr IPKamera pathCmd cgi-bin/CGIProxy.fcgi
attr IPKamera pathPanTilt cgi-bin/CGIProxy.fcgi?usr=xxx&pwd=xxx
attr IPKamera storage ./www/images/webcam

Einstellungen für Foscam C2 und Foscam R2

Eine ausführliche Beschreibung zur Benutzung der IP Kameras Foscam C2 und Foscam R2 findet sich in diesem Forenthread.

Parameter für Xiaomi Dafang

Diese Parameter gelten bei installierter alternativer Firmware von hier


Attributes:
attr IPKamera  cmdPanLeft cmd=motor_left
attr IPKamera  cmdPanRight cmd=motor_right
attr IPKamera  cmdTiltDown cmd=motor_down
attr IPKamera  cmdTiltUp  cmd=motor_up
attr IPKamera  delay      10
attr IPKamera  event-on-update-reading snapshots
attr IPKamera  icon       it_camera
attr IPKamera  path       cgi-bin/currentpic.cgi
attr IPKamera  pathPanTilt cgi-bin/action.cgi?
attr IPKamera  snapshots  5
attr IPKamera  storage    /opt/fhem/www/ipcamera/dafang_1/shot

Parameter für INSTAR Full HD

Die vollständige Schnittstelle und weitere Beispiele können direkt im INSTAR-Wiki eingesehen werden.
Zur Integration einer INSTAR Full HD CAM können zum Beispiel folgende Attribute verwendet werden:

attr INSTAR_8015 basicauth {USERNAME}:{PASSWORD}
attr INSTAR_8015 cmd01 cmd=setinfrared&-infraredstat=auto
attr INSTAR_8015 cmd02 cmd=setinfrared&-infraredstat=close
attr INSTAR_8015 cmd03 cmd=setinfrared&-infraredstat=open
attr INSTAR_8015 cmd04 cmd=setmdalarm&-aname=ftprec&-switch=on
attr INSTAR_8015 cmd05 cmd=setmdalarm&-aname=ftprec&-switch=off
attr INSTAR_8015 cmd06 cmd=setplanrecattr&-planrec_enable=0
attr INSTAR_8015 cmd07 cmd=setplanrecattr&-planrec_enable=1
attr INSTAR_8015 cmd08 cmd=setplanrecattr&-planrec_chn=11
attr INSTAR_8015 cmd09 cmd=setplanrecattr&-planrec_chn=12
attr INSTAR_8015 cmd10 cmd=manualrec&-act=on
attr INSTAR_8015 cmd11 cmd=manualrec&-act=off
attr INSTAR_8015 cmd12 cmd=sdfrmt
attr INSTAR_8015 cmd13 cmd=preset&-act=goto&-number=0
attr INSTAR_8015 cmd14 cmd=preset&-act=goto&-number=1
attr INSTAR_8015 cmd15 cmd=preset&-act=goto&-number=2
attr INSTAR_8015 cmdPanLeft -act=left
attr INSTAR_8015 cmdPanRight -act=right
attr INSTAR_8015 cmdPos15 -act=stop
attr INSTAR_8015 cmdTiltDown -act=down
attr INSTAR_8015 cmdTiltUp -act=up
attr INSTAR_8015 credentials /<ipcam-conf-path>/ipcam.conf
attr INSTAR_8015 eventMap /pos 15:MOVE-STOP/pan left:MOVE-LEFT/pan right:MOVE-RIGHT/tilt up:MOVE-UP/tilt down:MOVE-DOWN/cmd 1:IR-LED-auto/cmd 2:IR-LED-off/cmd 3:IR-LED-on/cmd 4:FTP-rec-on/cmd 5:FTP-rec-off/cmd 6:REC-SD-DISABLE/cmd 7:REC-SD-ENABLE/cmd 8:REC-SD-QUAL-HIGH/cmd 9:REC-SD-QUAL-MID/cmd 10:MAN-REC-Start/cmd 11:MAN-REC-Stop/cmd 12:FORMAT-SD-CARD/cmd 13:POS-WZ/cmd 14:POS-Flur/cmd 15:POS-Park/
attr INSTAR_8015 icon it_camera
attr INSTAR_8015 path tmpfs/snap.jpg
attr INSTAR_8015 pathCmd param.cgi
attr INSTAR_8015 pathPanTilt ptzctrl.cgi?-step=
attr INSTAR_8015 scheme https
attr INSTAR_8015 storage /<ipcam-snapshot-path>/snapshots
attr INSTAR_8015 webCmd POS-WZ:POS-Flur:POS-Park

Nicht unterstützte Netzwerkkameras

Die hier aufgeführten Netzwerkkameras sind definitiv nicht unterstützt oder es gibt gravierende, hier beschriebene Einschränkungen.

TRENDnet TV-IP320PI: Aufruf der Funktion get myCam image führt zur Fehlermeldung ...invalid Format; auf Kamerabild oder Stream kann jedoch über die URL camHostnameOrIP/Streaming/channels/1/Picture (Bild) bzw. camHostnameOrIP/Streaming/channels/1/httpPreview (Stream) zugegriffen werden.

Generierte Ereignisse

Das Modul IPCAM generiert die Ereignisse

last: <name_of_device>_snapshot.<image_extension>
snapshots: <total_number_of_taken_snapshots_at_end>

Bekannte Probleme

Derzeit (08/2015) ist das Logging aus dem Modul zumindest lückenhaft und verbesserungsfähig. So sollten z.B. einige weitere Meldungen zur Fehlereingrenzung bei der Einrichtung eines IPCAM Objekts eingefügt werden:

Ausgabe des kompletten Pfads / der URL, die bei der Erzeugung eines Snapshots aus einzelnen Bestandteilen zusammengesetzt wird
Die Zuordnung von Meldungen zu verbose-Leveln sollte kontrolliert und ggf. umgestellt werden
siehe auch diesen Forenthread, der Beschreibung von Problemen, eine Hikvision IPCam in Betrieb zu nehmen

Außerdem müsste das Modul dringend auf die aktuelle Form des Logging, verbose/Log3, umgestellt werden.

Eine mögliche Lösung für das Problem "Wrong or not supported image format: unknown" habe ich hier beschrieben: Forenbeitrag

Links

Forenthread zur Erweiterung des IPCAM Moduls
Forenthread zum Thema Bewegungserkennung
Forenthread zum Thema Bewegungsmelder der Kamera "anzapfen"
Webseite des Modulautors zum Thema Videoüberwachung