CODESYS ist eine Entwicklungsumgebung nach IEC 61131-3 für die Programmierung industrieller Automatisierungssysteme. Anwender können damit Automatisierungsprojekte erstellen, Hardware konfigurieren und Steuerungsanwendungen mit verschiedenen Programmiersprachen wie Kontaktplan, strukturiertem Text und Funktionsblockdiagrammen entwickeln.

Die Revolution Pi Library für CODESYS ermöglicht die Integration von RevPi Geräten in CODESYS. Der RevPi ist damit ein modularer und leistungsfähiger Mikrocontroller für Automatisierungsaufgaben. Er kann als Soft-SPS in Netzwerken eingesetzt werden, die Feldbus- und Industrial-Ethernet-Protokolle verwenden. Mit CODESYS WebVisu können Visualisierungen erstellt und plattformunabhängig in gängigen Webbrowsern angezeigt werden. Eine separate HMI-Software ist nicht erforderlich.

CODESYS-Lizenzierung #

Für den dauerhaften Betrieb einer CODESYS Runtime benötigst du eine kostenpflichtige Lizenz. Ohne gültige Lizenz läuft dein CODESYS-Projekt auf dem RevPi Gerät im Demo-Modus und beendet sich nach einer Laufzeit von zwei Stunden automatisch. Der Demo-Modus kann beliebig oft genutzt werden.

Welche Lizenz du benötigst, hängt von bestimmten Parametern deines Projekts ab, z. B. Anzahl der Ein- und Ausgänge, gewünschter Feldbus, gewünschte Zusatzprodukte oder Projektgröße. Sollten sich die Projektparameter ändern, kannst du dazu passende Upgrade-Lizenzen erwerben.

Detaillierte Orientierungshilfe zur Lizenzierung, siehe Applikationsbasierte Lizenzen.

Important
Die CODESYS-Lizenz kann verloren gehen.

Die Lizenz kann z. B. nach dem Aufspielen eines neuen Image oder im Fall eines beschädigten Dateisystems verloren gehen.

▷ Sichere die Lizenz für CODESYS außerhalb deines RevPi Geräts, damit sie dir weiterhin zur Verfügung steht.

Note

Eine CODESYS-Lizenz wird mit ihrer Aktivierung an dein RevPi Gerät gebunden. Du kannst sie nur auf diesem Gerät aktivieren und deaktivieren.

System einrichten #

Software #

Note

Die CODESYS-Software ist als 32- und 64-Bit-Version verfügbar. Sie muss der Bit-Version deines Betriebssystems entsprechen. Die Bit-Version des Betriebssystems kannst du mit dem Befehl getconf LONG_BIT auf dem Terminal des RevPi Geräts abfragen.
Ab RevPi Bookworm ist nur noch eine 64-Bit-Version verfügbar.

Kompatibilität der Software #

Revolution Pi Library
für CODESYS
Image CODESYS
Development
System
CODESYS Runtime

V2.4.0.0 (10/2025)

RevPi Bookworm (64 bit)

V3.5 SP21

CODESYS Control Linux ARM 64 bit V4.16.0.0

V2.3.0.0 (09/2025)

RevPi Bookworm (64 bit)

V3.5 SP21

CODESYS Control Linux ARM 64 bit V4.16.0.0

V2.2.0.0 (06/2025)

RevPi Bookworm (64 bit)

V3.5 SP21

CODESYS Control Linux ARM 64 bit V4.16.0.0

V2.2.0.0 beta (04/2025)

RevPi Bookworm (64 bit)

V3.5 SP21

CODESYS Control Linux ARM 64 bit V4.15.0.0

V2.1.1.0 (04/2025)

RevPi Bookworm (64 bit)
RevPi Bullseye (64 bit)

V3.5 SP20

CODESYS Control Linux ARM 64 bit V4.11.0.0

V2.1.0.0 (02/2025)

RevPi Bookworm (32 und 64 bit)
RevPi Bullseye (32 und 64 bit)

V3.5 SP20

CODESYS Control Linux ARM 64/32 bit V4.11.0.0

V2.0.0.0 (06/2024)

RevPi Bullseye (32 und 64 bit)

V3.5 SP20

CODESYS Control Linux ARM 64/32 bit V4.10.0.0

V1.4.2.0 (06/2025)

RevPi Bullseye (32 und 64 bit)

V3.5 SP19

CODESYS Control Linux ARM 64/32 bit V4.10.0.0

V1.4.1.99 beta (02/2024)

RevPi Bullseye (32 und 64 bit)

V3.5 SP19

CODESYS Control Linux ARM 64/32 bit V4.10.0.0

V1.4.1.0 (12/2023)

RevPi Buster

V3.5 SP19

CODESYS Control for Raspberry Pi MC SL 4.10.0.0

V1.4.0.0 (06/2023)

RevPi Buster

V3.5 SP19

CODESYS Control for Raspberry Pi MC SL 4.8.0.0

1.3.0.0

RevPi Buster

V3.5 SP18

CODESYS Control for Raspberry Pi MC SL 4.6.0.0

1.2.1.0

RevPi Buster

V3.5 SP17

CODESYS Control for Raspberry Pi MC SL 4.4.0.0

1.2.0.0

RevPi Buster

V3.5 SP17

CODESYS Control for Raspberry Pi MC SL 4.4.0.0

1.1.0.0

RevPi Buster

V3.5 SP16

CODESYS Control for Raspberry Pi MC SL 4.0.0.0

Informationen zum Betriebssystem-Image, siehe

Software installieren #

▷ Lade das CODESYS Development System auf deinen PC herunter.

▷ Installiere das CODESYS Development System auf deinem PC.

▷ Installiere die CODESYS Runtime CODESYS Control for Linux ARM bzw. CODESYS Control for Linux ARM64 über das Tool CODESYS Installer.

▷ Lade den I/O-Treiber Revolution Pi Library für CODESYS auf deinen PC herunter.

▷ Installiere den I/O-Treiber im CODESYS Development System.

CODESYS mit dem RevPi Gerät verbinden #

✓ Das RevPi Gerät ist mit dem Netzwerk verbunden.

Mit CODESYS Deploy Tool

Ab RevPi Bookworm (10/2024) wird die Verbindung über das CODESYS Deploy Tool hergestellt.

Note

Ab RevPi Bookworm (08/2025) muss zusätzlich die Firewall des RevPi für die Verbindung mit der CODESYS Entwicklungsumgebung freigegeben werden:

▷ Füge den Service revpi-codesys zu den Firewall-Einstellungen in Cockpit hinzu, siehe Firewall.

▷ Stelle über das CODESYS Deploy Tool eine Verbindung mit dem RevPi her.
Dafür musst du die IP-Adresse ermitteln.
Die notwendigen Anmeldedaten findest du auf dem Aufkleber an der Gehäuseseite des RevPi Geräts.

Deploy Contrl S

▷ Installiere das Softwarepaket CODESYS Control for Linux ARM/64 über das CODESYS Deploy Tool auf dem RevPi Gerät.

Mit Update Linux ARM64

Bis RevPi Bullseye (04/2024) erfolgt die Verbindung über das Softwarepaket CODESYS Control for Linux.

▷ Installiere die CODESYS Runtime CODESYS Control for Linux ARM über Tools  Update Linux ARM64.
Dafür musst du die IP-Adresse ermitteln.
Die notwendigen Anmeldedaten findest du auf dem Aufkleber an der Gehäuseseite des RevPi Geräts.

Projekt mit RevPi Geräten anlegen #

RevPi Basismodul anlegen #

Wenn du Geräte zum Projekt hinzufügst, wird eine Liste der potenziellen RevPi Basismodule angezeigt.

▷ Wähle dein RevPi Basismodul aus und füge es hinzu.

Add Base Module

RevPi Erweiterungsmodul hinzufügen #

An die RevPi Basismodule der RevPi Connect und RevPi Core Serie können auf der jeweils rechten und linken Seite bestimmte RevPi Erweiterungsmodule angeschlossen werden. Siehe auch Regeln für die Geräteanordnung.

RevPi I/O-Modul hinzufügen

Entsprechend der physischen Anordnung der RevPi I/O-Module deines Systems werden diese dem Projektbaum über die Objekte piBridgeLeft und piBridgeRight hinzugefügt.

piBridgeLeft-Right

▷ Wähle das RevPi I/O-Modul aus und füge es hinzu.

Add Expansion Module
RevPi Gateway hinzufügen

RevPi Gateways werden dem Projektbaum über das Objekt PiBridgeEnd hinzugefügt.
PiBridgeEnd ist ein virtueller Abschluss der PiBridge, der das Ende der RevPi Erweiterungsmodule anzeigt.

▷ Wähle das RevPi Gateway aus und füge es hinzu.

Add Gateway
RevPi Con Modul hinzufügen

RevPi Con Module werden dem Projektbaum über das Objekt PiBridgeRight hinzugefügt.

▷ Wähle das RevPi Con Modul aus und füge es hinzu.

revpi codesy add con module
Virtual Device hinzufügen

Mit dem Virtual Device können Daten zwischen CODESYS und anderen externen Anwendungen wie z. B. Node-RED ausgetauscht werden. Dafür wird über eine virtuelle Schnittstelle der dafür vorgesehene Speicher im Prozessabbild verwendet. Das Virtual Device wird dem Projektbaum über das Objekt piBridgeVirtual hinzugefügt.

▷ Füge das Virtual Device hinzu.

revpi codesy add virtual
Note

In den über GitLab zur Verfügung gestellten Beispieldateien sind fertige Projekte bereits angelegt und Anwendungen programmiert.

Für den Einstieg in das Arbeiten mit RevPi und CODESYS empfehlen wir dir die Beispiele zur Steuerung der LEDs RevPiLED-Control.

Siehe auch CODESYS-Tutorials.

Konfiguration #

Note

CODESYS und PiCtory können für die Konfiguration nicht parallel verwendet werden. Eine bestehende Konfiguration über PiCtory wird von einer Konfiguration über CODESYS überschrieben.

Die virtuellen Geräte OPC UA Server und MQTT Client können nur über PiCtory verwendet werden.

Die Konfiguration der RevPi Geräte im CODESYS Development System erfolgt in der Gerätekonfiguration. Hier können in tabellarischen Strukturen den I/O-Kanälen Variablen zugeordnet und bestimmte Werte festgelegt werden.

▷ Wähle das RevPi Gerät im Gerätebaum.

❯ Das Gerätekonfigurationsfenster öffnet sich.

revpi codesys config aio

▷ Gib Variablen im Reiter Mapping ein.

▷ Lege Werte im Reiter Parameter fest.

Beim Laden eines Projekts auf das RevPi Gerät werden die Einstellungen automatisch gemappt.

Art und Verwendung der Parameter und konfigurierbaren Werte der RevPi Geräte, siehe:

Konfiguration Basismodule
Konfiguration I/O-Module
Konfiguration RevPi Gateway

In der Gerätekonfiguration sind für das Byte ModuleState folgende Zuordnungen definiert:

Wert Status

0x00

Physisch offline

0x01

Physisch verbunden, aber keine Kommunikation

0x02

Standby/Ready (PreOp)

0x03

Zyklischer Datenaustausch aktiv (Op)

Config Gateway

Wenn der ModuleState offline ist, zeigt CODESYS den Status No driver found für das RevPi Gateway an:

No Driver Found

Wenn sich das RevPi Gateway im PreOp- und Op-Status befindet oder physisch verbunden ist, wird dies im Gerätebaum grün angezeigt:

gateway running

CODESYS-Tutorials #

Weitere Ressourcen #