Deye + Home Assistant: lokale Modbus integratie in 2026

Twee routes om Deye en Home Assistant te koppelen

Lokaal via Modbus TCP, of via de Deye Cloud API met Node-RED als brug. Voor de meeste power-users is lokaal de juiste keuze; cloud is een fallback voor wanneer de logger geen Modbus TCP spreekt of HA op afstand draait.

Optie A · lokale Modbus TCP setup in 8 stappen

Reken op 20 tot 30 minuten. Voorwaarde: een huidige Deye WiFi-logger met firmware MW3.16 of nieuwer en Home Assistant draaiend op je LAN.

1. 1

   Logger en HA op zelfde subnet

   Zorg dat je Deye WiFi-logger en je Home Assistant host in hetzelfde lokale subnet zitten (typisch 192.168.1.0/24). VLAN-segmentatie of Guest-WiFi blokkeert Modbus TCP.

2. 2

   Logger-IP achterhalen via router

   Ga naar je router DHCP client list. Zoek naar het MAC-adres dat begint met de Deye OUI (vaak D8:F1:5B of EC:FA:BC). Reserveer het IP statisch om drift te voorkomen.

3. 3

   HACS installeren als nog niet aanwezig

   In HA: Settings, Add-ons, en installeer Home Assistant Community Store. Restart HA na install. HACS is de gangbare weg voor third-party integraties.

4. 4

   Integratie deye_inverter via HACS

   Open HACS, Integrations, plus-knop, zoek "Deye Inverter Modbus". Install. Restart HA. De integratie is open-source en ondersteunt alle SUN-X hybride omvormers.

5. 5

   Device toevoegen in HA

   Settings, Devices and Services, Add Integration, kies Deye Inverter Modbus. Vul logger-IP in, port 502, slave-id 1 (default voor enkelvoudige inverter; bij parallel-stack 1 t/m 6).

6. 6

   Wacht 30 seconden op discovery

   De integratie spreekt de logger aan, leest het model uit en laadt de juiste register-map. Bij een SUN-12K-SG04LP3 krijg je circa 280 entities; bij een 1-fase model rond 180.

7. 7

   Dashboard cards toevoegen

   Maak een nieuw dashboard "Energie". Voeg Energy-card toe en koppel pv1_power, pv2_power als productie, grid_power als import/export, battery_power voor opslag. Statistics-card voor today_pv_yield.

8. 8

   Sensors valideren

   Vergelijk de waardes in HA met de Deye Cloud app of de display van de inverter. battery_soc moet identiek zijn, pv_power binnen 1-2% afwijking. Zo niet: slave-id of register-map klopt niet.

Optie B · Deye Cloud API setup in 6 stappen

Voor wanneer lokale Modbus TCP geen optie is. Reken op 45 tot 60 minuten omdat je een Node-RED flow bouwt en API-keys aanvraagt.

1. 1

   Deye Cloud account

   Maak een account op de Deye Cloud app of webportal. Koppel je inverter via de plant-id. Zorg dat de inverter daadwerkelijk data uploadt (controleer Live tab).

2. 2

   API-keys via legacy developer-portal

   Vraag developer-toegang aan via de legacy developer-portal achter Deye Cloud. Genereer een appId en appSecret. Bewaar deze veilig in HA secrets.yaml.

3. 3

   Node-RED installeren als HA add-on

   Settings, Add-ons, store, Node-RED. Install en start. Node-RED wordt onze brug tussen Cloud API en HA via MQTT.

4. 4

   HTTP-poll node configureren

   In Node-RED: maak een flow met een inject node (interval 60s), HTTP request node naar de plant-data endpoint, met Bearer-token uit een eerdere auth-call. Hou polling op 60s minimum tegen rate-limits.

5. 5

   JSON transformeren naar MQTT

   Function-node die de JSON-payload pakt en de relevante velden (battery_soc, pv_power, grid_power) als losse MQTT-topics publiceert onder homeassistant/sensor/deye/. Gebruik HA discovery-payload voor auto-onboarding.

6. 6

   Dashboard in HA

   De entities verschijnen automatisch via MQTT-discovery. Bouw hetzelfde dashboard als bij optie A. Houd er rekening mee dat data 60-300 sec achterloopt op realtime.

Belangrijkste sensors · 15 essentiële Modbus registers

De HACS-integratie publiceert circa 280 entities. Onderstaande 15 dekken 90% van wat je nodig hebt voor dashboards, automations en EVCC.

Voorbeeldautomations · 4 YAML-snippets

Plak deze in je automations.yaml of importeer via de UI. Pas entity-namen aan op je eigen setup.

alias: "Deye batterij laag"
description: "Push wanneer SoC < 20%"
trigger:
  - platform: numeric_state
    entity_id: sensor.deye_battery_soc
    below: 20
    for:
      minutes: 5
condition: []
action:
  - service: notify.mobile_app_jean
    data:
      title: "Deye batterij laag"
      message: "SoC is {{ states('sensor.deye_battery_soc') }}%"
mode: single

alias: "Deye laden bij Tibber-dal"
description: "Force-charge tijdens dynamisch dal-uur"
trigger:
  - platform: numeric_state
    entity_id: sensor.tibber_prijs_actueel
    below: 0.12
condition:
  - condition: numeric_state
    entity_id: sensor.deye_battery_soc
    below: 70
action:
  - service: modbus.write_register
    data:
      hub: deye_inverter
      address: 0x0094
      slave: 1
      value: 1
mode: single

alias: "EV laden op PV-overschot"
description: "Laad EV alleen bij export > 2000 W"
trigger:
  - platform: numeric_state
    entity_id: sensor.deye_grid_power
    below: -2000
    for:
      minutes: 2
condition:
  - condition: state
    entity_id: binary_sensor.ev_aanwezig
    state: "on"
action:
  - service: switch.turn_on
    target:
      entity_id: switch.ev_lader
mode: single

alias: "Deye foutcode kritiek"
description: "Discord-alert bij F23, F41, F58"
trigger:
  - platform: state
    entity_id: sensor.deye_alert_code
    to:
      - "F23"
      - "F41"
      - "F58"
condition: []
action:
  - service: notify.discord_webhook
    data:
      title: "Deye foutcode actief"
      message: "Code {{ states('sensor.deye_alert_code') }} op {{ now() }}"
mode: single

Foutoplossing · meest voorkomende issues