Seeed SenseCAP gehört zu den am weitesten verbreiteten industriellen LoRaWAN Sensoren auf dem Markt. Die S21xx Serie deckt Temperatur, Luftfeuchtigkeit, CO2, Licht, Luftdruck, Bodenfeuchte und mehr ab, alles in wetterfesten Gehäusen, die für den Außeneinsatz ausgelegt sind.
SenseCAP Sensoren werden vorkonfiguriert geliefert und treten jedem standardmäßigen LoRaWAN Netzwerk bei. Seeed betreibt zwar ein eigenes SenseCAP Portal, doch Sie können es komplett umgehen und Daten direkt über The Things Network oder jeden LoRaWAN Network Server, der HTTPS Webhooks unterstützt, an TagoIO senden.
Diese Anleitung deckt die komplette Integration ab: vom Registrieren eines SenseCAP Sensors bei TTN bis hin zu sauberen, decodierten Daten in einem TagoIO Dashboard.
Was Sie vorher brauchen
- Ein TagoIO Konto (kostenloser Tarif verfügbar)
- Einen Seeed SenseCAP Sensor (S2101, S2103, S2104, S2105, S2107 oder ein ähnliches S21xx Gerät)
- Ein LoRaWAN Gateway, das mit TTN oder Ihrem bevorzugten Network Server kompatibel ist
- Ein The Things Network (TTN) Konto unter console.cloud.thethings.network
Wie SenseCAP Sensoren kommunizieren
SenseCAP S21xx Sensoren nutzen die standardmäßige LoRaWAN Class A Kommunikation. Sie senden Uplinks in konfigurierbaren Intervallen (Standard 15 Minuten, über AT Commands oder die SenseCAP Mate App bis auf 1 Minute reduzierbar).
Jeder Uplink ist ein binärer Payload. Das Payload Format ist im Seeed SenseCAP Decoder Repository auf GitHub dokumentiert. Sie benötigen diesen Decoder, um den TagoIO Payload Parser zu schreiben.
Schritt 1: Den SenseCAP Sensor bei TTN registrieren
- Melden Sie sich bei console.cloud.thethings.network an.
- Öffnen oder erstellen Sie eine Application.
- Klicken Sie auf Register end device.
- Wählen Sie Enter end device specifics manually.
- Legen Sie den Frequency Plan für Ihre Region fest (EU868, US915 usw.).
- Setzen Sie die LoRaWAN Version auf 1.0.3 (von SenseCAP S21xx verwendet).
- Geben Sie die JoinEUI (AppEUI), DevEUI und den AppKey vom Etikett des SenseCAP Sensors oder aus der SenseCAP Mate App ein.
- Speichern Sie das Gerät.
Der Sensor tritt dem TTN Netzwerk bei seiner nächsten Übertragung bei.
Schritt 2: Ein Gerät in TagoIO anlegen
- Melden Sie sich bei admin.tago.io an.
- Klicken Sie auf Devices → Add Device.
- Suchen Sie nach The Things Network v3 und wählen Sie es aus.
- Benennen Sie das Gerät passend zu Ihrem SenseCAP Sensor.
- Kopieren Sie die Webhook URL und das Authorization Token, die TagoIO erzeugt.
Gerätedokumentation: docs.tago.io/docs/tagoio/devices
Schritt 3: TTN über Webhook mit TagoIO verbinden
- Gehen Sie in Ihrer TTN Application zu Integrations → Webhooks.
- Klicken Sie auf Add webhook → Custom webhook.
- Setzen Sie die Base URL auf die TagoIO Webhook URL.
- Fügen Sie den Header hinzu:
Authorization: <your_token>. - Aktivieren Sie die Uplink message Events.
- Speichern Sie.
Schritt 4: Den Payload Parser schreiben
SenseCAP S21xx Sensoren senden einen strukturierten binären Payload. Wenn Sie einen TTN Payload Formatter mit dem von Seeed bereitgestellten Decoder konfigurieren, decodiert TTN den Payload, bevor er an TagoIO gesendet wird. In diesem Fall kommen die decodierten Felder in payload.uplink_message.decoded_payload an.
Option A: TTNs Payload Formatter und TagoIO Parser verwenden
Konfigurieren Sie den Seeed Decoder als Payload Formatter auf Application Ebene in TTN. In TagoIO ordnet Ihr Parser dann einfach die decodierten Felder zu:
const decoded = payload.uplink_message.decoded_payload;
if (!decoded || !decoded.messages) {
payload = [];
return;
}
payload = decoded.messages.map(msg => ({
variable: msg.measurementId.toString().toLowerCase().replace(/ /g, "_"),
value: msg.measurementValue,
unit: msg.unit || ""
}));
Option B: Rohe Bytes in TagoIO decodieren
Wenn Sie das gesamte Decodieren lieber in TagoIO behalten möchten, lesen Sie den rohen base64 Payload aus payload.uplink_message.frm_payload und implementieren Sie den Parser für das binäre Seeed Format in JavaScript.
Für einen SenseCAP S2101 (Temperatur + Luftfeuchtigkeit):
const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");
// Seeed S2101 measurement payload starts at byte 3
const temperature = raw.readInt16LE(3) / 10;
const humidity = raw.readUInt16LE(5) / 10;
payload = [
{ variable: "temperature", value: temperature, unit: "C" },
{ variable: "humidity", value: humidity, unit: "%" }
];
Passen Sie die Byte Offsets je nach Sensormodell anhand der offiziellen Seeed Decoder Spezifikation an.
Payload Parser Dokumentation: docs.tago.io/docs/tagoio/devices/payload-parser
Schritt 5: Im Live Inspector prüfen
Öffnen Sie den Live Inspector Tab auf der Seite Ihres TagoIO Geräts. Warten Sie auf den nächsten Sensor Uplink (oder erzwingen Sie einen, indem Sie den Button am SenseCAP Gerät drücken). Stellen Sie sicher, dass die decodierten Variablen korrekt erscheinen, bevor Sie das Dashboard bauen.
Live Inspector Doku: docs.tago.io/docs/tagoio/devices/live-inspector
Schritt 6: Das Dashboard bauen
Erstellen Sie über Dashboards → + ein neues Dashboard. Für eine SenseCAP Umweltinstallation:
- Liniendiagramme für Temperatur, Luftfeuchtigkeit und CO2 über die Zeit
- Gauge Widgets, die aktuelle Messwerte anzeigen
- Alarm Status Karte, die zeigt, ob die Umgebung im zulässigen Bereich liegt
- Map Widget, falls Sie mehrere Sensoren über einen Standort verteilt haben
Verwenden Sie für Installationen mit mehreren Sensoren ein Blueprint Dashboard, um ein Layout auf alle Geräte anzuwenden. Jeder Sensor erhält über Device Tags seine eigene Dashboard Ansicht, ohne Duplizierung.
Dashboard Doku: docs.tago.io/docs/tagoio/dashboards
Schritt 7: Schwellenwert Alarme einrichten
Nutzen Sie Actions, um Ihr Team zu benachrichtigen, wenn Werte außerhalb des Bereichs liegen. Häufige SenseCAP Alarmmuster:
- CO2 über 1000 ppm in einem Besprechungsraum → E-Mail an die Anwesenden
- Bodenfeuchte unter 15% → SMS an das Bewässerungsteam
- Temperatur über 35°C in einem Gewächshaus → Kühlrelais per API Call auslösen
Actions Dokumentation: docs.tago.io/docs/tagoio/actions
Beispiele für Anwendungsfälle
Smart Agriculture
SenseCAP S2105 (Bodenfeuchte + Temperatur) und S2101 (Lufttemperatur + Luftfeuchtigkeit) Knoten, über die Anbaureihen verteilt. Messwerte alle 15 Minuten an TagoIO. Analyseskripte berechnen das Sättigungsdefizit (VPD) und schreiben es als berechnete Variable zurück. Die Bewässerung wird automatisch ausgelöst, wenn die Bedingungen für Bodenfeuchte und VPD erfüllt sind.
Umweltüberwachung in Büros und Schulen
SenseCAP S2103 (CO2, Temperatur, Luftfeuchtigkeit) in Klassenzimmern und Konferenzräumen. Ein Blueprint Dashboard gibt Gebäudemanagern eine Ansicht pro Raum. Actions senden eine Slack Benachrichtigung, wenn der CO2 Wert in einem Raum 1000 ppm überschreitet, und fordern so zum Lüften auf.
Industrielle Sensorik im Außenbereich
SenseCAP S2101 in wetterfesten Gehäusen auf einer Baustelle oder einem Logistikhof. TagoIO speichert die Messwerte und zeigt Trenddiagramme. Das Facility Team nutzt das mobil optimierte Dashboard, um die Bedingungen auf dem Handy zu prüfen.
Mit KI noch weiter gehen
Der MCP Server von TagoIO ermöglicht es KI Assistenten wie Claude, Ihre SenseCAP Daten direkt abzufragen. Stellen Sie Fragen wie “Welche Zone hatte letzte Woche den höchsten CO2 Wert?” oder “Zeige mir Temperaturanomalien über alle Sensoren in den letzten 48 Stunden”, ohne manuell eine Abfrage zu schreiben.
MCP Dokumentation: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration
Zusammenfassung
SenseCAP Sensoren verbinden sich in vier Schritten über TTN mit TagoIO: bei TTN registrieren, ein TagoIO Gerät mit dem TTN Connector anlegen, den Webhook konfigurieren und den Payload Parser schreiben. Der schwierigste Teil ist das korrekte binäre Decodieren: Der Open Source Decoder von Seeed nimmt Ihnen dabei den größten Teil der Rätselraterei ab.
Sobald die Daten fließen, übernimmt TagoIO Speicherung, Visualisierung und Alarmierung, ohne dass zusätzliche Infrastruktur nötig ist.
- TagoIO Devices: docs.tago.io/docs/tagoio/devices
- Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
- Dashboards: docs.tago.io/docs/tagoio/dashboards
- Blueprint Dashboards: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard
- Actions: docs.tago.io/docs/tagoio/actions
- TagoIO MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration


