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.

(if there are any problems, please contact the ADDI-DATA documentation and/or the ADDI-DATA support.)

The "ADDI-DATA PC-Card" 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 "dw_DriverHandle" 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 "dw_DriverHandle" to the ADDI-DATA functions.

Read8DigitalInputs:

Corresponds to the function "b_ADDIDATA_Read8DigitalInputs (DWORD dw_DriverHandle, BYTE b_Port, PBYTE pb_PortValue)".

Request:





 CALL 
 FC 100


  INO 
  := B#16#0 
  //b_Port


 RET_VAL 
 := MW 0 
 //RET_VAL error code


 OUT1 
 := MB 2 
 //pb_PortValue

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 "b_ADDIDATA_Read16DigitalInputs(DWORD dw_DriverHandle, BYTE b_Port, PWORD pw_PortValue)".

Request:





 CALL 
 FC 101


 INO 
 := B#16#0 
 //b_Port


 RET_VAL 
 := MW 0 
 //RET_VAL error code


 OUT1 
 := MB 2 
 //pw_PortValue

Read32DigitalInputs:

Corresponds to the function "b_ADDIDATA_Read32DigitalInputs(DWORD dw_DriverHandle, BYTE b_Port, PDWORD pdw_PortValue)".

Request:





 CALL 
 FC 102


 INO 
 := B#16#0 
 //b_Port


 RET_VAL 
 := MW 0 
 //RET_VAL error code


 OUT1 
 := MD 2 
 //pdw_PortValue

Set8DigitalOutputs:

Corresponds to the function "b_ADDIDATA_Set8DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, BYTE b_PortValue)".

Request:





 CALL 
 FC 103


 INO 
 := B#16#0 
 //b_Port


 IN1 
 := B#16#0 
 //b_PortValue


 RET_VAL 
 := MW 0 
 //RET_VAL error code

Set16DigitalOutputs:

Corresponds to the function "b_ADDIDATA_Set16DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, WORD w_PortValue)".

Request:





 CALL 
 FC 104


 INO 
 := B#16#0 
 //b_Port


 IN1 
 := B#16#0 
 //w_PortValue


 RET_VAL 
 := MW 0 
 //RET_VAL error code

Set32DigitalOutputs:

Corresponds to the function "b_ADDIDATA_Set32DigitalOutputsOn(DWORD dw_DriverHandle, BYTE b_Port, DWORD dw_PortValue)".

Request:





 CALL 
 FC 105


 INO 
 := B#16#0 
 //b_Port


 IN1 
 := DW#16#0 
 //dw_PortValue


 RET_VAL 
 := MW 0 
 //RET_VAL error code

InitAnalogInput:

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

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:





 CALL 
 FC 106


 INO 
 := W#16#0 
 //w_Channel


 IN1 
 := P#M 8.0 BYTE 10 
 //ANY-pointer to structure


 RET_VAL 
 := MW 0 
 //RET_VAL error code

ReleaseAnalogInput:

Corresponds to the function "b_ADDIDATA_ReleaseAnalogInput(DWORD dw_DriverHandle, WORD w_Channel)".

Request:





 CALL 
 FC 107


 INO 
 := W#16#0 
 //w_Channel


 RET_VAL 
 := MW 0 
 //RET_VAL error code

InitAnalogOutput:

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

Request:





 CALL 
 FC 108


 INO 
 := 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

ReadAnalogInput:

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

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:





 CALL 
 FC 109


 INO 
 := 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

WriteAnalogOutput:

Corresponds to the function "b_ADDIDATA_Write1AnalogOutput(DWORD dw_DriverHandle, WORD w_Channel, dw_ValueToWrite)".

Request:





 CALL 
 FC 110


 INO 
 := W#16#0 
 //w_Channel


 IN1 
 := DW#16#0 
 //dw_ValueToWrite


 RET_VAL 
 := MW 0 
 //RET_VAL error 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:

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^®, STEP^®7).

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.

S7-SoftPLC:ADDI-DATA configuration

Accessing the I/O card

Return values:

Navigation menu

Personal tools

Namespaces

Variants

Views

Actions

Search

Navigation

Tools

CALL	FC 100
INO	:= B#16#0	//b_Port
RET_VAL	:= MW 0	//RET_VAL error code
OUT1	:= MB 2	//pb_PortValue

CALL	FC 101
INO	:= B#16#0	//b_Port
RET_VAL	:= MW 0	//RET_VAL error code
OUT1	:= MB 2	//pw_PortValue

CALL	FC 102
INO	:= B#16#0	//b_Port
RET_VAL	:= MW 0	//RET_VAL error code
OUT1	:= MD 2	//pdw_PortValue

CALL	FC 103
INO	:= B#16#0	//b_Port
IN1	:= B#16#0	//b_PortValue
RET_VAL	:= MW 0	//RET_VAL error code

CALL	FC 104
INO	:= B#16#0	//b_Port
IN1	:= B#16#0	//w_PortValue
RET_VAL	:= MW 0	//RET_VAL error code

CALL	FC 105
INO	:= B#16#0	//b_Port
IN1	:= DW#16#0	//dw_PortValue
RET_VAL	:= MW 0	//RET_VAL error code

CALL	FC 106
INO	:= W#16#0	//w_Channel
IN1	:= P#M 8.0 BYTE 10	//ANY-pointer to structure
RET_VAL	:= MW 0	//RET_VAL error code

CALL	FC 107
INO	:= W#16#0	//w_Channel
RET_VAL	:= MW 0	//RET_VAL error code

CALL	FC 108
INO	:= 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

CALL	FC 109
INO	:= 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

CALL	FC 110
INO	:= W#16#0	//w_Channel
IN1	:= DW#16#0	//dw_ValueToWrite
RET_VAL	:= MW 0	//RET_VAL error code