S7-SoftSPS:Datenschnittstelle: Unterschied zwischen den Versionen

Aus IBHsoftec Wiki
Wechseln zu: Navigation, Suche
Zeile 124: Zeile 124:
 
Schreibt mehrere Werte in die ''S7-SoftSPS''.
 
Schreibt mehrere Werte in die ''S7-SoftSPS''.
  
−
<table>
+
{|
−
<tbody>
+
|-
−
<tr class="odd">
+
| unsigned long int DLLexport WriteVals || (unsigned long int typ,
−
<td align="left">unsigned long int DLLexport WriteVals</td>
+
|-
−
<td align="left">(unsigned long int typ,</td>
+
|  || unsigned long int nr,
−
</tr>
+
|-
−
<tr class="even">
+
|  || unsigned long int DBNr,
−
<td align="left"> </td>
+
|-
−
<td align="left">unsigned long int nr,</td>
+
|  || unsigned long int size,
−
</tr>
+
|-
−
<tr class="odd">
+
|  || unsigned long int far * vals);,
−
<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 />
 
  
−
 
+
{| 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<br />'E'<br />'A'<br />'M'<br />'B'<br />'D' || <br />Angabe in Bytes<br />Angabe in Bytes<br />Angabe in Bytes<br />Angabe in Bytes<br />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 />
+
|}
−
 <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.
 
Länge der Parameterliste (Visual-C): 20 Bytes.
Zeile 215: Zeile 159:
 
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'''<br />
+
'''DB lesen'''
−
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 />
+
Liest den Inhalt eines Datenbausteines aus der ''S7-SoftSPS''.
  
 +
{|
 +
|-
 +
| unsigned long int DLLexport ReadDB || (unsigned long int nr,
 +
|-
 +
|  || unsigned short int far * Baustein,
 +
|-
 +
|  || unsigned long int far * Anzahl,
 +
|-
 +
|  || unsigned long int Synchron);
 +
|}
  
−
<table>
+
{| class="wikitable"
−
<tbody>
+
|-
−
<tr class="odd">
+
! Parameter !! Beschreibung !!  Kommentar
−
<td align="left">Parameter</td>
+
|-
−
<td align="left">Beschreibung</td>
+
| nr || DB-Nummer || 1..16383
−
<td align="left">Kommentar</td>
+
|-
−
</tr>
+
| Baustein ||  Zeiger auf den DB-Inhalt || Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.<br />Achtung: Das Feld muss groß genug sein!
−
<tr class="even">
+
|-
−
<td align="left">nr</td>
+
| Anzahl || Anzahl der Worte, die aus dem Baustein gelesen werden sollen || Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.
−
<td align="left">DB-Nummer</td>
+
Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.
−
<td align="left">1..16383</td>
+
|-
−
</tr>
+
| Synchron || Immer 0 || Bei S7 ohne Bedeutung
−
<tr class="odd">
+
|-
−
<td align="left">Baustein</td>
+
| Rückgabe ||  0 bei Fehler || Fehlermeldungen
−
<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.
 
Länge der Parameterliste (Visual-C): 16 Bytes.

Version vom 5. November 2012, 15:06 Uhr

Von verschiedenen Programmiersystemen (z.B. Visual Basic®, Visual C/C++® oder Borland C++Builder®) 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);,


Parameter Beschreibung Kommentar
typ 'E' = Eingang
'A' = Ausgang
'M' = Merker
'Z' = Zählerwert
'T' = Zeitwert
'D' = Datenwort oder Datendoppelwort
'B' = Datenbit,-byte,-wort,-doppelwort
auf Byteadresse
'P' = P_Parameter


nur 16-Bit-Zugriff
nur 16-Bit-Zugriff
abhängig vom Parameter size

abhängig von size
S7 kompatibel, nur S7!
nur S7 ab Version 3!

nr Adresse Byteadresse des einzulesenden Operanden
DBNr Datenbaustein Nummer 1 – 16383
size Anzahl der Bits
0..7= Bit Nr 0 7
8 = 1 Byte
16 = 1 Wort
32 = 1 Doppelwort

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

Schreibt einen Wert in die S7-SoftSPS.

unsigned long int DLLexport WriteVal (unsigned long int typ,
unsigned long int nr,
unsigned long int DBNr,
unsigned long int size,
unsigned long int far * val);,
Parameter Beschreibung Kommentar
typ 'E' = Eingang
'A' = Ausgang
'M' = Merker
'Z' = Zählerwert
'T' = Zeitwert
'D' = Datenwort oder Datendoppelwort
'B' = Datenbit,-byte,-wort,-doppelwort
auf Byteadresse
'P' = P_Parameter


nur 16-Bit-Zugriff
nur 16-Bit-Zugriff
abhängig vom Parameter size

abhängig von size
S7 kompatibel, nur S7!
nur S7 ab Version 3!

nr Adresse Byteadresse des einzulesenden Operanden
DBNr Datenbaustein Nummer 1 – 16383
size Anzahl der Bits
0..7= Bit Nr 0 7
8 = 1 Byte
16 = 1 Wort
32 = 1 Doppelwort

nur 'E','A','M'
val Zu schreibender Wert
Rückgabe 0 bei Fehler Fehlermeldungen

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


Mehrere Werte lesen Liest mehrere Werte aus der S7-SoftSPS.

unsigned long int DLLexport ReadVals (unsigned long int typ,
unsigned long int nr,
unsigned long int DBNr,
unsigned long int size,
unsigned long int far * vals);,
Parameter Beschreibung Kommentar
typ 'E' = Eingang
'A' = Ausgang
'M' = Merker
'D' = Datenwort
'B' = Datenbyte auf Byteadresse


S5 kompatibel
S7 kompatibel, nur S7!
nr Adresse
DBNr Datenbaustein Nummer 1 – 16383
size Anzahl der Bytes oder Datenworte Bei typ: 'E', 'A', 'M' und 'B' Angabe in Bytes, bei 'D' Angabe in Datenworten.
vals Byte-Werte Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.
Achtung: Das Feld muss groß genug sein!
Rückgabe 0 bei Fehler Fehlermeldungen

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

Schreibt mehrere Werte in die S7-SoftSPS.

unsigned long int DLLexport WriteVals (unsigned long int typ,
unsigned long int nr,
unsigned long int DBNr,
unsigned long int size,
unsigned long int far * vals);,


Parameter Beschreibung Kommentar
typ 'E' = Eingang
'A' = Ausgang
'M' = Merker
'D' = Datenwort
'B' = Datenbyte auf Byteadresse


S5 kompatibel
S7 kompatibel, nur S7!
nr Adresse
DBNr Datenbaustein Nummer 1 – 16383
size Anzahl der Bytes oder Datenworte
'E'
'A'
'M'
'B'
'D'
Angabe in Bytes
Angabe in Bytes
Angabe in Bytes
Angabe in Bytes
Angabe in Datenworten.
vals Byte-Werte Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.
Achtung: Das Feld muss groß genug sein!
Rückgabe 0 bei Fehler Fehlermeldungen

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

Liest den Inhalt eines Datenbausteines aus der S7-SoftSPS.

unsigned long int DLLexport ReadDB (unsigned long int nr,
unsigned short int far * Baustein,
unsigned long int far * Anzahl,
unsigned long int Synchron);
Parameter Beschreibung Kommentar
nr DB-Nummer 1..16383
Baustein Zeiger auf den DB-Inhalt Pointer auf ein gültiges Array im Adressraum Ihrer Applikation.
Achtung: Das Feld muss groß genug sein!
Anzahl Anzahl der Worte, die aus dem Baustein gelesen werden sollen Falls der DB kleiner als die Anzahl ist, wird automatisch die Anzahl heruntergesetzt.

Pointer auf eine gültige Variable im Adressraum Ihrer Applikation.

Synchron Immer 0 Bei S7 ohne Bedeutung
Rückgabe 0 bei Fehler Fehlermeldungen

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

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

DB schreiben

Beschreibt einen Datenbaustein in der SPS.
<tbody> </tbody>
unsigned long int DLLexport WriteDB (unsigned long int nr,
  unsigned short int far * Baustein,
  unsigned long int far * Anzahl,
  unsigned long int Synchron);



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

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

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

DB lesen S7

Liest den Inhalt eines S7-Datenbausteines in der SPS (Byteorientiert).
<tbody> </tbody>
unsigned long int DLLexport ReadDB_S7 (unsigned long int nr,
  unsigned char int far * Baustein,
  unsigned long int far * Anzahl);



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

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

DB schreiben S7

Beschreibt den Inhalt eines S7-Datenbausteines in der SPS (Byteorientiert).
<tbody> </tbody>
unsigned long int DLLexport WriteDB_S7 (unsigned long int nr,
  unsigned char int far * Baustein,
  unsigned long int far * Anzahl);



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

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

Funktionen zur Zahlenumwandlung

FloatToMC5

Wandelt Gleitpunktzahlen im IBM-PC-Format in S7-Doppelwörter um.
<tbody> </tbody>
void DLLexport FloatToMC5 (float FloatValue,
  unsigned long far * MC5Val);



<tbody> </tbody>
Parameter Beschreibung Kommentar
FloatVal Gleitpunktzahl im IEEE- bzw. INTEL-Format  
MC5Val Gleitpunktzahl im Siemens-S7-Format  

MC5ToFloat

Wandelt S7-Doppelwörter in Gleitpunktzahlen im IBM-PC-Format um.
<tbody> </tbody>
void DLLexport MC5ToFloat (unsigned long far * MC5Val
  float FloatVal);



<tbody> </tbody>
Parameter Beschreibung Kommentar
MC5Val Gleitpunktzahl im Siemens-S7-Format  
FloatVal Gleitpunktzahl im IEEE- bzw. INTEL-Format  

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.

Von „https://wiki.ibhsoftec.com/de/index.php?title=S7-SoftSPS:Datenschnittstelle&oldid=2505“