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.
Example
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.