Universal Modbus: Modbus-TCP-Geräte ohne YAML über die Home-Assistant-Oberfläche einrichten

Showroom
, ,
1

Hallo zusammen,

ich möchte euch meine Custom Integration Universal Modbus vorstellen.

Sie richtet sich an alle, die Geräte über Modbus TCP in Home Assistant einbinden möchten, aber keine umfangreiche YAML-Konfiguration pflegen wollen. Verbindungen und Entitäten werden vollständig über eine grafische Oberfläche eingerichtet.

Typische Anwendungsfälle sind beispielsweise:

  • Wechselrichter und Batteriespeicher
  • Wärmepumpen
  • Wallboxen
  • Energiezähler
  • SPS- und Industriekomponenten
  • andere Geräte mit Modbus-TCP-Schnittstelle

Was kann Universal Modbus?

  • Mehrere Modbus-TCP-Geräte verwalten
  • Eigener Editor in der Home-Assistant-Seitenleiste
  • Coils, Discrete Inputs, Holding Registers und Input Registers lesen
  • Coils und Holding Registers schreiben
  • Sensoren, Binärsensoren, Schalter, Taster, Zahlenwerte und Auswahllisten erstellen
  • Unterstützung für bool, int16, uint16, int32, uint32 und float32
  • Skalierung und Offset konfigurieren
  • Byte- und Word-Reihenfolge einstellen
  • Separate Rückmelderegister für schreibbare Entitäten verwenden
  • Werte direkt im Editor anzeigen und steuern
  • Vollständige Gerätekonfigurationen importieren und exportieren
  • Benachbarte Register automatisch zu gemeinsamen Abfragen zusammenfassen
  • Diagnosewerte für Antwortzeit, Kommunikationsfehler und letzte erfolgreiche Abfrage anzeigen
  • Deutsche und englische Oberfläche

Universal Modbus – Übersicht
Universal Modbus – Übersicht1014×955 59.8 KB

Universal Modbus – Geräteeditor
Universal Modbus – Geräteeditor686×613 10.9 KB

Universal Modbus – Entitätseditor
Universal Modbus – Entitätseditor684×905 29.3 KB

Installation über HACS

Die Integration wurde zur Aufnahme in das Standardverzeichnis von HACS eingereicht. Die Prüfung steht aktuell noch aus. Bis dahin lässt sie sich als benutzerdefiniertes Repository installieren:

  1. In HACS Integrationen öffnen

  2. Oben rechts Benutzerdefinierte Repositories auswählen

  3. Folgende Adresse hinzufügen:

    https://github.com/Idelmaeaen/HA-Universal-Modbus

  4. Als Kategorie Integration auswählen

  5. Universal Modbus herunterladen

  6. Home Assistant neu starten

  7. Unter Einstellungen → Geräte & Dienste → Integration hinzufügen nach Universal Modbus suchen

Repository und Dokumentation:

Wichtige Hinweise

Aktuell wird ausschließlich Modbus TCP unterstützt. Modbus RTU beziehungsweise eine serielle Verbindung ist noch nicht enthalten.

Für die Einrichtung wird weiterhin die Registerbeschreibung des jeweiligen Gerätes benötigt. Die Adressen werden nullbasiert direkt an pymodbus übergeben. Eine Dokumentationsadresse wie 40001 wird daher nicht automatisch umgerechnet.

Tester und Gerätekonfigurationen gesucht

Ich würde mich besonders über Rückmeldungen mit unterschiedlichen Geräten freuen. Falls ihr Universal Modbus ausprobiert, schreibt gerne:

  • welches Gerät ihr verwendet,
  • welche Register und Funktionen ihr eingebunden habt,
  • ob Lesen und Schreiben zuverlässig funktionieren,
  • welche Datentypen oder Funktionen euch noch fehlen.

Exportierte Gerätekonfigurationen könnten später außerdem anderen Anwendern mit demselben Gerät den Einstieg erleichtern.

Universal Modbus wird von Edelmann Electronics entwickelt und gepflegt. Fehlerberichte, Verbesserungsvorschläge und Pull Requests sind willkommen.

2 „Gefällt mir“