diff --git a/source/_components/cover.lutron_caseta.markdown b/source/_components/cover.lutron_caseta.markdown index 482fa379b247..713c45447287 100644 --- a/source/_components/cover.lutron_caseta.markdown +++ b/source/_components/cover.lutron_caseta.markdown @@ -13,14 +13,10 @@ ha_iot_class: "Local Polling" ha_release: 0.45 --- -To get your Lutron Caseta covers (Serena Shades) working with Home Assistant, first follow the instructions for the general [Lutron Caseta component](/components/lutron_caseta/). +To get Lutron Caseta roller and honeycomb shades working with Home Assistant, first follow the instructions for the general [Lutron Caseta component](/components/lutron_caseta/). -You also need to configure Lutron Caseta as a cover platform in your `configuration.yaml` file: +After setup, shades will appear in Home Assistant using an `entity_id` based on the name used in the Lutron mobile app. For example, a shade called 'Living Room Window' will appear in Home Assistant as `cover.living_room_window`. -```yaml -# Example configuration.yaml entry -cover: - - platform: lutron_caseta -``` +For more information on working with shades in Home Assistant, see the [Covers component](/components/cover/). -Your Lutron Caseta shades will be pulled into Home Assistant with the names they were assigned in the Lutron Caseta app. +Available services: `cover.open_cover`, `cover.close_cover` and `cover.set_cover_position`. Cover `position` ranges from `0` for fully closed to `100` for fully open. \ No newline at end of file diff --git a/source/_components/light.lutron_caseta.markdown b/source/_components/light.lutron_caseta.markdown index 7edfca003d5e..02e15710d62e 100644 --- a/source/_components/light.lutron_caseta.markdown +++ b/source/_components/light.lutron_caseta.markdown @@ -12,4 +12,12 @@ ha_category: Light ha_iot_class: "Local Polling" --- -To get your Lutron Caseta lights working with Home Assistant, follow the instructions for the general [Lutron Caseta component](/components/lutron_caseta/). +To get Lutron Caseta lights working with Home Assistant, follow the instructions for the general [Lutron Caseta component](/components/lutron_caseta/). + +After setup, dimmable lights including wall and plug-in dimmers will appear in Home Assistant using an `entity_id` based on the name used in the Lutron mobile app. For example, a light called 'Bedroom Lamp' will appear in Home Assistant as `light.bedroom_lamp`. + +For non-dimmable lights or switched loads, see [Lutron Caseta Switch](/components/switch.lutron_caseta/). + +For more information on working with lights in Home Assistant, see the [Lights component](/components/light/). + +Available services: `light.turn_on`, `light.turn_off` and `light.toggle`. The `light.turn_on` service supports attributes `brightness` and `brightness_pct`. \ No newline at end of file diff --git a/source/_components/lutron_caseta.markdown b/source/_components/lutron_caseta.markdown index 0367f660610a..c2a3f41f7c69 100644 --- a/source/_components/lutron_caseta.markdown +++ b/source/_components/lutron_caseta.markdown @@ -14,18 +14,20 @@ ha_release: 0.41 ha_iot_class: "Local Polling" --- -[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_caseta` component in Home Assistant is responsible for communicating with the Lutron SmartBridge for these systems. Both 'pro' and 'standard' models are supported. +[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_caseta` component in Home Assistant is responsible for communicating with the Lutron Caseta Smart Bridge for the [Caseta](http://www.casetawireless.com) product line of dimmers, switches and shades. -This component only supports the Caseta line of products. The current supported Caseta devices are: +This component only supports the [Caseta](http://www.casetawireless.com) line of products. Both Smart Bridge (L-BDG2-WH) and Smart Bridge PRO (L-BDGPRO2-WH) models are supported. For the RadioRA 2 product line, see the [Lutron component](/components/lutron/). -- Dimmers as Home Assistant lights -- Wall switches as Home Assistant switches -- Scenes as Home Assistant scenes -- Serena shades (honeycomb and roller) as Home Assistant covers +The currently supported Caseta devices are: -When configured, the `lutron_caseta` component will automatically discover the currently support devices as setup in the Lutron SmartBridge. +- Wall and plug-in dimmers as Home Assistant [lights](/components/light.lutron_caseta/) +- Wall switches as Home Assistant [switches](/components/switch.lutron_caseta/) +- Scenes as Home Assistant [scenes](/components/scene.lutron_caseta/) +- Lutron shades as Home Assistant [covers](/components/cover.lutron_caseta/) -To use Lutron Caseta devices in your installation, add the following to your `configuration.yaml` file using the IP of your lutron Smartbridge: +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: ```yaml # Example configuration.yaml entry @@ -35,8 +37,10 @@ lutron_caseta: Configuration variables: -- **host** (*Required*): The IP address of the Lutron SmartBridge. +- **host** (*Required*): The IP address of the Lutron Smart Bridge.
-It is recommended to assign a static IP address to your Lutron SmartBridge. 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.
+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.
+
+Use a DHCP reservation on your router to reserve the address or in the PRO model of the Smart Bridge, set the IP address under Network Settings in the Advanced / Integration menu in the mobile app.