This page shows how you can setup your Door / Window Sensor 7 with a custom device handler in SmartThings and forms part of the larger Door / Window Sensor 7 user guide.

Special Thanks to Erocm123 for his configuration code, and SmartThings for the basic contact sensor code.

If you have any feedback, please contact

Version V1.1

  • Settings configure upon Wakeup of Sensor
  • Parameter 2 details changed to normal state and reverse state of DWS7 output.

Version V1.0

  • Adds tilt sensor status to SmartThings Classic interface
  • Adds preference settings for Parameter 1.
  • Adds preference settings for Parameter 2.

Installing Device Handler:


  1. Log in to Web IDE and click on the "My Device Types" link on the top menu (login here:
  2. Click on "My Locations"
  3. Select your SmartThings Home Automation gateway that you want to put the device handler in. (in the image below, my SmartThings gateway is called "Home", this may be different for you).
  4. Select tab "My Device Handlers" (If you correctly performed steps 2 and 3 above, you should be in your gateways home page now).
  5. Create a new Device Handler by clicking on "New Device Handler" button in the upper-right  corner.
  6. Click on "From Code."
  7. Copy the code from the text file found here (Mouse middle-click to open a new tab):
    1. Open up the .txt file containing the code.
    2. Now copy everything highlighted by pressing (CTRL + c)
    3. Click on the SmartThings code page and paste all code (CTRL + v)
  8. Click on "Save", then wait for the spinning wheel to disappear before continuing.
  9. Click on "Publish" -> "Publish for me"
  10. (Optional) You can skip steps 11 - 16 if you pair D/W Sensor 7 after installing the custom device handler. D/W sensor 7 should automatically pair with the new added device handler. If already paired, please continue forward to the following steps.
  11. Install it on your D/W sensor 7 by going to "My Devices" page in the IDE
  12. Find your D/W sensor 7.
  13. Go to the bottom of the page for the current D/W sensor 7 and click on "Edit."
  14. Find the "Type" field and select your device handler. (should be located at the bottom of the list as Aeotec Door Window Sensor 7 Basic).
  15. Click on "Update"
  16. Save Changes

Configure your Door Window Sensor 7 using SmartThings Connect.


  1. Open up SmartThings Connect app.
  2. Remove the cover of the Door Window Sensor 7. (recommended for convenience, in preparation for step 8)
  3. Find and open up Door Window Sensor 7 page.

  4. Select the more options icon at the top right corner (3 dots).
  5. Select "Settings".

  6. Change the settings based on what you want the Door Window Sensor 7 to do.
    • Parameter 1 - Dry Contact Enabled/Disabled
      • Allows you to disable magnet sensor and enable dry contact output on terminal 3 and 4.
    • Parameter 2 - Sensor State
      • Allows you to reverse the state of the DWS7 status output.

  7. When done, press the back arrow button located at the top left corner.
  8. Now tap the physical tamper switch on the Door Window Sensor 7 to send a wakeup report to SmartThings. (LED on DWS7 should light up once for 1-2 seconds).

    The parameter settings will configure when the device sends a wakeup report, so alternatively, you could wait until the next time the Door Window Sensor 7 sends a wakeup report to your hub which is once per a day.