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.

Einrichtung deines RevPi #

Verkabelung & 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.

Herstellung der Netzwerkverbindung #

Nachdem du den RevPi eingeschaltet hast, verbinde ihn per Ethernet-Kabel mit deinem 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.

Einrichtung des SSH-Zugriffs #

Für macOS-Nutzer

  1. Öffne die Terminal-Anwendung (Programme > Dienstprogramme > Terminal).

  2. Gib den folgenden Befehl ein und drücke Enter:

    ssh pi@revpi<SERIAL-NUMBER>.local

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

  3. 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:

    1. Öffne die Eingabeaufforderung oder PowerShell.

    2. Gib den folgenden Befehl ein und drücke Enter:

      ssh pi@revpi<SERIAL-NUMBER>.local

  • Für Windows 7:

    1. Lade PuTTY von https://www.putty.org/ herunter und installiere es.

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

    3. Wähle den Verbindungstyp SSH und klicke auf "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.

Systemupdates und Installation zusätzlicher Pakete #

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

sudo apt update && sudo apt upgrade && sudo apt dist-upgrade

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

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

Installation und Konfiguration des Cumulocity-Clients #

Herunterladen und Installieren des Thin-edge.io-Clients #

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

Konfiguration von Thin-edge.io #

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.

Erstellung und Hochladen von Zertifikaten #

Erstelle und lade ein Zertifikat für jedes Gerät 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"

Starten des Thin-edge.io-Clients #

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

sudo tedge connect c8y

Testen - Senden von Messwerten #

Sende einen Test-Messwert an Cumulocity:

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

Verifizierung des Datenempfangs #

Melde dich in deinem Cumulocity-Konto an und gehe zum Abschnitt "Gerätemanagement", um die Registerkarte "Messwerte" für dein Gerät anzuzeigen.

Neustart deines RevPi #

sudo reboot

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

Zugriff auf die Admin-Oberfläche des RevPi #

Navigiere zur Weboberfläche des RevPi:

http://revpi<serial>.local

Konfiguration von I/O-Modulen und Feldbus-Daten am RevPi mit PiCtory #

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

  2. Starte den grafischen Editor PiCtory.

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

  4. Konfiguriere deren Einstellungen und stelle sicher, dass das Kontrollkästchen "Export" aktiviert ist, wenn die Daten an Cumulocity gesendet werden sollen.

Übertragen von verbundenen Werten an den Thin-edge-Client #

Option 1: No-Code mit PiCtory #

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

  2. Stelle den Server auf localhost ein.

  3. Speichere die Konfigurationen und starte den Treiber neu.

Option 2: Node-RED #

Verwende NodeRed, 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.

Aktivierung der Cumulocity-Gerätemanagementfunktionen #

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.