Skip to content

Miggets7/HA-Earn-E-P1-Meter

Repository files navigation

EARN-E P1 Meter

HACS GitHub Release License

🇬🇧 English | 🇳🇱 Nederlands


English

Home Assistant custom integration for the EARN-E energy monitor. The EARN-E reads your smart meter's P1 port and broadcasts real-time energy data via UDP on the local network. This integration listens for those broadcasts and exposes them as sensor entities in Home Assistant.

Features

  • Automatic device discovery — no manual IP entry needed
  • Real-time power and voltage/current updates (~1s)
  • Energy and gas meter totals from full telegrams (~60s)
  • WiFi signal strength monitoring
  • All sensors grouped under a single device
  • No cloud, no polling — pure local push via UDP

Sensors

Sensor Unit Update Frequency
Power Delivered kW ~1s
Power Returned kW ~1s
Voltage L1 V ~1s
Current L1 A ~1s
Energy Delivered Tariff 1 kWh ~60s
Energy Delivered Tariff 2 kWh ~60s
Energy Returned Tariff 1 kWh ~60s
Energy Returned Tariff 2 kWh ~60s
Gas Delivered ~60s
WiFi RSSI dBm ~60s

Installation

HACS

  1. Open HACS in Home Assistant
  2. Search for "EARN-E P1 Meter" and click Download
  3. Restart Home Assistant

If the integration does not appear in the search results yet, go to Integrations → ⋮ → Custom repositories, add https://github.com/Miggets7/HA-Earn-E-P1-Meter with category Integration, and try again.

Manual

  1. Copy custom_components/earn_e_p1/ to your Home Assistant config/custom_components/ directory
  2. Restart Home Assistant

Setup

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for "EARN-E P1 Meter"
  3. The integration will automatically listen for UDP broadcasts on port 16121 for ~10 seconds. If your EARN-E is found, you'll see a confirmation screen with its IP address — just confirm to finish setup.
  4. If no device is discovered (e.g. the meter is on a different subnet), you'll be asked to enter the IP address manually.

Sensors will populate once the first data packets arrive.

Removal

  1. Go to Settings → Devices & Services
  2. Click on the EARN-E P1 Meter integration
  3. Click the three-dot menu (⋮) and select Delete

Nederlands

Home Assistant custom integratie voor de EARN-E energiemonitor. De EARN-E leest de P1-poort van je slimme meter en verstuurt realtime energiedata via UDP over het lokale netwerk. Deze integratie luistert naar die uitzendingen en maakt ze beschikbaar als sensorentiteiten in Home Assistant.

Kenmerken

  • Automatische apparaatdetectie — geen handmatige IP-invoer nodig
  • Realtime vermogen- en spanning/stroomupdates (~1s)
  • Energie- en gasmetertellingen uit volledige telegrammen (~60s)
  • WiFi-signaalsterkte monitoring
  • Alle sensoren gegroepeerd onder één apparaat
  • Geen cloud, geen polling — puur lokale push via UDP

Sensoren

Sensor Eenheid Updatefrequentie
Vermogen geleverd kW ~1s
Vermogen teruggeleverd kW ~1s
Spanning L1 V ~1s
Stroom L1 A ~1s
Energie geleverd tarief 1 kWh ~60s
Energie geleverd tarief 2 kWh ~60s
Energie teruggeleverd tarief 1 kWh ~60s
Energie teruggeleverd tarief 2 kWh ~60s
Gas geleverd ~60s
WiFi RSSI dBm ~60s

Installatie

HACS

  1. Open HACS in Home Assistant
  2. Zoek naar "EARN-E P1 Meter" en klik op Downloaden
  3. Herstart Home Assistant

Als de integratie nog niet in de zoekresultaten verschijnt, ga naar Integraties → ⋮ → Aangepaste repositories, voeg https://github.com/Miggets7/HA-Earn-E-P1-Meter toe met categorie Integratie, en probeer opnieuw.

Handmatig

  1. Kopieer custom_components/earn_e_p1/ naar de config/custom_components/ map van je Home Assistant
  2. Herstart Home Assistant

Instellen

  1. Ga naar Instellingen → Apparaten & Services → Integratie toevoegen
  2. Zoek naar "EARN-E P1 Meter"
  3. De integratie luistert automatisch ~10 seconden naar UDP-uitzendingen op poort 16121. Als je EARN-E wordt gevonden, verschijnt een bevestigingsscherm met het IP-adres — bevestig om de installatie af te ronden.
  4. Als er geen apparaat wordt gevonden (bijv. de meter staat op een ander subnet), wordt gevraagd om het IP-adres handmatig in te voeren.

Sensoren worden gevuld zodra de eerste datapakketten binnenkomen.

Verwijderen

  1. Ga naar Instellingen → Apparaten & Services
  2. Klik op de EARN-E P1 Meter integratie
  3. Klik op het drie-puntjes menu (⋮) en selecteer Verwijderen

About

Home Assistant custom integration for the Earn-E P1 Meter. The P1 meter broadcasts real-time energy data via UDP on the local network, and this integration exposes it as sensor entities in Home Assistant.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages