How to use Lutron QS "via integration" buttons

We have a very nice Lutron QS system that works extremely well in Home Assistant. From HA, the (configured in yaml) plugin auto-discovers all lights, keypad buttons, scenes etc… Using these are pretty straightforward in terms of turning lights on and off, setting scenes, and updates on the status of lights.

We installed the system without the keypads engraved so we could make changes in the system and get it just right. Almost all the lights in the house are lutron, but a few cats and dogs just had regular switches to save money. But since we were engraving the keypads, I thought I would replace these paddles with some Zooz Zwave switches, but wanted to have some of the keypad buttons be able to turn them on and off, like a regular Lutron light.

The Homeworks integration documentation says to use the homeworks_button_press event, but I could not see this event trigger at all in the developer options menu. After searching the forum, I found reference to the lutron_event event, and this worked fine. I did submit a request to update the documentation.

So in my case, I wanted a button in the butler’s pantry to act as a toggle for the zwave switch in the pantry. Here is the event that fires when I press that button:

event_type: lutron_event
data:
  id: csd_001_pantry
  action: single
  full_id: butler_s_csd_001_pantry
origin: LOCAL
time_fired: "2023-05-07T20:42:04.092854+00:00"
context:
  id: 01GZVZ6DDWB6CBJWV13F3HY8FP
  parent_id: null
  user_id: null

So when making the trigger for this button in HA, and to toggle the light in HA, here is what my automation looks like:

Pretty easy! I hope this will make it easier for others to use the “via integration” features of the Homeworks and other systems.

2 Likes

What Home Assistant integration are you using for Lutron Homeworks QS? Did you need anything enabled on the Lutron/Homeworks side for this to work - such as an account to log into?

I have a Lutron Homeworks QS system and also have the Lutron Connect bridge so I can control my Lutron set up from an iPhone app and also HomeKit. This part works really well. However I can’t get it working with Home Assistant - not sure what integration to use or what I am doing wrong, or if it is even supported for Homeworks QS

Home assistant support for the Lutron QS is quite excellent. I use a bridge as well. Which plugin were you trying?

This is what I use: Lutron - Home Assistant

1 Like

+1 although it says it only works for radio ra2, I have this working for my homeworks qs. if you’re still struggling w/ the instructions @fresnoboy gave, pls give us as much detail as you have on what you’re doing and what issues you’re seeing.

1 Like

Hi, thanks for the reply.

So I recently moved into a house that has a pretty extensive Lutron Homeworks QS (P6-2 processor) set up of lighting, blinds and nice etched buttons around the house - it’s pretty great. I got in touch with the original installer and he also fitted a Lutron Connect. I have found this good as I can control Lutron from my phone and particularly via HomeKit for some automations.

I also have a Home Assistant Green and have been working for that to be my central smart home system for various devices I have. The one thing I’ve not been able to get working with it is Lutron.

If I try the Add Integration > Lutron > Lutron with the IP addr of the Lutron Connect and a user/password of lutron/integration it just spins for some time and then has “unexpected error”. I have also tried the user/password I use to log in to the Lutron app and it does the same. From what I had read, I assume that the lutron/integration account needs enabling on my system and may not be.

The company that set up Lutron don’t know anything about Home Assistant. I asked them if they can enable a lutron/integration account and they said “Lutron have changed their integration for QS systems on later firmware updates, user names and passwords are no longer used. I will enquire with Lutron technical but I do not believe this integration is available”

I also tried the Add Integration > Lutron > Caseta and added the IP of the connect. It then says “after submitting this form, press the black button on the back of the bridge.” but just immediately says “failed to connect”. So I am guessing this is not the right integration.

Any help appreciated!

I connected to my main repeater. not the lutron connect. try the lutron/integration. If that doesn’t work try lutron/lutron

You do not have to enable this account online. That is a default account on all the main repeaters. Only accessible via lan. Note that this is what I have done for a homeworks qs and a radio ra2. I don’t know about caseta, but I think it is the same.

Oh I didn’t know I could connect to the Lutron repeater itself, I don’t think that is connected to my network, don’t even know where the network port is. I will have to open up the panel and have a dig around in there to see. Do they all have lan ports?

i’d be very surprised if your lutron system isn’t on your network. that’s how your lutron installer connects and configures it. and if you buy a home connect bridge, the home connect plugs into your network and finds your lutron main hub and connects via your lan. you do not have to connect to it physically. just find it’s ip address.

if you don’t already have something that exposes that to you, you may need to grovel around in the router table.

Duh of course it is connected, how stupid of me. In fact I think there are 2 Lutron connections (hand labelled “Lutron” and “Lutron Up”, which is probably upstairs) in my rack other than the Lutron Connect (so 3 in total).

I don’t see anything listed in my router (Unifi Ultra Cloud Gateway) which is getting an IP address though. I’ll have to do some digging…

I am hoping I just need to find the IP address that is being used and then the integration may work…

Woo hoo - think I have it solved. So it seemed the Lutron “main repeater” was not on my network in some way. Not sure what was happening, I had changed my router recently. So I could not see it and its IP address. I power cycled the Lutron and it took a DHCP IP from my router and became visible. The home assistant integration above then worked with the lutron/integration account.

Thank you :slight_smile:

Ok, so the integration appears to have picked up all of the lights, fans and blinds in Home Assistant now - big progress. I need to go through and name them appropriately and put them in the right rooms as the naming isn’t great.

However, they don’t seem to work. For instance there is a device listed as “Centre pendant” which is a switch - turning it on does nothing and the switch turns off after a few sections (in HA). That light is in fact a dimmable light anyway. A “Centre pendant” entity is listed, clicking on this brings up the UI to set/show the dimming level but it does nothing.

I feel I may be misunderstanding something here?

I’m not sure you are missing something…you clearly got it connected as you are enumerating entities. I do seem to recall having a similar issue at the very beginning… But that was a long time ago. and I think I didn’t actively do a change to address it other than potentially restarting ha lutron or both

@jamieosh Did you make any progress here? I’m stuck at the exact same point. Adding the Lutron integration reads everything from my QS processor, but can’t turn anything on or off, or even see correctly if a lighting load is on or off.

When I turn one on, HA shows it as on for a second or so, then it shuts right back off. The light itself never changed, and the Lutron app never showed a change either.

FWIW, we have Lutron QSX processors which integrate well with the Lutron Caséta integration. We can also listen for lutron_event events in Home Assistant automations like the OP shared above.

So strange - thought I closed the loop. The issue I was facing was that Lutron’s QS (and the like) generation needed each userid to only login once. I was logging in from both HA and another older system with the same UserID, and state updates were only going to one or the other.

I created another UserID in Lutron for HA, changed creds to that, and the issue never returned.

Yes, I’ve heard that QSX is a really valuable upgrade, but the cost of upgrading just those CPUs is shockingly high, nevermind that some of the RPMs have to get replaced and so forth.

Found my own comment here (thanks past me!) when trying to recall which event type to listen for. I’m testing now I’m not getting any events when listening for lutron_event in the Events section of Developer Tools. :frowning_face:

Sorry for the delay.

No I never got this to work. All of the elements seem to list in home assistant but trying to use them does nothing and they don’t reflect the actual state. It is a shame as it seems so close yet not there :frowning:

My assumption was that HomeKit and Lutron Connect can’t be used alongside Home Assistant at the same time, but I don’t know if this is the case. I’m reluctant to remove Lutron Connect from my HomeKit set up as that is all working ok.

@mattstein111 did you get anywhere?

Yes!

The issue I was facing was that Lutron’s QS (and the like) generation needed each userid to only login once. I was logging in from both HA and Control4 with the same UserID, and state updates were only going to one or the other.

I created another UserID in Lutron JUST FOR HA, changed creds to that, and the issue never returned. It’s been ROCK solid ever since. Arguably more stable and speedy than my Control4 system, which has a first party integration.

You may need your Lutron dealer to make the second set of credentials, but once they do, give those to HomeAssistant, and you should be golden.

Good luck.

Thank you for a quick reply!

So basically the Lutron processor can only deal with 1 “thing” connected to it via a given set of credentials and the default “lutron/integration” is one set.

And I am assuming that the Lutron Connect device, which gives HomeKit access to Lutron, is maybe using the lutron/integration credentials itself? I’m not using any other thing connected to the Lutron processor other than the Lutron Connect device.

I can get in touch with the installer and ask them to come and create a new set of credentials - what is the right way to explain to them what I need? Will they understand this? I had previously asked them about Home Assistant but they know nothing about that of course.

Maybe I can try removing the Luton Connect and try just HA on it’s own :confused: