Siemens Simatic S7-1500 Parts list manual

___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
___________________
SIMATIC
S7-1500
S7-PLCSIM Advanced
Function Manual
12/2017
A5E37039512
-AB
Preface
Guide
1
Product overview
2
Installing
3
Communication paths
4
Simulate CPU
5
Virtual time response
6
User interfaces (API)
7
Restrictions
8
List of abbreviations
A

Siemens AG
Division Digital Factory
Postfach 48 48
90026 NÜRNBERG
GERMANY
A5E37039512-AB
Ⓟ
12/2017 Subject to change
Copyright © Siemens AG 2016 - 2017.
All rights reserved
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by
personnel qualified
for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.

S7-PLCSIM Advanced
4Function Manual, 12/2017, A5E37039512-AB
Preface
Purpose of the documentation
This function manual describes the simulation software, SIMATIC
S7-PLCSIM Advanced V2.0. You can use this software to simulate and test your SIMATIC
STEP 7 programs on a virtual controller.
You can obtain updates to the function manual as downloads on the Internet
(https://support.industry.siemens.com/cs/us/en/view/109739154).
An application example for S7-PLCSIM Advanced is also available on the Internet
(https://support.industry.siemens.com/cs/ww/en/view/109739660).
Scope
This function manual is valid for the following order versions
●6ES7823-1FA01-0YA5 - SIMATIC S7-PLCSIM Advanced V2.0 Floating License (DVD)
●6ES7823-1FE01-0YA5 - SIMATIC S7-PLCSIM Advanced V2.0 Floating License
(Download)
●6ES7823-1FA01-0YE5 - Upgrade SIMATIC S7-PLCSIM Advanced V1.0 → V2.0 (DVD)
●6ES7823-1FE01-0YE5 - Upgrade SIMATIC S7-PLCSIM Advanced V1.0 → V2.0
(Download)
The articles each contain one license for up to three instances.
Basic knowledge required
The system may only be used by qualified staff.
The following knowledge is required:
●Industrial Automation and Automation Technology
●Programming with STEP 7 (TIA Portal)
●SIMATIC CPUs and CPU programming
●PC-based automation using S7-1500 and WinCC Runtime Advanced
●Development of software in C++ or C#
●PC technology
●Windows operating system

Preface
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 5
Conventions
Conventions STEP 7: In this documentation, "STEP 7" is used as a synonym for all versions
of the configuration and programming software "STEP 7 (TIA Portal)".
We also abbreviate SIMATIC S7-PLCSIM Advanced V2.0 as "PLCSIM Advanced".
Please also observe notes marked as follows:
Note
A note contains important information on the product described
in the documentation, on the
handling of the product or on the section of the documentation to which particular attention
should be paid.
Security information
Siemens provides products and solutions with industrial security functions that support the
secure operation of plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is
necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial
security concept. Siemens’ products and solutions only form one element of such a concept.
Customer is responsible to prevent unauthorized access to its plants, systems, machines
and networks. Systems, machines and components should only be connected to the
enterprise network or the internet if and to the extent necessary and with appropriate security
measures (e.g. use of firewalls and network segmentation) in place.
Additionally, Siemens’ guidance on appropriate security measures should be taken into
account. For more information about industrial security, please visit
(http://www.siemens.com/industrialsecurity).
Siemens’ products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends to apply product updates as soon as available and to
always use the latest product versions. Use of product versions that are no longer supported,
and failure to apply latest updates may increase customer’s exposure to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS
Feed under (http://www.siemens.com/industrialsecurity).

S7-PLCSIM Advanced
6Function Manual, 12/2017, A5E37039512-AB
Table of contents
Preface ................................................................................................................................................... 4
1 Guide.................................................................................................................................................... 27
1.1 Documentation guide ............................................................................................................. 27
1.2 S7-PLCSIM products ............................................................................................................. 29
2 Product overview .................................................................................................................................. 30
2.1 What is S7-PLCSIM Advanced? ............................................................................................ 30
2.2 Compatibility during upgrade ................................................................................................. 31
2.3 Security for S7-PLCSIM Advanced........................................................................................ 32
2.4 Simulations support ............................................................................................................... 33
2.5 Supported CPUs .................................................................................................................... 34
2.6 Differences between a simulated and a real CPU ................................................................. 36
2.6.1 Restrictions for all supported CPUs....................................................................................... 37
2.7 Simulating Motion Control...................................................................................................... 39
3 Installing ............................................................................................................................................... 40
3.1 Introduction ............................................................................................................................ 40
3.1.1 System requirements ............................................................................................................. 40
3.1.2 Licenses ................................................................................................................................. 42
3.1.3 Trial License........................................................................................................................... 42
3.1.4 Installation log ........................................................................................................................ 44
3.2 S7-PLCSIM Advanced ........................................................................................................... 45
3.3 Installing S7-PLCSIM Advanced............................................................................................ 46
3.4 Changing S7-PLCSIM Advanced........................................................................................... 48
3.5 Repairing S7-PLCSIM Advanced........................................................................................... 49
3.6 Uninstalling S7-PLCSIM Advanced ....................................................................................... 50
4 Communication paths ........................................................................................................................... 51
4.1 Local communication ............................................................................................................. 53
4.2 Communication via TCP / IP.................................................................................................. 54
4.3 Enable distributed communication......................................................................................... 56
5 Simulate CPU ....................................................................................................................................... 58
5.1 Basic procedure for the simulation......................................................................................... 58
5.2 User interface......................................................................................................................... 59
5.2.1 S7 PLCSIM Advanced Symbol .............................................................................................. 59
5.2.2 S7 PLCSIM Advanced Control Panel .................................................................................... 60

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 7
5.3 Download ................................................................................................................................64
5.4 Network addresses in the simulation ......................................................................................66
5.4.1 Siemens PLCSIM Virtual Ethernet Adapter............................................................................66
5.4.2 PLCSIM Advanced instances .................................................................................................66
5.5 Simulate peripheral I/O ...........................................................................................................68
5.6 Simulate communication.........................................................................................................69
5.6.1 Communication services that can be simulated .....................................................................69
5.6.2 Communication between instances ........................................................................................70
5.7 Provide project data offline for simulation...............................................................................71
6 Virtual time response ............................................................................................................................ 73
6.1 Speed up and slow down simulation ......................................................................................75
6.2 Stop simulation .......................................................................................................................76
6.3 Synchronize simulation partner ..............................................................................................78
6.3.1 Synchronize simulation partner cycle-controlled ....................................................................78
6.3.2 Synchronize simulation partner time-controlled......................................................................80
7 User interfaces (API)............................................................................................................................. 82
7.1 Introduction .............................................................................................................................82
7.1.1 Access to instances ................................................................................................................84
7.1.2 User interfaces (API)...............................................................................................................85
7.1.3 Overview of user interfaces for native C++ ............................................................................86
7.1.4 Overview of user interfaces for managed code ......................................................................90
7.1.5 Overview of data types for native C++....................................................................................93
7.1.6 Overview of data types for managed code .............................................................................94
7.2 Initialize API ............................................................................................................................96
7.2.1 Load API library ......................................................................................................................96
7.2.2 Native C++ ..............................................................................................................................96
7.2.2.1 InitializeApi() ...........................................................................................................................96
7.2.2.2 RuntimeApiEntry_Initialize ......................................................................................................98
7.2.3 .NET (C#)................................................................................................................................99
7.2.3.1 Initialize ...................................................................................................................................99
7.3 Shut down API ......................................................................................................................100
7.3.1 Native C++ ............................................................................................................................100
7.3.1.1 DestroyInterface() .................................................................................................................101
7.3.1.2 RuntimeApiEntry_DestroyInterface.......................................................................................102
7.3.1.3 FreeApi() ...............................................................................................................................103
7.3.1.4 ShutdownAndFreeApi().........................................................................................................104
7.3.2 .NET (C#)..............................................................................................................................105
7.3.2.1 Shut down API ......................................................................................................................105

Table of contents
S7-PLCSIM Advanced
8Function Manual, 12/2017, A5E37039512-AB
7.4 Global functions (Native C++).............................................................................................. 106
7.5 API ISimulationRuntimeManager......................................................................................... 111
7.5.1 Interfaces - Information and settings.................................................................................... 111
7.5.2 Simulation Runtime instances.............................................................................................. 113
7.5.3 Remote connections ............................................................................................................ 119
7.5.4 Events .................................................................................................................................. 124
7.5.4.1 OnConfigurationChanged events......................................................................................... 124
7.5.4.2 OnRuntimeManagerLost events .......................................................................................... 127
7.6 API IInstances ...................................................................................................................... 130
7.6.1 Interfaces - Information and settings.................................................................................... 130
7.6.2 Controller - Information and settings.................................................................................... 136
7.6.3 Operating state..................................................................................................................... 144
7.6.4 Tag list.................................................................................................................................. 152
7.6.5 I/O access ............................................................................................................................ 158
7.6.5.1 Synchronizing inputs and outputs........................................................................................ 158
7.6.5.2 I/O access via address - Reading........................................................................................ 158
7.6.5.3 I/O access via address - Writing .......................................................................................... 166
7.6.5.4 I/O access via tag name - Reading...................................................................................... 173
7.6.5.5 I/O access via tag name - Writing ........................................................................................ 191
7.6.6 Settings for the virtual time .................................................................................................. 220
7.6.7 Cycle control ........................................................................................................................ 223
7.6.8 Acyclic services.................................................................................................................... 228
7.6.8.1 Overview .............................................................................................................................. 228
7.6.8.2 ReadRecordDone / WriteRecordDone ................................................................................ 230
7.6.8.3 AlarmNotification .................................................................................................................. 232
7.6.8.4 ProcessEvent ....................................................................................................................... 234
7.6.8.5 PullOrPlugEvent................................................................................................................... 236
7.6.8.6 StatusEvent.......................................................................................................................... 238
7.6.8.7 ProfileEvent.......................................................................................................................... 239
7.6.8.8 UpdateEvent ........................................................................................................................ 240
7.6.8.9 GetConfiguredProcessEvent ............................................................................................... 241
7.6.8.10 RackOrStationFaultEvent .................................................................................................... 242
7.6.9 Events .................................................................................................................................. 243
7.6.9.1 OnOperatingStateChanged events...................................................................................... 243
7.6.9.2 OnSyncPointReached events .............................................................................................. 247
7.6.9.3 OnConfigurationChanging events........................................................................................ 249
7.6.9.4 OnConfigurationChanged events......................................................................................... 252
7.6.9.5 OnLedChanged events ........................................................................................................ 254
7.6.10 Events for acyclic services................................................................................................... 257
7.6.10.1 OnDataRecordRead / OnDataRecordWrite events ............................................................. 257
7.6.10.2 OnAlarmNotification events ................................................................................................. 258
7.6.10.3 OnProcessEvent events ...................................................................................................... 259
7.6.10.4 OnPullOrPlugEvent events .................................................................................................. 260
7.6.10.5 OnStatusEvent events ......................................................................................................... 261
7.6.10.6 OnProfileEvent events ......................................................................................................... 262
7.6.10.7 OnUpdateEvent events........................................................................................................ 263
7.6.10.8 RackOrStationFault events .................................................................................................. 264

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 9
7.7 API IRemoteRuntimeManager..............................................................................................265
7.7.1 Interfaces - Information and settings ....................................................................................265
7.7.2 Simulation Runtime instances ..............................................................................................268
7.7.2.1 Simulation Runtime instances (remote)................................................................................268
7.7.3 Events ...................................................................................................................................275
7.7.3.1 OnConnectionLost events ....................................................................................................275
7.8 Data types.............................................................................................................................279
7.8.1 DLL import functions (Native C++) .......................................................................................280
7.8.1.1 ApiEntry_Initialize..................................................................................................................280
7.8.1.2 ApiEntry_DestroyInterface ....................................................................................................280
7.8.2 Event callback functions (Native C++)..................................................................................281
7.8.2.1 EventCallback_VOID ............................................................................................................281
7.8.2.2 EventCallback_II_SREC_ST.................................................................................................281
7.8.2.3 EventCallback_II_SREC_ST_SROS_SROS.........................................................................282
7.8.2.4 EventCallback_II_SREC_ST_SRLT_SRLM..........................................................................283
7.8.2.5 EventCallback_II_SREC_ST_UINT32_INT64_INT64_UINT32.............................................284
7.8.2.6 EventCallback_IRRTM..........................................................................................................285
7.8.2.7 EventCallback_SRCC_UINT32_UINT32_INT32...................................................................285
7.8.2.8 EventCallback_II_SREC_ST_SRICC_UINT32_UINT32_UINT32_UINT32...........................286
7.8.2.9 EventCallback_II_SREC_ST_SDRI ......................................................................................287
7.8.2.10 EventCallback_II_SREC_ST_SDR .......................................................................................288
7.8.2.11 EventCallback_II_SREC_ST_UINT32_EPPET_UINT32.......................................................289
7.8.2.12 EventCallback_II_SREC_ST_UINT32_UINT32_EPET_UINT32...........................................290
7.8.2.13 EventCallback_II_SREC_ST_UINT32...................................................................................
291
7.8.2.14 EventCallback_II_SREC_ST_UINT32_UINT32 ....................................................................292
7.8.2.15 EventCallback_II_SREC_ST_UINT32_ERSFET ..................................................................293
7.8.3 Delegate definitions (managed code) ...................................................................................293
7.8.3.1 Delegate_Void.......................................................................................................................293
7.8.3.2 Delegate_II_EREC_DT .........................................................................................................294
7.8.3.3 Delegate_II_EREC_DT_EOS_EOS ......................................................................................294
7.8.3.4 Delegate_II_EREC_DT_ELT_ELM........................................................................................295
7.8.3.5 Delegate_II_EREC_DT_UINT32_INT64_INT64_UINT32 .....................................................296
7.8.3.6 Delegate_IRRTM ..................................................................................................................297
7.8.3.7 Delegate_SRCC_UINT32_UINT32_INT32 ...........................................................................297
7.8.3.8 Delegate_II_EREC_DT_SRICC_UINT32_UINT32_UINT32_UINT32 ...................................298
7.8.3.9 Delegate_II_EREC_DT_SDRI...............................................................................................299
7.8.3.10 Delegate_II_EREC_DT_SDR................................................................................................300
7.8.3.11 Delegate_SREC_ST_UINT32_EPPET_UINT32 ...................................................................301
7.8.3.12 Delegate_SREC_ST_UINT32_UINT32_EPET_UINT32 .......................................................302
7.8.3.13 Delegate_SREC_ST_UINT32 ...............................................................................................303
7.8.3.14 Delegate_SREC_ST_UINT32_UINT32.................................................................................304
7.8.3.15 Delegate_SREC_ST_UINT32_ERSFET ...............................................................................305
7.8.4 Definitions and constants......................................................................................................306
7.8.5 Unions (Native C++) .............................................................................................................307
7.8.5.1 UIP ........................................................................................................................................307
7.8.5.2 UDataValue...........................................................................................................................308

Table of contents
S7-PLCSIM Advanced
10 Function Manual, 12/2017, A5E37039512-AB
7.8.6 Structures............................................................................................................................. 309
7.8.6.1 SDataValue.......................................................................................................................... 309
7.8.6.2 SDVBNI................................................................................................................................ 311
7.8.6.3 SDataValueByAddress ........................................................................................................ 311
7.8.6.4 SDataValueByAddressWithCheck....................................................................................... 312
7.8.6.5 SDataValueByName ............................................................................................................ 312
7.8.6.6 SDataValueByNameWithCheck........................................................................................... 313
7.8.6.7 SConnectionInfo................................................................................................................... 313
7.8.6.8 SInstanceInfo ....................................................................................................................... 314
7.8.6.9 SDimension.......................................................................................................................... 314
7.8.6.10 STagInfo............................................................................................................................... 315
7.8.6.11 SIP ....................................................................................................................................... 317
7.8.6.12 SIPSuite4 ............................................................................................................................. 317
7.8.6.13 SOnSyncPointReachedResult............................................................................................. 319
7.8.6.14 SDataRecordInfo.................................................................................................................. 321
7.8.6.15 SDataRecord........................................................................................................................ 322
7.8.6.16 SConfiguredProcessEvents ................................................................................................. 323
7.8.6.17 SDiagExtChannelDescription............................................................................................... 324
7.8.7 Enumerations....................................................................................................................... 326
7.8.7.1 ERuntimeErrorCode............................................................................................................. 327
7.8.7.2 EArea ................................................................................................................................... 330
7.8.7.3 EOperatingState................................................................................................................... 330
7.8.7.4 EOperatingMode.................................................................................................................. 331
7.8.7.5 ECPUType ........................................................................................................................... 332
7.8.7.6 ECommunicationInterface.................................................................................................... 334
7.8.7.7 ELEDType............................................................................................................................ 334
7.8.7.8 ELEDMode........................................................................................................................... 335
7.8.7.9 EPrimitiveDataType ............................................................................................................. 335
7.8.7.10 EDataType ........................................................................................................................... 338
7.8.7.11 ETagListDetails .................................................................................................................... 342
7.8.7.12 ERuntimeConfigChanged .................................................................................................... 343
7.8.7.13 EInstanceConfigChanged .................................................................................................... 343
7.8.7.14 EPullOrPlugEventType ........................................................................................................ 344
7.8.7.15 EProcessEventType ............................................................................................................ 344
7.8.7.16 EDirection............................................................................................................................. 345
7.8.7.17 EDiagProperty...................................................................................................................... 345
7.8.7.18 EDiagSeverity ...................................................................................................................... 346
7.8.7.19 ERackOrStationFaultType ................................................................................................... 346
8 Restrictions..........................................................................................................................................347
8.1 Overview .............................................................................................................................. 347
8.2 Restrictions with fail-safe CPUs........................................................................................... 347
8.3 OPC UA server .................................................................................................................... 348
8.4 Web server........................................................................................................................... 349
8.5 Backing up and restoring the configuration of a PLCSIM Advanced instance .................... 350
8.6 Restrictions for file paths...................................................................................................... 350
8.7 Restrictions for communications services............................................................................ 351
8.8 Restrictions for instructions.................................................................................................. 351

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 11
8.9 Restrictions with Motion Control ...........................................................................................352
8.9.1 MCR and EMCR ...................................................................................................................352
8.9.2 Technology modules.............................................................................................................353
8.9.3 OB 91 and OB 92..................................................................................................................353
8.10 Restrictions to local communication via Softbus ..................................................................354
8.11 Restrictions of security with VMware vSphere Hypervisor (ESXi)........................................355
8.12 Error with overflow of cyclical events and motion OBs.........................................................355
8.13 Deviating I/O values in the STEP 7 user program................................................................356
8.14 Multiple simulations and possible collision of IP addresses .................................................356
8.15 Lacking access to an IP address ..........................................................................................356
8.16 Simulation in standby mode..................................................................................................356
8.17 Error installing the antivirus software from Kaspersky..........................................................357

Table of contents
S7-PLCSIM Advanced
12 Function Manual, 12/2017, A5E37039512-AB
A List of abbreviations .............................................................................................................................358
Tables
Table 1- 1 Comparison of S7-PLCSIM products...........................................................................................29
Table 2- 1 Compatibility of API and Runtime versions..................................................................................31
Table 2- 2 Supported CPUs ..........................................................................................................................34
Table 2- 3 Compatibility to the TIA Portal......................................................................................................35
Table 3- 1 Minimum requirements for hardware ...........................................................................................40
Table 5- 1 Assignment of the Ethernet interfaces, for example, for a CPU 1518-4 PN/DP..........................67
Table 5- 2 Supported communication options...............................................................................................69
Table 6- 1 Cycle-controlled operating modes (SingleStep)...........................................................................78
Table 6- 2 Time-controlled operating modes (TimespanSynchronized) .......................................................80
Table 7- 1 Overview of initializing and shutting down API - Native C++.......................................................86
Table 7- 2 Overview of global functions - Native C++...................................................................................86
Table 7- 3 Overview of API ISimulationRuntimeManager functions - Native C++........................................87
Table 7- 4 Overview of API ISimulationRuntimeManager events - Native C++............................................87
Table 7- 5 Overview of IInstances functions - Native C++............................................................................87
Table 7- 6 Overview of IInstances events - Native C++................................................................................89
Table 7- 7 Overview of IRemoteRuntimeManager functions - Native C++...................................................89
Table 7- 8 Overview of IRemoteRuntimeManager events - Native C++.......................................................89
Table 7- 9 Overview of initializing and shutting down API - .NET (C#).........................................................90
Table 7- 10 Overview of ISimulationRuntimeManager functions - .NET (C#).................................................90
Table 7- 11 Overview of ISimulationRuntimeManager events - .NET (C#) ....................................................90
Table 7- 12 Overview of IInstances functions - .NET (C#)..............................................................................91
Table 7- 13 Overview of IInstances events - .NET (C#)..................................................................................92
Table 7- 14 Overview of IRemoteRuntimeManager functions - .NET (C#).....................................................92
Table 7- 15 Overview IRemoteRuntimeManager events - .NET (C#).............................................................92
Table 7- 16 Overview of data types - Native C++ ...........................................................................................93
Table 7- 17 Overview of data types - .NET (C#) .............................................................................................94
Table 7- 18 InitializeApi() - Native C++ ...........................................................................................................97
Table 7- 19 RuntimeApiEntry_Initialize - Native C++ ......................................................................................98
Table 7- 20 Initialize - .NET (C#).....................................................................................................................99
Table 7- 21 DestroyInterface() - Native C++ .................................................................................................101
Table 7- 22 RuntimeApiEntry_DestroyInterface() - Native C++ ....................................................................102
Table 7- 23 FreeApi() - Native C++ ...............................................................................................................103
Table 7- 24 ShutdownAndFreeApi() - Native C++ ........................................................................................104

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 13
Table 7- 25 GetNameOfAreaSection() - Native C++ ....................................................................................106
Table 7- 26 GetNameOfCPUType() - Native C++ ........................................................................................106
Table 7- 27 GetNameOfCommunicationInterface() - Native C++.................................................................106
Table 7- 28 GetNameOfDataType() - Native C++ ........................................................................................106
Table 7- 29 GetNameOfErrorCode() - Native C++ .......................................................................................107
Table 7- 30 GetNameOfLEDMode() - Native C++ ........................................................................................107
Table 7- 31 GetNameOfLEDType() - Native C++ .........................................................................................107
Table 7- 32 GetNameOfOperatingMode() - Native C++ ...............................................................................107
Table 7- 33 GetNameOfErrorCode() - Native C++ .......................................................................................108
Table 7- 34 GetNameOfOperatingState() - Native C++................................................................................108
Table 7- 35 GetNameOfPrimitiveDataType() - Native C++...........................................................................108
Table 7- 36 GetNameOfTagListDetails() - Native C++ .................................................................................108
Table 7- 37 GetNameOfRuntimeConfigChanged() - Native C++..................................................................109
Table 7- 38 GetNameOfInstanceConfigChanged() - Native C++ .................................................................109
Table 7- 39 GetNameOfDirection() - Native C++..........................................................................................109
Table 7- 40 GetNameOfDiagSeverity() - Native C++....................................................................................109
Table 7- 41 GetNameOfRackOrStationFaultType() - Native C++.................................................................110
Table 7- 42 GetVersion() - Native C++ .........................................................................................................111
Table 7- 43 Version { get; } - .NET (C#) ........................................................................................................111
Table 7- 44 IsInitialized() - Native C++..........................................................................................................111
Table 7- 45 IsInitialized { get; } - .NET (C#) ..................................................................................................111
Table 7- 46 IsRuntimeManagerAvailable() - Native C++ ..............................................................................112
Table 7- 47 IsRuntimeManagerAvailable { get; } - .NET (C#).......................................................................112
Table 7- 48 Shutdown() - Native C++ ...........................................................................................................112
Table 7- 49 Shutdown() - .NET (C#) .............................................................................................................112
Table 7- 50 GetRegisteredInstancesCount() - Native C++ ...........................................................................113
Table 7- 51 GetRegisteredInstanceInfoAt() - Native C++ .............................................................................113
Table 7- 52 RegisteredInstanceInfo { get; } - .NET (C#) ...............................................................................113
Table 7- 53 RegisterInstance() - Native C++ ................................................................................................114
Table 7- 54 RegisterInstance() - .NET (C#) ..................................................................................................115
Table 7- 55 RegisterCustomInstance() - Native C++....................................................................................116
Table 7- 56 RegisterCustomInstance() - .NET (C#)......................................................................................117
Table 7- 57 CreateInterface() - Native C++...................................................................................................118
Table 7- 58 CreateInterface() - .NET (C#) ....................................................................................................119
Table 7- 59 OpenPort() - Native C++ ............................................................................................................119
Table 7- 60 OpenPort() - .NET (C#)..............................................................................................................120

Table of contents
S7-PLCSIM Advanced
14 Function Manual, 12/2017, A5E37039512-AB
Table 7- 61 ClosePort() - Native C++............................................................................................................120
Table 7- 62 ClosePort() - .NET (C#)..............................................................................................................120
Table 7- 63 GetPort() - Native C++ ...............................................................................................................120
Table 7- 64 Port { get; } - .NET (C#)..............................................................................................................121
Table 7- 65 GetRemoteConnectionsCount() - Native C++ ...........................................................................121
Table 7- 66 GetRemoteConnectionInfoAt()- Native C++ ..............................................................................121
Table 7- 67 RemoteConnectionInfo { get; } - .NET (C#) ...............................................................................121
Table 7- 68 RemoteConnect() - Native C++ .................................................................................................122
Table 7- 69 RemoteConnect() - .NET (C#) ...................................................................................................123
Table 7- 70 Events for the ISimulationRuntimeManager interface ...............................................................124
Table 7- 71 OnConfigurationChanged - .NET (C#).......................................................................................124
Table 7- 72 RegisterOnConfigurationChangedCallback() - Native C++ .......................................................124
Table 7- 73 RegisterOnConfigurationChangedEvent() - Native C++............................................................125
Table 7- 74 RegisterOnConfigurationChangedEvent() - .NET (C#)..............................................................125
Table 7- 75 UnregisterOnConfigurationChangedCallback() - Native C++ ....................................................125
Table 7- 76 UnregisterOnConfigurationChangedEvent() - Native C++.........................................................125
Table 7- 77 UnregisterOnConfigurationChangedEvent() - .NET (C#) ..........................................................126
Table 7- 78 WaitForOnConfigurationChangedEvent() - Native C++.............................................................126
Table 7- 79 WaitForOnConfigurationChangedEvent - .NET (C#).................................................................126
Table 7- 80 OnRuntimeManagerLost - .NET (C#) ........................................................................................127
Table 7- 81 RegisterOnRuntimeManagerLostCallback() - Native C++.........................................................127
Table 7- 82 RegisterOnRuntimeManagerLostEvent() - Native C++ .............................................................127
Table 7- 83 RegisterOnRuntimeManagerLostEvent() - .NET (C#) ...............................................................128
Table 7- 84 UnregisterOnRuntimeManagerLostCallback() - Native C++......................................................128
Table 7- 85 UnregisterOnRuntimeManagerLostEvent() - Native C++ ..........................................................128
Table 7- 86 UnregisterOnRuntimeManagerLostEvent() - .NET (C#) ............................................................128
Table 7- 87 WaitForOnRuntimeManagerLostEvent() - Native C++ ..............................................................129
Table 7- 88 WaitForOnRuntimeManagerLostEvent() - .NET (C#) ................................................................129
Table 7- 89 Dispose() - .NET (C#) ................................................................................................................130
Table 7- 90 GetID() - Native C++ ..................................................................................................................130
Table 7- 91 ID { get; } - .NET (C#).................................................................................................................130
Table 7- 92 GetName() - Native C++ ............................................................................................................131
Table 7- 93 Name { get; } - .NET (C#)...........................................................................................................131
Table 7- 94 GetCPUType() - Native C++ ......................................................................................................132
Table 7- 95 SetCPUType() - Native C++.......................................................................................................132
Table 7- 96 CPUType { get; set; } - .NET (C#)..............................................................................................132

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 15
Table 7- 97 GetCommunicationInterface() - Native C++ ..............................................................................133
Table 7- 98 SetCommunicationInterface() - Native C++...............................................................................133
Table 7- 99 CommunicationInterface { get; set; } - .NET (C#) ......................................................................134
Table 7- 100 GetInfo() - Native C++................................................................................................................134
Table 7- 101 Info { get; } - .NET (C#) ..............................................................................................................134
Table 7- 102 UnregisterInstance() - Native C++ .............................................................................................135
Table 7- 103 UnregisterInstance() - .NET (C#)...............................................................................................135
Table 7- 104 GetControllerName() - Native C++ ............................................................................................136
Table 7- 105 ControllerName { get; } - .NET (C#)...........................................................................................136
Table 7- 106 GetControllerShortDesignation() - Native C++ ..........................................................................137
Table 7- 107 ControllerShortDesignation { get; } - .NET (C#).........................................................................137
Table 7- 108 GetControllerIPCount() - Native C++.........................................................................................137
Table 7- 109 GetControllerIP() - Native C++...................................................................................................138
Table 7- 110 ControllerIP { get; } - .NET (C#) .................................................................................................138
Table 7- 111 GetControllerIPSuite4() Native C++...........................................................................................138
Table 7- 112 ControllerIPSuite4 { get; } - .NET (#) .........................................................................................138
Table 7- 113 SetIPSuite() - Native C++ ..........................................................................................................139
Table 7- 114 SetIPSuite() - .NET (C#) ............................................................................................................140
Table 7- 115 GetStoragePath() - Native C++..................................................................................................140
Table 7- 116 SetStoragePath() - Native C++ ..................................................................................................141
Table 7- 117 StoragePath { get; set; } - .NET (C#) .........................................................................................141
Table 7- 118 ArchiveStorage() - Native C++...................................................................................................142
Table 7- 119 ArchiveStorage() - .NET (C#).....................................................................................................142
Table 7- 120 RetrieveStorage() - Native C++ .................................................................................................143
Table 7- 121 RetrieveStorage() - .NET (C#) ...................................................................................................143
Table 7- 122 GetOperatingState() - Native C++ .............................................................................................144
Table 7- 123 OperatingState { get; } - .NET (C#)............................................................................................145
Table 7- 124 PowerOn() - Native C++ ............................................................................................................146
Table 7- 125 PowerOn() - .NET (C#) ..............................................................................................................147
Table 7- 126 PowerOff() - Native C++ ............................................................................................................148
Table 7- 127 PowerOff() - .NET (C#) ..............................................................................................................148
Table 7- 128 MemoryReset() - Native C++ .....................................................................................................149
Table 7- 129 MemoryReset() - .NET (C#).......................................................................................................149
Table 7- 130 Run() - Native C++.....................................................................................................................150
Table 7- 131 Run() - .NET (C#).......................................................................................................................150
Table 7- 132 Stop() - Native C++ ....................................................................................................................151

Table of contents
S7-PLCSIM Advanced
16 Function Manual, 12/2017, A5E37039512-AB
Table 7- 133 Stop() - .NET (C#) ......................................................................................................................151
Table 7- 134 UpdateTagList() - Native C++ ....................................................................................................153
Table 7- 135 UpdateTagList() - .NET (C#)......................................................................................................154
Table 7- 136 GetTagListStatus() - Native C++................................................................................................155
Table 7- 137 GetTagListStatus() - .NET (C#)..................................................................................................155
Table 7- 138 GetTagInfoCount() - Native C++................................................................................................155
Table 7- 139 GetTagInfos() - Native C++........................................................................................................156
Table 7- 140 TagInfos { get; } - .NET (C#) ......................................................................................................156
Table 7- 141 CreateConfigurationFile() - Native C++ .....................................................................................157
Table 7- 142 CreateConfigurationFile() - .NET (C#) .......................................................................................157
Table 7- 143 InputArea { get; } MarkerArea { get; } OutputArea { get; } - .NET (C#) ......................................158
Table 7- 144 GetAreaSize() - Native C++ .......................................................................................................159
Table 7- 145 AreaSize { get; } - .NET (C#)......................................................................................................159
Table 7- 146 ReadBit() - Native C++...............................................................................................................160
Table 7- 147 ReadBit() - .NET (C#).................................................................................................................160
Table 7- 148 ReadByte() - Native C++............................................................................................................161
Table 7- 149 ReadByte() - .NET (C#)..............................................................................................................162
Table 7- 150 ReadByte() - Native C++............................................................................................................163
Table 7- 151 ReadBytes() - .NET (C#)............................................................................................................164
Table 7- 152 ReadSignals() - Native C++ .......................................................................................................165
Table 7- 153 ReadSignals() - .NET (C#) .........................................................................................................166
Table 7- 154 WriteBit() - Native C++ ...............................................................................................................167
Table 7- 155 WriteBit() - .NET (C#).................................................................................................................168
Table 7- 156 WriteByte() - Native C++ ............................................................................................................169
Table 7- 157 WriteByte() - .NET (C#)..............................................................................................................169
Table 7- 158 WriteBytes() - Native C++ ..........................................................................................................170
Table 7- 159 WriteBytes() - .NET (C#) ............................................................................................................171
Table 7- 160 WriteSignals() - Native C++ .......................................................................................................172
Table 7- 161 WriteSignals() - .NET (C#) .........................................................................................................173
Table 7- 162 Read() - Native C++ ...................................................................................................................174
Table 7- 163 Read() - .NET (C#).....................................................................................................................175
Table 7- 164 ReadBool() - Native C++............................................................................................................176
Table 7- 165 ReadBool() - .NET (C#)..............................................................................................................176
Table 7- 166 ReadInt8() - Native C++.............................................................................................................177
Table 7- 167 ReadInt8() - .NET (C#)...............................................................................................................177
Table 7- 168 ReadInt16() - Native C++...........................................................................................................178

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 17
Table 7- 169 ReadInt16() - .NET (C#).............................................................................................................178
Table 7- 170 ReadInt32() - Native C++...........................................................................................................179
Table 7- 171 ReadInt32() - .NET (C#).............................................................................................................179
Table 7- 172 ReadInt64() - Native C++...........................................................................................................180
Table 7- 173 ReadInt64() - .NET (C#).............................................................................................................180
Table 7- 174 ReadUInt8() - Native C++ ..........................................................................................................181
Table 7- 175 ReadUInt8() - .NET (C#) ............................................................................................................181
Table 7- 176 ReadUInt16() - Native C++ ........................................................................................................182
Table 7- 177 ReadUInt16() - .NET (C#) ..........................................................................................................182
Table 7- 178 ReadUInt32() - Native C++ ........................................................................................................183
Table 7- 179 ReadUInt32() - .NET (C#) ..........................................................................................................183
Table 7- 180 ReadInt64() - Native C++...........................................................................................................184
Table 7- 181 ReadUInt64() - .NET (C#) ..........................................................................................................184
Table 7- 182 ReadFloat() - Native C++...........................................................................................................185
Table 7- 183 ReadFloat() - .NET (C#).............................................................................................................185
Table 7- 184 ReadDouble() - Native C++ .......................................................................................................186
Table 7- 185 ReadDouble() - .NET (C#) .........................................................................................................186
Table 7- 186 ReadChar() - Native C++ ...........................................................................................................187
Table 7- 187 ReadChar() - .NET (C#).............................................................................................................187
Table 7- 188 ReadWChar() - Native C++........................................................................................................188
Table 7- 189 ReadWChar() - .NET (C#) .........................................................................................................188
Table 7- 190 ReadSignals() - Native C++ .......................................................................................................189
Table 7- 191 ReadSignals() - .NET (C#).........................................................................................................190
Table 7- 192 Write() - Native C++ ...................................................................................................................191
Table 7- 193 Write() - .NET (C#).....................................................................................................................192
Table 7- 194 WriteBool() - Native C++............................................................................................................193
Table 7- 195 WriteBool() - .NET (C#)..............................................................................................................194
Table 7- 196 WriteInt8() - Native C++ .............................................................................................................195
Table 7- 197 WriteInt8() - .NET (C#)...............................................................................................................196
Table 7- 198 WriteInt16() - Native C++ ...........................................................................................................197
Table 7- 199 WriteInt16() - .NET (C#).............................................................................................................198
Table 7- 200 WriteInt32() - Native C++ ...........................................................................................................199
Table 7- 201 WriteInt32() - .NET (C#).............................................................................................................200
Table 7- 202 WriteInt64() - Native C++ ...........................................................................................................201
Table 7- 203 WriteInt64() - .NET (C#).............................................................................................................202
Table 7- 204 WriteUInt8() - Native C++ ..........................................................................................................203

Table of contents
S7-PLCSIM Advanced
18 Function Manual, 12/2017, A5E37039512-AB
Table 7- 205 WriteUInt8() - .NET (C#) ............................................................................................................204
Table 7- 206 WriteUInt16() - Native C++.........................................................................................................205
Table 7- 207 WriteUInt16() - .NET (C#) ..........................................................................................................206
Table 7- 208 WriteUInt32() - Native C++.........................................................................................................207
Table 7- 209 WriteUInt32() - .NET (C#) ..........................................................................................................208
Table 7- 210 WriteUInt64() - Native C++.........................................................................................................209
Table 7- 211 WriteUInt64() - .NET (C#) ..........................................................................................................210
Table 7- 212 WriteFloat() - Native C++ ...........................................................................................................211
Table 7- 213 WriteFloat() - .NET (C#) .............................................................................................................212
Table 7- 214 WriteDouble() - Native C++........................................................................................................213
Table 7- 215 WriteDouble() - .NET (C#)..........................................................................................................214
Table 7- 216 WriteChar() - Native C++ ...........................................................................................................215
Table 7- 217 WriteChar() - .NET (C#) .............................................................................................................216
Table 7- 218 WriteWChar() - Native C++ ........................................................................................................217
Table 7- 219 WriteWChar() - .NET (C#)..........................................................................................................218
Table 7- 220 WriteSignals() - Native C++ .......................................................................................................219
Table 7- 221 WriteSignals() - .NET (C#) .........................................................................................................220
Table 7- 222 GetSystemTime() - Native C++..................................................................................................220
Table 7- 223 SetSystemTime() - Native C++ ..................................................................................................221
Table 7- 224 SystemTime { get; set; } - .NET (C#) .........................................................................................221
Table 7- 225 GetScaleFactor() - Native C++ ..................................................................................................221
Table 7- 226 SetScaleFactor() - Native C++...................................................................................................222
Table 7- 227 ScaleFactor { get; set; } - .NET (C#) ..........................................................................................223
Table 7- 228 GetOperatingMode() - Native C++.............................................................................................223
Table 7- 229 SetOperatingMode() - Native C++ .............................................................................................223
Table 7- 230 OperatingMode { get; set; } - .NET (C#).....................................................................................224
Table 7- 231 SetSendSyncEventInDefaultModeEnabled() - Native C++........................................................224
Table 7- 232 IsSendSyncEventInDefaultModeEnabled() - Native C++ ..........................................................224
Table 7- 233 IsSendSyncEventInDefaultModeEnabled { get; set; } - .NET (C#) ............................................225
Table 7- 234 GetOverwrittenMinimalCycleTime_ns() - Native C++ ................................................................225
Table 7- 235 SetOverwrittenMinimalCycleTime_ns() - Native C++ ................................................................225
Table 7- 236 OverwrittenMinimalCycleTime_ns { get; set; } - .NET (C#)........................................................226
Table 7- 237 RunToNextSyncPoint() - Native C++ .........................................................................................226
Table 7- 238 RunToNextSyncPoint() - .NET (C#)...........................................................................................226
Table 7- 239 StartProcessing() - Native C++ ..................................................................................................227
Table 7- 240 StartProcessing() - .NET (C#)....................................................................................................227

Table of contents
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB 19
Table 7- 241 Overview - API methods and associated events .......................................................................228
Table 7- 242 ReadRecordDone() - Native C++...............................................................................................230
Table 7- 243 ReadRecordDone() - .NET (C#) ................................................................................................230
Table 7- 244 WriteRecordDone() - Native C++...............................................................................................231
Table 7- 245 WriteRecordDone() - .NET (C#).................................................................................................231
Table 7- 246 AlarmNotification() - Native C++ ................................................................................................232
Table 7- 247 AlarmNotification() - .NET (C#)..................................................................................................233
Table 7- 248 ProcessEvent() - Native C++ .....................................................................................................234
Table 7- 249 ProcessEvent() - .NET (C#) .......................................................................................................235
Table 7- 250 PullOrPlugEvent() - Native C++ .................................................................................................236
Table 7- 251 PullOrPlugEvent() - .NET (C#)...................................................................................................237
Table 7- 252 StatusEvent() - Native C++ ........................................................................................................238
Table 7- 253 StatusEvent() - .NET (C#)..........................................................................................................238
Table 7- 254 ProfileEvent() - Native C++........................................................................................................239
Table 7- 255 ProfileEvent() - .NET (C#)..........................................................................................................239
Table 7- 256 UpdateEvent() - Native C++.......................................................................................................240
Table 7- 257 UpdateEvent() - .NET (C#) ........................................................................................................240
Table 7- 258 GetConfiguredProcessEvents() - Native C++............................................................................241
Table 7- 259 GetConfiguredProcessEvents() - .NET (C#)..............................................................................241
Table 7- 260 RackOrStationFaultEvent() - Native C++...................................................................................242
Table 7- 261 RackOrStationFaultEvent() - .NET (C#) ....................................................................................242
Table 7- 262 Events for the IInstances interface.............................................................................................243
Table 7- 263 OnOperatingStateChanged - .NET (C#)....................................................................................243
Table 7- 264 RegisterOnOperatingStateChangedCallback() - Native C++ ....................................................244
Table 7- 265 RegisterOnOperatingStateChangedEvent() - Native C++.........................................................244
Table 7- 266 UnregisterOnOperatingStateChangedCallback() - Native C++ .................................................245
Table 7- 267 UnregisterOnOperatingStateChangedEvent() - Native C++......................................................245
Table 7- 268 UnregisterOnOperatingStateChangedEvent() - .NET (C#) .......................................................246
Table 7- 269 WaitForOnOperatingStateChangedEvent() - Native C++..........................................................246
Table 7- 270 WaitForOnOperatingStateChangedEvent() - .NET (C#)............................................................246
Table 7- 271 OnSyncPointReached - .NET (C#) ............................................................................................247
Table 7- 272 RegisterOnSyncPointReachedCallback() - Native C++.............................................................247
Table 7- 273 RegisterOnSyncPointReachedEvent() - Native C++ .................................................................248
Table 7- 274 UnregisterOnSyncPointReachedCallback() - Native C++ .........................................................248
Table 7- 275 UnregisterOnSyncPointReachedEvent() - Native C++..............................................................248
Table 7- 276 UnregisterOnSyncPointReachedEvent() - .NET (C#)................................................................248

Table of contents
S7-PLCSIM Advanced
20 Function Manual, 12/2017, A5E37039512-AB
Table 7- 277 WaitForOnSyncPointReachedEvent() - Native C++ ..................................................................249
Table 7- 278 WaitForOnSyncPointReachedEvent() - .NET (C#)....................................................................249
Table 7- 279 OnConfigurationChanging - .NET (C#) ......................................................................................249
Table 7- 280 RegisterOnConfigurationChangingCallback() - Native C++ ......................................................250
Table 7- 281 RegisterOnConfigurationChangingEvent() - Native C++ ...........................................................250
Table 7- 282 UnregisterOnConfigurationChangingCallback() - Native C++ ...................................................250
Table 7- 283 UnregisterOnConfigurationChangingEvent() - Native C++........................................................251
Table 7- 284 UnregisterOnConfigurationChangingEvent() - .NET (C#)..........................................................251
Table 7- 285 WaitForOnConfigurationChangingEvent() - Native C++............................................................251
Table 7- 286 WaitForOnConfigurationChangingEvent() - .NET (C#)..............................................................251
Table 7- 287 OnConfigurationChanged - .NET (C#).......................................................................................252
Table 7- 288 RegisterOnConfigurationChangedCallback() - Native C++ .......................................................252
Table 7- 289 RegisterOnConfigurationChangedEvent() - Native C++............................................................253
Table 7- 290 UnregisterOnConfigurationChangedCallback() - Native C++ ....................................................253
Table 7- 291 UnregisterOnConfigurationChangedEvent() - Native C++.........................................................253
Table 7- 292 UnregisterOnConfigurationChangedEvent() - .NET (C#) ..........................................................253
Table 7- 293 WaitForOnConfigurationChangedEvent() - Native C++.............................................................254
Table 7- 294 WaitForOnConfigurationChangedEvent() - .NET (C#) ..............................................................254
Table 7- 295 OnLedChanged - .NET (C#) ......................................................................................................254
Table 7- 296 RegisterOnLedChangedCallback() - Native C++.......................................................................255
Table 7- 297 RegisterOnLedChangedEvent() - Native C++ ...........................................................................255
Table 7- 298 UnregisterOnLedChangedCallback() - Native C++ ...................................................................255
Table 7- 299 UnregisterOnLedChangedEvent() - Native C++ ........................................................................256
Table 7- 300 UnregisterOnLedChangedEvent() - .NET (C#)..........................................................................256
Table 7- 301 WaitForOnLedChangedEvent() - Native C++ ............................................................................256
Table 7- 302 WaitForOnLedChangedEvent() - .NET (C#) ..............................................................................256
Table 7- 303 OnDataRecordRead - .NET (C#) ...............................................................................................257
Table 7- 304 OnDataRecordWrite - .NET (C#) ...............................................................................................257
Table 7- 305 RegisterOnDataRecordReadCallback() - Native C++ ...............................................................257
Table 7- 306 UnregisterOnDataRecordReadCallback() - Native C++ ............................................................258
Table 7- 307 OnAlarmNotificationDone() - .NET (C#).....................................................................................258
Table 7- 308 RegisterOnAlarmNotificationDoneCallback() - Native C++ .......................................................258
Table 7- 309 UnregisterOnAlarmNotificationDoneCallback() - Native C++ ....................................................259
Table 7- 310 OnProcessEventDone() - .NET (C#)..........................................................................................259
Table 7- 311 RegisterOnProcessEventDoneCallback() - Native C++ ............................................................259
Table 7- 312 UnregisterOnProcessEventDoneCallback() - Native C++ .........................................................260