Zum Hauptinhalt springen

RevPi über Thin-edge.io mit Cumulocity verbinden

Einführung​

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

Einrichtung Deines Revolution Pi​

Verkabelung & Stromanschluss​

Verwende entweder ein 24V-DC-DIN-Schienen-Netzteil oder ein 24V-DC-Steckernetzteil für den Desktop-Einsatz, um den Revolution Pi 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 Revolution Pi 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 Revolution Pi 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 Revolution Pi​

sudo reboot

Senden von IO-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 IOs und Feldbus-Daten am Revolution Pi mit Pictory​

  1. Melde Dich in der Admin-Weboberfläche an.
  2. Starte den grafischen Editor Pictory.
  3. Ziehe und platziere Geräte wie Analog-IO (AIO) und Digital-IO (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" in Dein Revolution Pi-Diagramm in Pictory.
  2. Stelle den Server auf localhost ein.
  3. Speichere die Konfigurationen und starte den Treiber neu.

Option 2: NodeRed​

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 IOs des Revolution Pi zu arbeiten und Daten an den Thin-edge-MQTT-Broker zu senden.

Aktivierung der Cumulocity-Gerätemanagementfunktionen​

Der Revolution Pi unterstützt verschiedene Cumulocity-Funktionen, darunter:

  • Messwerte
  • Warnungen / Alarme
  • Konfigurationsmanagement
  • Software-Management
  • Fernzugriff via SSH / VNC

Weitere Informationen findest Du in der Cumulocity-Dokumentation.