Overview
The Z-Wave MQTT light platform allows seamless control of Z-Wave connected lights through MQTT integration, improving convenience and capability in home lighting management. This capability enables users to remotely manage their lighting setup, enhancing comfort and energy efficiency.
Benefits
- Easily control lights from anywhere via MQTT commands.
- Create automated lighting scenarios based on events or schedules.
- Improve energy management by monitoring and controlling light usage.
Intent
The purpose of this capability is to facilitate the integration of Z-Wave lights with MQTT, allowing users to manage their lighting system via Home Assistant and other platforms. The outcome is a more connected and responsive home lighting environment.
Preconditions
- Z-Wave lights installed and configured.
- MQTT broker set up and operational.
- Home Assistant configured to support Z-Wave MQTT integration.
- Home Assistant installed and configured.
- Integration available and authenticated: Z-Wave JS.
- Device installed and reachable: WLED Light Controller.
Actors
- Homeowner managing lighting setup
- Family member adjusting lights remotely
- Guest controlling lights as needed
Trigger
The capability is triggered by an MQTT command sent to the broker, which is then processed to adjust the light settings.
Workflow Diagram
flowchart TD
A[MQTT Command Received] -->|check| B{{Light Control Action?}}
B -->|Yes| C[Adjust Light Settings]
C --> D[Lights Updated]
B -->|No| E[Exit]
Workflow Description
1. Send MQTT Command
The user sends an MQTT command to the broker indicating the desired action (e.g., turning lights on/off).
2. Broker Receives Command
The MQTT broker receives the command and processes it based on the predefined topics and settings.
3. Home Assistant Processes Command
Home Assistant listens for the command and determines the appropriate Z-Wave light device to control.
4. Adjust Light Settings
The specific Z-Wave light is adjusted according to the command (e.g., brightness change, on/off).
5. Confirm Action
The system confirms the action and updates the state of the light in Home Assistant for user visibility.
Postconditions
The light settings are adjusted as per the MQTT command, and the current state is reflected in Home Assistant.
Optional Enhancements
- Integrate with voice assistants for voice-activated light control.
- Create custom capability scripts for complex lighting scenarios.
- Implement energy monitoring to track usage of Z-Wave lights.
Recommended Components
| Recommended Applications | Recommended Integrations | Recommended Devices |
|---|---|---|
| Home Assistant | Z-Wave JS, Zigbee2MQTT | WLED Light Controller, Lutron Caseta Dimmer |
Source Examples
- 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)