Mapping HomeKit Devices to a Virtual HomeSeer Device

This plugin generally treats all devices as if they were Z-Wave devices. What this means is that it expects HomeSeer to use "standard" Z-Wave values to indicate things like "on" (Value = 255), "off" (value = 0), "Open" (value =255), "closed" (value =0), etc.

If you have a device or plugin that uses different values, you can "map" it to Z-Wave using virtual devices and events. I'll illustrate this by example for a Garage Door Opener. Z-Wave and this plugin expect a Garage Door Opener to use the value of 255 to indicate "open" and the value of 0 to indicate "closed". However, I understand that at least some HomeSeer plugins, and particularly the MyQ Garage Door plugin, use values of 1 for open and 2 for closed. A virtual device can be used to map the 1 / 2 values of the MyQ plugin to the expected 0 /255 values.

How to do it:

1. Create a virtual switch in HomeSeer with Off value of 0, On Value of 255. These are the "typical" Z-Wave Off / On values and correspond to the 0 / 255 value for close / open of the Garage Door. Note, by Default, HomeSeer will try and create the virtual switch with an Off value of 0, On Value of 100. Be sure to change these to 0 / 255.

2. Create an event in Homeseer that triggers on the opening of the garage door and that will set the virtual switch to "on" when the door opens. Create another event that triggers on the closing of the garage door to set the virtual switch to "off". These two events are for reporting state to homebridge-homeseer-plugin-2018.

3. Similarly, create two more events in HomeSeer - one to Open the garage door when your virtual switch is changed to On, and another to Close it when the virtual switch is changed to "off" These two events enable control commands coming from homebridge-homeseer-plugin-2018 to be mapped back to your myQ plugin.

4. In homebridge-homeseer-plugin-2018, create a "type":"GarageDoorOpener", but rather than specifying the "ref" of the MyQ plugin, specify the "ref" of the virtual switch.

This will effect a mapping by means of the virtual switch and events between the 1 = Open, 2=Closed value in your MyQ plugin and the 0 / 255 values used by Z-Wave for a Garage Door Opener .