Overview
Integrate ESPHome-based devices into Control4. ESPHome is an open-source system that transforms common microcontrollers, like ESP8266 and ESP32, into smart home devices through simple YAML configuration. ESPHome devices can be set up, monitored, and controlled using a web browser, Home Assistant, or other compatible platforms. This driver enables seamless monitoring and control of ESPHome devices directly from your Control4 system.
Features
- Local network communication requiring no cloud services
- Real-time updates from all supported entities exposed by the device
- Supports encrypted connections using the device encryption key
- Variable Programming Support
System requirements
- Control4 OS 3.3+
Compatibility
Verified Devices
This driver will generically work with any ESPHome device, but we have tested extensively with the following devices:
Supported Bluetooth Devices
When used as a Bluetooth proxy, this driver supports the following BLE device types through sub-drivers:
| Protocol | Sub-Driver | Example Devices |
|---|---|---|
| SwitchBot | ESPHome SwitchBot | Bot, Plug Mini, Relay Switch, Meter, Motion, Contact |
| BTHome | ESPHome BTHome | Shelly BLU Button/Door/Motion/H&T, DIY sensors |
| Govee | ESPHome Govee | Temperature/humidity monitors, meat thermometers |
See the individual sub-driver documentation for device-specific details.
Supported ESPHome Entities
| Entity Type | Supported |
|---|---|
| Alarm Control Panel | ❌ |
| API Noise | ✅ |
| Binary Sensor | ✅ |
| Bluetooth Proxy | ✅ |
| Button | ✅ |
| Climate | ❌ |
| Cover | ✅ |
| Datetime | ❌ |
| Date | ❌ |
| Time | ❌ |
| Camera | ❌ |
| Event | ❌ |
| Fan | ❌ |
| Light | ✅ |
| Lock | ✅ |
| Media Player | ❌ |
| Number | ✅ |
| Select | ❌ |
| Sensor | ✅ |
| Siren | ❌ |
| Switch | ✅ |
| Text | ✅ |
| Text Sensor | ✅ |
| Update | ❌ |
| Valve | ❌ |
| Voice Assistant | ❌ |
Customer reviews
Using another C4 driver, I ...
Bring your Ratgdo to life again while using the simplest of driver configurations I ...
v20260217 - 2026-02-17
Added
- Added Bluetooth proxy support with scanner infrastructure, advertisement parsing, and GATT connection management
- Added ESPHome Bluetooth Coordinator driver for multi-proxy aggregation with RSSI-based routing and connection failover
- Added room presence tracking with RSSI-based detection, anti-flapping, and contact sensor bindings
- Added ESPHome BTHome sub-driver for Shelly BLU and BTHome v1/v2 sensors
- Added ESPHome Govee sub-driver for temperature, humidity, and meat thermometer sensors
- Added ESPHome SwitchBot sub-driver for Bot, Plug Mini, Meter, Motion, and Contact devices
- Added device log forwarding to the ESPHome driver
v20251031 - 2025-10-31
Fixed
- Fixed compatibility with ESPHome 2025.10.0 for devices configured without passwords
- Improved password authentication failure detection and error reporting
v20251022 - 2025-10-22
Fixed
- Fixed an issue with parsing unknown fields in protobuf messages
v20251019 - 2025-10-19
Added
- Added support for OpenSSL with "Encryption Key" authentication mode across all applicable algorithms
Fixed
- Fixed a bug with the authentication flow in the latest 2025.10.0 firmware
v20250811 - 2025-08-11
Fixed
- Fixed switch entities not responding to bound relay proxies
v20250715 - 2025-07-14
Fixed
- Fixed bug causing entities to not be discovered on connect
v20250714 - 2025-07-14
Added
- Added support for encrypted connections using the device encryption key
v20250619 - 2025-06-19
Added
- Added ratgdo specific documentation
v20250606 - 2025-06-06
Added
- Initial Release
