In this tutorial, we are going to see how we can use the MQTT protocol with ESP32 to communicate with Tuya Cloud. Earlier we had been using LinkSDK to control smart devices through the app via Data point (DP) protocol but in this, we will learn to use the Things Data model, to support the features that the DP protocol cannot implement, such as actions, events, and sub-device management. The aim of this article is to help developers to connect their proprietary hardware to the Tuya IoT Development Platform


I have used ESP32 based M5 Core2 (micropython) but it should work with any ESP32 device with an MQTT library for bidirectional communication between a device and the Tuya IoT cloud.

Tuya IoT Platform Setup

Log in to the Tuya IoT Development Platform and create a product to get the following parameters. For more information about the detailed processes of product creation, see Create Products.

We have selected Switch as our product type (here are lot's of options to choose from). Also, selected TuyaLink as a development mode.

Once the product is created, create custom functions (Property, Events or Actions). If you want to make Data Points select Property. Events and actions are useful for value-based monitoring and alerts or trigger.

Tuya provides free licenses to debug devices, click on the link to get free licenses in the Activation and Verification shown below.

Once your license is obtained, you should be able to see all device information to be used to make a device connection with the ESP32 device.

ProductID - The PID of the product you create.

DeviceID - The device ID that is used for cloud authentication and communication.

DeviceSecret - The device secret that is used for cloud authentication and communication.

M5Stack Core 2 (ESP32) Setup

Core2 is an ESP32-based microcontroller with a touch screen display, battery, RTC, microphone, and speaker built-in. This core2 is compatible with Arduino, Micro Python, and UIFlow programming environments. To program with UIFlow, we must first configure our M5Stack Core2 with UiFlow; for this, we will require M5Burner. The above link will take you to a download page. Connect your Core2 to your PC, then run M5Burner, which will instantly detect your device. After that, go to Core2 and choose UiFlow for Core2.

Burn the firmware to your device. Once you are configured with Core2, open UIFlow IDE over the internet (

Understanding the code and Tuya MQTT connection

First, let us understand the MQTT parameters to be used to connect with Tuya Cloud.

  • Client Id: Enter a value in the format tuyalink_{$deviceid}. Device Id is obtained from the Tuya Setup step.
  • Endpoint: Enter an endpoint specified in the MQTT protocol. For example, is shown in the screenshot.
  • Port: Enter a port number. Set this parameter to 8883.
  • Username:${deviceId}|signMethod=hmacSha256,timestamp=${10-digit timestamp},secureMode=1,accessType=1
  • Password: The password is a 64-bit hexadecimal value obtained using hmacSha256(content, deviceSecret)The plaintext of content is a string concatenated with deviceIdtimestampsecureMode, and accessType in sequence.For example, content is made of deviceId={$device_id},timestamp=1607635284,secureMode=1,accessType=1 (you can use this website to get computed hash
  • SSL: True
  • timeout: 60

Below is micro python code,

m5mqtt = M5mqtt('tuyalink_6c1b715d5261ff4c7duev7', '', 8883, '6c1b715d5261ff4c7duev7|signMethod=hmacSha256,timestamp=1641396180,secureMode=1,accessType=1', 'b71103b496ec7cdf3f58d2e7c787a9b79401dc7b4b34c29f342bde2488bf0e60', 60, ssl = True)

If your...

Read more »