S7-SoftSPS:Datenschnittstelle - Versionsgeschichte

Joscha am 5. November 2012 um 14:22 Uhr

2012-11-05T14:22:07Z

← Nächstältere Version		Version vom 5. November 2012, 14:22 Uhr
Zeile 238:		Zeile 238:


	~~Achtung~~: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.		ACHTUNG: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.

Joscha am 5. November 2012 um 14:16 Uhr

2012-11-05T14:16:12Z

← Nächstältere Version		Version vom 5. November 2012, 14:16 Uhr
Zeile 60:		Zeile 60:
	\| \|\| unsigned long int far * val);,		\| \|\| unsigned long int far * val);,
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 83:		Zeile 84:

	'''Mehrere Werte lesen'''		'''Mehrere Werte lesen'''

	Liest mehrere Werte aus der ''S7-SoftSPS''.		Liest mehrere Werte aus der ''S7-SoftSPS''.

Zeile 97:		Zeile 99:
	\| \|\| unsigned long int far * vals);,		\| \|\| unsigned long int far * vals);,
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 116:		Zeile 119:

	Länge der Parameterliste (Visual-C): 20 Bytes.		Länge der Parameterliste (Visual-C): 20 Bytes.


	ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!		ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!
Zeile 156:		Zeile 160:

	Länge der Parameterliste (Visual-C): 20 Bytes.		Länge der Parameterliste (Visual-C): 20 Bytes.


	ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!		ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!


	'''DB lesen'''		'''DB lesen'''
Zeile 173:		Zeile 179:
	\| \|\| unsigned long int Synchron);		\| \|\| unsigned long int Synchron);
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 191:		Zeile 198:

	Länge der Parameterliste (Visual-C): 16 Bytes.		Länge der Parameterliste (Visual-C): 16 Bytes.


	Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.		Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.


	'''DB schreiben'''		'''DB schreiben'''
Zeile 208:		Zeile 217:
	\| \|\| unsigned long int Synchron);		\| \|\| unsigned long int Synchron);
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 226:		Zeile 236:

	Länge der Parameterliste (Visual-C): 16 Bytes.		Länge der Parameterliste (Visual-C): 16 Bytes.


	Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.		Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.
Zeile 242:		Zeile 253:
	\| \|\| unsigned long int far * Anzahl,		\| \|\| unsigned long int far * Anzahl,
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 256:		Zeile 268:
	\| Rückgabe \|\| 0 bei Fehler \|\| Fehlermeldungen		\| Rückgabe \|\| 0 bei Fehler \|\| Fehlermeldungen
	\|}		\|}


	Länge der Parameterliste (Visual-C): 12 Bytes.		Länge der Parameterliste (Visual-C): 12 Bytes.
Zeile 273:		Zeile 284:
	\| \|\| unsigned long int far * Anzahl,		\| \|\| unsigned long int far * Anzahl,
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 303:		Zeile 315:
	\| \|\| unsigned long far * MC5Val);		\| \|\| unsigned long far * MC5Val);
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Zeile 324:		Zeile 337:
	\| \|\| float FloatVal);		\| \|\| float FloatVal);
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"

Joscha am 5. November 2012 um 14:14 Uhr

2012-11-05T14:14:31Z

Änderungen zeigen

Joscha am 5. November 2012 um 14:06 Uhr

2012-11-05T14:06:38Z

Änderungen zeigen

Joscha am 5. November 2012 um 13:47 Uhr

2012-11-05T13:47:15Z

@@ Zeile 42: / Zeile 42: @@
 Länge der Parameterliste (Visual-C): 20 Bytes.
 '''Wert schreiben'''
@@ Zeile 80: / Zeile 81: @@
 Länge der Parameterliste (Visual-C): 20 Bytes.
-<table>
+'''Mehrere Werte lesen'''
-<tbody>
+Liest mehrere Werte aus der ''S7-SoftSPS''.
-<br />
+{|
+{| class="wikitable"
-<table>
+|-
-<tbody>
+! Parameter !! Beschreibung !!  Kommentar
-<tr class="odd">
+|-
-<td align="left">Parameter</td>
+| typ || 'E' = Eingang<br />'A' = Ausgang<br />'M' = Merker<br />'D' = Datenwort<br />'B' = Datenbyte auf Byteadresse || <br /><br /><br />S5 kompatibel<br />S7 kompatibel, nur S7!
-<td align="left">Beschreibung</td>
+|-
-<td align="left">Kommentar</td>
+| nr || Adresse ||
-</tr>
+|-
-<tr class="even">
+| DBNr || Datenbaustein Nummer || 1 – 16383
-<td align="left">typ</td>
+|-
-<td align="left">'E' = Eingang<br />
+| size || Anzahl der Bytes oder Datenworte || Bei typ: 'E', 'A', 'M' und 'B' Angabe in Bytes, bei 'D' Angabe in Datenworten.
- 'A' = Ausgang<br />
+|-
- 'M' = Merker<br />
+| vals ||  Byte-Werte ||  Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />Achtung: Das Feld muss groß genug sein!
- 'D' = Datenwort<br />
+|-
- 'B' = Datenbyte auf Byteadresse</td>
+| Rückgabe ||  	0 bei Fehler || Fehlermeldungen
-<td align="left"> <br />
+|}
 Länge der Parameterliste (Visual-C): 20 Bytes.
@@ Zeile 164: / Zeile 119: @@
 ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!
-'''Mehrere Werte schreiben'''<br />
- Schreibt mehrere Werte in die ''S7-SoftSPS''.
+'''Mehrere Werte schreiben'''
 <table>

Joscha am 5. November 2012 um 13:42 Uhr

2012-11-05T13:42:40Z

@@ Zeile 43: / Zeile 43: @@
 Länge der Parameterliste (Visual-C): 20 Bytes.
-'''Wert schreiben'''<br />
+'''Wert schreiben'''
-<table>
+Schreibt einen Wert in die ''S7-SoftSPS''.
-<br />
+{|
+{| class="wikitable"
-<table>
+|-
-<tbody>
+! Parameter !! Beschreibung !!  Kommentar
-<tr class="odd">
+|-
-<td align="left">Parameter</td>
+| typ || 'E' = Eingang<br />'A' = Ausgang<br />'M' = Merker<br />'Z' = Zählerwert<br />'T' = Zeitwert<br />'D' = Datenwort oder Datendoppelwort<br />'B' = Datenbit,-byte,-wort,-doppelwort<br />auf Byteadresse<br />'P' = P_Parameter || <br /><br /><br />nur 16-Bit-Zugriff<br />nur 16-Bit-Zugriff<br />abhängig vom Parameter size<br />
-<td align="left">Beschreibung</td>
+abhängig von size<br />S7 kompatibel, nur S7!<br />nur S7 ab Version 3!<br />
-<td align="left">Kommentar</td>
+|-
-</tr>
+| nr || Adresse || Byteadresse des einzulesenden Operanden
-<tr class="even">
+|-
-<td align="left">typ</td>
+| DBNr || Datenbaustein Nummer || 1 – 16383
-<td align="left">'E' = Eingang<br />
+|-
- 'A' = Ausgang<br />
+| size || Anzahl der Bits<br />0..7= Bit Nr 0 7<br />8 = 1 Byte<br />16 = 1 Wort<br />32 = 1 Doppelwort || <br /><br />nur 'E','A','M'
- 'M' = Merker<br />
+|-
- 'Z' = Zählerwert<br />
+| val ||  Zu schreibender Wert ||
- 'T' = Zeitwert<br />
+|-
- 'D' = Datenwort oder Datendoppelwort<br />
+| Rückgabe ||  	0 bei Fehler || Fehlermeldungen
- 'B' = Datenbit,-byte,-wort,-doppelwort auf Byteadresse<br />
+|}
 Länge der Parameterliste (Visual-C): 20 Bytes.

Joscha: Die Seite wurde neu angelegt: „Von verschiedenen Programmiersystemen (z.B. Visual Basic^®, Visual C/C++^® oder Borland C++Builder^®) kann direkt auf die ''S7…“

2012-11-05T13:40:23Z

Die Seite wurde neu angelegt: „Von verschiedenen Programmiersystemen (z.B. Visual Basic<sup>®</sup>, Visual C/C++<sup>®</sup> oder Borland C++Builder<sup>®</sup>) kann direkt auf die ''S7…“

Neue Seite

Von verschiedenen Programmiersystemen (z.B. Visual Basic<sup>®</sup>, Visual C/C++<sup>®</sup> oder Borland C++Builder<sup>®</sup>) kann direkt auf die ''S7-SoftSPS'' zugegriffen werden. Die hierzu benötigte DLL wird mitgeliefert (PLC32.DLL). Es handelt sich hierbei um eine 32 Bit Applikation.

Im Folgenden werden die zur Datenübertragung vorhandenen Funktionen beschrieben.

== Funktionen zur Datenübertragung ==

'''Wert lesen'''

Liest einen Wert aus der ''S7-SoftSPS''.

{|
|-
| unsigned long int DLLexport ReadVal || (unsigned long int typ,
|-
| || unsigned long int nr,
|-
| || unsigned long int DBNr,
|-
| || unsigned long int size,
|-
| || unsigned long int far * val);,
|}

{| class="wikitable"
|-
! Parameter !! Beschreibung !! Kommentar
|-
| typ || 'E' = Eingang<br />'A' = Ausgang<br />'M' = Merker<br />'Z' = Zählerwert<br />'T' = Zeitwert<br />'D' = Datenwort oder Datendoppelwort<br />'B' = Datenbit,-byte,-wort,-doppelwort<br />auf Byteadresse<br />'P' = P_Parameter || <br /><br /><br />nur 16-Bit-Zugriff<br />nur 16-Bit-Zugriff<br />abhängig vom Parameter size<br />
abhängig von size<br />S7 kompatibel, nur S7!<br />nur S7 ab Version 3!<br />
|-
| nr || Adresse || Byteadresse des einzulesenden Operanden
|-
| DBNr || Datenbaustein Nummer || 1 – 16383
|-
| size || Anzahl der Bits<br />0..7= Bit Nr 0 7<br />8 = 1 Byte<br />16 = 1 Wort<br />32 = 1 Doppelwort || <br /><br />nur 'E','A','M'
|-
| val || Gelesener Wert || Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.
|-
| Rückgabe || 0 bei Fehler || Fehlermeldungen
|}

Länge der Parameterliste (Visual-C): 20 Bytes.

'''Wert schreiben'''<br />
Schreibt einen Wert in die ''S7-SoftSPS''.

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport WriteVal</td>
<td align="left">(unsigned long int typ,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int nr,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int DBNr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int size,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * val);,</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">typ</td>
<td align="left">'E' = Eingang<br />
'A' = Ausgang<br />
'M' = Merker<br />
'Z' = Zählerwert<br />
'T' = Zeitwert<br />
'D' = Datenwort oder Datendoppelwort<br />
'B' = Datenbit,-byte,-wort,-doppelwort auf Byteadresse<br />
'P' = P_Parameter</td>
<td align="left"> <br />
<br />
<br />
nur 16-Bit-Zugriff<br />
nur 16-Bit-Zugriff<br />
abhängig vom Parameter size<br />
abhängig von size<br />
<br />
S7 kompatibel, nur S7!<br />
nur S7 ab Version 3!</td>
</tr>
<tr class="odd">
<td align="left">nr</td>
<td align="left">Adresse</td>
<td align="left">Byteadresse des einzulesenden Operanden</td>
</tr>
<tr class="even">
<td align="left">DBNr</td>
<td align="left">Datenbaustein Nummer</td>
<td align="left">1 – 16383</td>
</tr>
<tr class="odd">
<td align="left">size</td>
<td align="left">Anzahl der Bits<br />
0..7= Bit Nr 0 7<br />
8 = 1 Byte<br />
16 = 1 Wort<br />
32 = 1 Doppelwort</td>
<td align="left"> <br />
nur 'E','A','M'</td>
</tr>
<tr class="even">
<td align="left">val</td>
<td align="left">Zu schreibender Wert</td>
<td align="left"> </td>
</tr>
<tr class="odd">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 20 Bytes.

'''Mehrere Werte lesen'''<br />
Liest mehrere Werte aus der ''S7-SoftSPS''.

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport ReadVals</td>
<td align="left">(unsigned long int typ,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int nr,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int DBNr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int size,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * vals);,</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">typ</td>
<td align="left">'E' = Eingang<br />
'A' = Ausgang<br />
'M' = Merker<br />
'D' = Datenwort<br />
'B' = Datenbyte auf Byteadresse</td>
<td align="left"> <br />
<br />
<br />
S5 kompatibel<br />
S7 kompatibel, nur S7!</td>
</tr>
<tr class="odd">
<td align="left">nr</td>
<td align="left">Adresse</td>
<td align="left"> </td>
</tr>
<tr class="even">
<td align="left">DBNr</td>
<td align="left">Datenbaustein Nummer</td>
<td align="left">1 – 16383</td>
</tr>
<tr class="odd">
<td align="left">size</td>
<td align="left">Anzahl der Bytes oder Datenworte</td>
<td align="left">Bei typ: 'E', 'A', 'M' und 'B' Angabe in Bytes, bei 'D' Angabe in Datenworten.</td>
</tr>
<tr class="even">
<td align="left">vals</td>
<td align="left">Byte-Werte</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="odd">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 20 Bytes.

ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!

'''Mehrere Werte schreiben'''<br />
Schreibt mehrere Werte in die ''S7-SoftSPS''.

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport WriteVals</td>
<td align="left">(unsigned long int typ,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int nr,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int DBNr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int size,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * vals);,</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">typ</td>
<td align="left">'E' = Eingang<br />
'A' = Ausgang<br />
'M' = Merker<br />
'D' = Datenwort<br />
'B' = Datenbyte auf Byteadresse</td>
<td align="left"> <br />
<br />
<br />
S5 kompatibel<br />
S7 kompatibel, nur S7!</td>
</tr>
<tr class="odd">
<td align="left">nr</td>
<td align="left">Adresse</td>
<td align="left"> </td>
</tr>
<tr class="even">
<td align="left">DBNr</td>
<td align="left">Datenbaustein Nummer</td>
<td align="left">1 – 16383</td>
</tr>
<tr class="odd">
<td align="left">size</td>
<td align="left">Anzahl der Bytes oder Datenworte<br />
'E'<br />
'A'<br />
'M'<br />
'B'<br />
'D'</td>
<td align="left"> <br />
Angabe in Bytes<br />
Angabe in Bytes<br />
Angabe in Bytes<br />
Angabe in Bytes<br />
Angabe in Datenworten.</td>
</tr>
<tr class="even">
<td align="left">vals</td>
<td align="left">Byte-Werte</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="odd">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 20 Bytes.

ACHTUNG: BEI DATENBAUSTEINEN (TYP = 'D') MUSS DAS WERTE-FELD DOPPELT SO GROß SEIN, DA FÜR JEDES DATENWORT 2 BYTES BENÖTIGT WERDEN!

'''DB lesen'''<br />
Liest den Inhalt eines Datenbausteines aus der ''S7-SoftSPS''.

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport ReadDB</td>
<td align="left">(unsigned long int nr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned short int far * Baustein,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * Anzahl,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int Synchron);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">nr</td>
<td align="left">DB-Nummer</td>
<td align="left">1..16383</td>
</tr>
<tr class="odd">
<td align="left">Baustein</td>
<td align="left">Zeiger auf den DB-Inhalt</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="even">
<td align="left">Anzahl</td>
<td align="left">Anzahl der Worte, die aus dem Baustein gelesen werden sollen</td>
<td align="left">Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.<br />
Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.</td>
</tr>
<tr class="odd">
<td align="left">Synchron</td>
<td align="left">Immer 0</td>
<td align="left">Bei S7 ohne Bedeutung</td>
</tr>
<tr class="even">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 16 Bytes.

Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.

'''DB schreiben'''<br />
Beschreibt einen Datenbaustein in der ''SPS''.

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport WriteDB</td>
<td align="left">(unsigned long int nr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned short int far * Baustein,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * Anzahl,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long int Synchron);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">nr</td>
<td align="left">DB-Nummer</td>
<td align="left">1..16383</td>
</tr>
<tr class="odd">
<td align="left">Baustein</td>
<td align="left">Zeiger auf den neuen DB-Inhalt</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="even">
<td align="left">Anzahl</td>
<td align="left">Anzahl der Worte, die aus dem Baustein geschrieben werden sollen.</td>
<td align="left">Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.<br />
Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.</td>
</tr>
<tr class="odd">
<td align="left">Synchron</td>
<td align="left">Immer 0</td>
<td align="left">Bei S7 ohne Bedeutung</td>
</tr>
<tr class="even">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 16 Bytes.

Achtung: ES WIRD WORTORIENTIERT GELESEN, LOW- UND HIGHBYTE WERDEN VERTAUSCHT.

'''DB lesen S7'''<br />
Liest den Inhalt eines S7-Datenbausteines in der SPS (Byteorientiert).

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport ReadDB_S7</td>
<td align="left">(unsigned long int nr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned char int far * Baustein,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * Anzahl);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">nr</td>
<td align="left">DB-Nummer</td>
<td align="left">1..16383</td>
</tr>
<tr class="odd">
<td align="left">Baustein</td>
<td align="left">Zeiger auf den DB-Inhalt</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="even">
<td align="left">Anzahl</td>
<td align="left">Anzahl der Bytes, die aus dem Baustein gelesen werden sollen.</td>
<td align="left">Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.<br />
Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.</td>
</tr>
<tr class="odd">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 12 Bytes.

'''DB schreiben S7'''<br />
Beschreibt den Inhalt eines S7-Datenbausteines in der SPS (Byteorientiert).

<table>
<tbody>
<tr class="odd">
<td align="left">unsigned long int DLLexport WriteDB_S7</td>
<td align="left">(unsigned long int nr,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned char int far * Baustein,</td>
</tr>
<tr class="odd">
<td align="left"> </td>
<td align="left">unsigned long int far * Anzahl);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">nr</td>
<td align="left">DB-Nummer</td>
<td align="left">1..16383</td>
</tr>
<tr class="odd">
<td align="left">Baustein</td>
<td align="left">Zeiger auf den neuen DB-Inhalt</td>
<td align="left">Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />
Achtung: Das Feld muss groß genug sein!</td>
</tr>
<tr class="even">
<td align="left">Anzahl</td>
<td align="left">Anzahl der Bytes, die aus dem Baustein gelesen werden sollen.</td>
<td align="left">Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.<br />
Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.</td>
</tr>
<tr class="odd">
<td align="left">Rückgabe</td>
<td align="left">0 bei Fehler</td>
<td align="left">Fehlermeldungen</td>
</tr>
</tbody>
</table>

Länge der Parameterliste (Visual-C): 12 Bytes.

=== Funktionen zur Zahlenumwandlung ===

'''FloatToMC5'''<br />
Wandelt Gleitpunktzahlen im IBM-PC-Format in S7-Doppelwörter um.

<table>
<tbody>
<tr class="odd">
<td align="left">void DLLexport FloatToMC5</td>
<td align="left">(float FloatValue,</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">unsigned long far * MC5Val);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">FloatVal</td>
<td align="left">Gleitpunktzahl im IEEE- bzw. INTEL-Format</td>
<td align="left"> </td>
</tr>
<tr class="odd">
<td align="left">MC5Val</td>
<td align="left">Gleitpunktzahl im Siemens-S7-Format</td>
<td align="left"> </td>
</tr>
</tbody>
</table>

'''MC5ToFloat'''<br />
Wandelt S7-Doppelwörter in Gleitpunktzahlen im IBM-PC-Format um.

<table>
<tbody>
<tr class="odd">
<td align="left">void DLLexport MC5ToFloat</td>
<td align="left">(unsigned long far * MC5Val</td>
</tr>
<tr class="even">
<td align="left"> </td>
<td align="left">float FloatVal);</td>
</tr>
</tbody>
</table>

<br />

<table>
<tbody>
<tr class="odd">
<td align="left">Parameter</td>
<td align="left">Beschreibung</td>
<td align="left">Kommentar</td>
</tr>
<tr class="even">
<td align="left">MC5Val</td>
<td align="left">Gleitpunktzahl im Siemens-S7-Format</td>
<td align="left"> </td>
</tr>
<tr class="odd">
<td align="left">FloatVal</td>
<td align="left">Gleitpunktzahl im IEEE- bzw. INTEL-Format</td>
<td align="left"> </td>
</tr>
</tbody>
</table>

=== Zugriff mit einem Webserver ===

Sollten Sie beabsichtigen mit Webapplikationen (IIS) auf die ''S7-SoftSPS'' zuzugreifen, die Zugriff auf die Prozessdaten haben sollen, so setzen Sie sich bitte mit unserem Support in Verbindung. Im Lieferumfang der ''S7-SoftSPS'' ist ebenfalls ein Objekt enthalten, welches einen Datenzugriff aus Scriptsprachen (VB Script, J Script) heraus ermöglicht.