← Zurück
Dokumentation · Benutzerhandbuch

EasySense Link — Benutzerhandbuch

So konfigurieren und betreiben Sie EasySense Link: Zähler, Funk, Modbus TCP, MQTT, Firmware und Fehlerbehebung.

EasySense Link ist eine M-Bus-Gateway-Anwendung für den Teltonika TRB143. Sie liest verdrahtete und drahtlose M-Bus-Zähler aus, veröffentlicht die Daten per MQTT und stellt optional einen Modbus-TCP-Server und ein lokales Webportal bereit. Dieses Handbuch behandelt die tägliche Konfiguration und den Betrieb. Ist Link noch nicht installiert, beginnen Sie mit der Einrichtungsanleitung.

01 · Einführung

Überblick

Link läuft autonom auf dem TRB143. Nach der Konfiguration fragt es kontinuierlich Ihre Zähler ab, wertet die Messwerte aus und leitet sie an die EasySense-Plattform (oder Ihren eigenen Broker) weiter. Dieselben Daten können über Modbus TCP an ein Gebäudeleitsystem geliefert werden. Ein lokales Webportal auf Port 8000 steht jederzeit zur Konfiguration und Überwachung bereit.

EasySense-Link-Webportal
Das EasySense-Link-Webportal.
02 · Zugang

Erste Anmeldung

Öffnen Sie http://<geräte-ip>:8000 in einem Browser. Das Portal erfordert ein Passwort — es ist die TRB143-Seriennummer, die auf dem Geräteetikett aufgedruckt ist.

🔧Link noch nicht installiert oder Port 8000 noch nicht geöffnet? Folgen Sie zuerst der Einrichtungsanleitung.
03 · Lizenzierung

Lizenz & Funktionen

Link benötigt eine gültige Lizenz, um zu funktionieren. Ohne sie ist die Zählerauslesung deaktiviert und alle optionalen Funktionen sind gesperrt. Jede Lizenz aktiviert einen bestimmten Satz an Funktionen:

FunktionWas sie freischaltet
mqttVeröffentlichung an Ihren eigenen (Benutzer-)MQTT-Broker
modbusModbus-TCP-Server
wirelessDrahtloses M-Bus über das RelAir-R2M-Gateway
max_metersMaximale Anzahl an Zählern (unbegrenzt, wenn nicht gesetzt)

Lizenz installieren oder aktualisieren

Unter 1. Administration → License können Sie entweder einen Aktivierungscode für die Online-Aktivierung eingeben oder eine .dat-Lizenzdatei mit Choose File → Install hochladen. Der Lizenzbereich zeigt den aktuellen Status, die Seriennummer, das Ablaufdatum, das Zählerlimit und die aktivierten Funktionen an.

Lizenzen können ein Ablaufdatum haben. Link prüft die Gültigkeit bei jedem Auslesezyklus erneut; abgelaufene Funktionen werden deaktiviert, bis eine neue Lizenz installiert ist.
04 · Portal

Das Webportal

Das Portal ist in nummerierte, aufklappbare Abschnitte gegliedert:

  • 1. Administration — Lizenz, Firmware-Updates, Systemprotokoll, Log-Level und Benutzer-MQTT-Broker.
  • 2. M-Bus Control & Scanning — nach verdrahteten Zählern scannen, Auslesen starten/stoppen und Ausleseintervall festlegen.
  • 3. Wireless M-Bus (wM-Bus) — RelAir-Gateway, Funk-Scan-Liste, Whitelist und AES-Schlüssel.
  • 4. Meter Administration — verdrahtete (primäre) und drahtlose (sekundäre) Zähler hinzufügen oder aktualisieren.
  • 5. Live Values — aktuelle Messwerte der angeschlossenen Zähler.
  • 6. Modbus — Modbus-TCP-Server aktivieren/deaktivieren und Port festlegen.
  • 7. Modbus Register Mapping (Trend) — Zählerwerte auf Modbus-Register abbilden.
  • 8. Modbus Register Overview — das aktuelle Registerlayout, das Modbus-Clients bereitgestellt wird.

Nicht alle Abschnitte werden angezeigt — die verfügbaren Abschnitte hängen von den durch die installierte Lizenz aktivierten Funktionen ab.

Abschnitt Administration
1. Administration — Lizenz, Firmware, Protokollierung und Broker-Einstellungen.
05 · Verdrahtet

Verdrahtete Zähler

Verdrahtete Zähler werden über die M-Bus-Schnittstelle des TRB143 angeschlossen. Jeder hat eine eindeutige Primäradresse im Bereich 1–250.

Zähler hinzufügen

  • Automatischer Scan — legen Sie in 2. M-Bus Control & Scanning die Start- und Endadresse fest und klicken Sie auf Start Scan. Gefundene Zähler werden automatisch gespeichert.
  • Manuell — geben Sie in 4. Meter Administration → Primary (Wired) die Adresse ein und klicken Sie auf Add/Update.

Sekundäradressierung

Neben Primäradressen unterstützt Link auch die Sekundäradressierung, bei der der Zähler direkt über seine Seriennummer hinzugefügt wird. Geben Sie unter 4. Meter Administration → Secondary (Wired) die 8-stellige Seriennummer ein (z. B. 00012345) und klicken Sie auf Add/Update. Die Felder Mfr, Ver und Type sind optional und grenzen die Auswahl ein, falls mehrere Zähler dieselbe Seriennummer haben. Vor jeder Auslesung wählt Link den Zähler per M-Bus-Sekundäradressierung aus, sodass er auch ohne bekannte Primäradresse ausgelesen werden kann — praktisch, wenn mehrere Zähler mit derselben Primäradresse ausgeliefert wurden.

Auslesen

Klicken Sie auf Start Read, um das kontinuierliche Abfragen zu starten. Das Ausleseintervall (Standard 15 Minuten) legt fest, wie oft die Zähler abgefragt werden; ändern Sie es und klicken Sie auf Set Read Interval.

Abschnitt M-Bus Control and Scanning
2. M-Bus Control & Scanning.
06 · Funk

Drahtlose Zähler (RelAir R2M)

Drahtlose M-Bus-Zähler werden über ein RelAir R2M-Gateway empfangen (erfordert die wireless-Lizenz). Das Gateway empfängt Telegramme in Modus C und T. Sekundäradressen sind 8-stellige Dezimalkennungen, z. B. 00012345.

Einrichtung

  1. Schließen Sie das RelAir R2M an die verdrahtete M-Bus-Schnittstelle an.
  2. Klicken Sie in 3. Wireless M-Bus auf Discover — das Gateway wird automatisch erkannt.
  3. Klicken Sie auf Set Mode C+T / RSSI / AGE, um den Empfang zu konfigurieren.

Funk-Scan-Liste vs. Whitelist

  • Radio Scan List (RSL) — jeder Zähler, den das Gateway hört, automatisch befüllt mit Signalstärke (RSSI) und Verschlüsselungsstatus.
  • Whitelist (WL) — die Zähler, die Sie tatsächlich auslesen möchten. Nur Zähler auf der Whitelist werden verarbeitet. Fügen Sie einen Zähler aus der Liste mit der Schaltfläche + WL hinzu.

AES-Verschlüsselung

Verschlüsselte Zähler benötigen einen 128-Bit-AES-Schlüssel — geben Sie den 32-stelligen Hex-Schlüssel über die Schaltfläche Change / Schlüssel ein. Der Schlüsselstatus wird anhand eingehender Telegramme validiert:

  • OK — Entschlüsselung erfolgreich.
  • Wrong key — Telegramm empfangen, aber Entschlüsselung fehlgeschlagen.
  • No key — verschlüsselter Zähler ohne gespeicherten Schlüssel.
Abschnitt Wireless M-Bus
3. Wireless M-Bus — Gateway, Funk-Scan-Liste und Whitelist.
07 · Modbus

Modbus-TCP-Server

Der integrierte Modbus-TCP-Server (erfordert die modbus-Lizenz) stellt Zählerdaten als Holding-Register für ein Gebäudeleitsystem bereit.

  • Aktivieren/Deaktivieren und den Port in Abschnitt 6. Modbus festlegen (Standard 502, konfigurierbar 1–65535).
  • Slots — 6 Zähler-Slots, jeder auf 40 aufeinanderfolgende Holding-Register abgebildet.

Registerlayout (pro Slot)

OffsetFeldTypRegister
+0StatusU161 (1=online, 0=offline)
+1PrimäradresseU161
+2–3Zähler-Seriennr.U322 (High-Word zuerst)
+4–7EnergieFloat644 (IEEE-754, Big-Endian)
+8–11VolumenFloat644
+12–13DurchflussFloat322
+14–15LeistungFloat322
+16–17Temperatur 1Float322
+18–19Temperatur 2Float322
+20–21FeuchtigkeitFloat322
+22–39Reserviert18

Slot 1 beginnt bei Register 40001, Slot 2 bei 40041 und so weiter.

Feldzuordnung

Jeder Slot ordnet die M-Bus-Werte des Zählers automatisch den Modbus-Feldern zu. Wenn ein Zähler mehrere Werte desselben Typs bereitstellt (z. B. mehrere Energieregister), können Sie die automatische Auswahl in Abschnitt 7. Modbus Register Mapping (Trend) überschreiben. Das resultierende Layout wird in Abschnitt 8. Modbus Register Overview angezeigt.

Abschnitt Modbus
6. Modbus — aktivieren und Port festlegen; Zuordnung und Übersicht in Abschnitt 7–8.
08 · MQTT

Benutzer-MQTT-Broker

Standardmäßig werden Zählerdaten an den EasySense-Management-Broker veröffentlicht. Mit der Lizenzfunktion mqtt können Sie Link stattdessen auf Ihren eigenen Broker richten.

Geben Sie unter 1. Administration → User MQTT Broker Host, Port, Benutzername und Passwort ein, aktivieren Sie optional TLS und klicken Sie auf Save. Nach der Konfiguration werden Zählerdaten an Ihren Broker geleitet. Die Geräteverwaltung funktioniert weiterhin über beide Broker, und Befehlsantworten gehen stets an den Broker zurück, der den Befehl gesendet hat.

09 · Updates

Firmware-Updates & Rollback

Link kann sich selbst over-the-air aktualisieren. Klicken Sie in 1. Administration → Firmware auf Check for updates, wählen Sie eine kompatible Version aus der Dropdown-Liste und klicken Sie auf Update. Link lädt das Paket herunter, prüft dessen SHA-256-Prüfsumme, kontrolliert die OS-Kompatibilität, installiert es und startet den Dienst automatisch neu.

Rollback

Vor jedem Update wird die aktuelle Version gesichert. Verursacht ein Update Probleme, klicken Sie auf Rollback (es zeigt die Backup-Version und den Zeitstempel), um die vorherige Version wiederherzustellen und neu zu starten. Es wird eine Rollback-Ebene aufbewahrt — das jüngste Backup.

10 · Logs

Protokollierung

  • Systemprotokoll — Link protokolliert in das Syslog des TRB143. Laden Sie es unter 1. Administration → System Log herunter.
  • Log-Level — zur Laufzeit anpassbar (DEBUG, INFO, WARNING, ERROR) über das Portal.
  • Fernüberwachung — Betriebsmeldungen werden zur Ferndiagnose auch an die EasySense-Plattform veröffentlicht.
11 · Betrieb

Normalbetrieb

Nach der Konfiguration läuft Link unbeaufsichtigt: Beim Start verbindet es sich mit dem Broker und registriert das Gerät, validiert die Lizenz und fragt dann kontinuierlich die Zähler im festgelegten Intervall ab und veröffentlicht die ausgewerteten Daten. Ist Modbus aktiviert, hält es die Holding-Register aktuell und sendet einen periodischen Heartbeat an die Plattform.

🛡️Link erholt sich automatisch von vorübergehenden Fehlern (serielle Fehler, Broker-Trennungen, Thread-Abstürze). Ein Watchdog überwacht alle Worker-Threads und startet sie bei Bedarf neu.
12 · Hilfe

Fehlerbehebung

SymptomWahrscheinliche UrsacheLösung
Keine ZählerdatenAuslesen gestoppt oder keine Zähler konfiguriertAuslesen starten; Zähleradressen prüfen
“Serial port not available”Hardware- oder KonfigurationsproblemM-Bus-Verkabelung prüfen; serielle Portkonfiguration verifizieren
Drahtlose Zähler erscheinen nichtGateway nicht erkannt oder nicht auf der WhitelistDiscover ausführen; zur Whitelist hinzufügen
“Wrong key” bei einem drahtlosen ZählerFalscher AES-SchlüsselDen korrekten 32-stelligen Hex-Schlüssel erneut eingeben
Modbus-Register alle nullSlot nicht zugeordnet oder Zähler offlineDem Slot einen Zähler zuweisen; prüfen, ob der Zähler antwortet
Lizenz abgelaufenZeitlich begrenzte LizenzEine neue Lizenz installieren oder den Support kontaktieren
Firmware-Update schlägt fehlOS inkompatibel oder NetzwerkfehlerDie OS-Version des Geräts prüfen; Verbindung verifizieren