Installation

Nachfolgend sind zunächst die Systemvoraussetzungen auf dem Engineering PC und auf dem Laufzeit-PC beschrieben. Anschließend wird für das TwinCAT Build 4026 oder höher die Installation über den TwinCAT Package Manager, sowie für das TwinCAT Build 4024 die Installation über das Setup beschrieben.

Bitte beachten Sie, dass für den vollen Funktionsumfang des Produkts TE1400 das TwinCAT 3.1 Build 2026 oder höher (TwinCAT Package Manager Installation) erforderlich ist.

Systemvoraussetzung

Im Folgenden wird zwischen dem Engineering PC und dem Laufzeit-PC unterschieden. Dazu wird folgende Definition getroffen:

Auf dem Engineering PC werden Simulink^®-Modelle in TwinCAT-Objekte durch Einsatz des TwinCAT Target for Simulink^® konvertiert. Die erstellten TwinCAT-Objekte können in TwinCAT-Projekten instanziiert und so in den Programmablauf eingebunden werden.

	Gebaute Objekte können einfach weitergegeben werden Auf einem Engineering PC (oder Build Server) gebaute TwinCAT-Objekte können einfach an weitere Personen weitergereicht werden. Diese benötigen lediglich die TwinCAT-XAE-Entwicklungsumgebung, um die erstellten Objekte (TcCOM- oder PLC-Funktionsbausteine) in einer TwinCAT Solution zu nutzen.

Die erstellte TwinCAT-Solution wird dann vom Engineering PC auf einen Laufzeit-PC in die TwinCAT-Laufzeitumgebung zur Ausführung des Projekts geladen.

Voraussetzungen auf dem Engineering PC

MATLAB R2019a oder höher und mindestens Simulink^® und Simulink Coder^™
Visual Studio 2017 oder höher (Professional, Ultimate oder äquivalente Edition)

Bei der Installation muss manuell die Option Desktop development with C++ ausgewählt werden. Die Option kann auch nachträglich installiert werden.
Zur Unterstützung der TwinCAT OS (ARMV8-A) Plattform (zum Kompilieren für CX82xx und CX9240) ist zusätzlich die Komponente MSBuild Support for llvm (clang-cl) toolset erforderlich. Diese muss ebenfalls manuell selektiert werden.

TwinCAT XAE

Mit TwinCAT Package Manager: mindestes Version 3.1 4026 (siehe Installation TwinCAT 3.1 Build 4026)
Mit Setup: Version 3.1.4024.35 oder höher

TwinCAT Target for Simulink^®

TwinCAT-build 4026: Installieren Sie den für Sie passenden Workload (siehe nächster Absatz).
TwinCAT-build 4024: Nutzen Sie den Download Finder auf der Beckhoff Webseite und installieren Sie TwinCAT Tools for MATLAB^® and Simulink^®

Voraussetzungen auf dem Laufzeit-PC

Unterstützte Betriebssysteme

Windows 11, Windows 10
Beckhoff RT Linux^® (nur ab TwinCAT-build 4026)
TwinCAT/BSD

TwinCAT XAR

Mit TwinCAT Package Manager: mindestens Version 3.1 4026 (siehe Installation TwinCAT 3.1 Build 4026)
Mit Setup: Version 3.1.4024.35 oder höher

Beachten Sie für die Laufzeit-PCs die Details zu den Build-Plattformen.

	Laufzeitsystem und Engineering System benötigen dasselbe TwinCAT Major Build Bitte beachten Sie, dass auf dem Laufzeitsystem und dem Engineering System dasselbe TwinCAT Major Build verwendet werden muss. Das heißt: TwinCAT Build 4024 auf XAE und XAR oder TwinCAT Build 4026 auf XAE und XAR.

TwinCAT Package Manager: Installation (TwinCAT 3.1 Build 4026)

Eine ausführliche Anleitung zur Installation von Produkten finden Sie im Kapitel TwinCAT-Software verwalten in der Installationsanleitung TwinCAT 3.1 Build 4026.

Installieren Sie den folgenden Workload, um das Produkt nutzen zu können:

Im UI: TE1400 | TwinCAT 3 Target for Simulink®

In der Kommandozeile: tcpkg install TE1400.TargetForSimulink.XAE

Führen Sie außerdem die Integration in das Visual Studio®, welches Sie mit der Option Desktop development with C/C++ und ggf. MSBuild Support for llvm (clang-cl) toolset installiert haben, aus.

	Der folgende beschriebene Vorgang ist auch nach einem Update des Produkts TE1400 notwendig.

Die Installation des Produkts TE1400 erfolgt innerhalb der TwinCAT-Ordnerstruktur, d.h. sie ist losgelöst von der MATLAB^®-Installation. Um die Funktionen aus TE1400 in Ihrer MATLAB^®-Version nutzen zu können, müssen Sie die TE1400-Installation in Ihrer MATLAB^®-Installation bekannt machen.

Starten Sie hierzu MATLAB^® mit Administratorrechten und führen Sie das Installationsskript über folgenden Befehl im MATLAB^® Command Window aus:

run(getenv("TWINCAT3DIR") + "..\Functions\TE14xx-ToolsForMatlabAndSimulink\SetupTE14xx.p")

Es erscheint dann ein Pop-Up Fenster in dem Sie grundlegende Einstellungen vornehmen können. Anschließend können Sie in Ihrer MATLAB^®-Installation die Funktionen des Produkts TE1400 nutzen.

Schließen Sie im nächsten Schritt die Ersteinrichtung der Software ab und werfen Sie anschließend einen Blick auf die Schnellstart-Anleitung.

Möchten Sie ein TwinCAT Projekt erstellen und dort bereits gebaute TwinCAT-Objekte verwenden, installieren Sie folgende Workloads:

TwinCAT Standard
tcpkg install TwinCAT.Standard.XAE
TwinCAT Block Diagram Classic
tcpkg install TwinCAT.XAE.BlockDiagramClassic
In einigen Fällen benötigen Sie auch folgende Pakete:
tcpkg install TwinCAT.XAE.TMX.DataExchange(siehe DataExchangeModules)tcpkg install TwinCAT.XAE.TMX.MatSimUtilities(zur Konvertierung von ITcVnImage in ARRAY)

Setup: Installation (TwinCAT 3.1 Build 4024)

Die Systemvoraussetzungen (Engineering-PC) sind erfüllt. Beachten Sie insbesondere, dass eine unterstützte Visual Studio®-Version mit der Option Desktop development with C/C++ installiert und die Integration in das entsprechende Visual Studio® erfolgt ist.

Sie verfügen über Administratorrechte auf Ihrem System. Ohne Administratorrechte muss der Schritt 4 nach jedem (Neu-) Start von MATLAB^® durchgeführt werden.

1. Starten Sie das TwinCAT Tools for MATLAB^® and Simulink^® Setup zur Installation des TE1400.

2. Folgen Sie den Anweisungen im Setup Fenster.

Das TE400 ist in der TwinCAT-Ordnerstruktur installiert, d.h. die TE1400-Installation ist losgelöst von Ihrer MATLAB^®-Installation. Um die Funktionen aus TE1400 nutzen zu können, müssen Sie die TE1400-Installation in Ihrer MATLAB^®-Installation bekannt machen. Hierzu führen Sie die folgenden Schritte durch. Diese Schritte sind auch nach einem Update des Produkts TE1400 notwendig.

3. Starten Sie MATLAB^® mit Administratorrechten.

4. Führen Sie den untenstehenden Befehl in der MATLAB® Befehlszeile aus, um das Installationsskript zu starten.

Es erscheint dann ein Pop-Up Fenster in dem Sie grundlegende Einstellungen vornehmen können. Anschließend können Sie in Ihrer MATLAB^®-Installation die Funktionen des Produkts TE1400 nutzen.

run(getenv("TWINCAT3DIR") + "..\Functions\TE14xx-ToolsForMatlabAndSimulink\SetupTE14xx.p")