Milesight WS201: LoRaWAN-Sensor für Füllstandsüberwachung

Milesight WS201 LoRaWAN-Füllstandsensor: eigener ChirpStack/ThingsBoard-Decoder, dekodiertes Beispiel, ToF-Distanz und Restmengen-Alarme für Spender-Monitoring.

Milesight WS201
WS201Sensor
LoRaWAN
Class A, OTAA
Band / Port
EU868 / Port 85
Messprinzip
Time-of-Flight-Distanz
Messbereich
1 bis 55 cm, Genauigkeit plus/minus 1 cm
Batterie
590 mAh CR2450, rund 3,2 Jahre
Montage
Innen in Behältern und Spendern
Konfiguration
NFC (Milesight ToolBox)
Messgrößen

Was misst der WS201?

Distanz

Time-of-Flight-Abstand zur Oberfläche in Millimetern, gültig im Messbereich von 1 bis 55 cm mit einer Genauigkeit von plus/minus 1 cm.

Restmenge

Aus der Distanz abgeleiteter Füllstand in Prozent, nachdem leer und voll kalibriert wurden.

Batteriestand

Wird in Prozent gemeldet, sodass Nachfüllung und Batteriewechsel gemeinsam geplant werden können.

Daten ins Dashboard

Integration

Sensor / Controller

Misst oder steuert vor Ort und sendet LoRaWAN-Uplinks.

LoRaWAN-Gateway

Empfängt die Funkpakete und reicht sie an den Server weiter.

ChirpStack

Network-Server: verwaltet Sessions und decodiert das Payload.

ThingsBoard / Grafana

Dashboards, Alarme, Regeln und Reports.

ChirpStack v4 · decodeUplink
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) {          // battery (%)
      data.battery = bytes[i]; i += 1;
    } else if (channel === 0x03 && type === 0x82) {   // distance (mm)
      data.distance = readUInt16LE(bytes, i); i += 2;
    } else if (channel === 0x04 && type === 0xd6) {   // remaining amount (%)
      data.remaining = bytes[i]; i += 1;
    } else {
      break;
    }
  }
  return { data: data };
}

function readUInt16LE(b, i) {
  return ((b[i + 1] << 8) | b[i]) & 0xffff;
}

Implementiert nach der veröffentlichten Milesight-Byte-Spezifikation (Communication Protocol / User Guide).

Kanalformat: 01 75 Batterie (%), 03 82 Distanz (UINT16 Little-Endian, Millimeter), 04 D6 Restmenge (%). Geräteinfo- und Downlink-Antwort-Frames beginnen mit Kanal FF und FE und werden hier übersprungen. Der Restmengen-Prozentwert hängt von den über NFC kalibrierten Referenzdistanzen für leer und voll ab, dokumentiere diese also je Behälter. Für ThingsBoard kommt dieselbe Kanallogik in einen Uplink-Converter. Implementiert aus der veröffentlichten Milesight-Byte-Spezifikation.

Uplink (hex)

0175640382540104D65A

Decoded JSON

{ "battery": 100, "distance": 340, "remaining": 90 }
Aus der Praxis

Konfiguration & Stolpersteine

NFC-Einrichtung

Schlüssel, Meldeintervall und die Referenzdistanzen für leer und voll werden vor dem Rollout über NFC mit der Milesight ToolBox geschrieben.

Leer und voll kalibrieren

Der Restmengen-Prozentwert wird aus der Distanz abgeleitet, setze daher die Referenzpunkte für leer und voll je Behälter, sonst driftet der Prozentwert zwischen Behälterformen.

Im Messbereich bleiben

Der Time-of-Flight-Sensor misst von 1 bis 55 cm. Montiere ihn so, dass die Oberfläche bei vollem und leerem Behälter in diesem Bereich bleibt, sonst werden Messwerte am unteren oder oberen Limit abgeschnitten.

Schwellwert-Alarme

Ein Alarm bei niedriger Restmenge wird sofort gesendet, außerhalb des Meldeintervalls, daher sollten Dashboard-Regeln Alarm-Uplinks als prioritäre Nachfüll-Ereignisse behandeln.

Dein Partner

So unterstützt dich merkaio beim WS201

Von der Beschaffung bis zum laufenden Betrieb, alles aus einer Hand und auf eigener europäischer Infrastruktur.

Pre-Staging & Provisioning

Wir konfigurieren den WS201, setzen Keys, Intervalle und Alarme und liefern einsatzbereit aus.

Eigener Decoder

Payload-Codec für ChirpStack v4 und ThingsBoard, nach der Milesight-Spezifikation implementiert.

Integration ins Dashboard

Die Daten landen in deinem ThingsBoard oder Grafana, inklusive Alarmen und Reports.

Betrieb & Monitoring

Wir betreiben LoRaWAN-Stack und Dashboards auf europäischer Infrastruktur, du nutzt nur die Daten.

Häufige Fragen

Ja. Es ist ein Standard-LoRaWAN-Gerät, kein Milesight-Gateway oder Cloud nötig. Du fügst den Codec zum Device-Profil hinzu und provisionierst per OTAA.
Ja, für ChirpStack und ThingsBoard, implementiert aus der veröffentlichten Milesight-Byte-Spezifikation. Dieselbe Kanallogik kommt in einen ThingsBoard-Uplink-Converter.
Es ist ein Class-A-Gerät auf LoRaWAN-Port 85. Jeder Uplink trägt die Time-of-Flight-Distanz und die Restmenge; der Batteriestand wird in Prozent gemeldet.
Er nutzt einen Time-of-Flight-Sensor, um den Abstand zur Oberfläche im Behälter zu messen, und leitet daraus über die kalibrierten Referenzdistanzen für leer und voll einen Restmengen-Prozentwert ab.
Er läuft mit einer 590-mAh-CR2450-Lithium-Knopfzelle, ausgelegt auf rund 3,2 Jahre bei SF7 auf EU868, abhängig vom über NFC konfigurierten Meldeintervall.
Der Prozentwert wird aus der Distanz abgeleitet und hängt daher von den Referenzdistanzen für leer und voll ab. Kalibriere diese Referenzen für die Behälterform neu und prüfe, dass die Oberfläche bei vollem und leerem Behälter im Messbereich von 1 bis 55 cm bleibt.
Aus derselben Serie

Verwandte Geräte

Sprechen wir über Ihre Infrastruktur. Digital und vor Ort.

Ob IoT-Plattformentwicklung, Hardwareauswahl, Managed Hosting für ChirpStack, ThingsBoard, Grafana oder NetBird VPN, oder Migration von einem Self-Hosted-Setup - wir finden die passende Lösung für Ihren Anwendungsfall. Buchen Sie ein kostenloses 30-Minuten-Gespräch, unverbindlich.

Timo Wevelsiep

Ihr Ansprechpartner

Timo Wevelsiep

Gründer, merkaio

15 Minuten, unverbindlich, direkt mit Timo.

Mit dem Absenden stimmen Sie unserer Datenschutzerklärung zu.

Decoder für ChirpStack v4. merkaio ist unabhängiger Integrator und nicht mit Milesight affiliiert.