Home Assistant¶
The WattWächter Plus integration for Home Assistant enables seamless integration of your WattWächter Plus into your smart home. All sensor data is automatically detected and provided as entities in Home Assistant.
Currently available via HACS
The integration is currently installed as a custom repository via HACS. Once we are included in Home Assistant Core, this guide will be updated.
Prerequisites¶
- WattWächter Plus set up and connected to WiFi — if not yet done, follow the Getting Started guide first
- Home Assistant 2024.1 or newer
- HACS (Home Assistant Community Store) installed
- WattWächter Plus on the same network as Home Assistant
Installation via HACS¶
Step 1: Add Custom Repository¶
Open the Home Assistant sidebar and navigate to HACS. Click the three-dot menu () in the top right corner and select Custom repositories.
Step 2: Enter Repository URL¶
Enter the following details in the dialog:
- Repository:
https://github.com/SmartCircuits-GmbH/WattWaechter_HA_Integration - Type:
Integration
Then click Add.
Step 3: Confirm Repository¶
The WattWächter Plus repository is detected and displayed. Click Add again to add it to your HACS store. After that, the integration appears like any other HACS integration in your local HACS overview and can be downloaded and updated from there.
Step 4: Download the Integration¶
Search for WattWächter in HACS. You will find the integration under Available for download. Click the three-dot menu () and select Download.
Step 5: Select Version and Download¶
Select the desired version (latest by default) and click Download. The integration will be downloaded to /config/custom_components/wattwaechter.
Step 6: Restart Home Assistant¶
Restart Required
After downloading the integration, Home Assistant must be restarted for the integration to be loaded. Go to Settings > System > Restart.
Setting Up the Integration¶
Automatic Discovery (Zeroconf)¶
After restarting, Home Assistant automatically detects all WattWächter Plus devices on the network. You can find discovered devices under Settings > Devices & Services in the Discovered section. Click Add to set up a device.
Configure Device¶
The configuration dialog displays the device information:
- Model: WW-Plus
- Firmware: current version
- Host: IP address of the device
- Device ID: unique identifier
Optionally, you can enter an API token to enable authenticated access. Click OK to complete the setup.
Name Your Device¶
After configuration, you can assign a name and area to the device (e.g., "WattWächter Feed-in" in the area "Basement"). Click Skip and finish if you want to set this up later.
Available Sensors¶
The integration automatically creates sensors based on the OBIS codes provided by your electricity meter. Which sensors are available depends on your meter.
Energy Sensors¶
| Sensor | OBIS Code | Unit | Description |
|---|---|---|---|
| Total Consumption | 1.8.0 | kWh | Total energy import |
| Total Feed-in | 2.8.0 | kWh | Total energy export |
| Consumption Tariff 1 | 1.8.1 | kWh | Energy import tariff 1 (peak) |
| Consumption Tariff 2 | 1.8.2 | kWh | Energy import tariff 2 (off-peak) |
| Feed-in Tariff 1 | 2.8.1 | kWh | Energy export tariff 1 |
| Feed-in Tariff 2 | 2.8.2 | kWh | Energy export tariff 2 |
Power Sensors¶
| Sensor | OBIS Code | Unit | Description |
|---|---|---|---|
| Active Power | 16.7.0 | W | Current total power |
| Power L1 | 36.7.0 | W | Power phase 1 |
| Power L2 | 56.7.0 | W | Power phase 2 |
| Power L3 | 76.7.0 | W | Power phase 3 |
Voltage & Current Sensors¶
| Sensor | OBIS Code | Unit | Description |
|---|---|---|---|
| Voltage L1/L2/L3 | 32/52/72.7.0 | V | Voltage per phase |
| Current L1/L2/L3 | 31/51/71.7.0 | A | Current per phase |
| Frequency | 14.7.0 | Hz | Grid frequency |
| Power Factor | 13.7.0 | — | Total and per phase |
Diagnostic Sensors¶
| Sensor | Description |
|---|---|
| WiFi Signal Strength | Signal strength in dBm |
| WiFi SSID | Connected network |
| IP Address | Current IP address |
| mDNS Name | Network name of the device |
| Firmware Version | Installed firmware |
Dynamic Sensors
If your electricity meter provides OBIS codes not listed in the tables above, they are automatically created as additional sensors with appropriate units and device classes.
Options¶
After setup, you can adjust the integration via Settings > Devices & Services > WattWächter Plus > Configure:
| Option | Default | Range | Description |
|---|---|---|---|
| Scan Interval | 120 s | 3–900 s | How often meter data is fetched from the device |
Firmware Updates¶
The integration automatically creates an update entity. This allows you to install firmware updates directly from Home Assistant — including a progress indicator.
Troubleshooting¶
Device not automatically discovered
Make sure that:
- The WattWächter Plus is powered on and connected to WiFi
- Home Assistant and the WattWächter are on the same network/subnet
- mDNS/Zeroconf is not blocked in your network (e.g., by VLAN isolation or firewall)
- The device is not connected to a guest WiFi network — guest networks typically prevent communication between devices (client isolation)
You can also add the device manually: Settings > Devices & Services > Add Integration > WattWächter and enter the IP address.
MQTT Conflict
If MQTT auto-discovery is active on the WattWächter, the integration detects this and notifies you. In this case, either disable MQTT auto-discovery on the device or use the MQTT integration instead of the local API integration. Using both simultaneously can lead to duplicate entities.
Authentication Error
If the API token has changed, you can update it via Settings > Devices & Services > WattWächter Plus > Re-authenticate.