Overview
Setting up MQTT devices traditionally requires individual configuration for each entity, which can be cumbersome and time-consuming. With the new device-based auto discovery support, users can configure multiple MQTT devices at once, streamlining the setup process and enhancing overall efficiency.
Benefits
- Reduces the time and effort needed to set up multiple MQTT devices.
- Minimizes errors that can occur during manual configuration of devices.
- Enhances the overall user experience in managing smart home devices.
Intent
This capability aims to simplify the integration of MQTT devices into a smart home setup by allowing bulk discovery and configuration. The outcome is a more efficient and user-friendly experience for homeowners managing their smart devices.
Preconditions
- MQTT broker is installed and running.
- Home Assistant is configured to support MQTT integrations.
- MQTT devices are powered on and connected to the network.
- Home Assistant installed and configured.
- Integration available and authenticated: UniFi.
- Device installed and reachable: Unifi Networks.
Actors
- Homeowner
- Family member
- Guest
Trigger
The capability is triggered when the Home Assistant system initiates a scan for MQTT devices on the network.
Workflow Diagram
flowchart TD
A[Scan for MQTT Devices] -->|check| B{{Devices Found?}}
B -->|Yes| C[Auto Discover Devices]
C --> D[Configure Devices in Home Assistant]
B -->|No| E[Exit Process]
Workflow Description
1. Initiate Device Scan
The Home Assistant system sends a request to scan the network for available MQTT devices.
2. Device Detection
Detected devices are identified and listed for configuration based on their MQTT settings.
3. Auto Discovery Process
The system automatically configures the discovered devices, reducing the need for manual input.
4. Configuration Confirmation
The user is notified of the successful configuration of all detected MQTT devices.
5. Final Setup
The user can now control and manage their MQTT devices from the Home Assistant dashboard.
Postconditions
All discovered MQTT devices are successfully configured in Home Assistant, allowing for easy control and capability.
Optional Enhancements
- Implement notifications for users when new MQTT devices are detected.
- Allow users to customize device settings during the auto discovery process.
- Provide a log of the discovery process for troubleshooting purposes.
Recommended Components
| Recommended Applications | Recommended Integrations | Recommended Devices |
|---|---|---|
| Home Assistant | UniFi, Zigbee2MQTT | Unifi Networks |
Source Examples
- 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)