ADT tools 2

The Unofficial SmartThings Blog
Jump to: navigation, search

ADT Tools is a smart app that enables some functions that are not enabled by the native ADT app functionality to improve Smartthings integration.

The ADT Tools suite consists of the parent ADT Tools parent app and 2 child apps and one device handler. These apps will allow you to:

1. Create and send custom messages when the alarm changes between alarm states or an alarm is triggered

2. Trigger Smart things to do some activity when a ADT Alarm event takes place based on individual sensors

3. Trigger a remote siren, turn on, or flash lights, and trigger cameras to record when a ADT Alarm event occurs all of which are configured independently

4. Automatically turn off siren when alarm is cleared.

5. Change alarm modes using conigured Button tiles.

6. Maintain hub alarm status to be in sync with the ADT Alarm system.

7. Allow use of any non ADT contact and motion sensor to be used to trigger a alert event based on the alarm status. These events can trigger the same actions except for contacting ADT and triggering the internal alarm.

There are a few key things that make these tools work. Frist you must have an ADT SmartThings pannel and sensors. Other then the "ADT Change Mode" and "ADT Alert Any Sensor" Child programs all of the smart apps depend on matching events with ADT Sensors. The ADT Change Mode app depends on you have a ADT Security panel. Only sensors setup with the ADT Alert Any Sensor will allow you to trigger alerts or alarm messages that will not communicate with ADT.

How do you get ADT Tools

You can get ADT Tools two ways

You can link your Smartthings IDE Account to Owner: Mavrrick Name: ADT-Tools-2 Branch: master

Donwload the ADT Tools 2 Parent app and publish to your IDE account Download the remaining child apps to your IDE.(You do not need to publish them) Download the ADT Tools Button device handler

The child apps are, "ADT Alert Action", "ADT Home-Life Alert Action"

You can also go to [1] and install the parent app and the 2 child apps

How to setup ADT Tools once installed

You have a few questions to ask. Do you want to have ADT Tools create Virtual buttons for it to use? Do you want to use custom messages for alarm mode changes? Do you want to manage alarm modes from Smartthings?

Start the install by opening the Classic App and going to "Automation" page and the "SmartApp" tab. Scroll to bottom and click on "+ Add a Smartapp". Select "ADT Tools 2". Now how you answered the questions above will determine what you do next.

You want to ADT Tools to create it's virtual buttons

This will only be needed if you want either don't have virtual buttons already created or if you simply what ADT Tools to create them. This is optional

1. Because the buttons will be used by the mode change component they will need to be created first.

2. Select the "ADT Smartthings Alarm Mode Change" section. A new page will display.

3. Place a valid number in the Alarm Delay field between 1 and 120.

4. Click on the option to select your ADT Panel and select the panel that displays.

5. Select the option to return to the ADT Tools Main Menu

6. Select the "Optional Setup Steps" section

7. Select the switch on the right to tell ADT Tools to turn on the button creation

8. Click on the option to return to the ADT Tools Main Menu.

9. Click on Save and you should leave the app, it will now be in your list of applications. Open the application settings again.

10. Go back to the Optional Setup Steps and turn the switch to off. Follow steps 8 and 9 again to save the application.

ADT Tools is now installed and you should have virtual buttons created by ADT Tools.

Custom Messages for mode changes from ADT Tools 2

If you want to create message notifications from Smartthings when the the ADT Smartthings panel changes between Alarm Modes

1. Enter app to make configuration changes

2. Click on top section for ADT Mode Change Notifications.

3. Enter messages for each alarm state change that would want to send.

4. Enter a phone number if you want to send a text message(optional)

5. Specify if you want to use "Push Notifications"

6. Select the option to return to the ADT Tools Main Menu and click on save.

ADT Panel Mode management from ADT Tools and Smartthings

1. Enter app to make configuration changes

2. Click on "ADT Smarttings Alarm Mode Change Integration" secton

3. Associated a button with each alarm mode setup option. These should either be buttons you already have setup or those setup when the app was initially installed if you had ADT Tools create the virtual buttons.

4. If you have a need to use non ADT dual Branded sensors you will need to keep the location Alarm mode in sync with the ADT Panel Select the Switch to turn it on for this functionality

5. Specify a good Alarm delay for non ADT Sensors to use before they activate and enter the value.

6. If not already done select your ADT Alarm panel.

7. Click on return to ADT Tools Main Menu.

8. Click on Save.

Integrated Alert Actions

The Alert Action Child apps let you use alarm actions to trigger activities. They are split into two kinds of alarms: Security Alert Actions and Home/Life Alert Actions.

Security Alert apps will handle all security functions while the Home/Life Alert actions will handle things such as Water, Smoke and CO2 alerts that are life threatening

1. Enter application setup.

2. Click on "Integration Alert Actions" in the Alert Apps Sections

3. Select the application type you want to install. Security Alert Action Apps or Home/Life Alert Action Apps

4. Specify a name for the Alert Action

5. Specify if you are using ADT Dual Branded sensors or not.

6. Follow remaining prompts to complete the install of the alert action.

7. Click on save

Associated Device Handlers

There is only one custom device handler associated with ADT Tools. The "ADT Button Tile" was created to allow usage of a momentary button tile in both the old and new Smartthings applications. Follow the below steps in the Smartthings IDE.

1. In the IDE navigate to the "My Device Handlers" tab download the DTH from the Github repo. If you are not using the Smartthings integration to retrieve from github you can get the DTH from [2]

2. Navigate to the "My Devices" tab and click on the "+ New Device" button in the upper right corner.

3. Populate the required fields and remember to specifiy the "ADT Button Tile" for the device type.

Things to keep in mind

1. The Alert apps are setup so you can install multiple of the same apps. This can allow you to be granular as to what kind of reaction you want to different scenarios.

2. The Alert apps are setup to allow use of ADT Dual Branded and standard Z-wave Zigbee sensors. This is controlled by the switch you select when setting up the alert apps. Non dual branded sensors would not notify ADT, these apps will not change that. The logic in the SmartApps actually functions from matching the alerts from the Alarm to the sensor themselves. This would mean Non ADT sensors would never be recieved the by the smart app

3. The ADT Mode change functions similar to WEBCORE. As such it is believed that ADT could at any point block the functionality. Until such a time occurs enjoy the app, but be aware.

4. Be cautious using the ability to control the ADT Mode from Smartthings. This is a powerful function to allow you to trigger activity to the alarm to change state, but reliability could be difficult depending on your other components. This is the fundamental reason for why using smarthtings to create actions to the alarm is a bit of a worrisome idea. I used a standard presence routine yesterday to arm while away and my system armed while i was sitting 15 feet away in the next room. Be careful and test if you use this

5. Momentary button used for ADT Mode change can be used in Action Tiles

6. Because these are custom apps, these all function within the Smartthings cloud, so remember that when concerned about reliability. As a general rule using the ADT Branded components and software is always best from a reliability perspective as they run locally.

Use Cases

You are a SHM User

You are a long time user of SHM and don't want to replace all of your existing sensors to use the ADT System and not worried about ADT Monitoring.

1. Install ADT Tools 2 and do the setup to maintain states between ADT and HUB(SHM) Alarm state.

2. Setup the Security Alert app and Home/Life alert app turning off the flag for ADT Sensors for each zone/sensor/group as you wish to manage

Weather you have Smart Home Monitor still on your location or not this will allow you to function with the same self monitoring options. All of your sensors can be setup and grouped however you like per the ADT Alert Any Sensor child app with multiple installs.

TIP: Don't forget to setup a custom message for each Alert action app configuration. You can get a unique message for each instance

Large Home with need for more sirens to cover house

You have a very large home and the siren is not sufficient for your home.

1. Install ADT Tools and setup Alert Apps using the needed sensors. When setting up Alert apps select additional external alarm devices (ie. dome Sirens) through your home.

Now any time an alarm is triggered multiple sirens through the home will be triggered to ensure complete coverage.

TIP: This also applies to flashing and turning on lights.

You want to run routines or use 3rd party apps with your alarm

You have paid for Action Tiles and want to be able to change your alarm state from tablets mounted in your home.

1. Perform initial install of ADT Tools 2 allowing the app to build it's virtual buttons.

2. Setup ADT Smartthings Alarm Mode Change integration with each virtual button to assigned to a alarm mode.

3. Setup Actions Tiles to present your virtual buttons on a tile set and setup security on disarm button.

4. You may also want to setup the SHM Tile. Rename it ADT alarm status and set it to just be read only. If you have the mode change app set to keep the Location status in sync this will show you the current state of the alarm from action tiles.

The momentary buttons will now allow you to change the ADT alarm mode from smart things. They are also visible to external services, smartapps and automatons. You can take this even a step further create a routine to Arm and Disarm the alarm based on your location