Skip to content
Ben edited this page Nov 30, 2021 · 4 revisions

Use the 'Light Devices' (lightDevices[]) configuration section to customise how your light dimmers/bulbs/strips 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
name str Yes "" A label for this device, will be used as the HomeKit name if setting up a local device.
serialNumber str Yes "" 32 digit serial number (uuid) of the device.
connection str No "default"

Connection method to use for this device. Must be one of:

  • "default" - to use a hybrid connection of local control when possible or revert to the cloud when necessary
  • "cloud" - only use cloud control
  • "local" - only use local control
deviceUrl str No "" IP address to use for the device when connection is local.
ignoreDevice bool No false If true, this accessory will be removed and ignored from HomeKit.
model str See 1 ""

2 Required when device has been setup as local

Set the model for this device. One of:

  • "MPD100"
  • "MSL-100"
  • "MSL-100D"
  • "MSL100R"
  • "MSL-120"
  • "MSL-120B"
  • "MSL-120D"
  • "MSL-120R"
  • "MSL-320"
  • "MSL-320M"
  • "MSL-420"
  • "MSL-430"
  • "MSS560"
  • "MSS560X"
  • "MSS565"
  • "MSS570"
  • "MSS570x"
brightnessStep int No 1 1 A minimum step for the brightness slider in the Home app.
adaptiveLightingShift int No 0 -1 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.
firmwareRevision str No "" For local devices, HomeKit will show this as the firmware version.
userkey str No "" Override the user key for this device if it is registered to a different Meross account.
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