Skip to main content

Test Your Device

Preparing to test your device involves three main steps:

  • Enabling developer mode in the SmartThings app
  • Deploying your device to test
  • Testing your device

Enable Developer Mode in the SmartThings App#

You must enable developer mode before you can test using the SmartThings app.

  1. Launch the SmartThings app.
  2. Tap the Menu tab on the bottom navigation bar.
  3. Tap the Settings gear icon. The SmartThings settings menu will appear.
  4. Long-press About SmartThings for 5 seconds. A developer mode toggle will appear in the settings menu.
  5. Enable Developer Mode.
  6. Restart the SmartThings app.

Deploy To Test and Download Onboarding Profile#

In order to install your device with the SmartThings app, you will need to deploy to test from the Developer Workspace.

In the Developer Workspace Overview section, click Deploy to Test. After creating your device and deploying to test in the Developer Workspace, the device information is sent to the SmartThings Cloud.

After deploying to test, you will be prompted to download an onboarding profile and inject it into your test device. This profile is automatically generated once requirements for deploying to test have been met and deployment is complete.

important

Deploying your device to test does not mean your device is published. When you deploy your device to test, only the Samsung developer account used to deploy to test will be able to install the device from the SmartThings app, and only after enabling developer mode in the SmartThings app.

Register Your Test Device#

Test devices must be known to SmartThings before they can successfully connect to the cloud. Register devices by providing the device serial number and public key under Test > Test Devices in your project on the Developer Workspace.

Your device will now appear in the SmartThings app when signed in to the app with your Samsung developer account, allowing you to install your device from the SmartThings app.

Test Your Device With the SmartThings App#

To test your devices with the SmartThings app:

  1. Launch the SmartThings app. Your SmartThings app and Developer Workspace must be signed into the same account.
  2. Ensure developer mode is enabled in the SmartThings app.
  3. Tap Add device on the Dashboard or devices tab of the SmartThings app.
  4. Go to ADD DEVICE MANUALLY and tap My Testing Devices. You can now see and add your self-published devices.
note

If you have your company's Manufacture ID (MNID), you can see and add your self-published devices and also all self-published devices your company's developers have created.

  1. Confirm the connection by selecting ALLOW on your device.
note

To publish a SmartThings-certified device, you must download and complete a self-assessment checklist when requesting to publish the device.

To publish a SmartThings-compatible device, you must verify the self-test guidelines below.

Self-Test Guidelines#

You must verify the following self-test criteria to publish a SmartThings-compatible device.

important

If you want to publish your device, your device must pass the self-assessment checklist. You can download the self-assessment checklist in the final step of creating your device through Developer Workspace.

Pairing/Delete/Uninstall#

  • Device must pair to the SmartThings app properly.
  • Device must be unpaired/deleted from the SmartThings app properly.

Mobile UI/Metadata#

  • Paired device is visible and its name/icons are properly displayed on the list of devices on SmartThings app.
  • Device names/icons/capability status must be displayed properly on the device information page in the SmartThings app.
note

We recommend that a display name of your Connector be a combination of your company's brand name and the product's specific name such as its website or app name. For example, "Samsung SmartHome", "Samsung SmartCam".

Main Functionality#

  • Device's functionality is not impacted by any issues/crashes.
  • Device must have implemented clear, error messaging in cases when actions fail.
  • Device's functionality is compatible with defined use cases description.
  • Device must not have any hidden functionality (not included in documentation/product description).
  • Every device state change (of main capabilities) must be properly displayed on the SmartThings app.
  • Every device state change (of main capabilities) by SmartThings app must cause proper change on the device (physically).
  • Device capabilities that can be used in an Automation, either as a trigger for the Automation or recipient of the trigger, should execute correctly.
  • Device capabilities that can be used in Scenes should execute correctly.
  • Device must have a name that is strongly relevant to the device's functionality only.
  • Device must not have misleading name, device literature, or promotional materials.
  • Device info card must list a support URL that is real and correctly working.
  • Device must not breach the Terms and Conditions governing the use of SmartThings devices/services.
  • Device must not change and use "Connect with SmartThings" wording in ways that are not compatible with these guidelines.