Lutron Caseta LEAP (Caseta Only)

Installation and Programming Instructions

Overview

This driver provides native Lutron LEAP integration for Caseta Smart Bridge systems in RTI Integration Designer. Integration Designer connects directly to the Caseta bridge, stores the LEAP pairing credentials, reads the current Caseta system, and generates the RTI sources, functions, variables, and events for the devices actually discovered.

The setup flow intentionally follows the same general pattern used by RTI's Lutron LEAP driver: one command connects to the Lutron system and updates the stored project model, while Driver Sync refreshes Integration Designer from that already-stored model without contacting Lutron.

Hold Harmless Agreement

This driver is an independent third-party software component and is not developed, endorsed, supported, or certified by Lutron Electronics Co., Inc. or Remote Technologies Incorporated (RTI).

This software is provided "AS IS", without warranty of any kind, express or implied. By installing, enabling, configuring, or using this driver, you accept complete responsibility and all risk associated with its installation, operation, maintenance, and use.

To the maximum extent permitted by applicable law, the author, distributor, and contributors shall not be liable for direct, indirect, incidental, consequential, special, exemplary, or punitive damages arising from or related to this driver. By accepting the agreement in Driver Properties, you agree to indemnify, defend, and hold harmless the author, distributor, and contributors from claims, damages, losses, costs, or expenses arising from its installation or use.

Communication with the Caseta bridge is disabled until Accept Hold Harmless Agreement is enabled in Driver Properties.

System Requirements

RTI Integration Designer 10 or newer.

Compatible RTI processor running the minimum runtime specified by the driver manifest.

Lutron Caseta Smart Bridge or Smart Bridge PRO using native LEAP.

RTI processor and Caseta bridge on the same local network.

A DHCP reservation or static IP address for the Caseta bridge.

Adding the Driver

1. Add the Caseta LEAP driver from the Drivers tab in Integration Designer.

2. The hub source appears as Caseta Lutron LEAP.

3. Open Driver Properties and enter the reserved IP address of the Caseta Smart Bridge.

4. Read the Hold Harmless Agreement and enable Accept Hold Harmless Agreement.

5. From the driver menu, choose Connect to Caseta System.

Connect to Caseta System

Connect to Caseta System is the normal setup and update command.

If no saved LEAP pairing certificate exists, the driver starts the Caseta pairing process.

When prompted, press and release the physical pairing button on the Caseta bridge.

After pairing succeeds, the driver immediately connects over LEAP, reads the current Caseta system, saves the discovery model, and generates the RTI XML.

If the bridge is already paired, the pairing step is skipped and the driver immediately reads the current Caseta configuration.

Run Connect to Caseta System again whenever the Caseta project changes. It is the command that gets fresh information from Lutron.

Driver Sync

Driver Sync is a local Integration Designer refresh. It does not connect to the Caseta bridge and does not rediscover the Lutron system. It should rarely need used but feels out of sync press it.

Driver Sync checks which generated Caseta sources are currently added to the RTI workspace.

It regenerates Device Description, Configuration, Variables, Functions, and Events from the saved Caseta discovery model.

The driver automatically runs the same silent sync routine when a generated source is added to or deleted from the RTI workspace.

The manual Driver Sync command is a failsafe if Integration Designer does not refresh commands, variables, events, or source programming as expected.

A successful manual Driver Sync displays a completion message.

Reset LEAP Authentication

Reset LEAP Authentication clears the saved Caseta pairing credentials. Use it when replacing the bridge, intentionally re-pairing, or troubleshooting invalid authentication. After resetting authentication, run Connect to Caseta System and complete the physical pairing process again.

Adding Generated Sources

After Connect to Caseta System completes, discovered Caseta sources are available under Add To Existing Driver in Integration Designer. Sources are grouped by Caseta room/area and use the friendly Lutron device names. Add only the sources required by the RTI project.

Adding or deleting a generated source automatically triggers the driver's local sync routine so the commands, variables, and events associated with the current workspace sources remain aligned.

Auto-Programming Templates

Lights: primary template Lutron Lighting; secondary template Lighting.

Shades: primary template Lutron Shades; secondary template Shades.

Supported Devices and Commands

Lights

Dimmers: Set Level, On, Off, Toggle, Raise, Lower, and Stop.

Switched loads: On, Off, and Toggle.

Set Level uses 0-100 percent. Dimming loads support direct level control and feedback.

Fans

Set Fan Level accepts 0-100 and maps the slider value to Caseta's discrete fan speeds.

Discrete speeds are Off, Low, Medium, Medium High, and High.

Fan On feedback is true at every running speed and false only when Off.

The High command also carries the Fan On auto-programming tag.

Pico Remotes

Pico button functions are created from the discovered LEAP button hrefs.

Available command actions are Press and Release, Press, Press and Hold, and Release.

Events include Press, Release, and Long Hold for every discovered Pico button.

Picos expose Name and Room identity variables.

Scenes

Discovered Caseta scenes are generated as Run Scene functions.

Scenes are command-only and do not provide feedback variables.

Occupancy / Motion Sensors

Motion sensors expose Name, Room, Occupied, and Unoccupied variables.

Occupied and Unoccupied events are generated.

Sensors have no control functions and are not added as controllable device sources.

Before the first valid occupancy status is received, Occupied and Unoccupied are both false.

Shades- Beta untested as don’t have one to test with!

Shade support includes Set Level, Raise, Lower, Stop, Open, Close, and Toggle where supported by the discovered Caseta zone.

Feedback includes Level, Open, Closed, and position-change events.

Shade support is generated from the LEAP information reported by the bridge. Verify operation against the installed shade hardware.

Variables

Lights: Name, Room, On/Off state, and Level for dimmers.

Fans: Name, Room, Level, status, Fan On, and individual speed indicators.

Picos: Name and Room.

Motion sensors: Name, Room, Occupied, and Unoccupied.

Shades: Name, Room, Level, Open, and Closed.

Driver connection status is also available for system diagnostics.

Events

Lights: On, Off, and Level Changed where applicable.

Fans: Off, Low, Medium, Medium High, and High.

Picos: Press, Release, and Long Hold.

Motion sensors: Occupied and Unoccupied.

Shades: Open, Closed, and Position Changed.

Auto-Programming Tags

Lights

Light Level - slider/direct set and level feedback.

Light On - on command and on feedback.

Light Off - off command.

Light Toggle - toggle command.

Light Up / Light Down / Light Stop - fade control.

Light Name / Instance ID - device name.

Light Location - room.

Fans

Fan Level - slider control and level feedback.

Fan On - running-state feedback and the High command.

Fan Off, Fan Low, Fan Med, Fan MedHigh, Fan High - discrete control and matching feedback.

Fan Status - current discrete fan status.

Fan Name / Instance ID - device name.

Fan Location - room.

Motion Sensors

Motion Occupied - occupied feedback.

Motion Unoccupied - unoccupied feedback.

Motion Name / Instance ID - sensor name.

Motion Location - room.

Shades

Shade Level - slider/direct set and position feedback.

Shade Open / Shade Close / Shade Toggle - discrete shade commands and state feedback as applicable.

Shade Up / Shade Down / Shade Stop - movement control.

Shade Name - device name.

Shade Location - room.

Runtime Operation

After the RTI project is loaded to the processor, the runtime connects to the configured Caseta bridge IP using the LEAP credentials saved during Integration Designer pairing. It restores subscriptions, reads initial device state, maintains the LEAP heartbeat, and reconnects automatically if communication is interrupted. Runtime communication remains disabled unless the Hold Harmless Agreement is accepted.

Troubleshooting

Cannot connect: confirm bridge power, network connectivity, the configured IP address, and Hold Harmless acceptance.

Bridge is not paired: run Connect to Caseta System and complete the physical pairing prompt.

Devices, rooms, scenes, Picos, or motion sensors changed in the Lutron app: run Connect to Caseta System to obtain fresh Lutron data.

Commands, variables, events, or source programming do not refresh correctly in Integration Designer: run Driver Sync.

Bridge was replaced: run Reset LEAP Authentication, update the IP if necessary, then run Connect to Caseta System.

Do not share private LEAP certificates, keys, or pairing data in logs or screenshots.

Intentionally Unsupported

HVAC control.

Automatic mDNS bridge discovery or runtime IP recovery.