Messaging With Custom Format

If the connected devices cannot communicate with the cloud using JSON-formatted data, they can send raw data to the cloud. Tuya IoT Development Platform converts data between a custom format and the JSON format based on the scripts you have submitted.

This topic describes messaging using a custom format and the relevant MQTT topics.

Feature description

To enable a device to report and receive data in custom format, choose Custom for Data Protocol when you create a TuyaLink-based product and then submit a data parsing script. For more information, see Data Parsing.

Report custom format data

Interaction diagram

Device sends messages

Topic: tylink/${deviceId}/channel/raw/up

Message content

// Custom format data, such as
0x312c332c312c302c312c31342c313633373131343839323238372c4f4e

Parse upstream data

function rawDataToTyLink(bytes)

• Input parameter: raw data (bytes)

• Output parameter: JSON data

  {
    "msgType": "thing.action.execute.response",
    "payload": {
      "msgId": "17",
      "time": 1637114892287,
      "code": 0
    }
  }
  

Description

The msgType of the reported data.

Receive custom format data

Interaction diagram

Device receives messages

Topic: tylink/${deviceId}/channel/raw/down

Message content

// Custom format data into which the downstream data is parsed, such as
0x312c312c312c302c312c313030312c313633373131343839323238372c4f4e

Parse downstream data

function tyLinkToRawData(json)

• Input parameter: JSON data

  {
    "msgType": "thing.action.execute",
    "payload": {
      "msgId": "2011",
      "time": 1637114892287,
      "data": {
        "actionCode": "ptzcontrol",
        "inputParams": {
          "direction": "UP"
        }
      }
    }
  }
  

• Output parameter: custom format data

Description

The msgType of the received data.