Table of contents
SIMATIC Automation Tool V2.1 user guide
6 Manual, 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