Configure Pairing Information

After you create a product on the Tuya IoT Development Platform, you can set the pairing information in the Product Configuration step. A PID-based QR code will be generated for pairing. The QR code for pairing can greatly facilitate the device connection process in the access point (AP) pairing mode, Wi-Fi Easy Connect mode, and Bluetooth pairing mode.

Scenarios

The QR code is usually included in product manuals. End users can scan the QR code to open the pairing page. Even if the pairing information is modified, the QR code stays unchanged. When end users scan the QR code by using the specified app, they can use the latest information to complete the pairing process.

Advantages

Tuya’s pairing information is featured with the following advantages:

• Provide accurate pairing information to increase the chance of successful pairing.
• Sort the display order of multiple pairing methods, if any, and determine whether to display a specified pairing method.
• The packing and delivery are not subject to the pairing method and language requirements.
• The QR code does not need to be changed along with the pairing update, so the paper manuals will not be affected.
• Provide user-friendly pairing steps simply by scanning the QR code with the app.

Expected result

After the pairing information is set up, multi-step pairing or simple pairing will look like this:

Prerequisites

• You have created at least one product. For more information, see Create Products.

• Pairing information setting is supported by the Smart Life app v3.12.0 or later, or an OEM app of the ODM branch v3.12.0 or later. Scan the following QR code to update your app.

  

Method 1: Multi-step pairing

1. Log in to the Tuya IoT Development Platform.

2. Go to Product Development.

3. Select a product in the Developing state, and click Develop in the Operation column.

4. Click Product Configuration.

5. Find Device Pairing and click Settings.

   

6. On the Pairing Guide page, complete the following configuration.

   • Pairing guide text: It is displayed on the homepage. The text in Simplified Chinese and English is required.

   • Pairing guide image/video: Upload images or videos as per the prompts. We recommend that no text should be included in the images or videos, so the images or videos can apply to all languages.

     Enter proper text in Simplified Chinese and English and upload a pairing guide image or video for each pairing step. You can add or delete steps for different products.

     

7. (Optional) Upload pairing guide videos that run no longer than 45 seconds for different products. Too large video files will affect user experience.

   You can upload long videos in different languages.

8. Manage tips for pairing over 5 GHz Wi-Fi:

   If the hardware in your product supports a 5 GHz Wi-Fi network, you can enable this feature. The tip for Wi-Fi frequency bands will not be shown in the pairing guide.

9. To configure multiple languages, click More Languages and complete related information.

10. Click Download QR Code at the bottom of the page.

    

    The PID-based QR code stays unchanged even if the pairing information is modified. You can include the QR code in the pairing section of your product manual, and proceed with the packaging design in advance. You can change the detailed pairing steps and introduction corresponding to the QR code later.

    The QR code below is only an example. Download the actual QR code corresponding to your product PID.

11. (Optional) Click Custom Mode in the top-right corner to sort the pairing methods displayed on the app.

12. After you complete and confirm the configuration information, click Save at the bottom of the page, open your app, and test the pairing.

    For example, open the Smart Life app or your OEM app, tap Me, and then tap the scan icon in the top-right corner to scan the QR code and display the pairing information.

Method 2: Simple pairing

This section describes how to perform simple pairing for your reference.

1. Log in to the Tuya IoT Development Platform.

2. Go to Product Development.

3. Select a product in the Developing state, and click Develop in the Operation column.

4. Click Product Configuration.

5. Find Device Pairing and click Settings.

   

6. Enter the Pairing Guide page, scroll down to Simple Pairing, and then complete the following configuration.

   • Pairing guide text: It displays on the homepage and includes key and necessary pairing information.

   • Pairing guide image: Upload a pairing guide image as per the prompts. Support .png and .gif (recommended) files.

   • Radio button text: Enter the content for a radio button.

     

     Enter both Simplified Chinese and English options.

7. (Optional) Set the content of Help.

   It specifies how to reset the device. If you do not click Set and update the content, the pairing information of the specified product category will be used. You can customize the help content in the following steps.

   1. Select a language, such as English, and click Set.

      

   2. On the Help Guide Settings page, enter the pairing guidelines. The image below shows the visual effect for your reference.

      Describe each pairing step and provide related images, such as .jpg, .jpeg, .png, and .gif.

      

   3. After you complete and confirm the supplied configuration information, click OK.

   4. Go back to the pairing guide and click Help Link to check the updated content.

      

8. After you complete and confirm the configuration information, click Save at the bottom of the page, open your app, and then test the pairing process.

Typical cases

The image below shows the original paper user guide of an example product. Due to the limits of size, it has the following disadvantages:

• Only two small images are used to describe pairing information, without a specific description of pairing status.
• The font and image are too small to be clearly recognized by the readers.
• If the pairing interface of the app is modified, the paper user guide should be designed and printed again.

After the pairing information is embedded in the QR code, the updated user guide will be available after the QR code is scanned. This method boasts the following advantages:

• The user accesses the specified pairing information simply by scanning the QR code.
• Leave more space for content regarding operation instructions.
• If the pairing information is updated, there is no need to remake the paper user guide.
• The Smart Life app and OEM apps all support product-based illustration of pairing.

Demo video