ADT tools 2

The Unofficial SmartThings Blog
Jump to navigation Jump to 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 configured buttons.

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", and "ADT Panic Alert Action".

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

One word caution

ADT Tools 2 depending on configuration use a value associated with your location called "Alarm System Status". This is only created after you install Smart Home Monitor on the location. SHM does not need to remain installed though. Not having the value will effectively break the integration for Non ADT Sensor alerts and functionality that needs that value kept in sync. If you have never installed SHM on your location in Smartthings leave the option off to keep location alarm status in sync in the Mode change connfiguration settings and only use Dual branded sensors with ADT Tools.

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 Smartthings Classic App and going to "Automation" page and the "SmartApp" tab. Scroll to bottom and click on "+ Add a Smartapp". Select "ADT Tools 2". Immediately click on "Save" in the upper right corner. You will go back to the smartapp selection screen. The app is installed and now ready to be setup.

Now how you answered the questions above will determine what you do next.

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

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

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

1. Open the ADT Tools 2 Smartapp.

2. Select the "Optional Setup Steps" section.

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

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

5. Click on Save.

6. Open the Smart app and follow steps 2-5 again, but turn the switch off for button creation.

7. You now should have 3 new buttons created under your devices.

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 Smartthings Panel Mode management from ADT Tools

1. Enter app to make configuration changes

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

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 three kinds of alarms: Security Alert Actions, Home/Life Alert Actions, and Panic Alert Actions.

Security Alert apps will handle all security functions. The Home/Life Alert app actions will handle things such as Water, Smoke and CO2 alerts that are life threatening. The Panic Alert Action app will help provide actions with the various panic options are taking from either a keyfob, or the ADT Security panel directly.


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 specify 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 received 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. It has also been discovered that when internet access is recovered after a loss that mobile presence sensors will momentarily revert back to being home, and then a little bit later recover their proper state. This means routines that are setup to trigger on both of those actions could be initiated and for a time leave your home unprotected until the Arm Routine kicks back in. ADT Tools would notify you of the alarm mode changes, but they would still happen

5. Momentary button used for ADT Mode change can be used in Action Tiles, Routines, and pretty much anything that uses switches or a push button.

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

You need secondary Keypad

You have the main ADT panel in one room but want to be able to change the state by keypad from a secondary location. This can be accomplished with a Zigbee keypad like the Iris keypad from Lowes and by using a secondary Smartapp called Lock Manager.

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 routines for each alarm mode that will push the Virtual button configured in step 2.

4. Setup Lock manager and assign the Keypad to call the routines in step 3 for each alarm mode as described in Lock Manager.

Additional Useful Smartapps

Arlo Pilot

Smartthings Community Release Thread

Originally written by Steve White

Original repo Github Repository

Owner: shackrat
Name: SmartThings-by-Shackrat
Branch: master

ADT Tools 2 Fork Github Repository

Owner: Mavrrick
Name: SmartThings-by-Shackrat
Branch: master

This fork has been updated to allow the ADT Panel to trigger the same actions as SHM. You can use this fork with the ADT Panel to allow the ADT Panel Mode changes to trigger different Arlo Modes

Lock Manager

Smartthings Community Release Thread

Originally written by Eric Thayer

Original repo https://github.com/ethayer/lock-manager Github Repository

Owner: ethayer
Name: lock-manager
Branch: beta-2

ADT Tools 2 Fork https://github.com/Mavrrick/lock-manager Github Repository

Owner: Mavrrick
Name: lock-manager
Branch: beta-2

These forks have been updated to allow the Keypad functionality to directly interact with the ADT Alarm panel. You can use secondary Z-Wave or Zigbee keypads (ie Iris Keypad) at remote locations to check the alarm status and change modes as if you were right at the ADT Alarm Panel

Lock User Management (LUM)

Smartthings Release Topic

Written by RBoy Apps

Source RBoy Apps Website

This app allows the Keypad functionality to directly interact with the ADT Alarm panel using the ADT Control option under Lock/Unlock actions. You can use secondary Z-Wave or Zigbee keypads (ie Iris v2-v3/Centralite/Xfinity/UEI Keypads) at remote locations to check the alarm status and change modes as if you were right at the ADT Alarm Panel.