# Kerlink LoRaWAN Gateways mit TagoIO verbinden

> Vollständige Anleitung zur Anbindung von Kerlink LoRaWAN Gateways (iStation, iFemtoCell, Wirnet) an TagoIO. Behandelt das Wanesy Management Center, ChirpStack LNS-Weiterleitung, Payload-Parsing und Anwendungsfälle für Smart Cities und industrielle Umgebungen.

![Kerlink LoRaWAN Gateways mit TagoIO verbinden](https://tago.io/og/de/blog/how-to-connect-kerlink-lorawan-gateways-to-tagoio.png)

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](https://tago.io/pricing))
- 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

1. Melde dich bei [admin.tago.io](https://admin.tago.io) an.
2. Gehe zu **Devices → Add Device**.
3. Wähle **HTTPS** als Connector-Typ.
4. Benenne das Gerät (z. B. `kerlink-end-device-01`).
5. Klicke auf **Create Device** und kopiere das **Device Token** aus dem Tab General.

Geräte-Dokumentation: [docs.tago.io/docs/tagoio/devices](https://docs.tago.io/docs/tagoio/devices/)

### Schritt 2: Einen Push-Connector im Wanesy MC erstellen

1. Melde dich bei deinem Wanesy Management Center an.
2. Navigiere zu **Applications** und öffne oder erstelle eine Anwendung.
3. Gehe zu **Push connectors** und klicke auf **Add**.
4. Wähle **HTTP** als Connector-Typ.
5. Setze die URL auf:

   ```
   https://api.tago.io/data
   ```

6. Füge den HTTP-Header hinzu:

   ```
   Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
   ```

7. Stelle das Push-Format auf **JSON** (Standard).
8. 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:

```javascript
// 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](https://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

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

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

1. Gehe in deiner ChirpStack Application zu **Integrations → HTTP**.
2. Setze die **Uplink URL** auf:

   ```
   https://api.tago.io/data
   ```

3. Füge den benutzerdefinierten Header hinzu:

   ```
   Device-Token: YOUR_TAGOIO_DEVICE_TOKEN
   ```

4. 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).

```javascript
// 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](https://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](https://docs.tago.io/docs/tagoio/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](https://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](https://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](https://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](https://docs.tago.io/docs/tagoio/devices/)
- Payload Parser: [docs.tago.io/docs/tagoio/devices/payload-parser](https://docs.tago.io/docs/tagoio/devices/payload-parser/)
- Actions: [docs.tago.io/docs/tagoio/actions](https://docs.tago.io/docs/tagoio/actions/)
- Dashboards: [docs.tago.io/docs/tagoio/dashboards](https://docs.tago.io/docs/tagoio/dashboards/)
- MCP-Integration: [docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration](https://docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration)

[llms.txt](https://tago.io/llms.txt)