Skip to content

Latest commit

 

History

History

Force

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
Force.pcwex
Force.pcwex
 
 
README.MD
README.MD
 
 

README.MD

Force Service

Table of contents

Introduction

The PLCnext Runtime provides an RSC service, called IForceService, that a client can use to force some Global Data Space (GDS) variables. From the PLCnext Engineer help system:

What is the difference between forcing and overwriting?

Overwriting is possible for local and global variables (marker variables without assigned process data item) as well as for I/O variables (assigned to process data item). The value is overwritten (set) only once at the beginning of the task execution cycle. Then, the variable is processed normally. Thus, the new value of the variable remains until a write access is performed. A write access can be performed by a programmed store operation or by remote access (e.g. by the OPC server) or by initializing the variable in case of a controller cold start.

Forcing is possible for variables and ports which are connected to process data items, i.e., I/O variables/ports. Forcing means setting the I/O variable/port permanently to the force value until forcing is reset by the user.

Guide details

Description Value
Created 7.01.2021
Last modified 7.01.2021
Controller AXC F 2152
FW 2021.0.0 LTS
Arpversion 21.0.0.35466
SVN Revision 35466
SDK 2021.0.0 LTS (21.0.0.35466)
PLCnext CLI 21.0.0 LTS (21.0.0.489)

References

A complete description of the Force service is available from this source:

Quick-start example

This example demonstrates features of the Force RSC service.

It is assumed that the user has some experience building C++ Components and Programs for PLCnext Control.

Prerequisites:

  • AXC F x152 controller with AXL F DI8/3 DO8/3 2H (2702071) digital input/output module. Other hardware arrangements will require modifications to the sample code.

  • PLCnext Command Line Interface (CLI) tool, version 2021.0. This is included in the "PLCnext Technology C++ tool chain", available on the Phoenix Contact website.

  • A Software Development Kit (SDK) for the AXC F 2152 PLCnext Control, version 2021.0.0 or later. This is also included in the "PLCnext Technology C++ tool chain".

  • (optional) Eclipse IDE, with the PLCnext Technology feature installed.

  • (optional) Visual Studio, with the PLCnext Technology add-in installed.

  • PLCnext Engineer version 2021.0.1 or later.

Procedure:

  • Clone this repository, e.g.

    git clone https://github.com/PLCnext/CppExamples.git

  • Create the variables that will be forced:

    • In PLCnext Engineer, open the PLCnext Engineer project in the Examples/Force directory of this repository.
    • Check that the controller model and firmware version in the project matches the controller you are using.
    • Send the project to the PLC and check that the PLC starts OK.

  • Create a new ACF project using either the PLCnext CLI tool, or Eclipse, or Visual Studio, with the following settings:

    • Project name: Force
    • Component name: ForceComponent
    • Project namespace: Force

  • Copy the contents of the Examples/Force/src directory in this repository, to the src directory of the ACF project. Replace the existing source files with the same name.

  • Build the ACF project.

  • Deploy the ACF project to the PLC.

  • Restart the PLCnext Runtime.

  • Check the contents of the file /opt/plcnext/logs/Output.log. It should contain messages from your ACF component and from the GdsForceManager firmware component.