Version History…

Änderungshistorie

Das MotionEye Plugin installiert die Software MotionEye auf dem LoxBerry. Damit wird er zum vollwertigen Kamera Surveillance System. Zudem konvertiert die Software beliebige Kamera-/Video-Streams in MJPEG-Streams um, sodass auch Kameras, die kein MJPEG bieten, mit dem Türsteuerungsbaustein verwendet werden können. Die Konvertierung übernimmt dabei die Software ffmpeg. Ffmpeg kann so ziemlich alle gängigen Codecs und Videoformate decodieren.

MotionEye bietet dabei folgende Features:

• kompatibel mit den meisten USB Kameras und dem Raspberry PI Kamera Modul
• Support für IP (network) Kameras
• Motion Detection mit Email Notifications, Zeitplan und Schalten von virtuellen Eingängen am Miniserver
• Aufzeichnung bei Ereignis oder permanent, JPEG Dateien für Images, AVI/MP4 Dateien für Videos
• Aufzeichnung aus Loxone heraus starten (zum Beispiel per Bewegungsmelder)
• Uploading zu Google Drive und Dropbox sowie auf externe Datenträger und Netzwerk-Shares

MotionEye kann technisch gesehen mehr oder weniger jeden Stream in jeder Qualität in einen MJPEG-Stream wandeln, Bewegung auswerten, aufzeichnen. Und das auch für beliebig viele Kameras. Aber die Hardware begrenzt die Möglichkeiten stark! Die Konvertierung eines Videostreams benötigt sehr viel CPU-Last - je höher die Qualität des Streams ist (Auflösung, Frames/s,, Bitrate), desto höher sind die Anforderungen an die Hardware.

Soll der Stream konvertiert werden (z. B. aus einem H.264 Stream), gilt es als ersten Schritt die Videoqualität in der Kamera so gering wie nur irgendwie möglich einzustellen. Man sollte die Videogröße und die Bitrate soweit herunternehmen, bis das Bild gerade noch akzeptabel ist. Diesen Stream dann in MotionEye konvertieren.

Am Besten werden überhaupt keine Streams konvertiert. Aktiviert wenn möglich den MJPEG-Stream in der Kamera und lasst ihn von MotionEye nur re-streamen für die Türsteuerungsbausteine in Loxone. Das verbraucht sehr geringe Ressourcen.

Wenn ihr H264 Streams von der Kamera verarbeiten wollt, verzichtet auf eine Konvertierung in MotionEye!

Verzichtet auf die Bewegungserkennung wenn möglich! Diese verbraucht "gigantische" Ressourcen und lässt sich sinnvoll nur in einer VM nutzen. Aber selbst dann sind die Ergebnisse eher ernüchternd… Nutzt wenn irgendwie möglich die Bewegungserkennung in eurer Kamera und triggert dann über HTTP z. B. einen Virtuellen Eingang in Loxone.

Nachdem man die Kameras in MotionEye aktiviert hat, sollte man die CPU-Auslastung und die CPU-Temperatur des LoxBerrys kontrollieren. Schließt dazu MotionExe im Browser (die Webseite verbraucht durch die Anzeige viele Ressourcen), öffnet dann das Terminal Widget und startet im Terminal "htop":

Achtet hier auf die CPU- und Speicherauslastung. Beobachtet auch die Load Average. Die drei Werte bedeuten: Aktuelle Auslastung, 5-Minuten-Duchschnitt, 15-Minuten-Durchschnitt. Ist die Loadaverage gleich der CPU-Anzahl, habt ihr eine Vollauslastung des Systems (100%). Ist sie kleiner, haben die CPUs noch Reserve. Ist die Load Average größer als die Anzahl der CPUs, schaffen die CPUs es nicht alle Anfragen in der gewünschten Zeit zu verarbeiten. Im Screenshot ist die Load Average ungefähr 2 und der Raspberry 4 hat 4 CPU Kerne. Das bedeutet eine Auslastung von 50%.

• Das Plugin-Archiv (ZIP) kann auf GIT-Hub heruntergeladen werden: https://github.com/mschlenstedt/LoxBerry-Plugin-MotionEye/releases
• Der Sourcecode ist auf GitHub verfügbar: https://github.com/mschlenstedt/LoxBerry-Plugin-MotionEye

Fehlerberichte bitte direkt im Repository auf GitHub melden.

Das Plugin bietet keine Konfigurationsoptionen an. Sämtliche Einstellungen werden in MotionEye durchgeführt. 

Für eine Erklärung sämtlicher Optionen empfehle ich Euch die entsprechenden Tutorials auf YouTube: https://www.youtube.com/results?search_query=MotionEye

Neben den Aktionen, die innerhalb von MotionEye konfiguriert werden können, wenn von der Kamera eine Bewegung erkannt wurde, kann auch eine externe Webseite bei Bewegungserkennung aufgerufen werden. So ist es möglich in Loxone einen virtuellen Eingang bei Bewegungserkennung zu schalten und so weitere Aktionen in LoxoneConfig zu programmieren (Licht an z. B.).

Dazu gebt ihr in MotionEye in der Kamerakonfiguration unter "Motion Notifications" eine sogenannte Web Hook URL an. Diese schaltet den Virtuellen Eingang innerhalb von Loxone. Bitte schaut in die Doku von Loxone bzw. ins Wiki, wie sich die URLs zusammensetzen: REST Webservice oder https://www.loxone.com/dede/kb/webservices/

Eine URL für den Eingang/Baustein "kamera_garten" sieht z. B. so aus (Impuls): http://LOXONE_USER:LOXONE_PASSWORT@IP_MINISERVER/dev/sps/io/kamera_garten/Impulse

Richtet zunächst im LoxBerry euer Netzwerkshare oder aber einen externen Datenträger über das Netshares- oder USB Storage-Widget ein: Widget Netshares oder Widget USB Storages

Im System werden sowohl die Netzwerkshares als auch die USB Datenträger unter dem Pfad /opt/loxberry/system/storage/usb/NAME bzw. /opt/loxberry/system/storage/smb/NAME eingebunden. Wenn ihr im Widget auf "Browse" geht, seht ihr den exakten Pfad. Der Pfad zu eurem Datenträger oder Netzwerkshare muss nun in MotionEye unter "Filestorage" als "Custom Path" eingetragen werden:

Achtung! Standardmäßig ist hier das Datenverzeichnis des Plugins auf eurer SD-Karte vorausgewählt. Ich empfehle Euch dringend keine großen Datenmengen permanent auf der SD-Karte zu speichern! Die Speicherkarte könnte dadurch Schaden nehmen.

Mit Version 1.0.1 des Plugins können aus Loxone heraus Video- oder Fotoaufnahmen getriggert werden. So kann z. B. bei erkannter Bewegung über einen Bewegungsmelder die Aufzeichnung des Bildes für X Minuten gestartet werden.

Zunächst legt ihr einen passenden Pfad an, unter dem die Aufnahmen abgelegt werden sollen, siehe Kapitel oben.

Wenn ihr Videoaufnahmen per Trigger speichern wollt, aktiviert ihr die Sektion "Movies":

Es empfiehlt sich hier, Movie Passthrough zu aktivieren. Damit wird das Kamerabild 1:1 ohne irgendwelche Konvertierung in ein MP4-File geschrieben. Das benötigt die geringsten Systemressourcen. Als Recording Mode wählt ihr Motion Triggered. Legt nun noch fest, wie lange die Aufnahmen gespeichert werden sollen. Nach dieser Zeit wird die Aufnahme automatisch gelöscht. Die Sektion "Motion Detection" weiter unten in den MotionEye-Einstellungen muss nicht aktiviert werden!

Wenn ihr lediglich ein oder mehrere Standbilder per Trigger speichern wollt, aktiviert ihr die Sektion "Still Images":

Als Capture Mode wählt ihr Motion Triggered oder Motion Triggered (One Picture) . Bei Motion Triggered wird pro Sekunde ein Bild gespeichert, solange die Bewegungserkennung aktiv ist. Im anderen Fall wird nur ein Bild zu Beginn gespeichert. Legt nun noch fest, wie lange die Aufnahmen gespeichert werden sollen. Nach dieser Zeit wird die Aufnahme automatisch gelöscht. Die Sektion "Motion Detection" weiter unten in den MotionEye-Einstellungen muss nicht aktiviert werden!

In Loxone Config legt ihr Euch einen Virtuellen Ausgang an:

Die Adresse lautet: http://loxberry:passwort@<ip_loxberry>, z. B. http://loxberry:passwort@192.168.3.28 . Die IP-Adresse, Username und Passwort müsst ihr natürlich wie immer anpassen. Unterhalb des virtuellen Ausgangs legt ihr nun einen Virtuellen Ausgang Befehl an:

Befehl bei EIN: /admin/plugins/motioneye/motion.cgi?cam=1&motion=1

Befehl bei AUS: /admin/plugins/motioneye/motion.cgi?cam=1&motion=0

Als Digitaleingang verwenden: Aktiviert

Der Parameter cam enthält die Camera-ID, die ihr ansprechen wollt. Diese findet ihr in der MotionEye Weboberfläche in der Sektion "Video Device". Mit motion=1 aktiviert ihr die Aufzeichnung, mit motion=0 stoppt ihr die Aufzeichnung wieder. In dem ihr vor den Ausgang eine Ausschaltverzögerung hängt, könnt ihr die Dauer der Aufzeichnung bei Bewegungserkennung anpassen:

Die Aufnahmen könnt ihr über die Weboberfläche von MotionEye erreichen und von dort auch direkt im Browser abspielen. Klickt dazu in der Weboberfläche auf das Picture- oder Play-Symbol. In der Übersicht lassen sich die Dateien auch herunterladen oder manuell löschen, zippen oder ein Timelapse Video erstellen.

Eine andere Alternative ist per Netzwerkfreigabe auf den LoxBerry zuzugreifen und die Dateien direkt zu öffnen bzw. zu kopieren. Dazu öffnet ihr ein Explorer-Fenster und gebt zwei Backslashe gefolgt von der IP eures LoxBerrys ein, z. B. \\192.168.3.28. Wechselt in die loxberry-Freigabe und geht in den Ordner \system\storage. Dort findet ihr eure Netzwerkfreigaben oder USB-Geräte und könnt direkt auf die einzelnen Dateien zugreifen. Solltet ihr die Dateien im Datenverzeichnis des Plugins speichern, ist der Pfad \data\plugins\motioneye.

Möchte man die Aufnahme automatisch per Mail versenden, so ist das ebenfalls möglich (z. B. das Kamerabild beim Klingeln direkt per Email versenden). Natürlich muss zunächst Euer Mailserver im LoxBerry Mail Widget konfiguriert werden.

Aktiviert nun in der Sektion "Still Images" manuelle Captures - die Speicherzeit wählt ihr möglichst niedrig (außer ihr wollt die Bilder aufbewahren). Idealerweise speichert ihr die Bilder nicht auf der SD-Karte sondern auf einem externen Datenträger (z. B. USB-Stick).

Nun legt ihr wieder einen Virtuellen Ausgangsbefehl an (siehe oben):

Befehl bei EIN: /admin/plugins/motioneye/motion.cgi?cam=1&mail=1&to=DeineEmail@example.com

Als Digitaleingang verwenden: Aktiviert

Mögliche Optionen/Parameter für den Befehl:

Solltet ihr Probleme mit der Größe des angehängten Bildes haben (zu klein), dann beachtet bitte den Hinweis aus den FAQ: Obwohl ich einen Stream in voller Auflösung eingerichtet habe, hat der MJPEG-Stream in MotionEye nur 640x480 Pixel. Warum?

Über das Plugin kann auch einfach ein aktueller Snapshot abgerufen werden. Das kann eine Alternative für die URL im Kamerabaustein sein, wenn man aus Leistungsgründen den MJPEG-Stream nicht verwenden möchte oder aber das Bild noch einmal für Loxone resizen möchte (geht leider über MotionEye nicht). Loxone erzeugt aus den Einzelbildern, die abgerufen werden, dann wieder automatisch einen Stream.

Aktiviert in der Sektion "Still Images" manuelle Captures - die Speicherzeit wählt ihr möglichst niedrig (außer ihr wollt die Bilder aufbewahren). Idealerweise speichert ihr die Bilder nicht auf der SD-Karte sondern auf einem externen Datenträger (z. B. USB-Stick).

Nun legt ihr wieder einen Virtuellen Ausgangsbefehl an (siehe oben):

Befehl bei EIN: /admin/plugins/motioneye/motion.cgi?cam=1&show=1

Als Digitaleingang verwenden: Aktiviert

Mögliche Optionen/Parameter für den Befehl:

Solltet ihr Probleme mit der Größe des angehängten Bildes haben (zu klein), dann beachtet bitte den Hinweis aus den FAQ: Obwohl ich einen Stream in voller Auflösung eingerichtet habe, hat der MJPEG-Stream in MotionEye nur 640x480 Pixel. Warum?

Das Plugin fügt jede Kamera, für die das Video Streaming aktiviert wurde, in eine simple Webseite ein, die über den Webage-Baustein in die Loxone Config integriert werden kann. So kann man sich mit einem Klick alle Kameras auf einen Blick aus der Loxone App heraus anschauen. Ein Klick auf das jeweilige Kamerabild öffnet den Kamerastream im Großformat.

Nein. Du brauchst einen leistungsfähigen Rechner. Es ist mindestens ein Raspberry Pi 4 oder gleichwertig notwendig.

Du hast Deinen LoxBerry mit dem falschen Image installiert. Du musst das 64Bit Image (AARCH64) verwenden. Dein LoxBerry läuft auf einem 32Bit Image.

RSTP Streams zu dekodieren erfordert extrem viel Performance. Du kannst einen Trick verwenden und Snapshots Deiner Kamera in voller Auflösung zu einem MFPEG-Stream zu konvertieren. Dieser benötigt kaum Systemressourcen, um ihn in MotionEye weiter zu verarbeiten. Nachteil ist, dass die Bildwiederholungsrate sehr niedrig ist (1 Bild pro Sekunde in etwa). Für eine Überwachungskamera reicht das aber in aller Regel aus.

In diesem Artikel kannst Du nachlesen wie das geht: Aus einzelnen Caputres ein MJPEG-Stream erzeugen

Das ist ein Fehler in der Software Motion, auf der MotionEye basiert. Motion verwendet immer 640x480 und ignoriert die Größe des eingehenden Streams. Gebe bei der Option Extra Motion Options die echten Abmaße des eingehenden Kamerastreams wie folgt ein:

height 1080
width 1920

Danach hat der MJPEG-Stream die volle Größe.

Diese Option verändert nur die Streamgröße in der MotionEye WebUI und nicht die Größe des MJPEG-Streams oder des Snapshots. Schaue hier wie Du die Größe trotzdem ändern (verkleinern) kannst: Aufnahme / Snapshot abrufen