STUB ONLY, CODE IS IN SOURCE CONTROL, INSTRUCTIONS NEED TO BE COMPLETED.

Installation

Hardware Installation

The following section assumes you have a working Paradox Alarm Panel and have successfully connected, and configured, the Paradox Security PTR3 Printer Module.

Each of these devices comes with instructions for wiring and basic configuration. If you are not comfortable with this type of Wiring and configuration then contact your Alarm installer before proceeding.

Notes

• Configure the PTR3 Module Baud Rate

In Paradox EVO Alarm Panels this is Section [016] and in Spectra Alarm Panels this is Section [553] of the Alarm Panel configuration. The Baud Settings should be configured to 57600 Baud by setting both Options [2] & [3] to [ON]. You can use a lower Baud rate, but it will slow the communications between Vera and the Alarm Panel.

• Configure the PTR3 Module for Home Automation

In Paradox EVO Alarm Panels, this is Section [016], Option [4]. It should be set to [ON]

• Set any Zone Labels after you connect the PRT3 Module to the Combus

Only Zone Labels changed/modified after PRT3 is attached will be correctly recorded in the PRT3 Module. If you set the Zone Labels prior to connecting the PRT3, it'll only list "Default" Labels for each Zone. The Vera-Luup Alarm interface code will skip over these as if they're unused Zones. Please use the Alarm Panel's Reference and Installation manuals to determine how to setup your Zone Labels. If you've attached the PRT3 Module to an existing Alarm Panel, you can simply re-enter the Zone Labels to "trigger" it to get a copy of them.

• Attach Vera to the Paradox PRT3 Module using a USB Cable After attaching Vera to the Paradox PRT3 Module, navigate to the following pane in Vera: Toolbox >> MiOS Developers >> Serial Port configuration which should show settings similar to these You can now change the Baud rate to 57600, matching the Alarm Panel, and press (Save).

Software Installation

Initial Configuration

1. Download the ZIP file [http://www.box.net/shared/zhqhlumyna ParadoxSecurity.1.2.zip]
2. Expand the ZIP File to extract the 5x files, their names should be exactly as follows:
   • D_AlarmPartition1.xml
   • D_ParadoxSecurityEVO.xml
   • I_ParadoxSecurityEVO.xml
   • D_AlarmPartition1.json
   • S_AlarmPartition1.xml
3. Goto Toolbox --> MiOS Developers --> Luup files
4. Click the (Browse) buttons on the right, and enter the 5 filenames references above.
5. Select the checkbox "[x] Restart Luup after upload" and click (Go)
6. ... wait whilst it uploads and restarts the Lua engine ...
7. If successful, you'll see the 5x files listed in the System.
8. Navigate to the Create device tab.
9. Type for UpnpDevFilename type "D_ParadoxSecurityEVO.xml", for Description type "Paradox Alarm Panel", for UpnpImplFilename type "I_ParadoxSecurityEVO.xml" and click (Create Device)
10. Exit the MiOS Developers Dialog and click (Save).
11. For the lines that follow, we'll assume that you named the device Paradox Alarm Panel but you can call it anything.
12. Goto Toolbox --> MiOS Developers --> (Serial Port configuration)
13. Select the Paradox Alarm Panel [...] value for the Used by device: picklist then click (Save).

The Alarm Panel Plugin code will now read configuration data from the Alarm Panel, such as the number of Areas, Zones and Users. Once complete, Vera will present you with a list of these Alarm Panel Zones in the "unassigned" Devices area. You can Assign the Alarm Panel's Zones to ​Rooms within Vera, and then (Save) at the end to ensure these settings are persisted.

Validating the Configuration

This section not intentionally left blank, it's just not finished yet :)

Advanced Configuration

There are a number of advanced options that can be setup after performing the initial configuration, and validating it's working correctly. These are exposed through Variables listed under:

Your Room --> Paradox Alarm Panel --> [Wrench/Spanner?] --> Advanced

maxAlarmZones (number, default 24)

The number of Zones that the Alarm Panel Plugin should scan during startup. Depending upon the Alarm panel model, it can support 48, 96, or 192 Zones. Each takes some time to scan. To speed startup, set this parameter to the number of Zones installed within your particular System.

maxAlarmPartitions (number, default 1)

The number of Areas/Partitions? that the Alarm Panel Plugin should scan during startup. The Alarm Panel typically supports 4 or more Areas/Partitions? but most houses use only one, or maybe 2, of these Partitions. The Alarm Panel Plugin defaults to loading 1 Partition. This parameter may be used to increase the number of Partitions configured into Vera if you have more in your installation.

maxUserCodes (number, default 5)

The number of User codes registered with the Alarm Panel. The Alarm Panel may support 96, 192 or more Users and reducing this parameter decreases the startup time of the Plugin. At this time, only logging messages use the User strings but future functionality may permit Scene events based upon User descriptions retrieved by this parameter.

enableVirtualInputs (boolean, default false)

Enable the Alarm Panel's Virtual Inputs to be represented within Vera's UI. Intended for people that use the Paradox Alarm Panel Virtual input functionality.

maxVirtualInputs (number, default 5, if enableVirtualInputs is set)

If enableVirtualInputs is set, this parameter determines how many Virtual Inputs need to be established within Vera (up to the Max# of Virtual inputs of the Paradox Alarm Panel)

enableRemoteArm (string, default false)

Enable the use of Stay Arm (stay), Stay and Regular Arm (arm) or Stay, Regular and Disarm (disarm) functionality within the Plugin.

CAUTION: Use of the enableRemoteArm parameter may constitute a Security risk. Use at your own risk.

Scenes

The Plugin supports participation in Scenes, by generating Events and accepting/processing Actions.

Events

Each Alarm Partition is exposed as a !AlarmPartition1, and has the following scene capabilities Example Alarm Partition Scene

• Partition is Armed
• Partition is Stay-Armed
• Partition is Breached
• Partition is Disarmed

Each Alarm Zone is exposed a standard !MotionSensor1, and has the following standard Motion Sensor scene capabilities Example Alarm Zone Scene

• A sensor (door/window/motion/etc.) is tripped

Actions

Each Alarm Partition is exposed as a !AlarmPartition1, and has the following Actions (if Enabled) Example Alarm Partition Action

• RequestArm - Submit a request to Arm the Alarm Partition (with PINCode)
• RequestQuickArm - Submit a request to Quick, or "OneTouch", Arm the Alarm Partition (no PINCode required)
• RequestStay - Submit a request to Stay-Arm the Alarm Partition (with PINCode)
• RequestQuickStay - Submit a request to Quick, or "OneTouch", Stay-Arm the Alarm Partition (no PINCode required)
• RequestDisarm - Submit a request to Disarm the Alarm Partition (PINCode required)
• SetVirtualInput - Set one of the [16] Virtual Inputs on the Alarm Panel to Open (0) or Closed (1)

Scripting

... some Luup scripting please...

Errors

The Paradox Alarm Plugin unconditionally logs all Alarm Panel events in Vera's log file. These events have been translated into their English equivalent from the internal codes that the Alarm Panel uses.

Examples include:

01 ... luup_log:nn: 001:Zone is Open, 015:Motion Upstairs (Zone 15), 001:Area 1
01 ... luup_log:nn: 000:Zone is OK, 015:Motion Upstairs (Zone 15), 001:Area 1
01 ... luup_log:nn: 014:Disarm with User Code, 002:User Code 2, 001:Area 1
01 ... luup_log:nn: 064:Status 1, 000:Armed, 001:Area 1
01 ... luup_log:nn: 009:Arming with Master, 001:User Code 1, 001:Area 1
01 ... luup_log:nn: 004:Non-reportable Event, 007:Remote control access, 000:Occurs in all areas enabled in the system