Multi Channel Devices

Use the 'Multi Channel Devices' (multiDevices[]) configuration section to customise how your multi-channel switch, outlet and light switch devices are exposed to HomeKit.

See Supported Devices to see which devices can be customised using this section.

By default, each channel of a multi-channel device will appear in Homebridge as a single switch. You can use the Home app to change how this accessory appears:

• a switch
• a light
• a fan

All ON/OFF Accessory

An extra accessory will also be added to Homebridge which acts as an "All On/Off". This accessory will show as

• ON if any of it's channels are on, and turning it off will turn all of it's channels off
• OFF if all it's channels are off, and turning it on will turn all of it's channels on

Hiding Channels

It is possible to hide both the "All On/Off" accessory and any other channel accessory from Homebridge. You can do this using the hideChannels option. If you hide any channel using the above method then it will not be available to be used in any HomeKit automation.

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: "MSS120B" "MSS420" "MSS420F" "MSS425" "MSS425E" "MSS425F" "MSS530" "MSS530H" "MSS620" "MSS620B" "MSS620S" "MSS630"
showAs	str	No	"default"		Expose this device as a different HomeKit accessory type. "default" - Switches (Default) "outlet" - Outlets
hideChannels	str	No	""		A comma separated list of channels to hide for this device. Use "0" to hide the 'All On/Off' accessory. For example "0,1,2".
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

Examples

An example for a multi channel outlet device opting to hide the 'All On/Off' accessory:

"multiDevices": [
   {
      "name": "Extension Lead",
      "serialNumber": "2009############################",
      "showAs": "outlet",
      "hideChannels": "0"
   }
]

The same example as above, also hiding channel 2, but using local connection mode (by providing the deviceUrl, model and optionally firmwareRevision:

"multiDevices": [
   {
      "name": "Extension Lead",
      "serialNumber": "2009############################",
      "deviceUrl": "192.168.1.33",
      "model": "MSS420",
      "showAs": "outlet",
      "hideChannels": "0,2",
      "firmwareRevision": "2.1.0"
   }
]