Thermostat Devices

Use the 'Thermostat Devices' (thDevices[]) configuration section to customise how your thermostat and TH10/16 devices are exposed to HomeKit.

See Supported Devices to see which devices can be customised using this section.

Configuration

The easiest way to customise these devices is via the Homebridge/HOOBS UI. However, if you prefer to edit your Homebridge config file manually then here is a list of the options and and examples:

Entry	Type	Required	Default	Min	Explanation
label	str	No	""		This setting has no effect except to help identify this device.
deviceId	str	Yes	""		eWeLink Device ID (10 characters e.g. "10000abcde".
ignoreDevice	bool	No	false		If true, this accessory will be removed and ignored from HomeKit.
deviceModel	str	See 1	""		Set the model for this device. "th" - Sonoff TH10/16 "panel" - Sonoff NSPanel "sc" - Sonoff SC "hc" - KKMOON HC-T010-EWF
showAs	str	No	"default"		Only has effect if deviceModel is "th". Expose this device as a different HomeKit accessory type. "default" - 1 Switch + Sensors (Default) "heater" - 1 Heater "cooler" - 1 Cooler "humidifier" - 1 Humidifier "dehumidifier" - 1 Dehumidifier
hideSwitch	bool	No	false		Only has effect if deviceModel is "th" and showAs is "default". If true, this accessory will hide the TH10/16 switch from HomeKit.
offset	num	No	0		You can offset the temperature that the sensor reads. An offset of 2 means 2 degrees will be added to the recorded temperature. Can be positive or negative and can include a decimal point '.'.
humidityOffset	int	No	0		You can offset the humidity that the sensor reads. An offset of 2 means 2% will be added to the recorded relative humidity. Can be positive or negative.
minTarget	int	No	10	0	Only has effect if deviceModel is "th" and showAs is "heater" or "cooler". Minimum target temperature to show in HomeKit apps.
maxTarget	int	No	30	1	Only has effect if deviceModel is "th" and showAs is "heater" or "cooler". Maximum target temperature to show in HomeKit apps.
ipAddress	str	No	""		Only has effect if deviceModel is "th". You can manually set the IP address for this device if it cannot be discovered by the plugin.
overrideLogging	str	No	"default"		Override global logging setting for this device. "default" - follows global setting "standard" for standard logging "debug" for debug logging "disable" to disable all accessory logging

Examples

An example to set a custom IP, hide the switch and set a temperature offset of 5.5 for a Sonoff TH16:

"thDevices": [
   {
      "deviceId": "10009553c8",
      "deviceModel": "th",
      "showAs": "default",
      "hideSwitch": true,
      "offset": 5.5,
      "ipAddress": "192.168.1.16"
      
   }
]

Accessory Simulations

• 1 Heater (with Sonoff TH10 or TH16)
• 1 Cooler (with Sonoff TH10 or TH16)
• 1 Humidifier (with Sonoff TH10 or TH16)
• 1 Dehumidifier (with Sonoff TH10 or TH16)