MQTT Protocol Documentation

{
  "device": "devName",// devName: device name, example: "yq_6809_0"
  "data": {
    "id": 1,// Message ID, auto-increment
    "method": "",// Control method, example: "so"
    "params": {}// Control parameters, varies by control method
}

{
  "device": "yq_A755_0",
  "data": [
    { "id": 1, "method": "so", "params": [228, 0] },// Control command 1
    { "id": 2, "method": "sp", "params": [0, 1, 0, 5000, 1000, 0, 0] }// Control command 2
  ]
}

"method": "so",// set output 
"params": [value0, value1]
    //value0: 0-16 switch control values, value1: reserved, default 0.
    //Each 2 bits in value0's binary value corresponds to 1 output: 00=no action, 01=off, 10=on, 11=toggle
    //Example: value0 = 228 = 0b 11 10 01 00
    //Switch 1: 00 = no action
    //Switch 2: 01 = off
    //Switch 3: 10 = on  
    //Switch 4: 11 = toggle
    //Other switches: 00 = no action

    //Example code: Turn on switch 3, other switches no action   

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "so",
		"params": [32, 0]
	}
}

"method": "sp",// set pwm 
"params": [idx, onoff, inverse, pwm, hz, pwmRate, hzRate]
    // idx: PWM index (starts from 0)
    // onoff: 0=off, 1=on, 2=toggle
    // inverse: 0=normal, 1=inverted
    // pwm: duty cycle 0-10000 (actual 0-100.00%)
    // hz: frequency 1-150000Hz
    // pwmRate: duty cycle ramp rate 0-10000/s (actual 0-100.00%/s)
    // hzRate: frequency ramp rate 0-100000Hz/s
    // Set to -1 to keep original value

//Example code: Set PWM1 duty cycle to 80%, keep other parameters

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "sp",
		"params": [1, -1, -1, 8000, -1, -1, -1]
	}
}

"method": "sc",// set counter 
"params": [idxN,typeN,valueN,...]
    // idx: counter index 0-15
    // type: operation type 0=set, directly set value; 1=increment, increment from current value; 2=decrement, decrement from current value
    // value: specific operation value (Int32)

//Example code: Set counter 3 to 12345, increment counter 4 by 8899

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "sc",
		"params": [2, 0, 12345, 3, 1, 8899]
	}
}

"method": "sr",// set RF 
"params": [idx, rfValue]
    // idx: remote index
    //0~9: corresponds to hardware preset remotes 1~10
    //10~19: corresponds to device learned remotes 11~19
    //-1: use custom rfValue (high 20 bits ID + low 4 bits key value)
    //rfValue: 433MHz key value (0~15)

//Example code: Press button 3 on remote 3

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "sr",
		"params": [2, 3]
	}
}

"method": "gd",// get data 
"params": dataType
    // dataType: data type to retrieve, reported as full data
    //0: basic data (switches, inputs, PWM, temperature/humidity, ADC, counters, Modbus data)

//Example code: Get basic data

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "gd",
		"params": 0
	}
}

"method": "ro",// run oneKeyTask 
"params": taskId // Task ID (visible in APP)

//Example code: Execute "one-click" task with ID 12

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "ro",
		"params": 12
	}
}

"method": "se",//set enable 
"params": [taskId, enable]  //taskId: task ID to control; enable: 0: disable, 1: enable

//Example code: Disable task with ID 13

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "se",
		"params": [13,0]
	}
}

"method": "sd",//stop delay 
"params": id  // Task ID to stop, no effect if task is not executing

//Example code: Stop task with ID 14

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "sd",
		"params": 14
	}
}

"method": "cp",//clear pulse 
"params": idx  //Digital input index to clear

//Example code: Clear pulse count for input 2

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "cp",
		"params": 1
	}
}

"method": "rb",//reboot 
"params": 1//1: reboot

//Example code: Reboot device

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "rb",
		"params": 1
	}
}

"method": "sk",//set key 
"params": [admin, user]//admin: admin password, user: user password; if either is set to 0, password is cleared

//Example code: Set admin password to 123456, user password to 654321

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "sk",
		"params": [123456, 654321]
	}
}

"method": "ot",//ota 
"params": [binType, url, wifiName, wifiPsw]
    // binType: firmware type
    //  "0": Framework firmware (requires version > 82)
    //  "1": User logic firmware (will connect to MQTT in firmware after update)
    //  "2": User logic firmware (permanent)
    //  "3": Driver firmware
    // url: firmware file download direct link
    // wifiName: on-site 2.4G WiFi name
    // wifiPsw: on-site WiFi password

//Example code: Upgrade user logic firmware

{
	"device": "yq_6809_0",
	"data": {
		"id": 1,
		"method": "ot",
		"params": ["1", "http://example.com/firmware.bin", "WiFiName", "WiFiPassword"]
	}
}