Siemens SIMATIC S7 User manual

SIEMENS
Toolbox for PGs and PCs (AT and compatibles)
P R O D A V E S 7 V 5 . 5
Toolbox for WINDOWS 95/98/NT/ME/2000
Applications for a Data Link
of PGs/PCs to SIMATIC S7 via MPI Interface and
PC/MPI Cable
Operating Instructions
PRODAVE S7 Win95/98/NT/ME/2000 mini Order No.: 6ES7 807 - 3BA00 - 0YA0
PRODAVE S7 Win95/98/NT/ME/2000 Order No.: 6ES7 807 - 4BA00 - 0YA0
Copyright Siemens AG 2001 All Rights Reserved

Toolbox for Data Link PGs/PCs to SIMATIC S7
I
SIEMENS AG PRODAVE S7
Index
1. INTRODUCTION ...................................................................................................1
1.1 Basic Functions.......................................................................................................................................2
1.1.1 Functions for Data Transfer to S7 300/400......................................................................................2
1.1.2 Functions for Data Transfer to S7 200 .............................................................................................3
1.2 Functions for Data Handling in PG/PC ...............................................................................................3
1.3 TeleService Functions ............................................................................................................................4
2. DESCRIPTION ......................................................................................................4
2.1 Operating Mode of PRODAVE ............................................................................................................4
2.2 Use of the High Language Adaptor ...................................................................................................... 5
2.3 Pre-requisites.......................................................................................................................................... 5
2.4 Connection of PG/PC to PLC ............................................................................................................... 6
2.4.1 Driver under Windows 95/98/NT ....................................................................................................6
3. OPERATION .........................................................................................................7
3.1 Installation of PRODAVE S7................................................................................................................7
3.1.1 Installation of PRODAVE S7 under Windows 95/98/NT/ME/2000................................................ 7
3.2 Scope of Supply PRODAVE S7 ............................................................................................................8
3.2.1 PRODAVE S7 for Windows 95/98/NT/ME/2000 ...........................................................................8
3.2.2 PRODAVE S7 mini for Windows 95/98/NT/ME/2000...................................................................9
3.3 Working with PRODAVE ...................................................................................................................10
3.3.1 Notes on S7-200.............................................................................................................................10
3.3.2 Notes on AS300/400 ...................................................................................................................... 10
3.4 Differences between S5 and S7 ...........................................................................................................11
3.5 Linking to Standard Tools...................................................................................................................13
3.5.1 PRODAVE under Delphi (32-Bit) Example .................................................................................. 13
3.5.2 PRODAVE under Access (32-Bit) Example.................................................................................. 14
3.5.3 PRODAVE under Visual Basic (32-Bit) Example.........................................................................15
4. DESCRIPTION OF PRODAVE FUNCTIONS......................................................16
Functions Overview .........................................................................................................................................17
4.1 Basic Functions.....................................................................................................................................19
load_tool ................................................................................................................................................19
new_ss....................................................................................................................................................21
unload_tool ............................................................................................................................................21
4.1.1 Basic Functions for Data Transfer S7-300/400..............................................................................22
a_field_read ...........................................................................................................................................22
a_field_write ..........................................................................................................................................23
ag_info ................................................................................................................................................... 24

Toolbox for Data Link PGs/PCs to SIMATIC S7
II
SIEMENS AG PRODAVE S7
ag_zustand.............................................................................................................................................. 25
db_buch..................................................................................................................................................26
db_read ..................................................................................................................................................27
db_write ................................................................................................................................................. 29
d_field_read ...........................................................................................................................................30
d_field_write ..........................................................................................................................................30
e_field_read ...........................................................................................................................................31
mb_bittest...............................................................................................................................................32
mb_resetbit............................................................................................................................................. 32
mb_setbit................................................................................................................................................33
m_field_read .......................................................................................................................................... 34
m_field_write .........................................................................................................................................34
t_field_read ............................................................................................................................................35
z_field_read ...........................................................................................................................................35
z_field_write ..........................................................................................................................................35
mix_read ................................................................................................................................................ 36
mix_write ...............................................................................................................................................39
4.1.2 Basic Functions for Data Transfer S7-200.................................................................................... 40
as200_ag_info ........................................................................................................................................ 41
as200_ag_zustand .................................................................................................................................. 42
as200_e_field_read ................................................................................................................................43
as200_a_field_read ................................................................................................................................43
as200_m_field_read............................................................................................................................... 43
as200_sm_field_read .............................................................................................................................43
as200_vs_field_read .............................................................................................................................. 43
as200_a_field_write ...............................................................................................................................45
as200_m_field_write..............................................................................................................................45
as200_sm_field_write ............................................................................................................................45
as200_vs_field_write .............................................................................................................................45
as200_t_field_read.................................................................................................................................46
as200_z_field_read ................................................................................................................................47
as200_z_field_write ...............................................................................................................................48
as200_mb_bittest ...................................................................................................................................49
as200_mb_resetbit .................................................................................................................................49
as200_mb_setbit ....................................................................................................................................49
as200_mix_read .....................................................................................................................................50
as200_mix_write....................................................................................................................................52
4.2 Enhanced Functions for Data Handling in PG/PC ........................................................................... 53
boolean_byte ..........................................................................................................................................53
byte_boolean ..........................................................................................................................................53
gp_to_float .............................................................................................................................................54
float_to_gp ............................................................................................................................................. 55
kg_to_float .............................................................................................................................................55
float_to_kg ............................................................................................................................................. 55
kf_integer ...............................................................................................................................................56
testbit......................................................................................................................................................56
error_message ........................................................................................................................................57
4.3 TeleService Funcions ...........................................................................................................................59
4.3.1 General Commments on the Modem Connection...........................................................................62
4.3.2 Active Telephone Dialling from the PLC.......................................................................................62
ts_dial..................................................................................................................................................... 63
ts_hang_up_dial .....................................................................................................................................66
ts_set_ringindicator................................................................................................................................ 67
ts_read_info ...........................................................................................................................................69
ts_hang_up_ring.....................................................................................................................................69
5. DEMONSTRATION PROGRAMS .......................................................................70

Toolbox for Data Link PGs/PCs to SIMATIC S7
III
SIEMENS AG PRODAVE S7
5.1 Demonstration Programs for the PC..................................................................................................70
6. APPENDIX ..........................................................................................................72
6.1 Error Texts ...........................................................................................................................................72
6.2 Used Abbreviations..............................................................................................................................76
6.3 Literature and Ordering Data ............................................................................................................77
6.3.1 Modules .........................................................................................................................................77
6.3.2 PRODAVE Overview ....................................................................................................................78

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
1
1. Introduction
Due to their constantly increasing performance and vast availability of PC
applications for the manufacturing process, the Personal Computer is being
used more and more on the factory shop floor in addition to the programming
unit. This, however, poses the problem to you as the user how to combine the
variety of programs for handling of process data (e.g. data banks, statistical
evaluation) with your existing PLC systems. In order to make PLC data
available for the PC application you will need a working and cost effective data
link between PLC and PC.
This is where the software package PRODAVE S7 will offer the solution.
PRODAVE S7 offers tried and tested functions (tools) in a DLL (Dynamic Link
Library) or LIB (Library) which you can combine for each of your applications.
The combination of the tools is carried out in programming languages for
Windows 95/98/ME and Windows NT/2000.
Via these combined functions the process data traffic between PLC and PG/PC
is established by PRODAVE S7 using the MPI interface of the PLC. The data
now available can be translated into a format suitable for PCs and can be
processed by your own application or any standard application. This will enable
you to create a data link between PLC and PG/PC without having detailed
knowledge, and all your development activities can be concentrated on specific
processing of your data.
PRODAVE S7 enables you to not only evaluate and monitor but to influence
your process as well inasmuch that you can have several functions available to
you to enable you to write data to the PLC from the PG/PC.
As an introduction to PRODAVE S7 and to enable you to familiarise yourself
with it, we supply several demonstration programs as examples. These
functions are fully operational and are available in source code (see Para. 5.
Demonstration Programs).
PRODAVE S7 runs under Windows 95/98/NT/ME/2000 on PG 7xx and on Pcs
which are compatible to Industrial Standard in conjunction with MPI interfaces
(CP5411, CP5511, CP5611) or PC/MPI cables.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
2
The PRODAVE functions can be divided into 3 basic types:
1.1 Basic Functions
- initialise and de-initialise system (load_tool, unload_tool).
- activate connection (new_ss).
1.1.1 Functions for Data Transfer to S7 300/400
- read output bytes from PLC (a_field_read).
- write output bytes (a_field_write).
- read input bytes from PLC (e_field_read).
- read data bytes from a block DB (d_field_read).
- write data bytes to a block DB (d_field_write).
- read flag bytes from PLC (m_field_read).
- write to flag bytes in PLC (m_field_write).
- status test of a flag (mb_bittest).
- set and reset flag (mb_setbit, mb_resetbit).
- read timer words from PLC (t_field_read).
- read counter words from PLC (z_field_read).
- overwrite counter words in PLC (z_field_write).
- read mixed data (mix_read).
- write mixed data (mix_write).

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
3
1.1.2 Functions for Data Transfer to S7 200
- read output bytes from PLC (as200_a_field_read).
- write output bytes (as200_a_field_write).
- read input bytes from PLC (as200_e_field_read).
- read data bytes from variable memory (as200_vs_field_read).
- write data bytes to variable memory (as200_vs_field_write).
- read flag bytes from PLC (as200_m_field_read).
- write to flag bytes in PLC (as200_m_field_write).
- read special flag bytes from PLC (as200_sm_field_read).
- write to special flag bytes in PLC (as200_sm_field_write).
- status test of a flag (as200_mb_bittest).
- set and reset flag (as200_mb_setbit, as200_mb_resetbit).
- read timer words from PLC (as200_t_field_read).
- read counter words from PLC (as200_z_field_read).
- overwrite counter words in PLC (as200_z_field_write).
- read mixed data (as200_mix_read).
- write mixed data (as200_mix_write).
1.2 Functions for Data Handling in PG/PC
- error text output relating to error number (error_message).
- format conversion of S7 data (gp_to_float, float_to_gp).
- format conversion of S5 data (kg_to_float, float_to_kg).
- byte conversion of a byte to eight logical values and vice versa (boolean_byte,
byte_boolean).

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
4
1.3 TeleService Functions
The TeleService functions are an expansion of the PRODAVE functionality
which enables the user to establish a connection of and to an S7 controller via
the public telephone network.
Pre-requisite is the installation of the SIMATIC TeleService =
SW-Option package to STEP 7 for the linking of SIMATIC S7 controllers (PLCs)
via the public telephone network.
- Dial a station and / or a TS adaptor (ts_dial).
- Close a TeleService connection (ts_hang_up_dial).
- Initialise the system for call recognition (ts_set_ringindicator).
- Read informationen on alarm triggering station (ts_read_info).
- Close a TeleService connection (ts_hang_up_ring).
2. Description
2.1 Operating Mode of PRODAVE
Using the programming package PRODAVE S7 you can read data from a
programmable logic controller (PLC) and write data to a PLC under Windows
95/98/ NT via several CPUs from the S7-series.
PRODAVE S7 consists basically of two parts:
- driver for Windows 95/98/ME and Windows NT/2000
and
- high language adaptor
PRODAVE S7 offers the adaptor for Windows 95/98/NT/ME/2000 in the form of
a 32-Bit-DLL (Dynamic Link Library) created in VC++ Version 6.0.
If you wish to read data from the PLC or write data to the PLC using a high
language, you will only require the adaptor and its functions.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
5
2.2 Use of the High Language Adaptor
A detailed description of the available functions for the various programming
languages of this manual can be found in Chapter 4 "Description of the
PRODAVE Functions".
2.3 Pre-requisites
PRODAVE S7 operates with the following PLC types: S7-200, S7-300, S7-400,
M7 and C7 from the S7 series.
Software-Prerequisites:
Operating System Windows 95/98/ME or Windows NT V4.x/2000.
Hardware-Prerequisites:
PRODAVE S7
PRODAVE S7 mini
PG 7xx or AT compatible Industrial-PC with 64MB main memory and MPI-ISA-
interface, CP5411, CP5511, CP5611 or PC-Adaptor.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
6
2.4 Connection of PG/PC to PLC
2.4.1 Driver under Windows 95/98/NT
The PG/PC may be connected to the PLC by means of the following
components:
o CP 5611 PCI-Card
o CP 5511 PCMCIA-Card
o CP 5411 ISA-Card
o MPI-ISA-Card or MPI-ISA on Board (PG 720/740/760, PC RI45,25,FI25)
o COM 1/2 via PC-Adaptor
PC S7-300/400/M7/C7
MPI-ISA MPI-interface
CP5411/5511/5611 S7-200
PPI-interface
PC S7-300/400/M7/C7
COM1/2 PC-Adaptor MPI-interface
Installation and set-up of the required hardware is carried out via the STEP7-
Tool PG/PC interface parameterisation, which is available in the system after
successful installation.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
7
3. Operation
3.1 Installation of PRODAVE S7
3.1.1 Installation of PRODAVE S7 under Windows 95/98/NT/ME/2000
The installation of PRODAVE S7 is carried out via a Windows installation
program (SETUP.EXE), which must be activated by the file manager under
Windows.
After starting SETUP.EXE a destination path is offered for the installation which
may be changed by new input or via BROWSE.
After specifying the destination path the following installation components are
offered:
•PRODAVE S7 for Windows 95/98/NT/ME/2000
PRODAVE DLL and demonstration program for Windows
95/98/NT/ME/2000.
STEP7 Driver for Windows 95/98/NT/ME/2000
•Documentation, Online Help.
Setup automatically generates a PRODAVE program group with a
demonstration program and STEP7 tool to set up the used interface under
Windows 95/98/ME/NR/2000.
The drivers to be used can be loaded, parameterised and linked into the
system by means of the STEP7 tool PG/PC-interface parameterisation
(S7EPATSX.EXE). After correct installation the drivers are automatically
activated every time Windows 95/98/NT/ME/2000 is started.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
8
3.2 Scope of Supply PRODAVE S7
3.2.1 PRODAVE S7 for Windows 95/98/NT/ME/2000
The following PRODAVE components are available after successful installation:
SIEMENS\PRODAVE\INCLUDE\
W95_S7 .H = header file for PRODAVE-DLL
KOMFORT .H = header file for PRODAVE-DLL
W95_S7 .DEF = definition file for PRODAVE-DLL
KOMFORT .DEF = definition file for PRODAVE-DLL
SIEMENS\PRODAVE\LIB\
W95_S7 .LIB = import library for PRODAVE-DLL
KOMFORT .LIB = import library for PRODAVE-DLL
SIEMENS\PRODAVE\SAMPLE_VC\
DEMO .EXE = demo program
DEMO .C = source code demo program
ICON1 .ICO = 32 x 32 icon
DEMO .RC = resource code demo program
ERROR .DAT = file with German error texts
RESOURCE.H = header file demo program
SIEMENS\PRODAVE\SAMPLE_VB\
VBDEMO .VBP= visual basic projectfile
ERROR .DAT = file with German error texts
VBDEMO .EXE = visual basic demo program
VBDEMO .BAS = visual basic file
VBDEMO .FRM = visual basic FRM-file
DBBUCH_FRM .FRM
ERROR .FRM
FLAG .FRM
INFO .FRM
LOAD .FRM
READ_FRM .FRM
STATUS .FRM
TS_FRM .FRM
TSINFO_FRM .FRM
WRITE_FRM .FRM
WINDOWS\SYSTEM\ \WINDOWS\SYSTEM32\
W95_S7 .DLL = PRODAVE-DLL
KOMFORT .DLL = enhanced -DLL

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
9
3.2.2 PRODAVE S7 mini for Windows 95/98/NT/ME/2000
The following PRODAVE components are available after successful installation:
SIEMENS\PRODAVE_S7_MINI\INCLUDE\
W95_S7M .H = header file for PRODAVE-DLL
KOMFORT .H = header file for PRODAVE-DLL
W95_S7M .DEF = definition file for PRODAVE-DLL
KOMFORT .DEF = definition file for PRODAVE-DLL
SIEMENS\PRODAVE_S7_MINI\LIB\
W95_S7M .LIB = import library for PRODAVE-DLL
KOMFORT .LIB = import library for PRODAVE-DLL
SIEMENS\PRODAVE_S7_MINI\SAMPLE_VC\
DEMO .EXE = demo program
DEMO .C = source code demo program
ICON1 .ICO = 32 x 32 icon
DEMO .RC = resource code demo program
ERROR .DAT = file with German error texts
RESOURCE.H = header file demo program
SIEMENS\PRODAVE_S7_MINI\SAMPLE_VB\
VBDEMO .VBP= visual basic projectfile
ERROR .DAT = file with German error texts
VBDEMO .EXE = visual basic demo program
VBDEMO .BAS = visual basic file
VBDEMO .FRM = visual basic FRM-file
DBBUCH_FRM .FRM
ERROR .FRM
FLAG .FRM
INFO .FRM
LOAD .FRM
READ_FRM .FRM
STATUS .FRM
TS_FRM .FRM
TSINFO_FRM .FRM
WRITE_FRM .FRM
WINDOWS\SYSTEM\ \WINDOWS\SYSTEM32\
W95_S7M .DLL = PRODAVE-DLL
KOMFORT .DLL = enhanced -DLL

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
10
3.3 Working with PRODAVE
The user program is written in a high language and the function calls are used
in the form listed in Para. 4 "Description of PRODAVE Functions".
3.3.1 Notes on S7-200
When creating a data link to S7-200 it is not allowed to have more than one
connection parameterised in the load_tool function.
The connection is initialised by means of the load_tool function. This is
followed by the user specific part, where you may only call the as200_......
functions from the adaptor (see also Para. 4.1.2 “Basic Functions for Data
Transfer S7-200 “). When you wish to end your program, it is required to de-
initialise the connections by means of the unload_tool function.
3.3.2 Notes on AS300/400
The obligatory start of each user program is the initialisation of the
connections by calling the function load_tool. This is followed by the user
specific part, where you can call any amount of PRODAVE functions (with the
exception of the as200_.... functions) from the adaptor. When you wish to end
your program, it is required to de-initialise the connections by means of the
unload_tool function.
When carrying out the development of your program, the following points
should be noted to avoid data loss or a system crash:
- Prior to leaving the program, the connections must be de-initialised by calling
the adaptor function unload_tool!
- When reading data from the PLC, the fields into which data is to be
transferred, must be big enough to receive this data as the adaptor does not
carry out a field check!
- The error text file must be located in the same directory as the developed
program as otherwise the adaptor will not be able to read the error texts!
- In order to avoid a repeated “check if it exists” of the error text file, you can call
the function error_message at the start of the program to enable you to
output an appropriate message in the event of an error. This error text file is
loaded when calling this function for the first time.

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
11
- Prior to starting the PRODAVE application under MS-DOS it is required to
activate the drivers for the used interface.
3.4 Differences between S5 and S7
The main difference between S5-PLCs and S7-PLCs is the management of
data blocks. S5 data blocks are processed word by word, whereas the S7 data
blocks are processed byte by byte.
S5 S7
bit 15 .. bit 0 bit 7..0 bit 7..0
= DW 0
= DW 2
= DW 4
= DW 6
...
When using the d_field_read function, the data block is accessed byte by byte
such as, for instance, applies to the flag area.
When you read 3 data words using the db_read function, the PLC transfers
DBW0 - DBW5. I.e. three 16bit words are available for processing in the
PG/PC, which the PLC addresses via DBW0, DBW2 and DBW4, by the
PG/PC, however, they are addressed via DW0, DW1 and DW2.
DB0 DB1
DB2 DB3
DB4 DB5
DB6 DB7
... ...
DW 0
DW 1
DW 2
DW 3
...

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
12
In order to avoid confusion in the data management, we recommend to have
the PLC process the data block symbolically via type allocation in the following
form:
Type Declaration in Symbol List:
Block: DB10
DB_10
Address Variable Data Type Start Value Comments
STRUCT
DW ARRAY[0 .. 255]
WORD
END STRUCT
Example of access to the varilable in PLC:
L “DB_10“.DW[2]
T MW10
or
L MW10
T “DB_10“.DW[2]

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
13
3.5 Linking to Standard Tools
3.5.1 PRODAVE under Delphi (32-Bit) Example
To enable you to use the PRODAVE functions under Delphi, they must be
declared as follows:
function Load_tool ( no:Byte;
name: {pointer} PChar;
adr:{pointer} PChar): longint;
stdcall;
external ´w95_s7.dll´ name ´load_tool´;
function DB_read ( dbno: longint;
dwno: longint;
var amount: longint;
var buffer): longint
stdcall;
external ´w95_s7.dll´ name ´db_read´;
function Unload_tool: longint;
stdcall;
external ´w95_s7.dll´ name ´unload_tool´;
Example:
var
plc_adr_table : array [0..15] of byte;
name:array[0..255] of char;
res ,amount: longint;
buffer : array[0..255] of word;
plc_adr_table[0] := 2; {address}
plc_adr_table[1] := 0; {segment id}
plc_adr_table[2] := 2; {racktno}
plc_adr_table[3] := 0; {slotno}
plc_adr_table[4] := 0;
strcopy(name,'S7ONLINE');
res := Load_tool(1,addr(name),addr(plc_adr_table[0]));
res := DB_read(10,0,amount,buffer);
res := Unload_tool;

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
14
3.5.2 PRODAVE under Access (32-Bit) Example
To enable you to use the PRODAVE functions under Access, they must be
declared as follows:
Declare Function load_tool Lib “w95_s7“ ( ByVal no As Byte,
ByVal name As String,
ByVal adr As String) As Long
Declare Function db_read Lib “w95_s7“ ( ByVal dbno As Long,
ByVal dwno As Long,
ByRef amount As Long,
ByRef buffer As Integer) As Long
Declare Function unload_tool Lib “w95_s7“ () As Long
Example:
Dim dbno As Long, dwno As Long, amount As Long
Dim buffer(50) As Integer
Dim plc_adr_table As String
res = load_tool 1, “S7ONLINE“, plc_adr_table,
res = db_read dbno, dwno, amount, buffer(0)
res = unload_tool

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
15
3.5.3 PRODAVE under Visual Basic (32-Bit) Example
To enable you to use the PRODAVE functions under Visual-Basic, they must
be declared as follows:
Declare Function load_tool Lib "w95_s7.dll" (ByVal nr As Byte,
ByVal dev As String,
adr As plcadrtype) As Long
Declare Function db_read Lib “w95_s7“ ( ByVal dbno As Long,
ByVal dwno As Long,
amount As Long,
buffer%) As Long
Declare Function unload_tool Lib “w95_s7“ () s Long
Example:
Dim dbno As Long, dwno As Long, amount As Long
Dim buffer(50) As Integer
Type plcadrtype
adr As Byte
SEGMENTID As Byte
SLOTNO As Byte
RACKNO As Byte
End Type
Dim plcadr (5) As plcadrtype
plcadr(0).adr = 2
plcadr(0).SEGMENTID = 0
plcadr(0).SLOTNO = 2
plcadr(0).RACKNO = 0
plcadr(1).adr = 0
res = load_tool (1, ”S7ONLINE”, plcadr)
res = db_read (dbno, dwno, amount, buffer(0))
res = unload_tool()

SIEMENS AG PRODAVE S7
Toolbox for Data Link PGs/PCs to SIMATIC S7
16
4. Description of PRODAVE Functions
How to read the descriptions of the functions:
- The explanantion of the functions is in "normal" type.
- This is usually followed by a note on functions where their handling is similar,
or which are to be read in conjunction with the described function, in "bold"
type and marked by ☞
☞☞
☞.
- This is followed by the syntax for C functions in the "courier bold
italics " font.
- In the event of programming examples for the described adaptor function,
these would again be printed in "courier bold italics" (C).
All functions in the 32-Bit-DLL W95_S7.DLL and W95_S7M.DLL have the suffix
WINAPI. It is important to note this when using the functions as is it is not
explicitly mentioned in the function description.
Functions included in the software package PRODAVE S7 mini have the suffix
mini in the headline.
32-Bit-DLL for Windows 95/98/NT/ME/2000
int WINAPI a_field_read
(int nr, int amount, void* buffer);