ADT tools

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 7 child apps. These apps will allow you to:

1. Create and send custom messages when the alarm changes between alarm states

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 virtual Momentary 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: SmartThings-by-Mavrrick Branch: master

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

The child apps are, "ADT Notifier", "ADT Door or Window Alert", ADT Motion Alert", "ADT Smoke Alert", "ADT Water Alert", "ADT Mode Chage", "ADT Alert Any Sensor"

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


ADT Notifier

This child app will send custom notifications when the ADT Alarm system changes states.

1. When you open the app enter a custom message for each alarm state.

2. Specify if you want to use "Push Notifications" or just SMS Text.

3. Enter a valid phone number if you want to recieve texts

4. Fill in the remaining fields if needed.

Alarm Alert Notifcation Apps

The Alarm alert notification apps allow you to trigger certain activities based on what kind of alert and what sensors triggered the alert to ADT. If you wish to use NON ADT sensors use the ADT Any Sensor Alert child app below. There is a different alert app for each kind of sensor. The Alert child apps are: ADT Door Window Alert, ADT Motion Alert, ADT Smoke Alert, ADT Water Alert.

1. When you go to add the child alert app the first thing the app will ask for is the ADT Sensors to use. The list may show sensors that are not ADT branded and though you can select them, they will never trigger activity.

2. Select the alarm(s) you want to trigger with this action. This will allow you to trigger a external siren.

3. Specify what type of alarm you want to trigger. These can be "1" for Siren, "2" for Strobe, or "3' for both.

4. Specify what type of light action you want . These can be "1" for no action, "2" for turn on lights, "3" for flash lights, "4" for both turn on and flash

5. Select what lights you want to turn on with light action 2 or 4

6. Select what lights y ou want to flash with option 3 or 4

7. Setup flashing parameters

8. Setup camera options. Decide if you want to turn on camera recording and if you want it to record until the alert event stops.

9. Select your alarm panel from the list. This is used if you request repeated recording while alarm is occuring.

10. Select which cameras will trigger in this action

11. Specify the length of each clip

12. Click on save

ADT Alert Any Sensor

This child app allows you a way to use non ADT branded sensors to trigger non monitored alarm actions locally, but still use the status of the ADT Alarm system status. This is intended to provide similar functionality to what a user would experience with "Smart Home Monitor", and should provide a migration path for those that use it. The Alert Child app is: ADT Alert Any Sensor

1. Open up "ADT Tools Smart app and scroll down to slect the app identifed as "Allows Unmonitored Alarm action based on ADT status"

2. Set the ADT Alarm status that will be used to know when this event should be triggered. This is the status the ADT System will need to be in for the unmonitored action to trigger.

3. Select the Motion or Door/Window sensors to use for this monitorting activity.

4. Select the ADT Panel that will be used to validate the Alarm Status

5. Select alarm you want to trigger with this action. This will allow you to trigger a external siren.

6. Specify what type of alarm you want to trigger. These can be "1" for Siren, "2" for Strobe, or "3' for both.

7. Specify what type of light action you want . These can be "1" for no action, "2" for turn on lights, "3" for flash lights, "4" for both turn on and flash

8. Select what lights you want to turn on with light action 2 or 4

9. Select what lights y ou want to flash with option 3 or 4

10. Setup flashing parameters

11. Setup camera options. Decide if you want to turn on camera recording and if you want it to record until the alert event stops.

12. Select your alarm panel from the list. This is used if you request repeated recording while alarm is occuring.

13. Select which cameras will trigger in this action

14. Specify the length of each clip

15. Click on save

FYI: This child app is based on the alarm state of the hub location and not the ADT alarm. For this child app to function properly please make sure you have the ADT Mode Change app loaded and configured with a reasonable delay value. Without this configuration being completed this child app will not function.

ADT Mode Chage

This child app allows you a way to enable smartapp and direct access to change the Alarm Mode of the system. This application will also ensure that your ADT Alarm and your Hub alarm Status remain in sync if the feature is turned on. The Alarm Delay will allow for exit delay for the ADT Any Alarm child app

1. Create Virtual Momentary Tile buttons in the Smartthings IDE for the alarm modes you want to change to

2. Select "ADT Mode Change" from the ADT tools app

3. Assign your virtual momentary tile buttons to the appropriate option

4. Select if you want to turn on synchronization between The Smartthings ADT Panel and the location alarm state

4. Provide a numeric value for the Alarm Delay

4. Select your ADT Pannel

5. Click on Save

You should now be able to select those Momentary buttons from the App and change your alarm Mode. Now you can configure thouse buttons to be avaliable for external applications like Action tiles.

Associated Device Handlers

There is only one custom device handler associated with ADT Tools. The "ADT Momentary 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 Momentary Button" for the device type.

Things to keep in mind

1. These 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 scenerios.

2. All of the programs are specific to only ADT Sensors except the ADT Alert Any Sensor app. If the sensors would not notifiy ADT, these apps won't trigger anything. 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 "ADT Mode Change" child app. 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 worriesome idea. I used a standard presense routine yesterday to arm while away and my system armed while i was sitting 15 feet away in the next room. Becareful and test if you use this

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

6. Becuase 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 froma 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 and setup ADT Mode Change to maintain states between ADT and HUB(SHM ) Alarm state.

2. Setup the ADT Alert Any Sensor Smart app 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: Dont forget to setup a custom message for each ADT Alert Any Sensor 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. Configure 3 virtual mometary buttons in the Smartthings IDE

2. Install ADT tools and setup ADT Mode Change assinging each virtual button to 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 visable to external services, smartapps and automations. You can take this even a step further create a routine to Arm and Disarm the alarm based on your location