Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleSoftware Driver

The core of the driver is provided as a C++ class that implements the initialization and communications functions.  A sample process is provided which calls the appropriate class members.

The IP address, configuration information, and data areas to be read and written are passed as calling parameters to the class functions.

The following is a list of the provided driver files.  After review of the example driver, the user is required to modify the files as indicated:

File Name

Description

Modifications

ABPlc.cpp

Driver mainline function

Modify configuration class calls for specific PLC configuration.  Modify locations to read and write data.  Modify input and output datagram structure definition

ABPlcIn.cpp

ABPlc driver initialization

Insert required global common areas. 

PlcUsr.cpp

Process received values from PLC datagram and place in user data variables.

Get application variables and store in datagra for transmission to PLC

Change as required

...

TpriABPlc Class Descriptions

Expand
titleOverview

The Tsentry tpriABPlc class encapsulates the functionality required to communicate with the Allen Bradley PLC 2, PLC3, and PLC5 PLCs over a TCP/IP network.

...

Expand
titleClass Virtual Functions

The custom device driver class then overrides a set of virtual functions that will be called by the base classes at the appropriate times.  These virtual functions are:

 

  • Virtual int initDrv()
    The framework calls this function to process one-time initialization of internal parameters including device name, timeout values, max retry counts, etc.  Return zero to indicate success and nonzero to indicate that an error has occurred.

  •  Virtual int setupComm(int oper)
    The framework calls this function to connect (oper <> 0) or disconnect (oper = 0) from the remote device.  Return zero to indicate success and nonzero to indicate that an error has occurred.  This function does not need to be overridden under normal circumstances.

  •  Virtual int waitMsg()
    The framework calls this function to allow the derived class to decide when it is time to send a message to the remote device.  Return zero to indicate a message should now be sent and nonzero to continue waiting.

  •  Virtual int buildMsg()
    The framework calls this function to assemble the next outbound message immediately after the user has returned zero from a call to waitMsg().  The custom driver should copy the outbound message into the class data member txBuf[] character buffer and store the number of characters in the class data member txCnt.

  •  Virtual int xmitMsg()|
    The framework calls this function to transmit data to the remote device.  Return 0 to indicate success or nonzero indicate an error.  This function does not need to be overridden under normal circumstances.

  •  Virtual int waitRsp()
    The framework calls this function to read data from the remote device.  It must also call testRsp() to check if a full message has been received.  Return 0 to indicate reception of a complete message or timeout or -1 to continue reading data.  This function does not need to be overridden under normal circumstances.

  •  Virtual int testRsp()
    The framework calls this function to decide whether or not a response has been received from the remote device.  Upon entry into this function all data received from the remote device since transmission of the most recent message is stored in the class data member rxBuf[] character buffer and the number of received bytes stored in rxCnt.  Any bytes at the beginning of the rxBuf[] buffer that are not part of a valid response may be removed using the class member function tossRsp(int nToss).  If a valid message is found, copy it from the beginning of the rxBuf[] buffer to the response buffer using the class member function ripRsp(nRsp).  Return zero to indicate that the response is complete, less than zero to indicate that the response is incomplete, and greater than zero to indicate that an error has occurred.

  •  Virtual int procRsp()
    The framework calls this function to process a complete response from the remote device.  Return zero to reset and wait until the next message should be sent, and nonzero to reset the connection.

...

Allen Bradley Control Logix PLC Driver

Expand
titleCapabilities

This driver:

  • Communicates with A-B Control Logix 5500 and 5555 PLC systems

  • Uses TCP/IP Communications over:

    • Standard Ethernet network connection

    • High Speed dedicated process I/O network with deterministic network performance

  • Software implemented as a C++ Class

  • Multiple PLC support

  • Supports:

    • Read Variables

    • Write variables

Capable of running 500ms Input and Output scan rep rates, depending on data buffer size.

Expand
titleA-B Configuration

The Allen Bradley PLC must be set up with the proper IP address.  This configuration is completed with the A-B software.  The IP must be chosen such that it lies within the subnet selected for the specific Ethernet controller used for communications.

If the Ethernet controller is one that is controlled by the Windows 2000 system, the subnet is specified in the network setup utility of the control panel.

If the Ethernet controller is one that is controlled by the RTX Real-Time TCP/IP controller, the IP address is specified in the file d:\LocNtRt\sys\pif\RtxTcp.ini. 

Expand
titleSoftware Driver

The core of the driver is provided as a C++ class that implements the initialization and communications functions.  A sample process is provided which calls the appropriate class members.

The IP address, configuration information, and data areas to be read and written are passed as calling parameters to the class functions.

The following is a list of the provided driver files.  After review of the example driver, the user is required to modify the files as indicated:

File Name

Description

Modifications

ClPlc.cpp

Driver mainline function

Modify configuration class calls for specific PLC configuration.  Modify locations to read and write data.  Modify input and output datagram structure definition

ClIn.cpp

ClPlc driver initialization

Insert required global common areas. 

PlcUsr.cpp

Process received values from PLC datagram and place in user data variables.

Get application variables and store in datagra for transmission to PLC

Change as required

Expand
titleCLeip Class Description

The Tsentry CLeip class encapsulates the functionality required to communicate with the Allen Bradley 5500 and 5555 PLCs over a TCP/IP network.

The following public member functions are provided as part of the tpriCLeip class:

  •  tpriCLeip *pCLeip = new tpriCLeip;

    • Allocate a new tpriCLeip object

  • destroy (tpriCLeip *)pCLeip();

    • Destroy the tpriCLeip class object.

  •  int SetTraceLevel (int TraceLevel);

where:

int TraceLevel = debug trace level for class operations

                           default value = 30

                           valid values range between 0 and 100, inclusive

                           lower values produce less debug information

                           higher values produce more debug information

                           debug information written using LogMsg function

This function stores a new value for the TraceLevel parameter

 

  • int SetEnetPort (int port);

where:

int port = Ethernet Port number

            Default value = 1

This function stores a new value for the Ethernet Port parameter.  This communications parameter defines the port number for the Ethernet controller in the PLC chassis

 

  • int SetLogixSlot (int slot);

where:

int slot = Control Logix process slot number

            Default value = 0

This function stores a new value for the Ethernet Port parameter.  This communications parameter defines the slot in which the Control Logix processor resides.

 

  • int SetTimeOut (int sTimeOut, int rTimeOut, unsigned char ticktime,

                              unsigned char timeoutticks, unsigned char timeoutmultiplier,

                              unsigned long otrpi, unsigned long torpi );

where:

int sTimeOut = TCP Send message timeout value in milliseconds

                                    Default value = 2000

int rTimeOut = TCP Receive message timeout value in milliseconds

                                    Default value = 2000

unsigned char ticktime = (optional) Protocol Tick time (see below)

                              Default value = 10
                              Minimum value = 0
                              Maximum value = 15

unsigned char timeoutticks = (optional) TickTimes multiplier (see below)

Default value = 14

Minimum value = 1

Maximum value = 255

unsigned char timeoutmultiplier = (optional) Inactivity timeout (see below)

Default value = 1

Minimum value = 1

Maximum value = 255

unsigned long otrpi = (optional) Originator->Term Reqested packet interval (u-sec)

Default value = 2064960

unsigned long torpi = (optional) Terminator->Orig Reqested packet interval (u-sec)

                                     Default value = 2064960

 

This function stores timeout parameter values for use by the member functions of the class.

The values sTimeOut and rTimeOut are used to determine the maximum time that will elapse for a single user level call (read or write, respectively) to transfer data to or from the PLC.  If this timeout is exceeded, the I/O request will return to the caller indicating a timeout has occurred.

The remaining values are used to define the PLC’s connection session timeout information.  The values ticktime and timeoutticks are used to calculate the maximum time allowed for a connection request to be serviced by the PLC.  If the PLC cannot establish a connection session within this amount of time, the Connect method will return to the caller an error indicating that a timeout has occurred.  This timeout value is calculated by the following formula:

Connection_Timeout (ms) = 2^(ticktime) * timeoutticks

 

The values timeoutmultiplier otrpi (which stands for Originator->Terminator Requested Packet Interval) and torpi (Terminator->Originator Requested Packet Interval) determine the inactivity timeout of the PLC session.  If this timeout is exceeded BETWEEN calls to the driver (more precisely, between protocol messages sent between the control system and the PLC), the PLC connection session will time out, and the connections to the PLC must be rebuilt.  Subsequent user calls to the driver to transfer data between the control system and the PLC will find the connection destroyed and will return an error.  This timeout value is calculated by the following formula:

Inactivity_Timeout (u-sec) = 4 * 2^(timeoutmultiplier) * min (otrpi, torpi)

Using the default values, the connection timeout and inactivity timeout are:

Connection_Timeout (ms) = 2^(ticktime) * timeoutticks

= 2^10 * 14

= 1024 * 14

= 14336

Connection_Timeout (seconds) = 14.336

Inactivity_Timeout (u-sec) = 4 * 2^(timeoutmultiplier) * min (otrpi, torpi)

= 4 * 2^1 * min (2064960, 2064960)

= 4 * 2 * 2064960

= 16519680

Inactivity_Timeout (seconds) = 16.51968

 

  • int SetConnectionID (unsigned int connid);

where:

unsigned int connid = Logical Connection ID

                       Default value = 0x0b000100

This function stores a new value for the Logical Connection ID parameter

 

  • int SetConnectionSN (unsigned short connsn);

where:

unsigned short connsn = Logical Connection Serial Number

 

This function stores a new value for the Logical Connection Serial Number

 

  • int SetOriginatorInfo(unsigned short vendorid,  unsigned int sn);

where:

unsigned short vendorid = Originator (local system) vendor ID

default value = 1

unsigned int sn = Originator Sequence Number

default value = 0xBC1C0042

This function stores new values for the Originator (local system) information

 

  • int Connect (char *hostname, short int port);

where:

char *hostname = host name, or

IP addresses expressed as a character string

short int port = TCP/IP port number name, or

 

This function establishes a connection between the computer system and the Allen-Bradley Control Logix PLC. Note that if a connection has already been established with a given connection serial number, no other connection may be made to that PLC with the same connection serial number until that connection is either gracefully disconnected or has timed out due to inactivity.

 

  • int Disconnect ();

This function breaks a connection between the computer system and the Allen-Bradley Control Logix PLC

 

  • int readClPccc (int adrType, void *FileName, int offset, int noElements,

                                 int dataType, void *buf);

where:

int adrType = address type

void *FileName = file name within PLC from which to read data

int offset = offset (in data variables) from which to start data read

int noElements = number of data elements to read

int dataType = type of data to be read

void *buf = address of user supplied data buffer

This function reads a single data block from the PLC and stores the results in a user defined buffer.

Offsets may work in one of two ways.  If the PLC contains a variable array called by a file name of “PLCVars”, function calls to retrieve data starting at the 61st element of this array could contain 2nd and 3rd arguments of:

“PLCVars”, 60

or,

“PLCVars[60]”, 0

Legal values for the dataType argument are:

CL_SINT – 1-byte integers

CL_INT – 2-byte integers

CL_DINT – 4-byte integers

CL_REAL – IEEE 4-byte floating point numbers

 

  • int writClPccc (int adrType, void *FileName, int offset, int noElements,

                                 int dataType, void *buf);

where:

int adrType = address type

void *FileName = file name within PLC to write user data

int offset = offset (in data variables) from which to start data write

int noElements = number of data elements to write

int dataType = type of data to be written

void *buf = address of user supplied data buffer containing write data

This function writes a single data block to the PLC from the user defined buffer. Offsets may work in one of two ways. If the PLC contains a variable array called by a file name of “PLCVars”, function calls to write data starting at the 61st element of this array could contain 2nd and 3rd arguments of:

“PLCVars”, 60

or,

“PLCVars[60]”, 0

Legal values for the dataType argument are:

CL_SINT – 1-byte integers

CL_INT – 2-byte integers

CL_DINT – 4-byte integers

CL_REAL – IEEE 4-byte floating point numbers

 

  • int readClCip (void *FileName, int offset, int noElements, int *dataType, void *buf);

where:

void *FileName = file name within PLC from which to read data

int offset = offset (in data variables) from which to start data read

int noElements = number of data elements to read

int *dataType = pointer to an integer variable where the type of the data read shall be returned

void *buf = address of user supplied data buffer

This function reads a single data block from the PLC and stores the results in a user defined buffer.

Legal values returned in the dataType variable are:

CL_SINT – 1-byte integers

CL_INT – 2-byte integers

CL_DINT – 4-byte integers

CL_REAL – IEEE 4-byte floating point numbers

 

  •  int writClCip (void *FileName, int offset, int noElements, int dataType, void *buf);

where:

void *FileName = file name within PLC to write user data

int offset = offset (in data variables) from which to start data write

int noElements = number of data elements to write

int dataType = type of data to be written

void *buf = address of user supplied data buffer containing write data

This function writes a single data block to the PLC from the user defined buffer.

Legal values for the dataType argument are:

CL_SINT – 1-byte integers

CL_INT – 2-byte integers

CL_DINT – 4-byte integers

CL_REAL – IEEE 4-byte floating point numbers

Expand
titleProcess Driver Mainline

Some comments on the driver program are below:

This test program, on each expiration of the process timer, writes a single block of data to the PLC and then reads a single block of data.  This sequence, the number of reads and writes, their addresses, and the sizes of the blocks can be modified to fit the requirements of the application.

PlcUsr and the ‘datagram’ structures they reference should be modified as required to reference appropriate variables in application variables for transfer between the PLC and the control system.

 A sample driver is provided in the examples subdirectories of the standard Tsentry distribution

Modicon PLC Driver

Expand
titleCapabilities

This driver:

  • Communicates with Modicon (Schneider Automation) TSX Quantum PLC systems

  • Uses TCP/IP Communications over:

    • Standard Ethernet network connection

    • High Speed dedicated process I/O network with deterministic network performance

  • Software implemented as a C++ Class

  • Multiple PLC support

  • Supports:

    • Read Variables

    • Write variables

Capable of running 500ms Input and Output scan rep rates, depending on data buffer size.

Expand
titleModicon PLC Configuration

The Modicon PLC must be set up with the proper IP address.  This configuration is completed with the Schneider Automation software.  The IP must be chosen such that it lies within the subnet selected for the specific Ethernet controller used for communications.

If the Ethernet controller is one that is controlled by the Windows 2000 system, the subnet is specified in the network setup utility of the control panel.

If the Ethernet controller is one that is controlled by the RTX Real-Time TCP/IP controller, the IP address is specified in the file d:\LocNtRt\sys\pif\RtxTcp.ini. 

Enough memory must be installed in the PLC to support the data buffer size that will be requested by the software reads and writes.

Expand
titleSoftware Driver

The core of the driver is provided as a C++ class that implements the initialization and communications functions.  A sample process is provided which calls the appropriate class members.

The IP address, configuration information, and data areas to be read and written are passed as calling parameters to the class functions.

The following is a list of the provided driver files.  After review of the example driver, the user is required to modify the files as indicated:

File Name

Description

Modification

ModPlc.cpp

Driver mainline function

Modify configuration class calls for specific PLC configuration.  Modify locations to read and write data.  Modify input and output datagram structure definition

ModPlcIn.cpp

ModPlc driver initialization

Insert required global common areas. 

PlcUsr.cpp

Process received values from PLC datagram and place in user data variables.

Get application variables and store in datagra for transmission to PLC

Change as required