PLC.Commissioning.Lib

This repository was developed for the purpose of automating the testing of PROFINET sensors as part of a diploma thesis by @vformi at Czech Technical University in Prague (CTU), within the Open Informatics program specializing in Software Engineering.

Overview

This repository contains the main library for commissioning PLCs and includes links to manufacturer-specific libraries as Git submodules. The structure is designed to enable modular, automated testing across different PLC manufacturers, with each submodule providing manufacturer-specific functionality.

Prerequisites

• Operating System: Windows (required)
  • The TIA Portal is only supported on Windows, so this library requires a Windows platform to function properly.
• TIA Portal and TIA Portal Openness: TIA Portal (with TIA Openness enabled) must be installed on the system, as the library interacts directly with the TIA Portal software for PLC commissioning and testing.
  • Ensure that you have the necessary permissions, including membership in the Siemens TIA Openness Windows group, to allow programmatic access to TIA Portal functionalities.
• .NET Standard 2.0 or later: Ensure that .NET Standard 2.0 or a compatible version of .NET Core/.NET Framework is installed.

This repository contains the main library for commissioning PLCs and includes links to manufacturer-specific libraries and other functionalities as Git submodules. The structure is designed to enable modular, automated testing across different PLC manufacturers, with each submodule providing manufacturer-specific functionality.

Repositories Structure

The project is divided across several repositories:

• PLC.Commissioning.Lib (this repository)
• PLC.Commissioning.Lib.Abstractions
• PLC.Commissioning.Lib.Siemens
• PLC.Commissioning.Lib.Siemens.Webserver
• Further manufacturers (Rockwell, Beckhoff) in development

Cloning the Project

To clone the main repository with all submodules, use:

git clone --recurse-submodules https://github.com/vformi/PLC.Commissioning.Lib

To update the submodules later, use:

git submodule update --init --recursive

Getting Started

Install .NET Standard 2.0 or later. Restore dependencies: dotnet restore Usage

using PLC.Commissioning.Lib.Enums;
using PLC.Commissioning.Lib.Abstractions;

var controller = PLCFactory.CreateController<IPLCControllerSiemens>(Manufacturer.Siemens);
// Configure, initialize, and start your PLC operations

For further usage examples see PLC.Commissioning.Lib.App which also includes an executable code that is using and utilizing most of the library.

Troubleshooting

Engineering Security Exception

If you encounter the following error:

[12:25:45 ERR] EngineeringSecurityException: Ensure the user 'USER' is a member of the Siemens TIA Openness group.

This indicates that the user running the application is not a member of the Siemens TIA Openness Windows group, which is required for accessing certain TIA Portal functionality. To resolve this issue:

1. Add the User to the Siemens TIA Openness Group:
   • Open Local Users and Groups by pressing Win + R, typing lusrmgr.msc, and pressing Enter.
   • In the Groups section, locate Siemens TIA Openness.
   • Right-click on Siemens TIA Openness and select Add to Group.
   • Add your user to the group.
   • Save and close, then restart your computer for the changes to take effect.
2. Refer to Siemens Support Detailed Guide:
   • For more information, refer to the Siemens Support Detailed Guide.

FileNotFoundException: Siemens.Engineering.dll

If you encounter the following error:

Unhandled exception: System.IO.FileNotFoundException: Could not load file or assembly Siemens.Engineering, Version=17.0.0.0, Culture=neutral, PublicKeyToken=d29ec89bac048f84 or one of its dependencies. The system cannot find the file specified.

This indicates the required Siemens.Engineering.dll file is missing. To resolve:

• Verify that TIA Portal is installed and matches the required version.
• Ensure the Siemens.Engineering.dll file is properly referenced in your project.
• You have the following options to start the TIA Portal with a TIA Portal Openness application:
  • Use an application configuration file (recommended in most use cases).
  • Use the "AssemblyResolve" method (recommended when you use copy deploy etc.).
  • Copy the Siemens.Engineering.dll in the TIA Portal Openness application directory.

For more information, refer to the TIA Portal Openness Documentation (Page 81).

Single dll publish workflow

1. Install ILRepack

dotnet tool install -g dotnet-ilrepack 

2. Ensure your project and all dependencies are built successfully and output DLLs are in the bin\Release\netstandard2.0 folder:

dotnet build -c Release

After running the build, a ilrepack.rsp file will be created in the bin\Release\netstandard2.0 directory. This file contains the list of all .dll files to be merged, excluding the already merged output.

Steps to reproduce

1. Build the project:

dotnet build -c Release

2. Navigate to the output directory:

cd bin\Release\netstandard2.0

3. Run the ilrepack command:

ilrepack /out:PLC.Commissioning.Lib.Merged.dll "@ilrepack.rsp"