Added documentation about ISY994 platform. Also added documentation about creating entities by using the Entity base class.

source/components/index.markdown

@@ -88,8 +88,19 @@ Entities are things that you want to observe within Home Assistant. Support for
   <td>Track what is being played and control playback. (temporarely disabled awaiting protobuf 3 release)</td>
 </tr>
 
+<tr>
+  <td><a href='/components/isy994.html'><img src='/images/supported_brands/universal_devices.png' class='brand overview' /></a></td>
+  <td><a href='/components/isy994.html'>Insteon and X10 Devices</a></td>
+  <td>ISY994 controller for Insteon and X10 devices as well as create custom switches and sensors.</td>
+</tr>
+
 </table>
 
+<p class='note'>
+Support for these devices is provided by the Home Assistant community and not
+the manufacturers of these devices.
+</p>
+
 ## {% linkable_title Organization %}
 | Type | Description
 | ---- | -----------
@@ -105,6 +116,10 @@ Home Assistant integrates with a variety of third party Home Automation hubs and
 [<img src='/images/supported_brands/vera.png' class='brand' />](/components/vera.html)
 [<img src='/images/supported_brands/wink.png' class='brand' />](/components/wink.html)
 
+<p class='note'>
+Support for these devices is provided by the Home Assistant community and not
+the manufacturers of these devices.
+</p>
 
 ## {% linkable_title Services %}
 

source/components/isy994.markdown

@@ -0,0 +1,120 @@
+---
+layout: page
+title: "ISY-994 Controller"
+description: "Instructions how to setup the ISY994 controller within Home Assistant."
+date: 2015-01-20 22:36
+sidebar: false
+comments: false
+sharing: true
+footer: true
+---
+
+### Basic Configuration ###
+
+The ISY994 is a home automation controller that is capable of controlling
+Insteon and X10 devices. The controller is also capable of controlling Z-Wave
+devices but that functionality has not yet been confirmed with Home Assistant.
+The ISY994 controller is manufactured by [Universal
+Devices](https://www.universal-devices.com/residential/isy994i-series/).
+
+Home Assistant is capable of communicating with any switch, sensor, and light
+that is configured on the controller. Using the programs on the controller,
+custom switches and sensors can also be created.
+
+To integrate your ISY994 controller with Home Assistant, add the following 
+section to your configuration.yaml file:
+
+```
+isy994:
+    # requried
+    host: ISY_ADDRESS
+    username: ISY_USERNAME
+    password: ISY_PASSWORD
+
+    # optional
+    sensor_string: SENSOR_STRING
+    hidden_string: HIDDEN_STRING
+```
+
+The ISY_ADDRESS should be in full URL format. For example:
+http://192.168.10.100:80
+    
+The ISY_USERNAME and ISY_PASSWORD are the configured username and password used
+to access the ISY interface.
+
+The SENSOR_STRING is a string that is used to identify which devices are to be
+treated as sensors instead of lights of switches. By default, this string is
+'Sensor'. If this string is found in the device name, Home Assistant will
+assume treat is as a sensor.
+
+The HIDDEN_STRING is a string that is used to identify which devices are to be
+hidden on Home Assistant's front page. This string will be stripped from the
+device's name before being used. By default, this value is '{HIDE ME}'.
+
+Once the ISY controller is configured, it will automatically import any lights,
+switches, and sensors it can locate.
+
+### Creating Custom Switches ###
+
+Using the Programs tab in the controller's Administrative Console, custom
+switches can be created that will appear natively inside of Home Assistant.
+Home Assistant will scan two different directories for switch configurations on
+the controller. These directories must exist at the root level. The two
+directories used to make switches are *HA.doors* and *HA.switches*. Currently,
+the two receive identical treatment in Home Assistant. 
+
+A switch is created by creating a directory under either of these root
+dirctories with the name you would like to call the switch. Two programs are
+then required in this directory: *status* and *actions*. The image below shows
+a sample configuration. This sample includes an extra program called *auto on*.
+This is ignored by Home Assistant.
+
+<p class='img'>
+  <img src='{{site_root}}/images/isy994/isy994_SwitchExample.png' />
+</p>
+
+The *status* program in this directory is what indicates if the switch is on or
+off. Only the IF clause is evaluated. If the clause returns True, the switch
+will be on. False will indicate the switch is off.
+
+<p class='img'>
+  <img src='{{site_root}}/images/isy994/isy994_SwitchStatusExample.png' />
+</p>
+
+The *actions* program indicates what should be performed to turn the switch on
+or off. The THEN clause gives instructions for turning the switch on while the
+ELSE clause gives instructions for turning the switch off. Below is an example.
+
+<p class='img'>
+  <img src='{{site_root}}/images/isy994/isy994_SwitchActionsExample.png' />
+</p>
+
+The example program above shows how to control a legacy X10 device from Home
+Assistant using an ISY controller.
+
+### Creating Custom Sensors ###
+
+Custom sensors can also be created using the Programs tab in the ISY
+controller's Administrative Console. For programs, three different root level
+folders are evaluated that are all handled a little differently inside of Home
+Assistant.
+
+  * *HA.sensors* will have states of Open or Closed
+  * *HA.states* will have states of On or Off
+  * *HA.locations* will have states of Home or Away
+
+To create a custom sensor, create a program under any of the three root
+directories. The name of the program will be the name of the sensor. An example
+below shows a location indicator setup.
+
+<p class='img'>
+  <img src='{{site_root}}/images/isy994/isy994_SensorExample.png' />
+</p>
+
+The program created only needs an IF clause. It will be evaluated to either
+Open/On/Home when it returns True and Closed/Off/Away when it returns False. An
+example is below.
+
+<p class='img'>
+  <img src='{{site_root}}/images/isy994/isy994_SensorStatusExample.png' />
+</p>