V2.3-Projekt öffnen

Ein CoDeSys V2.3-Projekt kann nur in ein CODESYS V3-Projekt konvertiert werden, wenn in CODESYS V3 das Package CODESYS V2.3 Converter installiert ist. Das Package ist im CODESYS Store erhältlich.

Voraussetzung: CODESYS ist gestartet, es kann auch bereits ein Projekt geöffnet sein. Ihnen sollten die unterhalb der folgenden Anleitung beschriebenen Einschränkungen bewusst sein.

Wählen Sie Befehl „Datei Projekt öffnen“.
Wählen Sie im Dialog „Projekt öffnen“ das gewünschte CoDeSys V2.3-Projekt oder Projektarchiv aus dem Dateisystem. Zur Suche können Sie den Dateifilter in der rechten unteren Ecke des Dialogs setzen.

Falls noch ein anderes Projekt geöffnet ist, leitet CODESYS Sie entsprechend zum Schließen an. Danach startet automatisch der CoDeSys V2.3-Konverter.
Der V2.3-Konverter prüft, ob das Projekt fehlerfrei kompilierbar ist. Wenn ja, bearbeitet er das Projekt automatisch.
HINWEIS: Wenn das Projekt Visualisierungsobjekte mit Platzhaltervariablen enthält, die der Konverter nicht auflösen kann, erfolgt ein direktes Einbinden der jeweiligen Visualisierungen als Gruppierung an Stelle der Visualisierungsreferenzen.
Gerätekonvertierung: Wenn im zu öffnenden Projekt ein Gerät (Zielsystem) referenziert ist, für das noch keine Konvertierungsregel definiert ist, erscheint der Dialog „Gerätekonvertierung“. Legen Sie hier fest, ob und wie der Konverter die bisherige Geräte-Referenz durch eine aktuelle ersetzen soll.

Bei Ersetzung fügt der Konverter das neue Gerät anstelle des alten im Gerätebaum des konvertierten Projekts ein.
Bibliothekskonvertierung: Wenn im zu öffnenden Projekt eine Bibliothek referenziert ist, für die noch keine Konvertierungsregel definiert ist, erscheint der Dialog „Konvertierung einer Bibliotheksreferenz“. Legen Sie hier fest, ob und wie der Konverter die bisherige Bibliotheksreferenz durch eine aktuelle ersetzen soll. Falls Sie dabei eine Bibliothek auswählen, für die Projektinformationen fehlen, erscheint der Dialog „Projektinformationen eingeben“, den Sie ausfüllen müssen.

Der Konverter lädt das angepasste Projekt. Hinweis: Die neu definierten Bibliotheksreferenzen finden sich im globalen Bibliotheksverwalter in der POUs-Ansicht.

Einschränkungen beim Weiterverwenden eines CoDeSys V2.3-Projekts in CODESYS

Kompilierung:	Das Projekt muss ohne Übersetzungsfehler in CoDeSys V2.3 kompilierbar sein. Hinweis: Dennoch gibt CODESYS bei der Übersetzung in V3 Warnungen aus. Diese werden durch implizite Konvertierungen hervorgerufen, die zu Informationsverlust führen können (beispielsweise durch Vorzeichenwechsel). CODESYS V3 prüft „case“-Anweisungen gegen die Switch-Variable: `‎CASE USINT OF INT‎` wird in CoDeSys V2.3 nicht überprüft, es gibt jedoch eine Fehlermeldung beim Import in V3.
Steuerungskonfiguration:	Die „Steuerungskonfiguration“ eines CoDeSys V2.3-Projekts ist nicht in V3 importierbar. Sie müssen die Gerätekonfiguration neu erstellen und die in der Steuerungskonfiguration verwendeten Variablen erneut deklarieren.
Netzwerkvariablen:	Für Netzwerkvariablen erzeugt CODESYS V3 GVL-Objekte und importiert die Variablendeklarationen. Die Netzwerkeigenschaften werden jedoch nicht importiert! Sehen Sie hierzu die Beschreibung zum Netzwerkvariablen-Austausch.
Bibliotheken:	Alle Variablen und Konstanten, die in einer Bibliothek verwendet werden, müssen auch in dieser Bibliothek deklariert sein. Die Bibliothek muss in CoDeSys V2.3 fehlerfrei übersetzbar sein.
Syntaktische und semantische Einschränkungen seit CoDeSys V2.3:	`‎FUNCTIONBLOCK‎` ist nicht länger ein gültiges Schlüsselwort anstelle von `‎FUNCTION_BLOCK‎` Nach `‎TYPE‎` (Deklaration einer Struktur) muss ein “:” folgen. `‎ARRAY‎`-Initialisierung muss mit runden Klammern versehen sein. `‎INI‎` wird nicht mehr unterstützt (Sie müssen dies im Code durch die Init-Methode ersetzen). In Funktionsaufrufen ist es nicht länger möglich, explizite Parameterzuweisungen mit impliziten zu mischen. Deshalb kann die Reihenfolge der Parametereingangs-Zuweisungen verändert werden: `‎fun(formal1 := actual1, actual2); // -> Fehlermeldung ‎` `‎fun(formal2 := actual2, formal1 := actual1); // gleiche Semantik wie folgende Zeile: ‎` `‎fun(formal1 := actual1, formal2 := actual2); ‎` CoDeSys V2.3-Pragmas werden nicht konvertiert. Sie erzeugen in V3 eine Warnung. Der `‎TRUNC‎`-Operator konvertiert nun in den Datentyp `‎DINT‎`, anstelle von `‎INT‎`; bei einem CoDeSys V2.3-Import fügt CODESYS automatisch eine entsprechende Typkonvertierung hinzu.
Visualisierung:
Platzhalter und deren Ersetzung	Platzhalter	VAR_INPUT	Verwendung	Ersetzung
	`‎PLC_PRG.$LocalVar$.aArr[0] ‎`	`‎localVar: MyStruct; ‎`	`‎localVar.aArr[0] ‎`	`‎localVar := PLC_PRG.myStructVar ‎`
	`‎$Var$.aArr[0] ‎`	`‎Var : MyStruct; ‎`	`‎Var.aArr[0] ‎`	`‎Var := PLC_PRG.myStructVar ‎`
	`‎PLC_PRG.myStructVar.aArr[$Index$] ‎`	`‎Index : INT; ‎`	`‎PLC_PRG.myStructVar.aArr[Index] ‎`	`‎Index := 0 ‎`
Problematische Platzhalter	Platzhalter innerhalb eines Textes: Text: `‎$axle$-Axis ‎` Behebung: `‎localVar : STRING; ‎` Text: `‎%s-Axis‎` TextVariable:`‎ localVar ‎` Platzhalter beschreibt nur einen Teil eines Variablennamens: `‎axis$axis$spur$spur$.fActPosition‎` Behebung: Definieren Sie für den Platzhalter `‎axis$axis$spur$spur$‎` nur einen Platzhalter. `‎axis_spur : MyFunctionBlock;‎` Übergeben Sie dann direkt die entsprechende Instanz des Funktionsbausteins. `‎axis_spur := PLC_PRG.axis1spur2;‎` Platzhalter wird durch einen Ausdruck ersetzt: `‎$Expression$ -> PLC_PRG.var1 + PLC_PRG.var2‎` Behebung: Sie müssen den Ausdruck an eine Hilfsvariable übergeben und diese Hilfsvariable dann als Instanz übergeben. Platzhalter beschreibt einen Programmnamen: $Program$.bToggle -> PLC_PRG.bToggle D Diese Form der Platzhalterersetzung kann der Konverter nicht in V3 übertragen. Sie werden sie in der Praxis aber selten verwenden. Platzhalter wird durch verschiedene Typen ersetzt: `‎$Var$‎` -> Ersetzung 1 : `‎PLC_PRG.n‎` (INT) -> Ersetzung 2 : `‎PLC_PRG.st‎` (STRING) Behebung: Definieren Sie hierfür zwei verschiedene Platzhalter in der Schnittstelle. Die Visualisierung liegt in einer Bibliothek. Sie ersetzen die Platzhalter erst später aus einem beliebigen Projekt, wenn Sie die Visualisierung dort verwenden. Behebung: Hier müssen Sie die `‎TYPE_NONE‎`-Datentypen manuell ersetzen. Es gibt aber auch die Möglichkeit, dass Sie die Bibliothek in ein Projekt einbinden und der Platzhalter richtig ersetzt wird. Wenn Sie nun dieses Projekt importieren, dann wird der Datentyp auch in der Bibliothek richtig ermittelt.
Nicht importierbare Elemente:	Trend, ActiveX - Der Import ist nicht möglich, weil die Implementierung sehr unterschiedlich ist. In V3 wird eine entsprechende Warnung ausgegeben und ein entsprechender manueller Nachbau ist nötig.
Programmiersprachen	ST, AWL, FUP:	Keine Einschränkungen
	KOP:	CODESYS importiert Funktionsbausteine mit Parallelverzweigungen so, dass der Teil vor der Verzweigung für jeden Zweig wiederholt wird. Das entspricht dem generierten Code, den CoDeSys V2.3 für Parallelverzweigungen erzeugt.
	AS:	Explizit vom Anwender deklarierte Schrittvariablen müssen lokal im AS-Editor deklariert werden. Sie dürfen sie nicht als VAR_INPUT, VAR_OUTPUT oder VAR_INOUT deklarieren, da CODESYS die Aufrufe nicht automatisch angepassen kann. Erklärung: Schritte verwenden zur Verwaltung der internen Zustände in V3 keine booleschen Variablen mehr, sondern auch Strukturen vom Typ `‎SFCStepType‎`. Kennzeichner: Nicht mit einem Unterstrich beginnen dürfen folgende Kennzeichner: Namen von IEC-Aktionen im Baum Variablen, die in einer IEC-Assoziationsliste aufgerufen werden Namen von ausprogrammierten Transitionen Erklärung: In V3 erhalten die impliziten Variablen, welche CODESYS für Aktionen anlegt, einen Unterstrich als Präfix. Es würde ein ungültiger Kennzeichner mit doppeltem Unterstrich entstehen.
	CFC:	Große Bausteine: Das Layout großer Bausteine kann durch den Import an Qualität verlieren; Die Baustein-Boxen überlappen sich möglicherweise stark. (Behebung geplant.) Makros: Makros können nicht importiert werden. (Behebung geplant.)

Siehe auch