Diese Anleitung bietet umfassende Informationen zur Verbindung eines RevPi mit der Cumulocity IoT-Plattform mithilfe von Thin-edge.io. Sie umfasst Installation, Konfiguration und Datenübertragung.

RevPi einrichten #

Verkabelung und Stromanschluss #

Verwende entweder ein 24V-DC-DIN-Schienen-Netzteil oder ein 24V-DC-Steckernetzteil für den Desktop-Einsatz, um den RevPi mit Strom zu versorgen. Ein typisches Netzteil sollte mindestens 30 W Leistung haben. Nutze einen Barrel-Jack-Pigtail-Stecker mit offenen Kabelenden, um ihn mit dem RevPi zu verbinden.

Netzwerkverbindung herstellen #

▷ Schließe die Spannungsversorgung an den RevPi an.

▷ Verbinde den RevPi per Ethernet-Kabel mit dem Netzwerk.

▷ Greife über einen Webbrowser auf das Gerät zu, indem du zu http://revpi1234.local navigierst, wobei 1234 die Seriennummer auf der Vorderseite des RevPi ist.

SSH-Zugriff einrichten #

Für macOS-Nutzer

▷ Öffne die Terminal-Anwendung (Programme › Dienstprogramme › Terminal).

▷ Gib den folgenden Befehl ein und drücke Enter, wobei <SERIAL-NUMBER> durch die tatsächliche Seriennummer des RevPi zu ersetzen ist:

ssh pi@revpi<SERIAL-NUMBER>.local

▷ Gib das Passwort ein, das sich auf dem Aufkleber auf der rechten Seite deines Geräts befindet.

Für Windows 7/10/11-Nutzer

✓ Windows-Nutzer benötigen einen SSH-Client.

  • Für Windows 10/11:

▷ Öffne die Eingabeaufforderung oder PowerShell.

▷ Gib den folgenden Befehl ein und drücke Enter:

ssh pi@revpi<SERIAL-NUMBER>.local

  • Für Windows 7:

▷ Lade PuTTY herunter und installiere es.

▷ Gib revpi<SERIAL-NUMBER>.local in das Feld Host Name ein.

▷ Wähle den Verbindungstyp SSH und wähle Open.

In beiden Fällen ersetze <SERIAL-NUMBER> durch die Seriennummer deines Geräts.

▷ Gib das Passwort ein, das sich auf dem Aufkleber auf der rechten Seite deines Geräts befindet.

System aktualisieren #

▷ Sobald du dich über SSH angemeldet hast, aktualisiere und upgrade dein System:

sudo apt update && sudo apt full-upgrade

Zusätzliche Pakete installieren #

▷ Installiere die erforderlichen Pakete für No-Code-OPC-UA- und MQTT-Unterstützung:

sudo apt install mqtt-revpi-client opcua-revpi-server

Cumulocity-Client installieren und konfigurieren #

Thin-edge.io-Client herunterladen und installieren #

curl -fsSL https://thin-edge.io/install.sh | sh -s

Thin-edge.io konfigurieren #

▷ Konfiguriere die Cumulocity-IoT-Tenant-URL:

sudo tedge config set c8y.url your-tenant.cumulocity.com

Ersetze your-tenant.cumulocity.com durch den tatsächlichen Tenant-Link ohne https.

Zertifikate erstellen und hochladen #

▷ Erstelle ein Zertifikat für jedes Gerät und lade es hoch:

sudo tedge cert create --device-id revpi<SERIAL-NUMBER>

Ersetze <SERIAL-NUMBER> durch die Seriennummer deines Geräts.

sudo tedge cert upload c8y --user "your_username@example.com"

Thin-edge.io-Client starten #

▷ Starte den Thin-edge-Client, um eine Verbindung zu Cumulocity herzustellen:

sudo tedge connect c8y

Testen: Messwerte senden #

▷ Sende einen Test-Messwert an Cumulocity:

tedge mqtt pub 'c8y/s/us' '211,100'

Datenempfang verifizieren #

▷ Melde dich in deinem Cumulocity-Konto an.

▷ Gehe zum Abschnitt Gerätemanagement.

▷ Zeige die Registerkarte Messwerte für dein Gerät an.

RevPi neu starten #

sudo reboot

I/O-Daten des RevPi an den Thin-edge-Connector senden #

Auf die Admin-Oberfläche des RevPi zugreifen #

▷ Navigiere zur Weboberfläche des RevPi:

http://revpi<serial>.local

I/O-Module und Feldbus-Daten am RevPi mit PiCtory konfigurieren #

▷ Melde dich in der Admin-Weboberfläche an.

▷ Starte den grafischen Editor PiCtory.

▷ Ziehe und platziere analoge und digitale I/O-Module wie RevPi AIO und RevPi DIO.

▷ Konfiguriere deren Einstellungen.

▷ Stelle sicher, dass das Kontrollkästchen Export aktiviert ist, wenn die Daten an Cumulocity gesendet werden sollen.

Verbundene Werte an den Thin-edge-Client übertragen #

Option 1: No-Code mit PiCtory #

▷ Ziehe das virtuelle Gerät MQTT neben dein RevPi Basismodul in PiCtory.

▷ Stelle den Server auf localhost ein.

▷ Speichere die Konfigurationen und starte den Treiber neu.

Option 2: Node-RED #

▷ Verwende Node-RED, um Werte an den MQTT-Broker von Thin-edge zu senden.

▷ Konfiguriere einen MQTT-Knoten auf localhost und sende Werte als JSON.

Option 3: CODESYS #

▷ Installiere und nutze CODESYS, um Messwerte mit dessen MQTT-Client zu programmieren und zu senden.

Option 4: Python #

▷ Verwende die RevPiModIO2-Bibliothek, um mit den Ein- und Ausgängen des RevPi zu arbeiten und Daten an den Thin-edge-MQTT-Broker zu senden.

Cumulocity-Gerätemanagementfunktionen aktivieren #

Der RevPi unterstützt verschiedene Cumulocity-Funktionen, darunter:

  • Messwerte

  • Warnungen / Alarme

  • Konfigurationsmanagement

  • Software-Management

  • Fernzugriff via SSH / VNC

Weitere Informationen findest du in der Cumulocity-Dokumentation.