Processing Device Projects and Library Projects in One Workspace

Click the Menu → Create Workspace command.

Alternatively, you could select the command by using the button or the Command Center.

In this dialog, give a name to the new workspace – for example Calculator – and click the button to select the desired path in the file system. Then click OK.

In this dialog, select the Create Library Project command.

In the Create a new Library Project dialog, specify the data of your new library project.

Click the Create button.

The library project will be created.

The library project will be displayed in the workspace navigator as follows:

In the workspace navigator, right-click the CalculatorLibrary.fbslib item and select the Add Item → Function command.

In the Add Function dialog, specify a name for the function – for example Addition – and INT as the Return value.

Select Structured Text (ST) as the Implementation language and click Create.

In the editor, add the variable declarations for the input variables x : INT; and y := INT; as well as the implementation code Addition := x+y; so that the final function looks like this:

// Small function to perform addition
// x + y
FUNCTION Addition : INT
VAR_INPUT
    x : INT;    
    y : INT;
END_VAR
VAR
END_VAR
Addition := x+y;
END_FUNCTION

In the workspace navigator, add another function named Subtraction with the Return value INT to the library project. Select Structured Text (ST) as the Implementation language and click Create.

In the editor, also add the variable declarations and implementation code to the Subtraction function so the final function looks like this:

// Small function to perform a subtraction
// x - y
FUNCTION Subtraction : INT
VAR_INPUT    
    x : INT;    
    y : INT;
END_VAR
VAR
END_VAR
Subtraction := x - y;
END_FUNCTION

Select the Menu → Create Device Project command, or click the icon and select the command.

In the next dialog, specify the data for your new project and then click Create.

In the Add PLC dialog, select the controller – for example CODESYS Control Win V3 x64 – and click OK.

In the next dialog Add Program, PLC_PRG is already given as the Name and Structured Text (ST) is selected as the Implementation language. Click Create to confirm the dialog.

The device project will be created and added to the workspace navigator parallel to the already created library project:

The PLC_PRG.prg.st program will be opened in the editor.

In the workspace navigator, double-click the Libraries.json file of the device project and reference the CalcLib library project.

 {
    "references": {
        "Standard": {
            "$type": "Placeholder",
            "placeholder": "Standard"
        },
         "CalcLib": {
            "$type": "RelativePath",
            "path": "../../CalculatorLibrary.fbslib"
        }
     },
    "placeholderOverrides": {}}

Right-click the Libraries.json file and select the Resolve Libraries command in the context menu.

Switch to the editor of the PLC_PRG.prg.st program and add a variable declaration and the implementation code. When you type the first few letters of the name of your library name, the autocomplete function will suggest the library. The completed program will look like this:

PROGRAM PLC_PRG
VAR
    iVar : INT := 0;
END_VAR

iVar := CalcLib.Addition(iVar, 2);
iVar := CalcLib.Subtraction(iVar, 1);

END_PROGRAM

Right-click the Application.iecapp item and select the Build Application command.

Make any desired changes to the library directly in the library project.

When logging in again, CODESYS 4 detects the change and opens the Confirm Download dialog. It is not necessary to resolve the libraries again.

Double-click the Communication.settings.json item.

Click the Configure Device button.

Click the Add Gateway button.

In the Add Gateway dialog, choose a name for your gateway and click Add.

Note: The values for IP address and Port remain unchanged.

Click your controller to select it and click the Connect Device button.

Choose a user name and password. Confirm the password and click Apply.

Note: The chosen password must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one special character, and one digit.

In the Log In to Device dialog, provide your new credentials and click Log In.

In the Device Browser dialog, click Select.

For more information, see the following: Communication.settings.json

Right-click the Application.iecapp application and select the Download Application command.

In the Confirm Download dialog, click the Download button.

Click the icon (top right) or press the Alt+F8 shortcut to log in to the controller.

Click the icon (top right) to run the program.

Open the PLC_PRG program in the editor.

Click the icon (top right) to stop the program.

Click the icon (top right) or press the Ctrl+F8 shortcut to log out of the controller.