IPS for Beckhoff ADS

Configuration File

ADS-IPS uses a configuration file named ADSIPS.INI. This file must reside in the default (working) folder

ADSIPS.INI is a text file, that you may create and edit using Notepad. You may also access it via a menu shortcut on the ADS-IPS menu bar (under File).

ADSIPS.INI is divided into sections. Each section starts with the name of the section between square brackets.

The following sections are defined at the moment:

[PORT]
[UNET]
[DRIVER]
[WATCHDOG]

Within each section, you define parameters using a 'key' followed by the "=" sign and followed by one or more alpha-numeric arguments.

Parameters within the section may be arranged in any order.

Multiple arguments must be separated by spaces, a dot, or a comma.

A comment line starts with "/".

The following keys are defined at the moment:

Section: [PORT]

Parameter

Description

Default value

COM

Sets the COM port used.
The COM may be TCP or UDP.
TCP and UDP use port 48898

COM=TCP

Section: [UNET]

NODE

The identifier for this IPS on the UDP (UNET) network.

NODE=1

RESET

The index of the register in the data table that will be used for remote reset. Writing to this register causes the IPS to re-read the configuration file.

None. No reset register.

SNAP

The index of the register in the data table that will be used for remote protocol capture. Writing 1 to this register causes the IPS to produce a capture file. It is equivalent to clicking TRACE -> Capture.

None. No snapshot register.

The following keys are defined at the moment:

Section: [DRIVER]

TIMEOUT

The time in milliseconds that this station will wait for a response before trying again.

TIMEOUT=250

ENABLE

This parameter decides how the "ENABLE" registers operate for cluster of points. If ENABLE=0, the cluster communicates as long as its ENABLE register is on. If ENABLE=1, the cluster triggers a communication when the ENABLE register is turned on and automatically turns the ENABLE register off when the communication is confirmed by the station
.

ENABLE=0

REMOTE

Specifies the IP of a remote ADS module connected to this TCP/IP interface. Each remote is defined by 5 decimal numbers. The first number is the UNET node id. The next 4 are the IP of that station.

You may include up to 64 "REMOTE" lines in the file.

No remote station defined

Defines a cluster of binary registers to be received from a remote station. Each "DI" definition consists of 6 numbers. You may include up to 64 DI definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station the data will be coming from.

POS

the index of the first variable at the MODBUS station.

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

the index of the register at the IPS to trigger the transfer
When this register is set to 1, the transfer is initiated. If the ENABLE parameter is set to 1, once the transfer is confirmed by the station, this register is set to 0.
R0001 (index 0) may not be used as a ENABLE register. If ENABLE is 0, the cluster communicates continuously.

No DI cluster

Defines a cluster of registers to be received from a remote station. Each channel consists of 2 registers A registers at an even index is the STATUS of the corresponding channel, while a registers at an odd index is the VALUE of the corresponding channel. Each "RI" definition consists of 6 numbers. You may include up to 64 RI definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station that the values will be coming from.

POS

the index of the first register at the station.

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

No RI cluster

Defines a cluster of binary registers to be received from a remote station. Each "DI" definition consists of 6 numbers. You may include up to 64 "DO" definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station the data will be coming from (source).

POS

the index of the first variable at the MODBUS station.

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

No DO cluster

Defines a cluster of registers to be sent to a remote station. Each channel consists of 2 registers A registers at an even index is the CONTROL of the corresponding channel, while a registers at an odd index is the OUTPUT of the corresponding channel. Each "RO" definition consists of 6 numbers. You may include up to 64 "RO" definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station that the values will be coming from.

POS

the index of the first register at the station.

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

No RO cluster

READ

Defines a cluster of registers - usually one register - to be read from a ADS PLC device. The address of the register in the device is defined by a GROUP and an OFFSET that you obtain from the "pty" file (XML document) created when you download your configuration to the PLC. The Group and OFFSET are 32-bit quantities (in the range of 0 to 2**32-1). Since we use 16 bit parameters (in the range of 0 to 65535), we use 2 numbers for the OFFSET and 2 numbers for the GROUP. The Low component is the least significant part and the high component is the most significant part.
Example:
To represent an OFFSET of 98352, we use OFFSET-High=1 and OFFSET-Low=32816
(98352=1*65536+32816)
Each "READ" definition consists of 11 numbers. You may include up to 64 "READ" definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE, OFFSET-High, OFFSET-Low, GROUP-High, GROUP-Low, TYPE

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station that the values will be coming from.

POS

Not used

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

OFFSET - High

the high part of the OFFSET parameter

OFFSET - Low

the low part of the OFFSET parameter

GROUP - High

the high part of the GOUP parameter

GROUP - Low

the low part of the GROUP parameter

TYPE

Set to 0 to receive each value as a 16-bit integer. Set to 1 to receive each value as a short real number (32 bit floating point) - each value reads two consecutive MODBUS registers. Set to 2 to receive each value as a signed integer (2's complement).

No READ cluster

WRITE

Defines a cluster of registers - usually one register - to be written to a ADS PLC device. The address of the register in the device is defined by a GROUP and an OFFSET that you obtain from the "pty" file (XML document) created when you download your configuration to the PLC. The Group and OFFSET are 32-bit quantities (in the range of 0 to 2**32-1). Since we use 16 bit parameters (in the range of 0 to 65535), we use 2 numbers for the OFFSET and 2 numbers for the GROUP. The Low component is the least significant part and the high component is the most significant part.
Example:
To represent an OFFSET of 98352, we use OFFSET-High=1 and OFFSET-Low=32816
(98352=1*65536+32816)
Each "WRITE" definition consists of 11 numbers. You may include up to 64 "READ" definitions in the file.

FIRST, QTY, NODE, POS, ALERT, ENABLE, OFFSET-High, OFFSET-Low, GROUP-High, GROUP-Low

FIRST

the index of the first register of the block at the requesting IPS.

QTY

the number of registers to transfer, starting at and including the first register. The maximum number of register values that may be transferred is 16 per block.

NODE

the id of the station that the values will be coming from.

POS

Not used

ALERT

the index of the register to be set in case a communication error or time-out occurs when this particular block is transferred

ENABLE

OFFSET - High

the high part of the OFFSET parameter

OFFSET - Low

the low part of the OFFSET parameter

GROUP - High

the high part of the GOUP parameter

GROUP - Low

the low part of the GROUP parameter

TYPE

Set to 0 to send each value as a 16-bit integer. Set to 1 to receive each value as a short real number (32 bit floating point) - each value reads two consecutive MODBUS registers. Set to 2 to receive each value as a signed integer (2's complement).

No WRITE cluster

Section: [WATCHDOG]

ACTIVE

Enable/Disable the watchdog. When enabled, all the outputs turn off after a delay when the IPS no longer receives commands from a RTES32.

ACTIVE=1

TIME

The delay in milliseconds after which the outputs turn off when the watchdog is enabled.

TIME=1000.

Application Notes

Beckhoff BK9000

Each module presents 8 inputs and 8 outputs. A read operation (RI) reads the inputs. A write operation (RO) writes the outputs.

The 8 inputs of the first module are mapped as:
index 0 - position 1 status
index 1 - position 1 value
index 2 - position 2 status
index 3 - position 2 value
index 4 - position 3 status
index 5 - position 3 value
index 6 - position 4 status
index 7 - position 4 value
The 8 inputs of the next module will start at index 8, and so on.
'status' is a byte(0 to 255), 'value' is a word (0 to 65535)

The 8 outputs of the first module are mapped as:
index 0 - position 1 control
index 1 - position 1 output
index 2 - position 2 control
index 3 - position 2 output
index 4 - position 3 control
index 5 - position 3 output
index 6 - position 4 control
index 7 - position 4 output
The 8 outputs of the next module will start at index 8, and so on.
'control' is a byte(0 to 255), 'output' is a word (0 to 65535)

Example: RI=100,16,r,0,a,0 /will continuously read the 8 inputs from the 1st and 2nd modules of a BK9000 at REMOTE r (a=ALERT Reg.)
RO=200,16,r,0,a,0 /will continuously write the 8 outputs from the 1st and 2nd modules of a BK9000 at REMOTE r

You may read the inputs from a 3rd module with:
RI=116,8,r,16,a,0
or write the outputs to a 3rd module with:
RO=216,8,r,16,a,0

Once you have the input and outpt images in the data table of the ADS-IPS, you may then configure RTES32 to selectively read from the ADS-IPS and write to the ADS-IPS. For example, (continuing on the example above) you may read the 4 analog input values from the 2nd module of the BK9000 into RTES32 R1001 to R1004, with the folowing lines in RTES32.INI:
FLOAT=1000,1,u,109,a,0
FLOAT=1001,1,u,111,a,0
FLOAT=1002,1,u,113,a,0
FLOAT=1003,1,u,115,a,0

u is the UNET node id of the ADS-IPS
a is the index of a RTES32 register used as ALERT