TwinCAT XAE Version Overview
TwinCAT XAE Version Overview
TwinCAT XAE Version Overview
Content
■ General Information
■ V3.1.4024.32 (7/27/2022)
■ V3.1.4024.25 (3/28/2021)
■ V3.1.4024.22 (11/30/2021)
■ V3.1.4024.12 (2/9/2021)
■ V3.1.4024.10 (11/6/2020)
■ V3.1.4022.36 (11/30/2021)
■ V3.1.4022.32 (11/5/2020)
■ V3.1.4022.30 (3/23/2020)
■ V3.1.4022.27 (2/19/2019)
■ V3.1.4020.56 (11/5/2020)
■ V3.1.4020.28 (1/23/2018 )
■ V3.1.4016.28 (3/23/2017)
■ V3.1.4016.12 (12/16/2014)
General Information
■ Bosch Connected Industry only releases the TwinCAT XAR runtime as part of the Master Image. The TwinCAT XAE
development environment can be updated independently without release by Bosch Connected Industry. Feedback
about updates is welcome.
■ The change history listed below is not exhaustive. It is provided without liability. You can find another unofficial
changelog here: https://cookncode.com/TwinCatChangelog/tc3/
■ XAE setup: Full / Remote Manager (RM)
■ The latest full setup can usually be executed without uninstalling previous versions. If you want to uninstall previous
versions: first uninstall supplements (TFxxxx / TExxxx), then uninstall the TwinCAT versions contrary to the
installation chronology. Always follow the restart dialogs.
■ For download to the target system:
■ The XAE build number (e.g. 4022 or 4024) must be equal to the XAR build number.
■ The XAE revision (e.g. 4022.32 or 4024.12) must be equal to or higher than the XAR revision.
■ After updating a project to a new XAE revision (e.g. 4024.12 to 4024.22) a download is usually necessary.
■ The Remote Managers (RM) 4016.28 and 4020.28 may not be the last executed setup, because otherwise you
can't open newer projects. Recommended setup sequence (versions not needed can be skipped):
■ Visual Studio 2013 (necessary for TwinCAT 3.1.4016 and 3.1.4020.28 ), see description:
https://community.developer.bosch.com/t5/Knowledge-base/Setup-of-TcXaeShell/ta-p/27431
■ Full 4024 (including TcXaeShell)
■ RM 4016.28
■ Bosch patches for 4016
■ RM 4020.28
■ Bosch patches for 4020
■ RM 4020.56
■ RM 4022
■ RM 4024
■ Visual Studio / TcXaeShell
■ When installing a new TwinCAT version Bosch Connected Industry recommends to install TcXaeShell which is a
labeled Visual Studio 2017 Shell.
■ Recommended Visual Studio versions: 2015, 2017, 2019, TcXaeShell
■ Not recommended Visual Studio versions: 2010 (not supported anymore), 2013 (many crashes)
■ TwinSAFE Editor TE9000
■ The XAE setup always installs the latest version of TE9000. As TE9000 does not have any version selection like the
Remote Manager, the latest installed TE9000 will be used for all projects. When opening older projects the CRC
could change which means, login to the safety logic requires a download. To prevent this you must uninstall all
TE9000 and install the TE9000 version that has been used in your project.
V3.1.4024.32 (7/27/2022)
Bugfixes
■ 'Find All' works correctly now in Visual Studio 2019. It is now possible to jump directly to the source code from the
search results.
■ The Automation Interface which is used by the Nexeed Control plus Code Checker does not throw an exception
anymore if there is a FUNCTION without return value.
■ The TwinCAT Project Compare tool does not crash anymore when comparing SFC POUs like in the Nexeed Control
plus example project 'Digital Machine'.
■ If there are two PLC projects (port 851 and 852): If the first PLC halted at a breakpoint and was changed with online
change, the second PLC did not start anymore.
Remarks
V3.1.4024.25 (3/28/2021)
Bugfixes
■ Improvements of online change problems.
■ Solves a specific crash of Visual Studio / TcXaeShell that occurred with 4024.12 and 4024.22.
V3.1.4024.22 (11/30/2021)
Bugfixes
■ Network variables work again. With XAE 3.1.4024.12 network variables do not work.
■ Better support for local runtime on a laptop/development computer.
Remarks
■ The XAE revisions 4024.15, 4024.17 and 4024.20 should not be used due to known problems.
V3.1.4024.12 (2/9/2021)
New Features
■ Includes TcXaeShell (Visual Studio 2017 Shell) setup.
■ Supports Visual Studio 2019 (but not recommended because search results in SFC actions do not work correctly).
Visual Studio 2010 is not supported anymore.
■ SFC steps may have integrated actions (new property Duplicate on copy) that are renamed automatically together with
the step (works already with 3.1.4022 but without automatic renaming). This makes the renaming and copy and paste
of steps much easier.
■ Save all online states (Core Dump) in case of a PageFault or at stop on breakpoint. The Core Dump can be opened
later offline. Properties (ExecState, UnitState, etc.) are not yet supported, only variables.
■ First TwinCAT version with multiuser ability. Before login every programmer must merge his/her software version with
the one on the target system. Beckhoff installs the Git source code management system both on the development and
target system.
■ Several TwinSAFE improvements (global variables, multiple usage of variables, auto-complete for variable names,
creating own FBs, etc.)
■ Build time as long as with TwinCAT 3.1.4020 and ca. three times faster than TwinCAT 3.1.4022
■ Enumerations support TO_STRING() with the pragma {attribute 'to_string'}
■ FBs have the new property AdditionalMemory to do an OnlineChange without memory re-allocation after creating new
variables
■ (Un)comment several lines with CTRL+K, then CTRL+U or +C (recommendation: change shortcut to ALT+U/C)
■ 'Go to definition' in
■ With 'Go to definition' it is now possible to jump from the process image to the source code
■ In comparison to versions 4020 and 4022 the automatic build when clicking the login button works correctly and does
not require a download or online change. With TwinCAT 4020 and 4022 it was necessary to manually build a project
first after opening it to prevent a download or online change in some cases.
Remarks
■ REFERENCE to PLC inputs (%I*) is not possible anymore. If a peripheral (e.g. Kuka KRC4 and Stäubli CS9) use it,
you must switch the compiler version to a previous version in the PLC project properties in TwinCAT as long as no
peripheral update is available.
■ The setup includes the TwinSAFE Editor (TE9000) 1.3.0. If you open any existing TwinSAFE 1.0.0 project the CRC
could change and then only login with download is possible on the TwinSAFE target system. The TwinSAFE Editor
TE9000 currently does not have any remote manager function for version selection.
■ The XAE revisions 4024.10 and 4024.11 should not be used due to known problems.
V3.1.4024.10 (11/6/2020)
Remarks
■ This version should not be used anymore.
V3.1.4022.36 (11/30/2021)
Bugfixes
■ Solved problems with the TwinCAT Project Compare tool.
V3.1.4022.32 (11/5/2020)
New Features
■ When using Integrated Robotics with Stäubli robots the uniVALplc Client Library will be installed correctly with OES
and Control plus Studio. This is important in case of a new development/service computer.
Remarks
■ In the RM setup of this version the file TcXaeVsx.15.0.dll is missing. Therefore no TwinSAFE project can be opened
(the TwinSAFE are is empty). Manually install this file into the Windows GAC.
V3.1.4022.30 (3/23/2020)
Bugfixes
■ Project compare tool works again.
V3.1.4022.27 (2/19/2019)
New Features
■ Multi dongle support.
■ Zoom function in Structured Text (ST) editor.
■ Supports 'region' to collapse code segments.
Remarks
■ The Beckhoff project compare tool of this version does not work.
■ TwinCAT 3.1.4022 handles I/O variables (%I *,%Q *) differently from all previous versions. If an I/O variable has the
attributes {attribute 'hide'} or {attribute 'hide_all_locals'} (directly or indirectly), this variable is no longer included in the
I/O image of the task and therefore cannot be linked any more.
V3.1.4020.56 (11/5/2020)
Bugfixes
■ Solves many crashes that occurred with XAE 3.1.4020.28
Remarks
■ Update recommended for projects with XAE 4020.28. After update a download is necessary. An online change is
usually not possible.
V3.1.4020.28 (1/23/2018 )
New Features
■ Supports Windows 10
■ Installs Visual Studio Shell 2013
■ Supports Visual Studio 2015
■ Supports the Beckhoff license terminal EL6070
■ Refactoring for easy renaming of variables in the whole project
■ View any memory areas in an online view
■ Graphical editor for network variables
■ Improved cross reference list view
■ Static code analysis can be activated in the PLC project properties (e.g. search unused variables)
■ VAR_INST declares variables in methods that don't lose their values
■ For object developers: The Add Method dialog shows methods that are available in the interface/base FB
■ For object developers: compiler version can be set in PLC project properties (must be set to 3.1.4016.0)
■ For object developers: standard placeholder name must be set für library
Remarks
■ Do not forget to apply the patches (DLL updates via batch file). Otherwise library parameters could be lost and login is
only possible with download or online change.
■ The RM setup may not be the last setup that has been executed on the development system. After running the RM
4020.28 setup run any newer setup as well (at least build 4022).
V3.1.4016.28 (3/23/2017)
Remarks
■ This is the only version that has a Remote Manager setup to access runtime XAR 4016.x.
■ Do not forget to apply the patches (DLL updates via batch file).
■ The RM setup may not be the last setup that has been executed on the development system. After running the RM
4016 setup run any newer setup as well (at least build 4022).
V3.1.4016.12 (12/16/2014)
Bugfixes
■ Several important improvements compared with build 4014.
Remarks
■ This version should not be used anymore. It does not support installation parallely to other TwinCAT versions.
Deutsch 🠦 English
Inhalt
■ Allgemeine Hinweise
■ V3.1.4024.32 (27.07.2022)
■ V3.1.4024.25 (28.03.2021)
■ V3.1.4024.22 (30.11.2021)
■ V3.1.4024.12 (09.02.2021)
■ V3.1.4024.10 (06.11.2020)
■ V3.1.4022.36 (30.11.2021)
■ V3.1.4022.32 (05.11.2020)
■ V3.1.4022.30 (23.03.2020)
■ V3.1.4022.27 (19.02.2019)
■ V3.1.4020.56 (05.11.2020)
■ V3.1.4020.28 (23.01.2018 )
■ V3.1.4016.28 (23.03.2017)
■ V3.1.4016.12 (16.12.2014)
Allgemeine Hinweise
■ Bosch Connected Industry gibt nur die TwinCAT XAR Runtime als Teil des Master Images bei. Die TwinCAT XAE
Entwicklungsumgebung kann unabhängig davon aktualisiert werden ohne Freigabe durch Bosch Connected Industry.
Feedback zu Updates ist willkommen.
■ Die unten aufgeführte Änderungshistorie erhebt keinen Anspruch auf Vollständigkeit und wird ohne Gewähr
bereitgestellt. Einen anderen inoffiziellen Changelog gibt es hier: https://cookncode.com/TwinCatChangelog/tc3/
■ XAE Setup: Full / Remote Manager (RM)
■ Das neueste Full Setup can üblicherweise ohne Deinstallation vorheriger Versionen ausgeführt werden. Wenn man
vorherige Versionen deinstallieren will: zuerst Supplements deinstallieren (TFxxxx / TExxxx), dann die TwinCAT
Versionen entgegen der Installationsreihenfolge deinstallieren. Immer den Neustart-Dialogen folgen.
■ Für Download auf das Zielsystem:
■ Die XAE Build Nummer (z.B. 4022 oder 4024) muss gleich der XAR Build Nummer sein.
■ Die XAE Revision (z.B. 4022.32 oder 4024.12) muss gleich oder größer der XAR Revision sein.
■ Nach Aktualisierung eines Projekts auf eine neue XAE Revision (z.B: 4024.12 auf 4024.22) ist üblicherweise ein
Download erforderlich.
■ Die Remote Manager (RM) 4016.28 und 4020.28 dürfen nicht das zuletzt ausgeführte Setup sein, da man
ansonsten keine neueren Projekte mehr öffnen kann. Empfohlene Installationsreihenfolge (nicht benötigte
Versionen überspringen):
■ Visual Studio 2013 (notwendig für TwinCAT 3.1.4016 und 3.1.4020.28 ), siehe Beschreibung:
https://community.developer.bosch.com/t5/Knowledge-base/Setup-of-TcXaeShell/ta-p/27431
■ Full 4024 (inklusive TcXaeShell)
■ RM 4016.28
■ Bosch Patches für 4016
■ RM 4020.28
■ Bosch Patches für 4020
■ RM 4020.56
■ RM 4022
■ RM 4024
■ Visual Studio / TcXaeShell
■ Beim Installieren einer neuen TwinCAT Version empfiehlt Bosch Connected Industry die Installation von TcXaeShell,
welches ein gelabeltes Visual Studio 2017 Shell ist.
■ Empfohlene Visual Studio Versionen: 2015, 2017, 2019, TcXaeShell
■ Nicht empfohlene Visual Studio Versionen: 2010 (nicht mehr unterstützt), 2013 (viele Abstürze)
■ TwinSAFE Editor TE9000
■ Das XAE Setup installiert immer die neueste Version des TE9000. Weil TE9000 keine Versionsauswahl wie beim
Remote Manager besitzt, wird der neueste installierte TE9000 für alle Projekte verwendet. Wenn man ältere
Projekte öffnet, kann sich die CRC ändern, was bedeutet, dass ein Download notwendig ist. Um dies zu verhindern,
muss man alle TE9000 deinstallieren und die im Projekt notwendige TE9000 Version installieren.
V3.1.4024.32 (27.07.2022)
Fehlerbehebungen
■ 'Find All' funktioniert nun korrekt in Visual Studio 2019. Es ist nun möglich, aus den Suchergebnissen direkt zum
Quellcode zu springen.
■ Das Automation Interface, welches vom Nexeed Control plus Code Checker verwendet wird, wirft keine Exception
mehr, wenn es eine FUNCTION ohne Rückgabewert gibt.
■ Das TwinCAT Project Compare Tool stürzt nicht mehr ab beim Vergleich von SFC POUs wie im Nexeed Control plus
Beispielprojekt 'Digitale Maschine'.
■ Wenn es zwei SPS-Projekte gibt (Port 851 und 852): Wenn die erste SPS an einem Breakpoint hält und mit Online
Change geändert wurde, ist die zweite SPS nicht mehr gestartet.
Bemerkungen
V3.1.4024.25 (28.03.2021)
Fehlerbehebungen
■ Verbesserungen von Online Change Problemen.
■ Behebt einen spezifischen Absturz von Visual Studio / TcXaeShell, der mit 4024.12 und 4024.22 aufgetreten ist.
V3.1.4024.22 (30.11.2021)
Fehlerbehebungen
■ Netzwerkvariablen funktionieren wieder. Mit XAE 3.1.4024.12 funktionieren Netzwerkvariablen nicht.
■ Bessere Unterstützung der lokalen Runtime auf einem Laptop/Entwicklungsrechner.
Bemerkungen
■ Die XAE Revisionen 4024.15, 4024.17 und 4024.20 sollten nicht verwendet werden wegen bekannten Problemen.
V3.1.4024.12 (09.02.2021)
Neue Funktionen
■ Beinhaltet TcXaeShell (Visual Studio 2017 Shell) Setup.
■ Unterstützt Visual Studio 2019 (aber nicht empfohlen, weil die Suchergebnisse nicht mit SFC-Aktionen richtig
funktionieren). Visual Studio 2010 wird nicht mehr unterstützt.
■ SFC Schritte können integrierte Aktionen enthalten (neue Eigenschaft Duplicate on copy), die automatisch mit dem
Schritt umbenannt werden (funktioniert auch schon mit 3.1.4022, jedoch ohne automatische Umbenennung). Dies
vereinfacht das Umbenennen und Copy und Paste von Schritten.
■ Speichern aller Online-Zustände (Core Dump) im Fall eines PageFaults oder bei Halt an einem Breakpoint. Der Core
Dump kann später offline geöffnet werden. Properties (ExecState, UnitState, usw.) werden noch nicht unterstützt, nur
Variablen.
■ Erste TwinCAT-Version mit Multiuser-Fähigkeit, bei dem jeder Programmierer vor dem Login seinen Software-Stand
mit dem Zielsystem zusammenführen muss. Dafür installiert Beckhoff auf dem Entwicklungs- und Zielsystem das Git-
Quellcode-Verwaltungssystem.
■ Diverse TwinSAFE-Verbesserungen (globale Variablen, Mehrfachverwendung von Variablen, Autovervollständigung für
Variablen, Erstellung eigener FBs, usw.)
■ Übersetzungsdauer gleich wie bei TwinCAT 3.1.4020 und ca. drei Mal schneller als bei TwinCAT 3.1.4022
■ Enumerationen unterstützen TO_STRING() mit dem Pragma {attribute 'to_string'}
■ FBs haben die neue Eigenschaft AdditionalMemory, um bei neu angelegten lokalen Variablen einen OnlineChange
ohne Speicherverschiebung durchführen zu können
■ Mit CTRL+K, dann CTRL+U bzw. +C können mehrere Zeilen (ent)kommentiert werden (Empfehlung: ändern in
ALT+U/C)
■ Mit CTRL+K, dann CTRL+U bzw. +C können mehrere Zeilen (ent)kommentiert werden (Empfehlung: ändern in
ALT+U/C)
■ Mit 'Gehe zur Definition' ist es nun möglich, vom Prozessabbild in den Quellcode zu springen
■ Im Vergleich zu den Versionen 4020 und 4022 funktioniert das automatische Übersetzen beim Klicken des Login-
Buttons korrekt und erfordert keinen Download oder Online Change. Mit TwinCAT 4020 und 4022 war es notwendig,
ein Projekt nach dem Öffnen zuerst manuell zu übersetzen, um einen Download oder Online Change in manchen
Fällen zu verhindern.
Bemerkungen
■ REFERENCE auf SPS-Eingänge (%I*) ist nicht mehr möglich. Wenn ein Peripheral (z.B. Kuka KRC4 und Stäubli CS9)
es verwenden, muss die Compiler-Version in den SPS-Projekt Eigenschaften in TwinCAT auf eine vorherige Version
gesetzt werden solange kein Peripheral-Update verfügbar ist.
■ Das Setup enthält den TwinSAFE Editor (TE9000) 1.3.0. Wenn man ein bestehendes TwinSAFE 1.0.0 Projekt öffnet,
könnte sich die CRC ändern und deshalb nur ein Login mit Download auf dem TwinSAFE Zielsystem möglich sein. Der
TwinSAFE Editor TE9000 hat aktuell keine Remote Manager Funktion zur Versionsauswahl.
■ Die XAE Revisionen 4024.10 und 4024.11 sollten nicht verwendet werden wegen bekannten Problemen.
V3.1.4024.10 (06.11.2020)
Bemerkungen
■ Diese Version sollte nicht mehr verwendet werden.
V3.1.4022.36 (30.11.2021)
Fehlerbehebungen
■ Probleme mit dem TwinCAT Project Compare Tool behoben.
V3.1.4022.32 (05.11.2020)
Neue Funktionen
■ Bei Verwendung von Integrated Robotics mit Stäubli Robotern wird ab dieser Version die uniVALplc Client Library über
OES und Control plus Studio richtig installiert. Dies ist im Fall eines neuen Entwicklungsrechners wichtig.
Bemerkungen
■ Im RM Setup dieser Version fehlt die Datei TcXaeVsx.15.0.dll. Dadurch kann kein TwinSAFE Projekt geöffnet werden
(der TwinSAFE Abschnitt ist leer). Die Datei manuell in den Windows GAC installieren.
V3.1.4022.30 (23.03.2020)
Fehlerbehebungen
■ Project Compare Tool (Projektvergleich) funktioniert wieder.
V3.1.4022.27 (19.02.2019)
Neue Funktionen
■ Multi-Dongle Unterstützung.
■ Zoom-Funktion im Strukturierten Text (ST) Editor.
■ Unterstützt 'region' zum Einklappen von Code-Segmenten.
Bemerkungen
■ Das Beckhoff Project Compare Tool (Projektvergleich) dieser Version funktioniert nicht.
■ TwinCAT 3.1.4022 behandelt E/A Variablen (%I*, %Q*) anders als alle vorherigen Versionen. Ist eine E/A-Variable mit
dem Attribut {attribute 'hide'} oder {attribute 'hide_all_locals'} versehen (direkt oder indirekt), so wird diese Variable
nicht mehr ins E/A-Abbild der Task übernommen und kann somit nicht mehr verlinkt werden.
V3.1.4020.56 (05.11.2020)
Fehlerbehebungen
■ Behebt viele Abstürze, die mit XAE 3.1.4020.28 auftraten
Bemerkungen
■ Update empfohlen für Projekte mit XAE 4020.28. Nach Update ist ein Download notwendig. Ein Online Change ist
üblicherweise nicht möglich.
V3.1.4020.28 (23.01.2018 )
Neue Funktionen
■ Unterstützt Windows 10
■ Visual Studio Shell 2013 wird installiert
■ Unterstützt Visual Studio 2015
■ Unterstützt die Beckhoff Lizenzklemme EL6070
■ Refactoring für einfaches Umbenennen von Variablen im ganzen Projekt
■ Beliebige Speicherbereiche in Online-Ansicht betrachten
■ Grafischer Editor für Netzwerkvariablen
■ Verbesserte Cross-Reference-List Ansicht
■ Statische Code-Analyse in den SPS-Projekt-Einstellungen aktivierbar (z.B. unbenutzte Variablen suchen)
■ VAR_INST deklariert Variablen in Methoden, die ihren Wert nicht verlieren
■ Für Objektentwickler: Der Add Method Dialog zeigt im Interface/Basis-FB vorhandene Methoden an
■ Für Objektentwickler: Compiler-Version kann in den SPS-Projekt-Einstellungen verändert werden (muss auf
3.1.4016.0 gesetzt werden)
■ Für Objektentwickler: Standard Platzhaltername muss für Bibliothek angegeben werden
Bemerkungen
■ Nicht vergessen, die Patches anzuwenden (DLL-Updates via Batch-Datei). Ansonsten könnten Bibliotheksparameter
verloren gehen und Login ist nur möglich mit Download oder Online Change.
■ Dies ist die einzige Version, die ein Remote Manager Setup hat zum Zugriff auf die Runtime XAR 4016.x. Nach
Ausführen des RM 4020.28 Setups noch irgendein neueres Setup ausführen (mindestens Build 4022).
V3.1.4016.28 (23.03.2017)
Bemerkungen
■ Dies ist die einzige Version, die ein Remote Manager Setup hat zum Zugriff auf die Runtime XAR 4016.x.
■ Nicht vergessen, die Patches anzuwenden (DLL-Updates via Batch-Datei).
■ Dies ist die einzige Version, die ein Remote Manager Setup hat zum Zugriff auf die Runtime XAR 4016.x. Nach
Ausführen des RM 4016 Setups noch irgendein neueres Setup ausführen (mindestens Build 4022).
V3.1.4016.12 (16.12.2014)
Fehlerbehebungen
■ Mehrere wichtige Verbesserungen im Vergleich zum Build 4014.
Bemerkungen
■ Diese Version sollte nicht mehr verwendet werden. Sie unterstützt keine Installation parallel zu anderen TwinCAT-
Versionen.