Accessory Simulations

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.

Please do take note as these accessory simulations require specific setup and configuration.

• For any of these setups, you can use the label option within the json config block which has no effect except to be a helpful label for identifying which device this is when editing the configuration.

• For any of these setups, you can use the overrideDisabledLogging option within the json config block to enable logging for your accessory if you have the general disableDeviceLogging set to true.

• For any of these setups which use a LAN mode compatible device (for example Sonoff BASIC, MINI) you can use the ipAddress option within the json config block to manually set the IP for this device if the plugin cannot obtain the IP automatically.

⚠️ After setting up any Accessory Simulation in the configuration, you may need to remove the existing accessory from the cache so that it removes any existing switch services (otherwise the accessory will appear duplicated in HomeKit)

Available Simulations

• 1 Garage Door (with single channel device)
• 1 Garage Door (with multi channel device)
• 1 Garage Door (with Eachen GDDC5)
• 2 Garage Doors (with multi channel device)
• 4 Garage Doors (with multi channel device)
• 1 Window Blind (with multi channel device)
• 1 Door (with multi channel device)
• 1 Window (with multi channel device)
• 1 Heater (with Sonoff TH10 or TH16)
• 1 Cooler (with Sonoff TH10 or TH16)
• 1 Humidifier (with Sonoff TH10 or TH16)
• 1 Dehumidifier (with Sonoff TH10 or TH16)

Documentation Pending

• 1 Lock (with single channel device)
• 1 Lock (with multi channel device)
• 1 Tap/Faucet (with single channel device)
• 1 Tap/Faucet (with multi channel device)
• 2 Taps/Faucets (with multi channel device)
• 1 Irrigation Valve (with single channel device)
• 1 Irrigation Valve (with 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 Leak Sensor (with Sonoff DW2)