This binding offers integration to a ZoneMinder Server. It currently only offers to integrate to monitors (eg. cameras in ZoneMinder).
It also only offers access to a limited set of values, as well as an even more limited option to update values in ZoneMinder.
It requires at least ZoneMinder 1.29 with API enabled (option 'OPT_USE_API' in ZoneMinder must be enabled).
The option 'OPT_TRIGGERS' must be anabled to allow openHAB to trip the ForceAlarm in ZoneMinder.
Supported Things
This binding supports the following thing types
Thing
Thing Type
Discovery
Description
ZoneMinder Server
Bridge
Manual
A ZoneMinder Server. Required version is minimum 1.29
ZoneMinder Monitor
Thing
Automatic
Monitor as defined in ZoneMinder Server
Getting started / Discovery
The binding consists of a Bridge (the ZoneMinder Server it self), and a number of Things, which relates to the induvidual monitors in ZoneMinder.
ZoneMinder things can be configured either through the online configuration utility via discovery, or manually through the 'zoneminder.things' configuration file.
The Bridge will not be autodiscovered, this behavior is by design.
That is because the ZoneMinder API can be configured to communicate on custom ports, you can even change the url from the default /zm/ to something userdefined.
That makes it meaningless to scan for a ZoneMinder Server.
The Bridge must therefore be added manually, this can be done from Paper UI.
After adding the Bridge it will go ONLINE, and after a short while and the discovery process for monitors will start.
When a new monitor is discovered it will appear in the Inbox.
Bridge
Channel
Type
Description
online
Switch
Parameter indicating if the server is online
CPU load
Text
Current CPU Load of server
Disk Usage
text
Current Disk Usage on server
Thing
Channel
Type
Description
online
Switch
Parameter indicating if the monitor is online
enabled
Switch
Parameter indicating if the monitor is enabled
force-alarm
Switch
Parameter indicating if Force Alarm for the the monitor is active
alarm
Switch
true if monitor has an active alarm
recording
Text
true if monitor is recording
detailed-status
Text
Detailed status of monitor (Idle, Pre-alarm, Alarm, Alert, Recording)
event-cause
Text
Empty when there is no active event, else it contains the text with the cause of the event
function
Text
Text corresponding the value in ZoneMinder: None, Monitor, Modect, Record, Mocord, Nodect
rule "Monitor1 Alarm State"
when
Item zmMonitor1_EventState changed
then
if (zmMonitor1_EventState.state == ON) {
logInfo("zoneminder.rules", "ZoneMinder Alarm started")
}
else if (zmMonitor1_EventState.state == OFF) {
logInfo("zoneminder.rules", "ZoneMinder Alarm stopped")
}
end
rule "Monitor1 Recording State"
when
Item zmMonitor1_Recording changed
then
if (zmMonitor1_Recording.state == ON) {
logInfo("zoneminder.rules", "ZoneMinder recording started")
}
else if (zmMonitor1_Recording.state == OFF) {
logInfo("zoneminder.rules", "ZoneMinder recording stopped")
}
end
rule "Change Monitor1 Mode"
when
Item zmMonitor1_Mode changed
then
if (zmMonitor1_Mode.state==ON) {
zmMonitor1_Function.sendCommand("Modect")
zmMonitor1_Enabled.sendCommand(ON)
}
else {
zmMonitor1_Function.sendCommand("Monitor")
zmMonitor1_Enabled.sendCommand(OFF)
}
end
Sitemap configuration
sitemap zoneminder label="Zoneminder"
{
Frame {
Text item=zmServer_Online label="ZoneMinder Server [%s]" {
Frame {
Text item=zmServer_Online
Text item=zmServer_CpuLoad
Text item=zmServer_DiskUsage
}
}
Text item=zmMonitor1_Function label="(Monitor-1) [%s]" {
Frame {
Switch item=zmMonitor1_Enabled
Switch item=zmMonitor1_ForceAlarm
Text item=zmMonitor1_Online
Selection item=zmMonitor1_Function mappings=["None"=None, "Modect"=Modect, "Monitor"=Monitor, "Record"=Record, "Mocord"=Mocord, "Nodect"=Nodect]
Text item=zmMonitor1_EventState
Text item=zmMonitor1_Recording
Text item=zmMonitor1_DetailedStatus
Text item=zmMonitor1_EventCause
Text item=zmMonitor1_CaptureState
Text item=zmMonitor1_AnalysisState
Text item=zmMonitor1_FrameState
}
}
Frame label="Monitor Helpers" {
Switch item=zmMonitor1_Mode
}
}
}
Troubleshooting
Problem
Solution
Cannot connect to ZoneMinder Bridge
Check if you can logon to ZoneMinder from your openHAB server (with http).
Check that it is possible to establish a Telnet connection from openHAB server to Zoneminder Server
ZoneMinder Bridge is not comming ONLINE. It says: 'OFFLINE - COMMUNICATION_ERROR Cannot access ZoneMinder Server. Check provided usercredentials'
Check that the hostname is valid, if using a DNS name, make sure name is correct resolved. Also check that the given host can be accessed from a browser. Finally make sure to change the additional path from '/zm', if not using standard setup.
Cannot connect to ZoneMinder Bridge via HTTPS, using Letsencrypt certificate
Verify your Java version, if Java is below build 101, letsencrypt certificate isn't known by Java. Either use HTTP or upgrade Java to newest build. Please be aware that https support is provided as an experimental feature.
I have tried all of the above, it still doesn't work
Try to execute this from a commandline (on your openHAB server): curl -d "=XXXX&=YYYY&action=login&view=console" -c cookies.txt http:///zm/index.php. Change , and to the actual values. This will check if your server is accessible from the openHAB server.
