HELP FILE

Configuring the Reyrolle IO Server

After the Reyrolle IO Server (i.e. CSTRDC1132.EXE)  is installed, a small amount of  configuration is required. Configuring the Server automatically creates a CSTRDC1132.CFG file which holds all of the topic definitions, as well as the communication port configurations. This file will automatically be placed in the directory which is specified via the "Configuration File Path".

 To perform the required configurations, start up the  program. 

The application windows to the IO Server consists of a menu line with 3 main menus . Each main menu will be as follows:
 
 

Main menu	Sub menu
Configure	Com Port Settings
	Topic Definition
	Server Settings
Help	Browse Help File
	About  CSTRDC1132

Each of the configuration menu items are explained in the following chapters.

Please note : Screen shots used in this help file relates to a IO server  with the name CstJDx9132 but all  information also applies to the Reyrolle IO server named CstRDc1132.

Configure Serial Communication Port

To configure the communication ports, invoke the /Configure/Comm Port  Settings command. The "Communications Port Settings" dialogue box will appear:

The following describes each field in this dialogue box:

Com Port

 This field will display the communication port for this configuration.

 Reply Time-out

This field is used to enter the amount of time (in seconds) the Reyrolle Controls network using the selected communication port will be given to reply to commands from the Reyrolle IO Server This time-out is sustained only when a Reyrolle Controls networks fails to respond. When the Reyrolle Controls networks is responding normally, there is no penalty.Note: the default value of  3  seconds should be sufficient for most configurations.

Parity

Parity for Reyrolle relay  must be "None" or "Even" . "Even" is the default recommended value.

Stop Bits

Stop bits for Reyrolle relays must be "1" and cannot be changed.

Byte Size

Byte size for Reyrolle relays must be "8" and cannot be changed.

Baud Rate

Baud rate for Reyrolle relays can be configured according to requirements. The default recommended baud rate is "9600".

Once all entries have been made, select 0K to process the configuration for the communication port.

Topic Definition (Reyrolle Controls Network)

The user provides each Reyrolle relay node  with an arbitrary name which is used as the DDE topic name for all references to that network.

Only ONE topic can be defined for each relay on the Reyrolle network.

To define the Topics (nodes), invoke the /Configurationf/Topic Definition command. The topic list dialogue box will appear:

To modify an existing topic, select the topic name and click on Modify.
To define a new topic, click on Add. It's also possible to double click
on the topic name instead of using Modify.The "Topic Definition" dialogue box will appear:

The following describes the field in this dialogue box:

 Topic Name

 This field is used to enter a Topic Name. (The same DDE Topic Name is  entered in the InTouch "DDE Access Name definition" dialogue box described in the section "Using the DDE Server with InTouch The topic must be a unique name that is matched by the DDE clients (for example InTouch).

Poll Rate

This field tells the server how often it will try to update all the items defined under this topic. Please note that the DDE server is always doing its best. The IO server is able to process about 10 messages per second using 9600 baud serial link. If the pollrate is too low the IO server will still only manage 10 messages per second. The recommneded poll rate for LARGE systems(i.e. 64 relays or more) is 1000 ms (the default rate). A poll rate of  100ms is recommended for smaller systems.

Address

The address (written as a decimal integer value) of the node in the Reyrolle Controls network we want to communicate with. This is usually defined by a dip switch setting on the relay node or can be configured using the MMI panel push buttons on the relay.

Topic Type

The only topic type supported is the DC100 an can not be changed.

Comm Port...

If a communication port was previously defined for this node, its identification will appear to the right of this button .If no communication port has been defined, click on this button to associate the topic with a communication port (additional topics may be associated with this same port at a later time).

Configure Server Parameters Command

A number of parameters which controls 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 changing.

However, they can be changed to fine-tune the Server for a specific  environment.

To change the Server's internal parameters, invoke the /Configure/5erver Settings command. The " Server Operational Parameters" dialogue box will appear:

The following describes each field in this dialogue box:

Configuration File Path

This field is used to specify the path (disk drive and directory) in which the Reyrolle server will save its configuration file. IO 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 CSTRDC1132.CFG .

Note: There is no limit to the number of configuration files created although each must be in a separate directory. When using the Reyrolle IO Server with InTouch it is good practice to place the configuration file in the application dIrectory.

Note: Each time the CSTRDC1132.CFG  file is saved the old configuration file is saved as CSTRDC1132.CBK .

Protocol Timer Tick

This field is used to change the frequency, where the Server checks for work to do. This should take approximately 2 to 4 times the fastest rate desired to update data from the Reyrolle Controls Node. The default setting is 50 msec which is the shortest period that  can be configured.
 

NetDDE being used

Default value is unchecked. Must only be selected  if  DDE clients and IO servers are communicating over a LAN.

Start automatically as a Windows NT service

(Windows NT only) Default value is unchecked. Selecting this option will enable IO server to start up automatically as an NT service.

WW logger messages/ Debug information

The Wonderware logger program is primarily used for receiving error messages (default behavior), but can also be used in a debugging situation to find out what is really happening inside the IO server.

The Wonderware logger will log messages according to the options selected by right clicking the mouse button when the IO server  icon appears in the Windows status bar.

Please note that when messages are written to the Wonder Logger program this will slow down the performance of the IO server.

Saving the Configuration File Directory

If the configuration file does not currently exist, or there has been a change in the configuration of the Server, the Server will display the "Save Configuration" dialogue box:

This dialogue 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 WlN.INI file by selecting the "Make this file default configuration" option. Doing so will allow the Reyrolle IO Server to find the configuration file automatically each time it is started.

Configuration File Location

 Note: There is no limit to the number of configuration files that may be created, although each must be in a separate directory.

View IO Server status windows

The IO server will display the status of messages configured for active points in its status window ( main window) The window will display the status of active messages as "DUE" until the message has been serviced  during the current polling cycle.

Using the IO Server with InTouch

Defining the DDE link

Click on Add. The "DDE Access Name Definition" Dialogue Box will appear:

Note: When New 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 fields are required entries when entering a DDE Access Name Definition:

DDE Access Name

Enter an arbitrary name which will be used in InTouch tagname definitions to refer to the topic (Reyrolle Controls Node). (It is generally advisable that the same name defined for the Reyrolle topic is used here.)

IO Application/Server Name

Enter the application name, CSTRDC1132.

DDE Topic Name

Enter the name defined for the topic in the Reyrolle IO Server to  identify the Reyrolle Controls node the IO Server will be accessing.

 Note: This will usually be the same as the "DDE Access Name" although  if desired, they may be different. However, the "DDE TopIc Name" must be the same name used when the topics were configured in the Reyrolle IO Server program. (Refer "configure topic" section for further details.)

Request Initial Data

This option should not be selected when the DDE application is a Wonderware IO Server (CSTRDC1132 is based on the Wonderware DDE Server Toolkit and is hence a Wonderware IO Server). With nonWonderware DDE Servers, this option may be need to be selected if the server does not send data immediately when a window appears on the screen.

Wait for Change

This option should be selected when the DDE application is a Wonderware IO Server.

Advise All Items

 Selecting this option will cause the Reyrolle IO server to poll for all  Reyrolle points that are defined in the tagname database, regardless of whether they are visible. This option MUST be  selected for each topic configured for the Reyrolle relay network.

Advise only active items

 This option must not be used.

Defining the tagnames

Polling of Reyrolle relay events and measurands becomes enabled when the following tag names are configured :

•  EVIP1 - enables Class 1 polling
• MEAI - enables Class 2 polling

Note: Each topic must have these two points configured to enable  polling of all other points

To define the tagnames associated with the new "DDE Access Name", invoke the /Special/Tag Name Dictionary...command (In WindowMaker).

Click on New and enter the Tagname.(The tagname defined here is the name InTouch will use. The Reyrolle Server does not see this name.)

Select a tag type by clicking on the Type button. The "Choose tag type"
dialogue box will appear:

To access Reyrolle items, the type must be DDE discrete, DDE Integer,
DDE Real or DDE Message. Select the DDE type.

The "Details" box for the tagname will appear:

Select the Reyrolle topic (Reyrolle network node) by clicking on the DDE Access Name:...button. The "Select a DDE Access Name dialogue box will appear:

Select the appropriate topic name and click OK. (If the DDE Access Name has not been defined as previously described, click on New and then define the DDE topic now.)

The "Details" dialogue 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 should be equal to Max Raw.

Enter the Reyrolle item/point name to be associated with this tagname in the Item field in the "Details" box:

(Refer to the Item (Point) Naming section below for complete details.)

Where applicable, the Use Tagname as Item Name option may be selected
to automatically enter the tagname in this field.

Note: The tagname can only be used if it follows the conventions listed
in the "Item (Point) Naming " section in this document.

Once all entries have been made, click on the Save button, (in the top of the dialogue box) to accept the new tagname. To define additional tagnames click on the New button. To return to the WindowMaker main screen, select Done.

Item (Point) Naming

The Reyrolle IO Server supports two groups of item (point) names.
Items for the measurands (prefix "MEA") and items for events (prefix "EV").

Tag names are in accordance with the following Reyrolle publications:

• Argus 2 : COMMUNICATION INTERFACE available from Reyrolle

  TABLE I

APPENDIX B - CLASS 2 MEASURANDS

Note: COT = Cause of Transmission

TABLE 2

APPENDIX C - ARGUS STANDARD EVENT CODES

APPENDIX D - ARGUS PRIVATE EVENT CODES

General Reyrolle Measurands

Reyrolle Controls node "STATUS" Item

From InTouch the state of the Reyrolle Controls node may be read by defining a tagname and associating it with the topic configured for the Reyrolle Controls node and using Status as the Item name.

From Excel, the status of the Reyrolle Controls node communications may be read by entering the following formula in a cell:
                              =Reyrolle/topic/STATUS

Where topic is the topic name which you would like to monitor the status of.