Overview
The new support for sub-devices in ESPHome allows users to manage multiple logical devices through a single ESP device in Home Assistant. This simplifies the control of complex setups like RF bridges and Modbus gateways, enhancing user experience and reducing the need for multiple hardware components.
Benefits
- Streamlined control of multiple devices reduces clutter and complexity.
- Improved integration into smart home systems enhances capability capabilities.
- Cost savings by minimizing the number of required hardware devices.
Intent
This capability enables users to represent multiple devices under a single ESPHome instance, facilitating easier management and capability in smart home setups. The outcome is a more efficient home network that allows for greater flexibility in device control.
Preconditions
- ESPHome 2025.7 or higher must be installed.
- Compatible ESP device configured within Home Assistant.
- Home Assistant instance must be set up to recognize sub-devices.
- Home Assistant installed and configured.
- Integration available and authenticated: ESPHome.
- Device installed and reachable: Unifi Networks.
Actors
- Homeowner
- Family member
- Guest
Trigger
The capability is initiated when the homeowner interacts with the Home Assistant interface to control a sub-device.
Workflow Diagram
flowchart TD
A[User triggers device control] -->|check| B{{Is the device configured?}}
B -->|Yes| C[Control sub-device]
C --> D[Update device status in Home Assistant]
B -->|No| E[Show configuration error]
Workflow Description
1. Device Configuration
The user configures the ESP device in ESPHome, specifying the sub-devices to be managed.
2. Integration with Home Assistant
The configured ESP device is integrated into Home Assistant, enabling recognition of the sub-devices.
3. User Interaction
The homeowner or family member accesses the Home Assistant interface to control a specific sub-device.
4. Action Execution
Upon user command, the ESP device communicates with the designated sub-device to perform the required action.
5. Status Update
Home Assistant updates the status of the sub-device, reflecting any changes made during the action.
Postconditions
The sub-device status is updated in Home Assistant, and the user can see real-time feedback on their device control actions.
Optional Enhancements
- Implement voice control capabilities through Alexa or Google Home.
- Add capability scripts that trigger actions based on sub-device status.
- Create custom dashboards for better visual management of sub-devices.
Recommended Components
| Recommended Applications | Recommended Integrations | Recommended Devices |
|---|---|---|
| Home Assistant | ESPHome | Unifi Networks |
Source Examples
- 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)