// projecten / home assistant

Home Assistant als Modbus TCP-slave

Maakt van Home Assistant een Modbus TCP-apparaat. Kies een entiteit en een registeradres, en elke PLC, SCADA of energiemanager kan de waarde lezen. Volledig in te stellen via de UI, zonder YAML. Open source.

Geef een ster op GitHub Geen budget? Een ster helpt ook. Eén klik op ★ Star op GitHub helpt andere Home Assistant-gebruikers de integratie te vinden.

Latest release Last commit License Buy Me a Coffee

Laatste versie: v1.1.0 · · Changelog

// functies

Wat het doet

Alles wat Home Assistant weet, wordt beschikbaar als Modbus-registers. Je PLC leest de buitentemperatuur van een Zigbee-sensor, je energiemanager het vermogen van de laadpaal, en als je dat toestaat schakelt de PLC een lamp of zet hij een thermostaat.

  • Eenvoudig instellen

    Slave ID en poort (standaard 502), en Home Assistant beantwoordt Modbus TCP-verzoeken.

  • Elke entiteit koppelen

    Kies een entiteit en een startadres. Het register volgt de status direct, zonder polling.

  • Automatische datatypes

    Aan/uit wordt een bit, hele getallen uint16 of int16, de rest float32. Aan te passen naar uint32, int32 of scaled16 (waarde × 10/100/1000 in één register).

  • Werkt met elke master

    Coils en discrete inputs geven dezelfde bits, holding en input registers dezelfde registers. Masters die alleen FC3 kennen zien dus alles.

  • Optioneel terugschrijven

    Vink Writable aan en de master kan entiteiten schakelen of getallen instellen, met de juiste Modbus-foutcodes bij ongeldige writes.

  • Toegestane masters

    Accepteer alleen verbindingen van opgegeven IP-adressen of reeksen, en luister desgewenst op één interface, zoals je PLC-VLAN.

  • Gedraagt zich als echt apparaat

    Beantwoordt alleen zijn eigen slave ID, zoals een apparaat achter een gateway. Verzoeken voor andere unit ID's krijgen geen antwoord.

  • Veilig op een draaiende installatie

    Standaard alleen lezen. Schrijven kan alleen naar schakelbare en instelbare entiteiten, binnen hun min/max, en nooit een half 32-bit-getal.

Modbus TCP kent geen authenticatie. Vul Allowed masters in, houd de poort op een vertrouwd netwerk of VLAN en zet hem nooit open naar internet.

// screenshots

Zo ziet het eruit

Demo met waarden van een P1-slimme meter (vermogen, energie, stroom), gekoppeld aan registers.

  • Setup: slave ID, poort, luisteradres en toegestane masters
    Setup: slave ID, poort, luisteradres en toegestane masters
  • Koppeling toevoegen: kies een entiteit
    Koppeling toevoegen: kies een entiteit
  • Herkend datatype, klaar om te bevestigen of aan te passen
    Herkend datatype, klaar om te bevestigen of aan te passen
  • Alle koppelingen met hun registers
    Alle koppelingen met hun registers

// installatie

Installeren via HACS

Open HACS repository on My Home Assistant

  • 01Repository toevoegen

    Open HACS, kies ⋮ → Custom repositories, plak https://github.com/CervezaStallone/HA-Modbus-Slave en kies categorie Integration.

  • 02Downloaden

    Download Modbus Slave en herstart Home Assistant.

  • 03Integratie toevoegen

    Ga naar Instellingen → Apparaten & diensten → Integratie toevoegen, zoek op Modbus Slave en kies slave ID en poort.

  • 04Eerste koppeling

    Klik op Configureren → Add mapping, kies een entiteit en een startadres. De master kan de waarde meteen lezen.

Poort 502 werkt op Home Assistant OS en Supervised. Op Container of Core zonder root kies je een poort vanaf 1024, bijvoorbeeld 5020.