[[Image(thermostat.jpg)]]

= Introduction =

The [https://apps.mios.com/plugin.php?id=1618|Radio Thermostat Wifi plug-in] enables integration of Radio Thermostat Wifi products with Vera. The plugin is designed to co-exist with existing thermostat controls, including Radio Thermostat's cloud, and manual control from the physical thermostat interface.

= Requirements =

* A Vera device with UI5
* A compatible Radio Thermostat Wifi thermostat. This plug-in was developed and tested with the [http://www.radiothermostat.com/filtrete/products/3M-50 | 3M-50], but should work with other Radio Thermostat wifi thermostats.
* Your thermostat must already be provisioned and connected to your LAN. (I suggest going through the normal provisioning process to connect your thermostat to the Radio Thermostat cloud - this will also make sure you have the latest firmware)
* You need to know the IP address of your thermostat. I suggest either assigning a static IP to the thermostat, or creating a static / permanent DHCP allocation for the thermostat in your router.
* The thermostat firmware must be version 1.04.64 or newer. To check, browse to http://IPAddressOfYourThermostat/ and look for "Firmware Version" at the bottom of the page. (the newest is 1.04.73)
* An SSH client to connect to your Vera (to workaround a bug in UI5). ** If you don't know how to SSH to your Vera, stop here. **

= Installation =

This is (currently) a UI5 only plugin, so the easiest way to install the plug-in is via the [http://docs5.mios.com/doc.php?page=mymios_web_portal|Vera Web Portal]:

1. In your Vera Web Portal, navigate to "Apps" -> "Install Apps", and then search for "Thermostat" to find the "Radio Thermostat Wifi plugin"

2. Click on "Install" to install the plugin.

3. Vera will display the message "Please wait while the plugin is downloaded". 

**Note: the following two steps are a workaround for a bug in UI5:**

4. Wait for the message "Radio Thermostat Wifi Thermostat: Lua Engine Failed to start" in the portal status display (at the top of the page).

5. You must now SSH into your Vera and execute the following command:

{{{
pluto-lzo d /etc/cmh-ludl/L_RTCOA_Wifi_dkjson.lua.lzo /etc/cmh-ludl/L_RTCOA_Wifi_dkjson.lua
}}}

6. Click "close" on the "Please wait..." dialog in the Vera portal.

7. On the Advanced Tab of the device configuration dialog, enter the IP Address of your thermostat in the "IP" field.

8. Close the configuration dialog, and click "Save" to save your configuration.

9. In a minute or two, your thermostat device will appear in your device list.

= Operation =

= Known Issues / Limitations =

* I will be filling in this section soon.