homeworks qs home assistant

Navigation Menu

Search code, repositories, users, issues, pull requests..., provide feedback.

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly.

To see all available qualifiers, see our documentation .

• Notifications You must be signed in to change notification settings

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement . We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Homeworks Illumination, QS & QSX #33675

hrmpl42 commented Jul 10, 2024

github-actions bot commented Sep 8, 2024

Sorry, something went wrong.

No branches or pull requests

Lutron Caséta

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. The lutron_caseta integration in Home Assistant is responsible for communicating with the Lutron Caseta Smart Bridge for the Caseta product line of dimmers, switches, shades, and sensors. It will also communicate with the Lutron Radio RA2 Main Repeater for the RA2 Select product line of dimmers, switches, shades, and sensors.

This integration supports the Caséta , RA2 Select , RadioRA 3 , and Homeworks QSX (not QS) lines of products.

Supports Bridges:

• Lutron Caséta Smart Hub (L-BDG2-WH)
• Lutron Caséta Smart Bridge PRO (L-BDGPRO2-WH)
• RA2 Select Main Repeaters (RR-SEL-REP2-BL)
• QSX Processor (HQP7)
• RadioRA 3 All-in-One Processor (RR-PROC3)

For the RadioRA 2 and HomeWorks QS product lines, see the Lutron integration .

The currently supported devices are:

• Wall and plug-in dimmers as lights
• Wall switches as switches
• Scenes as scenes
• Lutron shades as covers
• Lutron smart fan speed control
• Lutron Occupancy/Vacancy sensors
• Pico Remotes as device triggers
• Shade Remotes as device triggers

When configured, the Lutron Caséta integration will automatically discover the currently supported devices as set up 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 ‘Lamp’ in a room called ‘Bedroom’ becomes light.bedroom_lamp in Home Assistant.

Configuration

To add the Lutron Caséta integration to your Home Assistant instance, use this My button:

Lutron Caséta can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered . You can then set it up right away.

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

Browse to your Home Assistant instance.

Go to Settings > Devices & Services .

In the bottom right corner, select the Add Integration button.

From the list, select Lutron Caséta .

Follow the instructions on screen to complete the setup.

Manual hub configuration

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 following the steps here , which will generate three files: caseta.key, caseta.crt, caseta-bridge.crt when you run it.

If you already have caseta.key , caseta.crt , caseta-bridge.crt , and cannot physically access the bridge to press the button, pairing can be done by utilizing these existing files.

Once you have the three necessary files, place them in your configuration directory and add the following to your configuration.yaml The configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] :

Note that multiple hubs can be specified by using multiple configuration blocks, but each of them requires its own keyfile , certfile , and ca_certs to be generated and specified.

Configuration Variables

The IP address of the Lutron Smart Bridge.

The private key that Home Assistant will use to authenticate to the bridge.

The certificate chain that Home Assistant will use to authenticate to the bridge.

The list of certificate authorities (usually only one) that Home Assistant will expect when connecting to the bridge.

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.

To get Lutron Caseta roller, honeycomb shades, wood blinds, lights, scene and switch working with Home Assistant, first follow the instructions for the general Lutron Caseta integration above.

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 .

For more information on working with shades in Home Assistant, see the Covers integration .

Available actions: cover.open_cover , cover.close_cover , cover.stop_cover and cover.set_cover_position . Cover position ranges from 0 for fully closed to 100 for fully open.

Available actions for tilt-only wood blinds: cover.open_cover_tilt , cover.close_cover_tilt , cover.stop_cover_tilt , cover.toggle_tilt . Cover position is 0 or 100 for fully closed and 50 for fully open.

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 the switch section on this page.

For more information on working with lights in Home Assistant, see the Lights integration .

The Lutron Caseta scene platform allows you to control your Smart Bridge Scenes that are created in the Lutron mobile app.

After setup, scenes will appear in Home Assistant using an entity_id based on the name used in the Lutron mobile app. For example, a scene called ‘Entertain’ will appear in Home Assistant as scene.entertain .

For more information on working with scenes in Home Assistant, see the Scenes integration .

Scenes are not directly supported on RA3 and QSX models, however the button platform (see below) can be used to activate scenes for these systems.

After setup, switches will appear in Home Assistant using an entity_id based on the name used in the Lutron mobile app. For example, a light switch called ‘Master Bathroom Vanity’ will appear in Home Assistant as switch.master_bathroom_vanity .

For dimmable lights including wall and plug-in dimmers, see the light section on this page.

For more information on working with switches in Home Assistant, see the Switches integration .

After setup, fans will appear in Home Assistant using an entity_id based on the name used in the Lutron mobile app. For example, a light switch called ‘Master Bedroom Ceiling Fan’ will appear in Home Assistant as fan.master_bedroom_ceiling_fan .

For more information on working with fans in Home Assistant, see the Fans integration .

Occupancy sensors can be added to a Lutron Caseta system to trigger events when an area becomes vacant and, optionally, occupied. However, Lutron systems report occupancy and vacancy statuses only in occupancy groups – that is, groups of one or more sensors.

Occupancy groups will appear in Home Assistant using an entity_id based on the area name in which the first sensor of the group is located. For example, one or more sensors in the Master Bathroom will appear in Home Assistant as binary_sensor.master_bathroom_occupancy .

An occupancy group is considered occupied if any of the sensors in the group are currently in an “occupied” state. Specifically, this means that motion has been detected more recently than that sensor’s particular timeout setting. Only after all sensors in an occupancy group report being vacant does the occupancy group itself report being vacant.

Lutron Caseta occupancy sensors support 4 different timeouts and 3 different sensitivity levels, but those are only controllable from the devices themselves and cannot be set from either Home Assistant or even the Caseta mobile app.

Because Lutron Caseta devices automatically report state to Home Assistant (rather than relying on polling), occupancy status updates occur almost instantaneously.

For more information on working with binary sensors in Home Assistant, see the Binary Sensors integration

Button Entities are created for each Keypad button and Pico Remote button present within the system. Radio RA3 and HomeWorks QSX systems can use these button entities to activate scenes that are defined within the Lutron system.

For more information on working with buttons in Home Assistant, see the Buttons integration .

Pico and Shade Remotes

Pico and Shade remotes are supported on the Smart Bridge (L-BDG2-WH), Smart Bridge PRO (L-BDGPRO2-WH), and RA2 Select (RR-SEL-REP2-BL) models.

Device triggers are implemented for press and release of each button on the remotes via watching for lutron_caseta_button_event events in the format:

Help us improve our documentation

• Whole Home Solutions
• Color, Style, & Fabrics
• Residential Applications
• Right Environment
• Human Centric Lighting
• Tunable White & Color Control
• Smart Buildings
• Color, Style & Fabrics
• Service Overview
• Market Segments Market Segments
• Case Studies
• Dimmers & Switches
• Fan Controls
• In-wall Sensors
• LED+ Dimmers
• Wallplates & Accessories
• Commercial Lighting Overview
• Code Smart Guestroom System
• Contract Roller
• Hyperion Solar-adaptive Shading
• Ketra Lighting
• Finiré Downlights
• Lumaris Tape Light
• LED Upgrades
• Vive Fixture Control
• Service Offerings
• Technology Support Plan
• Replacement & Upgrade
• Service FAQs
• Technical Documentation & Support Overview
• Specification Guides
• Product Specification Submittals
• Performance Specifications
• Installation Instructions
• Wiring Diagrams

CAD Downloads

• Revit Downloads
• Engraving Sheets
• Product Customization Forms
• UL Conditions of Acceptability
• Technical Papers

Application Notes

Technical Reference Guides

• Design & Configuration Software
• Product Selection Tools
• User Guides & Videos
• Technical FAQs
• Legacy Products
• Customer Support
• Serena Shades
• Not Sure Who to Contact?
• Dimming Basics
• How to install a dimmer
• Quick & Easy Troubleshooting
• What is Light Control?
• Energy Efficiency
• LED Center of Excellence
• Technologies
• Glossary of Terms
• Codes & Standards, US & Canada
• Commercial Application Guides
• Energy Saving Strategies
• Energy Benchmarking
• Continuing Education (CEU)
• North America Locations
• Lutron Worldwide
• The Lutron Experience Center
• Media & Press Center
• International Contact Information
• Provide Site Feedback
• Register or Login to myLutron
• United States | English (US)
• Where to Buy

How can we help you today?

Product Selection

FAQs Documents

Troubleshooting

Popular Topics

• Cleaning Recommendations for Lutron Products
• Help wiring your dimmer
• All your 0-10V questions answered
• Find the correct LED bulb or LED Dimmer

For the most uncompromising home integration projects. Equip yourself and your team of technology craftspeople with the ultimate in design freedom, innovative technology, and reliable quality. Push against the limits of what’s possible with the Lutron HomeWorks home automation system.

Design Freedom

Every project is different. Equip your team with the freedom to design, customize, and integrate a solution tailored to the unique demands of each project.

Reliable Quality

What’s the opposite of planned obsolescence? That’s what HomeWorks is. Build each system to be a durable part of the home with components that Lutron end-of-line tests and backs with an extensive warranty.

Innovative Technology

Innovation is more than new for new’s sake—it has to deliver real value. HomeWorks lets your team enrich and simplify your clients’ lives with Lutron’s most advanced and customizable technology.

Download the Luxury Experience App

The Lutron Luxury Experience App brings the showroom to your iPad. Guide clients on an immersive, virtual journey where they can interact with Lutron products—and visualize designs in their homes. Available now for iPadOS 16.4 or later.

Only with HomeWorks. We designed and engineered the Lutron Intelligent Light Portfolio from the ground up, authoring dozens of patents and industry firsts to redefine how light in the home should feel.

Precise, whisper-quiet, natural-light control. Lutron Shading solutions bring low-voltage and battery-powered glare reduction, UV protection, and privacy control to new and existing homes.

Powerful simplicity. Elevate the home’s design and simplify system interactions with a line of custom-engraved, HomeWorks-exclusive switches, remotes, and keypads.

Integrations

Security, climate control, A/V, home automation, voice—with Lutron’s LEAP API, third-party integrations have never been more responsive, reliable, or secure.

Lutron Connect

Unified teams equals extraordinary results. Accelerate your business and deliver industry-defining client experiences with a breakthrough platform of cloud-connected hardware and software. Lutron Connect streamlines, synchronizes, and simplifies work, establishing the new foundation for future Lutron innovations. 

Streamlined Workflow

Simplify the design, commissioning, and maintenance of a project with cloud-connected tools. 

Quick Integration

Save time with responsive, reliable, and secure 3rd-party integrations via the LEAP API.

Cloud-Synced Collaboration

Work with confidence and keep the whole team in sync with real-time project updates, tracked file versions, and automatic backups.

Over-The-Air Updates

Eliminate downtime for your clients and future-proof connected systems by delivering pain-free system enhancements.

HomeWorks System Options

Keypad, Dimmer, Switch, Fan Control and Companion

Dimmer, Switch, Fan Control, and Companion

Dynamic spectrum illumination

High performance downlight supporting both warm dimming and white tuning.

Static white lighting with warm-dimming option

High performance tape lighting supporting both warm dimming and white tuning.

HomeWorks Resources

Specification Documents

Installation Guides

Need a Rep?

Find a sales rep to help create, design, and deliver a complete solution for your workplace.

Have a question?

Let us help you choose the right solution for your job.

• United States
• Middle East
• Latin America

Sivoia QS Wireless Insulating Honeycomb Shades

Insulating Honeycomb Shades represent an evolution in Lutron window treatment operation, as they are the first wire-free, battery-powered shading solution.  

HomeWorks Whole Home Control

Saves energy with unparalleled total home control and easily integrate with third party manufacturers to control lights and shades. All equipment and temperature controls from a single keypad.

• App & Integration

Tools & Downloads

For over three decades, homeworks has been redefining expectations around the seamless control of light in a home. bringing together a legacy of best in class dimming technology, window coverings and now, fixtures, the next generation of homeworks raises the bar on creating beautiful light throughout the home., exceptional aesthetics.

Complement interior décor with sophisticated, intuitive controls, and create the perfect scene with a single button press. Keypads are available in a variety of styles and finishes and customisable to fit your needs. The Alisse Wall Control is an elegant, balanced and versatile control that curates magical lighting experiences at the touch of a button. Choose from a palette of exquisite metal finishes to complement any interior.

Refined daylight control

Energise your mornings with natural light, while ensuring privacy when you want it. Quiet automated blinds work at the touch of a button or through a personalised schedule. Our blinds solutions feature an expertly curated fabric collection to coordinate with your interior design.

A transformative environment

Experience unequaled lighting control that can transform a space in accordance with your mood or the task at hand. HomeWorks delivers an unlimited palette of personalised scenes that is yours to design, control and enjoy.

Smart living

Your lighting  can automatically know when you come and go. You can also control lights, blinds, and temperature when you are away - around the block or around the world— so you can always keep an eye on your home.

The power of voice

Set the perfect atmosphere or activate lighting that is right for the task at hand  - Lights  come on. Blinds open. Your favorite playlist fills the background - at your command.

The Lutron Difference

Our innovation, quality, and service remain the foundations of our company. When you choose Lutron, you can trust that your system, with its powerful controls, intelligent blinds, and beautiful light, will work as it’s supposed to, every time. Because we have the highest confidence in the quality of our products, HomeWorks is backed by an 8-year warranty. Our solutions are also backed by industry-best 24/7 technical support, so you can always reach us.

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

Home › News

Lutron Now Compatible with Google Home

Lutron Electronics has announced new integration with Google Home that allows homeowners to voice control their Lutron Caséta Wireless, RadioRA 2, and HomeWorks QS lighting systems using the Google Home.

By RS Staff

“OK Google, turn on the family room lights.”

Lutron Electronics has announced new integration with Google Home that allows homeowners to voice control their Lutron Caséta Wireless, RadioRA 2, and HomeWorks QS lighting systems using the Google Home, a voice-enabled speaker powered by the Google Assistant.

“Lutron continues to work with best-in-class companies to enhance our customers’ connected home experience. This latest integration with the Google Assistant reinforces Lutron’s leadership in the connected home space,” said Ed Blair, senior vice president at Lutron Electronics. “With Google Home’s voice-powered Google Assistant, customers can interact with and direct their connected homes easier than ever, and for today’s busy families, this service is invaluable.”

In addition to Google Home, the Google Assistant is accessible on Pixel (a phone by Google, and the first with the Google Assistant built in), select Android phones, and Android Wear. 

The Google Assistant will work with Lutron’s Caseta Wireless system (available now) via the Smart Bridge, and the RadioRA 2 and HomeWorks QS (available in June) via the Lutron Connect Bridge. 

Visit CasetaWireless.com/GoogleAssistant , Lutron.com/RadioRA2 , and Lutron.com/HomeWorksQS for more information. 

Priced from $99, Caséta Wireless kits are available on Amazon.com, The Apple Store, and Apple.com, BestBuy.com, and Best Buy stores, HomeDepot.com, and The Home Depot stores, Lowes.com and Lowe’s Home Improvement centers, Magnolia Design Centers, select Magnolia Home Theater stores, and from local electricians, lighting showrooms, electrical distributors, and home technology professionals. The free Lutron App for Caséta Wireless is available on Google Play and iTunes. Visit www.casetawireless.com for more information. 

RadioRA 2 and HomeWorks QS are available from authorized dealers in the U.S. and Canada, as well as authorized dealers in select regions of Central and South America. Some components are also available in Europe. Visit www.lutron.com/wheretobuy to locate an authorized dealer. 

In September 2016, Lutron began integrating its HomeWorks QS and RadioRA 2 lighting control systems with Amazon Alexa, after enabling voice control via its Caséta Wireless system earlier in the year.

New Tech Week: Tech Showcase — Residential Systems Best of Show Winners at CEDIA Expo 2023

Companies to Watch 2024

Review: Lutron RadioRA 3 Lighting and Palladiom Shading System

Tech Showcase: Lighting Solutions

Tech Showcase: Residential Systems Best of Show at CEDIA Expo 2021 Award Winners

2021 Fall Product Guide

Review: Orro One Smart Touchscreen Lighting Controller

Tech Showcase: Lighting Control

Lutron HomeWorks QS Keypad Integration

Hi I have a HomeWorks QS system and the idea is to use Lutron keypads in order to run HA scripts. I have installed the Lutron integration and can see the processor etc however am unable to see the lutron_event (which I believe should register the keypad presses) in Developer Tools. Is anyone able to help/provide some guidance please?

each button on my lutron homeworks qs shows up as an event entity:

and the presses on the buttons look like this:

Thanks @armedad appreciate the screenshots. Looks like there may be an issue the way my keypads are setup in the Lutron designer software - how are they setup there do you know?

sorry, i’m not able to answer that. i can only see it from the lutron mobile app side, control4 side (they do expose as separate entities in control4 as well) and ha side.

since i have a control4 system, i wonder if the installer had to do an extra config to expose them to control4 which then had the side effect of exposing them to ha.

Thank you anyway that was helpful - I take it you use the Lutron core integration (not homeworks or Caseta)?

yeah, i use this: