Defining the Peripheral Address

This chapter describes the definition of peripheral addresses for the SECS driver.

Click on the "_address" config of a DPE, select the driver type SECS and click on Configure... to open the following panel.

Reference

Address reference definition depends on the type of data which is gathered or sent. The driver supports direct collection of alarms, events and traces via a specific address reference scheme. Also, status variables and device constants have a separate address reference to read/write them onto specified DPEs. In addition to that, every E5-Message can be sent/received via Input or Output address references. When using full E5 messages as JSON-strings to request and/or respond, the addresses of Input and Output configs must be the same reference string to map the request/response to each other. The address schemes are described in the following tables.

Arbitrary E5-Message - Direction Host to Device

When the host sends any arbitrary request to the device, an address reference as described in the following table must be used.

Address-reference scheme Example Transformation Description
HREQ.<number> HREQ.231 string The host sends a request via JSON-string to the device. The number in the reference can be chosen arbitrarily.

Arbitrary E5-Message - Direction Device to Host

Any request from the device to the host has a reserved address reference which needs to be used to gather the request and respond to it.

Address-reference scheme Example Transformation Description
EREQ.<x>.<y> EREQ.7.3 string x and y are the numbers corresponding to the E5 stream (x) and function (y). This example receives the stream 7 with function 3. This address reference scheme is used to map any arbitrary request from the equipment to the host. The host must answer this request with the corresponding E5 response message.

Status Variables and Device Constants

Status Variables - by the definition in the SEMI E5 Standard - are read-only so they can only be used with the “Input” address direction. Device Constants - by the definition in the SEMI E5 Standard are read/write so they can be used with “Input”, “Output” or “In/Out” address direction. For reading the variable/constant value, spontaneous input, polling or single query can be used.

Address-reference scheme Example Transformation Description
SVID.<SVID> SVID.250 all DPEs with this address reference get set by the driver after a S1F3R request which contains the SVID (Status Variable Identifier) from the address reference. From the response (S1F4) the status variable values are written to the _original_value of the DPEs with corresponding address references.
ECID.<ECID> ECID.220 all DPEs with this address reference get set by the driver after a S2F13R request which contains the ECID (Equipment Constant Identifier) from the address reference. From the response (S2F14) the equipment constant values are written to the _original_value of the DPE with corresponding address references. When setting the _original_value of DPEs with this address reference and direction “In/Out” or “Output” via dpSet or in the para, the driver creates and sends a S2F15R request to change the value on the equipment.

Event, Alarm, Trace

Alarms, Events and Traces sent by the equipment: The address-reference must be according to the E5 message type you want to receive on the configured DPE and need direction “Input”.

Address-reference scheme Example Transformation Description
CEID.<CEID> CEID.4001 string S6F11 and S6F13 are automatically written to a DPE with an address-reference like this. The <CEID> must match the according collection event ID that should be captured on this DPE.
ALID.<ALID> ALID.1001 string S5F1 is automatically written to a DPE with an address-reference like this. The <ALID> must match the according alarm ID that should be captured on this DPE.
TRID.<TRID> TRID.6000 string S6F1 is automatically written to a DPE with an address-reference like this. The <TRID> must match the according trace ID that should be captured on this DPE.

Alarm

To map alarms from the equipment in WinCC OA different DPEs can be used, and two different alarm address-references are implemented.

DPE-Type Address-reference scheme Example Description
String ALID.<ALID> ALID.1000 S5F1, S5F6 and S5F8 are automatically written to a string DPE with an address-reference like this. The <ALID> must match the according alarm ID and the JSON string of the S5F1 message should be captured on this DPE.
Uint, Integer, Float, Bool ALID_A.<ALID> ALID_A.1000 S5F1, S5F6 and S5F8 is automatically written to a uint, int, float or bool DPE with an address-reference like this to map equipment alarms to WinCC OA alarms. The <ALID> must match the according alarm ID that should be captured on this alarm. The direction should be set to “Alert”.

Connection

Holds the name of the connection.

Driver number

Defines the number to which driver this address belongs to.

Reference Prefix

The reference prefix describes the type of address reference that is configured. Via this combo box, the address type can be changed in the reference string. The following prefixes are available:

  • HREQ
  • EREQ
  • CEID
  • TRID
  • ALID
  • ALID_A
  • ECID
  • SVID

Reference Nr. 1

The use of the first reference number depends on the configured reference prefix. The following table describes the usage:

Prefix Usage
HREQ User defined ID to match the request output address to the response input address
EREQ Equipment request E5 stream number. The function number can be configured via the “Reference Nr. 2”
CEID Collection Event ID of the equipment event
TRID Trace ID of an defined equipment trace
ALID Alarm ID of an equipment alarm
ALID_A Alarm ID of an equipment alarm
ECID Equipment Constant ID
SVID Status Variable ID

Reference Nr. 2

The second reference number is only available for the “EREQ” reference prefix. Here it is used to describe the function number of the equipment request which should be received on the DPE.

Transformation

The following transformations are available:

  • string
  • binary
  • bool
  • int 64
  • int 32
  • int 16
  • int 8
  • uint 64
  • uint 32
  • uint 16
  • uint 8
  • float 64
  • float 32

DPEs for receiving and/or sending full E5 messages must use “string”. Receiving status variable values and receiving/sending equipment constant values must use the corresponding data type as transformation. The DPE where the address is defined must match the transformation data type. For receiving multi-instance alerts, the transformation is disabled.

Direction

Output
Use when sending a E5 message or Equipment Constant value to the equipment
Input
Use when receiving E5 message, Alarm, Event, Trace, Status Variable value or Equipment Constant value from equipment
In/Out
Use when sending or receiving Equipment Constant values
Alert
Use on uint, int, float or bool DPE to map SECS-II alarm to WinCC OA alarms

Receive mode

Specifies how input values should be received:

Spontaneous
Use when receiving values or E5 messages spontaneously.
Polling
Specify a poll group which polls the required value in the specified time interval.
Single query
Values gets queried when a single query is triggered.

Low level comparison

Specifies if an old/new comparison should be made before the value gets written to the _original.._value .