WT401 – 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 WT401 TSL model, their descriptions, and how to use them.
Usage
- Have an overview of the configurable properties and their default values of WT401 .
- Copy the example code and remove the comments and parameters that do not require modification.
- Edit the desired properties according to the detailed
properties description
.
Note: Make sure that the edited example code complies with the JSON format requirements.
- 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 WT401 TSL model, along with their default values.
- 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
"seconds_of_time": 30, // Collecting Interval Type: int Unit: s
},
"reporting_interval": { // Reporting Interval Type: struct
"lora": { // LORA Reporting Interval Type: struct
"minutes_of_time": 10 // Reporting Interval Type: int Unit: min
}
},
"device_status": false, // Device Status Type: bool
"temperature_unit": "0", // Temperature Unit Type: enum
"data_sync_to_peer": "0", // Temperature & Humidity Data Source Type: enum
"data_sync_timeout": 10, // Data Timeout Type: int Unit: min
"ble_enable": true, // Bluetooth Enable Type: bool
"system_status": "0", // System On/Off Type: enum
"mode_enable": { // Temperature Control Mode Enable Type: struct
"heat": true, // Heat Type: bool
"em_heat": true, // EM Heat Type: bool
"cool": true, // Cool Type: bool
"auto": true // Auto Type: bool
},
"fan_enable": { // Fan Mode Enabled Type: struct
"auto": true, // Auto Type: bool
"circul": true, // Circul Type: bool
"on": false, // On Type: bool
"low": true, // Low Type: bool
"medium": true, // Medium Type: bool
"high": true // High Type: bool
},
"temperature_control_mode": { // Temperature Control Mode Type: struct
"mode": "0" // Temperature Control Mode Type: enum
},
"target_temperature_mode": "0", // Target Temperature Mode Type: enum
"target_temperature_resolution": "0", // Target Temperature Resolution Type: enum
"target_temperature_settings": { // Target Temperature Settings Type: struct
"temperature_control_mode": "0", // Temperature Control Mode Type: enum
"heat": 17, // Heat Target Temperature Type: float Unit: ℃
"em_heat": 25, // EM Heat Target Temperature Type: float Unit: ℃
"cool": 28, // Cool Target Temperature Type: float Unit: ℃
"auto": 23, // Auto Target Temperature Type: float Unit: ℃
"auto_heat": 17, // Auto-Heat Target Temperature Type: float Unit: ℃
"auto_cool": 28 // Auto-Cool Target Temperature Type: float Unit: ℃
},
"minimum_dead_zone": 5, // DeadBand Type: float Unit: ℃
"target_temperature_range": { // Target Temperature Range Type: struct
"id": "0", // Target Temperature Range ID Type: enum
"heat": { // Heat Target Temperature Range Type: struct
"min": 10, // Min Value Type: float Unit: ℃
"max": 19 // Max Value Type: float Unit: ℃
},
"em_heat": { // EM Heat Target Temperature Range Type: struct
"min": 10, // Min Value Type: float Unit: ℃
"max": 27 // Max Value Type: float Unit: ℃
},
"cool": { // Cool Target Temperature Range Type: struct
"min": 23, // Min Value Type: float Unit: ℃
"max": 35 // Max Value Type: float Unit: ℃
},
"auto": { // Auto Target Temperature Range Type: struct
"min": 10, // Min Value Type: float Unit: ℃
"max": 35 // Max Value Type: float Unit: ℃
}
},
"fan_control_mode": "0", // Fan Mode Type: enum
"pir_common": { // Occupancy Detection Type: struct
"enable": true, // Occupancy Detection Type: bool
"release_time": 30 // Occupied to Vacant Delay Type: int Unit: min
},
"pir_energy": { // Energy-saving Setting Type: struct
"enable": true, // Energy-Saving Enable Type: bool
"plan": { // Energy Saving Plan Type: struct
"occupied": "0", // Occupied Execution Type: enum
"unoccupied": "1" // Vacant Execution Type: enum
}
},
"pir_night": { // Night Occupancy Settings Type: struct
"enable": false, // Night Occupancy Settings Type: bool
"night_time": { // Nighttime Type: struct
"start": "1260", // Start Time Type: local_time Unit: min
"stop": "480" // Stop Time Type: local_time Unit: min
},
"occupied": "2" // Night Occupied Execution Type: enum
},
"screen_display_settings": { // Screen Display Settings Type: struct
"plan_name": true, // Schedule Name Type: bool
"ambient_temp": true, // Ambient Temperature Type: bool
"ambient_humi": true, // Ambient Humidity Type: bool
"target_temp": true // Target Temperature Type: bool
},
"button_custom_function": { // Button Custom Function Type: struct
"enable": false, // Enable Type: bool
"mode1": "1", // Button1 Custom Function Type: enum
"mode2": "2", // Button2 Custom Function Type: enum
"mode3": "0" // Button3 Custom Function Type: enum
},
"children_lock_settings": { // Child Lock Type: struct
"enable": false, // Enable Type: bool
"temp_up": false, // Temperature + Type: bool
"temp_down": false, // Temperature - Type: bool
"system_on_off": false, // System On/Off Type: bool
"fan_mode": false, // Fan Mode Type: bool
"temperature_control_mode": false, // Temperature Control Mode Type: bool
"reboot_reset": false, // Reboot&Reset Type: bool
"power_on_off": false, // Power On/Off Type: bool
"button1_event": false, // Button Event 1 Type: bool
"button2_event": false, // Button Event 2 Type: bool
"button3_event": false, // Button Event 3 Type: bool
"temperature_unit_switch": false // Temperature Unit Switch Type: bool
},
"unlock_button": { // Temporary Unlock Type: struct
"enable": false, // Temporary Unlock Enable Type: bool
"timeout": 30 // Temporary Unlock Time Type: int Unit: s
},
"unlock_combination_button_settings": { // Temporary Unlock Button Combination Type: struct
"button1": true, // Button 1 Type: bool
"button2": true, // Button 2 Type: bool
"button3": false, // Button 3 Type: bool
"button4": false, // Button 4 Type: bool
"button5": false // Button 5 Type: bool
},
"intelligent_display_enable": true, // Smart Display Type: bool
"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": "1", // 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": "1", // 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: %
},
"schedule_settings": [ // Schedule Settings Type: array Length: 8
{
"id": 0, // Schedule ID Type: int
"enable": false, // Enable Type: bool
"name_first": "TMD88I", // Name Type: string
"name_last": "0JB3", // Name Type: string
"content1": { // Schedule Content Type: struct
"tstat_mode": "0", // Temperature Control Mode Type: enum
"heat_target_temperature": 19, // Heating Target Temperature Type: float Unit: ℃
"em_heat_target_temperature": 25, // EM Heat Target Temperature Type: float Unit: ℃
"cool_target_temperature": 28 // Cool Target Temperature Type: float Unit: ℃
},
"content2": { // Schedule Content Type: struct
"fan_mode": "0", // Fan Mode Type: enum
"auto_target_temperature": 23, // Auto Target Temperature Type: float Unit: ℃
"auto_heat_target_temperature": 17, // Auto-Cool Target Temperature Type: float Unit: ℃
"auto_cool_target_temperature": 28 // Auto-Heat Target Temperature Type: float Unit: ℃
}
}
]
}
}
Description
The following table provides the description and valid values for the configurable properties of WT401.
| Parameter | Type | Description | ||
|---|---|---|---|---|
| collection_interval | Struct |
The interval for data collecting. |
||
| seconds_of_time | Integer |
Specify the interval for collecting data (Unit: second).
|
||
| reporting_interval | Struct |
The interval for data reporting. |
||
| lora | Struct |
The interval for data reporting when communication mode is LoRa. |
||
| minutes_of_time | Integer |
Specify the interval for data reporting (Unit: Minute).
|
||
| device_status | Boolean |
Decide whether to power on the device. Valid value:
|
||
| temperature_unit | Enum |
Specify the temperature unit. Valid value:
|
||
| data_sync_to_peer | Enum |
Specify the temperature and humidity source of the device. Valid value:
|
||
| data_sync_timeout | Integer |
Specify the timeout for not receiving (Unit : minute).
|
||
| ble_enable | Boolean |
Decide whether to enable Bluetooth. Valid value:
|
||
| system_status | Enum |
Decide whether to turn the system On/Off. Valid value:
|
||
| mode_enable | Struct |
Temperature Control Mode Enable settings. |
||
| heat | Boolean |
Decide whether to enable Heat control mode. Valid value:
|
||
| em_heat | Boolean |
Decide whether to enable EM Heat control mode. Valid value:
|
||
| cool | Boolean |
Decide whether to enable Cool control mode. Valid value:
|
||
| auto | Boolean |
Decide whether to enable Auto control mode. Valid value:
|
||
| fan_enable | Struct |
Fan Mode Enable settings. |
||
| auto | Boolean |
Decide whether to enable Auto mode. Valid value:
|
||
| circul | Boolean |
Decide whether to enable Circulate mode. Valid value:
|
||
| on | Boolean |
Decide whether to enable On mode. Valid value:
|
||
| low | Boolean |
Decide whether to enable Low mode. Valid value:
|
||
| medium | Boolean |
Decide whether to enable Medium mode. Valid value:
|
||
| high | Boolean |
Decide whether to enable High mode. Valid value:
|
||
| temperature_control_mode | Struct |
Note: This setting ONLY takes effect
when system_status is set to
1.Temperature Control Mode settings. |
||
| mode | Enum |
Specify the current temperature control mode. Valid value:
|
||
| target_temperature_mode | Enum |
Specify the Target Temperature Mode.
Note: This setting ONLY takes effect
when temperature_control_mode.mode is set to
3.Valid value:
|
||
| target_temperature_resolution | Enum |
Specify the Target Temperature Resolution. Valid value:
|
||
| target_temperature_settings | Struct |
Target Temperature Settings. |
||
| temperature_control_mode | Enum |
Specify Temperature Control Mode. Valid value:
|
||
| heat | Float |
Specify the target temperature for Heat mode ( Unit : ℃).
|
||
| em_heat | Float |
Specify the target temperature for EM Heat mode ( Unit : ℃).
|
||
| cool | Float |
Specify the target temperature for Cool mode ( Unit : ℃).
|
||
| auto | Float |
Specify the target temperature for Auto mode ( Unit : ℃).
|
||
| auto_heat | Float |
Specify the target temperature for Auto-Heat mode ( Unit : ℃).
|
||
| auto_cool | Float |
Specify the target temperature for Auto-Cool mode ( Unit : ℃).
|
||
| minimum_dead_zone | Float |
Specify the minimum allowed difference value between heating and cooling target temperature ( Unit : ℃).
|
||
| target_temperature_range | Struct |
Target Temperature Regulation Range settings. |
||
| id | Enum |
Specify the temperature control mode. Valid value:
|
||
| heat | Struct |
Target Temperature Regulation Range settings for Heat mode. |
||
| min | Float |
Specify the minimum adjustable target temperature ( Unit : ℃).
|
||
| max | Float |
Specify the maximum adjustable target temperature ( Unit : ℃)
|
||
| em_heat | Struct |
Target Temperature Regulation Range settings for EM Heat mode. |
||
| min | Float |
Specify the minimum adjustable target temperature ( Unit : ℃).
|
||
| max | Float |
Specify the maximum adjustable target temperature ( Unit : ℃)
|
||
| cool | Struct |
Target Temperature Regulation Range settings for Cool mode. |
||
| min | Float |
Specify the minimum adjustable target temperature ( Unit : ℃).
|
||
| max | Float |
Specify the maximum adjustable target temperature ( Unit : ℃)
|
||
| auto | Struct |
Target Temperature Regulation Range settings for Auto mode. |
||
| min | Float |
Specify the minimum adjustable target temperature ( Unit : ℃).
|
||
| max | Float |
Specify the maximum adjustable target temperature ( Unit : ℃)
|
||
| fan_control_mode | Enum |
Specify the current fan mode. Valid value:
|
||
| pir_common | Struct |
Occupancy Detection settings. |
||
| enable | Boolean |
Decide whether to enable occupancy detection. Valid value:
|
||
| release_time | Integer |
Specify the delay time to switch to Vacant status after Occupied status ( Unit : minute).
|
||
| pir_energy | Struct |
Energy-saving Setting. |
||
| enable | Boolean |
Decide whether to enable Energy-Saving Setting. Valid value:
|
||
| plan | Struct |
Energy Saving Plan settings. |
||
| occupied | Enum |
Specify the plan to execute when occupancy status changes to Occupied. Valid value:
|
||
| unoccupied | Enum |
Specify the plan to execute when occupancy status changes to Vacant. This value must differ from occupied execution plan. Valid value:
|
||
| pir_night | Struct |
Night Occupancy Settings. |
||
| enable | Boolean | Decide whether to enable Night Occupancy Settings. When
enabled, the device will retain Occupied status if it is
triggered during the night time. Valid value:
|
||
| night_time | Struct |
Night time settings. |
||
| start | local_time |
Specify the start time for night occupancy( Unit : minute).
|
||
| stop | local_time |
Specify the stop time for night occupancy( Unit : minute).
|
||
| occupied | Enum |
Specify the plan to execute when occupancy status changes to Occupied after the start time. Valid value:
|
||
| screen_display_settings | Struct |
Screen Display Settings. |
||
| plan_name | Boolean |
Decide whether to display Temperature Control Schedule Name. Valid value:
|
||
| ambient_temp | Boolean |
Decide whether to display Ambient Temperature. Valid value:
|
||
| ambient_humi | Boolean |
Decide whether to display Ambient Humidity. Valid value:
|
||
| target_temp | Boolean |
Decide whether to display Target Temperature. Valid value:
|
||
| button_custom_function | Struct |
Button Customization settings. |
||
| enable | Boolean |
Decide whether to enable Button Customization feature. Valid value:
|
||
| mode1 | Enum |
Specify the feature of Button1. Valid value:
|
||
| mode2 | Enum |
Specify the feature of Button2. Valid value:
|
||
| mode3 | Enum |
Specify the feature of Button3. Valid value:
|
||
| children_lock_settings | Struct |
Child Lock settings. |
||
| enable | Boolean |
Decide whether to enable Child Lock. Valid value:
|
||
| temp_up | Boolean |
Decide whether to lock Temperature +. Valid value:
|
||
| temp_down | Boolean |
Decide whether to lock Temperature -. Valid value:
|
||
| system_on_off | Boolean |
Decide whether to lock System On/Off. Valid value:
|
||
| fan_mode | Boolean |
Decide whether to lock Fan Mode. Valid value:
|
||
| temperature_control_mode | Boolean |
Decide whether to lock Temperature Control Mode. Valid value:
|
||
| reboot_reset | Boolean |
Decide whether to lock Reset. Valid value:
|
||
| power_on_off | Boolean |
Decide whether to lock Power On/Off. Valid value:
|
||
| button1_event | Boolean |
Decide whether to lock Button Event 1 report. Valid value:
|
||
| button2_event | Boolean |
Decide whether to lock Button Event 2 report. Valid value:
|
||
| button3_event | Boolean |
Decide whether to lock Button Event 3 report. Valid value:
|
||
| temperature_unit_switch | Boolean |
Decide whether to lock Temperature Unit Switch. Valid value:
|
||
| unlock_button | Struct |
Temporary Unlock settings. |
||
| enable | Boolean |
Decide whether to enable temporary button unlock. Valid value:
|
||
| timeout | Integer |
Specify the temporary unlock time ( Unit : second).
|
||
| unlock_combination_button_settings | Struct |
Temporary Unlock Button Combination settings. At least two buttons should be enabled. |
||
| button1 | Boolean |
Decide whether to use Button 1 as unlock button. Valid value:
|
||
| button2 | Boolean |
Decide whether to use Button 2 as unlock button. Valid value:
|
||
| button3 | Boolean |
Decide whether to use Button 3 as unlock button. Valid value:
|
||
| button4 | Boolean |
Decide whether to use Button 4 as unlock button. Valid value:
|
||
| button5 | Boolean |
Decide whether to use Button 5 as unlock button. Valid value:
|
||
| intelligent_display_enable | Boolean |
Decide whether to enable smart display. Valid value:
|
||
| time_zone | Enum |
Specify the time zone for this device.
|
||
| daylight_saving_time | Struct |
Daylight Saving Time settings. |
||
| daylight_saving_time_enable | Boolean |
Decide whether to enable Daylight Saving Time. Valid value:
|
||
| daylight_saving_time_offset | Integer |
Specify the bias of Daylight Saving Time (Unit : minute).
|
||
| start_month | Enum |
Specify the start month of Daylight Saving Time. Valid value:
|
||
| start_week_num | Enum |
Specify the start week of Daylight Saving Time. Valid value:
|
||
| start_week_day | Enum |
Specify the start week day of Daylight Saving Time. Valid value:
|
||
| start_hour_min | Enum |
Specify the start time of Daylight Saving Time (Unit : minute). Valid value:
|
||
| end_month | Enum |
Specify the end month of Daylight Saving Time. Valid value:
|
||
| end_week_num | Enum |
Specify the end week of Daylight Saving Time. Valid value:
|
||
| end_week_day | Enum |
Specify the end week day of Daylight Saving Time. Valid value:
|
||
| end_hour_min | Enum |
Specify the end time of Daylight Saving Time (Unit : minute). Valid value:
|
||
| temperature_calibration_settings | Struct |
Temperature calibration settings. |
||
| enable | Boolean |
Decide whether to enable temperature calibration. Valid value:
|
||
| calibration_value | Float |
Specify the calibration value (Unit: °C).
|
||
| humidity_calibration_settings | Struct |
Humidity calibration settings. |
||
| enable | Boolean |
Decide whether to enable humidity calibration. Valid value:
|
||
| calibration_value | Float |
Specify the calibration value ( Unit : %RH)
|
||
| schedule_settings | Array |
Schedule Plan Settings. |
||
| id | Integer |
Specify the Schedule ID.
|
||
| enable | Boolean |
Decide whether to enable this schedule. Valid value:
|
||
| name_first | String |
Specify the first name of the schedule.
|
||
| name_last | String | Specify the last name of the schedule.
|
||
| content1 | Struct |
Schedule Content settings. |
||
| tstat_mode | Enum |
Specify the Temperature Control Mode. Valid value:
|
||
| heat_target_temperature | Float |
Specify the Heating Target Temperature ( Unit : ℃).
|
||
| em_heat_target_temperature | Float |
Specify the EM Heat Target Temperature ( Unit : ℃).
|
||
| cool_target_temperature | Float |
Specify the Cool Target Temperature ( Unit : ℃).
|
||
| content2 | Struct |
Schedule Content settings. |
||
| fan_mode | Enum |
Specify the Fan Mode. Valid value:
|
||
| auto_target_temperature | Float |
Specify the Auto Target Temperature ( Unit : ℃).
|
||
| auto_heat_target_temperature | Float |
Specify the Auto-Cool Target Temperature ( Unit : ℃).
|
||
| auto_cool_target_temperature | Float |
Specify the Auto-Heat Target Temperature ( Unit : ℃).
|
||