MIMOlite Garage Door Plugin

Installation Guide (new version, 1.1 and after)

The following instructions are for Vera's UI7 interface.  The 1.x version of the plugfest does not support older versions of the interface.
  1. Add the Fortrezz MIMOlite module to your Z-wave network, following the Vera and MIMOlite user manuals (add as generic Z-wave device).
    1. Note, do not install the MIMOlite Plugin, which will create additional devices in Vera for each sensor included in the IO module.  These devices / sensors will not be used by the plugin.
    2. This should create a device for MIMOlite module as a "Binary Switch" or "Appliance Module."
    3. Recommend you rename that device to "<Door Name> mimo", where <Door Name> is what you plan to name your door.
  2. Install the MIMolite module according to the instructions on the Fortrezz webpage, http://www.fortrezz.com/index.php/products/mimolite
  3. Install plugin from http://apps.mios.com, once installed, plugin will create as new device for the Garage Door.
  4. Navigate to the "Variables" list under the "Advanced Tab" for the Garage Door plugin.
    1. Enter the device ID of the MIMOlite device you added in Step 1 above.
  5. Select the correct setting for "Normal" / "Invert" based on your door sensor configuration (this setting will automatically change the open/closed values for the GUI and scenes).

Installation Guide (old version, pre 1.0)

The following instructions are for Vera's UI5 interface.  The plugin currently does not support previous versions of the interface.
  1. Add the Fortrezz MIMOlite module to your Z-wave network, following the Vera and MIMOlite user manuals.
    1. Note, do not install the MIMOlite Plugin, which will create additional devices in Vera for each sensor included in the IO module.  These devices / sensors will not be used by the plugin.
  2. Install plugin from http://apps.mios.com, once installed, plugin will create the invisible device for it's files.
  3. Edit the Vera Device created when the MIMOlite module was added to the Z-wave network.
    1. Click the "Advanced" table in the device settings window.
    2. Change the "device_type" field to "urn:schemas-micasaverde-com:device:GarageDoorController:1"
    3. Change the "device_file" field to "D_MimoLiteGarageDoor.xml"
  4. Install the MIMolite module according to the instructions on the Fortrezz webpage, http://www.fortrezz.com/index.php/products/mimolite
    1. Wire the door sensor, so the contacts are "normally closed" when the door is closed.
  5. (Inverted Mode) Use the following steps if you need to connect your door sensor as "normally open."
    1. Use the following alternate device_type and device_files: "urn:schemas-micasaverde-com:device:GarageDoorControllerInverted:1" and "D_MimoLiteGarageDoor_invert.xml".  All other settings should remain the same.
The following settings are also required and recommended for your MIMOlite.
  1. On the "Device Options" tab, add the following two Configuration Settings
    1. (required): Configuration settings variable 8, size "1 byte hex" with the value "3".  This configures the MIMOlite to only use the relay in momentary (non-latching) mode.
    2. (recommend): Configuration settings variable 11, size "1 byte hex" with the value "5".  This configures the MIMOlite to hold the relay closed for 500ms, when the "Open/Close" button is pressed.  

UI7 Additional Requirements

  1. UI7 also requires an additional setting under the "Advanced" tab.  Change the "device_json" field to "D_MimoLiteGarageDoor.json" or "D_MimoLiteGarageDoor_invert.json" depending on your selected operating mode.

Operation

The door icon will indicate if the garage door is open or closed.

 
Garage Door Closed
 Garage Door is closed
 
Garage Door Open
 Garage Door is open


To open or close the door, click the "Open/Close" button one time.  Note, it may take a few moments for the door to open or close and the sensor to update the state of the icon.  Do not rapidly click the button multiple times.

Example Script (Scene)

I use a scene in our vera, which runs automatically every night at 10:40, to check the garage doors, and close them if necessary.  The scene also turns off the garage lights, etc.  The key to this scene is the Luup code, because the script should only send the "close command" if the door is actually open.  This example is for two doors.  I've found the delay is necessary to allow the transmit to the first door to finish completely before trying to close the second (reduces glitches).
-- Note, the door contacts are wired as "closed circuit" if the door is closed in this script"

-- Close door #1, if it's open
local lul_temp = luup.variable_get("urn:micasaverde-com:serviceId:SecuritySensor1","Tripped", 43) or "0"
if (lul_temp == "1") then
  luup.log("Garage door #1 open, trying to close now...")
  luup.call_action("urn:upnp-org:serviceId:SwitchPower1","SetTarget",{ newTargetValue="1" }, 43)
else
  luup.log("Garage door #1 already closed, nothing to do here.")
end

-- Small delay to let the first transmit occur
luup.sleep(700)

-- Close door #2, if it's open
local lul_temp = luup.variable_get("urn:micasaverde-com:serviceId:SecuritySensor1","Tripped", 61) or "0"
if (lul_temp == "1") then
  luup.log("Garage door #2 open, trying to close now...")
  luup.call_action("urn:upnp-org:serviceId:SwitchPower1","SetTarget",{ newTargetValue="1" }, 61)
else
  luup.log("Garage door #2 already closed, nothing to do here.")
end


Disclaimer

The MIMOlite Garage Door Plugin MUST only be installed on garage door openers that comply with the latest building and safety requirements, including, but not limited to, door openers with automatic reversing mechanisms and obstruction sensors.  Use of this plugin, related files, programs, code, etc on any garage door opener that does not include these features will create a serious safety hazard.  By using the plugin, related files, programs, etc, you hereby agree to accept all responsibility for the safe operation of the garage door and property where the module is install and hold harmless the authors of the plugin against any damages caused by the direct and indirect use of the plugin.

For additional information about the safety requirements of garage door opener systems, please refer to the Consumer Product Saftey Commission website.
Comments