TuyaLink Quick Start

This tutorial walks you through using TuyaLink to connect smart devices to the Tuya Developer Platform. A demo project in Java is available on GitHub. You can run the demo in IntelliJ IDEA and try out sending commands to and receiving data from a smart switch.

Prerequisite

Create an account of the Tuya Developer Platform to create and manage your connected devices.

Step 1: Enable TuyaLink connectivity

Create product

A product describes an abstract representation of a collection of physical devices, which is used to manage devices with the same capabilities. For example, if you want to have your Bluetooth treadmill connected to the Tuya Developer Platform for device monitoring, you can define it as a smart treadmill. This section describes how to create a product with TuyaLink.

1. Log in to the Tuya Developer Platform.

2. Determine the product category for your devices. For example, Electrical > Switch.

3. Choose TuyaLink for smart mode.

   

4. TuyaLink Solution is selected by default.

5. Complete the basic information about the product.

Define functions

Under the Function Definition tab, add functions based on the features of your devices.

1. Click Add and select a function such as switch 1.

2. Click OK to add the selected function.

   

Develop device and verify connectivity

1. Under the Device Development tab, choose Open Protocol and click Next.

2. Check out the development guide and determine the resources you want to develop with, either the Tuya MQTT Standard Protocol or the Tuya IoT Core SDK. This topic uses the Tuya MQTT Standard Protocol to describe the process.

   

3. You can request free licenses or purchase a license to activate your device. In the example, we choose Free to receive authorization code.

   

4. After you get the license, click Register Device to generate a device for debugging and verification.

5. In the Register Device dialog, select a registration method and click OK to generate a device certificate.

   

6. The Activation & Verification page displays the generated device certificates.

   

   Identifier	Example
   RegistrationID	nFUDM2LnPFuL5jTrW***
   ProductID	gmabzdwevsvlt***
   DeviceID	6cc87b39369b6fb754i***
   DeviceSecret	*****************

   • The values in the above code snippet are for demonstration only. Replace them with your own.
   • Device identity information is the unique credential to authenticate access to the Tuya Developer Platform. Keep it safe.

With the ProductID, DeviceID, and DeviceSecret, a device can report data to the cloud over MQTT.

Step 2: Download and edit demo

This section describes how to use the Java code to connect a device to the Tuya Developer Platform and implement device-to-cloud messaging. The Java code is run on a physical host, which can represent a real device.

1. Download TuyaLink Demo from GitHub.

2. Unzip the downloaded file and import it to IntelliJ IDEA.

3. Open TuyaMQTT3ClientDemo.

   
   Important folders:

   • sign: Includes the signature logic for MQTT connection.
   • listener: Includes the MQTT listener.
   • resources: Includes the certificate.

4. In TuyaMQTT3ClientDemo, replace the parameters marked in the following figure with your ProductID, DeviceID, and DeviceSecret.

   

   // TuyaLink device configuration is as follows, you must change it
   String productId = "dsadus***";
   String deviceId = "6cc87b393436fb754i***";
   String deviceSecret = "ffad8e******8c717";
   

   • The values in the above code snippet are for demonstration only. Replace them with your own.
   • Do not modify the code outside these three parameters. The sample code has implemented the subscription to the topic used to report a property change.

Step 3: Device reports data to the cloud

Report device properties

Topic: tylink/${deviceId}/thing/property/report

{
    "msgId":"45lkj3551234***",
    "time":1626197189638,
    "data":{
        "switch_led_1":{
            "value":true,
            "time": 1626197189638
        }
    }
}

Parameter

Example:

 //****************************************device property report********************************************

 // Property report topic
 String topic = "tylink/" + deviceId + "/thing/property/report";
 // Current timestamp
 long timestamp = System.currentTimeMillis();
 // Property report content
 String content = "{\n" +
         "\t\"msgId\":\"45lkj3551234002\",\n" +
         "  \t\"time\":" + timestamp + ",\n" +
         "\t\"data\":{\n" +
         "    \t\"switch_led_1\":{\n" +
         "        \t\"value\":true,\n" +
         "        \t\"time\": " + timestamp + "  \n" +
         "        }\n" +
         "\t}\n" +
         "}";

 MqttMessage message = new MqttMessage(content.getBytes());
 message.setQos(1);
 sampleClient.publish(topic, message);
 System.out.println("publish topic: " + topic);
 System.out.println("publish content: " + content);

The value of the property field in the code must be identical to that defined on the Tuya Developer Platform.

Debug online

1. When your code is ready to go, open the Tuya Developer Platform and choose Online Debugging in the development process.

   

   (Optional) You can click the Online Debugging tab to directly navigate to the destination.

   

2. Select a device for debugging. You can search for the device you configured in the code by DeviceID.

3. The connection status will appear. You can click Manual Refresh to get the latest status.

   

4. Right-click the TuyaMQTT3ClientDemo file and choose Run to run the code.

   

5. The output window shows successful data reporting to the cloud.

   

6. Navigate to Device Debugging on the Tuya Developer Platform and check the data reported from the device.

Step 4: Send messages to the device

This section describes how to send a message to the device.

1. Open the Tuya Developer Platform.

2. Navigate to the page of Device Debugging.

3. Select the target device.

4. In Property Debugging, enter or change the value of a property and click Set. The cloud will send the desired property value to the device. The content sent to the device is printed in the log.

5. If the code runs correctly, the output in the IntelliJ IDEA should look like this.

   

Next steps

The sample Java code simulates the bidirectional commutation between the device and the cloud, which can help you quickly verify use cases.

You can practice what you have learned by starting with Create Product.