Skip to content

Commit

Permalink
initial documentation for caseta update
Browse files Browse the repository at this point in the history
  • Loading branch information
mdonoughe committed Nov 4, 2017
1 parent df50d51 commit 2b7cf2d
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion source/_components/lutron_caseta.markdown
Expand Up @@ -27,17 +27,25 @@ The currently supported Caseta devices are:

When configured, the `lutron_caseta` component will automatically discover the currently supported devices as setup in the Lutron Smart Bridge. The name assigned in the Lutron mobile app will be used to form the `entity_id` used in Home Assistant. e.g. a dimmer called 'Bedroom Lamp' becomes `light.bedroom_lamp` in Home Assistant.

To use Lutron Caseta devices in your installation, add the following to your `configuration.yaml` file using the IP of your Smart Bridge:
To use Lutron Caseta devices in your installation, you must first log in to your Lutron account and generate a certificate that allows Home Assistant to connect to your bridge. This can be accomplished by downloading and executing [this script](https://gist.github.com/mdonoughe/21c7ffa5a3fa23cc11747e852cd32daa), which will generate three files: caseta.key, caseta.crt, caseta-bridge.crt when you run it. See the instructions at the top of the script for more information.

Once you have the three necessary files, place them in your configuration directory and add the following to your `configuration.yaml`:

```yaml
# Example configuration.yaml entry
lutron_caseta:
host: IP_ADDRESS
keyfile: caseta.key
certfile: caseta.crt
ca_certs: caseta-bridge.crt
```

Configuration variables:

- **host** (*Required*): The IP address of the Lutron Smart Bridge.
- **keyfile** (*Required*): The private key that Home Assistant will use to authenticate to the bridge.
- **certfile** (*Required*): The certificate chain that Home Assistant will use to authenticate to the bridge.
- **ca_certs** (*Required*): The list of certificate authorities (usually only one) that Home Assistant will expect when connecting to the bridge.

<p class='note'>
It is recommended to assign a static IP address to your Lutron Smart Bridge. This ensures that it won't change IP address, so you won't have to change the `host` if it reboots and comes up with a different IP address.
Expand Down

0 comments on commit 2b7cf2d

Please sign in to comment.