ESPHome Device v2.1 – RTI Driver

Control any ESPHome device from RTI – no Home Assistant required.

One driver for every ESPHome device. It connects straight to your ESP8266 or ESP32, finds everything it can do – lights, switches, dimmers, covers, fans, locks, buttons, numbers, selects, climate, and every kind of sensor – and gives you two-way control and feedback on your RTI panels and remotes.

It works with encrypted devices (the modern default). And because an ESP32 running ESPHome can act as a Bluetooth bridge, it even reaches BLE-only gear – adjustable beds, locks, sensors – that RTI can't control on its own.

WHAT THIS DRIVER IS

If your device runs ESPHome, this driver controls it – directly, over your network, with no Home Assistant, no cloud, and nothing to program by hand. Add the driver, point it at the device, click one button to import every control by its real name, and drag those onto your pages. That's the whole job.

WHAT'S NEW IN 2.1

Self-healing connection. If the secure connection ever stalls while connecting – for example right after the device reboots – the driver now notices and reconnects on its own, instead of sitting there until you reload it.

Everything from 2.0 still applies: one-click AutoConfig, support for encrypted devices, and very light CPU once the one-time key exchange is done.

SET IT UP

You do everything in Integration Designer – no app, no terminal.

1. Add the driver and enter the connection settings. Add one ESPHome Device driver per device, select it, and fill in its settings:

Device IP Address – your device's IP, e.g. 192.168.1.50. Give it a static IP or DHCP reservation so it never changes (RTI connects by IP, not a hostname).

Port – leave at 6053 (the ESPHome default).

Encryption Key – paste your device's base64 key (see "Finding your encryption key" below). Leave blank only for older, unencrypted devices.

License Key – paste your purchased key, or leave it blank to start the 2-hour free trial.

Startup Delay (seconds) – leave at 30 for now (explained in Options).

2. Import your controls. With the driver selected, look in the Driver Configuration panel (just below Driver Info) and click "Get Config from ESPHome Device" – a normal single click. The driver connects, reads every control, and creates functions and feedback variables labeled with the device's real names ("Living Room Lamp On," "Bed Head Up"), grouped by type. No slot numbers to fill in by hand. Run it again any time the device's controls change.

3. Place your controls. Drag the named functions onto your page buttons (e.g. Bed Head Up) and bind the named variables for feedback. Done.

4. Give the first connection a minute or two. Watch Connection State and Status Text. After a reboot, an encrypted device takes up to a minute or two to come online – this happens only once per reboot. First it waits out the Startup Delay so your other drivers finish booting (Status Text shows "Waiting 30s before connecting..."); then it makes its secure connection, the only slow step (Status Text then shows "Connected - N entities"). After that it stays connected, and day-to-day button presses and feedback are instant.

FINDING YOUR ENCRYPTION KEY

Modern ESPHome devices have API encryption on by default – for those the key is required (the device won't connect without it). You do NOT need Home Assistant to get it; it lives in the device's own ESPHome config:

From the ESPHome Dashboard (the usual way): open the device you flashed and look at its YAML (often secrets.yaml). The key is under api: encryption: key: – copy that exact 44-character value into Encryption Key.

From Home Assistant (only if you use it): Settings - Devices & Services - ESPHome - (your device) - Encryption key.

The key is write-only on the device – it can only be read from your config, never pulled back off the ESP; if it's lost, re-flash the device with a new key. If a device needs a key and the field is empty, Last Error says so – paste the key and it reconnects on its own.

OPTIONS

Startup Delay (seconds) – how long to wait after the processor boots before connecting (default 30, range 0–300). Encrypted devices do a brief, CPU-heavy key exchange on connect, so delaying it lets your other drivers finish booting first. Raise it on a heavily-loaded processor; lower it (even to 0) on a quiet one.

API Password – only for legacy devices that set a plaintext API password. Most devices use the Encryption Key instead; leave this blank if yours has none.

Debug Level – leave Off for normal use. Set it to High only when troubleshooting; the log appears in the processor's System Log (enter the processor IP in Integration Designer, then click System Log).

WHAT YOU CAN CONTROL

AutoConfig surfaces only the controls your device actually has, named for what they are:

Lights / dimmers: On, Off, Toggle, Set Brightness – with on/off and brightness feedback.

Switches / relays: On, Off, Toggle + state.

Covers / shades / garage doors: Open, Close, Stop, Set Position + position and operation feedback.

Fans: On, Off, Set Speed + speed feedback.

Locks: Lock, Unlock, Open + lock-state feedback.

Buttons: Press – fire any momentary control on the device (great for BLE-bridged gear like beds).

Numbers: Set Value (sliders, setpoints) + value, min/max feedback.

Selects: Set By Index (choose from the device's option list) + current selection.

Climate / thermostats: Set Mode, Target Temp, Target Temp Range, Fan Mode, Swing Mode, Preset + current temperature, target, action, and mode feedback.

Sensors / binary sensors / text sensors: read as values, on/off states, and text.

The driver also raises events – Connected, Disconnected, Entities Discovered, State Changed, plus license and trial events – so device changes can trigger RTI macros.

For safety, AutoConfig automatically omits the device's Factory Reset and Safe Mode buttons (nobody needs those on a touchpanel) and tucks ESP Restart into a System category alongside Reconnect and Refresh All.

MANUAL SETUP (OPTIONAL – WITHOUT AUTOCONFIG)

The driver works the moment you add it, even before you run AutoConfig: discovered controls fill numbered slots by type, and each slot's _Name variable shows the control's real name. Bind your pages to the slot variables (for example Light01_Name, Light01_State, Light01_Brightness, Cover01_Position, Climate01_CurrentTemp) and drive them with the slot command functions, picking the slot number from each function's dropdown.

Heads-up: slots are ordered alphabetically by name, so a "Button 1" isn't always the one you'd expect. Check the matching Button##_Name variable before assigning a Button Press – or just use Get Config, which names every button for you and hides the dangerous ones.

IF IT WON'T CONNECT

Check Last Error first – it names the problem in plain language:

"requires an encryption key" – the device is encrypted; paste its key into Encryption Key.

"Could not reach ESPHome device..." – check the IP address, that the device is powered and on your network, and that the Port is 6053.

A handshake that stalls now retries on its own (new in 2.1) – give it the minute-or-two startup window before assuming it failed.

Two System functions are always there if you need them: Reconnect (drop and rebuild the link) and Refresh All (re-pull every control's current state).

STATUS & LICENSING

The Status variables show connection state, device info (name, model, MAC, ESPHome version), how many controls were found, and the reconnect count. The Licensing variables show your trial or license status. The driver reconnects on its own if the device drops and keeps the link healthy in the background.

LICENSE

The driver runs for 2 hours per processor as a free trial. To license it permanently, purchase a key at customcontroldrivers.com and paste it into License Key. The license is locked to that processor.

SUPPORT

Questions or issues: support@customcontroldrivers.com

– Custom Control Drivers LLC customcontroldrivers.com