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

DI

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

RI

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

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 RI cluster

DO

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

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 DO cluster

RO

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

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 RO 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