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: Professional Edition (empfohlen)

Die ThingsBoard Professional Edition unterstützt externe MQTT Platform Integrations. Damit kann energiedaten.at Messwerte an einen gemeinsamen MQTT-Broker senden, den ThingsBoard abonniert.

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 Topic-Präfix (z. B. energiedaten/).

  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 result = {
    deviceName: data.meter_id,
    deviceType: 'smart-meter',
    attributes: { unit: data.unit },
    telemetry: [{
        ts: new Date(data.timestamp).getTime(),
        values: { value_kwh: data.value_kwh, quality: data.quality }
    }]
};
return result;
  1. Integration → MQTT in ThingsBoard anlegen:
Feld Wert
Host Hostname des MQTT-Brokers
Port 1883 (oder 8883 für TLS)
Topic-Filter energiedaten/#
QoS 0
Uplink Converter Den eben erstellten Converter auswählen

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

  2. Ergebnis prüfen: Unter Entities → Devices werden Geräte automatisch angelegt. Der Tab Latest Telemetry zeigt value_kwh und quality.

Weg 2: Community Edition

Die ThingsBoard Community Edition unterstützt keine MQTT Platform Integrations. energiedaten.at sendet stattdessen direkt an den eingebauten MQTT-Transport von ThingsBoard — pro Zähler ein eigenes Device.

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:
Feld Wert
Broker-Host Hostname Ihrer ThingsBoard-Instanz
Port 1883
Benutzername Access Token (kein Passwort)
Topic v1/devices/me/telemetry
  1. Zähler über Routen zuweisen.

Einschränkungen der CE: Kein Integration-basiertes Auto-Provisioning, kein Topic-basiertes Device-Mapping. Jede MQTT-Verbindung in energiedaten.at zeigt auf genau ein ThingsBoard-Device. Bei mehreren Zählern ist pro Zähler eine eigene Verbindung nötig.

Alternativen

REST API: Ein externes Skript oder eine ThingsBoard Rule-Engine-Node kann die energiedaten.at API periodisch abfragen (Polling) und Messwerte per HTTP an ThingsBoard weiterleiten. Geeignet, wenn Sie keinen eigenen MQTT-Broker betreiben möchten.

Webhook: energiedaten.at pusht Messwerte als HTTP-POST direkt an den ThingsBoard REST API Endpunkt (/api/v1/{accessToken}/telemetry). Kein zusätzlicher Broker nötig — Einrichtung über Webhooks.