Home Assistant integratie | ONEp1 Kennisbank

Koppel je ONEp1 energie manager aan Home Assistant en maak geavanceerde automatiseringen op basis van je energieverbruik, zonnepanelen en dynamische energieprijzen. Pas kanaalprioriteiten automatisch aan op basis van het seizoen, tijdstip of andere condities.

Wat kan je met de integratie?

De ONEp1 Home Assistant integratie geeft je volledige controle over je energie manager vanuit HA:

Real-time energiedata — verbruik en teruglevering als sensoren (kW)
Meterstanden — totaal verbruik en teruglevering (kWh) + gas (m³) voor het HA Energie dashboard
Kanaalinstellingen aanpassen — prioriteit, max vermogen, reactietijd, drempels, thuisaccu modus, economic mode
Kanalen aan/uit schakelen — via knoppen of automatiseringen
Slimme regels — schakel op basis van seizoen, weer, aanwezigheid of andere HA triggers

Abonnement vereist

De Home Assistant integratie is beschikbaar voor gebruikers met een actief ONEp1 abonnement (€1,30/maand of €13/jaar).

Installeren in 5 stappen

1API Key genereren

Open het ONEp1 dashboard, ga naar Instellingen en scroll naar de Home Assistant sectie. Klik op "API Key Genereren".

2Integratie downloaden

Klik op "Download ONEp1 integratie (.zip)" in dezelfde sectie. Je kunt ook direct downloaden via onep1.nl/api/ha/download.

3Bestanden installeren

Pak het ZIP bestand uit in je Home Assistant config/ map zodat je deze structuur krijgt:

config/
  custom_components/
    onep1/
      __init__.py
      sensor.py
      coordinator.py
      config_flow.py
      ...

Je kunt de config/ map bereiken via de Samba share add-on of via SSH.

4Home Assistant herstarten

Ga naar Instellingen → Systeem → Herstarten.

5Integratie toevoegen

Ga naar Instellingen → Apparaten en diensten → Integratie toevoegen en zoek "ONEp1". Plak je API Key en klik opslaan.

Wat krijg je na installatie?

Sensoren

ONEp1 Verbruik — huidig verbruik in kW (realtime, elke 10 seconden)
ONEp1 Teruglevering — huidige teruglevering in kW
ONEp1 Verbruik Totaal — meterstand verbruik in kWh (voor HA Energie dashboard)
ONEp1 Teruglevering Totaal — meterstand teruglevering in kWh
ONEp1 Gas — gasmeterstand in m³
ONEp1 Kanaal 0-3 — status per kanaal met attributen (prioriteit, max kW, reactietijd, etc.)

Service: onep1.set_channel

Met de onep1.set_channel service kun je elk kanaal aansturen. Beschikbare instellingen:

channel — kanaalnummer (0-3)
active — kanaal aan/uit (true/false)
priority — prioriteit (1-4, 1 = hoogste)
maxPower — max vermogen in kW
reactionTime — reactietijd in seconden
thresholdPower — surplus drempel in kW
consumptionThreshold — verbruik drempel in kW
isBattery — thuisaccu modus (true/false)
isMeter — meter modus/passthrough (true/false)
economicMode — economic mode aan/uit (true/false)
name — kanaalnaam

HA Energie dashboard

De sensoren ONEp1 Verbruik Totaal, ONEp1 Teruglevering Totaal en ONEp1 Gas zijn compatible met het HA Energie dashboard. Ga naar Energie in de zijbalk en configureer:

Van netwerk geïmporteerde energie → ONEp1 Verbruik Totaal
Naar netwerk geëxporteerde energie → ONEp1 Teruglevering Totaal
Gas → ONEp1 Gas

Besturing door Home Assistant

In het ONEp1 dashboard onder Instellingen → Home Assistant staat een schakelaar "Besturing door Home Assistant":

Aan — alleen HA kan kanaalinstellingen wijzigen, het dashboard is read-only
Uit — alleen het dashboard kan wijzigen, de HA API is geblokkeerd voor schrijfacties

Dit voorkomt dat het dashboard en HA elkaars instellingen overschrijven.

Voorbeeld automatiseringen

Kanaal aan/uit op basis van aanwezigheid

automation:
  - alias: "EV lader uit als niet thuis"
    trigger:
      - platform: state
        entity_id: person.jouw_naam
        to: "not_home"
    action:
      - service: onep1.set_channel
        data:
          channel: 0
          active: false

  - alias: "EV lader aan als thuis"
    trigger:
      - platform: state
        entity_id: person.jouw_naam
        to: "home"
    action:
      - service: onep1.set_channel
        data:
          channel: 0
          active: true

Prioriteit wijzigen op basis van temperatuur

automation:
  - alias: "Warmtepomp prioriteit 1 bij vorst"
    trigger:
      - platform: numeric_state
        entity_id: weather.thuis
        attribute: temperature
        below: 5
    action:
      - service: onep1.set_channel
        data:
          channel: 0
          priority: 1
          maxPower: 5.0

Max vermogen aanpassen

automation:
  - alias: "Boiler max 2kW overdag"
    trigger:
      - platform: time
        at: "08:00:00"
    action:
      - service: onep1.set_channel
        data:
          channel: 3
          maxPower: 2.0

  - alias: "Boiler max 3.6kW 's nachts"
    trigger:
      - platform: time
        at: "22:00:00"
    action:
      - service: onep1.set_channel
        data:
          channel: 3
          maxPower: 3.6

Veelgestelde vragen

Hoe snel worden wijzigingen doorgevoerd?

Wanneer je via HA een kanaalinstelling wijzigt, wordt dit binnen 7 seconden opgepikt door je ONEp1 dongle.

Is er een limiet op het aantal API calls?

De API is gelimiteerd tot 60 requests per minuut per API key. Bij een scan_interval van 10 seconden gebruik je 6 requests per minuut.

Kan ik de integratie combineren met het ONEp1 dashboard?

Ja, maar gebruik de schakelaar "Besturing door Home Assistant" om te bepalen wie de controle heeft. Zo voorkom je dat beide elkaars instellingen overschrijven.

Werkt het met elke Home Assistant installatie?

Ja, de integratie werkt als custom component op elke HA installatie (Home Assistant OS, Container, Core, Supervised).

Heb ik HACS nodig?

Nee. Je downloadt de integratie direct vanuit het ONEp1 dashboard en installeert het handmatig. HACS is niet vereist.

ONEp1 en Home Assistant