ChirpStack Payload Decoder: Von Hex zu sauberem JSON

ChirpStack führt bei jedem Uplink eine kleine JavaScript-Funktion aus. Sie bekommt die rohen Bytes und gibt ein JSON-Objekt zurück. Die decodierten Werte stehen dann im Event-Stream (MQTT/HTTP) bereit und lassen sich an ThingsBoard, Grafana oder jede Anwendung weiterreichen. Dieselbe Codec-Datei enthält auch den Downlink-Encoder für steuerbare Geräte (Relais, Thermostate, Ventile).

ChirpStack v4 erwartet eine decodeUplink(input)-Funktion. input.bytes ist ein Array von Byte-Werten; du gibst { data: { ... } } zurück. Milesight nutzt ein Channel-Format, wiederholt [Channel-ID][Channel-Type][Payload]:

function decodeUplink(input) {
  var bytes = input.bytes;
  var data = {};

  for (var i = 0; i < bytes.length; ) {
    var channel = bytes[i++];
    var type = bytes[i++];

    if (channel === 0x01 && type === 0x75) {          // Batterie (%)
      data.battery = bytes[i]; i += 1;
    } else if (channel === 0x03 && type === 0x67) {   // Temperatur, INT16 LE / 10
      data.temperature = readInt16LE(bytes, i) / 10; i += 2;
    } else if (channel === 0x04 && type === 0x68) {   // Feuchte, UINT8 / 2
      data.humidity = bytes[i] / 2; i += 1;
    } else {
      break;  // unbekannter Channel, abbrechen statt fehlzuparsen
    }
  }
  return { data: data };
}

function readInt16LE(b, i) {
  var v = (b[i + 1] << 8) | b[i];
  return v > 0x7fff ? v - 0x10000 : v;
}

• Endianness: Milesight-Payloads sind little-endian. Mehrbyte-Werte in falscher Reihenfolge gelesen ergeben Unsinn.
• Skalierungsfaktoren: Temperatur wird durch 10 geteilt, Feuchte durch 2. Ein fehlender Divisor ist der häufigste Decode-Bug.
• Unbekannte Channels: Bei unbekanntem Channel abbrechen, statt den Rest des Payloads fehlzuparsen.
• v3 zu v4: v3 nutzt eine andere Funktionssignatur und zeigte decodierte Daten als objectJSON. v4 zeigt sie direkt als object. Codecs und Converter zusammen migrieren.