Skip to content

Single Channel Devices

Ben edited this page Jul 8, 2021 · 20 revisions

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

See Supported Devices to see which devices can be customised using the 'Single Channel Devices' section.

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 an example:

Entry Type Required Default Min Explanation
deviceId str Yes "" eWeLink Device ID (10 characters e.g. "10000abcde".
deviceModel str See 1 ""

Set the model for this device.

  • "single" - Sonoff BASIC/MINI/RF/SV/RE5V1C
  • "t" - Sonoff T1/T2/T3/TX-1C
  • "pow" - Sonoff POW/R2
  • "iw" - Sonoff IW100/IW101
  • "s" - Sonoff S20/S26/S31/S55
  • "micro" - Sonoff Micro
  • "slampher" - Sonoff SLAMPHER/R2
  • "gddc5" - Eachen GD-DC5
  • "king" - KingArt KING-Q4
  • "zb" - Zigbee Single Switch (BASICZBR3/ZBMINI/S31ZB)

1 Required with Eachen GD-DC5 - set to "gddc5" to show accessory as a garage door.

label str No "" This setting has no effect except to help identify this device.
showAs str No "default"

Expose this device as a different HomeKit accessory type.

  • "default" - 1 Switch (Default)
  • "outlet" - 1 Outlet
  • "purifier" - 1 Air Purifier
  • "doorbell" - 1 Doorbell
  • "garage" - 1 Garage Door
  • "valve" - 1 Irrigation Valve
  • "lock" - 1 Lock
  • "p_button" - 1 Programmable Button
  • "sensor" - 1 Sensor
  • "tap" - 1 Tap/Faucet

Has no effect if deviceModel is "gddc5".

inUsePowerThreshold int No 0 0

HomeKit will set the 'In Use' status of outlet devices to true when the wattage is above this number

Only has effect when deviceModel is "pow" or "iw".

"singleDevices": [
   {
      "deviceId": "10009553c8"
   },
   {
      "deviceId": "10009553c9"
   }
]