Ihr erstes vernetztes Gerät in Cepaos – Schritt für Schritt

Bevor Sie beginnen

• Tarif: IoT-Telemetrie ist ab dem Domäne-Plan enthalten (und in allen höheren Tarifen). Enthält Ihr Tarif sie nicht, zeigt Ihnen Cepaos beim Öffnen von IoT & Automatisierung, welcher Tarif sie enthält und was er in Ihrem Markt kostet.
• Berechtigungen: Geräte und Gateways verbinden können nur Nutzer mit der Rolle Inhaber oder Admin.
• Was Sie verbinden: Kann Ihr Gerät (oder die Cloud des Herstellers) selbst Daten über das Internet senden, folgen Sie Weg A. Handelt es sich um eine SPS oder eine Industriemaschine ohne eigene Verbindung, folgen Sie Weg B. Unsicher, ob Gerät oder Sensor? Lesen Sie den Artikel „Gerät oder Sensor?“ in diesem Hilfe-Center.

Weg A – das Gerät sendet bereits Daten über das Internet

1. Öffnen Sie IoT & Automatisierung → Geräte → Vernetzte Geräte und klicken Sie auf + Gerät verbinden.
2. Wählen Sie den Gerätetyp (Presse, Pumpe, Abfüllanlage, Wetterstation …) und, falls angeboten, das Profil Ihres Modells.
3. Geben Sie einen Namen ein, unter dem Ihr Team das Gerät kennt. Hersteller, Standort und Maschinen-ID sind optional; mit dem Hersteller schlägt Cepaos Installationsschritte vor.
4. Nach dem Anlegen zeigt Cepaos den API-Schlüssel nur ein einziges Mal an. Unter „Für Ihren Techniker“ finden Sie die Adresse, an die das Gerät die Daten senden muss, eine Beispielnachricht für diesen Gerätetyp, einen Schnelltest mit curl, eine herunterladbare Konfigurationsdatei und einen QR-Code. Bewahren Sie den Schlüssel sicher auf: Geht er verloren, kann er nicht erneut angezeigt werden; Sie können ihn nur rotieren (es wird ein neuer erzeugt, der alte funktioniert nicht mehr).
5. Ihr Techniker richtet das Gerät so ein, dass jeder Messwert per POST an diese Adresse geht, mit dem Header Authorization: Bearer gefolgt vom Schlüssel und einem JSON mit mindestens eventType (bei Bedarf zusätzlich value und unit).
6. Öffnen Sie die Geräteseite. Solange nichts ankommt, sehen Sie einen Warteraum, der sich alle 10 Sekunden selbst aktualisiert; sobald der erste Messwert eintrifft, wird er mit Uhrzeit und Inhalt angezeigt, damit Sie prüfen können, ob das Format stimmt.

Weg B – Geräte ohne eigene Verbindung: Cepaos Gateway

Das Gateway ist ein Raspberry Pi oder Mini-PC im Weingut, der Industrieprotokolle in Daten übersetzt, die Cepaos versteht.

1. Bereiten Sie das Gerät vor: ab Raspberry Pi 3 (empfohlen: Pi 4 mit mindestens 2 GB) oder ein Mini-PC, mit Raspberry Pi OS Lite 64-Bit oder Ubuntu Server 22.04 oder neuer, per Kabel mit dem Netzwerk des Weinguts verbunden und mit Internetzugang.
2. Öffnen Sie IoT & Automatisierung → Geräte → Gateway und klicken Sie auf Gateway verbinden. Geben Sie einen Namen und optional den Standort ein.
3. Cepaos erzeugt einen Installationsbefehl mit einem Token, das nur ein einziges Mal angezeigt wird, 24 Stunden gültig ist und bei der ersten Verbindung verbraucht wird. Fügen Sie ihn im Terminal des Pi ein (per SSH oder mit Tastatur und Bildschirm). Das Skript installiert den Agenten als Dienst und startet ihn; das dauert etwa 2 Minuten.
4. Auf der Gateway-Seite wechselt der Status auf „Online“, sobald sich der Agent verbindet. Erscheint nach 5 Minuten nichts, prüfen Sie die Protokolle auf dem Pi mit journalctl -u cepaos-gateway -f.
5. Das Gateway durchsucht das Netzwerk und listet die Funde unter „Erkannte Geräte“ auf (alle 5 Minuten erneut). Klicken Sie auf Übernehmen, vergeben Sie einen Namen – fertig ist das vernetzte Gerät.

Protokolle: Modbus TCP und MQTT wurden bereits mit echter Hardware validiert. Modbus RTU, OPC-UA und Siemens S7 sind implementiert, aber noch nicht mit echter Hardware validiert: Sprechen Sie uns an, bevor Sie sich im Produktivbetrieb darauf verlassen.

Wenn Daten eintreffen

• Übersicht (IoT & Automatisierung → Geräte → Übersicht): der Status aller Ihrer Geräte auf einen Blick.
• Geräteseite: Messwerte, Verlauf und Live-Ansicht.
• Warnungen: Die Glocke oben rechts auf den IoT-Seiten öffnet das Warnungs-Center (fehlgeschlagene Befehle, vom Gerät gemeldete Fehler, Laboranalysen außerhalb des Bereichs, nicht abgeglichene Abfüllungen). Sie können Warnungen als gelesen markieren oder erledigen.
• E-Mail: Aktivieren Sie „Kritische IoT-Warnungen per E-Mail“ in Ihren Benachrichtigungseinstellungen (Einstellungen). E-Mails gehen nur bei neuen kritischen Warnungen raus; wiederholte werden gebündelt.

Optional: Fernsteuerung (Vernetzter Keller)

Für den Datenempfang brauchen Sie nichts weiter. Um einer Maschine Befehle zu senden (pausieren, fortsetzen, einen Zyklus starten – je nachdem, was sie unterstützt), benötigen Sie das Add-on Vernetzter Keller. Sie finden es unter Einstellungen → Module mit Preis und Schaltfläche zum Buchen (in manchen Tarifen ist es per Vertrag mit unserem Vertrieb enthalten).

• Beim ersten Befehl mit mittlerem oder hohem Risiko an eine Maschine bittet Cepaos Sie, die Nutzungsvereinbarung für diese Maschine zu akzeptieren.
• Befehle mit hohem Risiko werden erst ausgeführt, wenn ein zweiter Administrator sie freigibt (oder – wenn die Maschine ihre QR-Gerätekarte hat – die physische Anwesenheit per Scan bestätigt wird). Offene Befehle finden Sie unter IoT & Automatisierung → Geräte → Fernsteuerung.

Wenn etwas nicht funktioniert

• Das Gerät zeigt kein Signal: Prüfen Sie Strom und Netzwerk. Hängt es an einem Gateway, prüfen Sie zuerst das Gateway.
• Das Gerät erhält Fehler 401: Der Schlüssel ist falsch, wurde rotiert oder das Gerät wurde archiviert.
• Fehler 422 oder 400: Das JSON hat nicht das erwartete Format (eventType fehlt oder ungültiges JSON). Vergleichen Sie es mit der Beispielnachricht unter „Für Ihren Techniker“.
• Fehler 413: Die Nachricht ist größer als 8 KB; senden Sie kleinere Messwerte.