Kerlink LoRaWAN Gateways mit TagoIO verbinden

Kerlink ist ein französischer Anbieter von LoRaWAN-Infrastruktur mit starker Präsenz in Smart-City-, Versorgungs- und Industrieprojekten. Die Geräte Wirnet iStation (industriell, für den Außenbereich), Wirnet iFemtoCell (Innenbereich) und Wirnet Station sind für ihre Verarbeitungsqualität und ihre Zuverlässigkeit auf Carrier-Niveau bekannt. Kerlink betreibt zudem das Wanesy Management Center, einen cloudbasierten LoRaWAN-Netzwerkserver.

TagoIO liegt auf der Anwendungsebene: Es empfängt Gerätedaten, speichert sie und ermöglicht den Aufbau von Dashboards, Benachrichtigungen und Automatisierungen. Kerlink mit TagoIO zu verbinden bedeutet, die Ausgabe des Kerlink-Netzwerkservers mit dem Daten-Endpunkt von TagoIO zu koppeln.

Diese Anleitung behandelt zwei Wege: die Weiterleitung vom Kerlink Wanesy Management Center an TagoIO und einen privaten ChirpStack LNS, der parallel zu den Kerlink-Gateways läuft.

Was du vorab brauchst

Ein TagoIO-Konto (kostenloser Tarif verfügbar)
Ein Kerlink-Gateway (iStation, iFemtoCell, Wirnet Station oder kompatibel)
Einen LoRaWAN-Netzwerkserver: Kerlink Wanesy Management Center oder selbst gehostetes ChirpStack
Registrierte Endgeräte auf deinem Netzwerkserver

Architektur im Überblick

Kerlink-Gateways arbeiten als Funk-Packet-Forwarder. Sie führen keine Anwendungslogik aus: diese liegt auf dem LNS. Der LNS dekodiert die LoRaWAN-Frames, identifiziert die Geräte und leitet die Anwendungs-Payloads an den von dir gewählten Endpunkt weiter.

Dein Integrationspunkt mit TagoIO ist immer der LNS, nicht das Gateway direkt.

[LoRaWAN-Sensoren] → [Kerlink gateway] → [LNS (Wanesy oder ChirpStack)] → [TagoIO via HTTPS]

Weg 1: Kerlink Wanesy Management Center → TagoIO

Wanesy MC unterstützt Push-Benachrichtigungen (auch “Push-Connectors” genannt), die Geräte-Uplinks per POST an jeden beliebigen HTTPS-Endpunkt senden.

Schritt 1: Ein Gerät in TagoIO anlegen

Melde dich bei admin.tago.io an.
Gehe zu Devices → Add Device.
Wähle HTTPS als Connector-Typ.
Benenne das Gerät (z. B. kerlink-end-device-01).
Klicke auf Create Device und kopiere das Device Token aus dem Tab General.

Geräte-Dokumentation: docs.tago.io/docs/tagoio/devices

Schritt 2: Einen Push-Connector im Wanesy MC erstellen

Melde dich bei deinem Wanesy Management Center an.
Navigiere zu Applications und öffne oder erstelle eine Anwendung.
Gehe zu Push connectors und klicke auf Add.
Wähle HTTP als Connector-Typ.
Setze die URL auf:
```
https://api.tago.io/data
```
Füge den HTTP-Header hinzu:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Stelle das Push-Format auf JSON (Standard).
Speichere und aktiviere den Connector.

Wanesy sendet nun jeden Uplink von Geräten in dieser Anwendung per POST an TagoIO.

Schritt 3: Die Wanesy-Payload in TagoIO parsen

Wanesy sendet ein JSON-Objekt mit Geräteinformationen und der base64-kodierten Payload. Füge deinem TagoIO-Gerät einen Payload Parser hinzu, um die Sensormesswerte zu extrahieren.

Öffne Devices → [dein Gerät] → Payload Parser und schreibe:

// Wanesy payload structure
const decodedBytes = Buffer.from(payload.payloadHex, "hex");

// Example for a temperature/humidity sensor with 2-byte temperature, 1-byte humidity
const temperature = decodedBytes.readInt16BE(0) / 100;
const humidity = decodedBytes.readUInt8(2);

payload = [
  { variable: "temperature", value: temperature, unit: "C" },
  { variable: "humidity", value: humidity, unit: "%" },
  { variable: "rssi", value: payload.gwInfo?.[0]?.rssi || null },
  { variable: "snr", value: payload.gwInfo?.[0]?.snr || null }
];

Passe die Dekodierungslogik an das Payload-Format deines Sensors an.

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

Weg 2: Kerlink-Gateway + ChirpStack → TagoIO

Viele Kerlink-Betreiber lassen ChirpStack parallel zu ihren Gateways laufen, entweder on-premise oder in der Cloud. Die HTTP-Integration von ChirpStack kann Daten direkt an TagoIO senden.

Schritt 1: Das Kerlink-Gateway als Packet-Forwarder konfigurieren

Die meisten Kerlink-Gateways nutzen den Semtech UDP Packet Forwarder oder den Kerlink Common Packet Forwarder. Richte das Gateway auf die Adresse und den Port deines ChirpStack-Netzwerkservers aus (Standard: UDP 1700).

Greife per SSH oder über das Kerlink WMC auf die CLI des Gateways zu, um in der global_conf.json die Adresse deines ChirpStack-Servers einzutragen.

Schritt 2: Gateway und Gerät in ChirpStack registrieren

Gehe in ChirpStack zu Gateways → Add gateway und registriere dein Kerlink-Gerät.
Erstelle ein Device Profile, das zur LoRaWAN-Version und Region deines Endgeräts passt.
Registriere deine Endgeräte unter einer Application.

Schritt 3: Eine TagoIO-HTTPS-Integration in ChirpStack hinzufügen

Gehe in deiner ChirpStack Application zu Integrations → HTTP.
Setze die Uplink URL auf:
```
https://api.tago.io/data
```
Füge den benutzerdefinierten Header hinzu:
```
Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
```
Speichern.

Schritt 4: ChirpStack-Payload in TagoIO parsen

ChirpStack sendet Uplinks als JSON. Wenn du in ChirpStack einen Codec konfigurierst, kommt das dekodierte Objekt in payload.object an. Andernfalls dekodierst du die rohen Bytes aus payload.data (base64).

// ChirpStack with codec configured
if (payload.object) {
  payload = Object.entries(payload.object).map(([key, val]) => ({
    variable: key,
    value: val
  }));
} else {
  // raw decode from base64
  const raw = Buffer.from(payload.data, "base64");
  // add your sensor-specific decoding here
  payload = [];
}

Schritt 5: Im Live Inspector prüfen

Öffne nach Abschluss eines der beiden Wege den Live Inspector deines TagoIO-Geräts und bestätige, dass die Daten beim nächsten Uplink-Zyklus ankommen.

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

Schritt 6: Dashboards und Benachrichtigungen aufbauen

Erstelle ein Dashboard über Dashboards → +. Typische Widgets für eine Kerlink-basierte Smart-City- oder Industrieanwendung:

Map-Widget für Gerätestandorte
Zeitreihen-Diagramme für Sensormesswerte im Verlauf
Karten zur Signalqualität, die RSSI und SNR pro Gateway anzeigen
Heatmap, wenn viele Knoten in einem Abdeckungsbereich melden

Richte Actions ein für:

Schwellenwert-Benachrichtigungen (Temperatur, Vibration, Überflutungserkennung)
Erkennung offline gegangener Geräte (keine Daten innerhalb von X Minuten empfangen)
Automatisiertes Reporting per E-Mail oder webhook an ein Ticketsystem

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

Beispiele für Anwendungsfälle

Versorgungsbetriebe in der Smart City

Kerlink Wirnet iStation Gateways, montiert an Laternenmasten. Sensoren überwachen den Wasserdruck, die Füllstände von Abfallbehältern und die Luftqualität an verschiedenen Knoten einer Kommune. TagoIO bündelt alle Messwerte, zeigt eine stadtweite Karte und löst Benachrichtigungen an den städtischen Betrieb aus, sobald Behälter 80 % ihrer Kapazität erreichen.

Industrielle Vibrationsüberwachung

Kerlink iFemtoCell Gateways in einer Fabrik. LoRaWAN-Vibrationssensoren an rotierenden Maschinen melden an TagoIO. Analyse-Skripte berechnen FFT-basierte Anomalie-Scores und erkennen beginnenden Lagerverschleiß, bevor es zum Ausfall kommt.

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

Energiemanagement in Gebäuden

Mehrere LoRaWAN-Energiezähler, über Kerlink-Gateways mit TagoIO verbunden. TagoIO speichert die Zählerdaten, berechnet den täglichen und monatlichen Verbrauch pro Stromkreis und erstellt Kostenberichte. Blueprint Dashboards geben den Etagenverantwortlichen ihre eigene Ansicht.

Mit KI noch weiter gehen

Der MCP-Server von TagoIO ermöglicht Abfragen deiner Kerlink-Sensordaten in natürlicher Sprache. Frag Claude: “Welche Geräte haben die schlechteste Signalqualität?” oder “Zeig mir alle Anomalien in den Vibrationsdaten der letzten Woche.”

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

Zusammenfassung

Kerlink-Gateways leiten LoRaWAN-Pakete an einen Netzwerkserver weiter. Der Netzwerkserver, ob Kerlinks eigenes Wanesy MC oder ein selbst gehostetes ChirpStack, sendet die Geräte-Payloads per HTTPS an TagoIO. Ein Payload Parser in TagoIO dekodiert die Binärdaten in saubere Variablen für Speicherung und Visualisierung.

TagoIO Devices: docs.tago.io/docs/tagoio/devices
Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
Actions: docs.tago.io/docs/tagoio/actions
Dashboards: docs.tago.io/docs/tagoio/dashboards
MCP-Integration: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration