About DanielToGo

In this guide we describe the basics of how to set up a ctrlX CORE to work with a Python script by using the PLC app. We will show you a PLC sample project that illustrates how to read/write data in the datalayer and how to let axes move in the Motion app with a Python script. You can download the example project below and try starting it yourself. Prerequisites What you need: ctrlX CORE or CORE virtual ctrlX WORKS PLC App Motion App Python Runtime App Step-by-Step Guide So, let's start by adding the CXA_Python library which lets us execute, delete, reset and monitor Python scripts on script instances. Go to the Library Manager, click Add Library and search for CXA_Python. Add CXA_Python The next step is to create a global variables list. The first block represents the nodes we create in the datalayer. You can find them in ‘plc/app/Application/sym/[name of GVL file]/‘ later. The second block represents the script instance. The third block represents the script file that executes the python commands later. Here you can give the instance a name and specify the path to the python script we create in a few steps. The variables for the script instance and the script file will be linked to the visualization elements later. Global Variables to create nodes and variables for the instance/visualization The next step is to create the script instance and the script executable. We do that by creating a new POU program called PRG_Script with Structured Text as implementation language. Here we create some variables for the script instance and file. We can use some structures from the CXA_Python library for that, that will be shown in the visualization later. In the next part we can create the script instance and start the script file. The instance lets you execute the python script, but an instance only lets you execute one script at the same time. In this case the script instance can only be started on the startup or when restarting after the script finished running. Use the declared variables to create and start the instance and file. Creates python instance/file and connects button variables to it Another important step is to use the global variables that we want to become nodes in the datalayer (see line 1). This is important because you might not see variables in the next step if you aren’t using them. So, what we do next is export the variables we want to see in the datalayer. We do that by going into the Symbol Configuration and checking the variables, but first you need to build the project for all variables to appear. List of variables Then we simply call this new program from PLC_PRG. Calls PRG_Script program Now we can create a visualization and link the buttons and display elements to the according variables. That’s how we control the instance and the file. Visualization to start/stop the python instance and file After the visualization is done, we can start with the python script which is quite simple. We can use it just like a normal python script from here on. Here you can test reading from the datalayer. Reads data from datalayer You can also manipulate the data and write it back into the datalayer. Calculates some data and writes it back to the datalayer And finally, here are some examples to show that it’s possible to move axes with the Motions app by using a python script. Moves axes with the Motion app All we need to do now is to upload the python script onto the ctrlX CORE. To do that click “Manages app data” on the top right corner of the overlay of he ctrlX CORE. Managing app data Then open the File View by clicking on the three dots. Switching to file view Now we can upload the python script to the path we picked earlier as a global variable in the GVL_Script file. In this case it’s just the home folder 'activeConfiguration/MyPythonScript1.py'. You can also edit the script in this view. How to start the example We uploaded this project so you can download it below and start it, if ctrlX WORKS is installed. To test this python script, we need to add a linear axis called “Axis_X” in the motions app. Add axis window We start this program by going into the PLC project, connecting it to the ctrlX CORE, logging into the ctrlX via the PLC project and starting it. Logging in Starting the project Now we can start and stop the python script and instance with the visualization we created earlier. The script instance needs to be enabled first and then you can execute the file with the buttons. Below the buttons you can see the current state of the script instance and the script file to check if it’s running correctly or if any errors occurred. You can also reset or abort the python script. Everything should be green in the visualization. You should be able to see the axis move, and you should be able to see the changes in the datalayer if the program is running correctly. Running Visualization Window Axis is moving Values got assigned and changed Known Issue As of June 2024 something prevents a restart of the python script, if the "OPC UA Pub/Sub" app is installed on the same ctrlX CORE. Related Links Set up a ctrlX CORE and PLC Programming Set up a ctrlX PLC project to publish variables to the ctrlX Data Layer ... View more