This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# Digiplex/EVO Binding
This binding provides integration with Digiplex/EVO alarm systems from Paradox (opens new window). It utilizes PRT3 module (opens new window) for serial communication.
# Supported Things
# PRT3 Module
Before the binding can be used, a serial adapter must be added manually. Select PRT3 Module
and enter serial port parameters.
Please refer to PRT3 module manual for instructions how to modify baudrate (default setting is 2400)
# Discovery
Once PRT3 Module
is added and communication with the alarm system confirmed by its online
status, please start discovery process to automatically discover (and add as new Things) all zones and areas defined in the alarm system.
# Binding Configuration
There is no binding level configuration required.
# Thing Configuration
# PRT3 Module Configuration
The following section lists the PRT3 Module configuration. If using manual configuration in text files, the parameter names are given in the square brackets.
# Serial Port [port]
Sets the serial port name for the communication with the alarm system
# Baud Rate [baudrate]
Baud rate to use for serial port communication
# Area configuration
# Refresh time of area status (in seconds) [refreshPeriod]
Controls how often area status is refreshed from the alarm system.
# Channels
# PTR3 Module Channels
The table below summarizes all the channels available from the PTR3 Module
thing.
Channel | Description |
---|---|
messages_sent | Counts the number of messages sent to the module |
responses_received | Counts the number of responses received from the module |
events_received | Counts the number of events received from the module |
# Zone Channels
The table below summarizes all the channels available from the zone
thing.
Channel | Description |
---|---|
status | Simple zone status (open/closed) |
extended_status | Extended zone status as a String (Open/Closed/Tampered/Fire Loop Alarm) |
alarm | Information whether zone is in alarm (open/closed) |
fire_alarm | Same as above for fire alarm |
supervision_lost | Information whether supervision has been lost (open/closed) |
low_battery | Low battery warning (open/closed) |
# Area Channels
The table below summarizes all the channels available from the area
thing.
Channel | Description |
---|---|
status | Area status available as a String |
armed | Simple (open/closed) information whether zone is armed |
zone_in_memory | Information whether there are zones in the memory (after alarm has been triggered |
trouble | Information whether some of the zones are in 'trouble' (malfunctioning) |
ready | Information whether area is ready (no open zones) |
in_programming | Checks for programming mode enabled |
alarm | Information whether area is in alarm |
strobe | Information whether area is in strobe alarm |
control | Channel for controlling area |
User is able to send commands through control
channel to arm/quick arm/disarm the zone.
Every sent message is followed by the channel state change to either Ok
or Failed
depending whether command has been accepted by the alarm system.
Note that PRT3 module is capable of handling more kinds of messages, but those are not yet supported by this binding.
Message format is as follows:
Command | String sent to the control channel |
---|---|
Regular Arm | AA<pin> |
Force Arm | AF<pin> |
Stay Arm | AS<pin> |
Instant Arm | AI<pin> |
Regular Quick Arm | QA |
Force Quick Arm | QF |
Stay Quick Arm | QS |
Instant Quick Arm | QI |
Disarm | D<pin> |
<pin>
is your PIN as entered on a keypad.
Note: For security reasons please consider not storing your PIN in openHAB configuration files.
Note2: Please consult your alarm system manual how to enable Quick Arm
feature. It is not enabled by default.
For example, the following sitemap item can be used to send commands to the area and receive response status as modified color of a label:
Switch item=areaControl label="Actions[]" mappings=[QA="Regular Quick Arm",QS="Stay Quick Arm",D1111="Disarm"] labelcolor=[Ok="green",Fail="red"]