Downlink Commands for Thermostat Parameters

This section describes the downlink commands when control permission is Thermostat.

Configure Installation Parameters

Name Example
wires Enable Y1, O/B, W1, E, PEK, Y2.
{
  "wires": {
    "y1": "on",
    "gh": "off",
    "ob": "on",
    "w1": "on",
    "e": "on",
    "di": "off",
    "pek": "on",
    "w2": "off",  //Either W2 or AUX
    "aux": "off",
    "y2": "on",  //Either Y2 or GL
    "gl": "off"
  }
}
reversing_valve The O/B reversing valve is set to Energize on heat.
{
  "reversing_valve": {
    "mode": "energize on heat"  //energize on heat,energize on cool(default)
  } 
}
fan_control_during_heating Fan control during heating is Furnace or Boiler.
{
  "fan_control_during_heating": "furnace/boiler"  //furnace/boiler, thermostat
}
compressor_aux_combine_enable Enable Compressor and Auxiliary Heat Linkage.
{
  "compressor_aux_combine_enable": "enable"  //disable(default), enable
}
freeze_protection_config Enable Freeze Protection and the protection temperature is 1°C.
{
  "freeze_protection_config": {
    "enable": "enable", //disable(default), enable
    "temperature": 1  //Unit: °C, range: 1-5, default: 3
  }
}
system_protect_config Enable System Protection and the minimum running duration is 10 minutes.
{
  "system_protect_config": {
    "enable": "enable", //disable(default), enable
    "duration": 10  //Unit: min, range: 1-60, default: 5
  }
}
aux_control_config
Enable Y2 auxiliary mode only.
{
  "aux_control_config": {
    "y2_enable": "enable" //disable(default), enable
  }
}
Enable Y2 and W2 auxiliary mode.
{
  "aux_control_config": {
    "y2_enable": "enable", //disable(default), enable
    "w2_enable": "enable" //disable(default), enable
  }
}
Custom Temperature Control Stage Setting:
Name Example
custom_wiring_mode Enable custom temperature control stage.
{ 
  "custom_wiring_mode": "enable" //disable(default), enable
}
heating_stage1 Set stage-1 heat as Y1+Y2.
Note:
  • E is only working with EM heat.
  • If the lower stage is not configured, the higher stage command will be invalid.
{
  "heating_stage1": {
    "wire": "Y1+Y2"  //disable, Y1, Y2, W1, W2(AUX), Y1+Y2, Y1+Y2+W1, Y1+Y2+W1+W2(AUX),Y1+W1, Y1+W1+W2(AUX),W1+W2(AUX), E  
  }
}
heating_stage2
heating_stage3
heating_stage4
heating_stage5
emergency_heating
cooling_stage1
cooling_stage2
cooling_stage3

Configure Temperature Control Basic Parameters

The device provide multiple kinds of commands for easy configuration.
Name Example
temperature_control_enable_setting Enable to switch control mode from Heat and Cool.
{
  "temperature_control_enable_setting": {
    "mode": "heat/cool"  //heat/em heat/cool/auto, heat/cool/auto, heat, cool, heat/cool
  }
}
current_temperature_control_mode Switch temperature control mode to Auto.
{
  "current_temperature_control_mode": {
    "mode": "auto"   //heat, cool, em heat, auto
  }
}
target_temperature Target temperature of Cool mode is 25°C.
Note: This will not switch the temperature control mode.
{
  "temperature_control_mode": "cool",  //heat,em heat,cool,auto,auto heat, auto cool
  "target_temperature": 21.6  //Unit: °C, range: 5-35
}
system_status + temperature_control_mode + target_temperature System status is on, temperature control mode is Cool, target temperature is 25°C.
{
  "system_status": "on",  //on, off
  "temperature_control_mode": "cool",  //heat, em heat, cool, auto
  "target_temperature": 25 //Unit: °C, range: 5-35
}
target_temperature_resolution Target temperature resolution is 0.5.
{
  "target_temperature_resolution": 0.5  //0.5, 1
}
target_temperature_dual_enable When temperature control mode is Auto, the target temperature mode is Dual Target.
{
  "target_temperature_dual_enable": "enable" //disable (Single target), enable (Dual target)
}
temperature_tolerance Single target tolerance setting: Target temperature tolerance is 1°C, temperature control tolerance is 1°C. 
{
  "temperature_tolerance": {
    "target_temperature_tolerance": 1, //Unit: °C, range: 0.1-5,default: 1
    "auto_temperature_tolerance": 1   //Unit: °C, range: 0.5-10, default: 2
  }
}
double_point_target_tolerance Under Auto-Dual Target mode, heating temperature tolerance is 1°C.
{
  "double_point_target_tolerance": [
    {
      "mode": "heat", //heat, cool
      "tolerance": 1  //Unit: °C,range: 0.1-5, default: 2
    }
  ]
}
target_temperature_range_config Cool mode target temperature range is 15 - 30°C.
Note: Max. range value - Min. range value >1
{
  "target_temperature_range_config": {
    "temperature_control_mode": "cool", //heat, em heat, cool, auto
    "min": 15,  //Unit: °C, range: 5-35
    "max": 30  //Unit: °C, range: 5-35
  }
}

Configure Occupancy Mode Parameters

Name Example
occupancy_mode Switch occupancy mode to Occupied.
{
  "occupancy_mode": {
    "mode": "occupied"  //off (default), occupied, unoccupied
  }
}
occupied_delay The occupancy mode will switch from Occupied to Unoccupied after 60 minutes.
{
  "occupied_delay": {
    "time": 60  //Unit: min, range: 1-60, default: 255=disable
  }
}
When Occupancy Mode is Occupied:
Name Example
occupied_cooling_setpoint The cooling target temperature is 21.6°C.
{
  "occupied_cooling_setpoint": 21.6 //Unit: °C, range: 5-35
}
occupied_heating_setpoint The heating target temperature is 19°C.
{
  "occupied_heating_setpoint": 19 //Unit: °C, range: 5-35
}
occupied_cooling_setpoint_tolerance The cooling target temperature tolerance is 2°C.
{
  "occupied_cooling_setpoint_tolerance": 2  //Unit: °C, range: 0.1-5, default: 1
}
occupied_heating_setpoint_tolerance The heating target temperature tolerance is 2°C.
{
  "occupied_heating_setpoint_tolerance": 2  //Unit: °C, range: 0.1-5, default: 1
}
target_deadband The deadband value is 2°C.
{
  "target_deadband": 2 //Unit: °C, range: 1-10, default: 5
}

When Occupancy Mode is Unoccupied:

Name Example
unoccupied_cooling_setpoint The cooling target temperature is 21.6°C.
{
  "unoccupied_cooling_setpoint": 21.6 //Unit: °C, range: 5-35
}
unoccupied_heating_setpoint The heating target temperature is 19°C.
{
  "unoccupied_heating_setpoint": 19 //Unit: °C, range: 5-35
}
unoccupied_cooling_setpoint_tolerance The cooling target temperature tolerance is 2°C.
{
  "unoccupied_cooling_setpoint_tolerance": 2  //Unit: °C, range: 0.1-5, default: 1
}
unoccupied_heating_setpoint_tolerance The heating target temperature tolerance is 2°C.
{
  "unoccupied_heating_setpoint_tolerance": 2  //Unit: °C, range: 0.1-5, default: 1
}
target_deadband The deadband value is 2°C.
{
  "target_deadband": 2 //Unit: °C, range: 1-10, default: 5
}
When Occupancy Mode is Unoccupied or Occupied, the thermostat supports configuring central temperature as the target temperature, and adjustment tolerance to define the regulation range (=central temperature +/ adjustment tolerance). This is mainly used for BACnet downlink.
Name Example
center_cool_temp The cooling central temperature is 21.6°C.
{
  "center_cool_temp": 21.6  //Unit: °C, range: 5-35
}
center_heat_temp The heating central temperature is 19°C.
{
  "center_heat_temp": 19  //Unit: °C, range: 5-35
}
cooling_adjust_tolerance The cooling adjust tolerance is 5°C.
{
  "cooling_adjust_tolerance": 5 //Unit: °C, range: 0.5-16
}
heating_adjust_tolerance The heating adjust tolerance is 5°C.
{
  "heating_adjust_tolerance": 5 //Unit: °C, range: 0.5-16
}

Configure Unilateral Tolerance

Name Example
unilateral_tolerance Enable unilateral tolerance.
{
  "unilateral_tolerance": "enable" //disable(default), enable
}

Configure Fan Mode Parameters

Name Example
fan_mode Fan mode is Auto.
{
  "fan_mode_setting": {
    "mode": "auto"  //auto (default), always on, circulate
  }
}
fan_execute_time When fan mode is Circulate, the operation time is 10 minutes.
{
  "fan_execute_time": 10  //Unit: min/h, range: 5-55, default: 30
}
fan_delay_config Enable Fan Delay, the delay time is 300s.
{
  "fan_delay_config": {
    "enable": "enable",  //disable(default), enable
    "delay_time": 300  //Unit: s, range: 1-3600, default: 60
  }
}
fan_dehumidify Enable fan Regulate Humidity and the regulate interval is 10 minutes.
{
  "fan_dehumidify": {
    "enable": "enable",  //disable(default), enable
    "execute_time": 10  //Unit: min/h, range: 5-55, default: 30
  }
}

Temperature Control Stage Switch

Name Example
temperature_level_up_down_delta ΔT1 is 1°C , ΔT2 is 2°C. (ΔT2 must be greater than ΔT1).
{
  "temperature_level_up_down_delta": {
    "delta_1": 1, //Unit: unit: °C, range: 1-10, default: 3
    "delta_2": 2  //Unit: unit: °C, range: 1-10, default: 5
  }
}
temperature_up_down_enable Enable setforward and setback.
{
  "temperature_up_down_enable": {
    "forward_enable": "enable",  //disable, enable(default)
    "backward_enable": "enable",  //disable, enable(default)
  }
}
level_switch_settings Stage-up switch: When the ambient temperature does not change 1 °C for 10 minutes, switch to a higher heating stage.
{
  "level_switch_settings": [
    {
      "type": "heat", //heat, cool
      "time": 10,  //Unit: min, range: 1-10, default: 5
      "change_value": 1  //Unit: unit: °C, range: 1-10, default: 1
    }
  ]
}

Configure Temp. Control and Dehumidify

Name Example
humidity_range Target humidity range: 20-80%RH.
Note: Max. range value > Min. range value
{
  "humidity_range": {
    "min": 20,  //Unit: %RH, range: 0-100
    "max": 80   //Unit: %RH, range: 0-100
  }
}
temperature_dehumidify Enable Temp. Control and Dehumidify and the tolerance is 2°C.
{
  "temperature_dehumidify": {
    "enable": "enable",  //disable(default), enable
    "temperature_tolerance": 2  //Unit: °C, range: 1-5, default: 1
  }
}

Configure Schedule Parameters

Name Example
plan_type Switch schedule type to Wake.
{
  "plan_type": "wake" //wake, away, home, sleep, occupied, unoccupied, eco
}
single_temperature_plan_config Under single target mode, a Wake plan setting is as below.
{
  "single_temperature_plan_config": [
    {
      "type": "wake", //wake, away, home, sleep, occupied, unoccupied, eco
      "temperature_control_mode": "cool", //heat,em heat,cool,auto
      "fan_mode": "auto",  //auto, on ,circulate
      "target_temperature": 20,  //Unit: °C, range: 5-35, default: 17
      "target_temperature_tolerance": 1,  //Unit: °C,range: 0.1-5, default: 2
      "temperature_control_tolerance": 1  //Unit: °C,range: 0.5-10, default: 5
    }
  ]
}
dual_temperature_plan_config Under Auto-Dual Target mode, a Wake plan setting is as below.
{
  "dual_temperature_plan_config": [
    {
      "type": "wake", //wake, away, home, sleep, occupied, unoccupied, eco
      "temperature_control_mode": "cool", //heat,em heat,cool,auto
      "fan_mode": "auto",  //auto, on ,circulate
      "heat_target_temperature": 16, //Unit: °C, range: 5-35, default: 17
      "heat_temperature_tolerance": 1, //Unit: °C, range: 1-5, default: 2
      "cool_target_temperature": 20,  //Unit: °C, range: 5-35, default: 17
      "cool_temperature_tolerance": 1  //Unit: °C, range: 1-5, default: 2
    }
  ]
}
plan_schedule Add a time period for Wake type: Enable this time, the repeat day is Monday, Wednesday, Friday and Sunday, the time is 4:00.
{
  "plan_schedule": [
    {
      "plan_type": "wake", //wake, away, home, sleep, occupied, unoccupied, eco
      "id": 1,  //Range: 1-16
      "enable": "enable",  //disable, enable
      "week_recycle": {  //Repeat day
        "monday": "enable",
        "tuesday": "disable",
        "wednesday": "enable",
        "thursday": "disable",
        "friday": "enable",
        "saturday": "disable",
        "sunday": "enable"
      },
      "time": 240  //Unit: min, range: 0-1439
    }
  ]
}
plan_schedule_enable_config Disable all time periods of ECO schedule.
{
  "plan_schedule_enable_config": {
  "eco": "disable",  //disable, enable
  }
}

Enable all time periods of ECO schedule and disable others.

{
  "plan_schedule_enable_config": {
  "wake": "disable",
  "away": "disable",
  "home": "disable",
  "sleep": "disable",
  "occupied": "disable",
  "vacant": "disable",
  "eco": "enable"
  }
}

Relay Change Report

Enable or disable to report relay status when changing.
Name Example
wires_relay_change_report_enable Enable relay change report.
{
  "wires_relay_change_report_enable": "enable" //disable(default), enable
}