Overview
The CasaTunes Lutron integration allows customers to use various Lutron keypads and devices to control CasaTunes.
In particular, you can use Lutron’s Audio PICO controllers, which are specifically designed for audio control, to control your CasaTunes system. These controllers are small, simple to use, cost effective, and with a 10-year typical battery charge are virtually maintenance free.
The Lutron Audio PICO controllers are portable controllers, and with optional accessories, can be mounted in any location, including a desktop pedestal.
Using the CasaTunesX App, you can assign CasaTunes Actions to each button. Each button can be programmed with a short and/or long press action (aka as press & release and press & hold, respectively). For express configuration, you simply assign the room you want the Audio PICO controller to control, and CasaTunes automatically programs the actions for each button on the Lutron Audio PICO controller for you.
Figure 1: Auto-programmed CasaTunes Actions for Lutron Audio PICO controller. Top line shows the action programmed for a short press (press & release), and the bottom line shows the action programmed for a long press (press & hold)
The Lutron Audio PICO controllers are available in either black or white.
CasaTunes works with various Lutron lighting systems, including Lutron Caséta, RadioRA2 Select, Radio RA2 and HomeWorks QS.
Prerequisites
Depending on the lighting system you are using, CasaTunes requires the following hub, repeater or processor be installed:
- CasaTunLutron Caséta: Lutron Smart Hub PRO (L-BDGPRO2-WH)es v5.00.190910 or later
- RadioRA2 Select: RadioRA2 Select Main Repeater (RR-SEL-REP2)
- RadioRA 2: RadioRA2 Main Repeater (RR-MAIN-REP)
- HomeWorks QS: HomeWorks QS processor
Lutron Setup
Setup your Audio PICO controllers (and other keypads) per the manufacturer's instructions. You can also assign CasaTunes Actions to Lutron Time Clock Events (i.e. scheduled events) when using a RadioRA2 or HomeWorks lighting system.
For RadioRA2 and HomeWorks systems you will need to add a telnet login account for exclusive use by CasaTunes.
For Caséta and RadioRA2 Select systems you must enable telnet support in the Lutron App.
When the keypad is off, if the keypad does not display the time of day, then the keypad is not setup correctly. Check the keypad is plugged into the USB6 Keypad Hub, and verify the USB6 Keypad Hub is connected to your music server. Next, unplug the keypad and plug it back in to the Hub, and if that does not work, try unplugging and plugging back in the USB6 Keypad Hub. If you still do not see the time of day, please contact CasaTunes Support.
CasaTunes Setup
CasaTunes setup is a 3-step process using the CasaTunesX App:
- Step 1: Configure the Lutron connection settings CasaTunes will use to connect to your lighting system
- Step 2: Upload the Lutron configuration into CasaTunes
- Step 3: Assign CasaTunes Actions to be executed when you press a keypad button, or when a scheduled event occurs
Configuring the Lutron connection settings for CasaTunes
To configure the Luton connection settings for CasaTunes, use the CasaTunesX App:
- Open the CasaTunesX App
- Navigate to MENU > Settings > Lutron
- Set the Lutron Hardware option to match your lighting system
- Enable Lutron
Next, follow the instruction below based on whether you are using Caséta and RadioRA2 Select, or RadioRA 2 and HomeWorks
Caséta and RadioRA2 Select
- Verify and/or set the IP address of your SmartBridge Pro or RadioRA2 Select Main Repeater
- Using the Lutron App, go to Settings > Advanced > Integration
- Enable Telnet support (Caséta)
- Select Send Integration Report and email the report to your email address.
- Copy and save the body of the email to a file, and name it “IntegrationReport.json”.
- Using the CasaTunesX App, click the Upload Integration Report button, then browse and select the “IntegrationReport.json” file you previously saved.
- The Last Updated property shows the date of your most recent successful integration report upload, which should be today’s date.
You can also save the “IntegrationReport.json” file directly to your music server. Simply, copy the file to the \\CasaServer\CasaData music server folder. If you are prompted for credentials, enter CasaUser as the username (with no password). Restart CasaTunes to update your Lutron configuration.
Figure 2: Lutron Caseta and RadioRA2 Select set up
RadioRA 2 and HomeWorks QS
Figure 3: Lutron RadioRA2 and HomeWorks QS set up
- Enter the IP Address of your RadioRA2 Main Repeater or HomeWorks processor.
- Enter the Username and Password for your Lutron telnet connection
- Press the Verify Credentials button to verify your credentials
- After your credentials are successfully verified, CasaTunes will automatically download the Lutron configuration. This may take a few minutes. The Last Updated property should reflect the date and time you last updated your Lutron configuration.
- To make sure your latest settings are displayed, pull down the screen to refresh the settings page.
Advanced Options
The Advanced Options settings allow you to further customize your Lutron integration experience.
- Long press delay: This option lets you set how many milliseconds it takes for a button press to register as a Long Press (or Press & Hold) event.
- Repeat delay: Buttons set to Volume Up or Down will adjust the volume continuously when held. Use the Repeat Delay option to control the interval between changes.
- Volume adjustment: The volume adjustment option lets you set how much the volume changes with each button press.
- Audio Feedback: Enabling this option provides audio feedback when the source or featured item selected is changed.
Figure 4: Advanced set up options
Assigning CasaTunes Actions to buttons and scheduled events
After connecting to your Lutron lighting system and downloading the latest configuration, you can now assign various CasaTunes Actions to your Lutron keypad buttons and scheduled events.
Button and Scheduled Events
Figure 5: Auto-programmed Audio PICO controller for the Dining Room
- In the Lutron Settings screen, select Button Events (or Scheduled Events)
- To make a new assignment select + Add button (or + Add Scheduled Event)
- For Button Events, select the keypad (or device) that includes the button to program, from the list of available Lutron keypads and devices
- If the keypad you selected supports auto-programming, you will be prompted whether you want to let CasaTunes auto-program this device for you. Allowing CasaTunes to auto-program your device saves significant time and is recommended. Audio PICO keypads are programmed as shown in Figure 1.
- If the option to auto-program your keypad is not available or you prefer to manually configure your CasaTunes Actions, then follow the instructions below
- For scheduled events, select the event to program and follow the steps to manually configure a CasaTunes Action
Manually Configuring a CasaTunes Action for a button or scheduled event
- In the Lutron Settings screen, select Button Events (or Scheduled Events)
- To create a new assignment select + Add button (or + Add Scheduled Event)
- To change the assignment options for an existing keypad button or scheduled event, select the button or scheduled event to change.
- When adding a new button event, select the keypad (or device) that includes the button to add, from the list of available Lutron keypads
- If prompted to auto-program the keypad, select Cancel
- Select the keypad button short or long press (or scheduled event) to program
- In the Action Settings area in the Edit Action screen, select Action
- Pick the Action to assign to this button (or scheduled event)
- Depending on the Action you select, you may be prompted to configure additional settings for the Action. For example, if you select a Power On or Power Toggle Action, you need to specify the room or room group to power on, and optionally set the power-on volume, the source, and configure a featured item or playlist to play when the room or room group is powered on
- Repeat setting up a short and/or long press CasaTunes Action for each keypad button (and for each scheduled event)
Remove Action assigned to button and/or scheduled event
To remove a CasaTunes Action that is currently assigned to a keypad button press and/or scheduled event, simply set the CasaTunes Action to ‘None’
CasaTunes Actions
The following CasaTunes Actions are available:
- None: Select this to un-assign an action from a keypad button
- Power on/Power off/Power toggle: Used to power a room or room group on, off or toggle, respectively. When you select the Power on or Power toggle option, you must enter the room or room group to control, and optionally set the power-on volume, source to switch to, and the featured item or playlist to play when powered on
- All rooms off: Used to turn all the rooms off
- Turn volume up/down: Used to raise or lower the volume for a room or room group. When assigning these actions to a PICO keypad, pressing and holding the volume up/down buttons will repeatedly raise/lower the volume
- Mute on/off/Mute toggle: Turns mute on, off and toggles mute for the room or room group
- Select next/previous source: Used to select the next or previous source for a room or room group
- Select next/previous playlist: Used to play to the next or previous playlist in a room or room group
- Select next/previous featured item: Used to play to the next or previous featured item in a room or room group
- Pause/Play/Toggle play/pause: Used to pause, play or toggle between pause & play for a room or room group
- Run task: Runs the selected CasaTunes Task (only non-interactive tasks are supported). CasaTunes Tasks are similar to macros, containing one or more actions.
