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

Use the 'Light Devices' (lightDevices[]) configuration section to customise how your dimmer, bulb and LED strip 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.

  • "d1" - Sonoff D1/R2
  • "b1" - Sonoff B1/R2
  • "l1" - Sonoff L1/Lite
  • "bulbB02BA60" - Sonoff B02-B-A60
  • "bulbB02FA60" - Sonoff B02-F-A60
  • "bulbB02FST64" - Sonoff B02-F-ST64
  • "bulbB05BA60" - Sonoff B05-B-A60
  • "bulbB05BLA19" - Sonoff B05-BL-A19
  • "king" - KingArt KING-M4
  • "zl_d" - Zigbee Light (Dimmer)
  • "zl_dc" - Zigbee Light (Dimmer + CCT)
brightnessStep int No 1 1

Only has effect if deviceModel is not "b1".

A minimum step for the brightness slider in the Home app.
adaptiveLightingShift int No 0 -1

Only has effect if deviceModel is "l1", "bulbB02BA60", "bulbB05BA60", "bulbB02FA60", "bulbB02FST64", "bulbB05BLA19" or "zl_dc".

The mired for each Adaptive Lighting update will be increased by this value, making the light appear warmer. Set to -1 to remove Adaptive Lighting feature.
ipAddress str No ""

Only has effect if deviceModel is "d1" or "bulbB05BLA19".

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 and no disabling all accessory logging for a Sonoff D1:

"lightDevices": [
   {
      "deviceId": "10009553c8",
      "deviceModel": "d1",
      "ipAddress": "192.168.1.13",
      "overrideLogging": "disable"
      
   }
]

An example for a generic Zigbee Light (Dimmer + CCT) (connected to Sonoff Zigbee Hub), setting a brightness step to 10% and disabling adaptive lighting feature:

"lightDevices": [
   {
      "deviceId": "10009553c8",
      "deviceModel": "zl_dc",
      "adaptiveLightingShift": -1,
      "brightnessStep": 10
   }
]
Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️