
Table of contents
SIMATIC Automation Tool V2.1 user guide
6Manual, V2.1.1 07/2016, A5E33042676-AC
5 Menu, toolbar, and shortcut key reference............................................................................................. 59
5.1 Main menu ............................................................................................................................. 59
5.1.1 File menu ............................................................................................................................... 59
5.1.2 Edit menu ............................................................................................................................... 60
5.1.3 Network menu........................................................................................................................ 61
5.1.4 Tools menu ............................................................................................................................ 62
5.1.5 Help menu.............................................................................................................................. 64
5.2 Toolbar icons.......................................................................................................................... 65
5.3 Shortcut keys ......................................................................................................................... 66
6 SIMATIC Automation Tool API for .NET framework ............................................................................... 67
6.1 API Introduction...................................................................................................................... 67
6.2 Architectural overview............................................................................................................ 68
6.3 Referencing the API in a customer application...................................................................... 70
6.4 Common support classes ...................................................................................................... 71
6.4.1 The EncryptedString class ..................................................................................................... 71
6.4.2 The Fail-Safe password ......................................................................................................... 72
6.4.3 The Result class..................................................................................................................... 72
6.5 The Network class.................................................................................................................. 73
6.5.1 Network constructor ............................................................................................................... 73
6.5.2 QueryNetworkInterfaceCards method ................................................................................... 74
6.5.3 SetCurrentNetworkInterface method ..................................................................................... 75
6.5.4 CurrentNetworkInterface property.......................................................................................... 75
6.5.5 ScanNetworkDevices method................................................................................................ 76
6.6 The IProfinetDeviceCollection class ...................................................................................... 77
6.6.1 Iterating items in the collection............................................................................................... 77
6.6.2 Filtering items in the collection............................................................................................... 78
6.6.2.1 Collection items...................................................................................................................... 78
6.6.2.2 FilterByDeviceFamily method ................................................................................................ 78
6.6.2.3 FilterOnlyCPUs method ......................................................................................................... 79
6.6.3 Finding a specific device in the collection.............................................................................. 80
6.6.3.1 FindDeviceByIP method ........................................................................................................ 80
6.6.3.2 FindDeviceByMAC method.................................................................................................... 81
6.6.4 Serialization............................................................................................................................ 82
6.6.4.1 Transferring a collection to/from an external data file............................................................ 82
6.6.4.2 WriteToStream method.......................................................................................................... 82
6.6.4.3 ReadFromStream method ..................................................................................................... 83
6.7 The IProfinetDevice interface................................................................................................. 84
6.7.1 IProfinetDevice properties...................................................................................................... 84
6.7.2 IProfinetDevice methods........................................................................................................ 87
6.7.2.1 RefreshStatus method ........................................................................................................... 87
6.7.2.2 FirmwareUpdate method ....................................................................................................... 88
6.7.2.3 FlashLED method .................................................................................................................. 90
6.7.2.4 Reset method......................................................................................................................... 91
6.7.2.5 SetIP method ......................................................................................................................... 92
6.7.2.6 SetProfinetName method....................................................................................................... 93
6.7.3 IProfinetDevice events ........................................................................................................... 94
6.7.3.1 DataChanged event ............................................................................................................... 94