SIMATIC S7 Connector

Dieser Adapter ermöglicht das Anbinden von Siemens SIMATIC S7-Systemen als SPS aus Technical Processes heraus. Dabei lassen sich sowohl Daten aus der Steuerung auslesen als auch an diese übermitteln. Über eine XML-Input-Struktur kann bestimmt werden, welche Daten gelesen bzw. geschrieben werden sollen. Es können SIMATIC-Systeme der Reihe S7-200, 300, 400 angebunden werden.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

Read: Daten aus der SPS auslesen
Write: Daten in die SPS schreiben

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter.s7.S7Connector`: Hauptklasse (Standard)
host	Adresse, über welche die SPS im Netzwerk erreichbar ist Mögliche Werte: IP-Adresse oder Host-Name
rack	Rack, das auf der SPS angesprochen werden soll Mögliche Werte: Nummer des Racks (beim SPS-Entwickler zu erfragen)
slot	Slot, der auf der SPS angesprochen werden soll Mögliche Werte: Nummer des Slots (beim SPS-Entwickler zu erfragen)

Statuswerte

1 (ok)	Erfolgreiche Kommunikation (Lesen oder Schreiben) mit der SPS
-1 (error)	Fehler bei der Kommunikation (Lesen oder Schreiben) mit der SPS Eine Fehlermeldung wird zurückgegeben

Input

Dieser Adapter erwartet jeweils ein XML-Dokument mit folgender Input-Struktur:

Operation Read

XML

<Read dbnum="[DBNUM]" bytes="[LENGTH]" offset="[OFFSET]">
	<FELDNAME s7type="[TYP]" s7size="[LENGTH]" />
	...
</Read>

Parameter:

dbnum: DBNummer von der gelesen werden soll (beim SPS-Entwickler zu erfragen)
bytes: Anzahl der zu lesenden Bytes
offset: Offset in Bytes, ab dem gelesen werden soll
Die Elemente FELDNAME sind frei wählbar
s7type: Typ des zu lesenden Feldes;
Mögliche Werte:
- Array
- Bit (Hinweis: liest nur 1 Bit, daher müssen immer 8 Felder angegeben werden!)
- Byte
- DateAndTime
- Date (im Format yyyy-MM-dd'T'HH:mm:ss)
- Integer
- Long
- Real
- String
- Time (als Long)
s7size: Länge in Bytes, die für das Feld gelesen werden sollen. Nur für die Typen Array und String notwendig

Operation Write

XML

<Write dbnum="DBNUM" bytes="LENGTH" offset="OFFSET">
	<FELDNAME s7type="String" s7size="12">[WERT]</AUFNR>
	...
</Write>

Parameter:

siehe Operation Read
Der WERT des Elements muss syntaktisch zum Typ passen

Output

Dieser Adapter gibt ein XML-Dokument mit folgendem Aufbau zurück:

Operation Read: Die Ausgabe entspricht der Eingabe, die Elemente sind bei Erfolg jeweils mit den passenden Werten gefüllt
Operation Write: Die Ausgabe entspricht der Eingabe