View source for S7-SoftPLC:ADDI-DATA configuration

The ADDI-DATA-driver allows to access Digital I/O and Analog I/O cards from the PLC-program of ''S7-SoftPLC''. With the ADDI-PACK software the physical IO-cards are mapped into a single virtual card. It can be accessed over functions (FC-blocks), which need to be called from the PLC-program. A cyclic data exchange over the process image does not make sense, due to the ADDI-DATA functions infrastructure.

'''Requirements'''

* The interface card has to be installed on the computer.
* The adequate drivers of ADDI-DATA have to be installed.
* The software ADDIPACK has to be installed and correctly licenced.
* The interface card has to be configured in the ADDI-PACK.<br />
 (if there are any problems, please contact the ADDI-DATA documentation and/or the ADDI-DATA support.)
* The &quot;ADDI-DATA PC-Card&quot; driver has to be selected in ''S7-SoftPLC''.

=== Accessing the I/O card ===

The FC-blocks, installed by the driver in ''S7-SoftPLC,'' represent functions of the ADDIDATA.DLL provided by ADDI-DATA. These functions are transparently mapped as FC-blocks into the PLC-program. For detailed information please read the adequate documentation of ADDI-DATA. The parameter &quot;dw_DriverHandle&quot; described in the ADDI-DATA documentation is not required, because the ''S7-SoftPLC'' driver takes care of opening and closing the ADDI-DATA driver as well as passing the &quot;dw_DriverHandle&quot; to the ADDI-DATA functions.


'''Read8DigitalInputs:'''

Corresponds to the function &quot;b_ADDIDATA_Read8DigitalInputs (DWORD dw_DriverHandle, BYTE b_Port, PBYTE pb_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 100 
|-
|style="width:7em"|  INO ||style="width:10em"|  := B#16#0 ||  //b_Port
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|-
| OUT1 || := MB 2 || //pb_PortValue
|}
</code>


The parameter IN0 corresponds to the ADDI-DATA parameter b_Port. The parameter OUT1 corresponds to the ADDI-DATA parameter pb_PortValue. The driver itself takes care of the dw_DriverHandle. The result of the function is returned in RET_VAL. This scheme applies to every driver function.


'''Read16DigitalInputs:'''

Corresponds to the function &quot;b_ADDIDATA_Read16DigitalInputs(DWORD dw_DriverHandle, BYTE b_Port, PWORD pw_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 101 
|-
|style="width:7em"| INO ||style="width:10em"| := B#16#0 || //b_Port
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|-
| OUT1 || := MB 2 || //pw_PortValue
|}
</code>


'''Read32DigitalInputs:'''

Corresponds to the function &quot;b_ADDIDATA_Read32DigitalInputs(DWORD dw_DriverHandle, BYTE b_Port, PDWORD pdw_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 102 
|-
|style="width:7em"| INO ||style="width:10em"| := B#16#0 || //b_Port
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|-
| OUT1 || := MD 2 || //pdw_PortValue
|}
</code>


'''Set8DigitalOutputs:'''

Corresponds to the function &quot;b_ADDIDATA_Set8DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, BYTE b_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 103 
|-
|style="width:7em"| INO ||style="width:10em"| := B#16#0 || //b_Port
|-
| IN1 || := B#16#0 || //b_PortValue
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>


'''Set16DigitalOutputs:'''

Corresponds to the function &quot;b_ADDIDATA_Set16DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, WORD w_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 104 
|-
|style="width:7em"| INO ||style="width:10em"| := B#16#0 || //b_Port
|-
| IN1 || := B#16#0 || //w_PortValue
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>



'''Set32DigitalOutputs:'''

Corresponds to the function &quot;b_ADDIDATA_Set32DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, DWORD dw_PortValue)&quot;.

Request:

<code>
{|
|-
| CALL || FC 105 
|-
|style="width:7em"| INO ||style="width:10em"| := B#16#0 || //b_Port
|-
| IN1 || := DW#16#0 || //dw_PortValue
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>



'''InitAnalogInput:'''

Corresponds to the function &quot;b_ADDIDATA_InitAnalogInput(DWORD dw_DriverHandle, WORD w_Channel, pstr_InitAnalogInput ps_InitParameters, DWORD dw_StructSize)&quot;.

This function requires a data structure for the initialisation of an input (see card documentation). The structure is passed to the FC with an ANY-pointer of the type byte (ps_InitParameters). A seperate parameter for length of the structure (dw_StructSize) is not neccessary, it is taken from the ANY-pointer.

Request:

<code>
{|
|-
| CALL || FC 106 
|-
|style="width:7em"| INO ||style="width:10em"| := W#16#0 || //w_Channel
|-
| IN1 || := P#M 8.0 BYTE 10 || //ANY-pointer to structure
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>



'''ReleaseAnalogInput:'''

Corresponds to the function &quot;b_ADDIDATA_ReleaseAnalogInput(DWORD dw_DriverHandle, WORD w_Channel)&quot;.

Request:

<code>
{|
|-
| CALL || FC 107 
|-
|style="width:7em"| INO ||style="width:10em"| := W#16#0 || //w_Channel
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>



'''InitAnalogOutput:'''

Corresponds to the function &quot;b_ADDIDATA_Init1AnalogOutput(DWORD dw_DriverHandle, WORD w_Channel, BYTE b_VoltageMode, BYTE b_Polarity)&quot;.

Request:

<code>
{|
|-
| CALL || FC 108 
|-
|style="width:7em"| INO ||style="width:10em"| := W#16#0 || //w_Channel
|-
| IN1 || := B#16#0 || //b_VoltageMode
|-
| IN2 || := B#16#0 || //b_Polarity
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>


'''ReadAnalogInput:'''

Corresponds to the function &quot;b_ADDIDATA_Read1AnalogInput(DWORD dw_DriverHandle, WORD w_Channel, DWORD dw_ConvertingTime, BYTE b_ConvertingTimeUnit, BYTE b_InterruptFlag, PDWORD pdw_ChannelValue)&quot;.

The function requires a pointer to the return value (see card documentation). The structure is passed to the FC with an ANY-Pointer of the type dword (pdw_ChannelValue). Please note, that the ANY-Pointer always has to have the length of DWORD 3 (12 byte).

The parameter b.InterruptFlag is not used, because it runs in polling-mode only.

Request:

<code>
{|
|-
| CALL || FC 109 
|-
|style="width:7em"| INO ||style="width:10em"| := W#16#0 || //w_Channel
|-
| IN1 || := DW#16#0 || //dw_ConvertingTime
|-
| IN2 || := B#16#0 || //b_ConvertingTimeUnit
|-
| IN3 || := P#M4.0 DWORD 3 || //ANY-Pointer to result
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>


'''WriteAnalogOutput:'''

Corresponds to the function &quot;b_ADDIDATA_Write1AnalogOutput(DWORD dw_DriverHandle, WORD w_Channel, dw_ValueToWrite)&quot;.

Request:

<code>
{|
|-
| CALL || FC 110 
|-
|style="width:7em"| INO ||style="width:10em"| := W#16#0 || //w_Channel
|-
| IN1 || := DW#16#0 || //dw_ValueToWrite
|-
| RET_VAL || := MW 0 || //RET_VAL error code
|}
</code>

=== Return values: ===

On success RET_VAL = 0 is returned.

If an error has occurred, the error code from ADDIDATA.DLL is passed through, if possible.

If it should not be possible, the following error codes are returned:

{| class="wikitable"
|-
! Error code !! Reason 
|-
| 0x807F || DriverHandle not available 
|-
| 0x8042 || Error reading input
|-
| 0x8043 || Error writing output 
|-
| 0x8003 || Wrong ANY-Pointer type
|-
| 0x8023 || ANY-Pointer does not point to a valid area or does not have the correct length
|}


'''PLC switches to STOP:'''

If ''S7-SoftPLC'' is switched to STOP by the driver, an error code is inserted into the diagnostic buffer, which can be read out with the programming unit (''S7 für Windows''<sup>®</sup>, STEP<sup>®</sup>7).

{| class="wikitable"
|-
! Error code  !! Reason
|-
| 0xA140 || An error has occured at "i_ADDIDATA_OpenWin32Driver”. The error number of ADDIDATA.DLL is following in the next diagnostic buffer entry.
|}