MISTIC_B DDE Server. for Microsoft Windows and InTouch Applications. User Manual Ver 3.x Rev 2.3 DR DR

Transcription

1 MISTIC_B DDE Server for Microsoft Windows and InTouch Applications User Manual Ver 3.x Rev 2.3 DR DR KLINKMANN AUTOMATION P.O. Box 38 FIN Helsinki Finland tel. int fax int

2 Klinkmann Automation MISTIC_B DDE Server i Table Of Contents What is DDE?... 1 Accessing a Remote DDE Item from MISTIC_B... 2 Installing the MISTIC_B DDE Server... 2 Connection Cable... 4 Configuring the MISTIC_B Server... 4 DDE Server Settings Command... 5 Configure Comm Port Command... 6 Saving MISTIC_B Configuration File... 8 Configuration File Location... 8 Configure Brick Command... 9 Configure Topic Command Using the MISTIC_B Server with InTouch Defining the Tag names Brick STATUS Item Item (Point) Naming Brick Setup Commands SET RESPONSE DELAY command...18 SET FREQUENCY RESOLUTION command...18 SET TEMPERATURE UNITS command...18 SET COMM LINK WATCHDOG command...19 SET COMM. LINK WATCHDOG TIME-OUT DATA command...19 STORE SYSTEM CONFIGURATION command...20 Digital Read/Write and Latch Commands DIGITAL MODULE STATUS commands...21 DIGITAL LATCH GROUP commands...21 DIGITAL LATCH commands...22 DIGITAL COUNTER and FREQUENCY COMMANDS DIGITAL FREQUENCY MEASUREMENT GROUP command...24 DIGITAL FREQUENCY MEASUREMENT command...24 DIGITAL 32BIT COUNTER GROUP command...24 DIGITAL 32BIT COUNTER command...25 COUNTER ENABLE command...25 COUNTER CLEAR command...25 DIGITAL TIME DELAY, PULSE OUTPUT COMMANDS GENERATE N PULSES command...26 OUTPUT TIMER COUNTER command...26 TIME PROPORTIONAL OUTPUT (TPO) commands...27 START CONTINUOUS SQUARE WAVE command...27 START OFF PULSE command...28 START ON PULSE command...28 DIGITAL PULSE/PERIOD MEASUREMENT COMMANDS BIT PULSE/PERIOD GROUP commands BIT PULSE/PERIOD commands...29 PULSE/PERIOD COMPLETE STATUS commands...30 ANALOG I/O CONFIGURATION COMMANDS CALCULATE AND SET ADC MODULE OFFSET command...30 CALCULATE AND SET ADC MODULE GAIN command...30 SET ADC MODULE OFFSET command...31 SET ADC MODULE GAIN command...31 SET AVERAGING SAMPLE WEIGHT command...31 SET TOTALIZATION SAMPLE RATE command...31

3 Klinkmann Automation MISTIC_B DDE Server ii SET TPO RESOLUTION command...32 SET ENGINEERING UNIT SCALING PARAMETERS command...32 RAMP DAC TO ENDPOINT command...32 READ AND CLEAR I/O MODULE DATA command...33 READ AND CLEAR I/O MODULE DATA - GROUP command...34 I/O MODULE MAGNITUDE command...34 I/O MODULE MAGNITUDE - GROUP command...34 ANALOG PID LOOP COMMANDS INITIALIZE PID command...35 READ ALL PID LOOP PARAMETERS commands...36 READ PID LOOP PARAMETER command...37 SET/RESET PID LOOP CONTROL OPTIONS command...37 SET PID PARAMETERS commands...39 DIGITAL AND ANALOG EVENT REACTION COMMANDS CLEAR EVENTS commands...40 ENABLE/DISABLE EVENT GROUP commands...40 EVENT ENABLE/DISABLE STATUS commands...41 READ EVENT LATCHES commands...41 READ AND CLEAR EVENT LATCHES commands...42 READ EVENT DATA HOLDING BUFFER commands...42 READ EVENT TABLE ENTRY commands...42 SET EVENT ON COMM LINK WATCHDOG TIME-OUT command...44 SET EVENT ON MOMO MATCH commands...44 SET EVENT ON MORE and SET EVENT ON LESS commands...45 SET NULL REACTION command...45 ENABLE/DISABLE EVENT TABLE ENTRY REACTION commands...46 ENABLE/DISABLE EVENT ENTRY GROUP REACTION commands...46 SET OUTPUT MODULE STATE REACTION commands...47 START ON PULSE REACTION commands...47 START OFF PULSE REACTION commands...48 ENABLE DISABLE COUNTER REACTION commands...48 CLEAR COUNTER REACTION command...48 READ AND HOLD COUNTER/TIMER VALUE command...49 SET DAC MODULE MAGNITUDE COUNTS REACTION command...49 SET DAC MODULE MAGNITUDE ENGINEERING UNITS REACTION command...49 RAMP DAC OUTPUT TO ENDPOINT REACTION commands...50 ENABLE/DISABLE PID LOOP REACTION commands...50 SET PID LOOP SETPOINT REACTION commands...50 READ AND HOLD I/O DATA REACTION command...51 SET PID LOOP MIN-MAX OUTPUT LIMITS REACTION commands...51 Notes on Using Microsoft Excel Reading Values into Excel Spreadsheets Writing Values to MISTIC_B Points Troubleshooting WIN.INI entries Troubleshooting menu... 55

4 Klinkmann Automation MISTIC_B DDE Server 1 MISTIC_B DDE Server The MISTIC_B DDE Server is a Microsoft Windows 32-bit application program that acts as a DDE (Dynamic Data Exchange) Server and allows other Windows application programs access to the data from mistic Model 200 I/O Remote Units (Bricks). The MISTIC_B DDE Server requires an OPTO 22 AC37 adapter card to communicate with the OPTO 22 Remote I/O Bus. Through the OPTO 22 Remote I/O Bus the Server can access up to 256 individual units (Digital or Analog Bricks) on a single serial link for a total of 4096 digital and/or analog I/O points. The Server is primarily intended for use with Wonderware InTouch, but it may be used by any Microsoft Windows program that is capable of acting as a DDE Client. What is DDE? DDE is a complete communication protocol designed by Microsoft to allow applications in the Windows environment to send/receive data and instructions to/from each other. It implements a client-server relationship between two concurrently running applications. The server application provides the data and accepts requests from any other application interested in its data. Requesting applications are called clients. Some applications such as InTouch and Excel can simultaneously be both a client and a server. In order to obtain data from another application the client program opens a channel to the server application by specifying three things: the server application name, the topic name and the specific item name. For example, in the case of Excel, the application name is Excel, the topic name is the name of the specific spreadsheet that contains the data and the item name is the specific cell on the spreadsheet. With InTouch the application name is View, the topic name is the word Tag name when reading/writing an InTouch tag name and the item name is a specific tag name in the InTouch Data Dictionary. When a client application sets up a link to another DDE program, it requests the server application to advise the client whenever a specific item s value changes. These data links will remain active until either the client or server program terminates the link or the conversation. They are very efficient means of exchanging data because once the link has been established no communication occurs until the specified data value changes. InTouch uses DDE to communicate with I/O device drivers and other DDE application programs.

5 Klinkmann Automation MISTIC_B DDE Server 2 Accessing a Remote DDE Item from MISTIC_B The DDE protocol identifies an element of data by using a three-part address, including: Application, Topic and Item. Application refers to the name of the Windows program (server) that knows how to access the data element. In the case of data coming from or going to mistic Model 200 hardware, the application portion of the DDE address is MISTIC_B. Topic is an application-specific sub-group of data elements. The MISTIC_B Server considers each Brick to be a separate topic. The user creates meaningful names for the Brick and uses these names as the topic names for DDE references. Note: In some cases, the term node is used interchangeably with the term topic. Item indicates a specific data element within the specified topic. With the MISTIC_B Server, an item is an individual point on a Brick. (The item/point names are fixed by the MISTIC_B Server as described in the Item (Point) Naming section.) Note: In some cases, the term point is used interchangeably with the term item. Installing the MISTIC_B DDE Server The MISTIC_B DDE Server installation package can be supplied: 1. As a self-extracting archive 05016xxx.EXE if downloaded from Klinkmann s web site (the xxx is the current (latest) version of the Server). 2. From installation on CD. 3. On two or three distribution disks (floppies). To install the MISTIC_B DDE Server from the self-extracting archive, run the 05016xxx.EXE and proceed as directed by the MISTIC_B DDE Server Setup program. To install the MISTIC_B DDE Server from CD or distribution disk, on MS Windows (NT, 2000, ME or 95(98)): 1. Insert the CD with Klinkmann Software into CD drive or insert MISTIC_B Disk1 into a floppy drive A: or B:. 2. Select the Run command under the Start menu. 3. Run STARTUP.EXE if installing from CD or SETUP.EXE if installing from distribution disks (floppies). 4. If installing from CD: select Protocol Servers (DDE, SuiteLink, OPC), find MISTIC B DDE Server and click on Setup. 5. Proceed as directed by the MISTIC_B DDE Server Setup program. When installation is finished, the subdirectory specified as a folder where to install the MISTIC_B DDE Server will contain the following files: MISTIC_B.EXE MISTIC_B.HLP The MISTIC_B Server Program. This is a Microsoft Windows 32-bit application program. The MISTIC_B Server Help file.

6 Klinkmann Automation MISTIC_B DDE Server 3 MISTIC_B.CFG LICENSE.TXT WWCOMDLG.DLL An example configuration file. Klinkmann Automation software license file. Dynamic Link Library necessary for MISTIC_B Server. To uninstall the MISTIC_B Server, start Control Panel, select Add/Remove Programs and select the MISTIC_B DDE Server from the list of available software products. Click on Add/Remove and proceed as directed by the UnInstallShield program. Note: The HASP key is needed for full time running of MISTIC_B Server. The HASP Driver setup is performed during the Server setup. Without HASP Driver installed, the MISTIC_B Server will run only 1 hour (with all features enabled).

7 Klinkmann Automation MISTIC_B DDE Server 4 Connection Cable The following cable diagram must be used to connect the mistic Model 200 I/O Remote Units (Bricks) to the OPTO 22 AC37 adapter card: PC AC 37 MISTIC Bricks Super Serial Card RS485 2 wire 9 - pin connector TERM YES GND 4 DATA+ 8 DATA+ 5 DATA- 9 DATA- GND TX/RX+ TX/RX- Configuring the MISTIC_B Server After the MISTIC_B Server is initially installed, a little of configuration is required. Configuring the Server automatically creates a MISTIC_B.CFG file which holds all of the topic (Brick) definitions entered, as well as the communication port configurations. This file will be automatically placed in the same directory in which MISTIC_B is located unless the path where the configuration file will be placed is specified via the /Configure/DDE Server Settings... command. To perform the required configurations, start up the MISTIC_B program. If the Server starts up as an icon, double-click on the icon to open the server s window. The following will appear: To access the commands used for the various configurations, open the /Configure menu:

8 Klinkmann Automation MISTIC_B DDE Server 5 DDE Server Settings Command A number of parameters that control the internal operation of the Server can be set. In most cases, the default settings for these parameters provide good performance and do not require changes. However, they can be changed to the fine-tune Server for a specific environment. To change the Server s internal parameters, invoke the DDE Server Settings... command. The DDE Server Settings dialog box will appear: The following describes each field in this dialog box: Protocol Timer Tick This field is used to change the frequency at which the Server checks for work to do (at this frequency the Server tries to send one data request to mistic Brick and receive one reply; if the send/response cycle is too long then more than one activation of Server is necessary to process it). Considering Windows 3.x if computer is too busy or some other MS Windows application is taking over the computer the Server is activated more rarely than set in the Protocol Timer Tick. Note: The default value is 50. This it the minimum value for Windows 3.x. If the value is lower than 50 entered, the Server uses 50 milliseconds. NetDDE being used Select this option, if you are in network using NetDDE. Configuration File Directory This field is used to specify the path (disk drive and directory) in which MISTIC_B will save its current configuration file. The MISTIC_B Server will use this path to load the configuration file the next time it is started. Note: Only the path may be modified with this field. The configuration file is always named MISTIC_B.CFG. Note: There is no limit to the number of configuration files created, although each must be in a separate directory. When using the MISTIC_B Server with InTouch, it is a good practice to place the configuration file in the application directory. Once all entries have been made, click on OK.

9 Klinkmann Automation MISTIC_B DDE Server 6 Configure Comm Port Command To configure the computer serial port used to communicate with mistic Bricks, invoke the Com Port Settings... command. Communication Port Settings dialogue box will appear: The following describes each this dialogue box field: Com Port This field is used to select a communication port. Note: The default Com port is COM1. Base Address This field is used to enter the selected base address of the communication port. If AC37 adapter card is used then Base Address must be consistent with the base address selected on the AC37 card. Attention should be paid to selecting a base address which would not conflict with other devices in the system. Note: The default values are: 3F8H for COM1, 2F8H for COM2, 348H for COM3, 340H for COM4, 248H for COM5 and 240 for COM6. Interrupt Specifies the IRQ number for current port. Note: Interrupt is used only for Windows NT version. AC37 serial card Specifies if AC37 super serial card is used for current port. Use Win RT driver This field is enabled only for Microsoft Windows NT. Marking this check box causes the use of WinRT driver instead of the standard serial port driver. WinRT driver is automatically installed together with MISTIC_B DDE Server. If this check box is marked then correct Interrupt number and Base Address must be entered and they may not

10 Klinkmann Automation MISTIC_B DDE Server 7 conflict with other devices. The WinRT device driver must be used to communicate through the AC37 serial card. Note: Marking this check box causes the writing of new or updating old registry entry (HKEY_LOCAL_MACHINE "System\CurrentControlSet\Services\WinRT") in Windows NT registry for this port. Up to 25 keys are available in this registry. Other programs also can use the WinRT device driver and some of keys may be occupied. Therefore it is recommended to use this setting only for few Com ports. Reply Timeout This field is used to enter the amount of time (in seconds), all mistic Bricks using the selected communication port, will be given to reply to the commands from the Server. Note: The default value of 3 seconds should be sufficient for most configurations. Baud Rate Select the Baud Rate setting which matches with setting chosen for the mistic Network. (Refer to mistic Technical Reference Manual for Baud Rate selection instructions.) Checksum Specifies the method of data verification. There are two data verification methods supported: (1) 16-bit CRC. Four checksum characters are sent and received in ASCII protocol and two bytes in Binary protocol; this is default setting. (2) Modulo 256 (8 bit). Two checksum characters are sent in ASCII protocol and one byte in Binary protocol. Note: All mistic Model 200 I/O units (Bricks) connected to the current port must be configured with same data verification method. Protocol Specifies Binary (default and recommended choice) or ASCII protocol. When all entries have been made, select Done to process the configuration for the communication port. Notes: 1. If you are running Windows NT and you have made changes in WinRT settings, the Server tries to restart WinRT device driver. 2. The Administrator's access rights are required to configure the MISTIC_B DDE Server in Windows NT.

11 Klinkmann Automation MISTIC_B DDE Server 8 Saving MISTIC_B Configuration File If the configuration file does not currently exist, or a new configuration path has been specified, the Server will display the Saving MISTIC_B Configuration dialog box: This dialog box displays the path where the Server is going to save the current configuration file. The path may be changed if necessary. Also, the path can optionally be recorded in the WIN.INI file by selecting the Make this the default configuration option. Doing so will allow the MISTIC_B Server to find the configuration file automatically each time it is started. Configuration File Location When the MISTIC_B Server starts up, it first attempts to locate its configuration file by checking the WIN.INI file for a path which was previously specified. If the path is not present in the WIN.INI file, the Server will assume that the current working directory is to be used. To start the Server from the configuration file of application directory other than the default configuration file, a special switch (/d:) is used. For example, invoke the File/Run command and enter the following: MISTIC_B /d:c:\directoryname Note: There is no limit to the number of configuration files that may be created, although each must be in a separate directory.

12 Klinkmann Automation MISTIC_B DDE Server 9 Configure Brick Command The user provides each Brick with an arbitrary name used to associate topics with certain Brick. Each topic can communicate with one Brick and several topics can share the same Brick. To configure the Bricks you are to invoke Brick Settings... command. The Brick Configuration dialog box will appear: Click on New if you want to add a brick, Delete if you want to delete the selected brick or Modify if you want to view or modify the selected brick. If you select New or Modify buttons the following dialog box will appear: The following steps are performed to define the Topics (Bricks) attached to the mistic network:

13 Klinkmann Automation MISTIC_B DDE Server Select the Comm Port the Brick is connected to. 2. Enter an unique Brick name for current Comm port. 3. Enter a Brick address that corresponds to the jumper settings for this Brick. 4. Select the appropriate Brick type (Digital brick or Analog brick); 5. Select the Configuration Type for each channel (module) attached to this topic (Brick). To select a appropriate Configuration Type double click on one or several items of list box and make your choice from pop-up menu. The following are possible choices for Digital brick: Unused, Counter Input, Positive Pulse Measurement Input, Negative Pulse Measurement Input, Period Measurement Input, Frequency Measurement Input, Quadrature Counter Input, On Time Totalizer Input, Off Time Totalizer Input, Output

14 Klinkmann Automation MISTIC_B DDE Server 11 The following are possible choices for Analog brick: Unused, Generic Input, G4AD3 Input (4 to 20 ma), G4AD4 Input (ICTD), G4AD5 Input (Type J Thermocouple), G4AD6 Input (0 to 5 VDC), G4AD7 Input (0 to 10 VDC), G4AD8 Input (Type K Thermocouple), G4AD9 Input (0 to 50 mv), G4AD10 Input (100 Ohm RTD), G4AD11 Input (-5 to +5 VDC), G4AD12 Input (-10 to +10 VDC), G4AD13 Input (0 to 100 mv), G4AD14 Input (10 Ohm RTD), G4AD15 Input (28 to 140 VAC), G4AD16 Input (0 to 5 Amperes), G4AD17 Input (Type R Thermocouple), G4AD18 Input (Type T Thermocouple), G4AD19 Input (Type E Thermocouple), G4AD20 Input (0 to 4095 Hz), G4AD17 Input (Type S Thermocouple), G4AD24 Input (Type B Thermocouple), Generic Output, G4DA3 Output (4 to 20 ma), G4DA4 Output (0 to 5 VDC), G4DA5 Output (0 to 10 VDC), G4DA6 Output (-5 to +5 VDC), G4DA7 Output (-10 to +10 VDC), G4DA8 Output (0 to 20 ma), G4DA9 Output (Time Proportional Output) Note: Server's performance can be seriously decreased if not Unused Configuration Types are assigned to unused channels.

15 Klinkmann Automation MISTIC_B DDE Server 12 Configure Topic Command The user provides each Brick with an arbitrary name which is used as the DDE topic for all references to the Brick. The following steps are performed to define the Topics (Bricks) attached to the mistic network: 1. Invoke the Topic Definition... command. The Topic Definition dialog box will appear: 2. To modify an existing topic, select the topic name and click on Modify. To define a new topic, click on New. To remove an existing topic, click on Delete. The MISTIC_B Topic Definition dialog box will appear: 3. Enter the Topic Name which corresponds to the DDE Topic Name. (The DDE Topic Name is entered in the DDE Access Name Definition dialog box described in the Using the MISTIC_B Server with InTouch section.) 4. Click on the Com Port checkbox to associate a topic with the communication port. Note: Additional topics may be associated with the same communication port later. 5. Set the Update Interval field to indicate the frequency the items/points on this topic will be read (polled). The default value is 1000 milliseconds. 6. Choose the corresponding Mistic brick from the available ones configured at the Brick Configuration section. 7. Press the OK button.

16 Klinkmann Automation MISTIC_B DDE Server 13 Using the MISTIC_B Server with InTouch To access items/points on Analog or Digital Brick from InTouch, the following steps (all performed in WindowMaker) are required: To define the DDE Access Names in WindowMaker for each Brick invoke the /Special/DDE Access Names... command. The "DDE Access Name Definition" dialog box will appear. Click on Add. The Add DDE Access Name Dialogue Box will appear: Note: If Add is selected, this dialogue box will be blank when it initially appears. Data has been entered here to illustrate the entries which are made. The following three fields are required entries when entering a DDE Access Name Definition: DDE Access Name Enter an arbitrary name which will be used by InTouch to refer to the topic (Brick). It is recommended that the name defined for the topic (Brick) in MISTIC_B also is used here.)

17 Klinkmann Automation MISTIC_B DDE Server 14 DDE Application/Server Name Enter the application name MISTIC_B which is used by the DDE Server to access the Brick. DDE Topic Name Enter the name defined for the topic in MISTIC_B to identify the Brick the MISTIC_B Server will be accessing. Note: This usually will be the same as the DDE Access Name, although, if desired, they may be different. However, it must be the same name used as in the section Configuring the MISTIC_B Server when the topics were configured. Request Initial Data This option may be selected if the Server is other than a Wonderware DDE Server and the Server does not return data values immediately when a window is displayed. This option is not applicable to the MISTIC_B DDE Server. Wait for Change This option should be selected when the DDE application is the MISTIC_B DDE Server. Advise all Items This option may be selected if the Server is to poll for all data whether or not they are in visible windows, alarmed, logged or trended. Use of the option is not recommended. Advise only active Items Selecting this option will cause the MISTIC_B Server to poll only points in visible windows and points that are alarmed, logged or trended. Defining the Tag names To define the Tag names associated with the new DDE Access Name, invoke the /Special/Tag Name Dictionary command (in WindowMaker). The Dictionary - Tag Name Definition dialog box will appear: Click on New and enter the Tag Name. (The tag name defined here is the name InTouch will use. The MISTIC_B Server does not see this name.)

18 Klinkmann Automation MISTIC_B DDE Server 15 Select the tag type by clicking on the Type button. The Choose tag type dialog box will appear: To access MISTIC_B items, the type must be DDE Discrete, DDE Integer or DDE Real. Select the DDE type. The Details dialog box for the tag name will appear: Select the MISTIC_B topic (Brick) by clicking on the DDE Access Name... button. The Select a DDE Access Name dialog box will appear: Select the appropriate topic name and click on OK. (If the DDE Access Name has not been defined as previously described, click on New and define the DDE topic now.)

19 Klinkmann Automation MISTIC_B DDE Server 16 The Details dialog box will appear displaying the selected DDE Access Name: For integers and reals fill in the Min EU, Max EU, Min Raw and Max Raw fields. These fields control the range of values which will be accepted from the server and how the values are scaled. If no scaling is desired, Min EU should be equal to Min Raw and Max EU to Max Raw. Enter the MISTIC_B item/point name to be associated with this tag name in the Item field in the Details box: (Refer to the Item (Point) Naming section below for complete details.) Where applicable, the Use Tag name as Item Name option may be selected to enter automatically the tag name in this field. Note: The tag name can be used only if it follows the conventions listed in the Item (Point) Naming section. If all entries have been made, click on Save button (in the top dialog box) to accept the new tag name. To define additional Tag names click on the New button. To return to the WindowMaker main screen, select Done.

20 Klinkmann Automation MISTIC_B DDE Server 17 Brick STATUS Item For each Brick, there is a built-in discrete item which indicates the state of communication with the Brick. The discrete item (Status) is set to 0 when communication with the Brick fails and set to 1 when communication is successful. From InTouch the state of communication with the Brick may be read by defining a DDE Discrete tag name and associating it with the topic configured for the Brick and using Status as the Item name. From Excel, the status of the communications may be read by entering the following formula in a cell: =MISTIC_B topic!status

21 Klinkmann Automation MISTIC_B DDE Server 18 Item (Point) Naming Within the MISTIC_B Server, item/point naming depends on naming conventions of Digital and Analog mistic Bricks and supported read or write commands. The Server supports a fixed set of item names, generally may be described as: where: Name[n][S 0 ][S 1 ], Name - the item or command name; n - a number which can represent: (1) the channel (module) position number and may be from 0 to 15; (2) the PID loop number and may be from 0 to 7; (3) the Event/Reaction table entry number and may be from 0 to 255; (4) the Event group number and may be from 0 to 15 (or 255 if all events are specified); S 1 and S 2 - optionally used suffixes representing the sub-type of command. Brick Setup Commands SET RESPONSE DELAY command Name RSPDELAY DDE Type INTEGER; Write only; Brick - DIGITAL and ANALOG; Valid values from 0 to 2550 ms. This command is used to set a time of delay for command responses. Value specifies the delay time in milliseconds. The corresponding G4 I/O Unit command is SET RESPONSE DELAY (COMMAND ~). Example: RSPDELAY SET FREQUENCY RESOLUTION command Name FREZ DDE Type INTEGER; read/write; Brick - DIGITAL; Valid values: 1 or 10 Hz; This command is used to set the brick frequency measurement resolution. The corresponding G4 I/O Unit command is SET SYSTEM OPTIONS (COMMAND C). Example: FREZ Note: This command applies to all topics with the same port and Mistic Brick address. SET TEMPERATURE UNITS command Name TUNITS DDE Type DISCRETE; read/write; Brick - ANALOG; Valid values 0 (Celsius) or 1 (Fahrenheit). The corresponding G4 I/O Unit command is SET SYSTEM OPTIONS (COMMAND C). Example: TUNITS Note: This command applies to all topics with the same port and Mistic brick address.

22 Klinkmann Automation MISTIC_B DDE Server 19 SET COMM LINK WATCHDOG command Name WDOGS 0 where S 0 is one of the following suffixes: ON DDE Type INTEGER; Write only; Brick - DIGITAL; Valid values from 0 to 65535; Specifies output modules to turn ON after watchdog time-out occurs. OFF DDE Type INTEGER; Write only; Brick - DIGITAL; Valid values from 0 to 65535; Specifies output modules to turn OFF after watchdog time-out occurs. Note: each ON and OFF bitmask bit corresponds to particular output module. Setting bit to 1 instructs module to go ON or OFF. The least significant bit corresponds to module #00. You cannot specify one module to go ON and OFF simultaneously; DEL DDE Type INTEGER; Write only; Brick - DIGITAL and ANALOG; Valid values: 0 to disable watchdog function; from 200 to ms to set watchdog function. Specifies watchdog time-out delay in milliseconds. For Digital bricks the SET COMM LINK WATCHDOG command is sent only after the Server has received some new values for all three DDE items (WDOGON, WDOGOFF and WDOGDEL). For Analog bricks only the watchdog delay (WDOGDEL) is used. The corresponding G4 I/O Unit command is SET COMM LINK WATCHDOG MOMO AND DELAY (COMMAND D). WDOGON WDOGOFF WDOGDEL SET COMM. LINK WATCHDOG TIME-OUT DATA command Name WDDATAn DDE Type REAL, write only, Brick - ANALOG, n - analog output module channel number, valid values from 0 to 15. Specifies desired output module value in engineering units for output channel n upon a communications link watchdog timeout condition. Note: Command is executed (sent to PLC) after writing (poke) any value (0 or 1) to item WDDATA. Name WDDATA DDE Type DISCRETE, write only, Brick - ANALOG Writing any value to this item sets up all specified desired output module states for communication link watchdog timeout condition. If no output values are specified since previous use of this command, then output module values will not be changed upon communication link watchdog timeout condition. If it is

23 Klinkmann Automation MISTIC_B DDE Server 20 necessary to change watchdog condition output values, then module values must be specified by using item(s) WDDATAn prior writing any value to this item. The corresponding G4 I/O Unit command is SET COMM. LINK WATCHDOG TIME-OUT DATA (COMMAND H). WDDATA1 = 2.33; WDDATA2 = 4.5; WDDATA = 1; this set of commands specifies value 2.33 for output module 1 and 4.5 for output module 2 when communications link timeout condition occurs. WDDATA = 1; WDDATA = 0; this set of commands clears all previously specified output module states for communications link timeout condition. STORE SYSTEM CONFIGURATION command Name STOREEEPROM Type DISCRETE; Write only; Brick - DIGITAL and ANALOG; Writing any value to this item saves the current system parameters to EEPROM. The parameters for DIGITAL bricks saved to EEPROM are: 1. Module configuration (configured at DDE initialization). 2. Counter enable/disable status (configured by counter commands). 3. Communications link watchdog parameters. 4. Frequency resolution setting. 5. Response delay setting. 6. Event/Reaction table entries 00 through 20 hex (configured by event reaction commands). For ANALOG bricks: 1. I/O module configuration type. 2. Initial DAC analog output settings. 3. TPO Resolution Settings. 4. Temperature measurement units. 5. Input offset and gain settings. 6. Engineering Units scaling parameters. 7. PID loop parameters. 8. Communications link watchdog time. 9. Response delay setting. The corresponding G4 I/O Unit command is STORE SYSTEM CONFIGURATION (COMMAND E). Example: STOREEEPROM.

24 Klinkmann Automation MISTIC_B DDE Server 21 Digital Read/Write and Latch Commands DIGITAL MODULE STATUS commands Name MODSTATn Type DISCRETE; read/write; Brick - DIGITAL; n - channel number; valid values from 0 to 15; Specifies input or output module state. The corresponding G4 I/O Unit read command is READ MODULE STATUS (COMMAND R). The corresponding G4 I/O Unit write command is SET OUTPUT (ACTIVATE OUTPUT) (COMMAND d). Name MODSTATS 0 where S 0 - one of two possible suffixes: ON Type INTEGER; read/write; Brick - DIGITAL; Valid values from 0 to 65535; Each of 16 bits corresponds to a particular digital module. Value 1 of each bit means that particular module is in ON state (read value) or output module will go to ON state after writing. This item can be used to set particular outputs. OFF Type INTEGER; read/write; Brick - DIGITAL; Valid values from 0 to 65535; Each of 16 bits corresponds to particular digital module. Value 1 of each bit means that a particular module is in OFF state (read value) or output module will go to OFF state after writing. This item can be used to reset particular outputs. The corresponding G4 I/O Unit read command is READ MODULE STATUS (COMMAND R). The corresponding G4 I/O Unit write command is SET OUTPUT MODULE STATE - GROUP (COMMAND J). Name MODSTAT Type INTEGER; read/write; Brick - DIGITAL; Valid values from 0 to 65535; Each of 16 bits corresponds to particular digital module. Each bit value indicates or stores (after writing) particular module state. The corresponding G4 I/O Unit read command is READ MODULE STATUS (COMMAND R). The corresponding G4 I/O Unit write command is SET OUTPUT MODULE STATE - GROUP (COMMAND J). MODSTAT1 reads and writes digital module #1. MODSTATON reads all modules with ON state and writes modules to ON state. MODSTATOFF reads all modules with OFF state and writes modules to OFF state. MODSTAT reads and writes the state of all modules. DIGITAL LATCH GROUP commands Name LATCH[n][S 0 ][S 1 ] where: n optional digital input module channel; valid values is from 0 to 15; channel must be configured as counter input;

25 Klinkmann Automation MISTIC_B DDE Server 22 S 0 optional first suffix; S 1 optional latch clearing second suffix C; where S 0 can be one of the following suffixes: ON Specifies positive latches; OFF Specifies negative latches; without suffix Specifies both positive and negative latches. All possible items are read/write. If channel number n is specified then DDE type is DISCRETE, otherwise DDE type is INTEGER and all brick latches are addressed. If latch clearing suffix C is specified then all positive, negative or both positive and negative latches after reading are cleared (depending on first suffix S 0 ). Writing any value to item clears all latches affected by item. Note: If latch clearing suffix C is specified and any other command reads the same latch, then latch can be cleared by this command before other command reads this latch. Therefore it is not recommended to use other latch commands if latch group commands are used with latch clearing suffix. The corresponding G4 I/O Unit read command is READ AND OPTIONALLY CLEAR LATCHES GROUP (COMMAND S). The corresponding G4 I/O Unit write command is READ AND OPTIONALY CLEAR LATCH (COMMAND w) if module channel is specified or READ AND OPTIONALLY CLEAR LATCHES GROUP (COMMAND S) if no module channel is specified. LATCH reads all latches, write clears all latches. LATCH3 reads all latches and returns latch state of module 3, write clears latch of module 3. LATCH3ONC reads and clears all positive latches and returns positive latch state of module 3, write clears positive latch of module 3. LATCHOFFC reads and clears all negative latches, write clears all negative latches. DIGITAL LATCH commands Name SLATCHn[S 0 ][S 1 ] where: n digital input module channel from 0 to 15; channel must be configured as counter input; S 0 optional first suffix; S 1 optional latch clearing second suffix C; where S 0 can be one of the following suffixes: ON Specifies positive latches; OFF Specifies negative latches; without suffix Specifies both positive and negative latches. All possible items are read/write. DDE type is DISCRETE. If latch clearing suffix C is specified then all positive, negative or both positive and negative latches are cleared (depending on first suffix S 0 ). Writing any value to item clears all latches affected by item. The corresponding G4 I/O Unit command is READ AND OPTIONALY CLEAR LATCH (COMMAND w).

26 Klinkmann Automation MISTIC_B DDE Server 23 SLATCH3 reads and returns latch state of module 3, write clears latch of module 3. SLATCH3ONC reads and clears and returns positive latch state of module 3, write clears positive latch of module 3.

27 Klinkmann Automation MISTIC_B DDE Server 24 DIGITAL COUNTER and FREQUENCY COMMANDS Any digital Input position can function as event counter to return a count of external events, or frequency measurement input in order to return current digital impulse count per second. Any event counter input can be enabled and disabled. The counter value may be cleared at any time. The frequency measurement can be configured with different frequency resolutions (1Hz or 10Hz). In case of resolution 10Hz the input signal frequency is divided by 10 and then measured. The measured value is multiplied by 10 and value returned. DIGITAL FREQUENCY MEASUREMENT GROUP command Name FREQn Type INTEGER; read only; Brick - DIGITAL; Value range 0 to Hz or 0 to Hz; Reads all brick channels configured as frequency measurement channels and returns current frequency value of channel n which must be configured as frequency measurement channel. The corresponding G4 I/O Unit read command is READ FREQUENCY MEASURMENT - GROUP (COMMAND Z). Example: FREQ10 DIGITAL FREQUENCY MEASUREMENT command Name SFREQn Type INTEGER; read only; Brick - DIGITAL; Value range 0 to Hz or 0 to Hz; Reads and returns current frequency value of channel n which must be configured as frequency measurement channel. Note: This command is recommended to use only if one brick channel is configured as frequency measurement input (it is a bit faster than previous command). Otherwise the previous command is recommended. The corresponding G4 I/O Unit read command is READ FREQUENCY MEASURMENT (COMMAND t). Example: SFREQ10. DIGITAL 32BIT COUNTER GROUP command Name CNTn[S 0 ] where: n counter channel number from 0 to 15; channel must be configured as counter input or quadrature counter; S 0 optional counter clearing suffix C. All possible items are read only. DDE type is INTEGER. If counter clearing suffix C is specified then all counters of brick after reading are cleared. Note: If counter clearing suffix C is specified and any other command reads the same counter, then counter can be cleared by this command before other command reads this latch. Therefore it is not recommended to use other counter commands if counter group commands are used with counter clearing suffix. The corresponding G4 I/O Unit read command is READ 32 BIT COUNTER GROUP (COMMAND T) if counter clearing suffix is not specified or READ AND CLEAR 32 BIT COUNTER GROUP (COMMAND H) if counter clearing suffix is specified.

28 Klinkmann Automation MISTIC_B DDE Server 25 CNT15 reads all counters and returns counter value of module 15, CNT15C reads and clears all counters and returns counter value of module 15, DIGITAL 32BIT COUNTER command Name SCNTn[S 0 ] where: n counter channel number from 0 to 15; channel must be configured as counter or quadrature counter; S 0 optional counter clearing suffix C. All possible items are read only. DDE type is INTEGER. If counter clearing suffix C is specified then specified counter after reading is cleared. Note: If counter clearing suffix C is specified and any other command reads the same counter, then counter can be cleared by this command before other command reads this latch. Therefore it is not recommended to use other counter commands if counter group commands are used with counter clearing suffix. The corresponding G4 I/O Unit read command is READ 32 BIT COUNTER (COMMAND l) if counter clearing suffix is not specified or READ AND CLEAR 32 BIT COUNTER (COMMAND n) if counter clearing suffix is specified. SCNT15 reads and returns counter value of module 15, SCNT15C reads, clears and returns counter value of module 15, COUNTER ENABLE command Name ENCNT[n] where n is optionally used counter channel number from 0 to 15; read/write; Brick - DIGITAL. If counter channel is specified then DDE Type is DISCRETE. If counter channel n is not specified then DDE Type is INTEGER. If counter channel is specified then writing 1 enables and writing 0 disables counter. If counter channel is not specified then writing 1 enables and writing 0 disables all counters of the brick. The corresponding G4 I/O Unit write command is ENABLE/DISABLE COUNTER (COMMAND b) if counter channel is specified or ENABLE/DISABLE COUNTER GROUP (COMMAND H) if no counter channel is specified. The corresponding G4 I/O Unit read command is READ COUNTER ENABLE/DISABLE STATUS (COMMAND u). ENCNT0 reads and returns counter enable/disable status of module 0, writing 0 disables and writing 1 enable counter 0; ENCNT reads and returns counter enable/disable status s of all counters of brick, writing 261( BIN) to ENCNT item enables counters 0, 2 and 8, all other counters are disabled. COUNTER CLEAR command Name CLRCNT[n] where n is optionally used counter channel number from 0 to 15; write only; Brick - DIGITAL.

29 Klinkmann Automation MISTIC_B DDE Server 26 If counter channel is specified then DDE Type is DISCRETE and writing any value to this item clears specified counter. Otherwise if counter channel n is not specified then DDE Type is INTEGER and writing any value to this item clears all counters of brick. The corresponding G4 I/O Unit write command is CLEAR COUNTER (COMMAND c) if counter channel is specified or READ AND CLEAR 32 BIT COUNTER GROUP (COMMAND U) if no counter channel is specified. CLRCNT0 writing clears counter 0; CLRCNT writing clears all counters of brick. Note: The 16 bit counter commands are not supported in this Server version. DIGITAL TIME DELAY, PULSE OUTPUT COMMANDS GENERATE N PULSES command Name NPULSnS 0 Type INTEGER; write only; Brick - DIGITAL; where: n digital output channel number from 0 to 15; S 0 one of the ollowing suffixes: ON Specifies on pulse duration in units of 100 microseconds; Valid values greater than 10 (1 ms); OFF Specifies off pulse duration in units of 100 microseconds; Valid values greater than 10 (1 ms); CNT Specifies generated pulse count and starts generation. To generate N pulses firstly you need to specify valid on and off pulse durations, and then write necessary pulse count to item NPULSnCNT. The corresponding G4 I/O Unit write command is GENERATE N PULSES (COMMAND I). NPULS8ON NPULS8OFF NPULS8CNT writing specifies on pulse duration 1 second; writing 10 specifies minimal allowed off pulse duration 1 ms. writing 7 starts generate 7 pulses to output 8 with on pulse duration 1 second and off pulse duration 1 millisecond. OUTPUT TIMER COUNTER command Name OTCNTn Type INTEGER; read only; Brick - DIGITAL; where n specifies output channel number from 0 to 15; Value is in units of 100 microseconds. Reads the current time delay value of an output channel which may have a delay in progress. The value represents time remaining for the delay. A time of zero indicates that delay has finished or is not active anymore. The corresponding G4 I/O Unit write command is READ OUTPUT TIMER COUNTER (COMMAND k).

30 Klinkmann Automation MISTIC_B DDE Server 27 Example: OTCNT8. TIME PROPORTIONAL OUTPUT (TPO) commands Name TPOnS 0 write only; Brick - DIGITAL; where: n Specifies digital output channel number from 0 to 15; S 0 P one of following suffixes: Type INTEGER, specifies period of TPO in units of 100 microseconds; valid values greater than 1000 (0.1 sec) ; % Type REAL; Specifies percentage of TPO This command is used to set the period and percentage of time proportional output. The TPO period must be specified before issuing percentage command. The corresponding G4 I/O Unit write command is SET TIME PROPORTIONAL OUTPUT PERIOD (COMMAND ]) if suffix P is specified, and command SET TPO PERCENTAGE (COMMAND j) if suffix % is specified. TPO8P TPO8% writing specifies output 8 period of 1 second. writing 10.0 specifies that output 8 goes to on 10% of period time and output 8 goes off 90% of period time. START CONTINUOUS SQUARE WAVE command Name SQWnS 0 Type INTEGER; write only; Brick - DIGITAL; where: n Specifies digital output channel number from 0 to 15; S 0 one of the following suffixes: ON Specifies output on time duration in units of 100 microsecond; Valid values are greater than or equal to 10 (1 ms). OFF Specifies output on time duration in units of 100 microsecond; Valid values are greater than or equal to 10 (1 ms). This command is used to start a continuous square wave at output channel cpecified by n. Command is not executed before you do not specify both on and off pulse durations. After you specify both durations, changing one of them changes square wave time parameters immediately. The corresponding G4 I/O Unit write command is START CONTINUOUS SQUARE WAVE (COMMAND h). SQW8OFF writing specifies output 8 square wave off pulse duration of 1 second. SQW8ON writing 100 specifies output 8 square wave on pulse duration of 10 ms and starts continuous square wave on output 8; SQW8ON writing 1000 changes square wave on pulse duration to 0.1 second.

31 Klinkmann Automation MISTIC_B DDE Server 28 START OFF PULSE command Name OFFPULSEn Type INTEGER; write only; Brick - DIGITAL; Valid values greater than or equal to 5 (0.5 ms) in units of 100 microsecond. where n Specifies output channel number and can be from 0 to 15; This command is used to generate a retriggerable OFF pulse at the output specified by n. The corresponding G4 I/O Unit write command is START OFF PULSE (COMMAND g). Example: OFFPULSE8 writing instructs output 8 generate off pulse with duration 1 second. START ON PULSE command Name ONPULSEn Type INTEGER; write only; Brick - DIGITAL; Valid values greater than or equal to 5 (0.5 ms) in units of 100 microsecond. where n Specifies output channel number and can be from 0 to 15; This command is used to generate a retriggerable ON pulse at the output specified by n. The corresponding G4 I/O Unit write command is START ON PULSE (COMMAND f). Example: ONPULSE8 writing instructs output 8 generate on pulse with duration 1 second.

32 Klinkmann Automation MISTIC_B DDE Server 29 DIGITAL PULSE/PERIOD MEASUREMENT COMMANDS 32 BIT PULSE/PERIOD GROUP commands Name PP[n][S 0 ] Type INTEGER; read/write; Brick - DIGITAL; where n optional input channel number can be from 0 to 15; If channel number is not specified then item is used for restarting all pulse/period measurements on the brick. In this case DDE type is DISCRETE and item is write only. Writing any value to this point restarts all pulse/period measurement channels. S 0 optional pulse/period measurement restarting suffix C. The channel n must be configured into one of the followings: Positive pulse measure input point; Negative pulse measure input point; Period measure input point; On time totalizer input point; Off time totalizer input point; This command reads all pulse/period measurement channels of brick and optionally (if specified suffix C) restarts them, returns current measure value of channel n. Returned data is in units of 100 microseconds. Writing any value to point restarts pulse period measurement of specified channel. The corresponding G4 I/O Unit read command is READ 32 BIT PULSE/PERIOD GROUP (COMMAND W) id not specified restarting suffix. If it is specified pulse/period restarting suffix then corresponding G4 I/O Unit read command is READ AND RESTART 32 BIT PULSE/PERIOD GROUP (COMMAND X). For write only item (channel number not specified) the corresponding G4 I/O Unit write command is READ AND RESTART 32 BIT PULSE/PERIOD GROUP (COMMAND X). If channel number is specified then the corresponding G4 I/O Unit write command is READ AND RESTART 32 BIT PULSE/PERIOD (COMMAND r). PP3 period brick. PP PP3C reads all pulse/period measurement channels and returns current pulse measure value of input channel 3; writing any value restarts pulse period measurement of channel 3. writing any value restarts pulse/period measurement of all channels of reads and clears all pulse/period measurement channels and returns current pulse period measure value of input channel 3; writing any value restarts pulse period measurement of channel BIT PULSE/PERIOD commands Name SPPn[S 0 ] Type INTEGER; read/write; Brick - DIGITAL; where n input channel number and can be from 0 to 15; S 0 optional pulse/period measurement restarting suffix C. Channel n must be configured as described in the previous command. This command reads and returns currently measured value of pulse/period measurement of channel n and optionally (if specified suffix C) restarts it. Returned data are in units of 100 microseconds. Writing any value to point restarts pulse period measurement of specified channel. The corresponding G4 I/O Unit read command is READ 32 BIT PULSE/PERIOD MEASURMENT (COMMAND p) if not specified pulse/period measurement restarting

33 Klinkmann Automation MISTIC_B DDE Server 30 suffix. If it is specified pulse/period measurement restarting suffix then the corresponding G4 I/O Unit read command is READ AND RESTART 32 BIT PULSE/PERIOD MEASURMENT (COMMAND r). The corresponding G4 I/O Unit write command is READ AND RESTART 32 BIT PULSE/PERIOD MEASURMENT (COMMAND r). SPP3 reads and returns current pulse period measure value of input channel 3; writing any value restarts pulse period measurement of channel 3. SPP3C reads, clears and returns value of pulse/period measurement channel 3; writing any value restarts pulse period measurement of channel 3. PULSE/PERIOD COMPLETE STATUS commands Name PCMPL Type INTEGER; read only; Brick - DIGITAL; This command returns 16 bit number that identifies the channels which have measured one complete pulse or period. 1 indicates that a measurement is completedand the data are ready. 0 indicates that the measurement is in progress or waiting for an edge trigger to occur or channel is not configured for pulse/period measurements. The corresponding G4 I/O Unit read command is READ PULSE/PERIOD COMPLETE STATUS (COMMAND V). Example: PCMPL. ANALOG I/O CONFIGURATION COMMANDS CALCULATE AND SET ADC MODULE OFFSET command Name CSETOFFSETn Type DISCRETE; write only; Brick - ANALOG; where n Input channel number from 0 to 15; Writing any value to this item instructs the addressed I/O Unit to use the current input value as zero point input value. The current reading is multiplied by (-1) and is used as an offset. This command is intended for use with calibration purposes. The corresponding G4 I/O Unit write command is CALCULATE AND SET ADC MODULE OFFSET (COMMAND d). Example: CSETOFFSET0. CALCULATE AND SET ADC MODULE GAIN command Name CSETGAINn Type DISCRETE; write only; Brick - ANALOG; where n Input channel number from 0 to 15; Writing any value to this item instructs the addressed I/O Unit to use the current input value as the full scale input value. A gain coefficient is calculated and used for all subsequent readings. This command is intended for use with calibration purposes. The corresponding G4 I/O Unit write command is CALCULATE AND SET ADC MODULE GAIN (COMMAND e). Example: CSETGAIN0.