Russian readme is here.
Program ptusa_main directly controls technological process.
- General system architecture
- Common description
- How to build the project
- Using PLCnext Technology C++ Toolchain in Windows
- How to run a project
- Libraries used
General system architecture of the automated process control system (APCS) is shown below:
Controller logic implemented by Lua-script. At runtime, control is passed through special Lua functions that are responsible for the various stages of the control program.
- Execution of the technological process:
%%{ init: {'theme': 'neutral'} }%%
flowchart TD
A([<b>2 Process execution</b>]) --- B[/<p style='width:150px'> For each unit\]
B --- C[[3 Execution of the unit <br/> procedure]]
C --- D[\<p style='width:150px'> Next unit/]
D --- E([End])
%%{ init: {'theme': 'neutral'} }%%
flowchart TD
A([<b>3 Execution <br/> of the unit procedure</b>]) --- B[/<p style='width:150px'> For each operation\]
B --- C[[<p style='width:150px'>4 Execution <br/> of the operation]]
C --- D[\<p style='width:150px'> Next operation/]
D --- E([End])
%%{ init: {'theme': 'neutral'} }%%
flowchart TD
A([<b>5 Execution of the steps</b>]) --- A1[[6 Execution of the <br/> main step]]
A1 --- B[/<p style='width:150px'> For each extra step\]
B --- C[[6 Execution of the step]]
C --- D[\<p style='width:150px'> Next extra step/]
D --- E([End])
%%{ init: {'theme': 'neutral'} }%%
flowchart TD
A([<b>6 Execution of the step</b>]) --- B[/<p style='width:150px'> For each step\]
B --- C[[7 Execution of the action]]
C --- D[\<p style='width:150px'> Next action/]
D --- E([End])
%%{ init: {'theme': 'neutral'} }%%
flowchart TD
A([<b>7 Execution of the action</b>]) --- B(<p style='width:150px'>Action logic)
B --- E([End])
- When operation is turned on (off) happens next:
- During the execution of command happens next:
You could clone repository by next command:
git clone --recurse-submodules https://github.com/savushkin-r-d/ptusa_main.git
or, if you are clonned without initializing and updating submodules, try next:
git submodules update --init --recursive
Requirements:
- Microsoft Visual Studio Community 2019
You should open (in Visual Studio) root directory. This you get a CMake based project.
- Qt Creator
You could open file CMakeLists.txt cloned repository in Qt.
Or clone repository in Qt: New -> Import Project -> Git Clone specify the repository link and check the box Recursive
- Microsoft Visual Studio Community 2022
Before starting the project, you need to make sure that you have installed C++ CMake tools for Windows. C++ CMake tools for Windows are installed using:
Visual Studio Installer -> Development of classic applications in C++ -> C++ CMake tools for Windows
Detailed installation information can be obtained here. The CMake version required for the build is 3.13 and above.
You should open (in Visual Studio) root directory. This you get a CMake based project.
If an error occurs after startup, then you should clear the CMake cache Project -> Delete cache and perform reconfiguration.
Eclipse IDE with CMake based project on Linux.
Download the latest versions from the Phoenix Contact website (for example, from the AXC F 2152 area) PLCnext Technology C++ toolchain for Windows(current is 2023.0 LTS) and sdk for Windows 64 bit (current is 2022.0.4 LTS), in the section Downloads->Software
Navigate to the folder where downloads are located (typical path %userprofile%/Downloads), unzip the archive (SDK_2021.9_Windows_AXC_F_2152.tar.xz.zip).
Navigate to the folder where downloads are previously unzipped, Call the CLI in the console using the following command:
plcncli.exe install sdk –d [installation path] –p [path to archive file]If you install several SDKs, Phoenix Contact recommends to use the "target name/firmware version" folder structure.
Also your installation path must match with path in CMake.
E.g.:
plcncli.exe install sdk -d C:\CLI\sdks\AXCF2152\2022_0\ -p pxc-glibc-x86_64-mingw32-axcf2152-image-mingw-cortexa9t2hf-neon-axcf2152-toolchain-2022.0.tar.xzThe SDK is specified to the controller. The full list of controllers can be found on the PHOENIX CONTACT International site (Home > Products > PLCs and I/O systems > PLCnext Control > Product list PLCnext Technology components).
To run demo project you should use this command line:
- After building and deploying
windows-defaultcmake-configuration:
bin\install\windows-default\Release\ptusa_main.exe demo_projects/T1-PLCnext-Demo/main.plua path demo_projects/T1-PLCnext-Demo/ sys_path demo_projects/T1-PLCnext-Demo/sys/ debug- Launching a project in Microsoft Visual Studio Community 2022:
Select a launch item -> ptusa_main.exe.
Lua is a scripting programming language. A characteristic feature of Lua is implementation of a large number of program entities with a minimum of syntactic means.
Thus, all composite user data types (arrays, structures, sets, queues, lists) are implemented through the mechanism of tables, and the mechanisms of object-oriented programming, including multiple inheritance, are implemented using metatables, which are also responsible for overloading operations and a number of other features. Lua is a procedural dynamically typed modular language with automatic memory management. Includes basic elements to support functional and object programming styles. Thus, Lua can be called a multi-paradigm language. Built-in parallel programming tools allow you to write multithreaded programs only by means of the language, without accessing the operating system API or external libraries.
Since the main purpose of Lua is embedding, it has effective means of interlanguage interaction, focused mainly on calling C libraries and working in a C environment. The language supports a small number of built-in data types: boolean values, numbers, strings, functions, streams. There are no typical combined data structures, such as arrays, sets, lists, and records; instead of all of them, one basic Lua structure is used a table.
A separate type of userdata is designed specifically for low-level programming and data exchange with external code in other languages. Functions in Lua are objects of the first class, can be assigned and passed in parameters. Closures are supported, it is possible to create higher-order functions. The object system is prototypical, there is no explicit support for inheritance, but it is easily implemented using metatables.
Detailed information can be obtained here.
Tolua is a tool that greatly simplifies the integration of C/C++ code with Lua. Based on a cleaned header file, tolua automatically generates the binding code to access C/C++ features from Lua. Using Lua API and tag method facilities, tolua maps C/C++ constants, external variables, functions, classes, and methods to Lua. To use tolua, create a package file, a C/C++ cleaned header file, listing the constants, variables, functions, classes, and methods to want to export to the Lua environment. Then tolua parses this file and creates a C/C++ file that automatically binds the C/C++ code to Lua. If link the created file with our application, the specified C/C++ code can be accessed from Lua.
Detailed information can be obtained here.
Zlib is a software library used for data compression and is an abstraction of the DEFLATE compression algorithm used in their gzip file compression program.
Detailed information can be obtained here.
SubHook is a simple hooking library for C and C++ that works on Windows, Linux and macOS. It supports x86 only (32-bit and 64-bit).
Detailed information can be obtained here.
Cxxopts is a lightweight C++ option parser library, supporting the standard GNU style syntax for options.
Detailed information can be obtained here.
Google Test is a library for unit testing in C++. Google Test is built on the xUnit testing methodology, that is, when individual parts of the program (classes, functions, modules) are tested separately from each other, in isolation. The library itself is developed with the active use of testing, when adding any parts to the official version, in addition to the code of the changes themselves, it is necessary to write a set of tests to confirm their correctness.
Detailed information can be obtained here.
Google benchmark is a microbenchmark support library. The library can be used with C++03. However, it requires C++11 to build, including compiler and standard library support.
Detailed information can be obtained here.