Ecotracker Home Assistant Integration

Give me a tip: paypal.me/StefanSeeger buymeacoffee.com/stefsee

Custom integration for Ecotracker energy monitoring device. It directly accessed the local HTTP server. Depending on the official API Specification

Installation

Prerequisites

1. Make sure your ecotracker and Home Assistant are in the same LAN/WIFI
2. Make sure your ecotracker has enabled "Local http server" of your Ecotacker device
3. Make sure your ecotracker is reachable in the local network via (http://your.local.ip.address/v1/json).
4. Make sure your calling http://your.local.ip.address/v1/json in the browser returns at least data like below. If one of the fields is missing, configuration will fail.

{
   "power": 123, //mandatory
   "powerAvg": 456, //mandatory
   "energyCounterIn": 789 //mandatory
}

HACS (Recommended)

1. Add this repository as a custom repository in HACS:
   • Go to HACS > Integrations
   • Click the three dots in the top right
   • Select "Custom repositories"
   • Add the repository URL and select "Integration" as the category
2. Click "Install"
3. Restart Home Assistant

Manual Installation

1. Copy the custom_components/ecotracker folder to your Home Assistant's custom_components directory
2. Restart Home Assistant

Configuration

1. Go to Settings > Devices & Services
2. Click "+ Add Integration"
3. Search for "Ecotracker"
4. Enter your device's IP address
5. Set the polling interval (default: 60 seconds, range: 1-86400 seconds)

Changing Settings

To change the polling interval after setup:

1. Go to Settings > Devices & Services
2. Find your Ecotracker device
3. Click "Configure"
4. Update the polling interval and IP address as needed

Features

• Configurable polling interval (1-86400 seconds, default: 60 seconds)
• Compatible with Home Assistant Energy Dashboard
• Config flow UI for easy setup
• Options flow for changing settings without re-adding the integration

Sensors

• sensor.ecotracker_power - Current power consumption in Watts
• sensor.ecotracker_power_average - Average power consumption (last minute)
• sensor.ecotracker_energy_in - Total energy imported in Watt-hours
• sensor.ecotracker_energy_in_t1 - Energy imported (1.8.1) in Watt-hours
• sensor.ecotracker_energy_in_t2 - Energy imported (1.8.2) in Watt-hours
• sensor.ecotracker_energy_out - Total energy exported in Watt-hours (optional)
• sensor.ecotracker_power_phase_1 - Power consumption of phase 1 in Watts (optional)
• sensor.ecotracker_power_phase_2 - Power consumption of phase 2 in Watts (optional)
• sensor.ecotracker_power_phase_3 - Power consumption of phase 3 in Watts (optional)
• sensor.ecotracker_age_power - Milliseconds since last measurement (optional)

📝 Disclaimer

This software is not affiliated with, endorsed by, or associated with EcoTracker or everHome in any way. All product and brand names mentioned belong to their respective owners. It is provided as-is, without any warranties or guarantees. The authors assume no liability for any issues arising from its use.