Installation

The system requirements for the engineering PC and the runtime PC are described below. Next, we will describe how to install TwinCAT Build 4026 or higher using the TwinCAT Package Manager, and how to install TwinCAT Build 4024 using the setup program.

Please note that TwinCAT 3.1 Build 2026 or higher (TwinCAT Package Manager installation) is required to use the full range of features of the TE1400 product.

System requirement

In the following, a distinction is made between the engineering PC and the runtime PC. The following definition is used:

On the engineering PC, Simulink^® models are converted into TwinCAT objects by using the TwinCAT Target for Simulink^®. The TwinCAT objects created can be instantiated in TwinCAT projects and thus integrated into the program flow.

	Built objects can be easily forwarded TwinCAT objects built on an engineering PC (or Build Server) can be easily forwarded to other people. They only need the TwinCAT XAE development environment in order to use the created objects (TcCOM or PLC function blocks) in a TwinCAT solution.

The created TwinCAT Solution is then loaded from the engineering PC to a runtime PC in the TwinCAT runtime environment for execution of the project.

Requirements on the engineering PC

MATLAB® R2019a or higher and at least Simulink^® and Simulink® Coder^™
Visual Studio 2017 or higher (Professional, Ultimate or equivalent edition)

During installation, the option Desktop development with C++ must be selected manually. The option can also be installed later.
To support the TwinCAT OS (ARMV8-A) platform (for compiling for CX82xx and CX9240), the MSBuild Support for llvm (clang-cl) toolset component is also required. This must also be selected manually.

TwinCAT XAE

With TwinCAT Package Manager: at least version 3.1 4026 (see Installation of TwinCAT 3.1 Build 4026)
With setup: version 3.1.4024.35 or higher

TwinCAT Target for Simulink^®

TwinCAT Build 4026: Install the appropriate workload (see next paragraph).
TwinCAT Build 4024: Use the Download Finder on the Beckhoff website and install TwinCAT tools for MATLAB^® and Simulink^®

System requirements on the runtime PC

Supported operating systems

Windows 11, Windows 10
Beckhoff RT Linux^® (only from TwinCAT Build 4026)
TwinCAT/BSD

TwinCAT XAR

With TwinCAT Package Manager: at least version 3.1 4026 (see Installing TwinCAT 3.1 Build 4026)
With setup: version 3.1.4024.35 or higher

For runtime PCs, please note the details regarding the build platforms.

	The same TwinCAT major build is required on both the runtime and engineering systems Please note that the same TwinCAT major build must be used on the runtime system and the engineering system. This means: TwinCAT Build 4024 on XAE and XAR or TwinCAT Build 4026 on XAE and XAR.

TwinCAT Package Manager: Installation (TwinCAT 3.1 Build 4026)

Detailed instructions on installing products can be found in the chapter Managing TwinCAT software in the TwinCAT 3.1 Build 4026 installation instructions.

Install the following workload to be able to use the product:

In the UI: TE1400 | TwinCAT 3 Target for Simulink®

In the command line: tcpkg install TE1400.TargetForSimulink.XAE

Also, perform the integration into Visual Studio®, which you installed using the Desktop development with C/C++ option and, if applicable, the MSBuild Support for llvm (clang-cl) toolset option.

	The procedure described below is still necessary even after updating the TE1400 product.

The TE1400 product is installed in the TwinCAT folder structure, i.e. it is separate from the MATLAB^® installation. To use the TE1400 functions in your version of MATLAB^®, you must register the TE1400 installation with your MATLAB^® installation.

To do this, launch MATLAB^® with administrator rights and run the installation script using the following command in the MATLAB^® Command Window:

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

A pop-up window will then appear where you can configure basic settings. You can then use the functions of the TE1400 product in your MATLAB^® installation.

In the next step, complete the initial setup of the software, and then take a look at the quick start guide.

If you want to create a TwinCAT project and use TwinCAT objects that have already been built, install the following workloads:

TwinCAT Standard
tcpkg install TwinCAT.Standard.XAE
TwinCAT Block Diagram Classic
tcpkg install TwinCAT.XAE.BlockDiagramClassic
In some cases, you may also need the following packages:
tcpkg install TwinCAT.XAE.TMX.DataExchange(see DataExchangeModules)tcpkg install TwinCAT.XAE.TMX.MatSimUtilities(for converting ITcVnImage to ARRAY)

Setup: installation (TwinCAT 3.1 Build 4024)

The system requirements (engineering PC) have been met. Please note in particular that a supported version of Visual Studio® must be installed with the Desktop development with C/C++ option, and that integration with the corresponding Visual Studio® has been completed.

You have administrator rights on your system. Without administrator rights, you must perform Step 4 after every (re)start of MATLAB^®.

1. Start TwinCAT Tools for MATLAB^® and Simulink^® setup to install the TE1400.

2. Follow the instructions in the setup window.

The TE400 is installed within the TwinCAT folder structure, which means that the TE1400 installation is separate from your MATLAB^® installation. To use the functions from TE1400, you must register the TE1400 installation with your MATLAB^® installation. Carry out the following steps to do this. These steps are also necessary after updating the TE1400 product.

3. Launch MATLAB^® with administrator rights.

4. Run the command below in the MATLAB® command line to start the installation script.

A pop-up window will then appear where you can configure basic settings. You can then use the functions of the TE1400 product in your MATLAB^® installation.

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