View source for OPCServer:Variable Syntax

== Variable Syntax ==

One of the special features of the '''''IBH OPC Server''''' is to allow direct use of the absolute PLC Variables without declaration. It is also possible to use symbolic addressing as defined in the PLC program (Symbolic Table). Even variables used in S7 Data Blocks can be accessed via the '''''IBH OPC Server''''' with their symbolic names. These features eliminate the need of double declarations.
 

To do so, the PLC program is assigned with the '''''IBH OPCEditor''''' to the PLCName and the required variables are selected within the user interface.


Addressing of variables with absolute addresses in the '''''IBH OPC Server''''' is done by using the Simatic® Step®7 or Simatic® Step®5 syntax. Please note that REAL values (Double Word Format ) in S7 must be declared symbolic in order to have the correct format information. If this is not the case, the SCADA application must do the conversion of the &quot;Long variable in the REAL format&quot; into the correct &quot;REAL format&quot;.


The '''''IBH OPC Server''''' supports 3 notations for variables.

* Symbolic from the PLC project (Variables are selected via the '''''IBH OPCEditor''''')
* SIMATIC® S7 notation
* SIMATIC® S5 notation


When using absolute addresses from the OPC client, also a mixed S5/S7 notation is possible.


The syntax is always PLCName.VariableName respectively PLCName.DataBlockName.StructureElement.VariableName. A Variable must always begin with the PLCName. If the variables have been selected individually via the '''''IBH OPCEditor''''', the variables can be conviniently browsed from the OPC client.


The configuration of the PLC itself must always be done via the '''''IBH OPCEditor''''', regardless whether absolute or symbolic addressing is to be used. A shortcut to the '''''IBH OPCEditor''''' is installed on your PC.




== Common Syntax for S5 and S7: ==

<table>
{| border="1"
<tr class="odd">
<td align="left">'''Operand'''</td>
<td align="left">'''Bereich'''</td>
<td align="left">'''Datentyp'''</td>
</tr>
<tr class="even">
<td align="left">En.n</td>
<td align="left">Inputbits (2)</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="odd">
<td align="left">EBn</td>
<td align="left">Inputbytes (1)</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">EWn</td>
<td align="left">Inputwords (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="odd">
<td align="left">EDn</td>
<td align="left">Inputdoublewords (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="even">
<td align="left">ETn[Stringlength]</td>
<td align="left">Text from the input area (3)</td>
<td align="left">Character Array (VT_BSTR)</td>
</tr>
<tr class="odd">
<td align="left">An.n</td>
<td align="left">Outputbits (2)</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="even">
<td align="left">ABn</td>
<td align="left">Outputbytes (1)</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="odd">
<td align="left">AWn</td>
<td align="left">Outputwords (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="even">
<td align="left">ADn</td>
<td align="left">Outputdoublewords (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="odd">
<td align="left">ATn[Stringlength]</td>
<td align="left">Text from the output area (3)</td>
<td align="left">Character Array (VT_BSTR)</td>
</tr>
<tr class="even">
<td align="left">Mn.n</td>
<td align="left">Flagbits (2)</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="odd">
<td align="left">MBn</td>
<td align="left">Flagbytes (1)</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">MWn</td>
<td align="left">Flagwords (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="odd">
<td align="left">MDn</td>
<td align="left">Flagdoublewords (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="even">
<td align="left">MTn[Stringlength]</td>
<td align="left">Text from the flag area (3)</td>
<td align="left">Character Array (VT_BSTR)</td>
</tr>
</table>

== Syntax for S5: ==

<table>
{| border="1"
<tr class="odd">
<td align="left">'''Operand'''</td>
<td align="left">'''Bereich'''</td>
<td align="left">'''Datentyp'''</td>
</tr>
<tr class="even">
<td align="left">Dn.n,nr</td>
<td align="left">Databits, DB</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="odd">
<td align="left">DRn,nr</td>
<td align="left">Right Databyte, DB</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">DLn,nr</td>
<td align="left">Left Databyte, DB</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="odd">
<td align="left">DWn,nr</td>
<td align="left">Dataword, DB (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="even">
<td align="left">DSn,nr</td>
<td align="left">Dataword, DB (1)</td>
<td align="left">Signed short Integer (VT_I2)</td>
</tr>
<tr class="odd">
<td align="left">DDn,nr</td>
<td align="left">Datadoubleword, DB (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="even">
<td align="left">DVn,nr</td>
<td align="left">Datadoubleword, DB (1)</td>
<td align="left">Signed long integer (VT_I4)</td>
</tr>
<tr class="odd">
<td align="left">DFn,nr</td>
<td align="left">Datadoubleword, DB (1)</td>
<td align="left">Float (VT_R4)</td>
</tr>
<tr class="even">
<td align="left">DTn,nr[Stringlength]</td>
<td align="left">Text from a datablock (3)</td>
<td align="left">Character Array (VT_BSTR)</td>
</tr>
<tr class="odd">
<td align="left">DXn.n,nr</td>
<td align="left">Databits, DX</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="even">
<td align="left">DXRn,nr</td>
<td align="left">Right Databyte, DX</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="odd">
<td align="left">DXLn,nr</td>
<td align="left">Left Databyte, DX</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">DXWn,nr</td>
<td align="left">Dataword, DX (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="odd">
<td align="left">DXSn,nr</td>
<td align="left">Dataword, DX (1)</td>
<td align="left">Signed short Integer (VT_I2)</td>
</tr>
<tr class="even">
<td align="left">DXDn,nr</td>
<td align="left">Datadoubleword, DX (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="odd">
<td align="left">DXVn,nr</td>
<td align="left">Datadoubleword, DX (1)</td>
<td align="left">Signed long integer (VT_I4)</td>
</tr>
<tr class="even">
<td align="left">DXFn,nr</td>
<td align="left">Datadoubleword, DX (1)</td>
<td align="left">Float (VT_R4)</td>
</tr>
<tr class="odd">
<td align="left">DXTn,nr[Stringlength]</td>
<td align="left">Text from a DX datablock (3)</td>
<td align="left">Character Array (VT_BSTR</td>
</tr>
<tr class="even">
<td align="left">Sn.n</td>
<td align="left">S-Flagbits (2)</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="odd">
<td align="left">SYn</td>
<td align="left">S-Flagbytes (1)</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">SWn</td>
<td align="left">S-Flagwords (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="odd">
<td align="left">SSn</td>
<td align="left">S-Flagwords (1)</td>
<td align="left">Signed short Integer (VT_I2)</td>
</tr>
<tr class="even">
<td align="left">SDn</td>
<td align="left">S-Flagdoublewords (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="odd">
<td align="left">SVn</td>
<td align="left">S-Flagdoublewords (1)</td>
<td align="left">Signed long integer (VT_I4</td>
</tr>
<tr class="even">
<td align="left">SFn</td>
<td align="left">S-Flagdoublewords (1)</td>
<td align="left">Float (VT_R4)</td>
</tr>
<tr class="odd">
<td align="left">STn[Stringlength]</td>
<td align="left">Text from the extended flag area (3)</td>
<td align="left">Character Array (VT_BSTR</td>
</tr>
</table>

== Syntax for S7: ==

<table>
{| border="1"
<tr class="odd">
<td align="left">'''Operand'''</td>
<td align="left">'''Bereich'''</td>
<td align="left">'''Datentyp'''</td>
</tr>
<tr class="even">
<td align="left">DBn.DBXn.n</td>
<td align="left">DB, Databits (2)</td>
<td align="left">Bool (VT_BOOL)</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBBn</td>
<td align="left">DB, Databyte (1)</td>
<td align="left">Unsigned Byte (VT_UI1)</td>
</tr>
<tr class="even">
<td align="left">DBn.DBCn</td>
<td align="left">DB, Databyte (1)</td>
<td align="left">Signed Byte (VT_I1)</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBWn</td>
<td align="left">DB, Dataword (1)</td>
<td align="left">Unsigned Word (VT_UI2)</td>
</tr>
<tr class="even">
<td align="left">DBn.DBSn</td>
<td align="left">DB, Dataword (1)</td>
<td align="left">Signed Word (VT_I2)</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBDn</td>
<td align="left">DB, Datadoubleword (1)</td>
<td align="left">Unsigned DWord (VT_UI4)</td>
</tr>
<tr class="even">
<td align="left">DBn.DBVn</td>
<td align="left">DB, Datadoubleword (1)</td>
<td align="left">Signed DWord (VT_I4</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBRn</td>
<td align="left">DB, Real (1)</td>
<td align="left">Real (VT_R4)</td>
</tr>
<tr class="even">
<td align="left">DBn.DBLn</td>
<td align="left">DB, LongLong (64 Bit) (1)</td>
<td align="left">LONGLONG (VT_I8)</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBUn</td>
<td align="left">DB, ULongLong (64 Bit) (1)</td>
<td align="left">ULONGLONG (VT_UI8)</td>
</tr>
<tr class="even">
<td align="left">DBn.DBZn</td>
<td align="left">DB, S7 - DATE_AND_TIME (1)</td>
<td align="left">Date (VT_DATE)</td>
</tr>
<tr class="odd">
<td align="left">DBn.DBTn[Stringlength]</td>
<td align="left">Text from a datablock (3)</td>
<td align="left">Character Array (VT_BSTR)</td>
</tr>
</table>


1) For these operands the suffix [Count] may be added to read/write arrays. Example: PLCName.DB10.DBB2[5] reads 5 bytes starting from DBB2. PLCName.MW4[7] reads 7 Words starting from the MW4.


2) For bit operands also the suffix [Count] may be added to read/write arrays. Arrays of boolean must always start with Bit 0 within the byte. Example: PLCName.DB10.DBX2.0[5] reads 5 Bits starting from DBX2.0. PLCName.M4.0[7] reads 7 Bits starting from M4.0. A variable like PLCName.M4.3[4] is not permitted. When writing boolean arrays, always the entire byte is written.


3) If strings are entered in absolute notation, there is no verification whether it is a declared string. In S7 PLCs, strings have 2 leading bytes with additional information regarding the string, the declared length and the current length. Since this information lacks in absolute notation, strings are treated as pure character arrays of the length entered in [Stringlength]. If in a write operation the text is shorter as the length enterd in [Stringlength], the rest is filled up with zeroes.


The 'signed' datatypes also exist for the S7. Normally, we assume that the type will be set via the configuration tool '''''IBH OPCEditor'''''.

== Addressing the DB of a S7-200: ==

The syntax for the 200 equals the S7-300 syntax. To access a variable byte of the data block in S7-300 syntax you need to type: VB 2 (S7-200) = DB1.DBB2 (S7-300). The data block is always the DB1. A variable word VW 2 (S7-200) = DB1.DBW2 (S7-300). A variable doubleword VD 2 (S7-200) = DB1.DBD2 (S7-300).