Honeywell Total Connect 2 Security Plugin — Information

Posted on
Sun Nov 12, 2017 7:48 pm
gregss offline
Posts: 83
Joined: Sep 21, 2006
Location: Atlanta, GA

Honeywell Total Connect 2 Security Plugin — Information

About the Honeywell TC2 Security Plugin
This plugin adds support for interfacing with Honeywell security panels connected via the Total Connect 2 monitoring service, such as the Honeywell Lyric security panel. Because of the way that Honeywell's service and APIs are set up, this plugin polls for status periodically — the default is every 10 minutes, but this can be configured in the plugin settings.

The plugin adds a new Alarm Keypad device type, which will take on any of the following states:
  • Disarmed
  • Armed-Away
  • Armed-Stay
  • Armed-Night
  • Arming (temporarily, while arming — the plugin will re-check status every 30 seconds during this time)
  • Disarming (temporarily, while disarming — the plugin will re-check status every 30 seconds during this time)

The Alarm Keypad device also has states for tracking a binary arming status (isArmed), and whether zones were bypassed (isBypass). You can set up triggers for state changes to detect changes in status. There are several actions for an Alarm Keypad to arm (using any supported arming type) or disarm the panel, as well as to force a status update.

Installation Requirements
The following are required for the plugin to work correctly:
  • You must be running macOS 10.13 (High Sierra) or newer. This is required, because earlier versions of macOS don't support TLS version 1.1/1.2 connections in the versions of Python and OpenSSL installed by the operating system. Honeywell requires newer TLS security standards when connecting to Total Connect 2. NOTE: It is recommended that you carefully review the High Sierra compatibility announcements before upgrading. Indigo runs fine for me under 10.13.1, but install at your own risk, and only with a backup.
  • You must be running Indigo version 7 or newer, which is required to take advantage of the newer Python version.
  • You must install the deep Python library (see below).

To install Zeep:
  1. Open Terminal.
  2. Type the following, followed by Enter:
    Code: Select all
    sudo easy_install zeep
  3. Type your password, then Enter.
The installation will complete automatically.

Download
The latest version of the plugin can be downloaded from GitHub. Click on Clone or download on the right side, then Download ZIP.
If you'd like to be emailed when the plugin is updated, please subscribe to this topic.

Installation and Set-Up
Install and configure the plugin
  1. Download the plugin from the link above, and un-zip the archive if necessary.
  2. Double-click on the Honeywell TC2 Security.indigoPlugin file, Indigo should launch and ask if you'd like it to install the plugin.
  3. The plugin's config screen should pop up.
    Config.png
    Config.png (29.44 KiB) Viewed 176 times
  4. Type your Total Connect user name in Web access user name. It is recommended that you create a new Standard user for Indigo's exclusive use. This user must have access to your panel, with a user code assigned and synchronized. See instructions here.
  5. Type your Total Connect password in Web access password.
  6. Click Save.
Create an Alarm Keypad
  1. Create one Alarm Keypad device. This device tracks the arming status of your physical security panel. It's also the device you use to arm/disarm the alarm.
    New Alarm Keypad.png
    New Alarm Keypad.png (40.41 KiB) Viewed 176 times
  2. Configure the keypad by selecting the Total Connect location corresponding to your primary security panel.
    Configure Alarm Keypad.png
    Configure Alarm Keypad.png (18.05 KiB) Viewed 176 times

Usage
If you'd like Indigo to detect changes to the security panel status more quickly, you should not repeatedly use the Update Status action. This may result in Honeywell restricting your access. Rather, set up notifications sent to an email address that Indigo can check for updates — I run mine every minute. Then, set up triggers when emails are received with any of these in the subject line:
  • Armed Away
  • Armed Custom
  • Armed Stay
  • Disarmed
Then, issue an Update Status action to any panel(s) connected.

You can establish triggers based on changes to a keypad state.

Also, you can set up arm/disarm actions.

Credits
Many thanks to Craig J. Ward, whose Python-based Total Connect Client for another automation system was the initial inspiration and basis for this plugin.

Posted on
Fri Dec 08, 2017 2:32 pm
mssearch offline
Posts: 17
Joined: Mar 27, 2016

Re: Honeywell Total Connect 2 Security Plugin — Information

Hey, this is really cool. I've been spending ages looking for my HomeAutomation Holy Grail and as a part of that search I recently ordered a Honeywell Lyric Controller since they officially announced HomeKit support which may finally allow me to get a few of my desired setups working reliably.

Of course once I replace my Vista 20P with the Lyric I was thinking I'd be stuck without anything in Indigo but maybe that isn't the case now? Curious what your setup looks like and how TotalConnect fits into your overall home automation setup. Also wondering if you made any attempts to create a local connection? Not sure if you also have the Lyric Controller as but from what I can see their app allows local connection as well.

Thanks for putting the time into creating something to share with the community! I look forward to checking it out once my Lyric arrives and I get everything configured for TotalConnect. :)

Page 1 of 1

Who is online

Users browsing this forum: No registered users and 1 guest