ChirpStack zu ThingsBoard: Decodierte LoRaWAN-Uplinks weiterreichen

ChirpStack hat das Payload bereits decodiert, die Werte stehen im Feld object. Genau dieses Feld mappt ThingsBoard auf Telemetrie. Voraussetzung ist ein funktionierender Payload-Codec im Device-Profile.

{
  "deviceInfo": {
    "applicationId": "00372e31-0620-4671-8270-237632a4e227",
    "applicationName": "cold-chain",
    "deviceProfileName": "EM300-TH",
    "deviceName": "kuehlhaus-01",
    "devEui": "24e124136b502217"
  },
  "fPort": 85,
  "fCnt": 128,
  "data": "AXVkA2etAARoSw==",
  "object": { "battery": 100, "temperature": 17.3, "humidity": 57.5 },
  "rxInfo": [{ "gatewayId": "24e124fffef54092", "rssi": -51, "snr": 13.8 }],
  "txInfo": { "frequency": 868100000 }
}

Der schnellste Weg: beim Anlegen des Converters den Integrationstyp ChirpStack wählen, ThingsBoard liefert einen vorausgefüllten Decoder samt extrahierter Metadaten. Generisch und transparent geht es so:

// payload = ChirpStack-Event (JSON), metadata = auto-extrahierte Felder
var data = decodeToJson(payload);

var result = {
  deviceName: data.deviceInfo.devEui,             // stabiler, eindeutiger Schluessel
  deviceType: data.deviceInfo.deviceProfileName,  // z. B. "EM300-TH"
  attributes: {
    applicationName: data.deviceInfo.applicationName,
    fPort: data.fPort
  },
  telemetry: {
    ts: new Date(data.time).getTime(),
    values: data.object                           // decodierte Werte 1:1 durchreichen
  }
};

// Signalqualitaet als Telemetrie (optional, aber praxisnah)
if (data.rxInfo && data.rxInfo.length > 0) {
  result.telemetry.values.rssi = data.rxInfo[0].rssi;
  result.telemetry.values.snr  = data.rxInfo[0].snr;
}

return result;

ThingsBoard legt das Gerät bei der ersten Nachricht automatisch an und identifiziert es über die DevEUI, nicht über den Anzeigenamen. So bleibt die Zuordnung stabil, auch wenn du Geräte umbenennst.

Für steuerbare Geräte (UC300-Relais, WT102-Thermostat) baust du einen Downlink-Converter. Er übersetzt eine ThingsBoard-RPC oder eine Änderung an einem Shared-Attribute in einen ChirpStack-Downlink-Enqueue:

// Ausgeloest ueber die Rule Engine (Integration-Downlink-Node).
// metadata traegt die Ziel-DevEUI und ApplicationID.
var fPort = 85;
var payloadBase64 = msg.dataBase64;   // dein encodierter Befehl, Base64

var result = {
  contentType: "JSON",
  data: JSON.stringify({
    devEui: metadata.devEui,    // muss zur DevEUI im Topic passen
    confirmed: false,
    fPort: fPort,               // muss groesser 0 sein
    data: payloadBase64         // Base64; ChirpStack verschluesselt vor dem Senden
  }),
  metadata: {
    topic: "application/" + metadata.applicationId +
           "/device/" + metadata.devEui + "/command/down"
  }
};

return result;

Getriggert wird der Downlink in der Rule-Chain über einen Integration-Downlink-Node. Wichtig: Bei Class-A-Geräten wird der Downlink erst im RX-Fenster nach dem nächsten Uplink zugestellt, bei Class C (z. B. UC300) nahezu sofort.

• Region-Prefix: Die ChirpStack-v4-Default-Config stellt der Topic-Struktur die Region voran (z. B. eu868/application/...). Abonnierst du nur application/#, kommt nichts an. Entweder mit Prefix abonnieren oder den Prefix in der chirpstack.toml entfernen.
• v3 zu v4: Decodierte Daten liegen in v4 im Objekt object, früher im String objectJSON. Alte Converter mit JSON.parse(data.objectJSON) brechen.
• DevEUI als Schlüssel: Geräte über devEui zuordnen, nicht über den Namen.
• fPort größer 0: Downlinks mit fPort 0 werden abgewiesen.