Total Connect

The totalconnect integration provides connectivity with Resideo Total Connect 2.0-enabled alarm systems.

Prerequisites

Log in to the Total Connect website and create a “standard” Total Connect user account specifically for use with Home Assistant. It should not have full administrative privileges.

Give the user access to your Location, along with a user code, usually a 4 digit number.

Configuration

To add the Total Connect integration to your Home Assistant instance, use this My button:

Configuration Options

Auto Bypass Low Battery: if enabled, TotalConnect zones will immediately be bypassed when they report low battery. This option helps because zones tend to report low battery in the middle of the night. The downside of this option is that when the alarm system is armed, the bypassed zone will not be monitored.

Require Code: if enabled, you must enter the user code to disarm the alarm.

Automation example

automation:
  - alias: "Alarm: Disarmed Daytime"
    triggers:
      - trigger: state
        entity_id: alarm_control_panel.total_connect
        to: "disarmed"
    conditions:
      - condition: sun
        before: sunset
    actions:
      - action: scene.turn_on
        target:
          entity_id: scene.on_disarmed_day_time

  - alias: "Alarm: Armed Away"
    triggers:
      - trigger: state
        entity_id: alarm_control_panel.total_connect
        to: "armed_away"
    actions:
      - action: scene.turn_on
        target:
          entity_id: scene.on_armed_away

  - alias: "Alarm: Arm Home Instant at Sunset"
    triggers:
      - trigger: sun
        event: sunset
        offset: 0
    actions:
      - action: totalconnect.arm_home_instant
        target:
          entity_id: alarm_control_panel.total_connect

sudo apt install libxml2-dev libxmlsec1-dev

Alarm control panel

The integration provides an alarm control panel for each Total Connect location. It uses the name of your location from Total Connect. For example, if your location name in Total Connect is “Home”, Home Assistant will use alarm_control_panel.home.

The alarm control panel supports the following actions: alarm_arm_away, alarm_arm_home, alarm_arm_night, and alarm_disarm. The integration also provides unique actions for totalconnect.arm_home_instant and totalconnect.arm_away_instant which arms the system with zero entry delay, triggering the alarm instantly if an entry/exit zone is faulted.

The triggered state also provides a state attribute called triggered_source giving more detail on what triggered the alarm:

• Police/Medical is when sensors detected a burglar and/or the Police or Medical button was pressed
• Fire/Smoke is when fire or smoke is detected, and/or the Fire button was pressed
• Carbon Monoxide is when carbon monoxide is detected

Binary sensor

The integration provides a binary sensor for each Total Connect zone. To see faulted zones in Home Assistant, your Total Connect account must have “Sensor Activities” enabled. Your alarm monitoring company may charge an extra fee to enable this. If available, these can be found in the Total Connect 2 web portal at Notifications -> Sensor Activities. Alternately, they can be found in the Total Connect mobile app at More -> Settings -> Notifications -> Sensor Activities. Enable each zone you want to monitor. Unmonitored zones will display as Closed in Home Assistant.

The Total Connect API has limited zone type information. Home Assistant device class door is assigned to Total Connect entry/exit, perimeter, and motion zones; along with most alarm panel buttons. The sensor will appear as True if the zone is opened (either fault or triggered in Total Connect) and False if closed. Device class smoke is assigned to Total Connect smoke detectors and alarm panel buttons set to a “Fire No Verification” response type. The sensor will appear as True if smoke is detected or the respective button is pressed. Device class gas is assigned to Total Connect carbon monoxide detectors. The sensor will appear as True if carbon monoxide is detected.

Buttons

The integration provides a bypass button for each zone that can be bypassed. The Bypass All button for the alarm panel will bypass all faulted or troubled zones. The Clear Bypass button for the alarm panel will clear all bypassed zones.

Diagnostic Sensors

The following diagnostic sensors are available:

• Low Battery for Zones and Alarm Panels will be On if the battery is low.
• Tamper for Zones and Alarm Panels will be On if in a tampered state.
• Power for Alarm Panels will be On if main power is connected or Off if running on the backup battery.