Skip to content

Commit c91fb86

Browse files
thecynicfabaff
authored andcommitted
Update lutron component documentaion (home-assistant#1932)
1 parent 1975b2c commit c91fb86

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

source/_components/lutron.markdown

+23-1
Original file line numberDiff line numberDiff line change
@@ -13,5 +13,27 @@ featured: False
1313
ha_release: 0.37
1414
---
1515

16-
The `lutron` component is the base for all [Lutron](http://www.lutron.com/) in Home Assistant. The preferred way to setup the `lutron` component is by enabling the [the discovery component](/components/discovery/).
16+
[Lutron](http://www.lutron.com/) is an American lighting control company. They have several lines of home automation devices that manage light switches/dimmers, occupancy sensors, HVAC controls, etc. The `lutron` component in Home Assistant is responsible for communicating with the main hub for these systems.
1717

18+
Presently, there's only support for communicating with the [RadioRA 2](http://www.lutron.com/en-US/Products/Pages/WholeHomeSystems/RadioRA2/Overview.aspx) Main Repeater and only handle light switches and dimmers.
19+
20+
When configured, the `lutron` component will automatically discover the rooms and their associated switches/dimmers as configured by the RadioRA 2 software from Lutron. Each room will be treated as a separate group.
21+
22+
To use Lutron RadioRA 2 devices in your installation, add the following to your configuration.yaml file using the IP of your RadioRA 2 Main Repeater:
23+
24+
``` yaml
25+
lutron:
26+
lutron_host: <ip>
27+
lutron_user: lutron
28+
lutron_password: integration
29+
```
30+
31+
Configuration variables:
32+
33+
- **lutron_ip** (*Required*): The IP address of the Main Repeater.
34+
- **lutron_user** (*Required*): The login name of the user. The user `lutron` always exists, but other users can be added via RadioRA 2 software.
35+
- **lutron_password** (*Required*): The password for the user specified above. `integration` is the password for the always-present `lutron` user.
36+
37+
<p class='note'>
38+
It is recommended to assign a static IP address to your Main Repeater. This ensures that it won't change IP addresses, so you won't have to change the `lutron_ip` if it reboots and comes up with a different IP address.
39+
</p>

0 commit comments

Comments
 (0)