Thermostat Devices - homebridge-plugins/homebridge-ewelink GitHub Wiki

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

Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️