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

Wie teste ich den Modbus TCP Server?

Wie teste ich den Modbus TCP Server?

Gültig ab Lobas-Version: V2.32.0 (LMB 3.20.0)

Der Lobas nutzt das SunSpec-Modbus-Protokoll zur Integration in Energiemanagementsysteme. Externe Systeme wie EMS, Leitsysteme oder SCADA greifen dadurch auf Daten von Wallboxen, Zählern und weiteren Komponenten zu.

Voraussetzung

Die Bereitstellung der Daten muss in den einzelnen Komponenten aktiviert werden. Öffne dazu die Ladepunkt- oder Zähler-Einstellungen über das Dashboard. Aktiviere im Abschnitt „Allgemein“ 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. Bei Lobas-Systemen auf Basis der CC100-Hardware sowie bei allen Lobas-Systemen ab Baujahr 2025 ist der Port fest auf 1502 gesetzt und nicht änderbar. Bei Lobas-Systemen von vor 2025 lässt sich der Port frei wählen (empfohlen: ein Port über 1024, 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: Der SunSpec-Block liegt immer fest an Adresse 40'000. Er enthält einen Marker sowie Herstellerinformationen. Alle weiteren Blöcke – Systemeinstellungen (UnitID = 1) und Geräteeinstellungen (UnitID = 2) – folgen ohne feste Adressierung. Ein Scan der Register ist daher notwendig. Die Lobas-Oberfläche bietet dafür den Button „Aktive Geräte anzeigen“.
  2. Datenformat: Alle Daten werden ausschließlich im Big-Endian-Format übertragen.
  3. Modelle: Unter UnitID = 1 stehen die systemspezifischen Modelle 60'000, 60'001 und 60'002 zur Verfügung. Unter UnitID = 2 stehen die Modelle 113 (Ladestation), 213 (Zähler) und 124 (Batteriespeicher) zur Verfügung.

Zugriff und Adressierung

Nach Aktivierung des Modbus TCP Servers:

  1. Lobas ist unter Unit ID = 1 erreichbar.
  2. An Lobas angeschlossene Geräte sind ab Unit ID = 2 erreichbar.
  3. Die Startadressen der Geräteblöcke lassen sich über die Lobas-Oberfläche abfragen.

Wichtig: Ein von den Adressen abhängiges System sollte die exakte Blockadresse immer dynamisch über einen Scan ab Adresse 40'000 bestimmen. Es besteht keine Garantie, dass sich Blockadressen durch Erweiterungen nicht verschieben.

Start-Adressen der Modelle

Modell-Nr.AdresseRegisterlängeKomponenteAnmerkungen
113variabel63Ladestation
124variabel26Batteriespeicher
213variabel127ZählerInkl. virtueller Zähler für Energieflüsse
600004007016Lobas-EinstellungenRegister können sich in zukünftigen Versionen ändern
600014009833CM Flags (bis 32)Register können sich in zukünftigen Versionen ändern
600024013222Lobas-VariablenRegister können sich in zukünftigen Versionen ändern

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

Modell 113 (Wallbox)

OffsetBeschreibungEinheit
2Summe Ströme L1-L3A
4/6/8Strom L1/L2/L3A
16/18/20Spannung L1/L2/L3V
22LeistungW
24FrequenzHz
26ScheinleistungVA
32Import, WirkleistungWh
62Zustand
63Geräte ID

Modell 124 (Batteriespeicher)

OffsetBeschreibungEinheit
2Max. Lade-/EntladeleistungW
3/4% des aktuellen Lade-/Entladeleistungslimits%
8State of Charging%
18/19Skalierungsfaktoren
26Geräte ID

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–
127Geräte ID–

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

Startadressen können sich in künftigen Versionen ändern. Scanne den Registerbereich bei jeder neuen Konfiguration automatisch, beginnend bei Adresse 40'000.

Datenformate

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

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

    • Related Articles

    • Wie teste ich die Modbus-Kommunikation über die Entwicklertools?

      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 ...

    • Wie teste ich den Tesla Wall Connector?

      Gültig ab Lobas-Version: V2.3.0 Mit dieser Funktion prüfst du gezielt, ob ein Tesla Wall Connector (TWC) korrekt mit dem Lobas-System kommuniziert. Das ist besonders hilfreich bei der Inbetriebnahme oder Fehlersuche. So gehst du vor: Öffne den ...

    • Wie teste ich Zähler über die Entwicklertools?

      Gültig ab Lobas-Version: V2.3.0 Mit dem Fenster Zähler in den Entwicklertools kannst du prüfen, ob ein angebundener Energiezähler korrekt konfiguriert ist und zuverlässig mit dem Lobas-System kommuniziert. Das hilft dir dabei, mögliche ...

    • Wie konfiguriere ich Laderegeln im Lobas-System? ab V2.30.0

      Gültig ab Lobas-Version: V2.30.0 Hinweis: Dies ist ein Artikel für Geräte ab Version 2.30.0 bis vor Version 2.33.0. Für Geräte mit einer älteren Version gilt folgender Artikel: Wie konfiguriere ich Laderegeln in Lobas. Für Geräte ab Version 2.33.0 ...

    • 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 ...