// 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.
Geen budget? Een ster helpt ook. Eén klik op ★ Star op GitHub helpt andere Home Assistant-gebruikers de integratie te vinden.
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
uint16ofint16, de restfloat32. Aan te passen naaruint32,int32ofscaled16(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 
Koppeling toevoegen: kies een entiteit 
Herkend datatype, klaar om te bevestigen of aan te passen 
Alle koppelingen met hun registers
// installatie
Installeren via HACS
-
01Repository toevoegen
Open HACS, kies ⋮ → Custom repositories, plak
https://github.com/CervezaStallone/HA-Modbus-Slaveen 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.
// links
Open source
Gratis te gebruiken onder de GPL-3.0-licentie. Bevalt de integratie? Een koffie helpt bij verder ontwikkelen.
Modbus koppelen aan je PLC, GBS of energiemanager? Neem contact op.