WT303/WT304 – Configurable Properties

You can update a device's settings by modifying the configurable properties of its TSL model via API. This topic provides the configurable parameters for WT303/WT304 TSL model, their descriptions, and how to use them.

Usage

  1. Have an overview of the configurable properties and their default values of WT303/WT304 .
  2. Copy the example code and remove the comments and parameters that do not require modification.
  3. Edit the desired properties according to the detailed properties description .
    Note: Make sure that the edited example code complies with the JSON format requirements.
  4. Use the edited example code as the body parameters of Update Device Properties Incrementally.

Configurable Properties

The following code represents all configurable properties in the WT303/WT304 TSL model, along with their default values.

Note:
  • Click a property to view its detailed description and valid values.
  • Configure the example code as needed, then use it as the body parameters of Update Device Properties Incrementally to save time and effort.
{
    "version": "v1.0",
    "type": "TSL",
    "properties": {
        "collection_interval": { // Collecting Interval Type: struct
            "unit": "0", // Collecting Interval Unit Type: enum
            "seconds_of_time": 30, // Collecting Interval Type: int Unit: s
            "minutes_of_time": 1 // Collecting Interval Type: int Unit: min
        },
        "reporting_interval": { // Reporting Interval Type: struct
            "unit": "1", // Reporting Interval Unit Type: enum
            "seconds_of_time": 600, // Reporting Interval Type: int Unit: s
            "minutes_of_time": 10 // Reporting Interval Type: int Unit: min
        },
        "relay_changes_report_enable": false, // Relay/Valve Change Report Type: bool
        "temperature_unit": "0", // Temperature Unit Type: enum
        "temperature_source": { // Temperature Data Source Type: struct
            "type": "0", // Temperature Source Type: enum
            "lorawan_reception": { // LoRa Receive Type: struct
                "timeout": 10, // Timeout Type: int Unit: min
                "timeout_response": "0" // Device Offline Settings Type: enum
            },
            "d2d_reception": { // D2D Receive Type: struct
                "timeout": 10, // Timeout Type: int Unit: min
                "timeout_response": "0" // Device Offline Settings Type: enum
            }
        },
        "system_status": "0", // System On/Off Type: enum
        "mode_enable": "7", // Mode Enable Type: enum
        "temperature_control_mode": "1", // Temperature Control Mode Type: enum
        "target_temperature_resolution": "0", // Target Temperature Resolution Type: enum
        "heating_target_temperature": 17, // Heating Target Temperature Type: float Unit: ℃
        "cooling_target_temperature": 28, // CoolingTarget Temperature Type: float Unit: ℃
        "target_temperature_tolerance": 1, // Target Temperature Tolerance Type: float Unit: ℃
        "heating_target_temperature_range": { // Heating Target Temperature Regulation Range Type: struct
            "min": 10, // Min Value Type: float Unit: ℃
            "max": 19 // Max Value Type: float Unit: ℃
        },
        "cooling_target_temperature_range": { // Cooling Target Temperature Regulation Range Type: struct
            "min": 23, // Min Value Type: float Unit: ℃
            "max": 35 // Max Value Type: float Unit: ℃
        },
        "target_humidity_range": { // Target Humidity Regulation Range Type: struct
            "min": 40, // Min Value Type: float Unit: %
            "max": 80 // Max Value Type: float Unit: %
        },
        "temperature_control_dehumidification": { // Temp. Control and Dehumidify Settings Type: struct
            "enable": false, // Temp. Control and Dehumidify Type: bool
            "temperature_tolerance": 1 // Temp. Tolerance for Dehumidification Type: float Unit: ℃
        },
        "fan_control_mode": "0", // Fan Mode Type: enum
        "fan_delay_close": { // Fan Delay Type: struct
            "enable": false, // Fan Delay Enable Type: bool
            "time": 60 // The Duration of Delay Type: int Unit: s
        },
        "fan_auto_mode_temperature_range": { // Auto Fan Speed Control Delta Settings Type: struct
            "speed_range_1": 3, // ΔT1 Type: float Unit: ℃
            "speed_range_2": 5 // ΔT2 Type: float Unit: ℃
        },
        "timed_system_control": { // Timer Switch System Type: struct
            "command": "0", // Sub-command Type: enum
            "enable": false, // Timer Switch Enable Type: bool
            "start_cycle_settings": [ // On Time Setting Type: array Length: 4
                {
                    "id": 0, // Time ID Type: int
                    "enable": false, // Enable Type: bool
                    "execution_time_point": "0", // Time Type: local_time Unit: min
                    "execution_day_sun": false, // Sun. Type: bool
                    "execution_day_mon": false, // Mon. Type: bool
                    "execution_day_tues": false, // Tues. Type: bool
                    "execution_day_wed": false, // Wed. Type: bool
                    "execution_day_thu": false, // Thur. Type: bool
                    "execution_day_fri": false, // Fri. Type: bool
                    "execution_day_sat": false // Sat. Type: bool
                }
            ],
            "end_cycle_settings": [ // Off Time Setting Type: array Length: 4
                {
                    "id": 0, // Time ID Type: int
                    "enable": false, // Enable Type: bool
                    "execution_time_point": "0", // Time Type: local_time Unit: min
                    "execution_day_sun": false, // Sun. Type: bool
                    "execution_day_mon": false, // Mon. Type: bool
                    "execution_day_tues": false, // Tues. Type: bool
                    "execution_day_wed": false, // Wed. Type: bool
                    "execution_day_thu": false, // Thur. Type: bool
                    "execution_day_fri": false, // Fri. Type: bool
                    "execution_day_sat": false // Sat. Type: bool
                }
            ]
        },
        "intelligent_display_enable": true, // Smart Display Type: bool
        "screen_object_settings": { // Screen Display Settings Type: struct
            "enable": true, // Screen Display Type: bool
            "environmental_temperature": true, // Ambient Temperature Type: bool
            "environmental_humidity": true, // Ambient Humidity Type: bool
            "target_temperature": true, // Target Temperature Type: bool
            "schedule_name": true // Schedule Type: bool
        },
        "child_lock": { // Child Lock Type: struct
            "enable": false, // Child Lock Enable Type: bool
            "system_button": true, // System On/Off Type: bool
            "temperature_button": true, // Temperature + /- Type: bool
            "fan_button": true, // Fan Mode Type: bool
            "temperature_control_button": true, // Temperature Control Mode Type: bool
            "reboot_reset_button": true // Reboot&Reset Type: bool
        },
        "temporary_unlock_settings": { // Unlock Button Settings Type: struct
            "enable": false, // Unlock Function Enable Type: bool
            "system": false, // System On/Off Type: bool
            "temperature_up": false, // Temperature + Type: bool
            "temperature_down": false, // Temperature - Type: bool
            "fan": false, // Fan Mode Type: bool
            "temperature_control": false, // Temperature Control Mode Type: bool
            "unlocking_duration": 30 // Unlocking Time Type: int Unit: s
        },
        "time_zone": "0", // Time Zone Type: enum Unit: min
        "daylight_saving_time": { // Daylight Saving Time Type: struct
            "daylight_saving_time_enable": false, // Daylight Saving Time Type: bool
            "daylight_saving_time_offset": 60, // DST Bias Type: int Unit: min
            "start_month": "1", // Month Type: enum
            "start_week_num": "1", // Number of Week Type: enum
            "start_week_day": "7", // Week Type: enum
            "start_hour_min": "0", // Time Type: enum Unit: min
            "end_month": "1", // Month Type: enum
            "end_week_num": "1", // Number of Week Type: enum
            "end_week_day": "7", // Week Type: enum
            "end_hour_min": "0" // Time Type: enum Unit: min
        },
        "temperature_calibration_settings": { // Temperature Calibration Settings Type: struct
            "enable": false, // Temperature Calibration Type: bool
            "calibration_value": 0 // Calibration Value Type: float Unit: ℃
        },
        "humidity_calibration_settings": { // Humidity Calibration Settings Type: struct
            "enable": false, // Humidity Calibration Type: bool
            "calibration_value": 0 // Calibration Value Type: float Unit: %
        },
        "temperature_alarm_settings": { // Temperature Threshold Alarm Settings Type: struct
            "enable": false, // Temperature Threshold Alarm Type: bool
            "threshold_condition": "0", // Threshold Mode Type: enum
            "threshold_min": 0, // Value A Type: float Unit: ℃
            "threshold_max": 0 // Value B Type: float Unit: ℃
        },
        "high_temperature_alarm_settings": { // Persistent High Temperature Alarm Settings Type: struct
            "enable": false, // Persistent High Temperature Type: bool
            "difference_in_temperature": 3, // Difference in Temperature Type: float Unit: ℃
            "duration": 5 // Duration Type: int Unit: min
        },
        "low_temperature_alarm_settings": { // Persistent Low Temperature Alarm Settings Type: struct
            "enable": false, // Persistent Low Temperature Type: bool
            "difference_in_temperature": 3, // Difference in Temperature Type: float Unit: ℃
            "duration": 5 // Duration Type: int Unit: min
        },
        "schedule_settings": [ // Schedule Settings Type: array Length: 8
            {
                "id": 0, // Schedule ID Type: int
                "command": "0", // Sub-command Type: enum
                "enable": false, // Schedule Enable Type: bool
                "name_first": "TA6GLZ", // Name (prefix8) Type: string
                "name_last": "CR09", // Name (suffix8) Type: string
                "content": { // Schedule Content Type: struct
                    "fan_mode": "0", // Fan Mode Type: enum
                    "heat_target_temperature_enable": false, // Heating Target Temperature Enable Type: bool
                    "heat_target_temperature": 17, // Heating Target Temperature Type: float Unit: ℃
                    "cool_target_temperature_enable": false, // Cooling Target Temperature Enable Type: bool
                    "cool_target_temperature": 26, // Cooling Target Temperature Type: float Unit: ℃
                    "temperature_tolerance_enable": false, // Temperature Control Tolerance Enable Type: bool
                    "temperature_tolerance": 2 // Temperature Control Tolerance Type: float Unit: ℃
                },
                "cycle_settings": [ // Time Type: array Length: 16
                    {
                        "id": 0, // Time ID Type: int
                        "enable": false, // Enable Type: bool
                        "execution_time_point": "0", // Time Type: local_time Unit: min
                        "execution_day_sun": false, // Sun. Type: bool
                        "execution_day_mon": false, // Mon. Type: bool
                        "execution_day_tues": false, // Tues. Type: bool
                        "execution_day_wed": false, // Wed. Type: bool
                        "execution_day_thu": false, // Thur. Type: bool
                        "execution_day_fri": false, // Fri. Type: bool
                        "execution_day_sat": false // Sat. Type: bool
                    }
                ]
            }
        ],
        "interface_settings": { // Interface Settings Type: struct
            "object": "1" // System Type Type: enum
        },
        "valve_control_settings": { // Valve Control Setting (WT304 Only) Type: struct
            "type": "0", // Control Content Type: enum
            "control_interval": 30, // Valve Control Interval Type: int Unit: s
            "control_adjustment_range": 10, // Valve Control Adjustment Range Type: float Unit: ℃
            "opening_range": { // Valve Opening Range Type: struct
                "min": 0, // Min Value Type: int
                "max": 100 // Max Value Type: int Unit: %
            }
        },
        "fan_ec_control_settings": { // EC Fan Speed Settings (WT304 Only) Type: struct
            "type": "0", // Control Content Type: enum
            "low_threshold": 50, // Low Speed Type: int Unit: %
            "mid_threshold": 80, // Medium Speed Type: int Unit: %
            "high_threshold": 100 // High Speed Type: int Unit: %
        },
        "fan_stop_enable": true, // Fan Stop Settings Type: bool
        "valve_output_0v_enable": true, // Valve output 0% setting (WT304 Only) Type: bool
        "di_enable": false, // DI Enable Type: bool
        "di_settings": { // DI Settings Type: struct
            "object": "0", // DI Interface Type: enum
            "card_control": { // Room Card Type: struct
                "type": "0", // Control Object Type: enum
                "system_control": { // System Control Type: struct
                    "trigger_by_insertion": "1" // Insert Card Type: enum
                },
                "insertion_plan": { // Insert Schedule Type: struct
                    "trigger_by_insertion": "0", // Insert Card Type: enum
                    "trigger_by_extraction": "1" // Remove Card Type: enum
                }
            },
            "magnet_detection": { // Magnetic Contact Switch Type: struct
                "magnet_type": "0" // Sensor Type Type: enum
            }
        },
        "window_opening_detection_enable": false, // Open Window Detection Type: bool
        "window_opening_detection_settings": { // Open Window Detection Type: struct
            "type": "0", // Detection Method Type: enum
            "temperature_detection": { // Temperature Detection Type: struct
                "difference_in_temperature": 3, // Temperature Change Type: float Unit: ℃
                "stop_time": 30 // Stop Temperature Control For Type: int Unit: min
            },
            "magnet_detection": { // Magnetic Detection Type: struct
                "duration": 10 // Duration Type: int Unit: min
            }
        },
        "freeze_protection_settings": { // Freeze Protection Type: struct
            "enable": true, // Freeze Protection Type: bool
            "target_temperature": 3 // Protection Temperature Type: float Unit: ℃
        },
        "d2d_pairing_enable": false, // D2D Pairing Enable Type: bool
        "d2d_pairing_settings": [ // D2D Pairing Information Type: array Length: 5
            {
                "index": 0, // ID Type: int
                "type": "0", // Type Type: enum
                "enable": false, // Enable Type: bool
                "deveui": "HI022HTJ4SLAJQPS", // Device EUI Type: string
                "name_first": "2I3EEF0Y", // Device Name (prefix8) Type: string
                "name_last": "VKGNES8L" // Device Name (suffix8) Type: string
            }
        ],
        "d2d_master_enable": false, // D2D Controller Enable Type: bool
        "d2d_master_settings": [ // D2D Master Control Type: array Length: 10
            {
                "trigger_condition": "0", // Trigger Mode Type: enum
                "enable": false, // Enable Type: bool
                "command": "0000", // Control Command Type: string
                "uplink": false // LoRa Uplink Type: bool
            }
        ],
        "d2d_slave_enable": false, // D2D Agent Enable Type: bool
        "d2d_slave_settings": [ // D2D Controlled Type: array Length: 16
            {
                "index": 0, // D2D Controlled ID Type: int
                "enable": false, // Enable Type: bool
                "command": "0000", // Control Command Type: string
                "value": "16" // Action Status Type: enum
            }
        ]
    }
}

Description

The following table provides the description and valid values for the configurable properties of WT303/WT304.

Parameter Type Description
collection_interval Struct

The interval of sensor collecting.
unit Enum

Specify the collecting interval unit.

Valid value:
  • 0: second (Default value).
  • 1: minute.
seconds_of_time Integer

Specify the interval for collecting data (Unit: second).

  • Default value: 30
  • Valid value: 10 - 64800
minutes_of_time Integer

Specify the interval for collecting data (Unit: Minute).

  • Default value: 1
  • Valid value: 1 - 1440
reporting_interval Struct

The interval for data reporting.
unit Enum

Specify the reporting interval unit.

Valid value:
  • 0: second.
  • 1: minute (Default value).
seconds_of_time Integer

Specify the interval for data reporting (Unit: Second).

  • Default value: 600
  • Valid value: 10 - 64800
minutes_of_time Integer

Specify the interval for data reporting (Unit: Minute).

  • Default value: 10
  • Valid value: 1 - 1440
relay_changes_report_enable Boolean

Decide whether to enable Relay/Valve Change Report.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_unit Enum

Specify the temperature unit displayed on the Toolbox and the screen.

Valid value:
  • 0: ℃ (Default value).
  • 1: ℉.
temperature_source Struct

Temperature and Humidity Data Source settings.
type Enum

Specify the temperature and humidity source of the device.

Valid value:
  • 0: Embedded Temperature (Default value).
  • 1: External NTC.
  • 2: LoRaWAN Network Server.
  • 3: D2D.
lorawan_reception Struct

LoRa data source timeout settings.
timeout Integer

Specify the timeout for not receiving (Unit : minute).

  • Default value: 10
  • Valid value: 1 - 60
timeout_response Enum

Specify the settings when not receiving data from the LoRaWAN network server for the timeout.

Valid value:
  • 0: Keep Current Status (Default value).
  • 1: Valve Off & Ventilation.
  • 2: Switch to Embedded Temperature.
d2d_reception Struct

D2D data source timeout settings.
timeout Integer

Specify the timeout for not receiving (Unit : minute).

  • Default value: 10
  • Valid value: 1 - 60
timeout_response Enum

Specify the settings when not receiving data from D2D devices for the timeout.

Valid value:
  • 0: Keep Current Status (Default value).
  • 1: Valve Off & Ventilation.
  • 2: Switch to Embedded Temperature.
system_status Enum

Decide whether to turn the system On/Off.

Valid value:
  • 0: Off (Default value).
  • 1: On.
mode_enable Enum

Specify the control mode range to switches.

Valid value:
  • 7: Ventilation、Heat、Cool (Default value).
  • 3: Ventilation、Heat.
  • 5: Ventilation、Cool.
temperature_control_mode Enum

Specify the Temperature Control Mode from the control mode range.

Valid value:
  • 0: Ventilation.
  • 1: Heat (Default value).
  • 2: Cool.
target_temperature_resolution Enum

Specify the resolution to adjust and display the target temperature.

Valid value:
  • 0: 0.5 (Default value).
  • 1: 1.
heating_target_temperature Float

Specify the target temperature of heat mode ( Unit : ℃).

  • Default value: 17
  • Valid value: 5 - 35
cooling_target_temperature Float

Specify the target temperature of cool mode ( Unit : ℃).

  • Default value: 28
  • Valid value: 5 - 35
target_temperature_tolerance Float

Specify the allowed tolerance between target temperature and current temperature ( Unit : ℃).

  • Default value: 1
  • Valid value: 0.1 - 5
heating_target_temperature_range Struct

Heating Target Temperature Regulation Range settings.
min Float

Specify the minimum adjustable target temperature value when the temperature control mode is Heat ( Unit : ℃).

  • Default value: 10
  • Valid value: 5 - 35
max Float

Specify the maximum adjustable target temperature value when the temperature control mode is Heat ( Unit : ℃)

  • Default value: 19
  • Valid value: 5 - 35
cooling_target_temperature_range Struct

Cooling Target Temperature Regulation Range settings.
min Float

Specify the minimum adjustable target temperature value when the temperature control mode is Cool ( Unit : ℃).

  • Default value: 23
  • Valid value: 5 - 35
max Float

Specify the maximum adjustable target temperature value when the temperature control mode is Cool ( Unit : ℃).

  • Default value: 35
  • Valid value: 5 - 35
target_humidity_range Struct

Target Humidity Regulation Range settings.
min Float

Specify the minimum humidity value for Temp. Control and Dehumidify adjustment ( Unit : %RH).

  • Default value: 40
  • Valid value: 0 - 100
max Float

Specify the maximum humidity value for Temp. Control and Dehumidify adjustment ( Unit : %RH).

  • Default value: 80
  • Valid value: 0 - 100
temperature_control_dehumidification Struct

Temp. Control and Dehumidify Settings.
enable Boolean

Decide whether to enable Temp. Control and Dehumidify.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_tolerance Float

When reaching this tolerance over target temperature range, the device will stop heating or cooling even it is not reaching the target humidity range ( Unit : ℃).

  • Default value: 1
  • Valid value: 0.1 - 5
fan_control_mode Enum

Specify the Fan Mode.

Valid value:
  • 0: Auto (Default value).
  • 1: Low.
  • 2: Medium.
  • 3: High.
fan_delay_close Struct

Fan Delay settings.
enable Boolean

Decide whether to delay the close of fan after the system is off, or the temperature control stops under auto fan mode.

Valid value:
  • false: disable (Default value).
  • true: enable.
time Integer

Specify the duration of delay to close the fan ( Unit : second).

  • Default value: 60
  • Valid value: 30 - 3600
fan_auto_mode_temperature_range Struct

Auto Fan Speed Control Delta Settings.
speed_range_1 Float

Specify the ΔT1 value to switch between Low and Medium ( Unit : ℃). ΔT1 value must be lower than ΔT2 value.

  • Default value: 3
  • Valid value: 1 - 15
speed_range_2 Float

Specify the ΔT2 value to switch between High and Medium ( Unit : ℃).

  • Default value: 5
  • Valid value: 1 - 15
timed_system_control Struct

Timer Switch System settings.
command Enum

Specify the configuration content.

Valid value:
  • 0: Timer Switch Enable (Default value).
  • 1: On Time Setting.
  • 2: Off Time Setting.
enable Boolean

Decide whether to enable to turn on/off the system on schedule.

Valid value:
  • false: disable (Default value).
  • true: enable.
start_cycle_settings Array

On Time Setting.
id Integer

Specify the Time ID.

  • Default value: 0
  • Valid value: 0 - 3
enable Boolean

Decide whether to enable this time.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_time_point local_time

Specify the time to turn the system on.

  • Default value: 0
execution_day_sun Boolean

Decide whether to execute this plan every Sunday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_mon Boolean

Decide whether to execute this plan every Monday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_tues Boolean

Decide whether to execute this plan every Tuesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_wed Boolean

Decide whether to execute this plan every Wednesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_thu Boolean

Decide whether to execute this plan every Thursday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_fri Boolean

Decide whether to execute this plan every Friday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_sat Boolean

Decide whether to execute this plan every Saturday.

Valid value:
  • false: disable (Default value).
  • true: enable.
end_cycle_settings Array

Off Time Setting.
id Integer

Specify the Time ID.

  • Default value: 0
  • Valid value: 0 - 3
enable Boolean

Decide whether to enable this time.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_time_point local_time

Specify the time to turn the system off.

  • Default value: 0
execution_day_sun Boolean

Decide whether to execute this plan every Sunday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_mon Boolean

Decide whether to execute this plan every Monday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_tues Boolean

Decide whether to execute this plan every Tuesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_wed Boolean

Decide whether to execute this plan every Wednesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_thu Boolean

Decide whether to execute this plan every Thursday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_fri Boolean

Decide whether to execute this plan every Friday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_sat Boolean

Decide whether to execute this plan every Saturday.

Valid value:
  • false: disable (Default value).
  • true: enable.
intelligent_display_enable Boolean

Decide whether to enable Smart Display to stop updating data when the new collected value is close to the last value within 10 minutes.

Valid value:
  • false: disable.
  • true: enable (Default value).
screen_object_settings Struct

Screen Display Settings.
enable Boolean

Decide whether to enable screen display.

Valid value:
  • false: disable.
  • true: enable (Default value).
environmental_temperature Boolean

Decide whether to display ambient temperature.

Valid value:
  • false: disable.
  • true: enable (Default value).
environmental_humidity Boolean

Decide whether to display ambient humidity.

Valid value:
  • false: disable.
  • true: enable (Default value).
target_temperature Boolean

Decide whether to display target temperature.

Valid value:
  • false: disable.
  • true: enable (Default value).
schedule_name Boolean

Decide whether to display schedule name.

Valid value:
  • false: disable.
  • true: enable (Default value).
child_lock Struct

Child Lock settings.
enable Boolean

Decide whether to enable child lock.

Valid value:
  • false: disable (Default value).
  • true: enable.
system_button Boolean

Decide whether to lock System On/Off button.

Valid value:
  • false: disable.
  • true: enable (Default value).
temperature_button Boolean

Decide whether to lock Temperature + /- button.

Valid value:
  • false: disable.
  • true: enable (Default value).
fan_button Boolean

Decide whether to lock Fan Mode button.

Valid value:
  • false: disable.
  • true: enable (Default value).
temperature_control_button Boolean

Decide whether to lock Temperature Control Mode button.

Valid value:
  • false: disable.
  • true: enable (Default value).
reboot_reset_button Boolean

Decide whether to lock Reboot&Reset button.

Valid value:
  • false: disable.
  • true: enable (Default value).
temporary_unlock_settings Struct

Temporary Unlock Button Settings.
enable Boolean

Decide whether to enable temporary unlock feature.

Valid value:
  • false: disable (Default value).
  • true: enable.
system Boolean

Decide whether to enable to press System On/Off to release the lock temporarily.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_up Boolean

Decide whether to enable to press Temperature + to release the lock temporarily.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_down Boolean

Decide whether to enable to press Temperature - to release the lock temporarily.

Valid value:
  • false: disable (Default value).
  • true: enable.
fan Boolean

Decide whether to enable to press Fan Mode to release the lock temporarily.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_control Boolean

Decide whether to enable to press Temperature Control Mode to release the lock temporarily.

Valid value:
  • false: disable (Default value).
  • true: enable.
unlocking_duration Integer

Specify the unlocking time after pressing at least 2 buttons ( Unit : second).

  • Default value: 30
  • Valid value: 1 - 3600
time_zone Enum

Specify the time zone for this device.

  • Default value: 0 (UTC / Western European Time)
  • Valid value: Refer to time_zone Value for valid values and description.
daylight_saving_time Struct

Daylight Saving Time settings.
daylight_saving_time_enable Boolean

Decide whether to enable Daylight Saving Time.

Valid value:
  • false: disable (Default value).
  • true: enable.
daylight_saving_time_offset Integer

Specify the bias of Daylight Saving Time (Unit : minute).

  • Default value: 60
  • Valid value: 1 - 120
start_month Enum

Specify the start month of Daylight Saving Time.

Valid value:
  • 1 : January (Default value).
  • 2 : February.
  • 3 : March.
  • 4 : April.
  • 5 : May.
  • 6 : June.
  • 7 : July.
  • 8 : August.
  • 9 : September.
  • 10 : October.
  • 11 : November.
  • 12 : December.
start_week_num Enum

Specify the start week of Daylight Saving Time.

Valid value:
  • 1: 1st (Default value).
  • 2: 2nd.
  • 3: 3rd.
  • 4: 4th.
  • 5: last.
start_week_day Enum

Specify the start week day of Daylight Saving Time.

Valid value:
  • 1 : Monday.
  • 2 : Tuesday.
  • 3 : Wednesday.
  • 4 : Thursday.
  • 5 : Friday.
  • 6 : Saturday.
  • 7 : Sunday (Default value).
start_hour_min Enum

Specify the start time of Daylight Saving Time.

Valid value:
  • 0: 00:00 (Default value).
  • 60: 01:00.
  • 120: 02:00.
  • 180: 03:00.
  • 240: 04:00.
  • 300: 05:00.
  • 360: 06:00.
  • 420: 07:00.
  • 480: 08:00.
  • 540: 09:00.
  • 600: 10:00.
  • 660: 11:00.
  • 720: 12:00.
  • 780: 13:00.
  • 840: 14:00.
  • 900: 15:00.
  • 960: 16:00.
  • 1020: 17:00.
  • 1080: 18:00.
  • 1140: 19:00.
  • 1200: 20:00.
  • 1260: 21:00.
  • 1320: 22:00.
  • 1380: 23:00.
end_month Enum

Month

Specify the end month of Daylight Saving Time.

Valid value:
  • 1 : January (Default value).
  • 2 : February.
  • 3 : March.
  • 4 : April.
  • 5 : May.
  • 6 : June.
  • 7 : July.
  • 8 : August.
  • 9 : September.
  • 10 : October.
  • 11 : November.
  • 12 : December.
end_week_num Enum

Specify the end week of Daylight Saving Time.

Valid value:
  • 1: 1st (Default value).
  • 2: 2nd.
  • 3: 3rd.
  • 4: 4th.
  • 5: last.
end_week_day Enum

Specify the end week day of Daylight Saving Time.

Valid value:
  • 1 : Monday.
  • 2 : Tuesday.
  • 3 : Wednesday.
  • 4 : Thursday.
  • 5 : Friday.
  • 6 : Saturday.
  • 7 : Sunday(Default value).
end_hour_min Enum

Specify the end time of Daylight Saving Time.

Valid value:
  • 0: 00:00 (Default value).
  • 60: 01:00.
  • 120: 02:00.
  • 180: 03:00.
  • 240: 04:00.
  • 300: 05:00.
  • 360: 06:00.
  • 420: 07:00.
  • 480: 08:00.
  • 540: 09:00.
  • 600: 10:00.
  • 660: 11:00.
  • 720: 12:00.
  • 780: 13:00.
  • 840: 14:00.
  • 900: 15:00.
  • 960: 16:00.
  • 1020: 17:00.
  • 1080: 18:00.
  • 1140: 19:00.
  • 1200: 20:00.
  • 1260: 21:00.
  • 1320: 22:00.
  • 1380: 23:00.
temperature_calibration_settings Struct

Temperature Calibration Settings.
enable Boolean

Decide whether to enable temperature calibration.

Valid value:
  • false: disable (Default value).
  • true: enable.
calibration_value Float

Specify the calibration value (Unit: °C).

  • Default value: 0
  • Valid value: -80 - 80
    Note: This value supports setting one decimal place.
humidity_calibration_settings Struct

Humidity Calibration Settings.
enable Boolean

Decide whether to enable humidity calibration.

Valid value:
  • false: disable (Default value).
  • true: enable.
calibration_value Float

Specify the calibration value ( Unit : %RH).

  • Default value: 0
  • Valid value: -100 - 100
temperature_alarm_settings Struct

Temperature Threshold Alarm Settings.
enable Boolean

Decide whether to enable Temperature Threshold Alarm.

Valid value:
  • false: disable (Default value).
  • true: enable.
threshold_condition Enum

Specify the conditions for triggering the temperature alarm.

Valid value:
  • 0: Do NOT send temperature alarm (Default value).
  • 1: The detected temperature < Minimum threshold.
  • 2: The detected temperature > Maximum threshold.
  • 3: Minimum threshold < The detected temperature < Maximum threshold.
  • 4: The detected temperature < Minimum threshold or the detected temperature > Maximum threshold.
threshold_min Float

Specify the minimum threshold for temperature alarm (Unit: °C).

  • Default value: 0
  • Valid value: -20 - 60
threshold_max Float

Specify the maximum threshold for temperature alarm (Unit: °C).

  • Default value: 0
  • Valid value: -20 - 60
high_temperature_alarm_settings Struct

Persistent High Temperature Alarm Settings.
enable Boolean

Decide whether to enable persistent high temperature alarm.

Valid value:
  • false: disable (Default value).
  • true: enable.
difference_in_temperature Float

Specify the difference value with target temperature ( Unit : ℃).

  • Default value: 3
  • Valid value: 1 - 10
    Note: This value supports setting one decimal place.
duration Integer

Specify the duration time when current temperature is higher than the target temperature for difference value ( Unit : minute).

  • Default value: 5
  • Valid value: 0 - 60
low_temperature_alarm_settings Struct

Persistent Low Temperature Alarm Settings.
enable Boolean

Decide whether to enable persistent low temperature alarm.

Valid value:
  • false: disable (Default value).
  • true: enable.
difference_in_temperature Float

Specify the difference value with target temperature ( Unit : ℃).

  • Default value: 3
  • Valid value: 1 - 10
    Note: This value supports setting one decimal place.
duration Integer

Specify the duration time when current temperature is lower than the target temperature for difference value ( Unit : min)

  • Default value: 5
  • Valid value: 0 - 60
schedule_settings Array

Schedule Settings.
id Integer

Specify the Schedule ID.

  • Default value: 0
  • Valid value: 0 - 15
command Enum

Specify the configuration content.

Valid value:
  • 0: Schedule Enable (Default value).
  • 1: Name (prefix8).
  • 2: Name (suffix8).
  • 3: Schedule Content.
  • 4: Time.
enable Boolean

Decide whether to enable this schedule.

Valid value:
  • false: disable (Default value).
  • true: enable.
name_first String

Specify the first 6 characters of the schedule name.

  • Restrictions: <= 6 characters long.
name_last String

Specify the last 4 characters of the schedule name.

  • Restrictions: <= 4 characters long.
content Struct

Schedule Content settings.
fan_mode Enum

Specify the fan mode of the schedule.

Valid value:
  • 0: Auto (Default value).
  • 1: Low.
  • 2: Medium.
  • 3: High.
heat_target_temperature_enable Boolean

Decide whether to enable Heating Target Temperature.

Valid value:
  • false: disable (Default value).
  • true: enable.
heat_target_temperature Float

Specify the Heating Target Temperature ( Unit : ℃).

  • Default value: 17
  • Valid value: 5 - 35
cool_target_temperature_enable Boolean

Decide whether to enable Cooling Target Temperature.

Valid value:
  • false: disable (Default value).
  • true: enable.
cool_target_temperature Float

Specify the Cooling Target Temperature ( Unit : ℃).

  • Default value: 26
  • Valid value: 5 - 35
temperature_tolerance_enable Boolean

Decide whether to enable Temperature Control Tolerance.

Valid value:
  • false: disable (Default value).
  • true: enable.
temperature_tolerance Float

Specify the allowed tolerance between target temperature and current temperature ( Unit : ℃).

  • Default value: 2
  • Valid value: 0.1 - 5
cycle_settings Array

Schedule Time settings.
id Integer

Specify the schedule time ID.

  • Default value: 0
  • Valid value: 0 - 15
enable Boolean

Decide whether to enable this schedule time.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_time_point local_time

Specify the time to execute this schedule.

  • Default value: 0
execution_day_sun Boolean

Decide whether to execute this plan every Sunday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_mon Boolean

Decide whether to execute this plan every Monday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_tues Boolean

Decide whether to execute this plan every Tuesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_wed Boolean

Decide whether to execute this plan every Wednesday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_thu Boolean

Decide whether to execute this plan every Thursday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_fri Boolean

Decide whether to execute this plan every Friday.

Valid value:
  • false: disable (Default value).
  • true: enable.
execution_day_sat Boolean

Decide whether to execute this plan every Saturday.

Valid value:
  • false: disable (Default value).
  • true: enable.
interface_settings Struct

Installation Settings.
object Enum

Specify the system type.

Valid value(WT303):
  • 0: Four-pipe, Two-wire Valve+Three-speeds Fan.
  • 1: Two-pipe, Two-wire Valve+Three-speeds Fan (Default value).
  • 2: Two-pipe, Three-wire Valve+Three-speeds Fan.
Valid value(WT304):
  • 0: Four-pipe, 0~10V Valve+Three-speeds Fan.
  • 1: Two-pipe, 0~10V Valve+Three-speeds Fan (Default value).
  • 2: Two-pipe, 0~10V Valve+EC Fan.
  • 3: Four-pipe,Two-wire Valve+EC Fan.
  • 4: Two-pipe, Two-wire Valve+EC Fan.
  • 5: Two-pipe, Three-wire Valve+EC Fan.
valve_control_settings Struct

Valve Control Setting (WT304 Only).
type Enum

Specify the valve control content.

Valid value:
  • 2: Valve Control Interval.
  • 0: Valve Control Adjustment Range (Default value).
  • 1: Valve Opening Range.
control_interval Integer

Specify the Valve Control Interval ( Unit : second).

  • Default value: 30
  • Valid value: 1 - 60
control_adjustment_range Float

Specify the Valve Control Adjustment Range ( Unit : ℃).

  • Default value: 10
  • Valid value: 1 - 15
opening_range Struct

Valve Opening Range settings.
min Integer

Specify the minimum valve opening value ( Unit : %) .

  • Default value: 0
  • Valid value: 0 - 100
max Integer

Specify the maximum valve opening value ( Unit : %) .

  • Default value: 100
  • Valid value: 0 - 100
fan_ec_control_settings Struct

EC Fan Speed Settings (WT304 Only).
type Enum

Specify the control speed.

Valid value:
  • 0: Low Speed (Default value).
  • 1: Medium Speed.
  • 2: High Speed.
low_threshold Integer

Specify the voltage output percentage of Low Speed ( Unit : %).

  • Default value: 50
  • Valid value: 1 - 100
mid_threshold Integer

Specify the voltage output percentage of Medium Speed ( Unit : %).

  • Default value: 80
  • Valid value: 1 - 100
high_threshold Integer

Specify the voltage output percentage of High Speed ( Unit : %).

  • Default value: 100
  • Valid value: 1 - 100
fan_stop_enable Boolean

Decide whether to stop the fan when fan mode is Auto and the control status is standby.

Valid value:
  • false: disable (Low speed).
  • true: enable (Default value).
valve_output_0v_enable Boolean

Decide whether to control the valve to output 0% under standby control status (WT304 only).

Valid value:
  • false: disable (minimum valve opening).
  • true: enable (Default value).
di_enable Boolean

Decide whether to enable DI settings.

Valid value:
  • false: disable (Default value).
  • true: enable.
di_settings Struct

DI Settings.
object Enum

Specify the type to connect to the DI Interface.

Valid value:
  • 0: Room Card (Default value).
  • 1: Magnetic Contact Switch.
card_control Struct

Room Card settings.
type Enum

Specify the control object of the room card.

Valid value:
  • 0: System Control (Default value).
  • 1: Insert Schedule.
system_control Struct

System Control settings.
trigger_by_insertion Enum

Specify the event when inserting card.

Valid value:
  • 0: system off.
  • 1: system on (Default value).
insertion_plan Struct

Insert Schedule settings.
trigger_by_insertion Enum

Specify the schedule to execute when inserting card.

Valid value:
  • 0: Schedule1 (Default value).
  • 1: Schedule2.
  • 2: Schedule3.
  • 3: Schedule4.
  • 4: Schedule5.
  • 5: Schedule6.
  • 6: Schedule7.
  • 7: Schedule8.
  • 255: None.
trigger_by_extraction Enum

Specify the schedule to execute when removing card.

Valid value:
  • 0: Schedule1.
  • 1: Schedule2 (Default value).
  • 2: Schedule3.
  • 3: Schedule4.
  • 4: Schedule5.
  • 5: Schedule6.
  • 6: Schedule7.
  • 7: Schedule8.
  • 255: None.
magnet_detection Struct

Magnetic Contact Switch settings.
magnet_type Enum

Specify the Sensor Type to judge the open status.

Valid value:
  • 0: NO (Default value).
  • 1: NC.
window_opening_detection_enable Boolean

Decide whether to enable Open Window Detection.

Valid value:
  • false: disable (Default value).
  • true: enable.
window_opening_detection_settings Struct

Open Window Detection settings.
type Enum

Specify the Detection Method.

Valid value:
  • 0: Temperature Detection (Default value).
  • 1: Magnetic Detection.
temperature_detection Struct

Temperature Detection settings.
difference_in_temperature Float

Specify the temperature change value to detect whether the window opens ( Unit : ℃).

  • Default value: 3
  • Valid value: 1 - 10
stop_time Integer

Specify the time to stop temperature control after detecting the window open ( Unit : minute).

  • Default value: 30
  • Valid value: 1 - 60
magnet_detection Struct

Magnetic Detection settings.
duration Integer

Specify the duration to judge whether the window opens, and this is also the time to stop temperature control after detecting the window open ( Unit : minute).

  • Default value: 10
  • Valid value: 1 - 60
freeze_protection_settings Struct

Freeze Protection settings.
enable Boolean

Decide whether to enable Freeze Protection.

Valid value:
  • false: disable.
  • true: enable (Default value).
target_temperature Float

Specify the temperature to start the freeze protection ( Unit : ℃)

  • Default value: 3
  • Valid value: 1 - 5
d2d_pairing_enable Boolean

Decide whether to enable D2D data receiving feature.

Valid value:
  • false: disable (Default value).
  • true: enable.
d2d_pairing_settings Array

D2D Pairing Device Information settings.
index Integer

Specify the pairing device ID.

  • Default value: 0
  • Valid value: 0 - 4
type Enum

Specify the configuration type.

Valid value:
  • 0: Enable (Default value).
  • 1: Device EUI.
  • 2: Device Name (prefix8).
  • 3: Device Name (suffix8).
enable Boolean

Specify whether to enable to receive the data from this pairing device.

Valid value:
  • false: disable (Default value).
  • true: enable.
deveui String

Specify the Device EUI of the pairing device.

  • Restrictions: 16 characters long.
name_first String

Specify the first 8 characters of the device name.

  • Restrictions: <= 8 characters long.
name_last String

Specify the last 8 characters of the device name.

  • Restrictions: <= 8 characters long.
d2d_master_enable Boolean

Decide whether to enable D2D Controller feature.

Valid value:
  • false: disable (Default value).
  • true: enable.
d2d_master_settings Array

D2D controller settings.
trigger_condition Enum

Specify the event to trigger the device to send D2D command.

Valid value:
  • 0: Schedule1 (Default value).
  • 1: Schedule2.
  • 2: Schedule3.
  • 3: Schedule4.
  • 4: Schedule5.
  • 5: Schedule6.
  • 6: Schedule7.
  • 7: Schedule8.
  • 16: System Off.
  • 17: System On.
enable Boolean

Decide whether to enable this D2D trigger event.

Valid value:
  • false: disable (Default value).
  • true: enable.
command String

Specify the control command for D2D communication.

  • Default value: 0000
  • Restrictions: 4 characters long.
uplink Boolean

Decide whether to enable LoRa Uplink, which will send an uplink LoRa packet after sending the D2D control command.

Valid value:
  • false: disable (Default value).
  • true: enable.
d2d_slave_enable Boolean

Decide whether to enable D2D Agent feature.

Valid value:
  • false: disable (Default value).
  • true: enable.
d2d_slave_settings Array

D2D agent rule settings.
index Integer

Specify the D2D agent rule ID.

  • Default value: 0
  • Valid value: 0 - 15
enable Boolean

Decide whether to enable this rule.

Valid value:
  • false: disable (Default value).
  • true: enable.
command String

Specify the control command to receive.

  • Default value: 0000
  • Restrictions: 4 characters long.
value Enum Specify the action after receiving the specific command.
Valid value:
  • 0: Schedule1.
  • 1: Schedule2.
  • 2: Schedule3.
  • 3: Schedule4.
  • 4: Schedule5.
  • 5: Schedule6.
  • 6: Schedule7.
  • 7: Schedule8.
  • 16: System Off (Default value).
  • 17: System On.