Standard Instruction Set

A standard instruction set is a set of control function instructions that can be sent by devices. The standard instruction set varies depending on the product category. The control instructions supported by a specified product form a subset of the standard instruction set of the product category.

This chapter provides the instruction set for certain product categories on the Tuya Developer Platform. The instruction sets for more products are being developed. If you have any requirements, you can submit a ticket to contact Tuya.

Terms and definitions

Things to note

• The instruction set provided in this section is not completely consistent with the definition of product functions on the Tuya Developer Platform. The Tuya Developer Platform is integrated with the instructions of different products in the same category.
• You only need to integrate with Tuya’s instruction set of the same category, before you can control different products of the same category.
• If the returned standard product is an early product with a category code of qt, it might no longer be supported. If you need to integrate with it, please submit a ticket for confirmation.

Procedure

This section takes the electric pressure cooker in the Function Definition as an example to describe how to query the cloud function properties and status properties of smart devices.

Step 1: Query device function properties

You can refer to the sample request in this step to query the standard functional properties (or the instruction set) supported by your device and the status properties (or the status set) that can be reported. For more information about APIs, see Get the specifications and properties of the device.

• The instruction set will be used as the code in the instruction to be sent.

• The status set will be used to query the device status interface.

  If the returned result is empty, submit a ticket for confirmation.

Sample request

curl --request GET "https://openapi.tuyacn.com/v1.0/iot-03/devices/vdevo16**********035/specifications" --header "sign_method: HMAC-SHA256" --header "client_id: x37******************mmu0" --header "t: 1630599812793" --header "mode: cors" --header "Content-Type: application/json" --header "sign: 4979EC676FB3B7******************A0835B1CF46265B" --header "access_token: 5eb*********1371"

Sample response

{
"result": {
	"category": "dylg",
	"functions": [
	{
		"code": "switch",
		"type": "Boolean",
		"values": "{}"
	},
	{
		"code": "start",
		"type": "Boolean",
		"values": "{}"
	},
	{
		"code": "appointment_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":0,\"max\":1440,\"scale\":0,\"step\":1}"
	},
	{
		"code": "cook_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":0,\"max\":6000,\"scale\":0,\"step\":1}"
	},
	{
		"code": "warm_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":30,\"max\":1440,\"scale\":0,\"step\":1}"
	}
	],
	"status": [
	{
		"code": "switch",
		"type": "Boolean",
		"values": "{}"
	},
	{
		"code": "start",
		"type": "Boolean",
		"values": "{}"
	},
	{
		"code": "appointment_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":0,\"max\":1440,\"scale\":0,\"step\":1}"
	},
	{
		"code": "cook_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":0,\"max\":6000,\"scale\":0,\"step\":1}"
	},
	{
		"code": "work_state",
		"type": "Enum",
		"values": "{\"range\":[\"idle\",\"appointment\",\"cooking\",\"warm\",\"paused\"]}"
	},
	{
		"code": "warm_time",
		"type": "Integer",
		"values": "{\"unit\":\"min\",\"min\":30,\"max\":1440,\"scale\":0,\"step\":1}"
	}
	]
},
"success": true,
"t": 1630599813188
}

Step 2: Send instructions to the device

You can debug the device functions by sending instructions in the instruction set to the device. For more information about APIs, see Send commands.

The following sample request is based on the device function properties that are obtained in the previous step, using switch as an example to send instructions.

Sample request

curl --request POST "https://openapi.tuyacn.com/v1.0/iot-03/devices/vdevo16********035/commands" --header "sign_method: HMAC-SHA256" --header "client_id: x37upht******bmmu0" --header "t: 1630599977335" --header "mode: cors" --header "Content-Type: application/json" --header "sign: DE7D1F28BB2C775*********0F4A45D09430A13D48C0E086" --header "access_token: 5eb******1371" --data "{"commands":"[{\"code\":\"switch\",\"value\":true}]"}"

Sample response

{
	"result": true,
	"success": true,
	"t": 1630599977705
}

Step 3: Query the latest status of the device

You can query the current status of the device with the following instructions. For more information about APIs, see Get the status of a single device.

After sending the switch instruction in Step 2, you can query the latest status of the device.

Sample request

curl --request GET "https://openapi.tuyacn.com/v1.0/devices/vdevo16********035/status" --header "sign_method: HMAC-SHA256" --header "client_id: x37******mmu0" --header "t: 1630600155872" --header "mode: cors" --header "Content-Type: application/json" --header "sign: BD000A8CC7F8E35************0851F75C64A202" --header "access_token: 5eb*********1371"

Sample response

{
"result": [
	{
	"code": "switch",
	"value": true
	},
	{
	"code": "start",
	"value": false
	},
	{
	"code": "appointment_time",
	"value": 0
	},
	{
	"code": "cook_time",
	"value": 0
	},
	{
	"code": "work_state",
	"value": "idle"
	},
	{
	"code": "warm_time",
	"value": 30
	}
],
"success": true,
"t": 1630600156146
}

List of category code

The category code field indicates the abbreviation of a specified product. The following table lists the products that match most instruction codes.