Skip to content
Ben edited this page Jan 23, 2022 · 6 revisions

Use the 'Fan Devices' (fanDevices[]) configuration section to customise how your iFan 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 No ""

Set the model for this device.

  • "ifan" - Sonoff iFan/02/03/04
hideLight bool No false

Only has effect if deviceModel is "ifan".

If true, the light switch will be hidden from HomeKit

ipAddress str No ""

Only has effect if deviceModel is "ifan".

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 hide the light switch for an iFan03 device:

"fanDevices": [
   {
      "deviceId": "10009553c8",
      "deviceModel": "ifan",
      "hideLight": true
   }
]