Lutron Caseta Pro Component for Home Assistant
Lutron is an American lighting control company. They have several lines of home automation devices that manage light switches, dimmers, occupancy sensors, HVAC controls, etc.
This is a custom Home Assistant component to support the following models of Lutron bridges / main repeaters:
- Lutron Caseta Smart Bridge PRO (L-BDGPRO2-WH)
- Ra2 Select Main Repeater (RR-SEL-REP-BL)
- Ra2 Select Main Repeater for SnapAV (RR-SEL-REP2S-BL)
The bridges / main repeaters are supported through their Telnet integration interface which must be enabled for this component to function. The non-PRO model of the Caseta bridge is not supported. No other interfaces to the Smart Bridge or Main Repeater are used by this component.
The currently supported Lutron devices are:
- Wall and plug-in dimmers as Home Assistant lights
- Wall and plug-in switches as Home Assistant switches
- Scenes as Home Assistant scenes
- Lutron shades as Home Assistant covers
- Pico remotes as Home Assistant sensors
This component differs from the Lutron Caseta component in that it only works with the PRO model and uses the relatively well-documented (although still not officially supported) Telnet interface and the Lutron Integration Protocol. The Ra2 Select Main Repeater functions identically to the Caseta PRO model but with support for 100 devices and a different product line of dimmers, switches, fan controls, shades and occupancy sensors that is not compatible with Caseta.
Custom Component Installation
As this is currently a custom component, it must be installed for it to be loaded by Home Assistant.
- Create a directory
custom_componentsin your Home Assistant configuration directory ('config' share if using hass.io with the Samba add-on or
~/.home-assistant/for Linux installations).
- Copy the contents of this project including all sub-directories into the directory
It should look similar to this after installation:
/configuration.yaml /custom_components/lutron_caseta_pro.py /custom_components/casetify.py /custom_components/cover/ /custom_components/light/ ... etc...
- Proceed with first time setup.
First Time Setup
- Setup the Lutron app and add all your Lutron devices through the app. Enable Telnet Support under settings menu -> Advanced -> Integration. Also enable static IP under Network Settings and write down the IP.
- In your Home Assistant installation, install the custom component by copying in the files as noted in the instructions.
- In Home Assistant
configuration.yamlcreate a minimal configuration for the custom component (see below) using the IP address you wrote down and start Home Assistant.
- Once started and assuming first time setup, open Home Assistant on your mobile device and you should see a prompt to Configure Lutron Caseta Smart Bridge PRO on the front-end. Click on Configure and you’ll see a box to paste your Integration Report.
- Switch over to the Lutron app, go to settings -> Advanced -> Integration -> Send Integration Report. When prompted, select ‘Copy to clipboard’.
- Switch back to Home Assistant front-end and paste in the Integration Report. If your phone does not have copy and paste options, you will need to share it to yourself through email or to another app that supports copy paste.
- Once you submit the Integration Report the component should setup all your devices as dimmers and will save the Integration Report to your config directory as a JSON file.
- If you have switches or Lutron shades, open the Integration Report in your config directory using a text editor and find their Integration IDs and edit your Home Assistant configuration as described in the instructions below to tell it which devices are switches or shades. Unfortunately, the Integration Report does not contain this information so you need to do this manually if you have switches or shades. Restart Home Assistant if you change the yaml file.
After first-time configuration, the JSON-format Integration Report will be saved to your Home Assistant configuration directory as
lutron_caseta_pro_<bridge ip address>.json, where
<bridge ip address> is the IP address of the Bridge / Main Repeater. If it cannot find the Integration Report, it will use Configurator to prompt the user to enter it on the frontend.
When configured, the
lutron_caseta_pro component will load the Integration Report and setup all the zones as dimmable lights unless configured otherwise (see below).
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 'Ceiling Light' becomes
light.ceiling_light in Home Assistant. If lights or shades are assigned to an area in the Lutron app, the area name will be prepended to the entity_id. e.g. for area 'Dining Room', it would be
As a minimum, to use Lutron Caseta devices in your installation, add the following to your
configuration.yaml file using the IP of your Smart Bridge:
# Example of minimum configuration.yaml entry lutron_caseta_pro: bridges: - host: IP_ADDRESS mac: MAC_ADDRESS
IP_ADDRESSis the IP address of your Bridge / Main Repeater (e.g.
MAC_ADDRESSis the MAC address from the sticker on the bottom of your Smart Bridge / Main Repeater (e.g.
- bridges (Required): Must be a list of smart bridges. Even if you only have one bridge, use
- hostto start the list.
- host (Required): The IP address of the Lutron Smart Bridge / Main Repeater.
- mac (Optional): The MAC address of the Lutron Smart Bridge / Main Repeater. This is a unique string that is used to enable the Entity Registry feature of Home Assistant. It is optional, but strongly encouraged for your configuration to allow for renaming entities IDs and other customization features in the front-end.
Configuration with Device Types
Additional configuration is provided to set the device types according to the Integration IDs in the JSON integration report:
# Example configuration.yaml entry with device types lutron_caseta_pro: bridges: - host: 192.168.1.100 mac: a0:f6:fd:12:34:56 # Note: Configure only switches and shades, all others will be dimmers switch: [ 4, 5 ] cover: [ 11, 12 ]
- switch (Optional): Array of integration IDs ("ID" in the "Zones" section of Integration Report)
- cover (Optional): Array of integration IDs ("ID" in the "Zones" section of Integration Report)
In the above example Zone 4 and 5 are configured as switches (e.g.
switch.<device name> in Home Assistant) and Zones 11 and 12 are shades (e.g.
cover.<device name> in Home Assistant). If a listed ID is not found in the Integration Report, it will be ignored.
The Integration Report must be updated after any change to device configuration such as pairing new devices or scene renaming. For scenes, only adding or removing a scene or changing a scene's name will modify the Integration Report and changing light or shade levels will not affect it.
To update the Integration Report, delete the JSON Integration Report from your Home Assistant configuration directory, restart Home Assistant and follow the procedure above for first time setup.
To update the custom component, copy the latest files into
custom_components directory and overwrite existing files. If you have no other custom components, you can remove the contents of the directory before copying the files.
Pico Remote Sensors
All Pico remotes in the system will each get their own
sensor in Home Assistant.
The sensor's value will change when a button is pressed according to this button map.
Example Automation for a Pico Button
- alias: Media Pico Button 1 id: '1522884919017' action: - alias: Turn on Watch TV service: remote.turn_on data: activity: '29535421' entity_id: remote.living_room_harmony condition:  trigger: - platform: state entity_id: sensor.media_pico to: '1'
Enable debugging in your main configuration.yaml to see more logging:
logger: default: info logs: custom_components: debug
If connection errors are evident, try connecting to the IP listed in the configuration using a Telnet client such as PuTTY. A connection refused or timeout error indicates the wrong IP address has been used or the Telnet Support has not been enabled in the mobile app under Settings -> Advanced -> Integration.
- Confirm compatibility with Lutron occupancy sensors on Ra2 Select.