GE iFIX

Simulation 2 Driver

Version 5.8, SP2

December 2016
Disclaimer of Warranties and Liability

The information contained in this manual is believed to be accurate and reliable. However, GE Intelligent Platforms,
Inc. assumes no responsibilities for any errors, omissions or inaccuracies whatsoever. Without limiting the foregoing,
GE Intelligent Platforms, Inc. disclaims any and all warranties, expressed or implied, including the warranty of mer-
chantability and fitness for a particular purpose, with respect to the information contained in this manual and the
equipment or software described herein. The entire risk as to the quality and performance of such information, equip-
ment and software, is upon the buyer or user. GE Intelligent Platforms, Inc. shall not be liable for any damages, includ-
ing special or consequential damages, arising out of the use of such information, equipment and software, even if GE
Intelligent Platforms, Inc. has been advised in advance of the possibility of such damages. The use of the information
contained in the manual and the software described herein is subject to GE Intelligent Platforms, Inc. standard
license agreement, which must be accepted by the buyer or user before the use of such information, equipment or
software.

Trademark Notices

© 2016, General Electric Company. All rights reserved.

Proficy is a trademark of GE Intelligent Platforms, Inc., a wholly-owned subsidiary of General Electric Company.

* Indicates a trademark of General Electric Company and/or its subsidiaries.

All other product names and marks identified throughout this book are trademarks or registered trademarks of their
respective companies. They are used throughout this book in editorial fashion only. No such use, or the use of any
trade name, is intended to convey endorsement or affiliation.

No part of this publication may be reproduced in any form, or stored in a database or retrieval system, or transmitted
or distributed in any form by any means, electronic, mechanical photocopying, recording or otherwise, without the
prior written permission of GE Intelligent Platforms. Information contained herein is subject to change without notice.

We want to hear from you. If you have any comments, questions, or suggestions about our documentation, send them
to the following email address:

[email protected]
Table of Contents

Simulation 2 Driver 2

SM2 Driver Features 3

Accessing SM2 Registers 5

To use the SM2 register: 5

Generating Bad Data 6

Understanding Alarm Statuses 7

Index 9

© 2016 General Electric Company. All rights reserved. i

© 2016 General Electric Company. All rights reserved. 1
Simulation 2 Driver

The Simulation 2 (SM2) driver provides a matrix of addresses that lets you test your process database to
learn how its block and chains respond to different conditions. You can also use the SM2 driver with a C
application to extract data from legacy systems and store it in a process database.

The SM2 driver has no driver configuration program so no configuration of the driver is required. Instead,
you specify the SM2 address you want to use in a database block's I/O Address field and then place the
block on scan. To learn more about using SM2 addresses, refer to Accessing SM2 Registers.

The SM2 driver supports the following HMI software products:

l FIX for Windows NT version 6.15 or greater.

l iFIX version 2.5 or greater.

2 © 2016 General Electric Company. All rights reserved.

 SM2 Driver Features

The SM2 driver is similar to the SIM driver supplied with your FIX and iFIX software. Both drivers:

l Provide a matrix of addresses that database blocks can read from and write to.
l Support analog and digital database blocks.
l Support text blocks.

However, the SM2 driver differs from the SIM driver in several important ways:

The SM2 driver... The SIM driver...

Provides three independent sets of Provides one set of registers shared by both analog, digital,
registers. Analog blocks automatically and text blocks.
access the analog registers, digital blocks
automatically use the digital registers, and
Text blocks automatically access the text
registers.
Changing a register in one set does not Changing an analog register in the SIM driver modifies the
change the same register in the other set. register for analog, digital, and text reads. For example, if
For example, if you change the value of the you change the value of the analog register 1000, you also
analog register 1000, the value of the modify the value of the same digital register.
digital register 1000 is unchanged.
Provides 20,000 analog, 20,000 16-bit Provides 2000 analog and digital registers, a total of 32,000
digital registers, and 20,000 text registers. bits.
Stores analog values in 64-bit floating point Stores analog values in 16-bit integer registers, numbered 0
registers, numbered 0 to 19999. Incoming to 2000. Incoming 32-bit values are scaled to 16-bit values
values are not scaled. (0 - 65535).
Digital values are stored in 16-bit integer Digital values are stored in 16-bit integer registers,
registers, numbered 0 to 19999. numbered 0 to 2000.
Text values are stored in 8-bit registers Text values are stored in the same area as analog and
numbered 0 to 19999. Each register holds digital values, numbered 0 to 2000.
one text character for a total of 20,000
bytes of text.
Provides a register to simulate com- Cannot simulate communication errors. However, the SIM
munication errors. driver does provide registers RA through RK and RX through
RZ to generate random numbers. For more information,
refer to the Using Signal Generation Registers in the SIM
Driver section Building a SCADA System electronic book.
Supplies a C API that allows applications to Does not support a C API for accessing SIM values.
access SM2 analog, digital, and text values.
Supports exception-based processing. Does not support exception-based processing.
Supports latched data for Analog Input, Ana- Does not support latched data.
log Alarm, Digital Input, Digital Alarm and
Text blocks when a simulated com-
munication error is enabled.
Can read and write the individual alarm Cannot read and write the individual alarm status of any SIM

© 2016 General Electric Company. All rights reserved. 3

 status of each SM2 register. register.
Does not provide alarm counters. Provides alarm counters that show the general alarm state
of a SCADA server. For more information, refer to the Using
Alarm Counters chapter of the Implementing Alarms and
Messages electronic book.

Obviously, you can use the SIM driver for many of the same tasks as the SM2 driver. However, you may
prefer to use the SM2 driver when one or more of the following conditions occur:

l You have more test data than the SIM driver can hold.
l You want to determine how the database responds to 32-bit values.
l You need to access the driver from a C program.

4 © 2016 General Electric Company. All rights reserved.

 Accessing SM2 Registers

The SM2 driver matrix consists of three independent sets of registers: one for analog values, one for digital
values, and one for text values. Analog database blocks read from and write to analog registers only. Once
a block writes a value, other analog blocks can read the value from the register written to. Digital data-
base blocks work the same way, reading and writing from the digital registers. FIX (or iFIX) clears all SM2
values when FIX or iFIX starts.

The SM2 driver does not use the Hardware Options or Signal Conditioning fields.

To use the SM2 register:

1. Enter SM2 in the primary block's Device field.
2. Complete the I/O Address field with the following syntax:
For Analog values: register
For Digital values: register:bit
For Text values: register

SM2 Address Examples

Analog Examples Digital Examples Text Examples
1000 5000:10 2000
16435 23:15 10000

© 2016 General Electric Company. All rights reserved. 5

Generating Bad Data

The SM2 driver provides an S register to simulate a communication error. Using this register, all analog
and digital reads return an error as if communication to the process hardware has been lost.

To use this feature, set the S register to 1.

NOTE: The SM2 driver latches data when a simulated communication error is enabled.

6 © 2016 General Electric Company. All rights reserved.

 Understanding Alarm Statuses

iFIX and FIX can process alarm status information from I/O drivers. This information complements the
alarms generated by iFIX and FIX database blocks. When an alarm is returned from a driver, iFIX and FIX
compares the driver alarm against the block alarm. The alarm with the higher severity is used as the block
alarm and the other alarm is ignored.

iFIX defines the following alarms with the following severity:

Severity Alarm Status Description

16 (highest) IA_COMM Communication error ("BAD" value).
16 (highest) IA_IOF General I/O failure.
16 (highest) IA_OCD Open circuit.
16 (highest) IA_URNG Under range (clamped at 0).
16 (highest) IA_ORNG Over range (clamped at MAX).
16 (highest) IA_RANG Out of range (value unknown).
16 (highest) IA_DEVICE Device failure.
16 (highest) IA_STATION Station failure.
16 (highest) IA_ACCESS Access denied (privilege).
16 (highest) IA_NODATA On poll, but no data yet.
16 (highest) IA_NOXDATA Exception item, but no data yet.
16 (highest) IA_MANL Special code for MANL/MAINT (for inputs).
8 IA_FLT Floating point error.
8 IA_ERROR General block error.
8 IA_ANY Any block alarm.
8 IA_NEW New block alarm.
7 IA_HIHI The block is in the HIHI alarm state (High High).
7 IA_LOLO The block is in the LOLO alarm state (Low Low).
7 IA_COS Change of state.
7 IA_CFN Change From Normal (Digital block only).
7 IA_TIME Time-out alarm.
7 IA_SQL_LOG Not connected to database.
6 IA_HI The block is in the HI alarm state (High).
6 IA_LO The block is in the LO alarm state (Low).
6 IA_RATE Value exceeds rate of change setting since last scan period.
6 IA_SQL_CMD SQL command not found or invalid.
5 IA_DEV Deviation from the set point.
5 IA_DATA_MATCH SQL command does not match data list.
4 IA_FIELD_READ Error reading tag values.
4 IA_FIELD_WRITE Error writing tag values.
1 IA_DSAB Alarms disabled.
0 (lowest) IA_OK The block is in normal state.

© 2016 General Electric Company. All rights reserved. 7

FIX defines the following alarms with the following severity:

Severity Alarm Status Description

16 (highest) IA_COMM Communication error ("BAD" value).
7 IA_HIHI The block is in the HIHI alarm state (High High).
7 IA_LOLO The block is in the LOLO alarm state (Low Low).
7 IA_CFN Change From Normal (Digital block only).
6 IA_HI The block is in the HI alarm state (High).
6 IA_LO The block is in the LO alarm state (Low).
6 IA_RATE Value exceeds rate of change setting since last scan period.
5 IA_DEV Deviation from the set point.
0 (lowest) IA_OK The block is in normal state.

Using the preceding tables, you can see that if a driver returns a HIHI alarm to a block that is in HI alarm,
iFIX or FIX changes the alarm state to HIHI because the driver alarm is more severe. However, if the
alarms are of equal severity, iFIX or FIX does not change the alarm state of the block. For example, if the
block is in HI alarm and the driver returns a LO alarm, the block's alarm state does not change because
both alarms have equal severity. Once an operator acknowledges the HI alarm, iFIX or FIX changes the
block's alarm state.
NOTE: If you set a communication error to the S register with the SetCommError function, then all SM2 registers
show a COMM alarm status. When examining the alarm status of text, only the status of the first character (byte)
is read. You can control the alarm status functions of the SM2 driver using its C API only. Refer more information
about this API, refer to the Using the SM2 C API section.

8 © 2016 General Electric Company. All rights reserved.

 Index SM2 driver 3

addresses 4

compared to SIM driver 2

A
exception-based processing support 2
accessing SM2 registers 5
features 3
addresses 4
when to use 2
alarm status list 6
SM2 features 2
analog blocks 2
T
C
text blocks 3
communication errors 5

connecting to the database 4 U

understanding alarm statuses 7

D

digital blocks 3

exception-based processing 3

features 3

generating bad data 6

introducing the Simulation 2 Driver 1

latched data 3, 5

S register 6

SIM driver 3

simulating communication errors 2, 5

© 2016 General Electric Company. All rights reserved. 9