Uplink Data
This chapter describes the uplink packets reported by the device.
Basic Information Packet
After joining the network, the device reports a packet containing the basic device information. Example:
{
"device_status": "on",
"firmware_version": "v1.5",
"hardware_version": "v2.1",
"ipso_version": "v0.1", //Protocol version
"lorawan_class": {
"type": "Class C"
},
"reset_event": "reset", //Report after reset
"sn": "6791d19604050005",
"temperature_control_support_mode": {
"auto": "disable",
"cool": "disable",
"em_heat": "disable",
"heat": "enable"
},
"temperature_control_support_status": {
"stage_1_cool": "disable",
"stage_1_heat": "enable",
"stage_2_cool": "disable",
"stage_2_heat": "disable",
"stage_3_cool": "disable",
"stage_3_heat": "disable",
"stage_4_heat": "disable",
"stage_5_heat": "disable"
},
"tsl_version": "v1.0",
"wires": {
"aux": "off",
"di": "off",
"e": "on",
"gh": "on",
"gl": "off",
"ob": "off",
"pek": "off",
"w1": "on",
"w2": "on",
"y1": "on",
"y2": "on"
}
}
Periodic Data Packet
The device reports a data packet at a configured reporting interval.
Periodic packet example when control permission is Thermostat:
{
"ambient_temperature": 27.2, //Unit: °C
"celsius_ambient_temperature": 27.2,
"curr_temperature_humidity_source": "embedded",
"current_temperature_control_mode": {
"mode": "heat",
"status": "standby"
},
"system_status": "on",
"fahrenheit_ambient_temperature": 81,
"fan_mode_setting": {
"mode": "circulate",
"status": "on"
},
"humidity": 57, //Unit: %RH
"plan_type": "not executed",
"target_temperature": 17.2
}
Periodic packet example when control permission is Remote
Control:
{
"ambient_temperature": 27.3, //Unit: °C
"celsius_ambient_temperature": 27.3,
"system_status": "on",
"fahrenheit_ambient_temperature": 81.1,
"humidity": 34, //Unit: %RH
"enabled_relay": "Y1" //Enabled relay name
}Alarm Packet
The device reports the following types of alarm packets.
Temperature alarm
example:
{
"temperature": 27.6, //Unit: °C
"temperature_alarm": "threshold alarm"
}Target temperature range alarm example: report when receiving a
target temperature outside the regulation
range.
{
"target_temperature_range_alarm": [
{
"max": 18.8, //Max. regulation value, unit: °C
"min": 10, //Min. regulation value, unit: °C
"target_temperature": 3.6, //Invalid target temperature value, unit: °C
"temperature_control_mode": "heat"
}
]
}Data source alarm example: report when temperature data is not received before the timeout
and the data source is
switched.
{
"source_alarm": {
"source": "embedded"
}
}Status Change Packet
The device reports a packet when a parameter is changed.
- Control permission change report
example:
{ "control_permission": "thermostat" } - Wiring Setting change report
example:
{ "temperature_control_support_mode": { "auto": "disable", "cool": "enable", "em_heat": "disable", "heat": "disable" }, "temperature_control_support_status": { "stage_1_cool": "enable", "stage_1_heat": "disable", "stage_2_cool": "enable", "stage_2_heat": "disable", "stage_3_cool": "disable", "stage_3_heat": "disable", "stage_4_heat": "disable", "stage_5_heat": "disable" }, "wires": { "aux": "off", "di": "on", "e": "off", "gh": "on", "gl": "off", "ob": "off", "pek": "off", "w1": "off", "w2": "off", "y1": "on", "y2": "on" } } - A periodic report is sent when any of the following parameters change:
- Target Temperature
- Temperature Control Mode
- Fan Mode
- System Status
- Relay Status under Remote Control permission
- Relay status change report under thermostat control permission
When Relay Change Report is enabled, the device will send this report whenever the relay status changes.
Example:{ "enabled_relay": "Y1" }
Historical Data Packet
The device will report historical periodic reports when:
- Report at data retransmission interval when data retransmission is triggered;
- Report at data query report interval when sending history query commands.
Example:
{
"history": [
{
"fan_mode": "auto",
"fan_status": "standby",
"humidity": 39, //Unit: %RH
"system_status": "on",
"target_temperature": 27.7, //Target temperature or Cooling target temperature (dual target), Unit: °C
"target_temperature_2": 20.7, //Heating target temperature (dual target), Unit: °C
"temperature": 24.6, //Unit: °C
"temperature_control_mode": "cool",
"temperature_control_status": "standby",
"timestamp": 1697445600 //Unit: s
}
]
}