Go to Body Go to Navigation

How to test

The Developer Workspace allows you to test Automations and devices with the SmartThings app. It also includes some additional tools. With the Virtual Device you can do tests without a physical device, and with the Device Plugin Simulator you can test how your device appears in the SmartThings app, and how you can interact with it.

Prerequisites

To connect your mobile phone with the SmartThings SDK, set your ADB (Android Debug Bridge) path.

  1. Download the Android SDK Tools and install it.
  2. Enable adb debugging on your Android phone.
  3. Launch the Atom IDE.
  4. Go to File > Settings > Packages > Community Packages > SmartThings and click Settings.
  5. Enter the path to your adb installation. The default Windows path is C:\adb.

Test your Automation

The Developer Workspace allows you to create an Automation and test it.

  1. When creating your Automation in the Developer Workspace, click CONFIRM to register your Automation in the self-publish phase. The Automation information is sent to SmartThings Cloud.
  2. Launch the SmartThings app. Your SmartThings app and Developer Workspace must be signed into the same account.
  3. Enable Developer Mode in the SmartThings app.
  4. Go to Automations tab and add your Automation app.
  5. Test your Automation.

Test your device

To test your device, you have to self-publish or side-load it. You can download the self-assessment checklist in the final step of creating your device through the Developer Workspace.

Self-publishing

Self-publishing is an easy way to test your device in the SmartThings app.

  1. When creating your device in the Developer Workspace, click CONFIRM to self-publish your device in the self-publish phase. The device information is sent to SmartThings Cloud.
  2. Enable Developer Mode in the SmartThings app and then add your device.

Side-loading

To test a device plugin you have created, you must side-load it through the SmartThings SDK. You can test your device plugins in the SmartThings app or in the Device Plugin Simulator.

  1. Launch your SmartThings app and enable Developer Mode.
  2. Connect your mobile phone to your computer using a USB cable. If you cannot connect your mobile phone, set up the ADB path.
  3. In the Atom IDE, select SmartThings > Run As > Target, entering the password you set up when you signed the plugin. This copies the plugin files to your connected device.
  4. Refresh your SmartThings app: In Developer Mode, tap Restart App.

To test a physical device, you need to prepare your device. Enable developer Mode in the SmartThings app to add a self-published device for testing.

If you don’t yet have a physical device, you can use a Virtual Device that represents this physical device and its resources.

  1. Create and launch a new Virtual Device.
  2. Choose whether you will test your device using the SmartThings app or the Device Plugin Simulator.

NOTE

The Device Plugin Simulator only works with a Virtual Device.

You can then control and test the Virtual Device with the SmartThings app or the Device Plugin Simulator.

More information