ThingsBoard verbinden

ThingsBoard ist eine Open-Source-IoT-Plattform für Dashboards, Gerätemanagement und Datenanalyse. Die Integration eignet sich für Energiedienstleister, Stadtwerke und Facility Manager, die Smart-Meter-Daten zentral auswerten möchten.

Verfügbar ab Plan Growing.

Weg 1: Direktes MQTT (empfohlen)

energiedaten.at sendet Messwerte direkt an den eingebauten MQTT-Transport von ThingsBoard — kein externer Broker nötig. Funktioniert sowohl mit der Community als auch der Professional Edition.

Schritte

1. In ThingsBoard: Device anlegen für jeden Zähler.
2. Manage Credentials → Access Token des Devices kopieren.
3. In energiedaten.at: MQTT-Verbindung einrichten mit folgenden Werten:

4. Zähler über Routen zuweisen.

Messwerte kommen im nativen Telemetrie-Format von ThingsBoard ({ts, values}) an — kein Data Converter nötig. Prüfen Sie unter Entities → Devices → Latest Telemetry. Werte erscheinen unter ihrem OBIS-Code (z. B. 1-1:1.9.0 P.01).

Einschränkung: Jede MQTT-Verbindung in energiedaten.at authentifiziert sich als ein ThingsBoard-Device. Bei mehreren Zählern ist pro Zähler eine eigene Verbindung nötig. Das funktioniert gut für kleine bis mittlere Setups.

Weg 2: MQTT über externen Broker (Professional Edition)

Für größere Setups mit vielen Zählern unterstützt die ThingsBoard Professional Edition MQTT Platform Integrations. energiedaten.at publiziert alle Messwerte an einen gemeinsamen MQTT-Broker, den ThingsBoard abonniert — mit automatischer Geräteanlage.

Schritte

1. MQTT-Broker bereitstellen (z. B. Mosquitto), der sowohl für energiedaten.at als auch für ThingsBoard erreichbar ist.

2. MQTT-Verbindung in energiedaten.at einrichten → MQTT einrichten. Konfigurieren Sie Broker-Host, Port, Zugangsdaten und setzen Sie das Topic auf energiedaten/{metering_point_number}.

3. Zähler zuweisen über Routen in der Verbindungseinstellung.

4. Uplink Data Converter in ThingsBoard anlegen (Data Converters → Add Data Converter → Uplink):

var data = JSON.parse(decodeToString(payload));
var topic = metadata['topic'];
var deviceName = topic.substring(topic.lastIndexOf('/') + 1);

var telemetry = Array.isArray(data) ? data : [data];

return {
    deviceName: deviceName,
    deviceType: 'smart-meter',
    telemetry: telemetry
};

5. Integration → MQTT in ThingsBoard anlegen:

6. Debug-Modus aktivieren für die erste Überprüfung.

7. Ergebnis prüfen: Unter Entities → Devices werden Geräte automatisch angelegt. Der Tab Latest Telemetry zeigt Ihre OBIS-Code-Messwerte.

Alternative: HTTP-Integration (Professional Edition)

Wenn Sie keinen MQTT-Broker betreiben möchten, aber automatische Geräteanlage wünschen, unterstützt die ThingsBoard PE auch HTTP-Integrations. energiedaten.at sendet Messwerte als Webhook direkt an den HTTP-Integration-Endpunkt von ThingsBoard — gleiche Auto-Provisioning-Vorteile, keine zusätzliche Infrastruktur.