Paradox IP150-MQTTv2

Python-based IP150 'middle-ware' that uses the IP module's software port for monitoring and control of the alarm via an MQTT Broker.

The script was designed to be extendable to support more alarm types. See the ParadoxMap.py file for details. If you want to do some tcp dump of your alarm model to add into there, get Paradox's Winload software. Then within it's root folder find a file called COM.ini and change the 'IPEncrypted' setting to FALSE. You can then use WireShark (or equivalent) to trap whatever commands/replies you want to and either extend the ParadoxMap.py's existing dictionaries or add in a complete new Class for another alarm type.

NB: This is still a very early release and has its bugs. Feel free to submit a PR, any help is appreciated, even if its for my bad grammer/spelling!

Confirmed supported systems: See the wiki (please let me know if yours work, or not)

Steps to use it:

1. Tested with Python 2.7.10 & Mosquitto MQTT Broker
2. Download the files in this repository and place it in some directory
3. Edit the config.ini file to match your setup
4. Run the script: Python IP150-MQTTv2.py

What happens in the background:

The main script will connect to you IP module's software port (usually port 10000) and login with your password. It will then use two seperate classes (containing dictionaries) referenced in from the ParadoxMap.py file to extract different info from the alarm and translate events into meaningfull text. The dictionaries currently supports the MG5050 V4 firmware but could evolve over time if the community adds more alarm types to the dictionaries.

Once the info (mostly labels) has been extracted from the alarm, the MQTT broker is used as middleware between your application and the alarm panel.

Seeing as not all alarm variants are initially supported, you can use the config.ini file to switch off different portions of the script. You can also choose to only get events in their numeric form if you have the correct programming guide for your alarm detailing the event types. I would prefer it though if you can do a PR to update the ParadoxMap.py file with new entries for supported alarms or altogether new class dictionaries for other alarm variants.

What to expect:

Labels

If successfully connected to your IP150 and MQTT broker, the app will optionally start off by publishing (once-off) all the detected labels (zone, partition, output, etc. names) to your broker. Both the reading of label names and publishing thereof can be independantly controlled through the config.ini file. If you do read the labels, events such as "Zone open - Zone number 3" will translate to "Zone open - Garage door" or "Low battery on zone - Zone 1" to "Low battery on zone - Alley Beam" (assuming this is named/configured as such in your alarm).

• Zone Labels:
  • Topic: Paradox/Labels/Zones
  • Payload (example): 1:Front PIR;2:Back PIR;3:Garage Door;...
• Output Labels:
  • Topic: Paradox/Labels/Outputs
  • Payload (example): 1:Status LED;2:ToggleGarage;3:UnlockFront;4:MakeCoffee;5:Output 05;6:Output 06;...
• Partition Labels:
  • Topic: Paradox/Labels/Partitions
  • Payload (example): 1:Main Alarm;2:Front Beams
• User Labels:
  • Topic: Paradox/Labels/Users
  • Payload (example): 1:System Master;2:Master 1;3:Master 2;4:Bob;5:Alice;6:User 06;...
• Bus Module Labels:
  • Topic: Paradox/Labels/BusModules
  • Payload (example): 1:ZX8-1;2:Bus Module 02;3:Bus Module 03;4:Bus Module 04;5:Bus Module 05;...
• Wireless Repeater Labels:
  • Topic: Paradox/Labels/WirelessRepeaters
  • Payload (example): 1:Front Rpt;2:Repeater 2
• Wireless Keypad Labels:
  • Topic: Paradox/Labels/WirelessKeypads
  • Payload (example): 1:Main Keyp;2:Garage Keyp;3:Wireless Keyp 3;...
• Wireless Siren Labels:
  • Topic: Paradox/Labels/WirelessSirens
  • Payload (example): 1:Wireless Siren 1;2:Wireless Siren 2;3:Wireless Siren 3;4:Wireless Siren 4
• Site Name Labels:
  • Topic: Paradox/Labels/SiteNames
  • Payload (example): 1:Your Alarm Site

Events

Once the script has settled to listen for events, the following topics are available (and their names are also configurable in the config.ini file):

• Events:
  • Topic: Paradox/Events
    • Payload (example): Event:Zone OK;SubEvent:Braaikamer PIR
    • Payload (example): Event:Zone open;SubEvent:Braaikamer PIR
    • Payload (example): Event:Partition status;SubEvent:Disarm partition
    • Payload (example): Event:Zone forced;SubEvent:Back Door
    • Payload (example): Event:Disarming with user;SubEvent:User 06
    • Payload (example): Event:Non-reportable event;SubEvent:Arm in sleep mode
    • etc.....

Controls

• Controlling the alarm or outputs
  • Publish the following topic to control the alarm:
    • Paradox/C/P1/Disarm
    • (C = Control; P = Partition, followed by number; Then the action = Disarm / Arm / Sleep / Stay)
    • The payload is not evaluated in this case. Note that alarm controls can take a few seconds as the script must first be re-authenticated
    • Paradox/C/P1, Payload: Disarm
    • In this case the payload is used to determine the command to send.
  • Publish the following topic to control (Force/Pulse) an output (PGM):
    • Paradox/C/FO/4/Off
    • (C = Control; FO = Force output / PO = Pulse Output, followed by the output number; Then the action (for pulse this will be the intermediate state, e.g. to pulse High then back to Low use "On" and vice versa).
    • The payload is not evaluated in this case. Note that output controls can take a few seconds as the script must first be re-authenticated
    • Pulse outputs are configured for approx. 0.5sec.
    • Paradox/C/PO/1, Payload: On
    • In this case the payload is used to determine the command to send: Pulse Output 1, On->Off
• Controlling this application
  • Publish the following topics to enable/disable polling of the IP module:
    • Paradox/C/Polling/Enable
    • Paradox/C/Polling/Disable
    • The payload is not evaluated.
    • This command can be useful if the script was unable to correctly detect labels or you want it to re-scan them. Then simply disable and re-enable polling which will update the labels (if your config.ini file is configured for this).

Note: If you modified the subscription topic for controls in the config.ini file ensure it ends with a '/'.

Script State

• The current state of the script is linked to a topic found in the config file. Examples:
• Topic Paradox/State
• Payload (example): State Machine 1, Connected to MQTT Broker
• Payload (example): State Machine 2, Connecting to IP Module...
• Payload (example): State Machine 2, Connected to IP Module, unlocking...
• Payload (example): State Machine 2, Logged into IP Module successfully
• Payload (example): State Machine 3, Reading labels from alarm
• Payload (example): State Machine 4, Listening for events...
• Payload (example): Output: Forcing PGM 1 to state: On

Running as a service / daemon

On Mac

( thanks @Rtaxerxes )

If you want to run this as a daemon on Mac,

1. Create a file called local.paradox.plist.
2. Copy and paste the below into the file, editing for the location of your files.
3. Copy the file to /Library/LaunchDaemons/.
4. Run it with: sudo launchctl load /Library/LaunchDaemons/local.paradox.plist
5. Stop it with: sudo launchctl unload /Library/LaunchDaemons/local.paradox.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Label</key>
            <string>local.paradox</string>
        <key>WorkingDirectory</key>
            <string>/(folder where files are)</string>
        <key>ProgramArguments</key>
        <array>
            <string>/usr/bin/python</string>
            <string>/(folder where files are)/IP150-MQTT.py</string>
        </array>
        <key>RunAtLoad</key>
            <true/>
    </dict>
</plist>

On Debian Jessie using systemd

(see: http://www.raspberrypi-spy.co.uk/2015/10/how-to-autorun-a-python-script-on-boot-using-systemd/)

1. Create a file called IP150-MQTTv2.service in this directore: \lib\systemd\system => sudo nano \lib\systemd\system\IP150-MQTTv2.service
2. Type the code below into this file, adapting it for where you placed the python script (in this case in /opt/ParadoxIP150v2)
3. Ensure you change the working directory, otherwise depedencies will fail.
4. You can now start/stop the service with => sudo systemctl start IP150-MQTTv2.service / sudo systemctl stop IP150-MQTTv2.service
5. To run the new service upon startup, send the following commands: sudo systemctl daemon-reload && sudo systemctl enable IP150-MQTTv2.service
6. To see the status of the service run => sudo systemctl status IP150-MQTTv2.service

Content of IP150-MQTTv2.service file:

[Unit]
Description=My Script Service
After=multi-user.target

[Service]
Type=idle
ExecStart=/usr/bin/python /opt/ParadoxIP150v2/IP150-MQTTv2.py
WorkingDirectory=/opt/ParadoxIP150v2

[Install]
WantedBy=multi-user.target