Ein Milesight-Gateway ist ein Packet Forwarder, kein Network Server. Das Funkmodul empfängt LoRaWAN-Frames der Sensoren in Reichweite und leitet die rohen Bytes an ChirpStack weiter, das Join, MAC-Layer und Routing übernimmt. Drei Dinge müssen stimmen, damit die Verbindung funktioniert: das Forwarder-Protokoll, die Region und ein registriertes Gateway mit der richtigen EUI. Das Gateway dekodiert den Sensor-Payload nie, das ist Aufgabe des ChirpStack Payload Decoders auf dem Device Profile.
Milesight Gateway mit ChirpStack: UG65, UG67 und UG56 anbinden
Milesight UG65, UG67 oder UG56 an ChirpStack v4 anbinden: Semtech UDP, MQTT Forwarder oder Basics Station, die Gateway Bridge und EU868 im Überblick.
Architektur
Der Datenfluss
Ein Milesight UG65, UG67 oder UG56 leitet rohe LoRaWAN-Frames an deinen Network Server weiter. Diese Anleitung zeigt die drei Wege zu ChirpStack v4, die Rolle der Gateway Bridge, das EU868-Topic-Präfix und wie du das Gateway registrierst, damit Frames wirklich ankommen.
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.
Was das Gateway eigentlich tut
Drei Wege, wie ein Milesight-Gateway ChirpStack erreicht
Die Gateways Milesight UG65, UG67 und UG56 bieten in ihrer Weboberfläche dieselben Forwarder-Optionen:
- Eingebetteter ChirpStack MQTT Forwarder. Das Gateway veröffentlicht Frames direkt an deinen MQTT-Broker über TCP, mit TLS und Authentifizierung. Das ist der robusteste Weg und braucht keinen separaten Bridge-Prozess. Empfohlen für selbst gehostetes ChirpStack v4.
- Semtech UDP Packet Forwarder. Das klassische Protokoll: eine Pseudo-JSON-Nachricht über UDP an Port 1700. Maximale Kompatibilität, aber keine Verschlüsselung und keine Zustellgarantie, ein verlorenes UDP-Paket ist schlicht weg. Es braucht eine ChirpStack Gateway Bridge, die UDP in MQTT übersetzt.
- Basics Station. Semtechs modernes LNS-Protokoll über ein gesichertes WebSocket. Ein guter Mittelweg, ebenfalls von der Gateway Bridge verarbeitet.
Wo die Gateway Bridge sitzt
ChirpStack nimmt Semtech UDP oder Basics Station nicht direkt entgegen. Die ChirpStack Gateway Bridge sitzt zwischen Forwarder und Network Server: Sie wandelt diese Protokolle in MQTT (Protobuf oder JSON) auf einer bekannten Topic-Struktur um. In einer Standard-Installation von ChirpStack v4 läuft die Bridge neben dem Server, du rollst sie also meist nicht separat aus. Nutzt das Gateway den eingebetteten MQTT Forwarder, veröffentlicht es selbst am Broker und die Bridge wird ganz umgangen.
Sensors ──LoRaWAN RF──> Milesight UG65/UG67/UG56
│
┌─────────────────────┼──────────────────────┐
│ Semtech UDP :1700 │ Basics Station (WSS) │ Embedded MQTT Forwarder
▼ ▼ │
ChirpStack Gateway Bridge ───┘ │
│ MQTT (Protobuf/JSON) │
▼ ▼
MQTT broker ──> ChirpStack v4 Network Server
Semtech UDP: das Gateway auf die Bridge richten
Beim Semtech UDP Packet Forwarder braucht das Gateway nur die Serveradresse und die Up-/Down-Ports. Beide stehen standardmäßig auf 1700, dem Port, auf dem die Gateway Bridge lauscht. Auf der Gateway-Seite (oder in der eingebetteten lora-packet-forwarder-Konfiguration) sind die relevanten Zeilen:
{
"gateway_conf": {
"gateway_ID": "24E124FFFEF54092",
"server_address": "chirpstack.example.eu",
"serv_port_up": 1700,
"serv_port_down": 1700,
"keepalive_interval": 10,
"stat_interval": 30
}
}
Die gateway_ID ist die Gateway-EUI, derselbe Wert, den du in ChirpStack registrierst. Milesight druckt sie auf das Label und zeigt sie in der Oberfläche; sie leitet sich auch aus der Gateway-MAC ab.
Region EU868 und das Topic-Präfix
Gateway-Band und ChirpStack-Region müssen übereinstimmen. Für Europa ist das EU868. ChirpStack v4 stellt jedem Gateway-Event-Topic die Region voran, und das ist der mit Abstand häufigste Grund, warum ein frisch verbundenes Gateway nichts zeigt. Das Topic lautet:
eu868/gateway/{GatewayEUI}/event/up
eu868/gateway/{GatewayEUI}/event/stats
eu868/gateway/{GatewayEUI}/command/down
Wenn du mit einem MQTT-Client debuggst, abonniere die Wildcard mit Präfix, nicht ohne:
mosquitto_sub -h chirpstack.example.eu -t 'eu868/gateway/+/event/+' -v
Ein Abo nur auf gateway/# liefert nichts, weil das Region-Präfix Teil des Topics ist.
Gateway in ChirpStack registrieren
Gehe in ChirpStack auf Gateways, Add gateway und trage die Gateway-EUI genau so ein, wie sie auf dem Gerät steht. Setze dieselbe Region EU868. Sobald der Forwarder läuft und die EUI passt, zeigt der Reiter Gateway events Live-stats- und up-Frames. Von dort fließen Uplinks in deine Anwendungen, werden auf dem Device Profile dekodiert und weitergeleitet, etwa an ChirpStack zu ThingsBoard.
Stolperfallen aus der Praxis
- Region-Präfix: ChirpStack v4 stellt den Topics die Region voran (
eu868/...). Abonnieren ohne Präfix heißt keine Frames. Das passiert fast bei jedem ersten Setup. - EUI-Mismatch: Die Gateway-EUI in der Forwarder-Konfiguration muss zeichengenau der in ChirpStack registrierten entsprechen. Ein Tippfehler bedeutet, dass Frames ankommen, aber als von einem unbekannten Gateway verworfen werden.
- UDP kennt keine Retries: Semtech UDP verwirft verlorene Pakete stillschweigend. Bei wackeligem Backhaul lieber den MQTT Forwarder oder Basics Station nutzen.
- Firewall: Semtech UDP braucht Port 1700 erreichbar; der MQTT Forwarder braucht den Broker-Port (üblich 8883 für TLS) ausgehend vom Gateway offen.
- Gateway ist kein Server: Ein Gateway ohne erreichbaren Network Server startet trotzdem und zeigt grüne LEDs. Online heißt nicht mit ChirpStack verbunden.
Hardware-Seiten und Managed Hosting
Das passende Gateway hängt vom Standort ab: das Indoor-Gerät Milesight UG65 und das kompakte UG56 decken Büros und Gebäude ab, während das Outdoor-Gerät UG67 für Dächer und Höfe gebaut ist. Jede Seite listet die unterstützten Forwarder-Modi und Bänder. Ein Gateway auf dem Dach, das ChirpStack speist, ist das übliche Rückgrat einer Smart-City-Lösung, bei der viele Sensoren einen Network Server teilen. Wir registrieren dein Gateway, setzen Region EU868 und Broker und betreiben den Network Server als ChirpStack Managed Hosting auf europäischer Infrastruktur.
Häufige Fragen
Der eingebettete ChirpStack MQTT Forwarder ist am robustesten, weil er über TCP mit TLS und Authentifizierung läuft. Semtech UDP ist am einfachsten und kompatibelsten, hat aber keine Verschlüsselung und keine Zustellgarantie. Basics Station ist das moderne LNS-Protokoll und ein guter Mittelweg. Für ein selbst gehostetes ChirpStack nutzen wir standardmäßig den MQTT Forwarder.
Nur wenn das Gateway rohe Semtech-UDP- oder Basics-Station-Frames sendet. Die Gateway Bridge wandelt diese in MQTT für den Network Server um und ist Teil der Standard-Installation von ChirpStack v4. Mit dem eingebetteten MQTT Forwarder veröffentlicht das Gateway direkt am Broker, ein separater Bridge-Prozess entfällt dann.
Die zwei häufigsten Ursachen sind ein Region-Mismatch und das Topic-Präfix. Das Gateway-Band muss zur ChirpStack-Region passen (hier EU868), und ChirpStack v4 stellt der Gateway-Event-Topic die Region voran, etwa eu868/gateway/+/event/up. Ein Abo nur auf gateway/# empfängt nichts.
Nein. Das Gateway leitet nur rohe LoRaWAN-Frames weiter. Das Dekodieren des Binär-Payloads in JSON passiert im Codec des Device Profile in ChirpStack, nicht auf dem Gateway. Das sind getrennte Aufgaben.
Ja. Das Gateway leitet jeden empfangenen Frame weiter, egal aus welcher Anwendung. ChirpStack ordnet jeden Uplink über die Device-Session der richtigen Anwendung zu, sodass ein einzelnes UG65 viele Anwendungen und Mandanten gleichzeitig anbinden kann.
Ja. Wir betreiben ChirpStack v4 auf europäischer Infrastruktur, registrieren dein UG65, UG67 oder UG56, setzen die Region EU868 und den Broker und prüfen, dass Frames ankommen. Netz und Daten bleiben in deinem Besitz.
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.
Ihr Ansprechpartner
Timo Wevelsiep
Gründer, merkaio
15 Minuten, unverbindlich, direkt mit Timo.
merkaio ist unabhängiger Integrator und nicht mit Milesight affiliiert.