Skip to content

Multi Channel Devices

Ben edited this page Nov 6, 2020 · 19 revisions

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 (by default, useful for devices like the Sonoff 4CH)
  • a light (useful for devices like the T1-2C/3C, TX-2C/3C)
  • a fan

An extra accessory will also be added to Homebridge which acts as an "All On/Off", similar to the functionality of the eWeLink app. Some users may know this accessory as the "SW0" accessory. 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

Using HomeKit Automations

Problems can occur when controlling multiple accessories of the same physical device through automations. This is because multiple updates are sent to the device at exactly the same time, which can cause the channels to quickly flicker on and off.

When using automations, please use the "All On/Off" accessory so that only one update is sent to the device.

Controlling multiple physical devices through automations is possible, as the plugin will add a small delay between each update.

Hiding Channels

It is possible to hide both the "All On/Off" accessory and any other channel accessory from Homebridge. You can do this through the plugin settings, please see [the configuration|Configuration] in particular the hideChanFromHB option.

⚠️ If you hide any channel using the above method then it will not be available to be used in any HomeKit automation.