Energielenker Hilfecenter: SunSpec-Modbus im Lobas-System einrichten und nutzen

Modbus TCP Server

Gültig ab Lobas-Version: V2.7.0

Der Lobas nutzt das SunSpec-Modbus-Protokoll zur Integration in Energiemanagementsysteme. Dadurch können externe Systeme wie EMS, Leitsysteme oder SCADA auf Daten von Wallboxen, Zählern und weiteren Komponenten zugreifen.

Voraussetzung

Die Bereitstellung der Daten muss in den einzelnen Komponenten aktiviert werden. Öffne dazu die Ladepunkt‑ oder Zähler‑Einstellungen über das Dashboard. Im Abschnitt „Allgemein“ aktiviere die Funktion „Daten über Modbus TCP Server bereitstellen“.

Modbus-Server aktivieren

  1. Navigiere zu Konfiguration > Schnittstellen - Abschnitt Modbus TCP Server
  2. Aktiviere den Modbus TCP Server
  3. Wähle einen Port über 1024, z. B. 1502, da niedrigere Ports Adminrechte erfordern.
  4. Speichere die Einstellungen
  5. Mit Klick auf Aktive Geräte anzeigen erscheint eine Liste aller über Modbus verfügbaren Komponenten.

SunSpec-Protokollübersicht

Das SunSpec-Protokoll basiert auf Modbus und bietet standardisierte Datenmodelle für die Energiebranche.

  1. Adressierung: Adressen starten bei 0 (Offset), Daten werden im Big-Endian-Format übertragen.
  2. Modelle:
    1. Wallbox-Modell: Startadresse 113
    2. Zähler-Modell: Startadresse 213
    3. Weitere Modelle siehe unten

Zugriff und Adressierung

Nach Aktivierung des Modbus TCP Servers:

  1. Lobas ist unter Unit ID = 1 erreichbar.
  2. An Lobas angeschlossene Geräte: ab Unit ID = 2.
  3. Registerbereiche: Einheitliche Datenlänge und Offsets für konsistente Auslesung.
Die Startadressen und Offsets aller Register werden im Lobas angezeigt und müssen nicht manuell gesucht werden.

Start-Adressen der Modelle

Modell-Nr. Adresse Registerlänge Komponente Anmerkungen
113 variabel 63 Ladestation
124 variabel 26 Batteriespeicher
213 variabel 127 Zähler Inkl. virtueller Zähler für Energieflüsse
60000 40952 16 Lobas-Einstellungen Register können in zukünftigen Versionen variieren
60001 40970 33 CM Flags (bis 32) Register können in zukünftigen Versionen variieren
60002 41004 22 Lobas-Variablen Register können in zukünftigen Versionen variieren

Bei Entfernung eines Geräts rücken die folgenden Registerbereiche automatisch nach. Es existieren keine fest reservierten Adressräume.

Modell 113 (Wallbox)

Offset Beschreibung Einheit
2 Summe Ströme L1-L3 A
4/6/8 Strom L1/L2/L3 A
16/18/20 Spannung L1/L2/L3 V
22 Leistung W
24 Frequenz Hz
26
Scheinleistung
VA
32 Import, Wirkleistung Wh
62 Zustand (bei Modbus ID+1)
63 Geräte ID (bei Modbus ID+1)

Modell 124 (Batteriespeicher)

Offset Beschreibung Einheit
2 Max. Lade-/Entladeleistung W
3/4 % des aktuellen Lade-/Entladeleistungslimits %
8 State of Charging %
18/19 Skalierungsfaktoren
26 Geräte ID (bei Modbus ID+1)

Modell 213 (Zähler)

OffsetBeschreibungEinheit
0Modellkennung 213
1Länge
2Summe Ströme L1-L3A
4Strom L1A
6Strom L2A
8Strom L3A
10SpannungV
12Spannung L1V
14Spannung L2V
16Spannung L3V
26FrequenzHz
28LeistungW
30Leistung L1W
32Leistung L2W
34Leistung L3W
36ScheinleistungVA
38Scheinleistung L1VA
40Scheinleistung L2VA
42Scheinleistung L3VA
44BlindleistungVAr
60Export, WirkleistungWh
68Import, WirkleistungWh
126Rolle (bei Modbus ID+1)
127Geräte ID (bei Modbus ID+1)

Modell 60000 – Lobas Einstellparameter

OffsetBeschreibungEinheit
0Modellkennung 60000 (uint16, read-only)
1Länge (uint16, read-only)
2Max. GesamtstrommA
4Power ReservemA
6ÜberziehungmA
8Max. Wallbox-GesamtstrommA
10Max. PhasenschieflagemA
12Lastmanagement aktiv (1) / inaktiv (0)
14Hausverbrauch zur Schieflage addieren (1/0)
16Prozent max. Gesamtstrom (volatile)%

Modell 60001 – CM Flags

OffsetBeschreibung
0Modellkennung
1Länge
2–33CM.flag1 – CM.flag32

Modell 60002 – Lobas Variablen

OffsetBeschreibung
0Länge (uint16, read-only)
1Länge (uint16, read-only)
2–22Name Variable 1
23–24Wert Variable 1
25–45Name Variable 2
46–47Wert Variable 2


Hinweis zur Weiterentwicklung

In künftigen Versionen können sich Startadressen ändern. Es wird empfohlen, den Registerbereich bei jeder neuen Konfiguration automatisch zu scannen. Die Modbus-ID nachfolgender Komponenten erhöht sich jeweils um 1.


Datenformate

  • Modellnummer und Registerlänge: Dezimal (uint16)
  • Alle weiteren Werte: Float (Big Endian)

Bei Fragen zur Implementierung oder tiefergehenden technischen Details steht der Support zur Verfügung.


    • Related Articles

    • Modbus-Kommunikation testen

      Gültig ab Lobas-Version: V2.3.0 Mit dem Fenster Modbus in den Entwicklertools kannst du die Modbus-Kommunikation im Lobas-System gezielt testen. Das ist besonders nützlich, wenn du externe Geräte wie Zähler oder Steuerungen über Modbus TCP oder ...
    • Anbindung von Komponenten über Modbus RTU (RS485)

      1. Zweck und Anwendungsbereich Dieser Abschnitt beschreibt die Anbindung externer Komponenten, wie Ladepunkte oder Stromzähler, an Lobas über die serielle RS485‑Schnittstelle unter Verwendung des Modbus‑RTU‑Protokolls. Die Modbus‑RTU‑Anbindung dient ...
    • Zähler des Netzverknüpfungspunktes anlegen

      In diesem Artikel erfährst du, wie du im Lobas-System einen Zähler für den Netzanschluss (z. B. NSHV) anlegst. Dieser Schritt ist essentiell für den ordnungsgemäßen Betrieb des Lastmanagements. Voraussetzungen Du bist im Lobas-Webinterface ...
    • Anmeldung im Webinterface

      In diesem Artikel erfährst du, wie du dich am Lobas-System über den Browser anmeldest. Die Anleitung gilt für alle Varianten – mit oder ohne Display – und ist besonders hilfreich für die erste Einrichtung oder bei Änderungen an der ...
    • Schnittstellen im Lobas-System konfigurieren

      In diesem Artikel erfährst du, wie du im Lobas-System die wichtigsten Schnittstellen einrichtest – darunter OCPP, MQTT, Modbus TCP und serielle Verbindungen. Diese Konfigurationen ermöglichen deinem Energiemanagementsystem die Kommunikation mit ...