../pvss.htm menu.gif basics.gif

Data messages

The peripheral address in WinCC OA is composed of the following elements for explicit addressing of data points:

  • Data type

  • Region number (same as that in the SSI message)

  • Component number (same as that in the SSI message)

  • Module number (same as that in the SSI message)

  • Value number (same as that in the SSI message)

  • Subaddress (currently always 0)

  • Index: to discriminate between items of data when a message contains several different items of data.

Since the index in the message constitutes part of the peripheral address, this ensures total flexibility in configuring the individual items of data in a message. Hence the each of the items of data can be combined in one data point, say, or they might form part of a larger data point, or else be distributed amongst several data points.

The index numbers for each telegram are assigned in the driver. They are listed separately under the different messages.

In principle there are several options for assigning WinCC OA data points to messages. The peripheral addresses can be configured at the data point nodes, provided the sheets under this node have the same type (i.e. for all dynamic arrays of data points of the same type, such as a bit pattern structure, bit structure), as well as on the sheets. If the peripheral address is configured at a node, then the index number of the peripheral address specifies the object in the message from which the data is distributed to all other objects on the sheets of the WinCC OA data point. Thus one could for instance distribute 16 individual messages (index 0 to 15) to two data points of type bit structure, each with 6 bits, by specifying the index of the peripheral address as 0 in the data point node of the first data point, and as 6 in the node of the second data point. Incoming messages are then distributed to the sheets of the data points. The six sheets of the first data point receive messages 0-5 (bits), and the sheets of the second data point receive messages 6-11 (also bits). Since the remaining messages (12-15) have not been configured to any WinCC OA data point, they are discarded by the driver.

In addition, indices are introduced for some messages for special handling purposes. For instance it ought to be possible to configure the 16 individual messages jointly on one data point sheet of type bit pattern; the index 20 (for 16 individual messages) has been introduced for this purpose.

Non-real-time messages

These are also called priority-controlled messages. They are not time-based and arrive more quickly than real-time messages.

DF = 01 - Digital value unsigned 32 Bit

The data area of the message contains the following elements:

length

Parameter

4 bytes

unsigned integer (Little Endian)

The value is configured to a dedicated data point in WinCC OA. The corresponding type of the WinCC OA variable is natural number.

SSI label

Index

SSI type

WinCC OA type

Digital value unsigned 32 Bit

0

32 bit unsigned int

natural number

DF = 02 - Digital value signed 32 Bit ( 31 Bit plus VZ )

The data area of the message contains the following elements:

length

Parameter

4 bytes

signed integer (no two's-complement representation)

The value is configured to a dedicated data point in WinCC OA. The corresponding type of the WinCC OA variable is integer.

SSI label

Index

SSI type

WinCC OA type

Digital value signed 32 Bit

0

32 bit signed int

Integer

DF = 03 - Transformer tap position ( digital )

The data area of the message contains the following elements:

length

Parameter

1 byte

Transformer setting

1 byte

(Bit 1: contact indicator, Bit 0: error bit)

It is recommended to configure the three values to a common data point.

SSI label

Index

SSI type

WinCC OA type

Transformer setting

0

8 bit unsigned int

natural number

Error bit

1

bit

Bit

Contact indicator

2

bit

Bit

DF = 04 - Floating Point

The data area of the message contains the following elements:

length

Parameter

4 bytes

floating point in IEEE format

The assigned WinCC OA data point is of type floating point.

Table: The indices and types for "floating point" assigned to the individual items of data.

SSI label

Index

SSI type

WinCC OA type

floating point value

0

32 bit floating point IEEE

floating-point number

DF = 05 - Combination messages

The data area of the message contains the following elements:

length

Parameter

4 byte

signed integer in SSI format

1 byte

for limit messages LI3, LI2, LI1, Li0, 1 bit each

1 byte

for gradient messages GR1 and GR0, 1 bit each

SSI label

Index

SSI type

WinCC OA type

Measurement

0

32 bit signed int

Integer

Limit message LI0

1

bit

Bit

Limit message LI1

2

bit

Bit

Limit message LI2

3

bit

Bit

Limit message LI3

4

bit

Bit

Gradient message GR0

5

bit

Bit

Gradient message GR1

6

bit

Bit

Measurement

10

32 bit signed int

Integer

Limit message

11

byte (4 bits)

Bit pattern

Gradient message

12

byte (2 bits)

Bit pattern

Measurement

20

32 bit signed int

Integer

Limit+gradient

21

byte (6 bits)

Bit pattern

DF = 06 - Computer link formats

The data area of the message contains the following elements:

length

Parameter

8 bytes

(64 bits) transparent data

More precise structuring of the data is not implemented.

SSI label

Index

SSI type

WinCC OA type

Transparent data

0

8 bytes of transparent data

Text

DF = 07 - String

The data area in the message consists of up to 1000 bytes of transparent data. Currently up to 57 bytes are supported. More precise structuring of the data is not implemented.

SSI label

Index

SSI type

WinCC OA type

String (dynamic length)

0

1-1000 data bytes

Text

DF = 08 - Transparent data

The data area of the message contains the following elements:

length

Parameter

8 bytes

transparent data

More precise structuring of the data is not implemented.

SSI label

Index

SSI type

WinCC OA type

Transparent data

0

8 bytes of transparent data

Text

DF = 09 - 16 individual messages

The data area of the message contains the following elements:

length

Parameter

2 bytes

Message bits

  • 2 bytes of invalid bits accompany the message bits

If all the individual messages are mapped onto a bit pattern, the associated invalid bit is obtained from logically ORing the individual invalid bits.

SSI label

Index

SSI type

WinCC OA type

Message 0

0

bit

Bit

Message 1

1

bit

Bit

Message 2

2

bit

Bit

Message 3

3

bit

Bit

Message 4

4

bit

Bit

Message 5

5

bit

Bit

Message 6

6

bit

Bit

Message 7

7

bit

Bit

Message 8

8

bit

Bit

Message 9

9

bit

Bit

Message 10

10

bit

Bit

Message 11

11

bit

Bit

Message 12

12

bit

Bit

Message 13

13

bit

Bit

Message 14

14

bit

Bit

Message 15

15

bit

Bit

All

20

16 bit

bit pattern

DF = 10 - 8 Double messages

The data area of the message contains the following elements:

length

Parameter

2 bytes

Switch settings (2 bits each)

2 bytes

Invalid bits for the switch messages

This message indicates the state of a switch. Each switch state is described by two bits.

D

Z

State

0

1

ON

0

0

OFF

1

0

Intermediate

1

1

Error

If all the messages are mapped onto a bit pattern, the associated invalid bit is obtained from logically ORing the individual invalid bits.

SSI label

Index

SSI type

WinCC OA type

Message Z0

0

bit

Bit

Message D0

1

bit

Bit

Message Z1

2

bit

Bit

Message D1

3

bit

Bit

Message Z2

4

bit

Bit

Message D2

5

bit

Bit

Message Z3

6

bit

Bit

Message D3

7

bit

Bit

Message Z4

8

bit

Bit

Message D4

9

bit

Bit

Message Z5

10

bit

Bit

Message D5

11

bit

Bit

Message Z6

12

bit

Bit

Message D6

13

bit

Bit

Message Z7

14

bit

Bit

Message D7

15

bit

Bit

Message 0

20

2 bit

Bit pattern

Message 1

21

2 bit

Bit pattern

Message 2

22

2 bit

Bit pattern

Message 3

23

2 bit

Bit pattern

Message 4

24

2 bit

Bit pattern

Message 5

25

2 bit

Bit pattern

Message 6

26

2 bit

Bit pattern

Message 7

27

2 bit

Bit pattern

All

30

16 bit

Bit pattern

DF = 11 - 4 Double messages with command feedback

The data area of the message contains the following elements:

length

Parameter

2 bytes

Command feedback messages (4 bits each)

2 bytes

Invalid bits for the command feedback messages

This message is used to return information on the effects of a command. 4 bits describe the state of a switch (relays, NC contacts)

Bit

Bit

Switch state

Z

0

Off

 

1

On (switch state)

D

0

ok

 

1

Switch fault

SF

0

ok

 

1

Z bit changes because of external events (not because of command)

SL

0

defined state

 

1

Z switching between states

SSI label

Index

SSI type

WinCC OA type

Message Z0

0

bit

Bit

Message D0

1

bit

Bit

Message SF0

2

bit

Bit

Message SL0

3

bit

Bit

Message Z1

4

bit

Bit

Message D1

5

bit

Bit

Message SF1

6

bit

Bit

Message SL1

7

bit

Bit

Message Z2

8

bit

Bit

Message D2

9

bit

Bit

Message SF2

10

bit

Bit

Message SL2

11

bit

Bit

Message Z3

12

bit

Bit

Message D3

13

bit

Bit

Message SF3

14

bit

Bit

Message SL3

15

bit

Bit

Message 0

20

4 bit

Bit pattern

Message 1

21

4 bit

Bit pattern

Message 2

22

4 bit

Bit pattern

Message 3

23

4 bit

Bit pattern

All

30

16 bit

Bit pattern

If all the messages are mapped onto a bit pattern, the associated invalid bit is obtained from logically ORing the individual invalid bits.

 

DF = 12 - 1 Individual data point message

The data area of the message contains the following elements:

length

Parameter

1 byte

Feedback message (4 bits, 0 to 3)

SSI label

Index

SSI type

WinCC OA type

Message Z

0

bit

Bit

Message D

1

bit

Bit

Message SF

2

bit

Bit

Message SL

3

bit

Bit

Total message

10

4 bit

Bit pattern

DF = 13 Command

The data area of the message contains the following elements:

length

Parameter

1 bytes

Command number

1 bytes

Switching time

This message constitutes the pulse command of the SSI protocol. It contains a single command. A relay (switch) is switched for the given switching time, and then returns to an idle state. Normally two different command numbers would be required to switch a peripheral device between "ON" and "OFF". Unlike the usual data formats, data points of type pulse command must be signaled to the Event Manager by means of a single registration (in the command direction). All other data points are registered as a group. Provided the peripheral address is configured in the configuration panel then the correct form of registration will be set automatically. If configuration is from ASCII files, however, then the attribute address.._mode must be set to 5 (= single registration) for these commands, and to 1 (in the command direction) or 2 (in the message direction) for all other commands.

The message contains the switching time in addition to the command number. The switching time is coded in a byte, where the individual bits have the following meaning:

Time (bits 0 and 1)

0 for 50 ms, 1 for 500 ms, 10 for 1 sec, 11 for 10 sec.

Factor (bits 2-6)

1...31 switching time = time x factor

OW (bit 7)

1... overwrites command already running

 

0...Overwriting not permitted

The switching time can be specified in two different ways. For most commands it is adequate to use a system-wide switching time that applies to all commands. A default value for the switching time is provided for this purpose in the SSI driver. This can be set using the defaultImpulseTime entry in the configuration file (see chapter on Configuration file entries). If this entry does not appear, then 8 is used by default (equals 100 mS). If other switching times need to be set for individual commands, then these can be specified in the data point _SSI_Impulse_Times (this contains a dynamic array of bit patterns in which the required switching times can be set - the simplest way of doing this is in the Pulse times panel of the Peripheral address panel). In order to then assign a switching time from this array to a command data point, the index for this switching time in the _SSI_Impulse_times data point is added to the peripheral address as an extension to the data type (separated by a colon). One should note that this extra index is only allowed for data points of type command.

IconExample

The peripheral address 13:2.255.3.4.1.0 assigns to the data point the switching time contained in the second array item of the _SSI_Impulse_Time data point.

SSI label

Index

SSI type

WinCC OA type

Command 0

0

coded in bytes.

Bit

Command 1

1

coded in bytes.

Bit

Command 2

2

coded in bytes.

Bit

Command 3

3

coded in bytes.

Bit

Command 4

4

coded in bytes.

Bit

Command 5

5

coded in bytes.

Bit

Command 6

6

coded in bytes.

Bit

Command 7

7

coded in bytes.

Bit

Command 8

8

coded in bytes.

Bit

Command 9

9

coded in bytes.

Bit

Command 10

10

coded in bytes.

Bit

Command 11

11

coded in bytes.

Bit

Command 12

12

coded in bytes.

Bit

Command 13

13

coded in bytes.

Bit

Command 14

14

coded in bytes.

Bit

Command 15

15

coded in bytes.

Bit

 

Real-time messages

For every priority-controlled message there is an equivalent real-time message. This contains a 5-byte time field in front of the data, indicating the time the supplied data was generated. This time information has the following format:

length

Parameter

2 bytes

milliseconds (lower significant byte of the msec before the higher significant byte)

1 bytes

seconds

1 bytes

minutes

1 bytes

hours (24 hour format)

DF = 101 Digital value unsigned 32 Bit with time

This message otherwise has the same action as the analog NEZ message.

DF = 102 Digital value signed 32 Bit ( 31 Bit plus VZ ) with time

This message otherwise has the same action as the analog NEZ message.

DF = 03 - Transformer tap position ( digital ) with time

This message otherwise has the same action as the analog NEZ message.

DF = 104 Floating point with time

This message otherwise has the same action as the analog NEZ message.

DF = 105 Combination message with time

This message otherwise has the same action as the analog NEZ message.

DF = 106 Computer link formats with time

This message otherwise has the same action as the analog NEZ message.

DF = 107 String with time

This message otherwise has the same action as the analog NEZ message.

DF = 108 Transparent data with time

This message otherwise has the same action as the analog NEZ message.

DF = 109 16 Single messages with time

This message otherwise has the same action as the analog NEZ message.

DF = 110 8 Double messages with time

This message otherwise has the same action as the analog NEZ message.

DF = 111 4 Double messages with command feedback with time

This message otherwise has the same action as the analog NEZ message.

DF = 112 1 Single data point message with time

This message otherwise has the same action as the analog NEZ message.

DF = 113 Command with time

This message otherwise has the same action as the analog NEZ message.

Top Of Page

 

V 3.11 SP1

Copyright ETM professional control GmbH 2013 All Rights Reserved