Advanced Simulator Manual
Advanced Simulator Manual
Table of Contents
Advanced Simulator Driver 1
Table of Contents 2
Advanced Simulator Driver 3
Overview 3
External Dependencies 4
Setup 4
Channel Properties — General 5
Tag Counts 5
Channel Properties — Write Optimizations 6
Channel Properties — Advanced 6
Channel Properties — Data Source Settings 7
Device Properties — General 8
Operating Mode 8
Tag Counts 9
Device Properties — Scan Mode 9
Device Properties — Table Selection 10
Device Properties — Timing Options 10
Data Types Description 11
Address Descriptions 11
Error Descriptions 12
Missing address. 12
Device address <address> contains a syntax error. 12
Data Type <type> is not valid for device address <address>. 12
Device address <address> is read only. 13
Array support is not available for the specified address: <address>. 13
Write request rejected on read-only item reference <channel name><device name><address>. 13
Unable to retrieve table names. 13
Unable to retrieve table column names. 14
Unable to retrieve table row count. 14
Unable to connect to data source on channel <channel name>. 14
Data source <data source name> is configured as Read Only (all writes will be rejected). 15
Unable to open recordset on device <device name>. 15
Unable to query recordset on device <device name>. 15
Unable to retrieve database value for tag <tag address> on device <device name>. 16
Unable to read internal tag <tag address> on device <device name>. 16
Unable to write to internal tag <tag address> on device <device name> 16
Index 17
www. ptc.com
3 Advanced Simulator Driver
CONTENTS
Overview
What is the Advanced Simulator Driver?
Setup
How do I configure the Advanced Simulator Driver to communicate with ODBC data sources?
Address Descriptions
How do I address a data location in the ODBC data source?
Error Descriptions
What error messages are produced by the Advanced Simulator Driver?
Version 1.029
© 2025 PTC Inc. All Rights Reserved.
Overview
The Advanced Simulator Driver plugs into the industrial-based OPC server, which supplies reliable data access to
any HMI, SCADA, Historian or Enterprise application supporting any platform interfaces. The Advanced Simulator
Driver provides single-point access to multiple ODBC data sources via ODBC. It simulates live data by traversing
through all the records in a selected table at a rate set by the user.
For information on general server topics, refer to the server's help documentation.
www. ptc.com
Advanced Simulator Driver 4
External Dependencies
This driver has external dependencies. It requires Microsoft Data Access Components (MDAC), which consist of
several core components that provide various database technologies (including ODBC and its drivers).
Setup
Supported ODBC Data Sources
The Advanced Simulator Driver supports any ODBC-compliant data source, including the following:
Microsoft Access
Microsoft SQL
MySQL*
Oracle
Sybase
*If the project uses a MySQL data source, select MySQL from the Model drop-down list when creating a device.
The driver will accommodate the MySQL-specific data handling requirements. Users should make sure that the
MyODBC driver is installed for the PC that is running the OPC server.
Communication Protocol
ODBC API
www. ptc.com
5 Advanced Simulator Driver
Identification
Name: Specify the user-defined identity of this channel. In each server project, each channel name must be
unique. Although names can be up to 256 characters, some client applications have a limited display window when
browsing the OPC server's tag space. The channel name is part of the OPC browser information. The property is
required for creating a channel.
For information on reserved characters, refer to "How To... Properly Name a Channel, Device, Tag, and Tag
Group" in the server help.
Driver: Specify the protocol / driver for this channel. Specify the device driver that was selected during channel cre-
ation. It is a disabled setting in the channel properties. The property is required for creating a channel.
Note: With the server's online full-time operation, these properties can be changed at any time. This includes
changing the channel name to prevent clients from registering data with the server. If a client has already acquired
an item from the server before the channel name is changed, the items are unaffected. If, after the channel name
has been changed, the client application releases the item and attempts to re-acquire using the old channel name,
the item is not accepted. Changes to the properties should not be made once a large client application has been
developed. Utilize proper user role and privilege management to prevent operators from changing properties or
accessing server features.
Diagnostics
Diagnostics Capture: When enabled, this option makes the channel's diagnostic information available to OPC
applications. Because the server's diagnostic features require a minimal amount of overhead processing, it is
recommended that they be utilized when needed and disabled when not. The default is disabled.
Note: This property is not available if the driver does not support diagnostics.
For more information, refer to Communication Diagnostics in the server help.
Tag Counts
Static Tags: Provides the total number of defined static tags at this level (device or channel). This information can
be helpful in troubleshooting and load balancing.
www. ptc.com
Advanced Simulator Driver 6
Write Optimizations
Optimization Method: Controls how write data is passed to the underlying communications driver. The options are:
l Write All Values for All Tags: This option forces the server to attempt to write every value to the controller.
In this mode, the server continues to gather write requests and add them to the server's internal write
queue. The server processes the write queue and attempts to empty it by writing data to the device as
quickly as possible. This mode ensures that everything written from the client applications is sent to the tar-
get device. This mode should be selected if the write operation order or the write item's content must
uniquely be seen at the target device.
l Write Only Latest Value for Non-Boolean Tags: Many consecutive writes to the same value can accu-
mulate in the write queue due to the time required to actually send the data to the device. If the server
updates a write value that has already been placed in the write queue, far fewer writes are needed to reach
the same final output value. In this way, no extra writes accumulate in the server's queue. When the user
stops moving the slide switch, the value in the device is at the correct value at virtually the same time. As
the mode states, any value that is not a Boolean value is updated in the server's internal write queue and
sent to the device at the next possible opportunity. This can greatly improve the application performance.
Note: This option does not attempt to optimize writes to Boolean values. It allows users to optimize the
operation of HMI data without causing problems with Boolean operations, such as a momentary push but-
ton.
l Write Only Latest Value for All Tags: This option takes the theory behind the second optimization mode
and applies it to all tags. It is especially useful if the application only needs to send the latest value to the
device. This mode optimizes all writes by updating the tags currently in the write queue before they are
sent. This is the default mode.
Duty Cycle: is used to control the ratio of write to read operations. The ratio is always based on one read for every
one to ten writes. The duty cycle is set to ten by default, meaning that ten writes occur for each read operation.
Although the application is performing a large number of continuous writes, it must be ensured that read data is still
given time to process. A setting of one results in one read operation for every write operation. If there are no write
operations to perform, reads are processed continuously. This allows optimization for applications with continuous
writes versus a more balanced back and forth data flow.
Note: It is recommended that the application be characterized for compatibility with the write optimization
enhancements before being used in a production environment.
www. ptc.com
7 Advanced Simulator Driver
l Replace with Zero: This option allows a driver to replace non-normalized IEEE-754 floating point values
with zero before being transferred to clients.
l Unmodified: This option allows a driver to transfer IEEE-754 denormalized, normalized, non-number, and
infinity values to clients without any conversion or changes.
Note: This property is disabled if the driver does not support floating-point values or if it only supports the option
that is displayed. According to the channel's float normalization setting, only real-time driver tags (such as values
and arrays) are subject to float normalization. For example, EFM data is not affected by this setting.
For more information on the floating-point values, refer to "How To ... Work with Non-Normalized Floating-Point
Values" in the server help.
Inter-Device Delay: Specify the amount of time the communications channel waits to send new requests to the
next device after data is received from the current device on the same channel. Zero (0) disables the delay.
Note: This property is not available for all drivers, models, and dependent settings.
Data Source
This property is used to select a Data Source Name (DSN). A DSN must be created and configured for a data
source before it will appear in this list and the ODBC database. For information on how to do so, follow the instruc-
tions below.
1. To start, Click the Data Source property to get the Data Source Selection pop up.
2. Click Configure DSN to open the Microsoft® ODBC Data Source Administrator.
3. Select either the User DSN or System DSN tab. Data source types are local to the computer: the User
DSN is user-dedicated, whereas the System DSN can be accessed by any user with privileges.
5. Once a DSN has been configured successfully, it appears in the Data Source drop-down menu.
Login Timeout
This property specifies the number of seconds that the server will wait for a response before timing out when
attempting to connect to the ODBC data source. The default setting is 5 seconds. The range is 1-99999 seconds.
www. ptc.com
Advanced Simulator Driver 8
Identification
Name: Specify the name of the device. It is a logical user-defined name that can be up to 256 characters long and
may be used on multiple channels.
Note: Although descriptive names are generally a good idea, some OPC client applications may have a limited
display window when browsing the OPC server's tag space. The device name and channel name become part of
the browse tree information as well. Within an OPC client, the combination of channel name and device name
would appear as "ChannelName.DeviceName".
For more information, refer to "How To... Properly Name a Channel, Device, Tag, and Tag Group" in server help.
Channel Assignment: Specify the user-defined name of the channel to which this device currently belongs.
Model: Specify the type of device that is associated with this ID. The contents of the drop-down menu depend on
the type of communications driver being used. Models that are not supported by a driver are disabled. If the com-
munications driver supports multiple device models, the model selection can only be changed when there are no cli-
ent applications connected to the device.
Note: If the communication driver supports multiple models, users should try to match the model selection to the
physical device. If the device is not represented in the drop-down menu, select a model that conforms closest to the
target device. Some drivers support a model selection called "Open," which allows users to communicate without
knowing the specific details of the target device. For more information, refer to the driver documentation.
ID: Specify the device's driver-specific station or node. The type of ID entered depends on the communications
driver being used. For many communication drivers, the ID is a numeric value. Drivers that support a Numeric ID
provide users with the option to enter a numeric value whose format can be changed to suit the needs of the applic-
ation or the characteristics of the selected communications driver. The format is set by the driver by default.
Options include Decimal, Octal, and Hexadecimal.
Note: If the driver is Ethernet-based or supports an unconventional station or node name, the device's TCP/IP
address may be used as the device ID. TCP/IP addresses consist of four values that are separated by periods, with
each value in the range of 0 to 255. Some device IDs are string based. There may be additional properties to con-
figure within the ID field, depending on the driver.
Operating Mode
www. ptc.com
9 Advanced Simulator Driver
Data Collection: This property controls the device's active state. Although device communications are enabled by
default, this property can be used to disable a physical device. Communications are not attempted when a device is
disabled. From a client standpoint, the data is marked as invalid and write operations are not accepted. This prop-
erty can be changed at any time through this property or the device system tags.
Simulated: Place the device into or out of Simulation Mode. In this mode, the driver does not attempt to com-
municate with the physical device, but the server continues to return valid OPC data. Simulated stops physical com-
munications with the device, but allows OPC data to be returned to the OPC client as valid data. While in
Simulation Mode, the server treats all device data as reflective: whatever is written to the simulated device is read
back and each OPC item is treated individually. The data is not saved if the server removes the item (such as when
the server is reinitialized). The default is No.
Notes:
1. Updates are not applied until clients disconnect and reconnect.
2. The System tag (_Simulated) is read only and cannot be written to for runtime protection. The System tag allows
this property to be monitored from the client.
3. In Simulation mode, the item's memory map is based on client update rate(s) (Group Update Rate for OPC clients
or Scan Rate for native and DDE interfaces). This means that two clients that reference the same item with dif-
ferent update rates return different data.
4. When a device is simulated, updates may not appear faster than one (1) second in the client.
Simulation Mode is for test and simulation purposes only. It should never be used in a production environment.
Tag Counts
Static Tags: Provides the total number of defined static tags at this level (device or channel). This information can
be helpful in troubleshooting and load balancing.
Scan Mode: Specify how tags in the device are scanned for updates sent to subscribing clients. Descriptions of the
options are:
l Respect Client-Specified Scan Rate: This mode uses the scan rate requested by the client.
l Request Data No Faster than Scan Rate: This mode specifies the value set as the maximum scan rate.
The valid range is 10 to 99999990 milliseconds. The default is 1000 milliseconds.
Note: When the server has an active client and items for the device and the scan rate value is increased,
the changes take effect immediately. When the scan rate value is decreased, the changes do not take
effect until all client applications have been disconnected.
l Request All Data at Scan Rate: This mode forces tags to be scanned at the specified rate for subscribed
clients. The valid range is 10 to 99999990 milliseconds. The default is 1000 milliseconds.
www. ptc.com
Advanced Simulator Driver 10
l Do Not Scan, Demand Poll Only: This mode does not periodically poll tags that belong to the device nor
perform a read to get an item's initial value once it becomes active. It is the OPC client's responsibility to
poll for updates, either by writing to the _DemandPoll tag or by issuing explicit device reads for individual
items. For more information, refer to "Device Demand Poll" in server help.
l Respect Tag-Specified Scan Rate: This mode forces static tags to be scanned at the rate specified in
their static configuration tag properties. Dynamic tags are scanned at the client-specified scan rate.
Initial Updates from Cache: When enabled, this option allows the server to provide the first updates for newly activ-
ated tag references from stored (cached) data. Cache updates can only be provided when the new item reference
shares the same address, scan rate, data type, client access, and scaling properties. A device read is used for the
initial update for the first client reference only. The default is disabled; any time a client activates a tag reference the
server attempts to read the initial value from the device.
A number of tags are automatically generated in the server's tag database depending on the number of fields in the
selected table. An internal control tag is also generated to access data.
Automatic Looping
When enabled, this property causes the driver to start reading from the first record when the last record is reached.
When unchecked, the driver will stop at the last record.
www. ptc.com
11 Advanced Simulator Driver
Address Descriptions
Tag validation will only occur when a tag is requested by a client application. If a link to the ODBC data source can-
not be made by the driver or the address that the tag references cannot be resolved by the driver (meaning that the
address cannot be mapped to the data set in the ODBC data source) then the tag's data quality will be set to bad.
The appropriate error message will be placed in the OPC server's event log.
www. ptc.com
Advanced Simulator Driver 12
Error Descriptions
The following messages may be generated. Click on the link for a description of the message.
Address Validation
Missing address.
Device address <address> contains a syntax error.
Data Type <type> is not valid for device address <address>.
Device address <address> is read only.
Array support is not available for the specified address: <address>.
Runtime
Unable to connect to data source on channel <channel name>.
Unable to open recordset on device <device name>.
Unable to query recordset on device <device name>.
Unable to retrieve database value for tag <tag address> on device <device name>.
Unable to read internal tag <tag address> on device <device name>.
Unable to write to internal tag <tag address> on device <device name>.
Data source <data source name> is configured as Read Only (all writes will be rejected).
Missing address.
Error Type:
Warning
Possible Cause:
A tag address that has been specified statically has no length.
Solution:
Re-enter the address in the client application.
Possible Cause:
A tag address that has been specified statically contains one or more invalid characters.
Solution:
1. Re-enter the address in the client application if the address is dynamic.
www. ptc.com
13 Advanced Simulator Driver
Possible Cause:
A tag address that has been specified statically has been assigned an invalid data type.
Solution:
Modify the requested data type in the client or server application.
Possible Cause:
A tag address accessed by the client has requested an access mode that is not compatible with what the data
source supports for that address.
Solution:
Change the access mode in the client application, Device Properties or under the actual tag in the server's tag data-
base.
Note:
Some data sources do not support Write access, whereas others support it for specific items only.
Possible Cause:
A tag address that has been specified statically contains an array reference for an address type that doesn't sup-
port arrays.
Solution:
1. Re-enter the address in the client application to remove the array reference.
Possible Cause:
A tag that has been specified as read only cannot be written to.
Solution:
N/A
Possible Cause:
1. The ODBC data source is not available.
www. ptc.com
Advanced Simulator Driver 14
Solution:
1. Verify that the ODBC data source is configured properly and that it is accessible by the user or from a
remote machine.
2. Verify that the ODBC data source contains at least one table.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Possible Cause:
1. The ODBC data source is not available.
2. The ODBC data source table does not contain any columns.
Solution:
1. Verify that the ODBC data source is configured properly and that it is accessible by the user or from a
remote machine.
2. Verify that the ODBC data source table contains at least one column.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Possible Cause:
1. The ODBC data source is not available.
2. The ODBC data source table does not contain any records.
Solution:
1. Verify that the ODBC data source is configured properly and that it is accessible by the user or from a
remote machine.
2. Verify that the ODBC data source table contains at least one record.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Possible Cause:
www. ptc.com
15 Advanced Simulator Driver
2. The ODBC data source is not accessible based on user name and password.
Solution:
1. Verify that the ODBC data source is configured properly and that it is accessible by the user or from a
remote machine.
2. Verify that the authentication settings are properly configured in the data source (if applicable).
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
See Also:
Data Source Authentication
Data source <data source name> is configured as Read Only (all writes will be
rejected).
Error Type:
Serious
Possible Cause:
The ODBC data source is configured such that writes are not allowed.
Solution:
This should not create any trouble as all the tags are Read Only.
Possible Cause:
1. The ODBC data source is not available.
2. The ODBC data source is not accessible based on user name and password.
Solution:
1. Verify that the ODBC data source is configured properly and that it is accessible by the user or from a
remote machine.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Possible Cause:
www. ptc.com
Advanced Simulator Driver 16
Solution:
Verify that the ODBC data source is accessible by the user or from a remote machine.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Unable to retrieve database value for tag <tag address> on device <device
name>.
Error Type:
Serious
Possible Cause:
1. The ODBC data source is no longer available.
2. The tag represents an address that cannot be resolved into a value available from the data source.
Solution:
1. Verify that the ODBC data source is accessible by the user or from a remote machine.
2. Verify that the tag represents an address that is supported by the data source and/or access method.
Possible Cause:
The internal tag depends on a successful response from the ODBC data source which is no longer available.
Solution:
Verify that the ODBC data source is still accessible by the user or from a remote machine.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
Possible Cause:
The internal tag depends on a successful response from the ODBC data source which is no longer available.
Solution:
Verify the ODBC data source is still accessible by the user or from a remote machine.
Note:
The ODBC Specific Error returned by the ODBC data source driver contains specific information on the cause of
the problem.
www. ptc.com
17 Advanced Simulator Driver
Index
Address Descriptions 11
Address Validation 12
Advanced Simulator 3
Advanced Simulator Driver 3-4
Advanced Simulator Driver Help 3
Advanced Simulator Driver Specific Messages 12
Array support is not available for the specified address: <address>. 13
Channel Assignment 8
Channel Properties — Advanced 6
Channel Properties — General 5
Channel Properties — Write Optimizations 6
Communication Protocol 4
Data Collection 9
Data source <data source name> is configured as Read Only (all writes will be rejected). 15
Data Source Settings 7
Data Type <type> is not valid for device address <address>. 12
Data Types Description 11
Device address <address> contains a syntax error. 12
Device address <address> is read only. 13
Device Properties — General 8
Device Status Messages 12
Diagnostics 5
Do Not Scan, Demand Poll Only 10
Driver 8
Duty Cycle 6
DWord 11
Error Descriptions 12
External Dependencies 4
www. ptc.com
Advanced Simulator Driver 18
General 8
Help Contents 3
ID 8
Identification 5, 8
Initial Updates from Cache 10
Inter-Device Delay 7
MDAC 4
Microsoft Data Access Components 4
Missing address. 12
Model 8
Name 8
Non-Normalized Float Handling 6
ODBC API 4
Operating Mode 8
Optimization Method 6
Overview 3
www. ptc.com
19 Advanced Simulator Driver
Scan Mode 9
Setup 4
Simulated 9
String 11
Supported ODBC Data Sources 4
Table Selection 10
Tag Counts 5, 9
Timing 10
www. ptc.com