Sie sind auf Seite 1von 144

SIMATIC Automation Tool V2.

___________________
Vorwort

Benutzerhandbuch

SIMATIC Automation Tool 1


___________________
bersicht

SIMATIC

Voraussetzungen und
Einrichten der
Kommunikation

S7
SIMATIC Automation Tool V2.1
Benutzerhandbuch
Gertehandbuch

2
___________
3
___________________
Toolfunktionen
Speichern der
4
___________________
Gertetabelleninformationen
Mens, Symbolleiste und
___________________
5
Tastenkombinationen
SIMATIC Automation Tool
___________________
6
API fr .NET Framework
Untersttzte Gerte im
___________________
7
SIMATIC Automation Tool
Netzwerkbeispiel und API___________________
A
Schnittstellen

V2.1.1 07/2016
A5E36151946 AB

Rechtliche Hinweise
Warnhinweiskonzept
Dieses Handbuch enthlt Hinweise, die Sie zu Ihrer persnlichen Sicherheit sowie zur Vermeidung von
Sachschden beachten mssen. Die Hinweise zu Ihrer persnlichen Sicherheit sind durch ein Warndreieck
hervorgehoben, Hinweise zu alleinigen Sachschden stehen ohne Warndreieck. Je nach Gefhrdungsstufe
werden die Warnhinweise in abnehmender Reihenfolge wie folgt dargestellt.
GEFAHR
bedeutet, dass Tod oder schwere Krperverletzung eintreten wird, wenn die entsprechenden
Vorsichtsmanahmen nicht getroffen werden.
WARNUNG
bedeutet, dass Tod oder schwere Krperverletzung eintreten kann, wenn die entsprechenden
Vorsichtsmanahmen nicht getroffen werden.
VORSICHT
bedeutet, dass eine leichte Krperverletzung eintreten kann, wenn die entsprechenden Vorsichtsmanahmen
nicht getroffen werden.
ACHTUNG
bedeutet, dass Sachschaden eintreten kann, wenn die entsprechenden Vorsichtsmanahmen nicht getroffen
werden.
Beim Auftreten mehrerer Gefhrdungsstufen wird immer der Warnhinweis zur jeweils hchsten Stufe verwendet.
Wenn in einem Warnhinweis mit dem Warndreieck vor Personenschden gewarnt wird, dann kann im selben
Warnhinweis zustzlich eine Warnung vor Sachschden angefgt sein.

Qualifiziertes Personal
Das zu dieser Dokumentation zugehrige Produkt/System darf nur von fr die jeweilige Aufgabenstellung
qualifiziertem Personal gehandhabt werden unter Beachtung der fr die jeweilige Aufgabenstellung zugehrigen
Dokumentation, insbesondere der darin enthaltenen Sicherheits- und Warnhinweise. Qualifiziertes Personal ist
auf Grund seiner Ausbildung und Erfahrung befhigt, im Umgang mit diesen Produkten/Systemen Risiken zu
erkennen und mgliche Gefhrdungen zu vermeiden.

Bestimmungsgemer Gebrauch von Siemens-Produkten


Beachten Sie Folgendes:
WARNUNG
Siemens-Produkte drfen nur fr die im Katalog und in der zugehrigen technischen Dokumentation
vorgesehenen Einsatzflle verwendet werden. Falls Fremdprodukte und -komponenten zum Einsatz kommen,
mssen diese von Siemens empfohlen bzw. zugelassen sein. Der einwandfreie und sichere Betrieb der
Produkte setzt sachgemen Transport, sachgeme Lagerung, Aufstellung, Montage, Installation,
Inbetriebnahme, Bedienung und Instandhaltung voraus. Die zulssigen Umgebungsbedingungen mssen
eingehalten werden. Hinweise in den zugehrigen Dokumentationen mssen beachtet werden.

Marken

Alle mit dem Schutzrechtsvermerk gekennzeichneten Bezeichnungen sind eingetragene Marken der
Siemens AG. Die brigen Bezeichnungen in dieser Schrift knnen Marken sein, deren Benutzung durch Dritte fr
deren Zwecke die Rechte der Inhaber verletzen kann.

Haftungsausschluss
Wir haben den Inhalt der Druckschrift auf bereinstimmung mit der beschriebenen Hard- und Software geprft.
Dennoch knnen Abweichungen nicht ausgeschlossen werden, so dass wir fr die vollstndige bereinstimmung
keine Gewhr bernehmen. Die Angaben in dieser Druckschrift werden regelmig berprft, notwendige
Korrekturen sind in den nachfolgenden Auflagen enthalten.

Siemens AG
Division Digital Factory
Postfach 48 48
90026 NRNBERG
DEUTSCHLAND

A5E36151946 AB
07/2016 nderungen vorbehalten

Copyright Siemens AG 2016.


Alle Rechte vorbehalten

Vorwort
Service & Support
Zustzlich zu unserem Dokumentations-Angebot bietet Siemens Ihnen im Internet
technisches Know-how auf der Kundensupport-Website
(https://www.siemens.com/automation/) an.
Falls Sie technische Fragen haben, eine Schulung bentigen oder S7-Produkte bestellen
wollen, wenden Sie sich bitte an Ihre Siemens-Vertretung. Das technisch geschulte
Vertriebspersonal verfgt ber sehr spezifische Kenntnisse zu Einsatzmglichkeiten und
Prozessen sowie zu den verschiedenen Siemens-Produkten und kann Ihnen deshalb am
schnellsten und besten weiterhelfen, wenn Probleme auftreten.

Sprache des Quelldokuments


Mageblich fr Informationen ber das SIMATIC Automation Tool ist die englischsprachige
Fassung des Handbuchs SIMATIC Automation Tool Benutzerhandbuch . Alle bersetzten
Handbcher beziehen sich auf das englische Handbuch als magebliche und/oder
ursprngliche Quelle. Bei Abweichungen in den bersetzten Handbchern bestimmt
Siemens das englische Handbuch als magebliche und/oder ursprngliche Quelle.

Security-Hinweise
Siemens bietet Produkte und Lsungen mit Industrial Security-Funktionen an, die den
sicheren Betrieb von Anlagen, Systemen, Maschinen und Netzwerken untersttzen.
Um Anlagen, Systeme, Maschinen und Netzwerke gegen Cyber-Bedrohungen zu sichern, ist
es erforderlich, ein ganzheitliches Industrial Security-Konzept zu implementieren (und
kontinuierlich aufrechtzuerhalten), das dem aktuellen Stand der Technik entspricht. Die
Produkte und Lsungen von Siemens formen nur einen Bestandteil eines solchen Konzepts.
Der Kunde ist dafr verantwortlich, unbefugten Zugriff auf seine Anlagen, Systeme,
Maschinen und Netzwerke zu verhindern. Systeme, Maschinen und Komponenten sollten
nur mit dem Unternehmensnetzwerk oder dem Internet verbunden werden, wenn und soweit
dies notwendig ist und entsprechende Schutzmanahmen (z.B. Nutzung von Firewalls und
Netzwerksegmentierung) ergriffen wurden.
Zustzlich sollten die Empfehlungen von Siemens zu entsprechenden Schutzmanahmen
beachtet werden. Weiterfhrende Informationen ber Industrial Security finden Sie unter
(http://www.industry.siemens.com/topics/global/de/industrial-security/Seiten/default.aspx).
Die Produkte und Lsungen von Siemens werden stndig weiterentwickelt, um sie noch
sicherer zu machen. Siemens empfiehlt ausdrcklich, Aktualisierungen durchzufhren,
sobald die entsprechenden Updates zur Verfgung stehen und immer nur die aktuellen
Produktversionen zu verwenden. Die Verwendung veralteter oder nicht mehr untersttzter
Versionen kann das Risiko von Cyber-Bedrohungen erhhen.
Um stets ber Produkt-Updates informiert zu sein, abonnieren Sie den Siemens Industrial
Security RSS Feed unter (https://support.industry.siemens.com/cs/ww/de/).

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Vorwort

SIMATIC Automation Tool V2.1 Benutzerhandbuch

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Inhaltsverzeichnis
Vorwort ................................................................................................................................................... 3
1

SIMATIC Automation Tool - bersicht ..................................................................................................... 9


1.1

Verwalten von Netzwerken ....................................................................................................... 9

1.2

Netzwerkzugriff .......................................................................................................................13

1.3

Netzwerkoptionen ...................................................................................................................15

1.4

.NET API (Anwendungsschnittstelle) - DLL-Datei ..................................................................17

Voraussetzungen und Einrichten der Kommunikation ............................................................................ 19


2.1

PG/PC-Betriebssystemvoraussetzungen ...............................................................................19

2.2

Installieren des SIMATIC Automation Tools ...........................................................................20

2.3

Aufrufen des SIMATIC Automation Tools ...............................................................................21

2.4

Voraussetzungen fr die CPU-Konfiguration ..........................................................................21

2.5

Einrichten der Kommunikation ................................................................................................24

Toolfunktionen ...................................................................................................................................... 27
3.1

CPU-Passwrter .....................................................................................................................27

3.2

Scannen eines Netzwerks und Verwenden der Gertetabelle ...............................................28

3.3

Laden neuer IP-, Subnetz- und Gateway-Adressen ...............................................................34

3.4

Laden neuer PROFINET-Gertenamen .................................................................................35

3.5

Versetzen von CPUs in die Betriebsart RUN oder STOP ......................................................36

3.6

LED-Blinken an Gerten. ........................................................................................................38

3.7

Laden neuer Programme in CPUs ..........................................................................................39

3.8

Installieren neuer Firmware in CPUs und Modulen ................................................................43

3.9

Sichern und Wiederherstellen von CPU-Daten ......................................................................48

3.10

Rcksetzen von CPUs und Modulen auf die Werkseinstellungen .........................................52

3.11

Urlschen des CPU-Speichers ...............................................................................................54

3.12

Laden von Servicedaten aus CPUs ........................................................................................55

3.13

Einstellen der Uhrzeit in CPUs ...............................................................................................57

3.14

Lesen des Diagnosepuffers in einer CPU ..............................................................................58

3.15

Reihenfolge der Ausfhrung von Prozessen ..........................................................................59

Speichern der Gertetabelleninformationen........................................................................................... 61


4.1

"Save"/"Save as" - Speichern der Gertetabelle in verschlsseltem SAT-Format.................61

4.2

"Import"/"Export" - Laden/Speichern der Gertetabelle aus/in offenem CSV-Format ............62

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Inhaltsverzeichnis

Mens, Symbolleiste und Tastenkombinationen .................................................................................... 65


5.1
5.1.1
5.1.2
5.1.3
5.1.4
5.1.5

Hauptmen............................................................................................................................. 65
Men "File" ............................................................................................................................. 65
Men "Edit" ............................................................................................................................ 66
Men "Network" ..................................................................................................................... 67
Men "Tools" .......................................................................................................................... 68
Men "Help" ........................................................................................................................... 70

5.2

Symbole der Symbolleiste ..................................................................................................... 71

5.3

Tastenkombinationen ............................................................................................................. 72

SIMATIC Automation Tool API fr .NET Framework .............................................................................. 73


6.1

Einfhrung in die API ............................................................................................................. 73

6.2

bersicht ber die Architektur................................................................................................ 74

6.3

Verweis auf die API in einer Kundenapplikation .................................................................... 76

6.4
6.4.1
6.4.2
6.4.3

Hufig zur Untersttzung verwendete Klassen...................................................................... 77


Klasse EncryptedString .......................................................................................................... 77
Passwort fr fehlersicheren Betrieb ....................................................................................... 78
Klasse Result ......................................................................................................................... 78

6.5
6.5.1
6.5.2
6.5.3
6.5.4
6.5.5

Die Klasse Network ................................................................................................................ 80


Network-Constructor .............................................................................................................. 80
Methode QueryNetworkInterfaceCards ................................................................................. 81
Methode SetCurrentNetworkInterface ................................................................................... 82
Eigenschaft CurrentNetworkInterface .................................................................................... 82
Methode ScanNetworkDevices .............................................................................................. 83

6.6
6.6.1
6.6.2
6.6.2.1
6.6.2.2
6.6.2.3
6.6.3
6.6.3.1
6.6.3.2
6.6.4
6.6.4.1
6.6.4.2
6.6.4.3

Klasse IProfinetDeviceCollection ........................................................................................... 84


Elemente in der Sammlung iterieren...................................................................................... 84
Elemente in der Sammlung filtern .......................................................................................... 85
Elemente der Sammlung ....................................................................................................... 85
Methode FilterByDeviceFamily .............................................................................................. 85
Methode FilterOnlyCPUs ....................................................................................................... 86
Auffinden eines bestimmten Gerts in der Sammlung .......................................................... 87
Methode FindDeviceByIP ...................................................................................................... 87
Methode FindDeviceByMAC .................................................................................................. 88
Serialisierung ......................................................................................................................... 89
bertragen einer Sammlung an/von einer externen Datendatei ........................................... 89
Methode WriteToStream ........................................................................................................ 89
Methode ReadFromStream ................................................................................................... 90

6.7
6.7.1
6.7.2
6.7.2.1
6.7.2.2
6.7.2.3
6.7.2.4
6.7.2.5
6.7.2.6
6.7.3
6.7.3.1

Schnittstelle IProfinetDevice .................................................................................................. 91


IProfinetDevice-Eigenschaften............................................................................................... 91
IProfinetDevice-Methoden ..................................................................................................... 94
Methode RefreshStatus ......................................................................................................... 94
Methode FirmwareUpdate ..................................................................................................... 95
Methode FlashLED ................................................................................................................ 97
Rcksetzmethode .................................................................................................................. 98
Methode SetIP ....................................................................................................................... 99
Methode SetProfinetName ................................................................................................... 100
IProfinetDevice-Ereignisse ................................................................................................... 101
Ereignis DataChanged ......................................................................................................... 101
SIMATIC Automation Tool V2.1 Benutzerhandbuch

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Inhaltsverzeichnis

6.7.3.2

Ereignis ProgressChanged ...................................................................................................102

6.8
6.8.1
6.8.2

Klasse IModuleCollection und Moduleigenschaften .............................................................104


Klasse IModuleCollection .....................................................................................................104
Schnittstelle IModule .............................................................................................................104

6.9
6.9.1
6.9.2
6.9.3
6.9.3.1
6.9.3.2
6.9.3.3
6.9.3.4
6.9.3.5
6.9.3.6
6.9.3.7
6.9.3.8
6.9.3.9
6.9.3.10
6.9.3.11
6.9.3.12
6.9.4
6.9.4.1
6.9.4.2

Schnittstelle ICPU .................................................................................................................106


Dient zur Identifikation von CPU-Gerten in einer IProfinetDeviceCollection ......................106
Eigenschaften von ICPU .......................................................................................................107
ICPU-Methoden ....................................................................................................................107
Geschtzte CPUs und Passwrter .......................................................................................107
Sicherungsmethode ..............................................................................................................108
Methode GetCurrentDateTime .............................................................................................109
Methode GetDiagnosticsBuffer .............................................................................................110
Methode GetOperatingState .................................................................................................111
Methode MemoryReset.........................................................................................................112
Methode ProgramUpdate .....................................................................................................113
Methode ResetToFactory .....................................................................................................114
Methode Restore ..................................................................................................................115
Methode SetOperatingState .................................................................................................116
Methode SetCurrentDateTime ..............................................................................................117
Methode UploadServiceData ................................................................................................118
Eigenschaften RemoteInterfaces ..........................................................................................119
Dezentrale Peripheriemodule ...............................................................................................119
IRemoteInterface-Eigenschaften ..........................................................................................120

6.10
6.10.1
6.10.2
6.10.3
6.10.4
6.10.5
6.10.6
6.10.7
6.10.8

Enumerationen ......................................................................................................................124
DataChangedType ................................................................................................................124
DeviceFamily ........................................................................................................................124
ErrorCode .............................................................................................................................125
OperatingState ......................................................................................................................126
OperatingStateREQ ..............................................................................................................126
ProgressAction ......................................................................................................................127
RemoteInterfaceType ...........................................................................................................127
FeatureSupport .....................................................................................................................128

Untersttzte Gerte im SIMATIC Automation Tool ............................................................................... 129


7.1

Nicht erkannte Firmware-Versionen und Gerte ..................................................................129

7.2

Untersttzung der S7-1200 CPU ..........................................................................................129

7.3

Untersttzung der S7-1500 CPUs ........................................................................................130

7.4

Untersttzung der ET 200SP CPU (Dezentrale Peripheriesteuerung auf Basis von ET


200SP und S7-1500) ............................................................................................................131

7.5

Untersttzung von ET 200SP (PROFINET I/O) ....................................................................132

7.6

Untersttzung von ET 200MP (PROFINET I/O) ...................................................................132

7.7

Untersttzung von ET 200AL (PROFINET I/O) ....................................................................133

7.8

Untersttzung von ET 200S (PROFINET I/O) ......................................................................134

7.9

Untersttzung von ET 200M (PROFINET I/O) .....................................................................135

7.10

Untersttzung von ET 200eco (PROFINET I/O) ...................................................................135

7.11

Untersttzung von ET 200pro (PROFINET I/O) ...................................................................136

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Inhaltsverzeichnis

Netzwerkbeispiel und API-Schnittstellen...............................................................................................137


A.1

Netzwerkbeispiel .................................................................................................................. 137

Index ...................................................................................................................................................141

SIMATIC Automation Tool V2.1 Benutzerhandbuch

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.1

Verwalten von Netzwerken

Verwalten von SIMATIC-Gertenetzwerken


Nachdem ein Steuerungsprogramm mit der TIA Portal-Software von Siemens erstellt und
geprft wurde, kann das SIMATIC Automation Tool zum Konfigurieren, Betreiben, Warten
und Dokumentieren von Automatisierungsnetzwerken genutzt werden.
Wenn Sie ein Netzwerk mit vielen Gerten verwalten, kann das SIMATIC Automation Tool
Vorgnge vereinfachen und Zeit sparen, indem eine Gruppe von Gerten mit mehreren
Verarbeitungs-Threads automatisch verarbeitet wird. Whrend ein PG/PCKommunikationsverarbeitungs-Thread mit einem Gert verbunden ist und auf eine Nachricht
wartet, dass ein SIMATIC-Gert seine Aufgabe beendet hat, knnen andere Threads in
dieser Zeit mit anderen Gerten in der Gruppe kommunizieren.
Funktionalitten des SIMATIC Automation Tools
Scannen des Netzwerks und Erstellen einer Tabelle, die die erreichbaren Gerte im
Netzwerk abbildet. Nicht konfigurierte und konfigurierte CPUs und Module sind in der
Tabelle enthalten, die in einer sicheren SAT-Projektdatei hinterlegt ist.
LED-Blinken an einem Gert zum physischen Lokalisieren des Gerts
Laden von Adressen (IP, Subnetz, Gateway) in ein Gert
Laden des PROFINET-Namens (Stationsname) in ein Gert
Einstellen der Zeit in einer CPU auf die aktuelle Zeit Ihres PGs/PCs
(Programmiergert/Personal Computer)
Laden eines neuen Programms in eine CPU
Laden eines Firmware-Updates in eine CPU oder in ein Modul
Versetzen einer CPU in die Betriebsart RUN oder STOP
Urlschen eines CPU-Speichers
Lesen des Diagnosepuffers einer CPU
Laden von Servicedaten aus einer CPU
Sichern/Wiederherstellen von CPU-Daten in/aus einer Sicherungsdatei
Rcksetzen von Gerten auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.1 Verwalten von Netzwerken
Support fr SIMATIC-Gerte
Das SIMATIC Automation Tool untersttzt Standard- und fehlersichere CPUs sowie
Peripheriemodule.
Die sicherheitsrelevanten Vorgnge Rcksetzen auf Werkseinstellungen, Wiederherstellen
aus Sicherungsdatei und Programmaktualisierung sind bei fehlersicheren CPUs nicht
zulssig.
Bei bestimmten Gerten werden einige der Funktionen im SIMATIC Automation Tool nicht
untersttzt.
Klicken Sie auf ein Gert, um Informationen zur Untersttzung zu erhalten.
S7-1200 CPU (Seite 129)
S7-1500 CPU (Seite 130)
ET 200SP CPU (dezentrale Steuerung basierend auf ET 200SP und S7-1500) (Seite 131)
ET 200SP (PROFINET I/O) (Seite 132)
ET 200MP (PROFINET I/O) (Seite 132)
ET 200AL (PROFINET I/O) (Seite 133)
ET 200S (PROFINET I/O) (Seite 134)
ET 200M PROFINET I/O) (Seite 135)
ET 200eco (PROFINET I/O) (Seite 135)
ET 200pro (PROFINET I/O) (Seite 136)

SIMATIC Automation Tool V2.1 Benutzerhandbuch

10

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.1 Verwalten von Netzwerken

Beispiel einer S7-1200-Netzwerkinstallation

Panel Shop-Herstellung und erstmaliges Laden des Programms


Jede CPU verwendet dieselbe Hardwarekonfiguration und dasselbe
Steuerungsprogramm
Die CPU PROFINET-Konfiguration nutzt die Optionen "Set IP Address on the device" und
"Set PROFINET device name on the device"
Jedes Panel ist identisch
Der Panel Shop verwendet eine SD-Karte oder das TIA Portal zum Laden des CPUProgramms.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

11

SIMATIC Automation Tool - bersicht


1.1 Verwalten von Netzwerken
Feldinstallation und Funktionen
Scannen eines Netzwerks zum Suchen von CPUs und Modulen
LED-Blinken zum Identifizieren eines Gerts
Gerteweises Zuweisen von IP-Adressen und PROFINET-Namen beim Einrichten des
Netzwerks
Einstellen der Zeit der CPUs auf die aktuelle Zeit Ihres PGs/PCs
Aktualisieren von CPU-Programm/Firmware und Modulfirmware
Versetzen von CPUs in die Betriebsart RUN oder STOP
Lesen eines CPU-Diagnosepuffers und Laden von Servicedaten
Urlschen eines CPU-Speichers
Durchfhren von CPU-Datensicherungs- und Wiederherstellungsvorgngen
Dokumentieren und Speichern von Netzwerkinformationen in einer Standardtext-CSVDatei oder in einer verschlsselten und passwortgeschtzten SAT-Datei.
Einsparen von Zeit durch Arbeiten mit Gertegruppen und Verwenden von parallelen
Verarbeitungs-Threads

SIMATIC Automation Tool V2.1 Benutzerhandbuch

12

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.2 Netzwerkzugriff

1.2

Netzwerkzugriff

Kommunikation mit Siemens-Gerten


Mit einem Netzwerk direkt verbundene PROFINET-Gerte werden mithilfe der MAC-Adresse
(Media Access Control) erkannt. Jedes Gert besitzt eine eindeutige MAC-Adresse, die nicht
gendert werden kann und auf das Gert aufgedruckt ist. Angeschlossene PROFINETGerte werden erkannt, wenn Sie eine konfigurierte IP-, Subnetz- oder Gateway-Adresse
haben oder nicht konfiguriert (Adressen sind 0.0.0.0) sind.
Eine direkt angeschlossene CPU muss dennoch eine gltige IP-Adresse besitzen, bevor der
CPU nachgeschaltete Kommunikationsmodule, Signalmodule und die dezentrale Peripherie
in der Gertetabelle des SIMATIC Automation Tools angezeigt werden.
Beispielsweise besitzt eine S7-1500 CPU eine PROFINET-Netzwerkverbindung zum
SIMATIC Automation Tool und nutzt eine lokale CP-Karte, um eine Verbindung zu einem
anderen PROFINET-Netzwerk herzustellen, in dem dezentrale Peripherie angeschlossen ist.
Sie mssen der S7-1500 CPU eine gltige IP-Adresse zuweisen, bevor die dezentrale
Peripherie in der Gertetabelle des SIMATIC Automation Tools sichtbar wird.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

13

SIMATIC Automation Tool - bersicht


1.2 Netzwerkzugriff
Die Art des Netzwerkzugriffs hngt von dem von Ihnen ausgefhrten Befehl ab, wie in der
folgenden Tabelle dargestellt wird.
SIMATIC Automation Tool
-Befehl

Verwendete
Gerteadresse

CPU-Passwort fr
geschtzte CPU
erforderlich

Scannen (Erkennen von CPUs und


Peripheriegerten)

MAC

Nein

LED-Blinken an Gerten

MAC

Nein

Einstellen von IP-Adresse, Subnetzmaske und Gateway-Adresse


in Gerten

MAC

Nein

Einstellen des PROFINET-Namens


in Gerten

MAC

Nein

Rcksetzen von Gerten auf die


Werkseinstellungen
(nur PROFINET I/O-Devices)

MAC

Setzen der CPU-Zeit auf PG/PCZeit

IP

Laden des Programms in CPUs

PG/PC- und Gertekonnektivitt

Lokales Netzwerk: Sie knnen ber EthernetSwitches auf Gerte zugreifen, doch knnen
Sie nicht ber einen IP-Adressen-Router auf
Gerte in einem anderen Netzwerk zugreifen.

VPN-Anbindung (Virtual Private Network) an


lokales Netzwerk

Ja

IP

Ja

Lokales Netzwerk: Sie knnen ber EthernetSwitches auf Gerte zugreifen.

Laden neuer Firmware in CPUs


und Peripheriegerte

IP

Ja

Remote-Netzwerk: Sie knnen ber einen IPAdressen-Router auf Gerte in einem anderen
Netzwerk zugreifen.

Versetzen von CPUs in RUN oder


STOP

IP

Ja

VPN-Anbindung an lokales Netzwerk

Setzen der CPU-Zeit auf PG/PCZeit

IP

Ja

Urlschen des CPU-Speichers

IP

Ja

Lesen des CPU-Diagnosepuffers

IP

Ja

Laden von Servicedaten aus CPUs

IP

Ja

Sichern/Wiederherstellen von CPUDaten

IP

Ja

Rcksetzen von Gerten auf die


Werkseinstellungen
(nur CPU-Gerte)

IP

Ja

Hinweis
Zuweisen der IP-Subnetzmaske in einem lokalen Netzwerk
Der PG/PC, auf dem das SIMATIC Automation Tool installiert ist, und an das lokale
Netzwerk angeschlossene Gerte mssen dieselbe Subnetzmaske verwenden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

14

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.3 Netzwerkoptionen

1.3

Netzwerkoptionen

Lokale und dezentrale Netzwerke


Die folgenden Beispiele zeigen lokale und dezentrale Netzwerke, die das SIMATIC
Automation Tool nutzen kann. Zur besseren Darstellung der grundlegenden Konnektivitt
sind die Diagramme vereinfacht und zeigen keine lokale Peripherie, CPs und dezentrale
Peripheriegerte (PROFINET und PROFIBUS), auf die ebenfalls zugegriffen werden kann.
Auch andere Netzwerktopologien sind mglich.
Die IP-Adressierung und demzufolge gltige Netzwerk-IP-Adressen sind notwendig, um auf
Komponenten hinter Ethernet-IP-Routern zuzugreifen. Sie knnen eine SIMATIC Automation
Tool-Gertetabelle ausfllen, indem Sie auf die Optionen Scanning a network (Seite 28)
oder Importing a list (Seite 62) klicken, mit denen Stationen hinter einem Router identifiziert
werden.

Beispiel 1: Lokales S7-1200 Netzwerk

Beispiel 2: Dezentrales S7-1200 Netzwerk

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

15

SIMATIC Automation Tool - bersicht


1.3 Netzwerkoptionen

Beispiel 3: Kombiniertes lokales und dezentrales S7-1200 Netzwerk

SIMATIC Automation Tool V2.1 Benutzerhandbuch

16

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool - bersicht


1.4 .NET API (Anwendungsschnittstelle) - DLL-Datei

1.4

.NET API (Anwendungsschnittstelle) - DLL-Datei


Die vom SIMATIC Automation Tool verwendete Microsoft .NET API wird in diesem
Benutzerhandbuch dokumentiert. Sie knnen Ihre eigene Anwendungs-Software erstellen,
die die API nutzt, um dieselben Gertevorgnge wie das SIMATIC Automation Tool
auszufhren.
Das SIMATIC Automation Tool muss auf einem PG/PC installiert werden, der diese API
nutzt. Das SIMATIC Automation Tool und Ihre Anwendungs-Software verwenden die API
DLL-Datei und auerdem S7-Kommunikationsdateien. Mit der Installation des SIMATIC
Automation Tools werden alle bentigten Dateien bereitgestellt.
API DLL-Datei
Die Datei "AutomationToolAPI.dll" befindet sich in dem Ordner, in dem das AutomationTool
installiert wurde.
Kompatibilitt mit frheren Versionen
Die SIMATIC Automation Tool API wurde fr Version 2.1 berarbeitet. Programme, die fr
diese API zuvor geschrieben wurden, mssen ebenfalls berarbeitet werden. Einzelheiten
zur API V2.1 finden Sie im Kapitel SIMATIC Automation Tool API fr .NET-Framework
(Seite 73).

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

17

SIMATIC Automation Tool - bersicht


1.4 .NET API (Anwendungsschnittstelle) - DLL-Datei

SIMATIC Automation Tool V2.1 Benutzerhandbuch

18

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Voraussetzungen und Einrichten der Kommunikation


2.1

PG/PC-Betriebssystemvoraussetzungen

PG/PC-Betriebssysteme
Das SIMATIC Automation Tool V2.1 untersttzt die folgenden Betriebssysteme.
Windows 7 Home Premium SP1 (32- und 64-Bit)
Windows 7 Professional SP1 (32- und 64-Bit)
Windows 7 Enterprise SP1 (32- und 64-Bit)
Windows 7 Ultimate SP1 (32- und 64-Bit)
Windows 8.1 (nur 64-Bit)
Windows 8.1 Professional (nur 64-Bit)
Windows 8.1 Enterprise (nur 64-Bit)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

19

Voraussetzungen und Einrichten der Kommunikation


2.2 Installieren des SIMATIC Automation Tools

2.2

Installieren des SIMATIC Automation Tools

Installieren des Tools


1. Speichern Sie auf Ihrem PG/PC alle laufenden Arbeiten und schlieen Sie alle
Anwendungen, bevor Sie das SIMATIC Automation Tool installieren.
2. Fhren Sie die Datei "SIMATICAutomationToolSetup.exe" aus, um die Installation zu
starten.
Einschrnkungen bei der Installation
Auf einem PG/PC kann nur jeweils eine Version des SIMATIC Automation Tool installiert
sein. Eine frhere installierte Version (V1.0 oder V2.0) muss deinstalliert werden, bevor V2.1
installiert wird.
Das Installationsprogramm des SIMATIC Automation Tool V2.1 prft, ob eine frhere
Installation vorhanden ist. Diese Prfung kann zu folgenden Ergebnissen und Reaktionen
fhren:
Wenn keine frhere Version des SIMATIC Automation Tool gefunden wird, wird der
Installationsvorgang normal fortgesetzt.
Wird eine V2.1-Installation gefunden, bietet das Installationsprogramm die Optionen zum
Reparieren (Repair) oder zum Deinstallieren (Uninstall) der vorherigen Installation
an. Dies ist ein Standardverhalten bei Installationsprogrammen.
Wenn eine Vorgngerversion der Anwendung gefunden wird, also V1.0 oder V2.0, teilt
das Installationsprogramm dem Anwender mit, dass die Vorgngerversion automatisch
deinstalliert wird, damit die aktuelle Version installiert werden kann. An diesem Punkt
knnen Sie die Installation entweder abbrechen oder fortsetzen.
Wenn eine aktuelle Version des Tools (>V2.1) gefunden wird, wird dies dem Anwender
ebenfalls mitgeteilt, die Installation aber nicht fortgesetzt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

20

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Voraussetzungen und Einrichten der Kommunikation


2.3 Aufrufen des SIMATIC Automation Tools

2.3

Aufrufen des SIMATIC Automation Tools


Mglichkeiten zum Aufrufen des SIMATIC Automation Tools:
ber einen Doppelklick auf das SIMATIC Automation Tool-Symbol auf dem Desktop.
ber die Windows-Schaltflche "Start".
Klicken Sie auf die Windows-Schaltflche "Start" und dann auf "Alle Programme".
Klicken Sie auf den Ordner "Siemens Automation", dann auf "SIMATIC Automation
Tool" und schlielich auf "Automation Tool".
Aufrufen der Windows-Eingabeaufforderung (cmd.exe) und Eingeben des Namens der
ausfhrbaren Datei und optionaler Projektparameter.
AutomationTool.exe [projectname.sat].

2.4

Voraussetzungen fr die CPU-Konfiguration

Konfigurieren der Ethernet-Adresse


Wenn Sie mchten, dass das SIMATIC Automation Tool die IP-Adresse oder den
PROFINET-Namen einer CPU einstellt, dann mssen diese Aktionen in der CPUGertekonfiguration im TIA Portal-Projekt aktiviert sein. Verwenden Sie das TIA Portal zum
Betrachten und ndern der IP-Protokolleinstellungen eines Programms, wie im folgenden
S7-1200 Beispiel dargestellt.
ndern von IP-Adresse und PROFINET-Name
Dies ist mglich bei CPUs mit direktem Anschluss an das Netzwerk, das mit dem
SIMATIC Automation Tool verbunden ist (einschlielich Verbindung per Ethernet-Switch).
Dies ist nicht mglich bei CPUs mit indirektem Anschluss ber ein CP-Modul oder einen
sekundren Ethernet-Port der CPU, wenn der direkte Anschluss zum primren EthernetPort besteht.
Dies ist nicht mglich bei CPUs in einem anderen Netzwerk mit Verbindung zum
SIMATIC Automation Tool, die ber einen IP-Adressen-Router besteht.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

21

Voraussetzungen und Einrichten der Kommunikation


2.4 Voraussetzungen fr die CPU-Konfiguration
Beispiel fr eine S7-1200 Konfiguration
1. Klicken Sie auf den PROFINET-Port im CPU-Abbild in der Gertekonfiguration, um die
Port-Parameter anzuzeigen.

2. Klicken Sie im Register Properties auf das Register General, um die Optionen Ethernet
addresses anzuzeigen. Klicken Sie auf die Option SET IP address on the device.
Abhngig von der von Ihnen verwendeten TIA Portal-Version heit diese Option
mglicherweise Set IP address using a different method. Bei Gerten mit mehreren Ports
(z. B. S7-1500 CPU) knnen Sie alle Ports auf hnliche Weise konfigurieren, um IPAdressnderungen zu aktivieren (bei bestehender Verbindung zum SIMATIC Automation
Tool) oder Sie knnen nur den zu ndernden Port konfigurieren.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

22

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Voraussetzungen und Einrichten der Kommunikation


2.4 Voraussetzungen fr die CPU-Konfiguration
3. Klicken Sie unter den Optionen Ethernet addresses auf die Option Set PROFINET device
name on the device. Durch diese Auswahl kann das SIMATIC Automation Tool Namen
zuweisen. Bei Gerten mit mehreren Ports (z. B. S7-1500 CPU) knnen Sie alle Ports auf
hnliche Weise konfigurieren, um PROFINET-Namensnderungen zu aktivieren (bei
bestehender Verbindung zum SIMATIC Automation Tool) oder Sie knnen nur den zu
ndernden Port konfigurieren.

4. Speichern Sie das Projekt und laden Sie die neuen Konfigurationsnderungen in die
CPU.
Hinweis
Standardeinstellungen der PROFINET-IP-Parameter
Beim Erstellen eines neuen TIA Portal-Projekts werden die PROFINETStandardparameteroptionen auf "Set IP address in the project" und "Generate PROFINET
device name automatically" gesetzt. Mit den Standardoptionen knnen Sie mit dem
SIMATIC Automation Tool keine IP-Adressen oder PROFINET-Gertenamen einstellen.
Jedoch knnen Sie andere CPU-Funktionen verwenden wie RUN/STOP-Steuerung,
Programm/Firmware-Aktualisierung, Zeiteinstellung und Servicedaten-/Diagnoseanalyse.
Hinweis
Einstellen von IP-Adressen von S7-1200 CPUs mit Firmware V1
S7-1200 V1-CPUs untersttzen die Option "Set IP address on the device" nicht. Wurden die
IP-Adressen von einem TIA Portal-Programm zuvor eingestellt, dann mssen Sie die
Werkseinstellungen wiederherstellen, um die alten IP-Adressen zu lschen, bevor das
SIMATIC Automation Tool neue IP-Adressen zuweisen kann.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

23

Voraussetzungen und Einrichten der Kommunikation


2.5 Einrichten der Kommunikation

2.5

Einrichten der Kommunikation

Identifizieren der mit dem Gertenetzwerk verbundenen Netzwerkschnittstellenkarte


Nachdem Sie eine Verbindung zwischen PG/PC und Netzwerk hergestellt haben, knnen
Sie den Namen der Netzwerkschnittstellenkarte ber die Windows-Systemsteuerung
einsehen.
Im folgenden Beispiel sind S7-1200 CPUs an einen USB-Port eines PCs mit Windows 7
angeschlossen. Die Netzwerkschnittstellenkarte ist ein USB-auf-EthernetKonvertierungsgert. Die auf Ihrem PG/PC tatschlich angezeigten Optionen hngen von
Ihrer Netzwerk-Hardware ab.
Identifizieren Sie den Namen des Gerts mithilfe der Windows-Systemsteuerung.
1. ffnen Sie die Windows-Systemsteuerung.

2. Klicken Sie auf das Netzwerk- und Freigabecenter.

3. Sehen Sie sich die aktiven Netzwerke an und klicken Sie auf das mit den S7-1200 CPUs
verbundene Netzwerk.

4. Klicken Sie in der Verbindungsstatusanzeige auf die Schaltflche "Details".

SIMATIC Automation Tool V2.1 Benutzerhandbuch

24

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Voraussetzungen und Einrichten der Kommunikation


2.5 Einrichten der Kommunikation
5. Lesen Sie die Beschreibung der Netzwerkschnittstelle.

Zuweisen der Netzwerkschnittstellenkarte im SIMATIC Automation Tool


Sie mssen die Netzwerkschnittstellenkarte einem neuen Projekt zuweisen, bevor mit der
Kommunikation begonnen werden kann. Starten Sie das SIMATIC Automation Tool, klicken
Sie auf die Netzwerkkarten-Klappliste, und whlen Sie die Netzwerkkarte, die mit Ihrem
Siemens-Gertenetzwerk verbunden ist.
Sie sehen mglicherweise andere Netzwerkkarten als die in der folgenden Abbildung
gezeigten, da die Liste die Netzwerkschnittstellen wiedergibt, die auf Ihrem PG/PC verfgbar
sind.
Wenn die Netzwerkschnittstellenkarte ausgewhlt ist, aber die Gerte keine gltigen IPAdressen haben, dann knnen Sie die IP-Adressfunktionen nicht verwenden. Sie knnen
jedoch Funktionen auf Basis der MAC-Adresse verwenden und gltige IP-Adressen fr Ihr
Netzwerk einrichten.
MAC-Adressfunktionen
Scannen auf CPUs und Module
LED-Blinken zum Lokalisieren von Gerten
Einstellen von Ethernet-IP-Adressen
Einstellen von PROFINET-Namen
Rcksetzen auf Werkseinstellungen (nur PROFINET I/O-Devices)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

25

Voraussetzungen und Einrichten der Kommunikation


2.5 Einrichten der Kommunikation
Wie in der vorstehenden Abbildung ersichtlich ist, kann es zwei Eintrge fr eine
Netzwerkkarte geben, die sich durch die Ergnzung der Zeichen ".Auto" voneinander
unterscheiden.
"Auto" bezieht sich auf die Auto-Negotiation zwischen zwei Ethernet-Stationen hinsichtlich
Kommunikationsart und Geschwindigkeit.
Beide Optionen in der Klappliste ("Auto" und "Fixed") sollten funktionieren. Bei bestimmter
Netzwerk-Hardware ist es mglicherweise erforderlich, dass Sie fr eine effektive
Kommunikation nur eine der Einstellungen nutzen. Probieren Sie zuerst die einfachere
"Fixed"-Auswahl ohne "Auto".
Beispielsweise kann die S7-1200 CPU mit einer Geschwindigkeit von 10 oder 100 Mbit/s
kommunizieren (Halb- oder Vollduplex). Eine PROFINET-kompatible VollduplexGeschwindigkeit mit 100 Mbit/s ist empfehlenswert. Bei Auftreten eines Problems in der
Verbindungsnegotiation kann die Geschwindigkeit ggf. auf 10 Mbit/s (Halbduplex) gedrosselt
werden.
Wenn die Netzwerkschnittstellenkarte ausgewhlt ist und die IP-Adressen der Gerte gltig
sind, dann knnen Sie die Vorgnge im SIMATIC Automation Tool nutzen, die eine IPAdresse verwenden.
IP-Adressfunktionen
Setzen der CPU-Zeit auf PG/PC-Zeit
Programm/Firmware-Aktualisierung
Versetzen von CPUs in RUN oder STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen (nur CPU-Gerte)
Hinweis
Kommunikationsprobleme mit dem SIMATIC Automation Tool
Beispielsweise senden Sie einen Befehl an mehrere CPUs, aber eine CPU schliet den
Vorgang nicht ab und ein Kommunikationsfehler wird fr diese CPU angezeigt. Die anderen
CPUs kommunizieren und fhren den Vorgang jedoch wie erwartet aus.
Senken Sie bei auftretenden Kommunikationsproblemen die maximale Anzahl an simultanen
Vorgngen (Threads/Verbindungen), die im Dialogfeld Tools > Options festgelegt werden
kann. Schlieen Sie das SIMATIC Automation Tool und ffnen Sie die Anwendung erneut,
wiederholen Sie anschlieend die Gruppenfunktion.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

26

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.1

CPU-Passwrter
Wenn eine CPU passwortgeschtzt ist, muss das Passwort zur Ausfhrung zahlreicher
Operationen in das SIMATIC Automation Tool eingegeben werden. Das Passwort muss in
der Spalte Password eingegeben werden.
Das SIMATIC Automation Tool hindert den Anwender daran, sich zum Aufbau einer
fehlersicheren Verbindung mit einem Passwort fr fehlersicheren Betrieb zu legitimieren.
Deshalb wird immer bei Eingabe eines Passworts (in der Spalte Passwort) fr eine
fehlersichere CPU ein Nachrichtenfeld angezeigt, in dem der Anwender davor gewarnt wird,
ein Passwort fr fehlersicheren Betrieb einzugeben.
Wenn Sie diese Warnung ignorieren und das Passwort fr fehlersicheren Betrieb trotzdem
eingeben (oder das fehlersichere Passwort ohne Ihr Wissen eingegeben haben), wird die
Legitimation zurckgewiesen und Ihre Eingabe aus dem Passwortfeld gelscht.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

27

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle

3.2

Scannen eines Netzwerks und Verwenden der Gertetabelle

Grundlegende Funktionsweise
Die Gertetabelle eines neuen Projekts im SIMATIC Automation Tool ist leer. Sie knnen
eine Netzwerkkarte zuweisen, ein Netzwerk scannen und die Gertetabelle automatisch
ausfllen.
Die Gertetabelle wird mit Informationen gefllt, die whrend eines Netzwerksuchvorgangs
zusammengetragen werden. Sie knnen einen vorhandenen Wert eines Parameters sehen
und zu jedem Gert neue Werte in die entsprechende Spalte eintragen.
Die Zellen der Gertetabelle haben entweder einen hellgrauen oder dunkelgrauen
Hintergrund:
In die hellgrauen Zellen knnen Sie neue Werte eintragen
In die dunkelgrauen Zellen knnen Sie keine neue Werte eintragen
In eine deaktivierte dunkelgraue Zelle knnen keine neuen Werte eingetragen werden, d.
h. dieser Vorgang wird fr dieses Gert nicht untersttzt.
Nachdem neue IP-Adressen in die Gertetabelle eingetragen wurden, knnen Sie den
Befehl "Download" zum bertragen der Adresszuweisungen in ausgewhlte, direkt
verbundene Gerte verwenden.
Sobald die IP-Adressenzuweisungen fr alle Ihre Gerte gltig sind, knnen Sie die
Funktionen des SIMATIC Automation Tools, die IP-Adressen erfordern, verwenden.
Auerdem zeigt ein Netzwerkscan Gerte an, die sich hinter CPUs und IP-AdressenRoutern befinden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

28

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle

Scannen des Netzwerks


1. Whlen Sie im Men "Network" das Element "Scan" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Scan".
2. Das SIMATIC Automation Tool fllt eine neue Gertetabelle aus oder aktualisiert
eine vorhandene Tabelle mit Informationen aus erreichbaren Gerten.
Beim ersten Scanvorgang werden Gerte angezeigt, die mit dem SIMATIC Automation Tool
direkt verbunden sind. Diese Gerte werden in der obersten Ebene (links auen) in der
Gertehierarchie angezeigt.
Ein direkt angeschlossenes Gert kann alle MAC-adressierten Funktionen (mit nicht
konfigurierter oder konfigurierter IP-Adresse) und alle IP-adressierten Funktionen (mit
konfigurierter IP-Adresse) verwenden, sofern die Gerte-Firmware die Funktionen
untersttzt.
PROFINET-Peripheriegerte knnen in der Gertetabelle doppelt aufgefhrt werden. Einmal
auf der obersten Ebene, wo ein direkter Anschluss alle Funktionen im SIMATIC Automation
Tool zulsst, und dann in einem zweiten Eintrag auf einer niedrigeren Ebene hinter einer
CPU (mit konfigurierter IP-Adresse), wo ein indirekter Anschluss lediglich die FirmwareAktualisierungsfunktionen einschrnkt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

29

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle
Erweitern der Gertezeilen und Anzeigen lokaler Module und dezentraler Peripheriegerte
Klicken Sie auf das Symbol zum Erweitern einer Gertezeile. Verwenden Sie das
Rechtsklick-Men oder das Men "Edit" zum Erweitern/Reduzieren aller Ebenen.

Bei indirekt angeschlossenen Gerten ist nur der Vorgang der Firmware-Aktualisierung
mglich.
Gerte auf den unteren Ebenen reprsentieren lokale und dezentrale Peripherien, die ber
eine direkt angeschlossene CPU indirekt an das SIMATIC Automation Tool angeschlossen
sind. Eine gltige IP-Konfiguration ist Grundvoraussetzung in der CPU, bevor die lokalen
Gerte einer CPU in der Gertetabelle sichtbar werden.
Gerte der dritten und vierten Ebene reprsentieren dezentrale Peripheriegerte
(PROFINET- und PROFIBUS-Gerte). Eine IP-Konfiguration ist bei einer dezentralen
Peripheriesteuerung der Ebene zwei erforderlich, bevor die dezentrale Peripherie (z. B.
Kopfmodul und Peripheriemodule) in der Gertestruktur sichtbar wird.
Arbeiten mit der Gertetabelle
Verwenden Sie die Microsoft Excel-kompatible Zellenauswahl und kopieren bzw. fgen
Sie die Zwischenablage innerhalb/auerhalb der Gertetabelle aus einer anderen
Anwendung ein.
Klicken Sie auf einen Spaltenkopf, um die Zeilen nach den Spaltendaten zu sortieren
bzw. um die Sortierung umzukehren.
Klicken Sie mit der rechten Maustaste auf einen Spaltenkopf, um Spalten anzuzeigen
bzw. auszublenden.
Klicken Sie auf das Kontrollkstchen im Spaltenkopf oder verwenden Sie das Men
"Edit", um alle Zeilen mit den Optionen "Check All" bzw. "Uncheck all" zu markieren bzw.
die Markierung aufzuheben.
Sie knnen Zeilenfilter fr die Spalten "Device", "Device type" und "Article number"
erstellen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

30

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle
Rechtsklick-Men fr alle Tabellenzellen

Ausschneiden der aktuellen Auswahl.


Kopieren der aktuellen Auswahl.
Einfgen der aktuellen Auswahl.
Markieren aller Gertezeilen (erste Spalte).
Aufheben der Markierung aller Gertezeilen
(erste Spalte).
Erweitern aller Zeilen in der Gertespalte.
Reduzieren aller Zeilen in der Gertespalte.
Einfgen einer neuen Gertezeile.
Lschen der Auswahl oder markierter Gerte.
Aktualisieren markierter Gerte.
Rufen Sie die SIEMENS-Website IndustrySupport fr die Artikelnummer der aktuellen
Zeilen auf. Hier knnen Sie aktuelle Gerteinformationen und Firmware-Aktualisierungen
abrufen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

31

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle
Filtern der angezeigten Zeilen
Die Filteroption wird fr die Spalten "Device", "Device Type" und "Article number" untersttzt.
Beim Bewegen des Mauszeigers ber eine Spalte, die die Filteroption untersttzt, wird im
angezeigt. Klicken Sie auf diese Schaltflche, um
Spaltenkopf die Schaltflche "Filter"
das Fenster "Filter" zu ffnen.
Im folgenden Beispiel wurden die Artikelnummern 6ES7 131-6BF00-0BA0 und 6ES7 1326BD20-0BA0 mit der Filteroption ausgewhlt. Wenn Sie auf die Schaltflche OK klicken,
werden in der Gertetabelle nur die Zeilen mit diesen Artikelnummern angezeigt.

Scanregeln fr vorhandene Tabelleneintrge


Falls eine MAC-Adresse in der Tabelle bereits existiert, dann werden in der Zeile fr
diese MAC-Adresse die Felder "IP address", "Subnet" und "Gateway aktualisiert. Die
Daten in den restlichen Feldern bleiben bestehen.
Wenn keine MAC-Adresse aufgefhrt ist, wird eine neue Zeile erstellt. MAC-Adresse, IPAdresse, Subnetz und Gateway werden hinzugefgt. Bei einer neuen Zeile sind alle
restlichen Felder leer.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

32

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.2 Scannen eines Netzwerks und Verwenden der Gertetabelle
Event Log
Der "Event Log"-Bereich befindet sich unterhalb der Gertetabelle. Wenn Sie Gerte
auswhlen und einen Vorgang starten, dann werden Informationen ber erfolgreiche und
erfolglose Ergebnisse im Event Log angezeigt. ber das Rechtsklick-Men der Spaltenkpfe
im Event Log knnen Spalten ein- und ausgeblendet werden.

Klicken Sie im Event Log mit der rechten Maustaste, um das nachfolgend dargestellte Men
zu ffnen.
Kopieren von Log-Elementen in die Zwischenablage
Speichern von Log-Elementen in einer Datei
Lschen aller Log-Elemente

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

33

Toolfunktionen
3.3 Laden neuer IP-, Subnetz- und Gateway-Adressen

3.3

Laden neuer IP-, Subnetz- und Gateway-Adressen

ndern von IP-Adressen


Fhren Sie die folgenden Schritte aus, um die IP-Adressen zu aktualisieren.
1. Klicken Sie auf das Register "IP Address".
2. Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf das
linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All" ber
das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder das Men "Edit" auswhlen.
3. Geben Sie die Adressnderungen in die Spalten "New IP", "New subnet" und "New
Gateway" ein.
4. Whlen Sie im Men "Network" das Element "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download".
5. Durch den Ladevorgang werden die IP-, Subnetz- und Gateway-Adresse in den
ausgewhlten Gerten eingestellt.
6. Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs
angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

34

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.4 Laden neuer PROFINET-Gertenamen

3.4

Laden neuer PROFINET-Gertenamen

ndern von PROFINET-Gertenamen


PROFINET-Namensregeln
Gltige Namen richten sich nach den Standard-DNS-Namenskonventionen (Domain Name
System).
Eine maximale Anzahl von 63 Zeichen ist zulssig. Zu den gltigen Zeichen zhlen die
Kleinbuchstaben "a" bis "z", die Ziffern 0 bis 9, das Bindestrichzeichen (Minuszeichen) und
das Punktzeichen.
Ungltige Namen
Der Name darf nicht das Format n.n.n.n haben, wobei n ein Wert zwischen 0 und 999 ist.

Sie drfen den Namen nicht mit der Zeichenkette "port-nnn" oder der Zeichenkette "portnnnnnnnn" beginnen, wobei n eine Ziffer zwischen 0 und 9 ist. Beispielsweise sind "port123" und "port-123-45678" unzulssige Namen.

Ein Name darf nicht mit einem Bindestrich "-" oder mit einem Punkt "." beginnen oder
enden.
Fhren Sie die folgenden Schritte aus, um die PROFINET-Gertenamen zu aktualisieren.
1. Klicken Sie auf das Register "PROFINET name".
2. Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf das
linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All" ber
das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder das
Men "Edit" auswhlen.
3. Geben Sie in der Spalte "New PROFINET Name" einen neuen PROFINET-Namen
ein.
4. Whlen Sie im Men "Network" das Element "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download".
5. Durch den Ladevorgang werden neue PROFINET-Namen in den ausgewhlten
Gerten eingestellt.
6. Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs
angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

35

Toolfunktionen
3.5 Versetzen von CPUs in die Betriebsart RUN oder STOP

3.5

Versetzen von CPUs in die Betriebsart RUN oder STOP

Versetzen von CPUs in die Betriebsart RUN


1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element RUN oder klicken Sie in der Symbolleiste auf die Schaltflche RUN. In der CPU muss ein gltiges Programm vorhanden sein, bevor ein Wechsel in die Betriebsart RUN mglich ist.

3.

Die ausgewhlten CPUs werden in die Betriebsart RUN versetzt.

4.

Die Spalten "Mode" und "Operating state" in der Gertetabelle geben den aktuellen CPU-Status an. Gelb steht fr die Betriebsart STOP. Grn steht fr die Betriebsart RUN und bei ROT liegt ein CPU-Fehler an.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

36

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.5 Versetzen von CPUs in die Betriebsart RUN oder STOP

Versetzen von CPUs in die Betriebsart STOP


1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect
All" ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste
oder das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element STOP oder klicken Sie in der
Symbolleiste auf die Schaltflche STOP.

3.

Die ausgewhlten CPUs werden in die Betriebsart STOP versetzt.

4.

Die Spalten "Mode" und "Operating state" in der Gertetabelle geben den aktuellen CPU-Status an. Gelb steht fr die Betriebsart STOP. Grn steht fr die
Betriebsart RUN und bei ROT liegt ein CPU-Fehler an.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

37

Toolfunktionen
3.6 LED-Blinken an Gerten.

3.6

LED-Blinken an Gerten.

Lokalisieren eines Gerts mittels LED-Blinken


Mit der Schaltflche "Flash" werden die LEDs von ausgewhlten Gerten zum Blinken
gebracht. Durch das Blinken lsst sich physisch lokalisieren, welches Gert eine spezifische
MAC-Adresse besitzt. Sie knnen die Funktion LED-Blinken in der Betriebsart RUN oder in
der Betriebsart STOP verwenden.
1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element "Flash" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Flash".

3.

Daraufhin blinken die LEDs ausgewhlter Gerte.

4.

Der Blinkvorgang wird solange fortgesetzt, bis Sie auf die Schaltflche "Cancel"
klicken.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

38

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.7 Laden neuer Programme in CPUs

3.7

Laden neuer Programme in CPUs

Vorbereiten eines Programms auf die Nutzung mit dem SIMATIC Automation Tool
Ein TIA Portal-Programm muss von der TIA Portal-Software auf eine SIMATICSpeicherkarte, ein USB-Flash-Laufwerk oder eine andere Partition Ihrer PG/PC-Festplatte
bertragen werden, damit das Programm mit dem SIMATIC Automation Tool verwendet
werden kann. Informationen zum bertragen eines Programms auf ein Speichergert finden
Sie in der Dokumentation zum TIA Portal.
Hinweis
Die Operation Program Update ist bei fehlersicheren CPUs aus Sicherheitsgrnden nicht
zulssig.
Nachdem das Programm vom TIA Portal auf ein Speichergert bertragen wurde, knnen
Sie den Windows Explorer zum bertragen des Programms in den vom SIMATIC
Automation Tool verwendeten Ordner aufrufen.
Programmweises Kopieren des "SIMATIC.S7S"-Ordners
Befolgen Sie diese Schritte, um dem SIMATIC Automation Tool ein Programm zugnglich zu
machen
1. Fhren Sie das SIMATIC Automation Tool aus, rufen Sie die Einstellungen unter
Tools>Options auf und beachten Sie die Pfadzuweisung fr
Programmaktualisierungsdateien. Der Standardpfad lautet
C:\ProgramData\Siemens\SIMATIC Automation Tool\Programs. Falls Sie einen anderen
Ordner bevorzugen, knnen Sie den Pfad entsprechend ndern.
2. Erstellen Sie Ordner unter dem Programmpfad, der im Dialog "Options" zugewiesen ist.
Erstellen Sie fr jedes Programm einen Ordner und geben Sie einen Ordnernamen ein,
der das Programm identifiziert. Die von Ihnen erstellten Ordnernamen werden in der
Klappliste des SIMATIC Automation Tools angezeigt.
3. Verwenden Sie den Windows Explorer, um den Ordner "SIMATIC.S7S" (einschlielich
aller Unterordner und Dateien) in den im SIMATIC Automation Tool zugewiesenen
Ordner zu kopieren. Mit dem SIMATIC Automation Tool knnen nur Programme in eine
CPU geladen werden. Optionale Datenprotokoll- und Rezeptordner, die mglicherweise
existieren, knnen nicht geladen werden. Ein TIA Portal-Programm (ein "SIMATIC.S7S"Ordner) kann in einem ZIP-Dateiarchiv verpackt und an einen entfernten Speicherort
gesendet werden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

39

Toolfunktionen
3.7 Laden neuer Programme in CPUs

Hinweis
TIA Portal-Programmdaten sind verschlsselt
Einzelheiten wie Projektname oder Ziel-CPU eines TIA Portal-Programms lassen sich aus
den in einem SIMATIC.S7S-Ordner abgelegten verschlsselten Daten nicht auslesen. Sie
knnen den SIMATIC.S7S-Ordner eines Programms nicht ber den SIMATIC.S7S-Ordner
eines anderen Programms identifizieren.
Sie mssen im Programmaktualisierungsordner des SIMATIC Automation Tools Unterordner
erstellen und benennen, die die Programmfunktion oder Ziel-CPU identifizieren. Kopieren
Sie den SIMATIC.S7S-Ordner eines Programms in den von Ihnen benannten Unterordner.
Die von Ihnen erstellten Ordnernamen werden in der Klappliste in der Spalte "Program" des
SIMATIC Automation Tools angezeigt und enthalten den Pfad zum korrekten SIMATIC.S7SOrdner.

Laden neuer Programme in eine CPU


WARNUNG
Vergewissern Sie sich vor dem Laden eines neuen Programms, dass die CPU keinen
Prozess ausfhrt
Durch das Installieren eines neuen Programms geht die CPU in die Betriebsart STOP, was
sich auf den Betrieb eines Online-Prozesses oder einer Maschine auswirken kann.
Unvorhersehbarer Betrieb eines Prozesses oder einer Maschine kann zu tdlichen oder
schweren Verletzungen und/oder Sachschaden fhren.
Nachdem die Programmdaten in den Programmaktualisierungsordner kopiert wurden,
knnen Sie das SIMATIC Automation Tool zum Laden neuer Programme in eine oder
mehrere CPUs verwenden.
1.

Klicken Sie auf das Register "Program Update".

2.

Klicken Sie an den CPUs, die Sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect
All" ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste
oder das Men "Edit" auswhlen.

3.

Verwenden Sie fr jede ausgewhlte CPU die Klappliste in der Spalte "Program", um einen Programmordnernamen auszuwhlen. Die Klappliste zeigt die
Ordner an, die Sie im Programmaktualisierungspfad erstellt haben.

4.

Whlen Sie im Men "Network" den Befehl "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download", um den Vorgang zu starten.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

40

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.7 Laden neuer Programme in CPUs

Beispiel fr eine Programmaktualisierung


Der Standardpfad fr Programmaktualisierungen im Dialog "Options" lautet
C:\ProgramData\Siemens\SIMATIC Automation Tool\Programs.
Wenn Sie mchten, dass fnf verschiedene Programme zum Laden verfgbar sind, dann
mssen Sie unter dem Pfad, der im Dialog "Options" zugewiesen wird, fnf Ordner erstellen
und benennen. Kopieren Sie alle "SIMATIC.S7S"-Ordner in die fnf entsprechenden Ordner.
In diesem Beispiel identifizieren die Ordnernamen Program1", "Program2", "Program3",
"Program4" und "Program5" die verfgbaren Programme. Sie knnen einen beliebigen
Ordnernamen vergeben. Der Ordnername kann sich auf eine Programmfunktion oder einen
CPU-Speicherort beziehen.
Die folgende Abbildung zeigt die Windows Explorer-Ansicht der vier Unterordner unter dem
Programmordner. Die entsprechenden SIMATIC.S7S-Programmordner werden in diese
Ordner kopiert.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

41

Toolfunktionen
3.7 Laden neuer Programme in CPUs
Die folgende Abbildung zeigt das Register "Program Update" des SIMATIC Automation
Tools mit den beispielhaften Ordnernamen in der Klappliste der Spalte "Program". In der
Spalte "Select" sind zwei S7-1500 CPUs markiert. Sie mssen die Klappliste in der Spalte
"Program Update" verwenden, um festzulegen, welches Programm verwendet werden soll.
Wird mehr als eine CPU-Zeile ausgewhlt, dann mssen Sie den Vorgang wiederholen und
fr jede ausgewhlte CPU das korrekte Programm zuweisen.
Whlen Sie im Men "Network" den Befehl "Download" oder klicken Sie in der Symbolleiste
auf die Schaltflche "Download", um mit der Programmaktualisierung zu beginnen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

42

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.8 Installieren neuer Firmware in CPUs und Modulen

3.8

Installieren neuer Firmware in CPUs und Modulen

Firmware-Aktualisierungen
TIA Portal
Firmware-Aktualisierungen knnen mithilfe einer SIMATIC-Speicherkarte in CPUs und
Modulen installiert werden. Alternative Mglichkeiten der Firmware-Aktualisierung sind u.a.
die Modul-Informationsseite des integrierten Webservers einer CPU oder die Online- und
Diagnosefunktionen des TIA Portals.
SIMATIC Automation Tool
Das SIMATIC Automation Tool kann die Firmware von CPU- und Modulgruppen
aktualisieren. Sie knnen die einzelne UPD-Datei im neuen Format verwenden, oder die
Datei im lteren (klassischen) Format, das mindestens drei separate UPD-Dateien nutzt.
Standardmig wird beim Vorgang der Firmware-Aktualisierung die Firmware nicht durch die
gleiche Firmwareversion ersetzt und es wird nur ein einzelner Verarbeitungs-Thread
zugelassen, dessen Ausfhrung abgeschlossen sein muss, bevor der nchste
Gertevorgang ausgefhrt wird. Informationen zum ndern dieses Verhaltens finden Sie im
Abschnitt Men "Tool" (Seite 68). Bitte bercksichtigen Sie das in diesem Abschnitt
beschriebene Risiko bei der Durchfhrung von Multi-Thread-Firmware-Aktualisierungen.
Hinweis
Die Kommunikationsmodule S7-1200 CM mssen vor der Firmware-Aktualisierung
konfiguriert werden.
Sie knnen das SIMATIC Automation Tool zum Aktualisieren der Firmware von nicht
konfigurierten und konfigurierten SM- und CM-Modulen, mit Ausnahme linksseitiger S7-1200
CM-Gerte, verwenden. Bei dem S7-1200 CM mssen Sie eine CM-Konfiguration im TIA
Portal durchfhren und die Konfiguration laden, bevor Sie die CM-Firmware aktualisieren
knnen.
Hinweis
Herabstufen der CPU-Firmware
Sie knnen das SIMATIC Automation Tool zum Herabstufen der CPU-Firmware (Laden
einer lteren Firmware-Version) verwenden, doch die IP-Adresse und das Programm
werden dabei mglicherweise gelscht. In diesem Fall wird die IP-Adresse auf 0.0.0.0
rckgesetzt und ein erneuter Netzwerkscan ist erforderlich, um mit diesem Gert zu
kommunizieren. Sie mssen die IP-Adresse festlegen, um die vorherige Netzwerkadresse
wiederherzustellen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

43

Toolfunktionen
3.8 Installieren neuer Firmware in CPUs und Modulen

Vorbereiten von Firmware-Aktualisierungsdateien fr den Einsatz mit dem SIMATIC Automation Tool
Sie knnen Software zur Firmware-Aktualisierung ber die Kunden-Support
(https://www.siemens.com/automation/)-Website beziehen.
Sie knnen die Kunden-Support-Website fr ein Gert auch direkt aufrufen, indem Sie
den Mauszeiger auf eine Gertezeile bewegen, mit der rechten Maustaste klicken und
dann das Menelement "Check for updates" auswhlen. Die Auswahl einer SiemensSupport-Website erfolgt ber die in einer Gertetabellenzeile angezeigte Artikelnummer.
Der "Check for updates"-Befehl auf Artikelnummer 6ES7 215-1HG31-0XB0 leitet Sie z. B.
auf die zugehrige S7-1215C-Support-Website
(https://support.industry.siemens.com/cs/products/6es7215-1hg31-0xb0/cpu-1215cdcdcrly-14di10do2ai2ao?pid=79072&dtp=Download&mlfb=6ES7215-1HG310XB0&lc=de-WW) weiter.
Beispiel fr eine CPU: Die Firmware-Aktualisierungsdatei mit der Bezeichnung
6ES7211_1AE40_0XB0_V04.00.02.exe ist nur fr die S7-1200
Modelle CPU 1211C DC/DC/DC geeignet. Falls Sie die UPD-Datei in diesem Paket fr ein
anderes S7-1200 CPU-Modell verwenden, schlgt der Aktualisierungsprozess fehl.
Wenn Sie die Aktualisierungsdatei ausfhren und die Dateien extrahieren, sehen Sie die
folgenden Dateien und Ordner.
Datei: S7-JOB.SYS
Ordner: FWUPDATE.SYS enthlt die UPD-Datei.
Datei: 6ES7 211-1AE40-0XB0 V04.00.02.upd (UPD-Datei wird vom SIMATIC
Automation Tool verwendet)
Beispiel fr ein Peripheriemodul: Die Firmware-Aktualisierungsdatei mit der Bezeichnung
232-4HD32-0XB0_V203.exe ist nur fr die S7-1200 Module
SM1232 ANALOGAUSGANG 4AO geeignet. Die selbstentpackende EXE-Datei enthlt die
Datei 6ES7 232-4HD32-0XB0V02.00.03_00.00.00.00.upd, die vom SIMATIC Automation
Tool verwendet wird.
Hinweis
Firmware-Aktualisierungsdateien im neuen Format
Der Name der selbstentpackenden exe-Datei mit dem Aktualisierungspaket muss der
Artikelnummer des Gerts entsprechen, das Sie aktualisieren mchten.
Der Name der selbstentpackenden UPD-Datei muss der Artikelnummer des Gerts und
der Firmware-Version entsprechen, die Sie laden mchten.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

44

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.8 Installieren neuer Firmware in CPUs und Modulen
Hinweis
Firmware-Aktualisierungsdateien im alten Format
Der Name der selbstentpackenden exe-Datei mit dem Aktualisierungspaket muss der
Artikelnummer des Gerts entsprechen, das Sie aktualisieren mchten.
Enthlt je nach Firmware-Gre mindestens drei Dateien
Legen Sie einen Unterordner mit einem beliebigen Namen in dem Ordner
C:\ProgramData\Siemens\SIMATIC Automation Tool\Firmware an. Zwecks einfacher
Identifikation knnen Sie dem Ordner die Artikelnummer und Versionsnummer zuweisen
oder Sie vergeben einen beliebigen Namen. Das SIMATIC Automation Tool analysiert
beim Start alle Firmware-Dateien zur Besttigung der genauen FirmwareVersionsnummern.
Kopieren von UPD-Dateien in den Firmware-Aktualisierungsordner
Die einzelnen Firmware-Aktualisierungsdateien (UPD-Dateien) im neuen Format enthalten
die Modell- und Versionsnummern des Zielmoduls im Dateinamen. Sie knnen mehrere
UPD-Dateien in einen einzigen Firmware-Ordner kopieren und anschlieend das Zielmodul
anhand des UPD-Dateinamens identifizieren.
1. Fhren Sie das SIMATIC Automation Tool aus, rufen Sie die Einstellungen unter
Tools>Options auf und beachten Sie die Ordnerzuweisung fr FirmwareAktualisierungsdateien. Der Standardpfad lautet C:\ProgramData\Siemens\SIMATIC
Automation Tool\Firmware. Sie knnen die Standardeinstellung bei Bedarf ndern.
2. Kopieren Sie alle bentigten UPD-Dateien in den mit dem Befehl Tools>Option
festgelegten Firmware-Ordner.
WARNUNG
Vergewissern Sie sich vor dem Installieren von Firmware-Aktualisierungen, dass die CPU
keinen Prozess ausfhrt.
Durch das Installieren einer Firmware-Aktualisierung geht die CPU in die Betriebsart STOP,
was sich auf den Betrieb eines Online-Prozesses oder einer Maschine auswirken kann.
Unvorhersehbarer Betrieb eines Prozesses oder einer Maschine kann zu tdlichen oder
schweren Verletzungen und/oder Sachschaden fhren.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

45

Toolfunktionen
3.8 Installieren neuer Firmware in CPUs und Modulen

Laden von Firmware-Aktualisierungen in CPUs und Module


Nachdem die UPD-Dateien in den Ordner fr die Firmware-Aktualisierung kopiert wurden,
knnen Sie das SIMATIC Automation Tool zum Aktualisieren der Firmware von CPUs und
Modulen verwenden.
1.

Klicken Sie auf das Register "Firmware Update".

2.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

3.

Verwenden Sie fr jede ausgewhlte Gertezeile die Klappliste in der Spalte


"Firmware Version" und whlen Sie die Firmware-Version entweder fr eine CPU
oder ein Modul aus. Die Klappliste zeigt die Namen der UPD-Dateien, die Sie in
den Firmware-Aktualisierungspfad kopiert haben. Sind neue Firmware-Versionen
(UPD-Dateien) im Ordner fr die Firmware-Aktualisierung verfgbar, dann wird die
letzte Version in die Spaltenzelle "Firmware version" fr ein Gert automatisch
eingetragen.

4.

Whlen Sie im Men "Network" den Befehl "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download", um den Vorgang zu starten.

5.

Warten Sie, bis die Firmware-Aktualisierung abgeschlossen ist. Warten Sie, bis
die Leuchten an der CPU aufhren zu blinken, bevor Sie einen weiteren Vorgang
mit dieser CPU ausfhren.

6.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

Zeitberschreitungs-Fehlermeldung aufgrund langsamer Kommunikation mit UPDDateispeichergert


Wenn folgende Fehlermeldung angezeigt wird, sind mehr als fnf Sekunden vergangen,
ohne dass das SIMATIC Automation Tool alle UPD-Dateien im Firmware-Speicherordner
verarbeiten konnte. Die Zeit, die zum ffnen und Scannen aller UPD-Dateien bentigt wird,
hngt von der Datenzugriffszeit und der Anzahl der UPD-Dateien im Ordner ab.
Dieser Zeitberschreitungsfehler kann auftreten, wenn die Kommunikation mit einem
entfernten Speichergert zu langsam abluft.
Um dieses Problem zu vermeiden, weisen Sie mit dem Menbefehl Tools>Options einen
schnelleren Firmware-Datenspeicherpfad zu. Kopieren Sie die bentigten UPD-Dateien
auf ein schnelleres lokales Speichergert, und versuchen Sie den Vorgang erneut.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

46

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.8 Installieren neuer Firmware in CPUs und Modulen

Beispiel fr eine Firmware-Aktualisierung


Der Standardpfad fr Firmware-Aktualisierungen lautet C:\ProgramData\Siemens\SIMATIC
Automation Tool\Firmware.
Wenn Sie mchten, dass vier verschiedene Firmware-Versionen zum Laden verfgbar
sind, dann mssen Sie vier verschiedene UPD-Dateien in den Firmware-Unterordner
kopieren.
Im Register "Firmware update" des SIMATIC Automation Tools werden die verfgbaren
Versionen (UPD-Dateien) in der Klappliste der Spalte "New Firmware Version"
aufgefhrt. In der Spalte "Select" wurde eine CPU markiert. Sie mssen die Klappliste der
"FW Version" verwenden und dieser CPU eine Datei zuweisen. Wird mehr als eine CPU
ausgewhlt, dann mssen Sie den Vorgang wiederholen und fr jede ausgewhlte CPU
die korrekte Aktualisierungsdatei zuweisen.
Existieren mehrere Peripheriemodule desselben Modells, dann werden durch die
Firmware-Aktualisierung eines Moduls alle hnlichen Module aktualisiert. Die Firmware
von Peripheriemodulen kann separat aktualisiert werden, ohne die Firmware der CPU im
Baugruppentrger zu aktualisieren.
Whlen Sie im Men "Network" den Befehl "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download", um mit dem Prozess zu beginnen.

Hinweis
Die Firmware bestimmter S7-1200 Module kann mit dem SIMATIC Automation Tool nicht
aktualisiert werden
Wenn die Fehlermeldung "The device requires both the CPU and module to support
firmware update. This device can only be updated via SD card angezeigt wird, dann lsst
sich die Modul-Firmware nicht mit dem SIMATIC Automation Tool aktualisieren.
Module mit den Artikelnummern xxx30 oder xxx31 knnen nicht mit dem Automation Tool
aktualisiert werden, verwenden Sie dafr eine SIMATIC Memory Card. Dies gilt
ausschlielich fr links- bzw. rechtsseitig von der CPU installierte S7-1200 Module.
Beispielsweise enthlt der Mittelteil der Artikelnummer 6ES7232-4HD30-0XB0 das Segment
4HD30, und Sie knnen die Firmware dieses Moduls nicht mit dem SIMATIC Automation
Tool aktualisieren.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

47

Toolfunktionen
3.9 Sichern und Wiederherstellen von CPU-Daten

3.9

Sichern und Wiederherstellen von CPU-Daten

Sichern von Gerten


Neue CPU-Datensicherungsdateien werden erstellt und in den festgelegten Ordner kopiert.
Der Standarddateipfad lautet C:\ProgramData\Siemens\SIMATIC Automation Tool\Backup.
Der Sicherungsdateiname enthlt Datum, Zeit und PLC-Name, hnlich wie die
Sicherungsdateinamen im TIA Portal. Sie knnen diese Dateien fr die
Gertewiederherstellung im SIMATIC Automation Tool verwenden.
Hinweis
Aus Sicherheitsgrnden ist die Operation Restore from Backup file bei fehlersicheren
CPUs nicht zulssig.
Sie knnen den Sicherungsvorgang ber eine beliebige Registerauswahl starten (IPAdresse, PROFINET-Name, Programmaktualisierung, Firmware-Aktualisierung oder
Wiederherstellen des Namens).
Fhren Sie die folgenden Schritte aus, um neue Sicherungsdateien zu erstellen.
1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element "Backup Device" oder klicken Sie in
der Symbolleiste auf die Schaltflche "Backup device to file".

3.

Neue CPU-Sicherungsdateien werden erstellt und in den im Men Tools>Options


zugewiesenen Sicherungsdateipfad kopiert.

4.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

48

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.9 Sichern und Wiederherstellen von CPU-Daten
Die folgende Abbildung zeigt das Namensformat der Sicherungsdatei: Jahr-Monat-TagStunde-Sekunde-Millisekunde_PLC-Name.s7pbkp.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

49

Toolfunktionen
3.9 Sichern und Wiederherstellen von CPU-Daten

Wiederherstellen von Namen


CPU-Daten knnen aus einer Sicherungsdatei wiederhergestellt werden. Die
Sicherungsdateien lassen sich mit dem TIA Portal oder dem SIMATIC Automation Tool
erstellen. Sicherungsdateien haben die Erweiterung "s7pbkp" und mssen in dem im Men
Tools>Options zugewiesenen Sicherungsdateipfad vorhanden sein oder dorthin kopiert
werden. Der Standarddateipfad lautet C:\ProgramData\Siemens\SIMATIC Automation
Tool\Backup.
Die Zellen in der Spalte "Restore" dienen zum Eintragen des Namens der
Wiederherstellungsdatei. Sie knnen Sicherungsdateien mit dem TIA Portal oder dem
SIMATIC Automation Tool erstellen. Diese Dateien haben die Erweiterung "s7pbkp". Die
Zellen in der Spalte "Restore" dienen zum Eintragen des Namens der
Wiederherstellungsdatei.
Standardmig wird beim Wiederherstellungsvorgang nur ein einzelner VerarbeitungsThread zugelassen, dessen Ausfhrung abgeschlossen sein muss, bevor der nchste
Gertevorgang ausgefhrt wird. Informationen zum ndern dieses Verhaltens finden Sie im
Abschnitt Men "Tool" (Seite 68).
Fhren Sie die folgenden Schritte aus, um ausgewhlte Gerte aus einer Sicherungsdatei
wiederherzustellen.
1.

Klicken Sie auf das Register "Restore Name".

2.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

3.

Verwenden Sie fr jede ausgewhlte Gertezeile die Klappliste der Spalte "Restore Name" und whlen Sie eine Sicherungsdatei aus. Die Klappliste zeigt die Namen der s7pbkp-Dateien, die unter dem ber das Men Tools>Options
festgelegten Sicherungsdateipfad vorhanden sind.

4.

Whlen Sie im Men "Network" den Befehl "Download" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Download", um den Vorgang zu starten.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

50

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.9 Sichern und Wiederherstellen von CPU-Daten
In der folgenden Abbildung ist eine CPU ausgewhlt, sodass nur eine Sicherungsdatei in der
Spalte "Restore Name" ausgewhlt werden muss. Wird mehr als ein Gert ausgewhlt,
mssen Sie die Auswahl der Sicherungsdatei fr jedes ausgewhlte Gert wiederholen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

51

Toolfunktionen
3.10 Rcksetzen von CPUs und Modulen auf die Werkseinstellungen

3.10

Rcksetzen von CPUs und Modulen auf die Werkseinstellungen

Rcksetzen ausgewhlter Gerte auf die Werkseinstellungen


Sie knnen ausgewhlte Gerte auf die Werkseinstellungen zurcksetzen, Ausnahme ist die
IP-Adresse. Die IP-Adresse, die vor dem Prozess bereits vorhanden war, wird beibehalten,
sodass Ihre IP-Netzwerkzuweisungen nicht verloren gehen.
Hinweis
Die Operation Reset to factory defaults ist bei fehlersicheren CPUs aus Sicherheitsgrnden
nicht zulssig.
Standardmig wird beim Rcksetzen auf die Werkseinstellungen nur ein einzelner
Verarbeitungs-Thread zugelassen, dessen Ausfhrung abgeschlossen sein muss, bevor der
nchste Gertevorgang ausgefhrt wird. Informationen zum ndern dieses Verhaltens
finden Sie im Abschnitt Men "Tool" (Seite 68). Bitte bercksichtigen Sie das in diesem
Abschnitt beschriebene Risiko bei der Durchfhrung von Multi-Thread-FirmwareAktualisierungen.
Fhren Sie die folgenden Schritte aus, um ausgewhlte Gerte auf die Werkseinstellungen
zurckzusetzen.
1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element "Reset Factory Defaults" oder klicken Sie in der Symbolleiste auf die Schaltflche "Reset Factory Defaults".

3.

Klicken Sie im Dialogfeld "Reset to Factory" auf die Schaltflche "Continue".

4.

Die ausgewhlten Gerte werden daraufhin auf die Werkseinstellungen zurckgesetzt.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

6.

Warten Sie, bis der Rcksetzvorgang abgeschlossen ist. Warten Sie, bis die
Leuchten am Gert aufhren zu blinken, bevor Sie einen weiteren Vorgang
durchfhren.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

52

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.10 Rcksetzen von CPUs und Modulen auf die Werkseinstellungen
Die ausgewhlten Gerte in der folgenden Abbildung werden auf die Werkseinstellungen
zurckgesetzt, sobald der Befehl "Reset Factory Defaults" ausgefhrt wird.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

53

Toolfunktionen
3.11 Urlschen des CPU-Speichers

3.11

Urlschen des CPU-Speichers

Urlschen des Speichers von ausgewhlten Gerten


Fhren Sie die folgenden Schritte aus, um ein Urlschen des CPU-Speichers ausgewhlter
Gerte durchzufhren.
1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element "Memory Reset" oder klicken Sie in
der Symbolleiste auf die Schaltflche "Memory Reset".

3.

Klicken Sie im Dialogfeld "Memory Reset" auf die Schaltflche "Continue".

4.

Daraufhin wird ein Urlschen des Speichers ausgewhlter CPUs durchgefhrt.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

Fr den Speicher der ausgewhlten Gerte wird in der folgenden Abbildung ein Urlschen
durchgefhrt, sobald der Befehl "Memory Reset" ausgefhrt wird.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

54

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.12 Laden von Servicedaten aus CPUs

3.12

Laden von Servicedaten aus CPUs

Abrufen von Servicedaten aus ausgewhlten CPUs


Wenn eine CPU in einen Fehlerstatus bergeht, werden in der CPU Informationen
gespeichert, die Sie dann laden knnen. Sie knnen die Servicedatendateien an den
Siemens-Kundensupport senden und so dazu beitragen, die Ursache eines Fehlers zu
finden. Es wird ein Ordner unter dem festgelegten Fehlerordner angelegt (der Standardpfad
lautet C:\ProgramData\Siemens\SIMATIC Automation Tool\Fault).
Fhren Sie die folgenden Schritte aus, um Servicedaten aus ausgewhlten CPUs zu laden.
1.

Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf
das linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All"
ber das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder
das Men "Edit" auswhlen.

2.

Whlen Sie im Men "Network" das Element "Upload Service data" oder klicken
Sie in der Symbolleiste auf die Schaltflche "Upload service data".

3.

Klicken Sie im Dialogfeld "Upload Service Data" auf die Schaltflche "Continue".

4.

Ausgewhlte CPUs laden die Servicedaten in den unter dem Men


Tools>options zugewiesenen Dateipfad.

5.

Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs angezeigt.

Die ausgewhlten Gerte in der folgenden Abbildung laden die Servicedaten, sobald der
Befehl "Upload Service Data" ausgefhrt wird.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

55

Toolfunktionen
3.12 Laden von Servicedaten aus CPUs

Servicedatendateien
Der Ordnername basiert auf Datum, Zeit und PLC-Name wie im TIA Portal.
Hinweis
Laden von Servicedatendateien aus passwortgeschtzten CPUs
Falls eine CPU passwortgeschtzt ist, mssen Sie das CPU-Passwort angeben, damit alle
Servicedatendateien geladen werden knnen. Geben Sie die CPU-Passwrter in die Spalte
"Password" des SIMATIC Automation Tools ein, bevor Sie mit dem Laden von Servicedaten
beginnen.
Beispiel fr einen Servicedaten-Dateisatz:
2015-04-16_15-33-58_PLC_1\Fault.bin
2015-04-16_15-33-58_PLC_1\Fault2.bin (nur S7-1200 V4.1 oder hher).
2015-04-16_15-33-58_PLC_1\Alarms.txt
2015-04-16_15-33-58_PLC_1\ASLog.txt
2015-04-16_15-33-58_PLC_1\ASLog.txt
2015-04-16_15-33-58_PLC_1\DNN.txt
2015-04-16_15-33-58_PLC_1\PLCInformation.txt
2015-04-16_15-33-58_PLC_1\RAM.img (nur S7-1200)
2015-04-16_15-33-58_PLC_1\NAND.img (nur S7-1200)
2015-04-16_15-33-58_PLC_1\ResourceStats.txt (nur S7-1200)
2015-04-16_15-33-58_PLC_1\CommBuffers.txt (nur S7-1200)
2015-04-16_15-33-58_PLC_1\CommBuffers.txt (nur S7-1200)
Hinweis
Servicedaten werden im Klartext gespeichert
Ein unbefugter Anwender kann die Servicedatendateien nutzen, um Informationen zu Status
und Konfiguration des Steuerungssystems zu erlangen. Die Servicedatendateien werden in
der CPU im Klartext gespeichert (binre Kodierung). Durch Vergabe eines CPU-Passworts
kann der Zugriff auf diese Informationen kontrolliert werden.
Richten Sie den CPU-Schutz ber die Gertekonfiguration des TIA Portals ein und vergeben
Sie ein sicheres Passwort. Sichere Passwrter sind mindestens acht Zeichen lang, bestehen
aus Buchstaben, Zahlen und Sonderzeichen, sind keine Wrter, die in einem Wrterbuch zu
finden sind, und sind keine Namen oder Kennungen, die sich aus persnlichen Daten
ableiten lassen. Halten Sie das Passwort geheim und ndern Sie es hufig.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

56

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.13 Einstellen der Uhrzeit in CPUs

3.13

Einstellen der Uhrzeit in CPUs

Einstellen der Uhrzeit in CPUs auf die aktuelle PG/PC-Zeit


ber die Schaltflche "Time" kann die Uhrzeit von ausgewhlten CPUs auf die aktuelle
PG/PC-Zeit eingestellt werden. Zeitumrechnungsangaben hinsichtlich Zeitzone und
Sommerzeit werden nicht gendert und mssen im TIA Portal-Projekt angepasst werden.
1. Klicken Sie an den Gerten, die sie in den Vorgang einschlieen mchten, auf das
linke Kontrollkstchen. Sie knnen die Befehle "Select All" und "Unselect All" ber
das obere Kontrollkstchen, das Kontextmen der rechten Maustaste oder das Men "Edit" auswhlen.
2. Whlen Sie im Men "Network" das Element "Set Time" oder klicken Sie in der
Symbolleiste auf die Schaltflche "Set time in devices to PC time".
3. Klicken Sie im Dialogfeld "Set Time" auf die Schaltflche "Continue".
4. Die Systemzeit ausgewhlter CPUs wird auf die aktuelle PG/PC-Zeit eingestellt.
5. Im Event Log unterhalb der Gertetabelle werden die Ergebnisse dieses Vorgangs
angezeigt.
Die ausgewhlten Gerte in der folgenden Abbildung stellen die eigene Uhrzeit auf die
aktuelle PG/PC-Zeit, sobald der Befehl "Set Time" ausgefhrt wird.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

57

Toolfunktionen
3.14 Lesen des Diagnosepuffers in einer CPU

3.14

Lesen des Diagnosepuffers in einer CPU

CPU-Diagnosepuffer
Der CPU-Diagnosepuffer enthlt zu jedem Diagnoseereignis einen Eintrag. Jeder Eintrag
umfasst das Datum und die Uhrzeit, zu denen das Ereignis aufgetreten ist, eine
Ereigniskategorie und eine Ereignisbeschreibung. Die Eintrge werden in chronologischer
Reihenfolge angezeigt, wobei das jngste Ereignis an oberster Stelle steht. In diesem Puffer
werden bis zu 50 aktuelle Ereignisse gespeichert. Ist der Puffer voll, wird immer das lteste
Ereignis durch ein neues Ereignis berschrieben. Bei einer Unterbrechung der
Stromversorgung werden die Ereignisse gespeichert.
1. Klicken Sie in der Spalte "Select" auf das Kontrollkstchen einer CPU. Sie knnen das Kontextmen ber die rechte Maustaste verwenden oder das Men
"Edit" fr den Befehl "Unselect All".
2. Whlen Sie im Men "Network" das Element "Diagnostics buffer" oder klicken
Sie in der Symbolleiste auf die Schaltflche "Diagnostics".
3. Das SIMATIC Automation Tool zeigt den Inhalt des CPU-Diagnosepuffers an.
Beispiel fr einen Diagnosepuffer
Die folgenden Ereignistypen werden im Diagnosepuffer erfasst.
Systemdiagnoseereignis (jeder CPU-Fehler und Modulfehler)
CPU-Zustandsnderungen (jeder Hochlauf, jeder Wechsel in STOP, jeder Wechsel in
RUN)
Sie knnen sich mithilfe des Kontrollkstchens "Display CPU Time Stamp in PG/PC local
time" die Zeitstempel in der Ortszeit oder in UTC-Zeit (Coordinated Universal Time)
anzeigen lassen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

58

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Toolfunktionen
3.15 Reihenfolge der Ausfhrung von Prozessen

3.15

Reihenfolge der Ausfhrung von Prozessen


Prozesse werden ber eine Schaltflche in der Symbolleiste oder ber einen Meneintrag
angestoen. Mit jedem Klick auf die Schaltflche in der Symbolleiste wird die Warteschlange
der Prozesse fr jede ausgewhlte Gertezeile um einen einzelnen Prozess ergnzt. Wenn
beispielsweise 20 verschiedene CPUs ausgewhlt sind und auf die Schaltflche RUN
geklickt wird, dann wird die Warteschlange um 20 RUN-Prozesse ergnzt.
Zur Leistungsverbesserung knnen separate Threads unabhngig voneinander laufen, um
die in der Warteschlange enthaltenen Prozesse zu initialisieren und auszufhren. Die
zulssige Anzahl gleichzeitiger Threads wird im Dialog "Options" festgelegt. Separate
Threads drfen Auftrge in einer CPU nicht gleichzeitig starten, um Situationen zu
vermeiden, in denen ein Auftrag die CPU in die Betriebsart STOP und ein anderer Auftrag
dieselbe CPU in die Betriebsart RUN versetzt.

Ausfhrungsbeispiele
Beispiel 1:
Wenn die Prozess-Warteschlange 10 Go-to-RUN-Auftrge fr verschiedene CPUs enthlt,
dann arbeiten mehrere Threads parallel, um alle CPUs in die Betriebsart RUN zu versetzen.
Da die Threads parallel ausgefhrt werden, kann nicht garantiert werden, in welcher
Reihenfolge die CPUs in die Betriebsart RUN gehen. Die Kommunikationsgeschwindigkeit
und die Dauer bis zum Abschluss eines Auftrags knnen je nach CPU unterschiedlich sein.
Beispiel 2:
Sie knnen so viele Auftrge des gleichen Typs in die Warteschlange stellen, wie Sie
mchten. Beispielsweise knnen Sie 100 CPUs in die Betriebsart STOP versetzen, indem
Sie alle 100 CPUs auswhlen und auf die Schaltflche "STOP" klicken. Es wird solange ein
Dialogfeld mit einem Fortschrittsbalken eingeblendet, bis alle 100 Auftrge abgeschlossen
sind. Dieses Dialogfeld blockiert solange den Start eines weiteren Prozesses, bis alle STOPProzesse abgeschlossen sind.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

59

Toolfunktionen
3.15 Reihenfolge der Ausfhrung von Prozessen

SIMATIC Automation Tool V2.1 Benutzerhandbuch

60

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Speichern der Gertetabelleninformationen


4.1

"Save"/"Save as" - Speichern der Gertetabelle in verschlsseltem


SAT-Format
Verwenden Sie die Befehle Save/Save as oder klicken Sie auf die Schaltflche "Save", um
die Gertetabelleninformationen in einer verschlsselten SAT-Datei zu speichern. Sobald
das SIMATIC Automation Tool-Projekt gespeichert ist, knnen Sie den Befehl File>Open
zum Wiederherstellen der Gertetabelle dieses Projekts verwenden.
Der Speicherpfad der SAT-Datei wird ber den Befehl Tools>Options festgelegt.
Der Standardpfad lautet C:\ProgramData\Siemens\SIMATIC Automation Tool\Projects.
Sie knnen diesen Pfad bei Bedarf ndern.
Zum Speichern einer SAT-Projektdatei im SIMATIC Automation Tool mssen Sie ein
gltiges Passwort angeben.
Zum erneuten ffnen einer vorhandenen SAT-Projektdatei im SIMATIC Automation Tool
mssen Sie das korrekte Passwort eingeben.

Schtzen der SAT-Datei im SIMATIC Automation Tool


Schtzen Sie Ihr SIMATIC Automation Tool-Projekt mit einem sicheren Passwort. Sichere
Passwrter sind mindestens zehn Zeichen lang, bestehen aus Buchstaben, Zahlen und
Sonderzeichen, sind keine Wrter, die in einem Wrterbuch zu finden sind, und sind keine
Namen oder Kennungen, die sich aus persnlichen Daten ableiten lassen. Halten Sie das
Passwort geheim und ndern Sie es hufig.
Passwortregeln im SIMATIC Automation Tool
Mindestens zehn Zeichen lang
Obligatorische Kombination aus Buchstaben, Zahlen und Sonderzeichen
Integrittsprfung der SAT-Datei
Vor dem ffnen eines Projekts wird anhand eines internen Prfsummentests geprft, ob die
Daten in der Datei seit dem letzten Speichervorgang des SIMATIC Automation Tools
gendert wurden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

61

Speichern der Gertetabelleninformationen


4.2 "Import"/"Export" - Laden/Speichern der Gertetabelle aus/in offenem CSV-Format

4.2

"Import"/"Export" - Laden/Speichern der Gertetabelle aus/in


offenem CSV-Format
Der Menbefehl File>Export speichert die Gertetabelle im CSV-Textformat (durch
Komma getrennte Werte).
Der Menbefehl File>Import liest eine CSV-Textdatei und fgt die Daten in die
Gertetabelle des SIMATIC Automation Tools ein.
Die erste Textzeile ist eine beschreibende berschrift, der sich eine oder mehrere
Datenzeilen anschlieen. Der Datentext muss dem geforderten Format entsprechen und mit
zwlf Kommazeichen (",") in jeder Textzeile enthalten. Zwlf Kommazeichen trennen die
dreizehn Datenspalten, die Sie im Exportbeispiel sehen.
Die Gertetabelle im SIMATIC Automation Tool konfiguriert die Kommunikation mit einer
Gertegruppe. Wenn Sie falsche Informationen in die Zellen einer Gertetabelle oder in eine
importierte CSV-Datei eintragen, kann der betroffene Gertevorgang fehlschlagen.
Korrigieren Sie die Gertedaten und wiederholen Sie den Vorgang.
Hinweis
CPU-Passwrter werden nicht exportiert
Wenn Sie eine Gertetabelle ber die Option Export exportieren, dann bleibt die zehnte
Spalte der CSV-Datei (Passwort) aus Sicherheitsgrnden leer.
Sie knnen eine CSV-Datei bearbeiten, die Passwrter ergnzen und anschlieend ber die
Option Import importieren. Die Passwrter werden daraufhin in der Gertetabelle des
SIMATIC Automation Tools angezeigt.
Der Import- bzw. Exportpfad der CSV-Datei wird ber den Befehl Tools>Options festgelegt.
Der Standardpfad lautet C:\ProgramData\Siemens\SIMATIC Automation Tool\Projects. Sie
knnen diesen Pfad bei Bedarf ndern.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

62

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Speichern der Gertetabelleninformationen


4.2 "Import"/"Export" - Laden/Speichern der Gertetabelle aus/in offenem CSV-Format

Beispiel fr einen Export


Die folgende Abbildung zeigt das Textformat einer vom SIMATIC Automation Tool
exportierten CSV-Datei.

Die folgende Abbildung zeigt dieselbe Textdatei in Microsoft Excel.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

63

Speichern der Gertetabelleninformationen


4.2 "Import"/"Export" - Laden/Speichern der Gertetabelle aus/in offenem CSV-Format

SIMATIC Automation Tool V2.1 Benutzerhandbuch

64

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Mens, Symbolleiste und Tastenkombinationen


5.1

Hauptmen

5.1.1

Men "File"
Sym- Menbefehl
bol

Beschreibung

New

Erstellen eines neuen SIMATIC Automation Tool-Projekts.

Open

Angezeigt wird der Dialog "Open", in dem Sie zu einem Ordner navigieren,
eine SAT-Projektdatei auswhlen und ein Passwort zum ffnen einer verschlsselten Projektdatei eingeben knnen. Der Standardpfad wird im
Dialog Tools>Options festgelegt.

Save

Die Gertetabellendaten werden in einer SAT-Datei gespeichert. Falls


weder Dateiname noch Passwort zugewiesen wurden, greift dieser Vorgang auf den Befehl "Save As" zurck.

Save As

Die Gertetabellendaten werden in einer SAT-Datei gespeichert. Sie knnen zu einem Ordner navigieren, einen SAT-Projektdateinamen zuweisen
und ein Passwort zum Schutz der Projektdatei vergeben. Der Standardpfad
wird im Dialog Tools>Options festgelegt.

Import...

Ausfllen der Gertetabelle mit Daten aus einer Datei im CSV-Format.

Export...

Speichern der Gertetabellendaten in einer Datei im CSV-Format.

Exit

Schlieen der Anwendung. Falls das Projekt seit dem letzten Speichervorgang gendert wurde, wird der "Speichern"-Vorgang ausgefhrt.

Siehe auch
"Save"/"Save as" - Speichern der Gertetabelle in verschlsseltem SAT-Format (Seite 61)
"Import"/"Export" - Laden/Speichern der Gertetabelle aus/in offenem CSV-Format
(Seite 62)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

65

Mens, Symbolleiste und Tastenkombinationen


5.1 Hauptmen

5.1.2

Men "Edit"
Symbol

Menbefehl

Beschreibung

Cut

Ausschneiden der ausgewhlten Daten und Kopieren dieser


Daten in die Zwischenablage. Die Eintrge in der Zwischenablage sind mit Excel kompatibel, sodass Daten zwischen den
beiden Anwendungen ausgetauscht werden knnen. Schreibgeschtzte Zellen werden nicht gelscht.

Copy

Kopieren der ausgewhlten Daten in einem Excel-kompatiblen


Format in die Zwischenablage.

Paste

Einfgen der in der Zwischenablage enthaltenen Daten in ein


ausgewhltes Feld bzw. in ausgewhlte Felder im SIMATIC
Automation Tool. Schreibgeschtzte Zellen werden nicht gendert.

Check All

Markieren (Auswhlen) aller Datenzeilen im sichtbaren Register.

Uncheck All

Aufheben der Markierung aller Zeilen im sichtbaren Register.

Expand All

Erweitern aller Gerte- und Modulzeilen.

Collapse All

Reduzieren aller Gerte- und Modulzeilen.

Insert Device

Einfgen einer neuen Gertezeile an der ausgewhlten Zeile


und Verschieben der nachfolgenden Gertezeilen nach unten.
Falls ein Gert durch einen Netzwerkscan nicht erkannt wird,
knnen Sie diesen Befehl zum Hinzufgen des Gerts zur
Gertetabelle verwenden. Wenn Sie diesen Befehl zum Einfgen eines Gerts verwenden, wird der Gertename blau dargestellt. Die blaue Farbe bedeutet, dass die auf MACAdressen basierenden Vorgnge (LED-Blinken, Einstellen der
IP-Adresse und Einstellen des PROFINET-Namens) nicht
mglich sind und die entsprechenden Zellen der Gertetabelle
deaktiviert werden.

Delete

Device

Lschen einer oder mehrerer markierter Gertezeilen.

Selection

Lschen der aktuellen Auswahl in der Gertetabelle.

Refresh Devices F5

Aktualisieren der markierten Gerte.

Check for Updates

ffnen der Siemens-Support-Website fr das ausgewhlte


Gert.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

66

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Mens, Symbolleiste und Tastenkombinationen


5.1 Hauptmen

5.1.3

Men "Network"
Symbol

Menbefehl

Beschreibung

Scan

Scannen der ausgewhlten Netzwerkschnittstelle auf erreichbare


CPUs und Module.

Download

Laden von in das SIMATIC Automation Tool eingegebenen Daten in


PLCs im Netzwerk. Der Downloadtyp hngt von der aktuellen Registerauswahl ab.
Downloadtypen:

IP-Adressparameter

PROFINET-Name

Programmaktualisierung

Firmware-Aktualisierung

Wiederherstellen von Gertedaten aus benannter s7pbkpSicherungsdatei

RUN

Versetzen der ausgewhlten CPUs in die Betriebsart RUN.

STOP

Versetzen der ausgewhlten CPUs in die Betriebsart STOP.

Flash LEDs

LEDs an den ausgewhlten Gerten blinken lassen. Verwenden Sie


diese Funktion zum physischen Lokalisieren eines Gerts.

Reset to factory
defaults

Rcksetzen ausgewhlter Gerte auf die Werkseinstellungen.

Memory reset

Urlschen des Speichers ausgewhlter CPUs.

Upload service
data

Laden von Serviceinformationen aus CPUs.

Set time

Einstellen der Uhrzeit in ausgewhlten CPUs auf die PG/PC-Zeit.

Backup

Sichern aller CPU-Daten in ausgewhlten CPUs.

Diagnostics buffer

Lesen des Diagnoseprotokolls einer CPU.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

67

Mens, Symbolleiste und Tastenkombinationen


5.1 Hauptmen

5.1.4

Men "Tools"
Symbol

Menbefehl

Beschreibung

Options

Set file paths for the SIMATIC Automation Tool

Pfad fr SIMATIC Automation Tool-Projektdateien

Pfad fr CPU-Firmware-Update-Dateien

Pfad fr Programm-Update-Dateien

Pfad fr Servicedatendateien

Pfad fr Sicherungs-/Wiederherstellungsdateien
Allow firmware update to replace same firmware version
Die Standardeinstellung ist deaktiviert, um Zeit zu sparen, indem unntige Vorgnge vermieden werden. Sie knnen eine Aktualisierung erzwingen, indem Sie diese Option aktivieren.
Allow multiple threads for firmware update, reset to factory defaults, and
restore device
Wenn Ihr Netzwerk eine Sterntopologie hat, bei der jede CPU eine separate Verbindung zum PG/PC ber einen Ethernet-Switch unterhlt,
knnen Sie die Multiple-Thread-Option aktivieren.
Falls Ihr Netzwerk eine Kettentopologie besitzt, dann sollten Sie diese
Option deaktivieren, damit eine CPU nicht die Kommunikation mit einer
anderen CPU unterbricht. Beispiel: Sie haben eine Kettentopologie
(PG/PC zu CPUa zu CPUb zu CPUc zu ...). Ein laufender Vorgang in
CPUb wird unterbrochen, wenn ein separater Thread einen Neustart der
CPUa verursacht.
Set simultaneous operations limit
Begrenzung der Anzahl der Kommunikationsverbindungen und Verarbeitungs-Threads. Die von Ihnen ausgewhlte Gertegruppe kann
gleichzeitig Kommunikations- und Prozessanfragen vom SIMATIC Automation Tool verarbeiten.
Es knnen maximal 5 Prozesse gleichzeitig ausgefhrt werden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

68

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Mens, Symbolleiste und Tastenkombinationen


5.1 Hauptmen
Standardoptionen

Hinweis
Kommunikationsprobleme mit dem SIMATIC Automation Tool
Beispielsweise senden Sie einen Befehl an mehrere Gerte, aber ein Gert schliet den
Vorgang nicht ab und ein Kommunikationsfehler wird fr dieses Gert angezeigt. Die
anderen Gerte kommunizieren und fhren den Vorgang jedoch wie erwartet aus.
Senken Sie bei auftretenden Kommunikationsproblemen die maximale Anzahl an simultanen
Vorgngen (Threads/Verbindungen), die im Dialogfeld Tools > Options festgelegt werden
kann. Schlieen Sie das SIMATIC Automation Tool und ffnen Sie die Anwendung erneut,
wiederholen Sie anschlieend die Gruppenfunktion.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

69

Mens, Symbolleiste und Tastenkombinationen


5.1 Hauptmen

5.1.5

Men "Help"
Sym- Menbol
befehl
View user guide

Beschreibung
ffnen des Benutzerhandbuchs des SIMATIC Automation Tools. Das
Benutzerhandbuch liegt im PDF-Format vor. Zum ffnen und Lesen
des Handbuchs bentigen Sie entsprechende Software.
Das Benutzerhandbuch ist auf Englisch und Deutsch installiert. Welche
Version angezeigt wird, hngt von den Einstellungen fr Region und
Sprache Ihres Windows-Betriebssystems ab.
Das deutsche Benutzerhandbuch wird bei folgenden Einstellungen
angezeigt:

de Deutsch

de-AT Deutsch (sterreich)

de-DE Deutsch (Deutschland)

de-CH Deutsch (Schweiz)

de-LI Deutsch (Liechtenstein)

de-LU Deutsch (Luxemburg)


In allen anderen Fllen wird das englische Benutzerhandbuch angezeigt.
About

Anzeigen von Informationen zu:

Produktname

Version

SIMATIC Automation Tool V2.1 Benutzerhandbuch

70

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Mens, Symbolleiste und Tastenkombinationen


5.2 Symbole der Symbolleiste

5.2
Symbol

Symbole der Symbolleiste


Beschreibung
Neu: Erstellen eines neuen SIMATIC Automation Tool-Projekts mit der Dateinamenerweiterung "*.SAT".
ffnen: Anzeien des Dialogs "Open", in dem Sie zu einem Ordner navigieren, eine SAT-Projektdatei auswhlen
und ein Passwort zum ffnen einer verschlsselten Projektdatei eingeben knnen.
Speichern der geffneten Projektdaten in einer Datei. Falls weder Dateiname noch Passwort zugewiesen wurden, wird der Dialog "Save As" angezeigt.
Ausschneiden der ausgewhlten Daten und Kopieren dieser Daten in die Zwischenablage. Die Daten in der
Zwischenablage sind mit Excel kompatibel, sodass Daten zwischen den beiden Anwendungen ausgetauscht
werden knnen.
Kopieren der ausgewhlten Daten in die Zwischenablage.
Einfgen der in der Zwischenablage enthaltenen Daten in das ausgewhlte Feld bzw. in die ausgewhlten
Felder.
Scannen der ausgewhlten Netzwerkschnittstelle auf erreichbare CPUs und Module.
Laden von in das SIMATIC Automation Tool eingegebenen Daten in Gerte im Netzwerk. Entsprechend der
aktuellen Registerauswahl werden entweder IP-Adressen, PROFINET-Namen, Programmaktualisierungen,
Firmware-Aktualisierungen oder Wiederherstellungsdaten aus einer Sicherungsdatei geladen.
RUN: Versetzen der ausgewhlten CPUs in die Betriebsart RUN.
STOP: Versetzen der ausgewhlten CPUs in die Betriebsart STOP.
LEDs an den ausgewhlten Gerten blinken lassen. Verwenden Sie diese Funktion zum physischen Lokalisieren eines Gerts.
Rcksetzen auf die Werkseinstellungen ausgewhlter CPUs.
Urlschen des Speichers: Urlschen des Speichers von ausgewhlten Gerten.
Laden von Servicedaten: Laden von Serviceinformationen aus einer CPU.
Einstellen der Uhrzeit: Einstellen der Systemzeit ausgewhlter CPUs auf die aktuelle PG/PC-Zeit.
Sichern des Gerts: Erstellen von Sicherungsdaten und Ausfhren einer Datensicherung.
Diagnose: Lesen eines CPU-Diagnosepuffers
Klappliste der Netzwerkschnittstelle: Auswhlen der Ethernet-Netzwerkschnittstelle,
die mit dem Industriesteuerungsnetzwerk verbunden ist.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

71

Mens, Symbolleiste und Tastenkombinationen


5.3 Tastenkombinationen

5.3

Tastenkombinationen
STRG+Bild auf

Umschalten zwischen Registern, von links nach rechts

STRG+Bild ab

Umschalten zwischen Registern, von rechts nach links

STRG+A

Auswhlen der gesamten Tabelle

STRG+C

Kopieren der ausgewhlten Zellen

STRG+O

Anzeigen des Dialogs "Project open" zum ffnen einer neuen


Projektdatei

STRG+S

Anzeigen des Dialogs "Save As"

STRG+V

Einfgen der Inhalte aus der Zwischenablage am Einfgepunkt


und Ersetzen der Auswahl

STRG+X

Ausschneiden der ausgewhlten Zellen

STRG+Z

Rckgngig machen des letzten Bearbeitungs- oder Lschvorgangs

PFEILTASTEN

Eine Zelle nach oben, unten, links oder rechts navigieren

UMSCHALT+PFEILTAST Erweitern der Zellenauswahl


EN
LSCHEN

Entfernen der Inhalte der aktiven Zelle

EINGABE

Abschlieen der Zellenbearbeitung und Validieren der Daten

ESC

Abbrechen der Zellenbearbeitung und Wiederherstellen des ursprnglichen Zellenwerts

POS1

Zum Anfang einer Zeile navigieren

STRG+POS1

Zum Anfang der Tabelle navigieren

ENDE

Zum Ende einer Zeile navigieren

STRG+ENDE

Zum Ende der Tabelle navigieren

BILD AB

In der Tabelle einen Bildschirm nach unten navigieren

BILD AUF

In der Tabelle einen Bildschirm nach oben navigieren

LEERTASTE

Kontrollkstchen der Zeile oder ggf. mehrerer Zeilen auswhlen


oder lschen

TAB

Eine Zelle nach rechts navigieren

SIMATIC Automation Tool V2.1 Benutzerhandbuch

72

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.1

Einfhrung in die API

API (Anwendungsprogrammierschnittstelle)
Mithilfe der SIMATIC Automation Tool API knnen Sie entsprechend der im SIMATIC
Automation Tool verfgbaren Funktionalitt benutzerspezifische Anwendungs-Software
erstellen. In einer benutzerspezifischen Anwendungssoftware knnen Sie Operationen in
einer bestimmten Reihenfolge programmieren und so fr Ihr
Industrieautomatisierungsnetzwerk optimierte Workflows erstellen. In den folgenden
Abschnitten werden die ber die API bereitgestellten Operationen und Datentypen
beschrieben.
Kompatibilitt mit frheren Versionen
Die SIMATIC Automation Tool API wurde fr Version 2.1 berarbeitet. Programme, die fr
diese API zuvor geschrieben wurden, mssen ebenfalls berarbeitet werden.
Beispielnetzwerk
Ein Beispiel fr ein im TIA Portal angezeigtes Netzwerk und fr die entsprechenden von
Ihrer Anwendungs-Software verwendbaren API-Schnittstellen finden Sie in Anhang A
(Seite 137).

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

73

SIMATIC Automation Tool API fr .NET Framework


6.2 bersicht ber die Architektur

6.2

bersicht ber die Architektur


Netzwerke
Das Netzwerk der .NET-Klasse dient dazu, mithilfe einer auf einem PG/PC installierten
Netzwerkkarte (NIC) Funktionen auszufhren. Die .NET-Klasse wird verwendet, um auf
verfgbare Schnittstellenkarten zu scannen und die zu verwendende Schnittstellenkarte
auszuwhlen. Alle Kommunikationen des SIMATIC Automation Tools mit dem
Industrienetzwerk erfolgen ber die so ausgewhlte Netzwerkschnittstelle.
Network-Constructor (Seite 80)
Methode QueryNetworkInterfaceCards (Seite 81)
Methode SetCurrentNetworkInterface (Seite 82)
Eigenschaft CurrentNetworkInterface (Seite 82)
Methode ScanNetworkDevices (Seite 83)
Gerte
Die einzelnen Gerte im Netzwerk werden durch Schnittstellen reprsentiert. Jede NIC-Karte
stellt Eigenschaften und Methoden bereit, die fr das reprsentierte Netzwerkgert geeignet
sind. Die im Netzwerk vorhandenen Hardwaregerte werden jeweils am besten durch eine
der folgenden Schnittstellen reprsentiert:
IProfinetDevice Durch diese Schnittstelle kann jedes im Industrienetzwerk erreichbare
Gert dargestellt werden.
ICPU Diese Schnittstelle steht fr S7 CPUs, die direkt mit dem Netzwerk verbunden
sind. Bei CPUs werden spezifische Funktionen untersttzt.
IBaseDevice Mit dieser Schnittstelle werden Gerte reprsentiert, die nicht direkt mit
dem Ethernet-Netzwerk verbunden, aber ber ein anderes Gert erreichbar sind. Dies ist
beispielsweise eine mit einer CPU verbundene PROFIBUS-Slave-Station, die im
Netzwerk als IBaseDevice reprsentiert wird.
IModule Mit dieser Schnittstelle werden einzelne Peripheriemodule reprsentiert, die in
eine CPU, ein PROFINET-Gert oder eine PROFIBUS-Station eingesteckt sind.
IHardware Die Basisklasse fr alle anderen Schnittstellen. Diese Schnittstelle bietet
Zugriff auf alle Eigenschaften, die den im Netzwerk erkannten Hardwareelementen
gemeinsam sind.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

74

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.2 bersicht ber die Architektur
Die Schnittstellen sind in Sammlungen zusammengefasst, die jeweils Gruppen von Gerten
darstellen. Die Sammlungen werden fr Iterationen, Filter- und Suchvorgnge bereitgestellt.
Beispiele:
IProfinetDeviceCollection Eine Sammlung aller im Netzwerk direkt erreichbaren Gerte.
IModuleCollection Eine Sammlung, die beispielsweise alle in eine CPU oder
Peripheriestation eingesteckten Peripheriemodule reprsentiert.
IHardwareCollection Diese Sammlung kann eine CPU und alle zugehrigen
Peripheriemodule reprsentieren.

Klasse IProfinetDeviceCollection (Seite 84)


Schnittstelle IProfinetDevice (Seite 91)
IProfinetDevice-Methoden
RefreshStatus (Seite 94)
FirmwareUpdate (Seite 95)
FlashLED (Seite 97)
Reset (Seite 98)
SetIP (Seite 99)
SetProfinetName (Seite 100)
IProfinetDevice-Ereignisse (Seite 101)
Klasse IModuleCollection (Seite 104)
Schnittstelle IModule (Seite 104)
Schnittstelle ICPU (Seite 106)
ICPU-Methoden
Sicherung (Seite 108)
GetCurrentDateTime (Seite 109)
GetDiagnosticsBuffer (Seite 110)
GetOperatingState (Seite 111)
MemoryReset (Seite 112)
ProgramUpdate (Seite 113)
ResetToFactory (Seite 114)
Wiederherstellen (Seite 115)
SetOperatingState (Seite 116)
SetCurrentDateTime (Seite 117)
UploadServiceData (Seite 118)
IRemoteInterface-Eigenschaften (Seite 119)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

75

SIMATIC Automation Tool API fr .NET Framework


6.3 Verweis auf die API in einer Kundenapplikation

Hinweis
Ein Beispiel fr ein Industrienetzwerk und fr die zur Darstellung der einzelnen
Netzwerkkomponenten verwendeten Klassen der SIMATIC Automation Tool API finden Sie
im Anhang (Seite 137).

6.3

Verweis auf die API in einer Kundenapplikation


Die API wird als eine einzige DLL bereitgestellt:
AutomationToolAPI.dll

Diese DLL wurde mit Microsoft Visual Studio 2010 und .NET Framework Version 4.0 erstellt.
Sie ist verwendbar mit Applikationen, die mit dieser Version oder hheren Versionen von
Visual Studio einschlielich Visual Studio 2015 SP2 erstellt wurden. Alle Codebeispiele und
Screenshots in diesem Dokument wurden mit Visual Studio 2015 SP2 in der
Programmiersprache C# generiert.
Wenn Sie die API in Ihre Applikation aufnehmen mchten, mssen Sie AutomationTool.dll
als Verweis (reference) in Ihre Visual-Studio-Lsung einfgen.
In jeder Quelldatei, in der auf die API-Klassen verwiesen wird, muss die folgende usingAnweisung als Verweis auf den API-Namespace eingefgt werden:
using Siemens.Automation.AutomationTool.API;

Zur bersetzung aller Codebeispiele in diesem Dokument muss jeweils die richtige usingAnweisung in derselben Quelldatei (*.cs) wie der Beispielcode enthalten sein. Der
Einfachheit halber ist die using-Anweisung in den einzelnen Codebeispielen dieses
Dokuments nicht aufgefhrt.
Fr den Zugriff auf die API zur Laufzeit muss auf dem PG/PC die richtige Version der S7Kommunikationssoftware installiert sein. Dies lsst sich am einfachsten dadurch
sicherstellen, dass das SIMATIC Automation Tool auf dem betreffenden Rechner installiert
wird. Nach der Installation kann die API-DLL (AutomationToolAPI.dll) in einen beliebigen
Ordner auf dem PG/PC eingefgt und erfolgreich verwendet werden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

76

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.4 Hufig zur Untersttzung verwendete Klassen

6.4

Hufig zur Untersttzung verwendete Klassen

6.4.1

Klasse EncryptedString
Vor der Beschreibung der von der API verfgbar gemachten Operationen muss zunchst ein
Grundverstndnis einiger Klassen geschaffen werden, die in den meisten Codebeispielen
vorkommen.

Klasse EncryptedString
Viele API-Operationen setzen eine legitimierte Verbindung zu einer SIMATIC S7 CPU
voraus. Fr diese Operationen ist als einer der Parameter fr diese Methode ein Passwort
erforderlich. Die S7 CPU nimmt das Passwort in verschlsseltem Format entgegen. Zu
diesem Zweck stellt die API die Klasse EncryptedString bereit.
Mithilfe dieser Klasse kann ein Klartextpasswort so verschlsselt werden, dass es zur
Legitimierung einer CPU-Verbindung dienen kann. Viele der Codebeispiele zeigen eine
typische Verwendungsweise dieser Klasse. In den meisten Codebeispielen wird ein
EncryptedString direkt am Ort seiner Verwendung instanziiert, z. B. wie folgt:
Result retVal = devAsCpu.RefreshStatus(new EncryptedString("password"));

Wenn Sie ein Passwort zur mehrfachen Verwendung in Ihrem Code verschlsseln wollen,
knnen Sie auch den EncryptedString instanziieren und dann wie folgt als Parameter an
mehrere Aufrufe bergeben:
EncryptedString pwd = new EncryptedString(Passwort");
DateTime curTime = new DateTime();
Result retVal = devAsCpu.RefreshStatus(pwd);
retVal = devAsCpu.GetCurrentDateTime(pwd, out curTime);

Hinweis
Wenn eine CPU nicht passwortgeschtzt ist, bergeben Sie einfach eine leere Zeichenkette
an den EncryptedString-Constructor. Beispielsweise knnte der folgende Code erfolgreich
bei einer CPU eingesetzt werden, fr die kein Schutz konfiguriert ist:
Result retVal = devAsCpu.RefreshStatus(new EncryptedString(""));

Or

Result retVal = devAsCpu.RefreshStatus(new EncryptedString(String.Empty));

Im EncryptedString-Objekt wird das vom Anwender zugeordnete Klartextpasswort nicht


gespeichert. Wenn jedoch Ihre Applikation Passwrter als Literalzeichenketten codiert, z. B.
als neues EncryptedString(meinPasswort), wird der Klartext "meinPasswort" in das
Anwenderprogramm bersetzt und ist unter Umstnden fr andere, die die .NET Reflection
API nutzen, sichtbar.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

77

SIMATIC Automation Tool API fr .NET Framework


6.4 Hufig zur Untersttzung verwendete Klassen

6.4.2

Passwort fr fehlersicheren Betrieb


Sie sind nicht berechtigt, eine Verbindung mit einer S7-CPU durch ein Passwort fr
fehlersicheren Betrieb zu legitimieren. Wenn Sie ein Passwort fr fehlersicheren Betrieb fr
eine ICPU-Methode angeben, die ein Passwort akzeptiert, schlgt die Methode der SIMATIC
Automation Tool API fehl und gibt folgenden Fehler aus:
ErrorCode.LegitimizationFailsafeLevelNotAllowed.

6.4.3

Klasse Result

Klasse Result
Diese Klasse verkapselt die Logik, die feststellt, ob eine bestimmte API-Aktion erfolgreich ist.
Die meisten API-Aktionen erfordern ein gewisses Ma an Netzwerkkommunikation. Bei
vielen Aktionen wird auerdem eine Verbindung zu einem Netzwerkgert geffnet. Es gibt
keine Garantie, dass solche Aktionen erfolgreich ablaufen. Das von einer API-Aktion
ausgegebene Result-Objekt sollte immer auf erfolgreiche oder fehlgeschlagene Ausfhrung
berprft werden.
In vielen Fllen reicht es wahrscheinlich aus, zu wissen, ob eine bestimmte Aktion
erfolgreich war. In solchen Fllen ist es nur erforderlich, die Eigenschaft Succeeded zu
berprfen.
Result retVal = dev.RefreshStatus(new EncryptedString(""));
if (retVal.Succeeded)
{
//-----------------------// Operationen fortsetzen....
//-----------------------}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

78

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.4 Hufig zur Untersttzung verwendete Klassen
In anderen Fllen brauchen Sie vielleicht weitere Informationen ber die fehlgeschlagene
Operation. Zur Inspektion des konkreten Fehlers verwenden Sie wie folgt die Eigenschaft
Code:
Result retVal = devAsCpu.RefreshStatus(new EncryptedString(""));
if (retVal.Succeeded)
{
//-----------------------// Operationen fortsetzen....
//-----------------------}
else
{
//-------------// Was passiert ist
//-------------switch (retVal.Code)
{
case ErrorCode.AccessDenied:
break;
case ErrorCode.TooManySessions:
break;
}
}

Siehe auch ErrorCode-Werte (Seite 125)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

79

SIMATIC Automation Tool API fr .NET Framework


6.5 Die Klasse Network

6.5

Die Klasse Network

6.5.1

Network-Constructor
Die .NET-Klasse Network dient dazu, Funktionen mithilfe einer auf einem PG/PC installierten
Netzwerkkarte (NIC) auszufhren. Die Klasse Network wird verwendet, um auf verfgbare
Schnittstellenkarten zu scannen und die Schnittstellenkarte auszuwhlen, die mit dem
Industrienetzwerk kommuniziert.

Constructor
Zur Interaktion mit dem Industrienetzwerk deklariert Ihr Programm wie folgt eine Variable
des Typs Network:
Network myNetwork = new Network();

Sie knnen mithilfe dieses Objekts verfgbare Netzwerkschnittstellen ermitteln und die zu
verwendende Netzwerkschnittstelle auswhlen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

80

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.5 Die Klasse Network

6.5.2
Ausgabetyp
Result

Methode QueryNetworkInterfaceCards
Methodenname

QueryNetworkInterfaceCards

Parameters

Name

aInterfaces

Datentyp

List<string>

Parametertyp
Out

Beschreibung

Eine Sammlung aller Netzwerkschnittstellenkarten auf dem PG/PC


in einer Auflistung nach Namen.

Zur Ermittlung der verfgbaren Netzwerkkarten verwenden Sie wie im folgenden Beispiel
gezeigt die Methode QueryNetworkInterfaceCards:
Network myNetwork = new Network();
List<String> interfaces = new List<String>();
Result retVal = myNetwork.QueryNetworkInterfaceCards(out interfaces);
if (retVal.Succeeded)
{
//----------------------------------------------------// Die Methode gibt eine Liste von Zeichenketten aus.
// Jede Zeichenkette in der Liste steht fr eine verfgbare Netzwerkkarte (NIC).
// Die Liste kann in Arraynotation iteriert werden.
//----------------------------------------------------for (Int32 index = 0; index < interfaces.Count; index++)
{
String strInterfaceName = interfaces[index]);
}
}

Wie das Beispiel zeigt, gibt diese Methode eine Liste von Zeichenketten aus. Jedes Element
in der Liste steht fr eine durch den Namen identifizierte verfgbare Netzwerkkarte.
Die Methode QueryNetworkInterfaceCards gibt ein Result-Objekt aus. Dieses reprsentiert
den Status der Operation. Auf einer hheren Ebene zeigt dieses Objekt an, ob die Operation
erfolgreich war (ob die Eigenschaft Succeeded wahr ist) oder fehlgeschlagen ist (d. h. die
Eigenschaft Succeeded falsch ist). Fr das Fehlschlagen einer Operation kann es viele
Grnde geben.
Eine vollstndige Beschreibung der Klasse Result finden Sie unter Klasse Result (Seite 78)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

81

SIMATIC Automation Tool API fr .NET Framework


6.5 Die Klasse Network

6.5.3
Ausgabetyp
Result

Methode SetCurrentNetworkInterface
Methodenname

SetCurrentNetworkInterface

Parameter
Name

strInterface

Datentyp
string

Parametertyp

Beschreibung

Eingang

Der Name der zu verwendenden Netzwerkkarte. In der Regel handelt es sich


dabei um einen der Namen, die von der
Methode
QueryNetworkInterfaceCards ausgege-

ben wurden.

Um eine der identifizierten Netzwerkschnittstellenkarten fr den Zugriff auf das


Industrienetzwerk zu verwenden, ist es erforderlich, diese Schnittstelle einzustellen. Der
folgende Code zeigt, wie eine der identifizierten Netzwerkschnittstellen fr API-Operationen
zugewiesen wird. Bei diesem Beispiel wird mit dem Code die erste im im vorherigen Beispiel
ermittelte Netzwerkschnittstellenkarte ausgewhlt.
Result retVal = myNetwork.SetCurrentNetworkInterface(interfaces[0]);
if (retVal.Succeeded)
{
//-----------------------------------------------// Die Aktion war erfolgreich. Mit Operationen fortfahren.
//-----------------------------------------------}

6.5.4

Eigenschaft CurrentNetworkInterface
Diese Eigenschaft wird bereitgestellt, um eine Abfrage nach der aktuell ausgewhlten
Netzwerkschnittstelle durchzufhren. Die Eigenschaft ist schreibgeschtzt. Das folgende
Beispiele zeigt die Verwendung dieser Eigenschaft.
string currentInterface = myNetwork.CurrentNetworkInterface;

Hinweis
Diese Eigenschaft gibt eine leere Zeichenkette aus, wenn durch einen frheren Aufruf der
Methode SetCurrentNetworkInterface keine Netzwerkschnittstelle ausgewhlt wurde.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

82

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.5 Die Klasse Network

6.5.5
Ausgabetyp
Result

Methode ScanNetworkDevices
Methodenname

ScanNetworkDevices

Parameter
Name

strFile

Datentyp

IProfinetDeviceCollection

Parametertyp

Beschreibung

Ausgang

Eine Sammlung, die fr jedes erreichbare


Gert im Industrienetzwerk ein Element
IProfinetDevice enthlt.

Nach Auswahl einer Netzwerkschnittstelle besteht die Mglichkeit, eine Abfrage nach den
Gerten im Industrienetzwerk durchzufhren. Die Methode ScanNetworkDevices gibt eine
Sammlung von Elementen aus, bei der jedes der Elemente ein direkt mit dem EthernetNetzwerk verbundenes Gert darstellt. Zu diesen Gerten knnen u. a. CPUs und
dezentrale Peripheriestationen gehren.
Mit dem folgenden Beispiel wird eine Sammlung aller ber die ausgewhlte
Netzwerkschnittstelle erreichbaren Gerte erstellt.
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
//-----------------------------------------------// Die Aktion war erfolgreich. Mit Operationen fortfahren.
//-----------------------------------------------}

Diese Methode gibt eine Sammlung IProfinetDeviceCollection aus. Diese Klasse wird im
nchsten Kapitel errtert.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

83

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6

Klasse IProfinetDeviceCollection

6.6.1

Elemente in der Sammlung iterieren


Die Methode ScanNetworkDevices gibt ein Objekt des Typs IProfinetDeviceCollection aus.
Diese Klasse stellt die Fhigkeit bereit, die Elemente der Sammlung auf unterschiedliche
Weise zu iterieren. Auerdem bietet sie Methoden zur Filterung der Elemente in der
Sammlung nach bestimmten Kriterien. In den folgenden Abschnitten wird die fr diese
Sammlung verfgbare Funktionalitt beschrieben.
Betrachten Sie den Beispielcode aus der Methode ScanNetworkDevices:
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);

Programmierer, die eine Syntax vom Array-Typ bevorzugen, knnen den Zugriff auf die
Elemente in scannedDevices wie folgt codieren:
if (retVal.Succeeded)
{
for (int deviceIdx = 0; deviceIdx < scannedDevices.Count; deviceIdx++)
{
//---------------------------------------------------------// Jedes Element in der Sammlung ist ein IProfinetDevice.
//---------------------------------------------------------IProfinetDevice dev = scannedDevices[deviceIdx];
}
}

Die Sammlung untersttzt auerdem die Iteration mithilfe der foreach-Syntax. Das folgende
Beispiel zeigt dieselbe Sammlung mit einer Iteration mithilfe dieser Syntax:
foreach (IProfinetDevice dev in scannedDevices)
{
//----------------------------------------------------------// Die Variable "dev" steht nun fr das nchste Element der Sammlung
//----------------------------------------------------------}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

84

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.2

Elemente in der Sammlung filtern

6.6.2.1

Elemente der Sammlung


Die Sammlung enthlt ein Element fr jedes Gert im Industrial-Ethernet-Netzwerk. Die
Sammlung kann Gerte aus mehreren Produktfamilien (z. B. S7-1200, S7-1500, ET200S
usw.) enthalten.
Die Sammlung kann ebenfalls unterschiedliche Kategorien von Gerten (z. B. CPUs oder
Peripheriestationen) enthalten. Fr unterschiedliche Gertekategorien sind spezifische
Operationen verfgbar. Deshalb kann es manchmal sinnvoll sein, die Sammlung zu filtern,
um nur mit bestimmten Gerten zu arbeiten.

6.6.2.2

Methode FilterByDeviceFamily
Diese Methode gibt eine Sammlung aus, die nur Gerte der angegebenen Produktfamilien
enthlt. Das Filterergebnis wird zunchst als Liste mit einer oder mehreren Produktfamilien
aufgebaut. Beispielsweise erstellt die folgende Deklaration einen Filter nur mit S7-1200- und
S7-1500-Gerten.
List<DeviceFamily> fams = new List<DeviceFamily> {
DeviceFamily.S71200,DeviceFamily.S71500 };

bergeben Sie diesen Filter" an die Methode FilterByDeviceFamily. Das Ergebnis ist eine
Sammlung IProfinetDeviceCollection, die nur die Gerte der angegebenen Produktfamilien
enthlt.
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
IProfinetDeviceCollection onlyPlus = scannedDevices.FilterByDeviceFamily(fams);

Die resultierende Sammlung kann anschlieend iteriert werden, um Aktionen nur mit den
enthaltenen Gerten durchzufhren.
Hinweis
Die bergabe einer leeren Deklaration List<DeviceFamily>fhrt zur Ausgabe einer leeren
Sammlung.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

85

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.2.3

Methode FilterOnlyCPUs
Die SIMATIC Automation Tool API untersttzt zahlreiche Operationen, die nur mit CPUs
zulssig sind. Daher ist es sinnvoll, die Sammlung nur nach den CPUs zu filtern, die im
Netzwerk erkannt wurden.
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
List<ICPU> cpus = scannedDevices.FilterOnlyCpus();
foreach (ICPU cpu in cpus)
{
//---------------------------------------------------------// Iteration im Durchgang durch die Liste nur aus CPU-Gerten
//---------------------------------------------------------}

Diese Methode gibt eine Liste ICPU aus. Fr CPU-Gerte werden weitere API-Operationen
untersttzt. ber die Schnittstelle ICPU werden diese Operationen bereitgestellt. Die ICPUSchnittstelle wird ausfhrlich im Kapitel Schnittstelle ICPU (Seite 106) beschrieben.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

86

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.3

Auffinden eines bestimmten Gerts in der Sammlung

6.6.3.1

Methode FindDeviceByIP
Auffinden eines bestimmten Gerts in der Sammlung Dieser Workflow wird von folgender
Methode untersttzt:
Zwei Versionen dieser Methode werden bereitgestellt; eine erlaubt die Darstellung der IPAdresse als Zeichenkette und die andere akzeptiert die IP-Adresse als vorzeichenlosen
ganzzahligen Wert.

Ausgabetyp

IProfinetDevice

Methodenname

FindDeviceByIP

Parameter
Name
ip

ipString

Datentyp
uint

string

Parametertyp

Beschreibung

Eingang

Die zu suchende IP-Adresse

Eingang

Die zu suchende IP-Adresse

Das folgende Beispiel zeigt die Suche nach einem Gert an einer angegebenen IP-Adresse.
Wird das Gert nicht in der Sammlung gefunden, so wird eine Referenz NULL ausgegeben.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (!retVal.Succeeded)
return;
IProfinetDevice dev = scannedDevices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
// Gefunden!
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

87

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.3.2

Methode FindDeviceByMAC
Mit der Methode FindDeviceByMAC kann nach einem Gert mit einer bestimmten MACAdresse gesucht werden.
Zwei Versionen dieser Methode werden bereitgestellt; eine erlaubt die Darstellung der MACAdresse als Zeichenkette und die andere akzeptiert die MAC-Adresse als vorzeichenlosen
langen ganzzahligen Wert.

Ausgabetyp

IProfinetDevice

Methodenname

FindDeviceByMAC

Parameter
Name

Datentyp

macString

string

mac

ulong

Parametertyp

Beschreibung

Eingang

Die zu suchende MAC-Adresse

Eingang

Die zu suchende MAC-Adresse im Zeichenkettenformat "xx:xx:xx:xx:xx:xx"

ulong targetMAC = 0x112233445566; // quivalent zur Zeichenkette "11:22:33:44:55:66"


retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (!retVal.Succeeded)
return;
IProfinetDevice dev = scannedDevices.FindDeviceByMAC(targetMAC);
if (dev != null)
{
// Gefunden!
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

88

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.4

Serialisierung

6.6.4.1

bertragen einer Sammlung an/von einer externen Datendatei


Die folgenden bereitgestellten Methoden ermglichen die Serialisierung und bertragung
des Inhaltes einer Sammlung an eine externe Datendatei bzw. von dieser. Diese Methoden
werden von der SIMATIC Automation Tool-Applikation zur Untersttzung von
Anwenderprojektdateien verwendet.

6.6.4.2
Ausgabetyp
Result

Methode WriteToStream
Methodenname
WriteToStream

Parameter
Name

stream

Datentyp
Stream

Parametertyp

Beschreibung

Eingang

Das Ziel fr die serialisierte Ausgabe der


Sammlung.

Mithilfe dieser Methode wird der Inhalt der Sammlung extern gespeichert. Das folgende
Beispiel zeigt die Verwendung dieser Methode.
retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (!retVal.Succeeded)
return;
FileStream f = File.Create("myDataFile.SAT");
retVal = scannedDevices.WriteToStream(f);
f.Close();

Diese Methode serialisiert Versionsinformationen, wodurch die Vorwrtskompatibilitt


gespeicherter Daten untersttzt wird.
Hinweis
Es gibt keine Klassen der SIMATIC Automation Tool API, die Speicher fr vom Benutzer
eingegebene Passwrter bereitstellen. Bei der Serialisierung des Inhalts der
IProfinetDeviceCollection in einer Datendatei werden deshalb Passwortinformationen nicht
bercksichtigt.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

89

SIMATIC Automation Tool API fr .NET Framework


6.6 Klasse IProfinetDeviceCollection

6.6.4.3

Methode ReadFromStream
Mithilfe dieser Methode wird die Sammlung aus einer zuvor erstellten Serialisierungsdatei
wiederhergestellt. Das folgende Beispiel zeigt die Verwendung dieser Methode.

Ausgabetyp
Result

Methodenname

ReadFromStream

Parameter
Name

stream

Datentyp
Stream

Parametertyp

Beschreibung

Eingang

Die Quelle fr die Wiederherstellung einer


serialisierten Sammlung

Mithilfe dieser Methode wird die Sammlung aus einer zuvor erstellten Serialisierungsdatei
wiederhergestellt. Das folgende Beispiel zeigt die Verwendung dieser Methode.
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
FileStream f = File.OpenRead("myDataFile.SAT");
retVal = devices.ReadFromStream(f);
f.Close();

SIMATIC Automation Tool V2.1 Benutzerhandbuch

90

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7

Schnittstelle IProfinetDevice

6.7.1

IProfinetDevice-Eigenschaften
Jedes Element der Sammlung IProfinetDeviceCollection wird durch die Schnittstelle
IProfinetDevice reprsentiert. Diese Schnittstelle ermglicht den Zugriff auf die Daten und
Operationen, die alle direkt mit dem Industrienetzwerk verbundenen Gerte gemeinsam
haben.
Die Schnittstelle IProfinetDevice untersttzt die folgenden Eigenschaften, die Informationen
ber das Netzwerkgert bereitstellen. Alle diese Eigenschaften sind schreibgeschtzt. Damit
sichergestellt ist, dass sie die aktuellen Informationen ausgeben, muss der Code zunchst
die Methode RefreshStatus fr das Gert aufrufen.
Name der Eigenschaft

Ausgabetyp

BackupAllowed

bool

ChangeModeAllowed

bool

Comment

string

Configured

bool

DefaultGateway

uint

DefaultGatewayString

string

Description

string

Failsafe

FeatureSupport

Family

DeviceFamily

ArticleNumber

string

Beschreibung
Die Bestell- oder MLFB-Nummer
Untersttzt das Gert die Sicherungsfunktion?
Untersttzt das Gert den Wechsel der Betriebsart
(RUN/STOP)?
Dem Gert kann ein Kommentar zugeordnet werden. Dieser wird in der Benutzeroberflche des
SIMATIC Automation Tool verwendet und ist fr
API-Operationen nicht relevant.
Zeigt die DNN-Datei fr das Gert an, dass es
konfiguriert wurde?
Die Standard-Gateway-Adresse des Gerts, dargestellt als vorzeichenlose Ganzzahl. In der verschlsselten Gateway-Adresse wird jeweils ein
Byte zur Darstellung der einzelnen Dezimalwerte
in der Adresse verwendet. So ist z. B. der verschlsselte Wert 0xC0A80001 quivalent zu der
hufigeren Zeichenketten-Darstellung als
"192.168.0.1"
Die Standard-Gateway-Adresse des Gertes bei
Darstellung als Zeichenkette im Format
"xx.xx.xx.xx" (z. B. "192.168.0.1")
Eine Beschreibung des Hardware-Elements auf
Basis der Artikelnummer. Hierbei handelt es sich
um dieselbe Beschreibung wie die im TIA Portal
angezeigte.
(z. B. "CPU-1215 DC/DC/DC")
Ist dies laut Artikelnummer ein fehlersicheres Gert?
Zu welcher Gertefamilie gehrt das Gert?
Siehe auch: Enumeration der Gertefamilie (Seite 124)

FirmwareUpdateAllowed

FeatureSupport

Untersttzt dieses Gert Firmwareaktualisierungen?

FirmwareVersion

string

Die aktuelle Firmware-Version des Gerts

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

91

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

Name der Eigenschaft


HardwareID

Ausgabetyp
uint

Beschreibung
Die eindeutige Kennung fr jedes Gert und Modul
in der Station. Sie wird als eindeutige Kennung bei
Ausfhrung einer Operation FirmwareUpdate
verwendet.

IP

uint

IPString

string

MAC

ulong

Die dem Gert zugeordnete eindeutige MACAdresse. In der verschlsselten MAC-Adresse


wird jeweils ein Byte zur Verschlsselung eines
der 6 Oktette verwendet, die fr die Adresse definiert sind. So ist z. B. die verschlsselte MACAdresse 0x112233445566 quivalent zu der blicheren Zeichenketten-Darstellung als
"11:22:33:44:55:66"

MACString

string

MemoryResetAllowed

FeatureSupport

Die dem Gert zugeordnete eindeutige MACAdresse, dargestellt als Zeichenkette im Format
"11:22:33:44:55:66".

Modules

IModuleCollection

Name

string

Der Name des Gerts.

NewFirmwareVersion
NewDefaultGateway
NewIP
NewProfinetName
NewProgramName
NewRestoreName

string
string
string
string
string

Diese Eigenschaften werden in der Benutzeroberflche des SIMATIC Automation Tool verwendet
und sind fr API-Operationen nicht relevant.

ProfinetName

string

Der PROFINET-Name fr das Gert.

ProgramUpdateAllowed

FeatureSupport

Untersttzt das Gert eine Programmaktualisierung?

ResetToFactoryAllowed

FeatureSupport

RestoreAllowed

FeatureSupport

Untersttzt das Gert das Rcksetzen auf die


Werkseinstellungen?

Selected

bool

SerialNumber

string

Slot

uint

Die IP-Adresse des Gerts, dargestellt als vorzeichenlose Ganzzahl. In der verschlsselten IPAdresse wird jeweils ein Byte zur Darstellung der
einzelnen Dezimalwerte in der IP-Adresse verwendet. So ist z. B. der verschlsselte Wert
0xC0A80001 quivalent zu der hufigeren Zeichenketten-Darstellung als "192.168.0.1"
Die IP-Gateway-Adresse des Gertes bei Darstellung als Zeichenkette im Format "xx.xx.xx.xx" (z.
B.

Untersttzt das Gert das Urlschen des Speichers?


Eine Sammlung der in die Station eingesteckten
Module.
Siehe auch Klasse IModuleCollection (Seite 124)

Untersttzt das Gert die Wiederherstellungsfunktionen?


Diese Eigenschaft wird in der Benutzeroberflche
des SIMATIC Automation Tool verwendet und ist
fr API-Operationen nicht relevant.
Die eindeutige Seriennummer fr das Gert
Die Steckplatznummer fr das Hardware-Element.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

92

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

Name der Eigenschaft


SlotName

Ausgabetyp
string

Beschreibung
Diese Eigenschaft wird in der Benutzeroberflche
des SIMATIC Automation Tool verwendet und ist
fr API-Operationen nicht relevant.

StationNumber

uint

SubSlot

uint

Die Subslot-Nummer des Gerts Dieser Wert wird


fr steckbare Submodule wie das SB-1200 (Signalboard) verwendet.

Supported

bool

SubnetMask

uint

Wird das erkannte Netzwerkgert von aktuellen


Operationen der SIMATIC Automation Tool API
untersttzt?

SubnetMaskString

string

Die Stationsnummer des Gerts

Die Subnetzmaske des Gerts, dargestellt als


vorzeichenlose Ganzzahl. In der verschlsselten
Subnetzmaske wird jeweils ein Byte zur Darstellung der einzelnen Dezimalwerte in der Adresse
verwendet. So ist z. B. der verschlsselte Wert
0xFFFFFF00 quivalent zu der blicheren Zeichenketten-Darstellung als "255.255.255.0"
Die Standard-Gateway-Adresse des Gerts, dargestellt als Zeichenkette im Format "xx.xx.xx.xx"
(z. B. "192.168.0.1)

Siehe auch
Klasse IModuleCollection (Seite 104)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

93

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.2

IProfinetDevice-Methoden

6.7.2.1

Methode RefreshStatus

Ausgabetyp

Methodenname

Name

Datentyp

Result

RefreshStatus

Parameter
password

EncryptedString

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Wenn die Sammlung IProfinetDeviceCollection durch Aufrufen der Methode


ScanNetworkDevices erstellt wird, wird ber die einzelnen Gerte nur eine minimale
Informationsmenge erfasst. Um alle verfgbaren Informationen ber das Gert zu erfassen,
muss die Methode RefreshStatus aufgerufen werden. Diese Methode stellt eine Verbindung
zum Gert her, fragt verschiedene Informationen ab und trennt die Verbindung dann wieder.
Mit dem folgenden Code wird RefreshStatus fr jedes Gert im Netzwerk aufgerufen.
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in scannedDevices)
{
Result retVal = networkDevice.RefreshStatus(new EncryptedString(""));
if (retVal.Succeeded)
{
//-------------------------------------------------// Operation erfolgreich, die Daten sind vertrauenswrdig.
//-------------------------------------------------}
}
}

Die Methode RefreshStatus stellt eine Verbindung zum Gert her, um Informationen
auszulesen. Gegen einen solchen Zugriff ist das Gert unter Umstnden passwortgeschtzt.
Deshalb erfordert diese Methode (wie alle anderen Methoden, die eine interne
Gerteverbindung herstellen) einen Passwort-Parameter. Im obigen Beispiel wird ein leeres
Passwort an die Methode bergeben. Dies wre nur bei einem Gert ohne Passwortschutz
sinnvoll. Das Beispiel zeigt die Klasse EncryptedString. Diese Klasse wird von der API zur
korrekten Verschlsselung eines Klartext-Passworts bereitgestellt, mit dem anschlieend die
Verbindung zum Gert legitimiert wird.
Siehe auch Klasse EncryptedString (Seite 77)

SIMATIC Automation Tool V2.1 Benutzerhandbuch

94

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.2.2

Methode FirmwareUpdate
Ausgabetyp
Result

Methodenname

FirmwareUpdate

Parameter
Name

Datentyp

password

EncryptedString

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

strFile

string

Eingang

hardwareID

uint

Ein vollstndig qualifizierter Pfad und


Dateiname fr die Aktualisierungsdatei.

Eingang

Die Hardwarekennung des Moduls

bUpdateSameVersion

Bool

Eingang

Wenn diese Methode wahr ist, setzt sie


die Aktualisierung fort, auch wenn die
Aktualisierungsdatei anzeigt, dass sie die
gleiche Version aufweist wie die aktuelle
Firmware-Version des Moduls.

Mit dieser Methode wird die Firmware-Version des angegebenen Hardware-Elements


(hardwareID) auf dem Gert aktualisiert. Die Hardwarekennung (hardwareID) gibt entweder
das Gert selbst oder ein Modul auf demselben Baugruppentrger an.
Nicht alle Gerte untersttzen die Funktion zur Firmware-Aktualisierung. Ob das aktuelle
Gert diese Funktion untersttzt, kann mithilfe der Eigenschaft FirmwareUpdateAllowed
berprft werden.
Das folgende Beispiel zeigt die Suche nach einem Gert an einer bestimmten IP-Adresse
und die Aktualisierung der Firmware in diesem Gert.
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
string updateFile = @"c:\myUpdates\6ES7 221-1BF32-0XB0 V02.00.00.upd";
if (!retVal.Succeeded)
return;
IProfinetDevice dev = scannedDevices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
Result retVal = dev.FirmwareUpdate(new EncryptedString(""),
updateFile, dev.ID, true);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

95

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice
Mithilfe der Methode FirmwareUpdate kann auch die Firmware eines Moduls an einer
Zentralstation aktualisiert werden. Der folgende Code zeigt die Suche nach einer CPU an
einer bestimmten Adresse und die anschlieende Prfung der Module an dieser CPU auf
eine bestimmte Artikelnummer. Im Ergebnis wird die Firmware der Module aktualisiert, die
den Suchkriterien entsprechen.
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
string targetModule = @"6ES7 221-1BF32-0XB0";
string updateFile = @"c:\myUpdates\6ES7 221-1BF32-0XB0 V02.00.00.upd";
if (!retVal.Succeeded)
return;
IProfinetDevice dev = scannedDevices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
retVal = dev.RefreshStatus(new EncryptedString(""));
if (!retVal.Succeeded)
return;
//------------------------------// Die Module an der CPU werden gesucht.
//------------------------------IModuleCollection mods = dev.Modules;

foreach (IModule mod in mods)


{
if (mod.ArticleNumber == targetModule)
{
//--------------------------------------// Die Firmware der bereinstimmenden Module wird aktualisiert)
//--------------------------------------dev.FirmwareUpdate(new EncryptedString(""),
updateFile, mod.ID, true);
}
}

Beachten Sie, dass die Methode FirmwareUpdate weiterhin fr die CPU aufgerufen wird. Die
an die Methode bergebene Hardware-Kennung (hardwareID) gibt jedoch an, welches
Modul aktualisiert werden soll.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

96

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.2.3

Methode FlashLED
Ausgabetyp
Result

Methodenname
FlashLED

Diese Methode bewirkt das Blinken der LED bei einem bestimmten Netzwerkgert. Die
blinkende LED hilft, den physischen Standort des Gerts zu erkennen.
Das Beispiel zeigt den Code, durch den die LED an dem Gert mit der IP-Adresse
192.168.0.1 blinkt.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
//-----------------------------------------------// Suche nach dem Gert unter der IP-Adresse und Auslsen des Blinkens der LED
//-----------------------------------------------IProfinetDevice dev = scannedDevices.FindDeviceByIP(targetIPAddress);

if (dev != null)
{
retVal = dev.FlashLED();
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

97

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.2.4

Rcksetzmethode
Ausgabetyp
Result

Methodenname
Reset

Diese Methode dient zum Rcksetzen eines Gerts auf die Werkseinstellungen.
Das folgende Beispiel zeigt den Aufruf der Methode Reset fr ein Gert an einer bestimmten
IP-Adresse.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
//-----------------------------------------------// Suche nach dem Gert unter der IP-Adresse und Auslsen des Blinkens der LED
//-----------------------------------------------IProfinetDevice dev = scannedDevices.FindDeviceByIP(targetIPAddress);

if (dev != null)
{
retVal = dev.Reset();
}

Hinweis
Diese Methode kann nicht zum Rcksetzen einer CPU verwendet werden. Die Schnittstelle
ICPU untersttzt eine Methode ResetToFactory, die speziell fr CPUs vorgesehen ist.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

98

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.2.5

Methode SetIP

Ausgabetyp

Methodenname

Result

SetIP

Parameter
Name

Datentyp

nIP

uint

nSubnet

uint

nGateway

uint

Parametertyp

Beschreibung

Eingang

Neue verschlsselte IP-Adresse

Eingang

Neue verschlsselte Subnetz-Adresse

Eingang

Neue verschlsselte Gateway-Adresse

Diese Methode wird zum Einstellen oder ndern der IP-Adresse eines Gerts verwendet.
Damit diese Operation erfolgreich ausgefhrt wird, muss fr den Gerteport die Option Set
IP address on the device konfiguriert sein. Je nach verwendeter Version des TIA Portals
kann diese Option auch "SET IP address using a different method lauten.
Das folgende Beispiel zeigt die Suche nach einem Gert an einer angegebenen MACAdresse und das Einstellen der IP-Adresse des Gerts.
ulong targetMACAddress = 0x112233445566; // 11:22:33:44:55:66
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
//-----------------------------------------------// Suche nach dem Gert an dieser MAC-Adresse und Einstellen der IP-Adresse
//-----------------------------------------------IProfinetDevice dev = scannedDevices.FindDeviceByMAC(targetMAC);

if (dev != null)
{
retVal = dev.SetIP(0xC0A80001, 0xFFFFFF00, 0x0);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

99

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

Hinweis
Die Methode SetIP erwartet, dass die Adressen in verschlsseltem Format vorliegen (wie
oben gezeigt). Die Adressen knnen mit folgendem C#-Code von einem ZeichenkettenFormat in eine verschlsselte vorzeichenlose Ganzzahl (uint) umgewandelt werden:
string userEnteredAddress = @"192.168.0.1"; // Beispiel:
//------------------------------// Zeichenketten-Adressen in uint umwandeln
//------------------------------System.Net.IPAddress ip = IPAddress.Parse(userEnteredAddress);
byte[] bytes = ip.GetAddressBytes();
Array.Reverse(bytes);
uint encodedIp = BitConverter.ToUInt32(bytes, 0); // jetzt kann encodedIP verwendet
werden

6.7.2.6

Methode SetProfinetName

Ausgabetyp

Methodenname

Result

SetProfinetName

Parameter
Name

Datentyp

Parametertyp

Beschreibung

strName

string

Eingang

Der neue Name fr die PROFINETStation

Diese Methode wird zum Einstellen oder ndern des Namens der PROFINET-Station des
Gerts verwendet. Damit diese Operation erfolgreich ausgefhrt wird, muss fr den
Gerteport die Option Set IP PROFINET device name konfiguriert sein.
ulong targetMACAddress = 0x112233445566; // 11:22:33:44:55:66
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
//--------------------------------------------------------// Suche nach dem Gert an dieser MAC-Adresse und Einstellen des PROFINET-Namens
//--------------------------------------------------------IProfinetDevice dev = scannedDevices.FindDeviceByMAC(targetMAC);

if (dev != null)
{
retVal = dev.SetProfinetName("new name");
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

100

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.3

IProfinetDevice-Ereignisse

6.7.3.1

Ereignis DataChanged
Das Ereignis DataChanged wird von der Schnittstelle IProfinetDevice untersttzt.
Mithilfe dieses Ereignisses kann das Programm berwachen, ob bei einem gegebenen
Gert im Netz nderungen auftreten, die durch andere API-bedingte Operationen verursacht
wurden. Beispielsweise kann das Programm einen Verweis auf ein bestimmtes
IProfinetDevice enthalten, aufgrund dessen es das Gert auf bestimmte nderungen
abhren kann.
Im folgenden Beispiel nimmt der Code eine Verknpfung mit dem Ereignis DataChanged fr
jedes Gert im Netzwerk vor.
private void AttachEvents(IProfinetDeviceCollection devices)
{
foreach (IProfinetDevice dev in devices)
{
dev.DataChanged += new DataChangedEventHandler(Dev_DataChanged);
}
}
private void Dev_DataChanged(object sender, DataChangedEventArgs e)
{
if (e.Type == DataChangedType.OperatingState)
{
}
}

Wenn nun eine Aktion der API einen Betriebsartenwechsel des Gerts hervorruft, wird die
Methode Dev_DataChanged aufgerufen.
Hinweis
Hierdurch wird nicht das Netzwerk im Betrieb aktiv berwacht, sondern die Eigenschaften
von IProfinetDevice werden berwacht. Um das Ereignis auszulsen, muss sich der
Zustand des Objekts ndern.
Klasse DataChangedEventArgs
Der Handler fr das Ereignis DataChanged wird an ein DataChangedEventArgs-Objekt
bergeben. Wie im obigen Beispiel gezeigt, besitzt diese Klasse eine einzige Eigenschaft
(Typ) des Typs DataChangedType.
Siehe auch DataChangedType-Enumeration (Seite 124)

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

101

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice

6.7.3.2

Ereignis ProgressChanged
Das Ereignis ProgressChanged wird von der Schnittstelle IProfinetDevice untersttzt.
Das Ereignis ermglicht dem Programm die berwachung von Methoden, die lange Zeit in
Anspruch nehmen. Ein Beispiel fr eine solche Methode ist FirmwareUpdate.
Damit das Ereignis genutzt werden kann, wird ein Ereignis-Handler an das Ereignis
angehngt. Der Ereignis-Handler wird automatisch aufgerufen, wenn es zu einer nderung
im Fortschritt einer Operation kommt.
Das folgende Beispiel demonstriert den Einsatz des Handlers. In diesem Beispiel wird eine
Methode gezeigt, welche die Firmware fr ein Gert im Netzwerk aktualisiert. Diese
Operation kann erhebliche Zeit in Anspruch nehmen. Um den Fortschritt der Aktion
berwachen zu knnen, wird ein Ereignis-Handler definiert und an das Ereignis
ProgressChanged angehngt. Nach Beendigung der Firmware-Aktualisierung wird der
Ereignis-Handler wieder vom Ereignis entfernt.
private void UpdateCpuAtAddress(IProfinetDeviceCollection devices,
uint targetIPAddress, string updateFile)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
dev.ProgressChanged += new
ProgressChangedEventHandler(Dev_ProgressChanged);
dev.FirmwareUpdate(new EncryptedString(""), updateFile, dev.ID, true);

}
{

dev.ProgressChanged -= new
ProgressChangedEventHandler(Dev_ProgressChanged);
}
private void Dev_ProgressChanged(object sender, ProgressChangedEventArgs e)
IProfinetDevice device = sender as IProfinetDevice;
double percent = 0;
if (device != null)
{
if (e.Count != 0)
{
percent = (double)e.Index / (double)e.Count;
string sPercent = e.Action.ToString() + " -> " +
"Index = " +
e.Index.ToString() +
" Count = " +
e.Count.ToString() +
" progress " +
(percent * 100).ToString("0.##") + "%";
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

102

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.7 Schnittstelle IProfinetDevice
Klasse ProgressChangedEventArgs
Der Handler fr das Ereignis ProgressChanged wird an ein ProgressChangedEventArgss-Objekt
bergeben. Dieses Objekt hat folgende Eigenschaften:
Name der Eigenschaft

Ausgabetyp

Beschreibung

Action

ProgressAction

Eine Beschreibung der aktuellen Aktion:

Cancel

bool

Wurde die Aktion abgebrochen?

Count

int

ID

uint

Die Gesamtmenge der zu bertragenden Daten

Index

int

Siehe auch ProgressAction-Enumeration (Seite 127)

Die Hardwarekennung
Die aktuelle bertragene Datenmenge

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

103

SIMATIC Automation Tool API fr .NET Framework


6.8 Klasse IModuleCollection und Moduleigenschaften

6.8

Klasse IModuleCollection und Moduleigenschaften

6.8.1

Klasse IModuleCollection
Die Schnittstelle IProfinetDevice stellt Informationen ber ein beliebiges in die Station
eingestecktes Modul bereit (Signalmodule, Signalboards, CMs, CPs usw.). Die Eigenschaft
Modules gibt eine Sammlung dieser Module aus.
Der folgende Code zeigt den Zugriff auf diese Informationen mithilfe eines (in einem frheren
Beispiel erstellten) IProfinetDevice.
//-------------------------------------------------------// Um sicherzustellen, dass die Informationen aktuell und vollstndig sind,
// muss erst RefreshStatus()aufgerufen werden
//-------------------------------------------------------Result retVal = networkDevice.RefreshStatus(new EncryptedString(""));
if (retVal.Succeeded)
{
//-------------------------------------------------------// Von der Eigenschaft Modules wird eine Sammlung IModule ausgegeben
/-------------------------------------------------------IModuleCollection modules = networkDevice.Modules;
foreach (IModule mod in modules)
{
//------------------------------------------------------// Abrufen der einzelnen Artikelnummern fr jedes Modul an der Zentralstation
//------------------------------------------------------string displayArticleNum = mod.ArticleNumber;
}
}

6.8.2

Schnittstelle IModule
Jedes Modul an der Station wird als eine Schnittstelle IModule reprsentiert. Diese
Schnittstelle stellt eine Teilmenge der fr ein Gert verfgbaren Eigenschaften bereit.
Die Schnittstelle IModule stellt keine Methoden zur Verfgung. Alle an einem Modul
durchgefhrten Operationen mssen am Gert ausgelst werden. Die Schnittstelle IModule
untersttzt die folgenden Eigenschaften:

Name der Eigenschaft

Ausgabetyp

Comment

string

ArticleNumber

string

Beschreibung
Die Bestell- oder MLFB-Nummer
Hiermit kann der Anwender dem Gert einen Kommentar zuordnen. Dieser wird in der Benutzeroberflche des SIMATIC Automation Tool verwendet
und ist fr API-Operationen nicht relevant.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

104

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

Name der Eigenschaft


Configured

Ausgabetyp
bool

Beschreibung
Zeigt die DNN-Datei fr das Gert an, dass es konfiguriert wurde?

Description

string

Failsafe

FeatureSupport

FirmwareUpdateAllowed

FeatureSupport

Untersttzt dieses Gert FirmwareAktualisierungen?

FirmwareVersion

string

HardwareID

uint

Die aktuelle Firmware-Version des Gerts

Name

string

NewFirmwareVersion

string

Selected

bool

SerialNumber

string

Die eindeutige Seriennummer fr das Gert

Slot

uint

SlotName

string

Die Steckplatznummer fr das Hardware-Element

StationNumber

uint

SubSlot

uint

Supported

bool

Eine Beschreibung des Hardware-Elements auf


Basis der Artikelnummer. Hierbei handelt es sich
um dieselbe Beschreibung, die der Anwender im
TIA Portal sieht.
(z. B. "CPU-1215 DC/DC/DC")
Ist dies laut Artikelnummer (ArticleNumber) ein
fehlersicheres Gert?

Die eindeutige Kennung fr jedes Gert und Modul


in der Station. Sie wird als eindeutige Kennung bei
Ausfhrung einer Operation FirmwareUpdate verwendet.
Der Name des Gerts
Diese Eigenschaft wird in der Benutzeroberflche
des SIMATIC Automation Tool verwendet. Sie ist fr
API-Operationen nicht relevant.
Diese Eigenschaft wird in der Benutzeroberflche
des SIMATIC Automation Tool verwendet. Sie ist fr
API-Operationen nicht relevant.

Diese Eigenschaft wird in der Benutzeroberflche


des SIMATIC Automation Tool verwendet und ist fr
API-Operationen nicht relevant.
Die Stationsnummer des Gerts
Die Subslot-Nummer des Gerts. Diese ist fr
steckbare Submodule wie das SB-1200 (Signalboard) relevant.
Wird das erkannte Netzwerkgert von aktuellen
Operationen des SIMATIC Automation Tool untersttzt?

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

105

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9

Schnittstelle ICPU

6.9.1

Dient zur Identifikation von CPU-Gerten in einer IProfinetDeviceCollection


Wie bereits errtert, wird die Methode ScanNetworkDevices aufgerufen, um eine Sammlung
IProfinetDeviceCollection zu generieren. Diese Sammlung enthlt ein Element fr jedes
erreichbare Gert im Industrienetzwerk. Zu diesen Gerten knnen u. a. CPUs und
dezentrale Peripheriestationen gehren.
Die Schnittstelle IProfinetDevice stellt Eigenschaften und Methoden zur Verfgung, die auf
beide Kategorien von Gerten anwendbar sind. Es gibt jedoch bestimmte Eigenschaften und
Methoden, die spezifisch fr ein CPU-Gert gelten. Der Zugriff auf diese Eigenschaften und
Methoden erfolgt ber die Schnittstelle ICPU.
Um festzustellen, ob eine bestimmte Schnittstelle IProfinetDevice wirklich ein CPU-Gert
reprsentiert, senden Sie sie einfach an eine Schnittstelle ICPU. Wenn die bertragung
erfolgreich ist, dann handelt es sich bei dem Netzwerkgert um eine CPU und die
Schnittstelle ICPU kann verwendet werden. Das folgende Beispiel illustriert dies:
IProfinetDeviceCollection scannedDevices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in scannedDevices)
{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu != null)
{
//-------------------------------------------// Das Gert ist eine CPU.

// Lassen Sie die Interaktion mit dem Gert ber diese Schnittstelle ablaufen.
//--------------------------------------------

Hinweis
Die Schnittstelle ICPU erbt ihre Einstellungen vom IProfinetDevice. Deshalb werden alle vom
IProfinetDevice untersttzten Eigenschaften und Methoden auch von der Schnittstelle ICPU
untersttzt. Der folgende Abschnitt behandelt daher nur Eigenschaften/Methoden, die
spezifisch fr die Schnittstelle ICPU sind.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

106

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.2

Eigenschaften von ICPU


Die Schnittstelle ICPU erweitert IProfinetDevice um die folgenden Eigenschaften. Diese
Eigenschaften sind schreibgeschtzt. Damit sichergestellt ist, dass die Eigenschaften die
aktuellen Informationen ausgeben, muss der Code zunchst die Methode RefreshStatus
aufrufen.

Name der Eigenschaft

Ausgabetyp

Beschreibung

RemoteInterfaces

List<IRemoteInterface>

Eine Liste der Remote-Peripherieschnittstellen,


die fr die CPU konfiguriert sind.

Siehe auch Eigenschaft RemoteInterfaces (Seite 119)

6.9.3

ICPU-Methoden

6.9.3.1

Geschtzte CPUs und Passwrter


Die folgenden Methoden werden fr die Schnittstelle ICPU bereitgestellt. Die meisten
Aktionen in Bezug auf die Schnittstelle ICPU erfordern eine legitimierte Verbindung mit der
CPU. Hierfr kann ein Passwort bentigt werden. Deshalb brauchen die meisten Methoden
fr die Schnittstelle ICPU einen Passwort-Parameter.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

107

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.2

Sicherungsmethode

Ausgabetyp

Methodenname

Result

Backup

Parameter
Name

Datentyp

Password

EncryptedString

strFile

string

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Ein vollstndig qualifizierter Pfad und


Dateiname fr die Speicherung der Backup-Datei.

Diese Methode dient zur Sicherung der Daten in einer CPU. Nicht alle CPUs untersttzten
die Funktion zum Sichern/Wiederherstellen. Ob die aktuelle CPU diese Funktion untersttzt,
kann mithilfe der Eigenschaft BackupAllowed berprft werden.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt. Wird diese CPU gefunden, so
wird geprft, ob sie die Sicherungsfunktion untersttzt. Falls ja, wird die Methode Backup
aufgerufen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
string bkFile = @"C:\MyCPUBackupFile.s7pbkp";
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in devices)
{
ICPU devAsCpu = dev as ICPU;

if ((devAsCpu != null) &&


(devAsCpu.IP == targetIPAddress) &&
(devAsCpu.BackupAllowed == FeatureSupport.BackupAllowed)
)
{
retVal = devAsCpu.Backup(new EncryptedString(""), bkFile);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

108

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.3

Methode GetCurrentDateTime

Ausgabetyp

Methodenname

Result

GetCurrentDateTime

Parameter
Name

Datentyp

Password

EncryptedString

DateTime

System.DateTime

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Ausgang

Von der CPU ausgegebenes Datum und


ausgegebene Uhrzeit

Mit dieser Methode wird der aktuelle Zeitstempel fr die CPU abgerufen.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
retVal = myNetwork.ScanNetworkDevices(out devices);
if (!retVal.Succeeded)
return;
foreach (IProfinetDevice dev in devices)
{
ICPU devAsCpu = dev as ICPU;
if ((devAsCpu != null) && (devAsCpu.IP == targetIPAddress))
{
DateTime curTime = new DateTime();

retVal = devAsCpu.GetCurrentDateTime(new EncryptedString(""),


out curTime);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

109

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.4

Methode GetDiagnosticsBuffer

Ausgabetyp

Methodenname

Result

GetDiagnosticsBuffer

Parameter
Name

Datentyp

password

EncryptedString

aDiagnosticsItems

List<DiagnosticsItem>

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Ausgang

Eine Sammlung von DiagnoseElementen. Dabei steht jedes Element


der Sammlung fr einen Eintrag im Diagnosepuffer.

Mit dieser Methode werden die aktuellen Diagnoseeintrge aus der CPU ausgelesen. Jeder
Eintrag wird als ein Diagnose-Element DiagnosticsItem reprsentiert.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt. Wird diese gefunden, so
werden die Diagnoseinformationen aus der CPU ausgelesen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
List<DiagnosticsItem> aLogs = new List<DiagnosticsItem>();
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in devices)
{
ICPU devAsCpu = dev as ICPU;
if ((devAsCpu != null) && (devAsCpu.IP == targetIPAddress))
{
retVal = devAsCpu.GetDiagnosticsBuffer(new EncryptedString(""),
out aLogs);
if (retVal.Succeeded)
{
for (int idxLog = 0; idxLog < aLogs.Count; idxLog++)
{
string descr = aLogs[idxLog].Description1;

SIMATIC Automation Tool V2.1 Benutzerhandbuch

110

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU
Klasse DiagnosticsItem
Die Methode GetDiagnosticsBuffer gibt eine Sammlung von DiagnosticsItem-Objekten aus.
Diese Klasse definiert die folgenden Member:
Name des Members
TimeStamp

6.9.3.5

Datentyp

System.DateTime

Beschreibung
Uhrzeit, zu der das Diagnose-Ereignis protokolliert wurde.

State

Byte

Eingehend/abgehend

Description1

String

Description2

String

Titel
Detail

Methode GetOperatingState

Ausgabetyp

Methodenname

OperatingState

GetOperatingState

Diese Methode gibt einen OperatingState (Betriebszustand) aus.


Siehe auch OperatingState-Enumeration (Seite 126)
Hinweis
Im Unterschied zu den meisten anderen Aktionen in Bezug auf die Schnittstelle ICPU
erfordert GetOperatingState keine legitimierte Verbindung zur CPU. Es wird daher kein
Passwort bentigt.
Im folgenden Beispiel wird der aktuelle Betriebszustand fr alle CPUs im Industrienetzwerk
abgefragt. Befindet sich eine CPU nicht in RUN, wird ein Fehler angezeigt.
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{

foreach (IProfinetDevice dev in devices)


{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu != null)
{
if (devAsCpu.GetOperatingState() != OperatingState.Run)
{
// DisplayError!

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

111

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.6

Methode MemoryReset

Ausgabetyp

Methodenname

Result

MemoryReset

Parameter
Name

Datentyp

password

EncryptedString

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Diese Methode fhrt ein Urlschen des Speichers auf der CPU durch.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt, und wird MemoryReset fr diese
CPU aufgerufen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;

if (devAsCpu != null)
{
retVal = devAsCpu.MemoryReset(new EncryptedString(""));
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

112

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.7

Methode ProgramUpdate

Ausgabetyp

Methodenname

Result

ProgramUpdate

Parameter
Name

Datentyp

password

EncryptedString

strPath

string

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Ein vollstndig qualifizierter Pfad zu dem


Ordner, der den Inhalt der Programmkarte
enthlt.

Diese Methode fhrt eine Programmaktualisierung auf der CPU durch. Der Parameter
strPath gibt einen Ordner an, der das zu ladende Programm enthlt. Um erfolgreich
aktualisiert zu werden, muss das Programm mit dem TIA Portal generiert und im Format
program memory card gespeichert worden sein.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt, und wird das Programm fr
diese CPU aktualisiert.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu != null)
{
retVal = devAsCpu.ProgramUpdate(new EncryptedString(""),
@"c:\myFolder\ProgramUpdate");

Hinweis
Die Methode ProgramUpdate ist bei einer fehlersicheren S7-CPU nicht zulssig. Bei einer
fehlersicheren CPU wird diese Operation durch die SIMATIC Automation Tool API blockiert.
Wenn die Software feststellt, dass diese Methode fr eine fehlersichere CPU aufgerufen
wurde, wird ein spezifischer Fehler (ErrorCode.FailsafeAccessNotAllowed) ausgegeben.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

113

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.8

Methode ResetToFactory

Ausgabetyp

Methodenname

Result

ResetToFactory

Parameter
Name

Datentyp

password

EncryptedString

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Diese Methode setzt eine CPU auf die Werkseinstellungen zurck.


Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt, und wird die Methode
ResetToFactory aufgerufen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu != null)
{
retVal = devAsCpu.ResetToFactory(new EncryptedString(""));

Hinweis
Die Methode ResetToFactory ist bei einer fehlersicheren S7-CPU nicht zulssig. Bei einer
fehlersicheren CPU wird diese Operation durch die SIMATIC Automation Tool API blockiert.
Wenn die Software feststellt, dass diese Methode fr eine fehlersichere CPU aufgerufen
wurde, wird ein spezifischer Fehler (ErrorCode.FailsafeAccessNotAllowed) ausgegeben.

SIMATIC Automation Tool V2.1 Benutzerhandbuch

114

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.9

Methode Restore

Ausgabetyp

Methodenname

Result

Restore

Parameter
Name

Datentyp

password

EncryptedString

strFile

string

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Ein vollstndig qualifizierter Pfad zu dem


Ordner, der den Inhalt der Programmkarte
enthlt.

Mithilfe dieser Methode werden die Daten einer frheren Sicherung der CPU
wiederhergestellt. Nicht alle CPUs untersttzen die Funktion zum Sichern/Wiederherstellen.
Ob die aktuelle CPU diese Funktion untersttzt, kann mithilfe der Eigenschaft
RestoreAllowed berprft werden.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt. Wird diese CPU gefunden, so
wird geprft, ob sie die Wiederherstellungsfunktion untersttzt. Falls ja, wird die Methode
Restore aufgerufen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
string bkFile = @"C:\MyCPUBackupFile.s7pbkp";
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;

if ((devAsCpu != null) &&


(devAsCpu.RestoreAllowed == FeatureSupport.RestoreAllowed)
)
{
retVal = devAsCpu.Restore(new EncryptedString(""), bkFile);
}

Hinweis
Die Methode Restore ist bei einer fehlersicheren S7-CPU nicht zulssig. Bei einer
fehlersicheren CPU wird diese Operation durch die SIMATIC Automation Tool API blockiert.
Wenn die Software feststellt, dass diese Methode fr eine fehlersichere CPU aufgerufen
wurde, wird ein spezifischer Fehler (ErrorCode.FailsafeAccessNotAllowed) ausgegeben.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

115

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.10

Methode SetOperatingState

Ausgabetyp

Methodenname

Result

SetOperatingState

Parameter
Name

Datentyp

password

EncryptedString

nRequestState

OperatingStateREQ

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Der neue Betriebszustand

Diese Methode dient zum Wechseln des Betriebszustands einer CPU.


Nicht alle CPUs untersttzen diese Funktion. Ob die aktuelle CPU diese Funktion
untersttzt, kann mithilfe der Eigenschaft ChangeModeAllowed berprft werden.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt. Wird diese CPU gefunden, so
wird geprft, ob sie die Funktion fr den Betriebszustandswechsel untersttzt. Falls ja, wird
die CPU in RUN versetzt.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;

if ((devAsCpu != null) &&


(devAsCpu.ChangeModeAllowed == true)
)

retVal = devAsCpu.SetOperatingState(new EncryptedString(""),


OperatingStateREQ.Run);

SIMATIC Automation Tool V2.1 Benutzerhandbuch

116

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.11

Methode SetCurrentDateTime

Ausgabetyp

Methodenname

Result

SetCurrentDateTime

Parameter
Name

Datentyp

password

EncryptedString

time

System.DateTime

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Neuer Wert fr die aktuelle Uhrzeit der


CPU.

Mit dieser Methode wird die aktuelle Zeit fr die CPU eingestellt. Durch diese Aktion werden
die konfigurierten Zeitumwandlungsregeln nicht gendert. Der angegebene Wert fr
DateTime basiert deshalb auf der UTC und nicht auf der Ortszeit.
Im folgenden Beispiel wird das gesamte Industrienetzwerk erfasst und die Uhrzeit fr jedes
CPU-Gert auf die aktuelle Uhrzeit des PG/PC eingestellt.
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in devices)
{
ICPU devAsCpu = dev as ICPU;

if (devAsCpu != null)
{
retVal = devAsCpu.SetCurrentDateTime(new EncryptedString(""),
DateTime.UtcNow);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

117

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.3.12

Methode UploadServiceData

Ausgabetyp

Methodenname

Result

UploadServiceData

Parameter
Name

Datentyp

password

EncryptedString

strPath

string

Parametertyp

Beschreibung

Eingang

Diese Methode ffnet eine legitimierte


Verbindung zum Gert. Daher kann ein
Passwort erforderlich sein.

Eingang

Ein vollstndig qualifizierter Pfad zu dem


Ordner, der den Inhalt der Programmkarte
enthlt.

Mithilfe dieser Methode knnen die Servicedaten aus einer defekten CPU geladen werden.
Im folgenden Beispiel wird die Sammlung IProfinetDeviceCollection daraufhin durchsucht,
ob sie eine CPU unter einer bestimmten IP-Adresse enthlt. Anschlieend wird der
OperatingState (Betriebszustand) der CPU geprft. Wenn die CPU defekt ist, werden die
Servicedaten aus der CPU geladen.
uint targetIPAddress = 0xC0A80001; // 192.168.0.1
string strDiagFolder = @"c:\Diagnostics";
IProfinetDeviceCollection devices = new IProfinetDeviceCollection();
Result retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
IProfinetDevice dev = devices.FindDeviceByIP(targetIPAddress);
if (dev != null)
{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu != null)
{
devAsCpu.RefreshStatus(new EncryptedString(""));

if (devAsCpu.GetOperatingState() == OperatingState.Defective)
{
retVal = devAsCpu.UploadServiceData(new EncryptedString(""),
strDiagFolder);
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

118

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.4

Eigenschaften RemoteInterfaces

6.9.4.1

Dezentrale Peripheriemodule
Jede CPU kann unter Umstnden mehrere dezentrale Peripheriemodule untersttzen.
Informationen ber die an diese Remote-Schnittstellen angehngten Gerte sind ber die
Eigenschaft RemoteInterfaces abrufbar.
Fr den Zugriff auf Informationen ber die dezentrale Peripherie muss zunchst die Methode
RefreshStatus in Bezug auf die CPU ausgefhrt werden. Hierdurch wird eine legitimierte
Verbindung zur CPU geffnet, werden die relevanten Informationen ausgelesen und wird die
Verbindung wieder geschlossen.
Das folgende Beispiel zeigt den Zugriff auf diese Informationen fr alle CPUs im Netzwerk.
retVal = myNetwork.ScanNetworkDevices(out devices);
if (retVal.Succeeded)
{
foreach (IProfinetDevice dev in devices)
{
ICPU devAsCpu = dev as ICPU;
//---------------------------------------------------------// Ein Aufruf von RefreshStatus() ist notwendig, um Informationen ber dezentrale
// Netzwerke zu erfassen
//---------------------------------------------------------retVal = devAsCpu.RefreshStatus(new EncryptedString(""));
if (!retVal.Succeeded)
return;
List<IRemoteInterface> decentalNets = devAsCpu.RemoteInterfaces;

foreach (IRemoteInterface net in decentalNets)


{
//----------------------------// Die Remote-Schnittstelle wird berprft
//----------------------------}

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

119

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU

6.9.4.2

IRemoteInterface-Eigenschaften
Die Schnittstelle IRemoteInterface untersttzt die folgenden Eigenschaften. Diese
Eigenschaften sind schreibgeschtzt.
Name der Eigenschaft
Devices

InterfaceType

Name

Ausgabetyp

Beschreibung

List<IBaseDevice>

RemoteInterfaceType

string

Eine Liste der dezentralen Peripheriestationen, die mit dieser


Remote-Schnittstelle verbunden
sind
Das Kommunikationsprotokoll
fr diese Remote-Schnittstelle
Siehe auch RemoteInterfaceType-Enumeration (Seite 127)
Der konfigurierte Name fr die
Remote-Schnittstelle.

Die Eigenschaft Devices kann dazu verwendet werden, Operationen mit Wirkung auf ein
gesamtes dezentrales Netzwerk auszufhren. Jedes Gert in einem dezentralen Netzwerk
wird durch eine Schnittstelle IBaseDevice reprsentiert. Dieser Schnittstelle ist eine
Teilmenge der Eigenschaften zugeordnet, die fr ein IProfinetDevice verfgbar sind. Die
Schnittstelle bietet den begrenzten Funktionsumfang, der fr diese Gerte in der SIMATIC
Automation Tool API vorgesehen ist.
Die folgenden Eigenschaften sind an der Schnittstelle IBaseDevice verfgbar:
Name der Eigenschaft

Ausgabetyp

Beschreibung

ArticleNumber

string

BackupAllowed

FeatureSupport

Die Bestell- oder MLFBNummer

ChangeModeAllowed

FeatureSupport

Comment

string

Configured

bool

Description

string

Failsafe

FeatureSupport

Untersttzt das Gert die Sicherungsfunktion?


Untersttzt das Gert den
Wechsel der Betriebsart
(RUN/STOP)?
Hiermit kann der Anwender dem
Gert einen Kommentar zuordnen. Dieser wird in der Benutzeroberflche des SIMATIC
Automation Tool verwendet und
ist fr API-Operationen nicht
relevant.
Zeigt die DNN-Datei fr das
Gert an, dass es konfiguriert
wurde?
Eine Beschreibung des Hardware-Elements auf Basis der
Artikelnummer. Hierbei handelt
es sich um dieselbe Beschreibung, die der Anwender im TIA
Portal sieht.
(z. B. "CPU-1215 DC/DC/DC")
Ist dies laut Artikelnummer ein
fehlersicheres Gert?
SIMATIC Automation Tool V2.1 Benutzerhandbuch

120

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU
Family

DeviceFamily

FirmwareUpdateAllowed

FeatureSupport

FirmwareVersion

string

HardwareID

uint

MemoryResetAllowed

FeatureSupport

Modules

IModuleCollection

Zu welcher Gertefamilie gehrt das Gert? Weitere Informationen finden Sie in der
Beschreibung der DeviceFamily-Enumeration.
Untersttzt dieses Gert Firmware-Aktualisierungen?
Die aktuelle Firmware-Version
des Gerts
Die eindeutige Kennung fr
jedes Gert und Modul in der
Station. Sie wird als eindeutige
Kennung bei Ausfhrung einer
Operation FirmwareUpdate
verwendet.
Untersttzt das Gert das Urlschen des Speichers?
Eine Sammlung der in die Station eingesteckten Module.
Siehe auch Klasse IModuleCollection und Moduleigenschaften
(Seite 104)

Name

string

Der Name des Gerts

NewFirmwareVersion

string

Diese Eigenschaft wird in der


Benutzeroberflche des
SIMATIC Automation Tool verwendet und ist fr APIOperationen nicht relevant.

ProgramUpdateAllowed

FeatureSupport

Untersttzt das Gert eine Programmaktualisierung?

ProjectData

Uint64

Diese Eigenschaft wird in der


Benutzeroberflche des
SIMATIC Automation Tool verwendet und ist fr APIOperationen nicht relevant.

ResetToFactoryAllowed

FeatureSupport

RestoreAllowed

FeatureSupport

Untersttzt das Gert das


Rcksetzen auf die Werkseinstellungen?

Selected

bool

SerialNumber

string

Die eindeutige Seriennummer


fr das Gert.

Slot

uint

Die Steckplatznummer fr das


Hardware-Element.

Untersttzt das Gert die Wiederherstellungsfunktionen?


Diese Eigenschaft wird in der
Benutzeroberflche des
SIMATIC Automation Tool verwendet und ist fr APIOperationen nicht relevant.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

121

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU
SlotName

string

StationNumber

uint

SubSlot

uint

Supported

bool

Diese Eigenschaft wird in der


Benutzeroberflche des
SIMATIC Automation Tool verwendet und ist fr APIOperationen nicht relevant.
Die Stationsnummer des Gerts.
Die Subslot-Nummer des Gerts. Diese ist fr steckbare
Submodule wie das SB-1200
(Signalboard) relevant.
Wird das erkannte Netzwerkgert von aktuellen Operationen
der SIMATIC Automation Tool
API untersttzt?

SIMATIC Automation Tool V2.1 Benutzerhandbuch

122

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.9 Schnittstelle ICPU
Mithilfe der Eigenschaft Devices der Schnittstelle IRemoteInterface knnen alle Stationen
eines dezentralen Netzwerks inspiziert werden.
Um das frhere Beispiel fortzufhren:
retVal = myNetwork.ScanNetworkDevices(out scannedDevices);
if (!retVal.Succeeded)
return;
foreach (IProfinetDevice dev in scannedDevices)
{
ICPU devAsCpu = dev as ICPU;
if (devAsCpu == null)
continue;
//---------------------------------------------------------// Ein Aufruf von RefreshStatus() ist notwendig, um Informationen ber dezentrale
// Netzwerke zu erfassen
//---------------------------------------------------------retVal = devAsCpu.RefreshStatus(new EncryptedString(""));
if (!retVal.Succeeded)
return;
List<IRemoteInterface> decentalNets = devAsCpu.RemoteInterfaces;
List<string> orderNumbers = new List<string>();
foreach (IRemoteInterface net in decentalNets)
{
//----------------------------// Die Remote-Schnittstelle inspizieren
//----------------------------if (net.InterfaceType == RemoteInterfaceType.Profinet)
{
//-------------------------------// Jede dezentrale Station berprfen
//-------------------------------List<IBaseDevice> stations = net.Devices;

foreach (IBaseDevice station in stations)


{
orderNumbers.Add(station.ArticleNumber);
}

Bei diesem Beispiel werden alle PROFINET-Remoteschnittstellen erfasst und es wird eine
Liste der Bestellnummern fr alle dezentralen Stationen im Industrienetzwerk erstellt.
Da IBaseDevice auch die Eigenschaft Modules untersttzt, knnte das obige Beispiel einfach
erweitert werden und es knnten ber die dezentralen Stationen hinaus auch die lokal
gesteckten Module an jeder Station erfasst werden.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

123

SIMATIC Automation Tool API fr .NET Framework


6.10 Enumerationen

6.10

Enumerationen

6.10.1

DataChangedType
Diese Enumeration legt die mglichen Argumentwerte fr den DataChangedEventHandler
(Seite 101) fest.
OperatingState
RackInformation

6.10.2

DeviceFamily
Diese Enumeration gibt die Produktfamilie eines Hardware-Elements an.
CPU1200
CPU1500
ET200AL
ET200ECO
ET200M
ET200MP
ET200PRO
ET200S
ET200SP
NetworkDevice
None

SIMATIC Automation Tool V2.1 Benutzerhandbuch

124

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.10 Enumerationen

6.10.3

ErrorCode
Diese Enumeration umfasst alle mglichen Ausgabewerte fr ein Result-Objekt. Es gibt zwei
Kategorien von Werten.
Die folgenden Werte werden nur von einer legitimierten CPU-Verbindung ausgegeben:
AccessDenied
ServiceTimeout
Disconnected
FailedToDisconnect
TooManyRequests
TooManySessions
SessionDelegitimated
NotChangableInRun
NotEnoughMemoryAvailable
InvalidFileName
MultiESNotSupported
ServiceAborted
MultiESLimitExceeded
MultiESIncompatibleOtherESVersion
LegitimizationFailsafeLevelNotAllowed

Die folgenden Werte sind nicht auf eine legitimierte Verbindung beschrnkt:
OK
GenericFailure
ProjectIPMismatch
CPUFailedToEnterRunMode
MACAddressIsNotValid
IPAddressIsNotValid
SubnetMaskIsNotValid
GatewayIsNotValid
ProfinetNameIsNotValid
InvalidPointer
SetIPErrorDueProjectSettings
UnsupportedCPU
FirmwareUpdateModuleNotConfigured
DeviceDoesNotSupportFirmwareUpdate
SetNameErrorDueProjectSettings
FirmwareUpdateModuleNotSupported
OperationNotSupportedByThisDevice
ProgramUpdateNotSupported
FirmwareFileNotCompatibleToNew
FirmwareFileNotCompatibleToOld
FirmwareFileNotCompatibleNotSame
FirmwareFileNotCompatibleSame
FirmwareFileNotCompatibleBuildType
BackupRestoreNotSupported
ResetToFactoryDefaultsNotSupported
MemoryResetNotSupported
OperationCanceledByUser
FirmwareVersionMatch

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

125

SIMATIC Automation Tool API fr .NET Framework


6.10 Enumerationen
UpdateProgramVersionGreaterPLCVersion
DeviceNotOnNetwork
FirmwareFileNotCompatible
FirmwareModuleDeactivated
FirmwareModuleMaintenanceRequired
FirmwareModuleMaintenanceDemanded
FirmwareModuleError
FirmwareModuleNotReachable
FirmwareModuleUnknown
FirmwareModuleIOnotAvailable
FirmwareModuleNotAccepted
FirmwareIDNotFound
FailsafeAccessNotAllowed

6.10.4

OperatingState
Diese Enumeration definiert die mglichen Zustnde, die von einem Aufruf der Methode
GetOperatingState (Seite 111) ausgegeben werden knnen.
NotSupported
StopFwUpdate
StopSelfInitialization
Stop
Startup
Run
Halt
LinkUp
Update
Defective
ErrorSearch
NoPower
CiR
STOPwithoutODIS
RunODIS

6.10.5

OperatingStateREQ
Diese Enumeration definiert die mglichen Zustnde, die bei einem Aufruf der Methode
GetOperatingState (Seite 116) angefordert werden knnen.
Stop
Run

SIMATIC Automation Tool V2.1 Benutzerhandbuch

126

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

SIMATIC Automation Tool API fr .NET Framework


6.10 Enumerationen

6.10.6

ProgressAction
Diese Enumeration legt die mglichen Argumentwerte fest, die an einen
ProgressChangedEventHandler (Seite 102) gesendet werden knnen.
Invalid
Connecting
Reconnecting
Disconnecting
Initializing
Updating
Processing
Downoading
Uploading
Resetting
Rebooting
Verifying
Finished

6.10.7

RemoteInterfaceType
Diese Enumeration definiert die mglichen Zustnde, die von einem Aufruf der Eigenschaft
InterfaceType an der Schnittstelle IRemoteInterfaces (Seite 119) ausgegeben werden
knnen.
None
Profinet
Profibus
ASi

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

127

SIMATIC Automation Tool API fr .NET Framework


6.10 Enumerationen

6.10.8

FeatureSupport
Das SIMATIC Automation Tool zeigt mithilfe dieser Enumeration, welche Funktionen die
einzelnen Gerte untersttzen.
Uninitialized
BackupAllowed
ChangeModeAllowed
FailsafeSupported
FirmwareUpdateAllowed
MemoryResetAllowed
PasswordAllowed
ProgramUpdateAllowed
ResetToFactoryAllowed
NotFailsafe
RestoreAllowed

Um zu prfen, ob ein Gert eine bestimmte Funktion untersttzt, vergleichen Sie den Wert
der entsprechenden Eigenschaft mit dem fr diese Funktion definierten Wert von
FeatureSupport. Beispielsweise wird mit folgendem Code geprft, ob ein Gert die Funktion
zum Urlschen des Speichers untersttzt, bevor diese Operation versucht wird:
List<ICPU> cpus = devices.FilterOnlyCpus();
foreach (ICPU cpu in cpus)
{
if (cpu.MemoryResetAllowed == FeatureSupport.MemoryResetAllowed)
{
cpu.MemoryReset(new EncryptedString(string.Empty));
}
}

SIMATIC Automation Tool V2.1 Benutzerhandbuch

128

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Untersttzte Gerte im SIMATIC Automation Tool


7.1

Nicht erkannte Firmware-Versionen und Gerte


Die Gerteuntersttzungs-Tabellen zeigen die Entsprechungen zwischen dem SIMATIC
Automation Tool V2.1, dem SIMATIC Gertemodell, mglichen Firmware-Versionen und
untersttzten Operationen des Tools.
Wenn Sie ein nicht erkanntes SIMATIC-Gert mit Ihrem Netzwerk verbinden, gibt es zwei
Mglichkeiten:
Das SIMATIC SIMATIC Automation Tool V2.1 erkennt die Artikelnummer des Gerts,
aber die Firmware-Version ist eine neuere als die letzte untersttzte Firmware-Version. In
diesem Fall wird das Gert in die Gertetabelle geladen, aber es werden nur die
Operationen des Tools untersttzt, bei denen dies auch mit der letzten untersttzten
Firmware-Version der Fall war.
Das SIMATIC Automation Tool V2.1 erkennt die Artikelnummer nicht. In diesem Fall wird
das Gert nicht untersttzt, in der Gertetabelle wird kein Eintrag vorgenommen und es
sind keine Operationen des Tools mglich.

7.2

Untersttzung der S7-1200 CPU

Untersttzte Funktionen in den Firmware-Versionen der S7-1200


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird. Standard-CPUs haben nur
die Firmware-Versionsnummer im Spaltenkopf. Fehlersichere CPUs haben die Bezeichnung
"Fehlersicher" im Spaltenkopf.
S7-1200

V1.x

V2.x

V3.x

V4.0

V4.1

Fehlersicher
V4.1

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit

Programmaktualisierung

Versetzen der CPU in RUN/STOP

Urlschen des CPU-Speichers

Lesen des Diagnosepuffers

Laden von Servicedaten

Firmware-Aktualisierung

Sichern und Wiederherstellen


Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

129

Untersttzte Gerte im SIMATIC Automation Tool


7.3 Untersttzung der S7-1500 CPUs

7.3

Untersttzung der S7-1500 CPUs

Untersttzte Funktionen in den Firmware-Versionen der S7-1500


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird. Standard-CPUs haben nur
die Firmware-Versionsnummer im Spaltenkopf. Fehlersichere CPUs haben die Bezeichnung
"Fehlersicher" im Spaltenkopf.
Fehlersicher
S7-1500

V1.0

V1.1

V1.5

V1.6

V1.7

V1.8

V1.5

V1.6

V1.7

V1.8

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit

Programmaktualisierung

Firmware-Aktualisierung

Versetzen der CPU in RUN/STOP

Urlschen des CPU-Speichers

Lesen des Diagnosepuffers

Laden von Servicedaten

Sichern

Wiederherstellen

Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch

130

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Untersttzte Gerte im SIMATIC Automation Tool


7.4 Untersttzung der ET 200SP CPU (Dezentrale Peripheriesteuerung auf Basis von ET 200SP und S7-1500)

7.4

Untersttzung der ET 200SP CPU (Dezentrale Peripheriesteuerung


auf Basis von ET 200SP und S7-1500)

Untersttzte Funktionen in den Firmware-Versionen der ET 200SP CPU


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird. Standard-CPUs haben nur
die Firmware-Versionsnummer im Spaltenkopf. Fehlersichere CPUs haben die Bezeichnung
"Fehlersicher" im Spaltenkopf.
Fehlersicher
ET 200SP CPU

V1.6

V1.7

V1.8

V1.7

V1.8

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit

Programmaktualisierung

Firmware-Aktualisierung

Versetzen der CPU in RUN/STOP

Urlschen des CPU-Speichers

Lesen des Diagnosepuffers

Laden von Servicedaten

Sichern

Wiederherstellen

Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

131

Untersttzte Gerte im SIMATIC Automation Tool


7.5 Untersttzung von ET 200SP (PROFINET I/O)

7.5

Untersttzung von ET 200SP (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200SP


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200SP

V1.0

V1.1

V2.1

V2.2

V3.0

V3.1

V3.2

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINETNamens

Einstellen der Uhrzeit auf


PG/PC-Zeit
Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in
RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

7.6

Untersttzung von ET 200MP (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200MP


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200MP

V1.0

V2.0

V3.0

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch

132

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Untersttzte Gerte im SIMATIC Automation Tool


7.7 Untersttzung von ET 200AL (PROFINET I/O)

7.7

Untersttzung von ET 200AL (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200AL


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200AL

V1.0

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung

Versetzen der CPU in RUN/STOP


Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

133

Untersttzte Gerte im SIMATIC Automation Tool


7.8 Untersttzung von ET 200S (PROFINET I/O)

7.8

Untersttzung von ET 200S (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200S


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200S

V3.x

V5.x

V6.x

V7.x

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

Hinweis
Keine Untersttzung der ET 200S CPU
Die ET 200S CPU wird vom SIMATIC Automation Tool nicht untersttzt

SIMATIC Automation Tool V2.1 Benutzerhandbuch

134

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Untersttzte Gerte im SIMATIC Automation Tool


7.9 Untersttzung von ET 200M (PROFINET I/O)

7.9

Untersttzung von ET 200M (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200M


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200M

V2.x

V3.x

V4.x

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

7.10

Untersttzung von ET 200eco (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200eco


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200eco

V6.x

V7.x

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

135

Untersttzte Gerte im SIMATIC Automation Tool


7.11 Untersttzung von ET 200pro (PROFINET I/O)

7.11

Untersttzung von ET 200pro (PROFINET I/O)

Untersttzte Funktionen in den Firmware-Versionen der ET 200pro


Das Hkchen () bedeutet, dass der Vorgang untersttzt wird.
ET 200SP

V2.x

V4.x

V5.x

V6.x

V7.x

Scannen auf Gerte

LED-Blinken

Einstellen der IP-Adresse

Einstellen des PROFINET-Namens

Einstellen der Uhrzeit auf PG/PC-Zeit


Programmaktualisierung
Firmware-Aktualisierung
Versetzen der CPU in RUN/STOP
Urlschen des CPU-Speichers
Lesen des Diagnosepuffers
Laden von Servicedaten
Sichern und Wiederherstellen
Rcksetzen auf Werkseinstellungen

Hinweis
Die ET 200pro CPU wird nicht untersttzt
Die ET 200pro CPU wird vom SIMATIC Automation Tool nicht untersttzt

SIMATIC Automation Tool V2.1 Benutzerhandbuch

136

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Netzwerkbeispiel und API-Schnittstellen


A.1

Netzwerkbeispiel
Dieses Beispiel zeigt eine Netzwerkkonfiguration des TIA Portals und die API-Schnittstellen,
welche die vernetzten Gerte darstellen.

Hierbei gelten folgenden Annahmen: Alle Gerte in der obersten Zeile (PLC_1, IO device_1
und PLC_2) seien mit einem externen Ethernet-Netzwerk (nicht abgebildet) verbunden und
ermglichen so den direkten Zugriff durch die SIMATIC Automation Tool API. Ferner sei
angenommen, dass das mit PLC_2 verbundene PROFINET-Subnetz nicht mit dem externen
Netzwerk verbunden ist.
Die SIMATIC Automation Tool API kann fr alle PLCs und Peripheriestationen in dieser
Konfiguration Informationen und Operationen bereitstellen.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

137

Netzwerkbeispiel und API-Schnittstellen


A.1 Netzwerkbeispiel
Das folgende Schaubild zeigt dieselbe Netzwerkkonfiguration und die Hardwaregerte im
Netzwerk:

SIMATIC Automation Tool V2.1 Benutzerhandbuch

138

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Netzwerkbeispiel und API-Schnittstellen


A.1 Netzwerkbeispiel
Im Schaubild oben wird durch die Symbole in Form eines Lollis jeweils angegeben, welche
Schnittstellenklasse der SIMATIC Automation Tool API die betreffende
Netzwerkkomponente am besten reprsentiert.
Mit dem externen Netzwerk direkt verbundene CPUs werden durch die Schnittstelle ICPU
dargestellt
Mit dem externen Netzwerk direkt verbundene Peripheriestationen werden durch die
Schnittstelle /IProfinetDevice reprsentiert
Die von einer CPU ausgehenden Subnetze werden durch die Schnittstelle
IRemoteInterface reprsentiert.
Mit dem externen Netzwerk nicht direkt verbundene (aber ber eine CPU erreichbare)
Peripheriestationen werden durch die Schnittstelle IBaseDevice dargestellt.
Peripherie- oder Kommunikationsmodule, die mit einer CPU oder Peripheriestation
verbunden sind, werden durch die Schnittstelle IModule reprsentiert.

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

139

Netzwerkbeispiel und API-Schnittstellen


A.1 Netzwerkbeispiel

SIMATIC Automation Tool V2.1 Benutzerhandbuch

140

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Index
Diagnosepuffer, 58, 58

A
API (Anwendungsschnittstelle)
AutomationToolAPI.dll, 17, 76
bersicht ber die Architektur, 74
Versionskompatibilitt, 73
Automation Tool - bersicht, 9

B
Befehle
ndern der IP-Adresse, 34
ndern des PROFINET-Namens, 35
Ausfhrungsreihenfolge, 59
Einstellen der Uhrzeit in der CPU, 57
Importieren/Exportieren, 62
Installieren neuer Firmware, 43
Laden eines neuen Programms, 39
Laden von Servicedaten, 55
LED-Blinken, 38
Lesen des Diagnosepuffers, 58, 58
Rcksetzen auf Werkseinstellungen, 52
RUN/STOP, 36
Save/Save as, 61
Scannen, 28
Sichern von Gerten, 48
Urlschen des Speichers, 54
Wiederherstellen von Namen, 48
Beispielnetzwerk, 137
Betriebsart RUN, 36
Betriebsart STOP, 36

E
Eigenschaft CurrentNetworkInterface (API), 82
Einrichten der Kommunikation, 24
Einstellen der Uhrzeit, 57
Elemente von IProfinetDevice Collection (API), 85
Ereignis DataChanged (API), 101
Ereignis ProgressChanged (API), 102
ErrorCode (API), 125

F
FeatureSupport (API), 128
Filtern von Gertezeilen, 28
Firmware-Aktualisierung, 43

G
Gertetabelle, 28
Gerteuntersttzung
ET 200AL, 133
ET 200eco, 135
ET 200M, 135
ET 200MP, 132
ET 200pro, 136
ET 200S, 134
ET 200SP, 132
ET 200SP CPU, 131
nicht erkannte Gerte, 129
S7-1200, 129
S7-1500, 130

C
CPU
IP-Konfigurationsvoraussetzungen, 22
Konfigurationsvoraussetzungen fr PROFINETNamen, 22
CSV-Datei, 62

D
DataChangedType (API), 124
DeviceFamily (API), 124
Dezentrale Module, 119

H
Hotline, 3

I
ICPU (API)
Eigenschaften, 107
Schnittstelle, 106
IModule (API)
IModuleCollectionClass, 104
Schnittstelle, 104

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

141

Index

IP-Adresse
Gerteeinstellung, 34
Konfigurationsvoraussetzungen, 22
IProfinetDevice (API)
Eigenschaften, 91
Iteration von Elementen der Sammlung, 84
IRemoteInterface-Eigenschaften (API), 120

K
Klasse EncryptedString (API), 77
Klasse Result (API), 78
Konfigurationsvoraussetzungen fr PROFINETNamen, 22
Kontaktdaten, 3
Kunden-Support, 3

L
Laden von Servicedaten, 55

M
Men
Edit, 66
File, 65
Help, 70
Network, 67
Tools, 68
Methode Backup (API), 108
Methode FilterByDeviceFamily (API), 85
Methode FilterOnlyCPUs (API), 86
Methode FindDeviceByIP (API), 87
Methode FindDeviceByMAC (API), 88
Methode FirmwareUpdate (API), 95
Methode FlashLED (API), 97
Methode GetCurrentDateTime (API), 109
Methode GetDiagnosticsBuffer (API), 110
Methode GetOperatingState (API), 111
Methode MemoryReset (API), 112
Methode QueryNetworkInterfaceCards (API), 81
Methode ReadFromStream (API), 90
Methode RefreshStatus (API), 94
Methode ResetToFactory (API), 114
Methode Restore (API), 115
Methode ScanNetworkDevices (API), 83
Methode SetCurrentDateTime (API), 117
Methode SetCurrentNetworkInterface (API), 82
Methode SetIP (API), 99
Methode SetOperatingState (API), 116
Methode SetProfinetName (API), 100

Methode UploadServiceData (API), 118


Methode WriteToStream (API), 89

N
Name der SAT-Dateierweiterung, 61
Network-Constructor (API), 80
Netzwerk
Optionen, 15
Zugriff, 13
Netzwerkbeispiel, 137

O
OperatingState (API), 126
OperatingStateReq (API), 126

P
Passwort fr fehlersicheren Betrieb (API), 78
ProgramUpdate (API), 113
ProgressAction (API), 127

R
RemoteInterfaceType (API), 127
Remote-Module (API), 119
Rcksetzen auf Werkseinstellungen, 52
Rcksetzmethode (API), 98

S
Scannen eines Netzwerks, 28
Service und Support, 3
Sichern von Gerten, 48
Support, 3
Symbole der Symbolleiste, 71

T
Tastenkombinationen, 72
Technischer Support, 3
Technischer Support von Siemens, 3

U
Untersttzte Betriebssysteme, 19
Urlschen des Speichers, 54

SIMATIC Automation Tool V2.1 Benutzerhandbuch

142

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

Index

W
Wiederherstellen von Namen, 48

SIMATIC Automation Tool V2.1 Benutzerhandbuch


Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB

143

Index

SIMATIC Automation Tool V2.1 Benutzerhandbuch

144

Gertehandbuch, V2.1.1 07/2016, A5E36151946 AB