Skip to content

Accessory Simulations

Ben edited this page Jul 8, 2021 · 80 revisions

An accessory simulation can be used to create a custom accessory in Homebridge/HomeKit from a generic single/multi-channel device.

For example, a Sonoff Dual would, by default, appear in Homebridge as two switches. If this device were wired to a garage door then you could use an accessory simulation to make the device appear as a garage door accessory in Homebridge rather than two switches.

Since v7.0.0 of the plugin, Accessory Simulations no longer have their own configuration section. Instead, use the 'Show As' (showAs) option in the relevant configuration section for the device. For example, to setup a simulation for a TH10/16, use the 'Thermostat Devices' (thDevices[]) section of the plugin settings.

When setting up a new simulation, the plugin should remove any old switch services that originally appeared in the Home app for the device. If you remove the simulation or change from one simulation to another, the plugin will not remove the old simulation service, so you will need to remove the accessory from the Homebridge cache so the new simulation is setup properly.

Available Simulations

Documentation Pending

  • 1 Lock (with single or multi channel device)
  • 1 Tap/Faucet (with single or multi channel device)
  • 2 Taps/Faucets (with multi channel device)
  • 1 Irrigation Valve (with single or multi channel device)
  • 2 Irrigation Valves (with multi channel device)
  • 4 Irrigation Valves (with multi channel device)
  • 1 Switch + 1 Irrigation Valve (with multi channel device)
  • 1 Sensor (with single or multi channel device)
  • 1 Programmable Button (with single or multi channel device)
  • 1 Doorbell (with single or multi channel device)
  • 1 Leak Sensor (with Sonoff DW2) (see video)