How to

RAK Wireless Geräte mit TagoIO verbinden

Schritt-für-Schritt-Anleitung zum Verbinden von RAK Wireless WisBlock Sensoren und RAK Gateways mit TagoIO. Behandelt die Einrichtung des LoRaWAN Network Servers (TTN und ChirpStack), das Parsen von Payloads und praktische Anwendungsfälle für smarte Landwirtschaft, industrielle Überwachung und Umweltmessung.

Thiago Lima ·
RAK Wireless Geräte mit TagoIO verbinden

RAK Wireless baut eines der flexibelsten LoRaWAN-Systeme, das heute verfügbar ist. Mit der modularen WisBlock-Plattform lassen sich Sensorkerne, Kommunikationsmodule und Grundplatinen kombinieren, um in wenigen Minuten einen individuellen IoT-Knoten zu bauen. Ihre Gateways RAK7258, RAK7289 und RAK7268 sind in Gebäuden, auf Campussen und an Industriestandorten weit verbreitet.

TagoIO liefert die Anwendungsschicht: Geräteverwaltung, Datenspeicherung, Dashboards, Alarmierung und eine vollständige REST-API. Zusammen decken RAK-Hardware und TagoIO den kompletten Weg vom Sensor bis zur Entscheidung ab, aber die Verbindung erfordert ein paar gezielte Schritte auf beiden Seiten.

Diese Anleitung führt durch die gesamte Integration, von der Konfiguration des LoRaWAN Network Servers bis zu Ihrem ersten Live-Dashboard.

Was Sie vorab brauchen

  • Ein TagoIO-Konto (kostenloser Tarif verfügbar)
  • Ein RAK Gateway (RAK7258, RAK7289, RAK7268C oder ähnlich)
  • Einen oder mehrere WisBlock Sensorknoten oder RAK LoRaWAN Endgeräte
  • Einen LoRaWAN Network Server: The Things Network (TTN) oder eine selbst gehostete ChirpStack-Instanz

So funktioniert die Integration

RAK Gateways leiten LoRaWAN-Pakete an einen Network Server (NS) weiter. Der NS dekodiert die Geräteadressierung und übergibt die Payload an eine Anwendungsschicht, in diesem Fall TagoIO.

Es gibt zwei Hauptwege:

Weg 1: RAK Gateway → The Things Network → TagoIO Das ist die häufigste Konfiguration. TTN übernimmt die LoRaWAN-MAC-Schicht, und die native TTN-Integration von TagoIO empfängt Uplinks über einen webhook.

Weg 2: RAK Gateway → ChirpStack → TagoIO HTTPS webhook Für private Bereitstellungen oder On-Premise-Installationen können RAK Gateways mit ChirpStack (auf der RAK7258 AEP-firmware bereits integriert) dekodierte Payloads per HTTP POST an TagoIO weiterleiten.

Beide Wege führen in TagoIO zum selben Ergebnis. Wählen Sie nach Ihrer bevorzugten Netzwerkinfrastruktur.

Weg 1: RAK + The Things Network + TagoIO

Schritt 1: Registrieren Sie Ihr Gateway bei TTN

  1. Melden Sie sich bei console.cloud.thethings.network an.
  2. Wechseln Sie zu Gateways und klicken Sie auf Register gateway.
  3. Geben Sie die EUI Ihres Gateways ein (auf dem Etikett des RAK Gateways oder in der Admin-Oberfläche zu finden).
  4. Wählen Sie den Frequenzplan für Ihre Region (EU868, US915, AU915 usw.).
  5. Speichern Sie und prüfen Sie, ob Ihr Gateway als Connected angezeigt wird.

Schritt 2: Registrieren Sie Ihr Endgerät bei TTN

  1. Klicken Sie in Ihrer TTN-Anwendung auf Register end device.
  2. Wählen Sie Ihr WisBlock-Modul aus dem Geräte-Repository (z. B. RAK4631 mit dem passenden Sensorprofil) oder geben Sie die Zugangsdaten manuell ein.
  3. Kopieren Sie die generierten Werte AppEUI, DevEUI und AppKey. Diese programmieren Sie über das RAK Serial Port Tool oder per AT-Befehlen in Ihren WisBlock-Knoten.

Schritt 3: Legen Sie ein Gerät in TagoIO an

  1. Melden Sie sich bei admin.tago.io an.
  2. Klicken Sie in der linken Seitenleiste auf Devices und dann auf Add Device.
  3. Suchen Sie in der Connector-Liste nach The Things Network v3 und wählen Sie es aus.
  4. Geben Sie dem Gerät einen Namen, der zu Ihrem TTN-Endgerät passt.
  5. TagoIO erzeugt eine webhook-URL und einen Authorization Token. Kopieren Sie beide.

Vollständige Dokumentation zur Geräteeinrichtung: docs.tago.io/docs/tagoio/devices

Schritt 4: Fügen Sie den TagoIO webhook in TTN hinzu

  1. Gehen Sie in Ihrer TTN-Anwendung zu Integrations → Webhooks.
  2. Klicken Sie auf Add webhook und wählen Sie Custom webhook.
  3. Setzen Sie die Base URL auf die TagoIO webhook-URL aus Schritt 3.
  4. Setzen Sie den Authorization-Header auf den Token aus Schritt 3.
  5. Aktivieren Sie unter den Nachrichtentypen Uplink message.
  6. Speichern Sie den webhook.

TTN leitet nun jeden LoRaWAN-Uplink Ihrer registrierten Geräte in Echtzeit an TagoIO weiter.

Schritt 5: Schreiben Sie einen Payload Parser für Ihren WisBlock-Sensor

WisBlock-Sensoren senden binäre Payloads. Das Format hängt davon ab, welches Sensormodul Sie angeschlossen haben. TagoIO erwartet dekodierte Variablen in seinem Standard-Datenformat:

[
  {"variable": "temperature", "value": 22.5, "unit": "C"},
  {"variable": "humidity", "value": 58.0, "unit": "%"}
]

Um die rohe TTN-Payload in dieses Format zu überführen, fügen Sie Ihrem TagoIO-Gerät einen Payload Parser hinzu:

  1. Öffnen Sie das Gerät in TagoIO.
  2. Wechseln Sie zum Tab Payload Parser.
  3. Schreiben Sie eine JavaScript-Funktion, die payload.uplink_message.decoded_payload liest (TTN sendet dieses Feld, wenn Sie in TTN einen Formatter konfigurieren) oder dekodieren Sie die rohen Bytes aus payload.uplink_message.frm_payload.

Beispiel-Parser für einen WisBlock-Umweltsensor (RAK1906 / BME680):

const decoded = payload.uplink_message.decoded_payload;

if (!decoded) {
  payload = [];
  return;
}

payload = [
  { variable: "temperature", value: decoded.temperature, unit: "C" },
  { variable: "humidity", value: decoded.humidity, unit: "%" },
  { variable: "pressure", value: decoded.pressure, unit: "hPa" },
  { variable: "gas_resistance", value: decoded.gas, unit: "Ohm" }
];

Dokumentation zum Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser

Schritt 6: Prüfen Sie im Live Inspector

Öffnen Sie auf der Geräteseite den Tab Live Inspector. Er zeigt jede eingehende Anfrage in Echtzeit. Lösen Sie einen Uplink von Ihrem WisBlock-Knoten aus und bestätigen Sie, dass die dekodierten Variablen erscheinen, bevor Sie Ihr Dashboard bauen.

Live-Inspector-Dokumentation: docs.tago.io/docs/tagoio/devices/live-inspector

Weg 2: RAK Gateway + ChirpStack + TagoIO

Das RAK7258 und das RAK7289 werden mit einem integrierten ChirpStack-LNS in ihrer AEP-firmware ausgeliefert. Das ist nützlich für private LoRaWAN-Netze ohne Abhängigkeit von TTN.

Schritt 1: Konfigurieren Sie ChirpStack auf dem RAK Gateway

  1. Melden Sie sich an der Web-Oberfläche des RAK Gateways an (Standard 192.168.230.1).
  2. Gehen Sie zu LoRa Network und stellen Sie sicher, dass ChirpStack als Network Server ausgewählt ist.
  3. Erstellen Sie im ChirpStack Application Server eine Application und registrieren Sie Ihre Endgeräte.

Schritt 2: Fügen Sie in ChirpStack eine HTTP-Integration hinzu

  1. Öffnen Sie in ChirpStack Ihre Application und klicken Sie auf Integrations.

  2. Fügen Sie eine HTTP Integration hinzu.

  3. Setzen Sie die Uplink URL auf den TagoIO HTTPS-Endpunkt:

    https://api.tago.io/data

  4. Fügen Sie den HTTP-Header hinzu:

    Device-Token: YOUR_TAGOIO_DEVICE_TOKEN

Den Device Token finden Sie im Tab General Ihres TagoIO-Geräts.

Dokumentation zum Token: docs.tago.io/docs/tagoio/devices/device-token

Schritt 3: Parsen Sie die ChirpStack-Payload in TagoIO

ChirpStack sendet ein JSON-Objekt mit einem object-Feld, das die dekodierten Daten enthält (wenn Sie einen Codec konfiguriert haben), oder data als base64. Schreiben Sie in TagoIO einen entsprechenden Payload Parser.

// For ChirpStack with codec configured
const obj = payload.object;
payload = [
  { variable: "temperature", value: obj.temperature, unit: "C" },
  { variable: "humidity", value: obj.humidity, unit: "%" }
];

Schritt 7: Bauen Sie Ihr Dashboard

Sobald Daten fließen, erstellen Sie in TagoIO über Dashboards → + ein Dashboard.

Für eine WisBlock-Bereitstellung mit mehreren Sensoren ist dieses Startlayout sinnvoll:

  • Map-Widget, das alle Gerätestandorte zeigt (wenn ein GPS-Modul angeschlossen ist)
  • Zeitreihen-Diagramme für Temperatur und Luftfeuchtigkeit pro Gerät
  • Card-Widgets, die den letzten Messwert jeder Variablen anzeigen
  • Statusanzeigen für Akkustand und letzten Empfangszeitpunkt

Für Bereitstellungen, die viele RAK-Knoten über mehrere Standorte verwalten, nutzen Sie ein Blueprint Dashboard. Ein Layout gilt über Tags automatisch für alle Geräte.

Dashboard-Dokumentation: docs.tago.io/docs/tagoio/dashboards

Schritt 8: Richten Sie Alarme ein

Nutzen Sie Actions, um Benachrichtigungen auszulösen, wenn Sensorwerte den Bereich verlassen. Nützlich für RAK-Bereitstellungen:

  • Temperatur über dem Grenzwert → E-Mail/SMS an das Bereitschaftsteam
  • Luftfeuchtigkeit fällt in einer kontrollierten Umgebung unter 20 % → Lüftungslogik auslösen
  • Keine Daten innerhalb von 1 Stunde empfangen → Offline-Alarm

Actions-Dokumentation: docs.tago.io/docs/tagoio/actions

Beispiele für Anwendungsfälle

Smarte Landwirtschaft

WisBlock-Knoten mit Bodenfeuchte- (RAK12035), Temperatur- und Luftfeuchtigkeitssensoren, verteilt über ein Feld. Das Outdoor-Gateway RAK7289 deckt Flächen von mehreren Hektar ab. TagoIO speichert die Messwerte und löst Steuersignale für die Bewässerung aus, wenn die Bodenfeuchte unter den Zielbereich fällt.

Nutzen Sie Blueprint Dashboards, um jeder Feldzone eine eigene Ansicht zu geben, ohne Konfigurationen zu duplizieren.

Industrielle Umweltüberwachung

WisBlock-Knoten mit Gas- (RAK12004, RAK12009) und Feinstaubsensoren, installiert in Fertigungsbereichen. Messwerte fließen kontinuierlich zu TagoIO. Ein Analysis-Skript berechnet gleitende Durchschnitte und schreibt die berechneten Werte zurück in den Geräte-bucket. Alarme werden ausgelöst, wenn Konzentrationsgrenzwerte überschritten werden.

Analysis-Dokumentation: docs.tago.io/docs/tagoio/analysis

Kühlkette und verderbliche Waren

WisBlock-Knoten in Kühlfahrzeugen oder Lagerräumen. Ein GPS-Modul (RAK1910) wird zur Standortverfolgung ergänzt. TagoIO empfängt Temperatur-, Luftfeuchtigkeits- und GPS-Daten. Ein Map-Widget zeigt die Fahrzeugpositionen; ein Alarm wird ausgelöst, wenn die Temperatur während des Transports über das sichere Band steigt.

Mehr daraus machen mit KI

Der MCP-Server von TagoIO verbindet KI-Assistenten wie Claude direkt mit Ihren Sensordaten. Sobald Ihre RAK-Geräte an TagoIO senden, können Sie Fragen in natürlicher Sprache stellen: “Welche Zone hatte letzte Woche die höchste Luftfeuchtigkeit?” oder “Zeig mir alle Geräte, die in den letzten 24 Stunden offline gegangen sind.”

Details: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Zusammenfassung

Das Verbinden von RAK Wireless Geräten mit TagoIO braucht drei Komponenten: einen LoRaWAN Network Server (TTN oder ChirpStack), ein TagoIO-Gerät mit dem passenden Payload Parser und eine webhook-Integration zwischen beiden. RAK übernimmt die Hardware- und Funkschicht; TagoIO übernimmt alles von den Rohdaten bis zu Dashboards und Alarmen.

Beginnen Sie mit einem Gateway und einem WisBlock-Knoten. Prüfen Sie die Daten im Live Inspector, schreiben Sie den Payload Parser und bauen Sie von dort aus das Dashboard.

Verwandte Beiträge

Elsys LoRaWAN-Sensoren mit TagoIO verbinden

Elsys LoRaWAN-Sensoren mit TagoIO verbinden

Jun 3, 2026

Kerlink LoRaWAN Gateways mit TagoIO verbinden

Kerlink LoRaWAN Gateways mit TagoIO verbinden

Jun 2, 2026

Tektelic LoRaWAN Sensoren mit TagoIO verbinden

Tektelic LoRaWAN Sensoren mit TagoIO verbinden

Jun 2, 2026