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 TE1401 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.
- Engineering-PC: Auf diesem System werden MATLAB®-Funktionen durch Einsatz von TE1401 in TwinCAT-Objekte konvertiert. Optional kann hier auch die TwinCAT-Solution erstellt werden, die diese Objekte verwendet.
- Laufzeit-PC: Die auf dem Engineering-PC erstellte TwinCAT-Solution wird in die TwinCAT-Laufzeitumgebung geladen und dort ausgeführt.
Voraussetzungen auf dem Engineering-PC
- MATLAB R2019a oder höher und mindestens MATLAB® und MATLAB® Coder™ Toolbox
- 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 MATLAB®
- 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
![]() | 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. |
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:
TE1401 | TwinCAT 3 Target for MATLAB® - In der Kommandozeile:
tcpkg install TE1401.TargetForMATLAB.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 TE1401 notwendig. |
Die Installation des Produkts TE1401 erfolgt innerhalb der TwinCAT-Ordnerstruktur und ist damit losgelöst von der MATLAB®-Installation. Um die Funktionen aus TE1401 in Ihrer MATLAB®-Version nutzen zu können, müssen Sie die TE1401-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 TE1401 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)(zur Konvertierung von ITcVnImage in ARRAY)
tcpkg install TwinCAT.XAE.TMX.MatSimUtilities
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 TE1401.
- 2. Folgen Sie den Anweisungen im Setup Fenster.
- Das TE401 ist in der TwinCAT-Ordnerstruktur installiert, d.h. die TE1401-Installation ist losgelöst von Ihrer MATLAB®-Installation. Um die Funktionen aus TE1401 nutzen zu können, müssen Sie die TE1401-Installation in Ihrer MATLAB®-Installation bekannt machen. Hierzu führen Sie die folgenden Schritte durch. Diese Schritte sind auch nach einem Update des Produkts TE1401 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 TE1401 nutzen.
run(getenv("TWINCAT3DIR") + "..\Functions\TE14xx-ToolsForMatlabAndSimulink\SetupTE14xx.p")