IPCAM

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

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

Templates

Die Einrichtung von Kameras kann über Templates einfacher gemacht werden.

Als funktionierend bekannte Funktionen können in diesem Forenbeitrag hinterlegt werden, sie werden dann beizeiten ins SVN aufgenommen und stehen so für alle Benutzer zur Verfügung.

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
• Foscam FI9853EP
• 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
• Mobotix (jedenfalls S26 und Q25)
• 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

Pfad-Parameter für Mobotix

attr IPKamera path /record/current.jpg

Pfad-Parameter für reolink (E1 Zoom)

attr IPKamera path cgi-bin/api.cgi?cmd=Snap&width=<Breite>&height=<Hoehe>&channel=0&rs=<irgendwas>&user=Username&password=Passwort

Beispiel:

attr IPKamera path cgi-bin/api.cgi?cmd=Snap&width=1024&height=768&channel=0&rs=12345&user=User&password=Pwd

Weitere Befehle sind aktuell noch nicht bekannt.

Es gibt eine spärliche Doku bzgl. cgi hier: https://cdn.reolink.com/wp-content/uploads/2017/01/Reolink-CGI-command-v1.61.pdf

Allerdings wird wohl für die Steuerbefehle (PTZ) ein Post-Request benötigt.

Weitere Kommandos wurden hier gesammelt: https://community.jeedom.com/t/reolink-liste-de-commandes-via-api-maj-29-04/25565

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

Logging

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
  • Mit 27. Februar 2021 erhält man mit verbose 4 zB folgenden Logeintrag: 2021.02.27 23:03:39 4: IPCAM (ipcam_reolink) - set cmd requesting http://x.x.x.x/cgi-bin/api.cgi?user=abc&password=def&cmd=GetOsd
• Die Zuordnung von Meldungen zu verbose-Leveln sollte kontrolliert und ggf. umgestellt werden

Außerdem müsste das Modul dringend auf die aktuelle Form des Logging, verbose/Log3, umgestellt werden. (seit 27. Februar 2021 behoben)

Probleme mit HikVision IP Kamera

Siehe auch diesen Forenthread, der Beschreibung von Problemen, eine Hikvision IPCam in Betrieb zu nehmen

Meldung "Wrong... image format: unknown"

Eine mögliche Lösung für das Problem "Wrong or not supported image format: unknown" ist in diesem Forenbeitrag beschrieben.

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