Before You Begin Testing

Complete the steps on this page before you start a test in the SmartThings Test Suite. Good preparation helps your Full Integration Test run without interruptions.

General Prerequisites

Before using the Test Suite, make sure that you have:

1. A Samsung account. You use it to sign in to the Test Suite.
2. The latest version of the SmartThings app installed on your Android or iOS device.
3. A device that uses a supported connection type: Matter, Zigbee, Z-Wave, LAN, Direct Connected (MQTT), or Cloud Connected (SmartThings Schema). See Supported Connection Types to check which ones qualify for self-test certification.
4. Access to your Organization (if applicable). If the device belongs to a Developer Center Organization, make sure that your Samsung account is a member of that Organization. See Using the SmartThings Console - Organizations to learn how Organizations work and how to invite others.
5. Checked that your device is supported. Compare your device with the supported device types and Capabilities.

Remove your device from SmartThings before a Full Integration Test

For a Full Integration Test (required for self-test certification), your device must not be onboarded to SmartThings. Onboarding is part of the test, and the Test Suite asks you to onboard the device during the test. If the device is already connected, remove it from SmartThings first.

Z-Wave devices and the SmartThings Hub

If you connect your Z-Wave device through a SmartThings Hub, note that the SmartThings Hub does not support the following Z-Wave Plus V2 features:

• Z-Wave Long Range star network
• SmartStart onboarding
• Over-the-Air (OTA) updates

Prepare for Your Connection Type

Each connection type has its own preparation steps. Select your connection type below.

Hub Connected Devices (Matter | Zigbee | Z-Wave)

Before you start a Full Integration Test:

• Remove the device from SmartThings: If the device you want to test is already connected, remove it from SmartThings.
• Get the device ready to pair: Make sure that the device can be added to SmartThings. For example, reset it or put it in pairing mode.
• Know your onboarding method: During the test, you will be asked which method you used to onboard the device.

No additional documentation is required.

Cloud Connected (Schema) Devices

Before you start a Full Integration Test:

• Remove linked services: Remove any previously linked services (Schema connectors) that you want to test from SmartThings. For instructions, see the SmartThings Support Guide. The Test Suite can't detect devices that are already connected through your Schema integration.
• Prepare two test devices:
  • A primary device to test core functionality.
  • A secondary device to verify onboarding.
• Prepare the required documentation: You upload the following files during the test. Capture them before you start the test, using the procedures below.

Documentation	Required?	Accepted formats	Maximum file size
Screenshot of your authorization page	Always	PNG, JPG, JPEG	25 MB
Video of App-to-App Account Linking on each supported platform (Android, iOS)	Only if your integration supports App-to-App Account Linking	MP4, MKV, WebM, MOV, WMV	100 MB

How to capture the screenshot of the authorization page

Note: Have your screen capture tool ready. You take the screenshot during the final step (re-pairing).

Preparation

1. If your integration supports App-to-App Account Linking, uninstall your app.

Pairing

1. Start pairing the device with SmartThings for the first time.
2. Check that you are redirected to your web login page.
3. Enter your credentials.
4. Check that the device is successfully paired in SmartThings.

Service removal

1. Remove the linked service from the SmartThings app.
2. Check that the service is completely removed.

Re-pairing

1. Pair the device again shortly after removal, while the authentication data is still cached.
2. Check that the authorization screen or the web login page is displayed.
3. Take a screenshot.

How to record the App-to-App Account Linking video (if supported)

Preparation

1. Install and set up your app.
2. Log in and add your test device.
3. Start your screen recording. Make sure that it is recording before you continue.

Pairing

1. Start pairing from the SmartThings app.
2. Check that you are automatically redirected to your app.
3. Approve the connection on the authorization screen, without entering your credentials again.
4. Check that the device is successfully paired in SmartThings.

Service removal

1. Remove the linked service from the SmartThings app.
2. Check that the service is completely removed.

Re-authentication

1. Log out of your app.
2. Start pairing again from the SmartThings app.
3. Check that you are redirected to your app and asked to log in.
4. Log in and complete pairing.
5. Check that the device is successfully connected.
6. Stop your screen recording.

Direct Connected Devices (MQTT)

Before you start a Full Integration Test:

• Remove the device from SmartThings: If the device you want to test is already connected, remove it from SmartThings.
• Meet the security requirements: Review and implement the Security Requirements for Direct Connected Devices.
• Prepare the WWST Security Request Form: You don't upload this form in the Test Suite. You submit the WWST Security Request Form with your certification request in the SmartThings Console. See Direct Connected (MQTT) Devices and the Security Review.
• Prepare the required documentation: You upload the following file during the test:

Documentation	Required?	Accepted formats	Maximum file size
Photo of the device's QR code for the device you onboard. The QR code must follow the QR code guidelines for Direct Connected devices.	Always, even if you don't use the QR code to onboard the device	PNG, JPG, JPEG	25 MB

Next Step

When you are ready, start a test and onboard your device.