Light Devices

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
   }
]