wiring block pins from geh6700k part 2.pdf4-16 toolboxst* user guide for mark* vie control zoom and...

Wiring Block PinsBlock pins are wired together to direct the flow of data through the software. Youcan form a connection by using the pointer tool to drag one pin to another pin.The destination pin’s Connection property is set to the block that was the source

of the drag-and-drop operation. You can also use the Wiring Tool to formpin connections, which forms connections to both normal blocks and to blockswith a configurable number of inputs (called Rubber Pins).

Source of the Wiring Tooldrag-and-drop operation

Destination (anew rubber pin)

Wire Styles and Colors

Wires connecting blocks are solid for analog variables (any numeric datatype) and dashed for Booleans. When the ToolboxST application is not onlinewith the controller, wires are drawn in black. When online, wires are drawnin different colors to indicate values and quality.

Wire Styles and ColorsOnline analog, solid

Quality Color

Normal Black

Poor Magenta

Online Boolean, dashed

True Red

False Gray

Forced True Orange

Forced False Blue

Warning

Logic forcing procedures can result in personal injury ordeath, if not strictly followed. Only adequately trainedpersonnel should modify any programmable machine.Forcing of control logic for an operating process isstrongly discouraged.

Forcing of protective functions is never permissible foran operating unit. All safety measures should be strictlyenforced in conjunction with this procedure.

4-16 ToolboxST* User Guide for Mark* VIe Control

Zoom and Pan Tools

� To pan the block diagram

♦ From anywhere in the diagram, press and hold the right-mouse button. Thecursor displays as a hand, allowing you to pan in any direction.

� To use zoom in the block diagram

Note While using the zoom tool, hyperlinks in the diagram are active.

GEH-6700K Chapter 4 Block Diagram Editor User Guide 4-17

Block Shape Shortcut MenuWhen you right-click a block, a shortcut menu displays:

Block Help shows reference documentation on the selected block type in a help window.

Add To Trend allows you to open a new Trender window. The blockis automatically added to the new Trender.

Add to Watch allows you to open a new Watch Window. The block isautomatically added to the Watch Window.

Go To Definition allows you to locate the variable definition.

Compare To Definition allows you to display a difference report that comparesthe userblock instance and it’s library definition.

Show Description on Diagram toggles the display of description text forthe block. This text is the most effective way to document a block, as the textstays attached to the block whenthe diagram is rearranged.

Edit Block Pins displays the Edit Block Connections dialog box.

Unhide all Pins causes the pins to display.

Copy allows you to copy a block.Paste displays to allow you to pastethe copy to the Block Diagram Editor.

Cut allows you to cut a block from the Block Diagram Editor.

Delete allows you to delete a block from the Block Diagram Editor.

Bring to Front andSend to Back reorder blocks, causing them to appear above orbelow all other blocks and shapes on the diagram when overlap occurs.

Paste After allows you to insert whatever is on the clipboard but sets the executionorder of the blocks to be immediately after the right-clicked block.


Connecting Pins� To connect a single pin

♦ From theBlock Diagram Editor , double-click a pin. TheConnectPin dialog box displays.

Connect a pin to anyvariable or immediatevalue by typing thename of the variableor the value.

Browse buttonsdisplay the VariableBrowser.

This tab is a quick referenceshowing the variablesconnected to the selected pin.

Click to access localvariables andenumeration values.

Option buttonsspecify the type ofconnection.

Creates a newvariable in theuser block.


� To connect multiple pins

♦ Double-click a block in theBlock Diagram Editor . TheEdit BlockPin Connections dialog box displays.

Pins represent inputs and outputs of a block. Parameters are a special type of Pinthat are always Inputs, and are usually constant values that control block operation.Most Parameters are drawn on the Blockware diagram under the block; typically,they do not display if they are left to their default initial value.

Changing a Pin Connection

� To change a pin’s connection

♦ From theConnection column, select the cell for the desired pin. Either entera new value or click the down arrow to select a value.

Note Clicking the Connection column displays a drop-down list that includes BrowseGlobals and Browse Locals. If either of these is selected, the Select a Variable dialogbox displays to allow you to select a variable. Any enumerated values that are legalfor the selected pin also display in the drop-down list.

Note All block pin connection changes take effect immediately (there is no OK orCancel button in the Edit Block Pin Connections dialog box). From the Edit menu inthe Component Editor, select the Undo option to reverse any changes.

Tip � Pressing Enter while entering text selects the next pin on the block, allowingrapid entry of connections.


Toggling Live Data LayersTo reduce information clutter in the online blockware diagram, you can toggle livedata or variable names on and off with various toolbar buttons.

� To toggle between live variables and values

♦ From the diagram Layer toolbar, click the down arrow to select the desired action.

Buttons on the Layer toolbar allow you to display the following.

Mode ToolbarButton

Displays:

Value Only (VAL) Live value only:

Variable Only (VAR) Variable only:


Mode ToolbarButton

Displays:

Value and Variable

(VAL/VAR)

Variable name and live value

Value Over Variable displays the live value largerthan the variable:

Variable Over Value displays the variable name

larger than the live value:

Variable Inline with Value both display larger andmay overlap other shapes in the diagram:


Modifying Live ValuesWhile you are connected online to a controller,and the controller is not in Locked mode,you can change the current value stored in a variable. Optionally, you can also force the newvalue, which prevents programs defined in block diagrams from overwriting your choices.

Warning



� To change the value of a variable while online

♦ From anywhere variables are used in theSoftware tab, double-click a variable valueto display theSend Value dialog box. A dialog box displays that is appropriateto the data type of the variable. Refer to the following variables.

Note When the controller is in Locked mode, double-clicking on a variable valuedisplays the following message.

Boolean Values

Displays the currentvalue of thevariable.

Select an option toselect a True or Falsevalue for the variable.

Check this box toprevent programs fromoverwriting your selectedvalue.

Click here to send the NextValue to the controller andclose the dialog box.

Click here to invert the currentvalue and immediately send itto the controller without closingthe dialog box.


Numerical Values

Click here to send theNext Value to thecontroller and close thedialog box.

Click here to send the NextValue to the controller without closing the dialog box.

Click to increase ordecrease the variable by thedelta value and send theresult to the controller.

Displays thecurrent value ofthe variable.

Enter a new valuefor the variable.

Check this box toprevent programsfrom overwritingyour selectedvalue.

Enter a value tobe added to orsubtracted fromthe variable.

Array Values

Double-click an element ofthe array to display theassociated Send Valuedialog box.

When you are finishedchanging values, click hereto close the dialog box.


Shape Drawing ToolsSeveral drawing tools allow you to customize the Block Diagram. These drawing toolscreate shapes, which are elements of graphics or text that provide additional visualinformation on a drawing sheet. They are accessed from the Block Diagram Editor toolbar.

Variable Rail Tool

The Variable Rail Tool arranges inputs along the left side of a particularsheet and outputs along the right side to improve readability. It inserts a variablereference that can be wired to a block pin and moved around freely.

Inputs Outputs

Variab le displays the variable represented by the shape.

Top displays the top location of the variable shape.

Left displays the left location of the variable shape.

Width displays the width of the variable shape.

Variables on a variable rail display with symbols and cross references thatindicate the role of the variable in the system.

Note The Variable Rail tool is only used in Manual Layout mode (refer to the section,Layout Modes). When you select the Variable Rail tool, a message box displays thatallows you to switch to this mode.


Localinput

Globalvariable

Undefinedvariable

Pincallout

EGDvariable

Note For each variable on the rail, cross references to other variable usages display.

Adding a Variable Rail

� To add a var iable rail

1. From theBlock Diagram Editor , select theVariable Rail drawing tool.

2. Press and hold the left-mouse button on the blockware diagram sheet, then dragthe mouseuntil the size and location of the new variable rail displays. Releasethe mouse button when you are satisfied with the location of the rail.

To define a rectangulararea for the rail, clickand drag the cursor.

Note Clicking in the right or left two inches of the sheet docks the rail to the sheet’sedge.


Adding Variables to a Variable Rail

� To add a variable to a rail

Note Variables from other windows (Watch Windows, Trenders, and such) can bedragged and dropped into a variable rail, as well.

♦ Click to select a desired variable, then drag the variable from the rail anddrop it onto a block pin to form a wired connection.


Managing Variables on a Rail

Variables attached to a rail can be manipulated in different ways.

� To connect variables on a rail to a block pin

♦ Drag a variable from the rail and drop it into a block pin to form a wired connection.

� To move variables on a rail

♦ Select and drag the variable from the rail to the desired location.

Working with Variables

� To work with variables

♦ Right-click anywhere in theVariable Rail to display the following shortcut menu.

Go To Where Used displays a list of all places that the selected variableis used (hardware I/O, EGD page, and such)

Add To Trend adds the selected variable to a defined Trender.

Add To Watch adds the selected variable to a defined Watch Window.

Go To Definition navigates to the location where the variable is defined. Itautomatically selects the Where Used tab in the Component InfoView.

Change Live Value displays the Change Live Value dialog box (youmust be online to use this menu option).

Add To EGD allows you to set the EGD page for the selected variable.


Text Tool

The Text Tool allows you to enter text anywhere on the diagram. While this tool isuseful in Manual Layout mode, the Description property of each block may be a moreappropriate way to add text when working in one of the two automatic layout modes.

� To use the Text Tool

♦ Click at the desired upper left corner of the text field, drag to the desired lowerright corner and release the mouse button. Enter the text in the dialog box thatdisplays and clickOK. The new shape is added to the drawing.

The shape created by the text tool has the following properties:

Text displays the text displayed by the text shape.

Text Font displays the font used to display the text.

Foreground Color displays the color of the text.

Filled, if set to True, causes the text shape to use the Fill Color as a background color.

Fill Color displays the background color shown behind the text if Filled is set to True.

Top displays the top location of the text shape.

Left displays the left location of the text shape.

Height displays the height of the text shape.

Width displays the width of the text shape.


Rectangle/Ellipse Tools

The Rectangle and Ellipse Tools draw simple geometric shapeswith configurable line and fill colors.

� To use the Rectangle or Ellipse Tool

♦ Click the desired upper left corner of the shape, drag to the desired lower right cornerand release the mouse button. The new shape is added to the drawing.

The Rectangle and Ellipse shapes have the following properties:

Line Color displays the color of the shape's line.

Line Thickness displays the thickness of the shape's line.

Filled , when set to True, causes the shape to be filled with the colorspecified in the Fill Color property.

Fill Color displays the color the shape is filled with when Filled is set to True.

Top displays the top location of the shape.

Left displays the left location of the shape.

Height displays the height of the shape.


Image Tool

The Image Tool inserts a Windows Metafile (.wmf) or EnhancedMetafile (.emf) into the diagram.

� To use the Image Tool

♦ Click the desired upper left corner of the shape, drag to the desired lowerright corner, and release the mouse button. Then, in theBrowse for Imagedialog box, provide the path to the .wmf or .emf file that contains the imageand clickOK. The image is added as a shape to the drawing.

Note The image file is not embedded in the diagram. All images must be distributedseparately from the .xml files for the diagram.

Image shapes have the following properties:

Metafile Path displays the path to the .wmf or .emf file containingthe image that is displayed.

Left displays the left location of the shape.

Top displays the top location of the shape.

Width displays the width of the shape.

Height displays the height of the shape.

Tip � To ensure that images can be found when the diagram is moved on the harddisk, avoid hard-coded path names or mapped drive names. Relative names, such as..\Metafiles\bom1.wmf are best.


Additional Toolbar ButtonsFull Screen Editing toggles the Library View, InfoView, and TreeViewon and off. When in full screen mode, more space is allotted to the BlockDiagram Editor for working with large drawings.

Detached View Window displays a new window containing a Block Diagram Editorby itself (without the TreeView or InfoView). The new window displays the samediagram as the main view, but can be scrolled and zoomed independently.

Tip � You can have as many detached views as desired, which can be convenient formoving pins from one drawing to another drawing.

Alignment Tools are available when multiple drawing shapes are selected (either bydrawing a selection rectangle around multiple shapes using the Pointer tool or by holdingthe CTRL key while selecting additional shapes). The tool modifies the location, width, orheight of each shape to match the selected aspect of the primary selected object (denotedwith green selection handles). The Top, Bottom, Left, and Right alignment tools affectlocation, while Width and Height adjust size. Arrange Horizontal and Arrange Verticalequally space all of the selected shapes along the Horizontal or Vertical axis.


Diagram SettingsThe Diagram Settings dialog box contains options that change how the Diagram Editoroperates, as well as style options such as paper size. In most situations, these settings areconsistent across all diagrams in a system, but occasionally a particular drawing mayneed custom settings. The diagram settings are arranged hierarchically with system levelsettings in effect unless other settings are configured. These settings can be overriddenby the device or library settings, which take effect at the Component Editor level. Theuser settings, saved on a per user basis, override the device or library settings, and finallythe diagram settings are saved per diagram and override all other settings.

Diagram

User

Device or Library

System

For example, if the system settings specify the paper size as Letter, the libraryand user settings specify Use Parent Setting, and the diagram settings set thepaper size to Legal, that diagram would be shown on legal-size paper while allother diagrams would be shown on letter-size paper.

� To configure diagram settings

1. Right-click an open area of a diagram while inEdit mode and selectDiagramSettings . A dialog box displays with the available scopes.


2. Select a scope to edit –System, Device or Library, User, or Diagram –and clickOK. TheEdit Dialog Settings dialog box displays.

TheEdit Diagram Settings dialog box allows you to edit the following options:

Size selects the paper size.

Landscape , when checked, makes the longest dimension of the paper, the horizontaldimension, creating a drawing that is wider than it is tall.

Font Sizes controls the font sizes in the diagram.

Hide Unused Pins , when checked, hides unconnected pins.

Show Block Drawings , when checked, graphically displays blockoperation whenever possible.

Show Wired Pin Connection Text , when unchecked, hides the connectiontext for wired pins, reducing clutter on the drawing.

Tip � Selecting the Default to parent setting or a dimmed check box indicates thatyou have no preference at the current level. The diagram uses the settings from thenext level down in the hierarchy.


Rung EditorBoolean logic functions are added to a block diagram inside special blocks called rungblocks. Rung blocks are named after a component of a Relay Ladder Diagram (RLD). In aRLD, one or more contacts (which function similarly to a mechanical relay switch) areconnected as a control network for a single coil, or output. As the diagram is formed withtwo vertical buses, one representing powerand one representing ground, the completeddiagram resembles a ladder, with each coil and associated contacts resembling a ladderrung. Rung blocks, like the rungs in a relay ladder diagram, control a single output.

The Rung block controls variable values using Boolean logic equations. While youcan specify a Boolean logic equation directly by connecting it to the EQN pin of therung block, a graphical RLD Editor is also available to simplify the process.

� To open the RLD Editor

♦ From aBlock Diagram , double-click aRung Block .

Or,

♦ Right-click aRung Block . From the shortcut menu, selectEdit Ladder Logic .


The RLD Editor window consists of both a 16x16 or smaller grid of cells that can containcontacts or wires and a set of tools used to edit the contents of the cells.

Wiring toolsDrag separators to addor remove columns.

Click OK to save or Cancelto discard changes.

Drag separators toadd or remove rows.

Display the currentequation or error message.


Contacts

Each contact represents a virtual relay switch that is controlled by a Boolean

variable. Contacts that either represent a variable directly or the negation ofthe variable are added to a ladder diagram using the contact tools.

� To add a contac t

1. Select the contact tool that matches the type of contact you want to

add. The mouse cursor changes to reflect the selected contact type.

2. Click a cell to add a new contact.

3. Double-click inside the cell above the newly inserted contact to openthe Connect Contact dialog box.

Check this box to changeall references to the listedvariable in the rung.

Enter or select a variableto connect to the contact.

Wires

Wires are used to connect contacts to the coil and to each other.

� To add a wire

♦ Select theWire tool , and then click a location on the grid.

Wires can only be drawn vertically or horizontally, as demonstrated below:


Coils

The diagram always has one coil.

� To connect the coil to a variable

♦ Double-click the coil to open theConnect Contact dialog box.(Refer to the section,Contacts.)

Adding Rows and Columns

Up to 16 rows or columns can be added to the grid to provide enoughspace for large logic diagrams.

� To add or remove rows or columns

♦ Drag the boundary between any row or column. Blue text will displayindicating the result of the action.

Errors

You can create rung diagrams in the RLD Editor that do not convert to compatibleBoolean logic functions. Typical errors include not connecting a contact to a variable,creating a wire or contact that is not connected to power and ground, or creating ashort circuit. If you make one of these mistakes, text will display on the status barto help you resolve the error. (When the output equation is displayed on the statusbar, the diagram is correctly drawn and no errors are detected.)


Chapter 5 Sequential Function Chart(SFC)

A Sequential Function Chart (SFC) is a graphical programming model that allows you toorganize an application by creating a state machine containing three types of components:Steps, Actions, and Transitions. Begin by opening a ToolboxST system and creatinga Mark VIe component (refer toChapter 6, the sectionCreation Wizard.

Creating an SFC� To create an SFC

1. From theMark VIe Component Editor , select theSoftware tab, then right-clickthePrograms item and selectAdd Program to add a program.

Right-click Prog1 , then select Add Special Task and Add Sequential Function Chart from the drop-down list. The Add Sequential Function Chart dialog box displays.

GEH-6700K Chapter 5 Sequential Function Chart (SFC) User Guide 5-1

2. From theAdd a Sequential Function Chart dialog box, add anSFC,then clickOK. The newSFC displays in theTree View .

From the Tree View , click newSFCto display the SFC logic editor .

From the toolbar, click the Edit SFCbutton to allow changes to the logic.

From the logic editor, you can define and edit the SFC.

Note When the SFC is created, the Initial Step is already defined.

The following properties are available in the Property Editor when theSFC item is selected in the Tree View:

Descript ion provides a description of the SFC.

Name is the name of the SFC.

EGD is the EGD page that contains all published variables from the SFC.

New Tran sition Condition Options sets the default contents ofthe Transition condition logic.

Protec tion provides access rights.

Put Action of Interest Status on EGD , if set to True, publishes theAction of Interest status variables on the EGD page.

Put Step Active Times on EGD , if set to True, publishes the ActiveTime variable for each Step on the EGD page.

Put Transition Progression Status on EGD , if set to True, publishes the Transitionprogression status variable for each Transition on the EGD page.

Version is the user-defined version of an SFC.

HMI Link Source is the source file containing visuals for SFC elements.

HMI Linked Object for SFC Network is the HMI object thatvisualizes the overall SFC network.

HMI Linked Object for Steps is the HMI object that visualizes an SFC step.

HMI Linked Object for Transitions is the HMI object that visualizes an SFC transition.

Execution Order sets the order in which the program is run.

Frame Multiplier is the number of frames at which the SFC task runs.

Schedule Offset is the offset from the beginning of the frame at which the SFC task runs.


Editing an SFC

� To edit an SFC

♦ From the toolbar, click theEdit SFC button.

The button changes to displayEditing SFC and the toolbar ispopulated with additional buttons.

Toolbar Buttons

Button Use to

Edit SFC

Toggle between editing and viewing modes

Run SFC

Run the SFC

Pause SFC

Pause the SFC

Reset the SFC

Reset a paused SFC (if the SFC is running, Reset is disabled)

Single Step

Place a Hold on every Transition in the SFC

SFC Status Display the following states:(Offline) indicates that the ToolboxST application is not online with the controller

PAUSED indicates that the SFC is not running (Action and Transition condition logic is not

running)RUNNING indicates that the SFC is active (Action logic in active Steps is running, and

Transitions are being evaluated

SINGLE STEP indicates that the SFC is active, but a Hold was placed on all Transitions.COMPLETE indicates that the END Transition was reached and the SFC is complete

Zoom In, Zoom

Out

Change the zoom level of the SFC logic editor

Select Tool

Select Steps and Transitions

Step Tool

Create a new Step

Transition Tool

Create a new Transition

END Transition Tool

Create a new END Transition

Alignment Tool

Align multiple selected shapes


� To add a Step

♦ From theSFC toolbar, click theStep button .

When you click the Step button and move thecursor to the logic sheet, Click to add Stepdisplays. Click to display the Add Step dialog box.

Enter a name, then click OK. Thenew Step displays in the logic editor.

� To add an Action

♦ From theSFC toolbar, click theSelect button , then double-click astep. TheEdit actions for step dialog box displays.

Click the Add Actionbutton to add an action.

From the Qualifier column, select theaction qualifier (refer to the table below).

Select the check box to makethis an Action of Interest .

From the Action Logic Sheet column,click Edit Action Logic to edit theblockware logic for the action.

From the Qualifier drop-down list, selectP:Pulse (Action runs once) , which causesthe Action to run only once when the Stepbecomes active.


Action Qualifiers

Qualifier Description

N The Action runs every frame that the Step is Active.

L The Action runs for a specific number of milliseconds while the

Step is Active, indicated by the Time value, then stops running.

D The Action does not run until the number of milliseconds indicated

by the Time value has been reached, after which the Action runs

every frame the Step is Active.

P The Action runs only once and is triggered by a rising edge on

the Action’s Pulse Input.

L and D Action Qualifiers : A Time value, either a reference variable or animmediate value, must be specified in the Time column for the Action.

P Action Qualifier : A Pulse Input Boolean value must be specified inthe Pulse Input column for the Action.

By default, a PERMIT block is automatically created in a new Transition. The outputof the PERMIT is connected to the Transition_Condition_Value, and any conditionsfor the Transition can be connected to the PERMIT’s inputs.

The PERMIT standardizes the Transition conditions so that HMI screens have acommon method to display information about Transitions.

Note The Active and Finished fields indicate the status of the Action.


� To define an Action’s logic

♦ From theSFC toolbar, click theSelect button, then double-click a step.The Edit actions for step dialog box displays.

An Action can be authored in Terms of Blockware in the logic sheet.

Note Always connect the Action_Finished local variable to a Boolean expression.The Action_Finished variable enables the Actions of Interest feature to know that theAction has finished its operation. This is recommended even if the application does notuse Actions of Interest.


Adding a Transition

� To add a Transition

♦ From the toolbar, click theTransition button , then move the cursor tothe sheet and click. TheAdd Transition dialog box displays.

Enter a name, then click OK. The newTransition displays in the logic editor.

� To define a Transition’s condition logic

♦ From the toolbar, click theSelect button, then double-click aTransition .

A Transition Condition can be authored in Terms of Blockware.

Note Always connect the Transition_Condition_Value local variable to the resultof the Transition Condition Boolean expression. The Transition_Condition_Valuevariable enables the SFC to progress if the Transition Condition Value evaluates Truewhen the Transition is Active.


� To use a Step’s Action of Interest status in a Transition condition

♦ From the toolbar, click theSelect button, then double-click aTransition .

Using a Transition condition’s Boolean expression, such as defining whether or not theconfigured Actions of Interest for the Initial Step have been completed, add a Move Blockwhose source (SRC) pin is “MySFC.Initial_Actions_Of_Interest_Status” global variableand whose destination (DEST) pin is “Transition_Condition_Value” local variable.

A Step’s Action of Interest Status is referenced from a Transition Condition.


Adding an End Transition

� To add an End Transition

1. From the toolbar, click theEnd Transition button .

2. Move the cursor to the SFC logic sheet to place the End Transition. TheAddTransition dialog box displays. Enter a name, then clickOK.

� To move a Step or Transition

1. From the toolbar, click theSelect button, then click the orTransition to be moved.

2. Move theStep or Transition to its destination.


� To connect Steps to Transitions

♦ From the toolbar, click theSelect button, then click theStep to be linked.

Move the cursor to the Transition to be linked.


Variable Connections

There are several required variable connections when defining SFCs in theToolboxST application. When defining a Transition’s Transition Condition,always connect the Boolean expression’s output to the Transition_Condition_Valuelocal variable. This enables the Transition to progress.

When defining a Step’s Action Logic, always connect a Boolean expression to theAction_Finished local variable. This enables Actions of Interest Control to be used in theSFC by having the Action state when it has finished. This is recommended even if Actionsof Interest Control is not being used in theapplication. It makes using the Actions ofInterest Control feature in the application much easier later in development if needed.


SFC Online Operations from the ToolboxST Application� To run an SFC in a controller from the ToolboxST application

1. From the Mark VIe Component Editor, click theGo On/Offlineicon to go online with the controller.

2. From theSoftware tabTree View , select the SFC item to open the logic sheet.

3. From the toolbar, click theRun button . TheRun SFC dialog box displays.

Click OK tocontinue.

4. To pause the SFC, click thePause icon to display thePauseSFC dialog box, then clickOK.

� To reset an SFC back to its Initial Step

♦ From the toolbar, clickReset button to display theReset SFC dialogbox, then clickOK. The reset Initial Step displays green.

Note The SFC must be either paused or complete to reset.


Changing SFC Modes

� To change an SFC’s mode

1. From the toolbar, click theMode button to display theSingleStep Mode SFC dialog box, then clickOK.

2. To place the SFC back into Free Running mode, click theMode button again todisplay theFree Running mode SFC dialog box, then clickOK.

Note When the SFC is placed into Single Step Mode, all Implicit Holds are removedfrom Transitions, and previously set Operator Holds are restored.

� To apply or remove Operator Holds

1. From the logic sheet, right-click theTransition , then selectApply HOLD toTransition to display theApply HOLD to Transition dialog box.

Click Yes to applyan Operator Holdto the Transition.

2. To remove an Operator Hold, right-click onTransition , then selectRemove HOLD from Transition .

� To ackn owledge a HOLD applied to a Transition

♦ From the logic sheet, right-click theTransition that has a HOLD applied, thenselectAcknowledge Hold to display theAcknowledge Hold dialog box.

Click Yes toacknowledgethe Hold.

Note If the Transition Condition for Trans1 was set to True at the time the HOLD wasacknowledged, the SFC would continue.

� To apply a FORCE to a Transition

♦ From the logic sheet, right-click theTransition then selectForce Transitionto display theForce Transition dialog box.

Click Yes to force the Transition to proceed.


Publishing an SFC on an EGD PageAn SFC’s Control and Monitor interface, which can be placed on anEGD page, includes the following items.

• Run

• Reset

• Transition Hold

• Transition Hold Acknowledge

• Transition Force variables

In addition, the SFC’s Step Active Flags, Transition Active Flags, and TransitionCondition Value are placed onto EGD automatically.

The user has an option to place items from the SFC Monitor Interface onEGD. These items include Action of Interest Status, Transition ProgressionStatus, and Step Active Times variables. By default, the Step Active Times areautomatically placed on EGD in the ToolboxST application.

� To place an SFC and its Control Interface on EGD

1. From a Mark VIe Component Editor, select theSoftware tab, thenfrom the Tree View , select an SFC.

From the Property Editor , select EGD Page. From the drop-down list, select the EGD page on which the SFC and its control interface will be published.

2. To remove the SFC from EGD, use the same drop-down list and select the blank entry.


� To place other SFC activities on an EGD page

From the Property Editor , select True for each of the SFC activities to place them on an EGD page.


Notes


Chapter 6 Mark VIe Component Editor

Creation WizardMark VIe components are created from the System Editor by usingthe Mark VIe Creation Wizard screens.

� To create a component

♦ From theSystem Editor Tree View , right-click the system name andselectInsert New from the shortcut menu.

Select Controller and Mark VIe Controller .The Mark VIe Creation Wizard displays.

GEH-6700K Chapter 6 Mark VIe Component Editor User Guide 6-1

Click Finish to accept the default libraries.A new controller component is added tothe system and the System Editorupdates to reflect the changes.


The Mark VIe component editor displays in theTree View and in theSummary View .


� To open the Mark* VIe Component Editor

♦ From either theSystem Editor Tree View or theSummary View , double-clickthe Mark VIe component. TheMark VIe Component Editor displays.

The Summary View provides anoverview of the item selected in theTree View . It can be used to monitor oredit an item.

Tabbed pages organizethe different elements ofthe component’sconfiguration.

The Tree View lists allmajor component items.The list changes when adifferent tab is selected.

The Property Editorallow you to edit the itemselected in the Tree orSummary View .

The ComponentInfoView displaysfeedback information onthe currently selected tab.

� To edit the component

♦ From theComponent Editor , click an item in theTree View . The configurationinformation for that item displays in theSummary View andProperty Editor .

Existing components can also be imported from a file.

� To im port an existing component


♦ In theTree View , right-click a parent component (either a system or a group),selectInsert Existing , then selectDevice . Select theDevice .xml filefor the component to be imported and clickOpen .

Summary ViewThe information displayed in the Summary View depends on the item selected inthe Tree View. There are many types of summary views ranging from the blockdiagram to simple lists of referenced files where no editing is possible.

Property EditorThe Property Editor allows you to view and edit the properties of the selected item.Properties are named values associated with the selected item. The configuration itemdisplays in the left field and the value displays in the right field.

The Min-max buttonallows you to quicklyresize the Tree View andthe Property Editorwithin their shared view.

The List by Categorybutton allows you to viewthe list of propertiesorganized by category.

Double-click on thedouble bar to view theProperty Editor in aseparate detachedwindow.

The Alphabetical Listbutton allows you to viewthe list of propertiesarranged alphabeticallyby name.

� To edit a property in the Property Editor

♦ From theProperty Editor , select an item by clicking its value field.The field can display several options:

Click theEllipsis button to change the value from a dialog box.


Click the drop-down list button to change the value from a drop-down list.

If no button displays, edit the value directly in the corresponding text boxon the right side of theProperty Editor .


Component InfoView

The color on the Statustab indicates the overallstate of the controller.

The Component InfoView contains several tabs that provide status information.(Depending on the open component type, additional tabs may also be available.)

Log tab displays messages related to user commands or system eventsissued in the ToolboxST configuration.

Tip � If there is a build problem, the error is listed on the Log tab. Double-clickthe error. The input focus goes to the location in the component configuration wherethe error occurred.

Status tab displays operating state and equality information aboutthe Mark* VIe component.

Histor y tab keeps a navigation history for each user session and allows you to returnto different places in the editor. Each time an item is selected in the Tree View orSummary View, the name of that item is added to the top of this list.

Where Used tab tracks variables in the Tree View or Summary View and displaysall other places in the controller where they are used.

Tip � From the Where Used tab, double-click the desired item. The input focus goesto the view represented by that line and the item is selected.

The write icon that displays at the beginning of some lines indicatesthat the variable is being written at that location.

Find Results tab displays the results of the Finder.

Info tab displays context-sensitive descriptions for the selected TreeView or Summary View item.


Log Tab

When the Log tab is selected, three buttons display in the toolbar atthe bottom of the Component Editor.

Click each of the buttons to hide the corresponding items (for example, click the Warning button to hide the warnings in the Log tab).

Each time a Build command is performed, the Log tab is updated with current errors,warnings, and general information. Concurrently, with each Build command, a file isgenerated in the component folder that reflects the contents of the Log tab. This file,called Build.log, remains until the next Build command then is updated.

The build.log is generated each time a Build command is performed.

Note To go to its location in ToolboxST, right-click either an Error or a Warning,then select Go To.


Data GridsData Grids are used to view or edit many of the configuration properties availablein ToolboxST component editors. While eachData Grid contains different columnsand properties, several features are common to all Data Grids, including columnresizing, clipboard operations, and multi-row editing.

Note Some Data Grids, especially those without an Append Row, may not support allfeatures described in this chapter.

Editing Data

To... Do this:

Edit a text or numeric valueLeft-click inside the cell to be modified. The cell changes into a

text box. Edit the contents of the cell as desired, and then press Enter to save your changes.

Edit an enumerated value

Left-click inside the cell to be modified. The cell changes into adrop-down list. Click the down arrow and select the desired value for the cell.

Edit a complex value

Left-click inside the cell to be modified. The cell changes into

a text box with an ellipsis button, indicating that a dialog box is available to change the cell

contents. To display the dialog box, click the ellipsis button.

Quickly set a property to the

same value for multiple rows

Left-click the row header for the first row to be edited. Then, while pressing the CTRL key,

left-click added row headers. After selecting all desired rows, use the Property Editor tochange properties for all selected rows. (Some properties are omitted when a group of rows isselected, and properties with conflicting values will display no value in the property editor.)


Organizing Columns

The columns of a Data Grid can be customized. You can select the columns that display,the column order from left to right, the column width, and the sort criteria.

To... Do this:

Resize a column Drag the vertical bar on the right of the column header to a new location.

Quickly remove a single column Right-click the column header and select Hide Column.

Move a column to a different location Drag the column header to a new location.

Sort by a column Click a column header. The column sorts in ascending order. To sort in descending

order, click the column header again.

Reset columns to the originalconfiguration

Right-click any column header and select Default Column Organization.

Add or remove columns Right-click any column header and select Organize Columns to display theOrganize Columns dialog box.


Copying and Moving Data

To… Do this:

Copy and paste a single row Right-click the header for the source row and select Copy Selected/Current Rows toplace the source row on the clipboard. Then, right-click the header for the append row

in the destination grid and select Paste Row(s) to insert the row into its new

location.

Copy and paste multiple rows Left-click the row header for the first source row. Then, while pressing the CTRL key,left-click added row headers. After selecting all desired rows, continue to hold down

the CTRL key and right-click any selected header. From the shortcut menu, selectCopy Selected/Current Rows to place the rows on the clipboard. Then, right-click the

header for the append row in the destination grid and select Paste Row(s)to insert the rows into their new location.

Copy and paste a range of two ormore cells

Click the top left cell of the desired range and drag to the bottom right cell. Right-clickthe selected region and select Copy Selected/Current Rows to place the cells on theclipboard. Then, click the top left cell of the destination range and drag to select the

same number of columns and rows that were copied to the clipboard. Right-click insidethe destination region and select Paste Row(s).

Move rows between data grids Arrange windows on screen so both the source and destination grid are visible. (An

entry in a Tree View is acceptable as a destination). Left click the row header for the firstrow. Then, while pressing CTRL, click any added row headers to be moved. Releasethe CTRL key and drag a row header to the new data grid.

Add a variable to a block diagram,Trender window or Watch Windowfrom a data grid

Arrange windows on screen so both the source grid and a destination block diagram,Trender window or watch window are visible. Then, drag the row header for the variableto the destination window.

Tip � You can copy and paste rows between different data grids if the columns matchby following the above procedures and navigating to a different data grid beforepasting the data.

Tip � Cells in a data grid can also be copied to and pasted from Microsoft Excel.The copied data is stored in .csv format, which contains no information about columnnames. To make sure pasted data is placed into the proper columns, do not changecolumn ordering and always select the exact destination range in the ToolboxSTconfiguration before pasting data from Excel.


Component OptionsThe ToolboxST application provides settings that change the way variousfunctions within the component operate.

� To open the Settings dialog box

♦ From theComponent Editor , select theOptions menu, then selectSettings to display theSettings dialog box.

Note In the Settings dialog box, categories are listed in a Tree View on the left sideof the dialog box.


The Mark VIe Controller options include the following.

Controller Parallel Online Download , when set to True, allows you todownload application code to redundant controllers in parallel.

Show Boot Loader displays the boot loader in the Download Wizardwhen it does not have to be downloaded.

Enable I/O diagnostic Alarm Events , when set to True, makes available I/Odiagnostic alarm events for automatic updates in the I/O Diagnostic Viewer.

Show Diagnostic Icons , when set to True, displays diagnostic icons inthe Tree View and serves as a permissive to show more enhanced diagnosticicons in both the Tree View and the Summary View.

Show More Enhanced Diagnostic Icons , when set to True, displays enhanceddiagnostic icons in the Tree View and the Summary View (Show DiagnosticIcons must be set to True for this option to be enabled).


SecurityThe security provided in the ToolboxST application is based on passwordsentered by the user. Passwords ensure that only authorized persons canview or make changes to system components.

The three types of protection available are called Access Rights.

Refer to Chapter 2, thesection SecurityST for moreinformation.

• Access Roles allows you to set Modify Data and Modify Design accessrights to pre-defined user roles. Once roles have been assigned to a protectedobject, only users with those roles can access the object.

• Modify Data allows you to make changes to data values associated with anobject without changing how it works. For example, it protects the initial value ofa variable defined in a controller. The purpose of this right is generally to keepunauthorized persons from making unsafe changes to settings.

• Modify Design allows you to change the way a protected object works.For example, this protects block creation and editing of connections withina library block diagram. The purpose of this right is to limit the ability tochange how the system works to authorized persons.

A protected object can have one or more of these access rights (refer tothe section,Protected Objects). Each right can have a different passwordset. Some objects can be protected if they are contained in another parentobject, which is protected by its own password(s).

Passwords

Whenever you attempt to perform an operation on a protected object,the Enter Password dialog box displays.

The title bar indicates which access right is protected.

Protected Locationindicates which object isprotected within the system.Although some object(s)may not be protected, theobject can be containedwithin another protectedobject. It is important toknow which object is askingyou to enter a password.

Enter the password, thenclick OK.

Note Passwords are case-sensitive –secret andSecret are not considered to be thesame password.


� To change an existing password

1. From theProperty Editor , expand theProtection item.

2. Select the desired access right, such asModify Design, and then click theEllipsis

button. If there is already a password on that access right and it has not yetbeen entered, you are first asked for the password before being allowed to changeit. The Change Modify Design Password dialog box opens.

The title bar indicateswhich access right thechange will apply to, forexample, Modify Design .

Enter the newpassword twice. A validpassword consists ofsix or more characters,letters, or numbers, andis case-sensitive. Click OK to apply

the change.

Password Caching

The security system caches passwords that were previously entered so that onceyou enter a unique password, you don’t have to enter that password again. Separatecaches are maintained for the system and each major component (such as a LibraryContainer). A cached password remains until the component is closed.

Note From the Device menu, select Restore Password Protection to clear all passwordsand protect the component.

Tip � If you have performed an operation in the ToolboxST application that requiresentering a password, it is recommended to close the protected component when you aredone so that an unauthorized user does not gain inappropriate access.


Viewing Protection Status

The protection status for a component displays in the Property Editor. The followingexample shows the protection for a Mark VIe component.

The Protection properties are as follows:

Access Roles allows you to set modifying data and design rightsto previously defined user roles.

Modify Data allows you to modify data values and forcing of variables.

Warning



Modify Design allows you to modify the component design.

Protected Objects

Specific actions governed by each access right depend on the specific componenttype. Examples of protected objects are:

System can only have a Modify Design password. If present, it preventsyou from adding or deleting system components.

Component can have Modify Data and Modify Design passwords. Modify Dataprevents you from saving changes or changing initial values for variables defined inthe component's application software. Modify Design prevents you from modifyingany aspect of the hardware or software configuration for the component.

User Block Library can have passwords for all three access rights. They have no directeffect on the block library, but are inherited by all block definitions within that library.

User Block Definition can have passwords for all three access rights. If blockpasswords are not applied, the passwords on the library container apply to the definition.

User Block Instanced in a program can be given its own passwords for Modify Data,Modify Design, or View Design. If none are assigned, it takes on the Modify Dataand Modify Design protection for the parent component. The passwords assigned toan instance of some block in a user block library are initially set to the passwords thatwere in force in the definition of that block. Once instanced though, any changes to theprotection on the block definition do not propagate to instances of that block.


Upgrading� To upgrade the ToolboxST application

♦ Install the new version. Refer to the section,Installation. The icons on your desktopand in yourStart menu are updated to start the most recently installed version.

The GE ControlST CD supports a variety of control equipment. These productsinclude updated firmware for the equipment and configuration tools that are availableas component editors inside the ToolboxST application. When you install a newversion of the CD, newer versions of some components may be installed as well. Touse the new versions, you must upgrade each component separately.

� To upgrade a component

1. Install new software for the component type that you want to upgrade byinstalling the latest version of the ToolboxST application.

2. Start theToolboxST application and open the system file. Double-clicka component to open its Component Editor.

3. From theFile menu, selectUpgrade . The Mark VIe ProductVersion Upgrade Wizard displays.

Click Next .


Compare To ControllerThis feature allows you to generate a report that compares the configuration inthe ToolboxST software to the controller configuration.

� To generate a Compare to Controller report

1. From theSystem Editor Tree View , double-click the Mark VIe componentto display theMark VIe Component Editor .

From the Filemenu, selectCompare toController .

The Select Channel dialog box displays.

2. Select the desired channel, and clickOK.

The report displays configuration differences in areas such as hardware and software.Differences are arranged in appropriate groups and sub-groups.


Compare DevicesThis feature allows you to compare the configurations of two different components.

� To generate a Compare Devices report

From the File menu, selectCompare Devices… .When the Pick Items toCompare dialog boxdisplays, select thecomponent to be compared.

A Compare Results : window displays differences between the two selectedcomponents, as shown in the example below.


Mark VIe Menus

Menu Command Use to

Save Save changes to the current system

Print Generate a paper copy of the entire component configuration

Upgrade Change the version of the component support software

Compare to Controller Compare the ToolboxST configuration for a controller against the actual

configuration downloaded to the controller

Compare Device byProgram(s)

Compare individual program(s) in the ToolboxST configuration for a controlleragainst the same programs in the actual configuration downloaded to the

controller

Compare Devices… Compare ToolboxST component configurations

Import Import an I/O Variable or Configuration report, a Global Variable report, a Block

Pin report from a .csv file, or a Variable Alias report, or Second Language report

from a .csv or .xml file

File

Close End the component editing session and return to the System Editor

Undo Remove the item currently selected in the Tree View

Redo Add a new component to the current system

Cut Cut the selected item in the Tree View

Copy Copy the selected item in the Tree View

Paste Paste the copied item in the Tree View into the Summary View

Delete Display the System Information Editor (refer to the section System Information

Editor)

Find Display the Component Editor for the item currently selected in the Tree View

Edit

Bookmarks Mark and toggle between items in the Tree View

Go Back Return to the view that immediately preceded the current view in the history

Go Forward Return to the view that immediately follows the current view in the history

Forced Variables Display a list of forced variables

Warning

Logic forcing procedures can result in personal injury or death, if notstrictly followed. Only adequately trained personnel should modify any

programmable machine. Forcing of control logic for an operating processis strongly discouraged.

Forcing of protective functions is never permissible for an operating unit.All safety measures should be strictly enforced in conjunction with thisprocedure.

Global Variables Display a list of global variables

Trenders Display a list of Trenders for this component (refer to Chapter 8, Trender)

Watch Windows Display a list of Watch Windows for this component (refer to the section, WatchWindow)

LiveViews Display live data from the open component

Reports Generate any of the following reports:Variable generates a report of all global or configuration variables in the

View


Menu Command Use to

component. You can also generate a Web variable report, a CompressedData Log variable report, an EGD variable list report, Alias report, or a SecondLanguage report

Block Pin generates a list of all block pins in the configurationI/O generates an I/O variable report or an I/O configuration report.

Alarm generates a list of all variables marked as alarms

Hold generates a list of all variables marked as holdsEvent generates a list of all variables marked as eventsNovRAM generates a report of all variables marked as non-volatile

IONet EGD provides network status values of all IONet communicationdisplayed in the current component

I/O Diagnostics generates a report of all faults, revisions, communication,

and hardware issuesCoding Practices generates a list of unwritten variables, a list of multiple

writes, and a list of unused I/O variables

Auto-Reconfiguration generates either a Configuration report or aDifference report

Control Constants Generate a list of control constants (refer to the section, Control Constants)

Diagnostics Display regular and advanced controller diagnostics, as well as I/O diagnosticsand I/O status

Profiler Display the Controller Load Profiler window

EGD ManagementTool

Start the EGD Management Tool (refer to GEI-100619, EGD Management Tool(EMT)

I/O Checkout Verify that Mark VIe I/O points are operational

Disagreements View the disagreements (for example, exchange vote data and output voting)among redundant controllers in a TMR configuration.

Online Connect or disconnect from a controller

Build Convert the current configuration into binary files that can be downloaded to acontroller

Download Perform any of the following download functions:Controller Setup opens a wizard that allows you to perform basic

configuration tasks

Download Wizard… downloads base load, firmware, and application codeto the controller and distributed I/O modules

Update Dynamic Data Recorder exchanges updated information with

the DDRs in the controllerView/Set Time… displays a dialog box that manages the controller time.Backup Files to Controller provides file backup.

Upload Retrieve configuration information from the controller and uses it to create a newcontroller component in the system

Put Device to SDB Store the component configuration to a System Database (SDB)

Compress Rearrange variables to minimize the amount of space used

Administer Totalizers Open the View/Set Totalizers dialog box

Device

Restore PasswordProtection

Clear all passwords and protect the component


Menu Command Use to

Options Settings Display a dialog box to select Mark VIe controller settings

Contents Open the Mark VIe editor help file

Controller H elp Open the Mark VIe controller help file

Distributed IO Help Display a list of pack help files to open

Release Notes Display any of the following release notes:

ToolboxST displays current information about your version.

Mark VIe displays current information about your version of the Mark VIesupport software

Distribut ed IO allows you a list of pack help files to open.

How To Guides Display a list of available ToolboxST How-to Guides

Send Problem Report Display a System Change Request form to report any system issues

Help

About Display version and copyright information


General TabThe General tab allows you to configure general properties and attributes of aMark VIe controller, including redundancy (simplex, dual, or Triple ModularRedundant (TMR)) and frame rate (its basic scheduling rate).

� To configure Mark VIe general features

♦ From theSystem Editor , double-click theMark VIe Component to display theMark VIe Component Editor . TheGeneral tab is selected by default.

The Tree View lists theitems that can be configuredon the General Tab .The list of items changeswhen a different tab isselected.

Property Editorallows youto edit the itemcurrently selected in theTree View .

The Component InfoViewdisplays feedbackinformation about thecurrently selected item.

The Summary View provides anoverview of the controller.


The following properties are available in the Property Editor when theGeneral item is selected in the Tree View:

Command Event Log stores information about alarm transitions, event transitions,variable set commands, and such on the controller file system. This data can beviewed for analysis by an external client through a web interface.

% Command Size specifies the maximum size (as a percentage) of both thecommand and event portions of the Command and Event log.

% Event Size specifies the maximum size (as a percentage) of theevent portions of the Command and Event log.

Log to Disk specifies whether Command events should be loggedto the CompactFlash on the controller.

Time specifies the number of days that the Command and Event log iskept if the allocated space is not exceeded.

Compressed Data Log activates the compressed data logging, which causesselected variables to be collected in the controller data log file.

Note The Compressed Data Log property is only available when the applicationrunning is a 1.5 MW Wind Turbine.

% Size specifies the maximum size (as a percentage) of the Compressed Data log.

Average Interval Time specifies the interval in minutes over whichthe data is averaged and stored.

Enable Compressed Data Log , when set to True, activates the Compressed DataLog. This causes selected variables to be collected in the controller data log file.

Note When set to False, a major configuration difference occurs that forces an offlineload.

Time specifies the number of days the Compressed Data log is kept solong as the allocated space is not exceeded

Controller Web Pages , when set to True, enables access to controller web pagesif they are provided by the controller or another product. The controller can providea set of default pages as part of the firmware download. Product web pages canalso be downloaded to the controller. For example, the 1.5MW Wind Turbine usesproduct-specific web pages that are downloaded separately.

Enable Controller Web Pages , when set to True, activates the Web serveron the controller. It also displays the Web Page Tab.


Password allows you to create or change a password.

Web File Path is the directory used as the web page source whendownloading product web pages to the controller.

Application reflects the application type.


Controller Backup Option determines how backup files are handledduring the Build and Download commands.

Automatic , the default, creates backup files in a device.zip file during a Buildcommand, and provides an option in the Download Wizard to download the device.zip file.

Manual mode does not create a device.zip file so there is no option todownload backup files from the Download Wizard.

Description is a functional description of the current controller.

Enable Alias Prefix , if set to False, disables the prefixing of the aliaswith the device name (the default is False).

Enable Auto-Reconfiguration , if set to False, disables the Auto-Reconfigurationfeature (the default is True).

Major Revision is the time of the build performed after the most recent major change.(Major changes require the controller to be restarted after download.)

Minor Revision is the time of the build performed after the most recent minorchange (minor changes do not require a controller restart).

Name reflects the name of the current controller as set in the System Editor. It is read-onlyin the Mark VIe Component Editor and can only be changed from the System Editor.

NTP Configuration Mode determines how the Network Time Protocol clientsynchronizes the controller time. Valid options are:

• Disabled – The controller does not perform any time synchronization.

• Broadcast – The client listens for NTP broadcasts on the network.

• Unicast – The client uses the specified servers to obtain the time.

Note Disabling NTP results in a major configuration difference that forces an offlineload.

Configuration Manual Override , when set to True, allows you to manually overrideall settings for the local device rather than use the settings configured at the system level.

Mode is the mode of the NTP client.

NTP Configuration Primary Server is the IP address of the primaryserver used when unicast mode is selected.

NTP Configuration Secondary Server is the optional IP address of a secondary(backup) server used when unicast mode is selected.

Platform is the type of hardware on which the Mark VIe control code is started.

Product Version is a read-only property that reflects the version of the Mark VIeproduct associated with the selected component. The version number is set when theconfiguration is first created, and is updated with each upgrade operation.

Profiler Enabled determines if the controller load profiler is enabled.


Protection provides the following two access rights:

• Access Roles are assigned to protect each access right for this component.

• Modify Data permits modification of data values and the forcing of variables.

Warning

Logic forcing procedures can result in personal injury ordeath, if not strictly followed. Only adequately trainedpersonnel should modify any programmable machine.

Forcing of control logic for an operating process isstrongly discouraged.


• Modify Design permits modification of the design of the controller.

Redundancy determines the level of redundancy of the controller. Thefollowing choices are available:

• Simplex – a single non-redundant controller.

• Dual – a two-controller configuration where one controller providesbackup for the other.

• TMR – a triple module redundant configuration where there are threecontrollers that vote on decisions for reliability.

OPC Properties includes the following two properties:

Active Diagnostics Severity defines the OPC AE severity value fora diagnostic alarm in the active condition. This value is used for displaypurposes on the WorkstationST Alarm Viewer.

Normal Diagnostics Severity defines the OPC AE severity value fora diagnostic alarm in the normal condition. This value is used for displaypurposes on the WorkstationST Alarm Viewer.

Background Period reflects the timeframe, in seconds, of blockswith background methods.

Frame Period determines the frame period in milliseconds. A frame is the basis forMark VIe scheduling; the frame period determines the fastest scan time, the rate at whichfirst class I/O is scanned, and the fundamental frequency for the scheduling of all tasks.

Note The two properties below are only available when the application running is a1.5 MW Wind Turbine.

Enable Wind Farm Management System , when set to True, allows a windturbine to be controlled by the wind farm controller.



Wind Farm Management Server IP Address displays the IP addressof the Wind Farm Management Server.

Note The four properties below are only available when the application running is aWind Control.

Max Wind Farm Turbines is the maximum number of wind turbines for thisWind Control. If this number is reduced after the turbines have connected, thoseturbines are disconnected from Wind Control when the timeout parameter setin the Wind Turbine Timeout (sec) property is reached.

Wind Farm Master Number is the master plant number for this Wind Control.

Wind Farm Update Time (ms) is the time, in milliseconds, to update all wind turbines.

Wind Turbine Timeout (sec) is the time, in seconds, at which timeoutdata is received from the wind turbines.

Password Protection

If passwords were set for this component, changing the followingproperties requires a password.

Modify Data Modify Design

Command Event Log properties (%

Command Size; % Event Size; Log to

Disk; Time)

Enable Controller Web Pages

Controller Backup Option

Description

Enable Auto-Reconfiguration

NTP Configuration

Platform

Profiler Enabled

Redundancy

OPC properties (Active DiagnosticsSeverity; Normal Diagnostics Severity)

Scheduling properties (Background

Period (sec); Frame Period (sec)

Note The first time you attempt a password-protected function, the Enter Passworddialog box displays. All protected functions performed during the remainder of theToolboxST session do not require re-entering the password.


Attributes

Attributes are device-level values that affect how the configuration is generated.When the Attributes item is selected in the Tree View, those controller attributescan be edited in the Summary View data grid.

The following columns are available:

Name is a unique identifier for the attribute.

Description stores added comments about the attribute.

Value displays and modifies the current attribute value.


Attribute Value Editor

The Attribute Value Editor allows you to enter values for a wide variety of data types.

� To open the Attribute Value Editor

♦ From an attributeData Grid , click a Value Cell , and then click the ellipsis

button. TheModify Value dialog box displays.

The name ofthe attributebeing modified

The value ofthe attribute

If checked, theattribute valuesare restricted toan enumeration(a predefined setof allowablevalues).

The Data Typeof the attribute

To add a value to the enumeration, enter theName,Value , and (optionally) a Description , then click OK.

If the attribute uses anenumeration, use this drop-downlist to select a predefined value.


Network Adapters

The network adapters that are present in the controller display as items in the Tree View.The number of adapters depends on the controller’s hardware type and configuration. Inmost applications, Mark VIe controllers have four network adapters. The first adapterprovides connectivity to the Unit Data Highway (UDH), and any additional adapters areused for I/O networks. Some adapter properties may be disabled in certain configurations.


When a Network Adapter item is selected in the Tree View, the followingproperties display in the Property Editor:

Enabled , if set to False, disables the selected network adapter.

Host Name is the Internet Protocol (IP) host name for the selected network adapter.

IP Address is the IP Address for the selected network adapter.

Wire Speed is the speed of the network to which the selected adapter is connected.

Network sets the network connected to the selected adapter. (Availablenetworks are determined in the System Editor.)

Subnet Mask controls which portions of the IP address are deemed significant.(This property is usually unavailable; for I/O networks, the subnet mask isalways a fixed value, and for other networks defined at the system level, thesubnet mask is configured in the System Editor.)


Auto-Reconfiguration

The ToolboxST application provides a feature called Auto-Reconfiguration, which allowsyou to replace a pack and have the necessary configuration files downloaded when thatI/O pack is replaced. It requires no user interaction once power is restored to the packafter replacement. The Auto-Reconfiguration feature is enabled from the PropertyEditor. This feature is available with GE ControlST release V03.05 or higher.

From the Generaltab PropertyEditor , select Falseto disable Auto-Reconfiguration .

Note The Auto-Reconfiguration feature applies only to I/O packs; it is not availablefor controllers or terminal boards. Refer toGEH-6721, Mark VIe Control System Guide,Volume II, for a list of I/O packs


Hardware TabThe ToolboxST application manages I/O packs and terminal boards through a logical unitcalled an I/O module. An I/O module consists of up to three I/O packs connected to a mainterminal board and (optionally) one or more auxiliary terminal boards. The configurationis known as a simplex configuration when one I/O pack is present, dual if two I/O packsare present, and TMR if three I/O packs are present. (The configuration of moduleredundancy is independent of the network redundancy and controller redundancy settings.)

To help with identification and version management, each I/O pack has an I/Ocompatibility code and a configuration compatibility code. These codes identify the I/Omap layout and the configuration area for a pack. For each compatibility code set, thereare multiple hardware forms used to identify physical characteristics of the pack. EachI/O pack module that can be added to a Mark VIe controller is identified by both itshardware form factor and its compatibility codes. For example, PDOA_2_2 representsthe discrete output module with I/O compatibility code 2 and configuration code 2.

Note Removing all WCBM packs causes a major configuration difference that forcesan offline load.

Password Protection

If passwords were set in the General tab Property Editor for this component,the following functions require a password.


Add Module

Add Group

Attach Layout Drawing



Network Redundancy

A controller can have one, two or three I/O networks in a simplex, dual orTMR configuration. The configuration of network redundancy is separatefrom controller redundancy and module redundancy.

� To change the network redundancy

♦ From theHardware tabTree View , select theDistributed I/O item.

Select the NetworkRedundancy item in theProperty Editor , thenselect Simplex , Dual , orTMR from the drop-downlist.


Adding Modules

� To add a module to a component configuration

♦ From theHardware tab, right-click theDistributed I/O item in theTree Viewand selectAdd Module to display theAdd Module Wizard .


Click Next .

Select the I/O packRedundancy type:Simplex if one I/O pack ispresent, Dual if two I/Opacks are present, andTMR if three I/O packs arepresent. The HotBackupoption provides dual I/Opacks with one activegateway and one backup.

Select a module type. (Thetypes of available modulesvary based on I/O packredundancy.

Note If the module being added does not have an auxiliary terminal board, the windowshown below does not display.


Use the Version drop-down list to select a moduleversion. Listed module versions depend on the availablecompatibility codes.

Click the ReleaseNotes button toview additionalinformation aboutthe currentlyselected moduleversion.

If the Module Requiredcheck box is selected,the module must bepresent and functioningfor the controller to goonline.

Click Next topreviewconfigurationinformation.


Review the configuration summary,and then click Finish to add thenew module.


Organizing Modules

Modules can be organized into groups.

� To create a group

♦ From theHardware tabTree View , right-click theDistributed I/O item andselectAdd Group. The Add Group dialog box displays.

Enter a Name (up to eightalphanumeric characters).

Select the Type (Cabinet or General)from the drop-down list. SelectingGeneral changes the icon to a folderlabeled I/O.

Enter aDescription ofthe group(optional).

Select the Icon todisplay in the TreeView .

Click OK.

� To add modules to a group

♦ From theHardware tab Tree View , drag a module to the desired

group. When the mouse pointer changes to a symbol, releasethe mouse button to move the module.


Modifying Modules

� To modify an existing module

♦ From theTree View , right-click the module to modify, then selectModify... fromthe shortcut menu to display theModify: [module name] dialog box.


Viewing Modules

Group Layout

Click the foldericon to selectgroup layout.

Network Layout

Click the foldericon to selectnetwork layout.

When you select a module from the Tree View, several tabs display in theSummary View. Each module contains four common tabs (Summary, Parameters,Variables, and Diagnostics). Many modules also contain custom tabs that configureavailable I/O capabilities. For information about the settings configured by I/Opack-specific tabs, refer to the I/O pack documentation.

For example, the following set of tabs (taken from a PDOA module) containsthe base set, as well as two other tabs, Inputs and Outputs.


Summary Tab

The Summary tab displays a graphical overview of the selected module.


Parameters Tab

The Parameters tab allows you to configure all module-specific parameters.After a parameter is changed, updated pseudocode files must be downloaded tothe I/O packs, but the download operation is done online and does not requirea reboot of either the controller or the I/O packs.

Note Some infrequently used parameters are classified as Advanced and are hidden

by default. To displayAdvancedparameters, click theShow/Hide Advancedbutton on the toolbar.

Variables Tab

The Variables tab displays available variables from the module that have nophysical endpoint. These variables exist only internally in the module, andcan be connected to another variable for use in code.

Inputs/Outputs Tab

This tab contains I/O points (with associated screws in sub-tabs) that have no meaningto software or firmware, such as those used for excitation.

ExtraCircuits Tab

This tab contains input/output variables found on the module terminal boards, whichcan be associated with the application software. For some modules, these tabs are splitinto more module-specific input/output tabs that better define their function.

Inputs/Outputs Tabs

These tabs contain input/output variables found on the module terminal boards,which can be associated with the application software.


Note For some modules, these tabs are split into more module-specific input/outputtabs that better define their function.

It is possible to attach a software variable to an I/O variable. A softwareitem (programs, tasks, and such) must be defined in the Component EditorSoftware tab before this feature can be performed.

� To attach a software variable to an I/O variable

♦ From theData Grid , select a variable.

From the Connected Variablecolumn, click the Ellipsis button.

The Select a Variable dialog box displays.


Click Yes to display theSelect Where to PlaceVariable dialog box.

Select the softwareitem in which toplace the variable,then click OK .

Alternately, use the following method to attach variables.

Type the variable name,then press theEnter key.

If the variable name entered is a defined variable, it continues to displayand the cursor moves to the next field.

If the variable name entered is undefined, theUndefined Variable dialog boxdisplays. ClickYes to select the desired software item, as shown above.


Diagnostics Tab

The Diagnostics tab allows you to check the I/O pack alarms and errors thatexist on I/O packs. Each pack has a unique set of diagnostic signals that can bemonitored. For more information about the fault codes used in an I/O pack, referto theDiagnostics section of the I/O pack documentation.

The stateof the fault.

Information about icons:

Inactive Alarm(s)

Active Alarm(s)


Status Tab

The Status tab allows you to check the I/O pack version and network communication status.

Prod ID EGD producer ID of this exchange

Exch ID EGD exchange ID

Health EGD health status

Period The cyclic period (ms) in which this exchange is transmitted

Size The size of the exchange in bytes

Port Port connectivity (IONet connection)

Recv Cnt The number of times the exchange was received

Missed Cnt The number of times the exchange was not received

Late Cnt The number of times the exchange was later than expected

I/O pack version equal

I/O pack version unequal


Upgrading Modules

It is possible to perform an upgrade to the runtime and the I/O firmwaresimultaneously. The component and specific I/O modules can be upgraded toa newer version of the runtime and firmware, as well.

� To perform a unified upgrade

From the Filemenu, selectUpgrade... . TheMark VIe Productand IO PackVersion UpgradeWizard displays.

Click Next to continue.


From the New column, select the new version for the upgrade.

Note Modules can be upgraded to a different compatibility code set if one is available.


� To upgrade a single module

♦ From theHardware tabTree View , right-click the module to be upgraded andselectUpgrade . TheUpgrade Module Wizard displays.

For the example module shown below, there are two module versions available: a PDOAwith compatibility code set 2,1 and a PDOA with compatibility code set 3,1.

Click a new mversion to upgthe module.


Enter the Bar Code forthe Terminal Board .

Click Next to continue to theconfiguration display screen,then click Finish .

Note When the ToolboxST V03.05 application is installed, the Upgrade option allowsyou to upgrade Mark VIe-related packs to work with the Auto-Reconfiguration feature(refer to the section,Auto-Reconfiguration). After a component has been upgraded,you cannot undo the upgrade. You also cannot upgrade a component to its current ora previous revision. Only newer revisions display in the drop-down list of revisionoptions in the Upgrade Wizard.


Diagnosing Modules

When a problem with a module is detected, symbols display in theSummary tab. All symbols provide ToolTips.

The I/O Diagnostic viewer provides a utility to interrogate I/O pack faults,version, and diagnostic communication data. Diagnostic I/O pack reports canbe generated on a pack, module, or component level.

Note You must be online to view diagnostics (except for reports).

The following are Tree View Symbols:

Error (ex. link unhealthy)

Warning (ex. active alarm)

Informational (ex. inactive alarm)

Normal

The Summary tab, with diagnostic information displayed, is shown below.


The following are Summary tab diagnostic symbols:

Inactive Alarm(s)

Active Alarm(s)

I/O pack version unequal

I/O pack version status indeterminate

Link broken

Link error

Link warning

Link information

Note Place the mouse over the icon to display detailed messages regarding theproblem.


I/O Diagnostic Viewer

� To start an I/O diagnostic viewer

♦ From the Summary tab, left-click an I/O pack or terminal board, then selectTroubleshoot andStatus from the context menu to display the viewer.

Note For more information, refer to the section,Diagnostics Tab.


I/O Diagnostics Report

� To create an I/O diagnostic report

♦ Left-click an I/O pack or terminal board in theSummary tab, then selectCreatemodule Report . The desired I/O pack report is created.

Reporting Board Data

The ToolboxST application can generate the following I/O-related reports:

• I/O module Fault Report

• I/O module Revision Report

• I/O module Communication Report

• I/O module Hardware Report

Each report contains configuration or diagnostic details about the I/Ohardware in a component.


� To view or print a module report

♦ From theHardware tab Tree View , right-click Distributed I/Oand selectCreate Module Report .

The I/O report for the component displays.


Working Online

Downloading Parameters

After modifying parameters in a module, you must download to the module before the newsettings take effect. Downloads to a module are separate from downloads to a controller.

� To download parameters to a module

♦ From theHardware tab Tree View , right-click the module to bedownloaded and selectDownload Parameters .

Comparing Parameters

While making changes to a module’s configuration, it is often useful to comparethe downloadable configuration items currently stored in the pack with the currentconfiguration of the same items in the ToolboxST application.

Caution

As module parameters directly affect the operation ofthe controller and associated I/O modules, always checkthe Compare Parameters dialog box before downloadingnew parameter values to a component to reduce the riskof improper operation or damage to the unit.

� To open the Compare Parameters dialog box

♦ From theHardware tabTree View , right-click a module to compare and selectCompare Parameters . TheDifferences dialog box displays.

The differences between the controllerand the ToolboxST configuration aredisplayed in a hierarchical tree view.

Click OK to upload the selectedvalues from the controller intoToolboxST, replacing your changes.


Send Controller Problem Report

This feature allows you to report problems with the controller and/or any configured I/Omodules. The report is generated, then attached to an email to the ToolboxST support team.

� To send a controller problem report

From the Help menu (when theHardware tab is selected), select SendController Problem Report . The SelectIO Module(s) dialog box displays.

Select the I/O modules to be includedin the report, then click OK. When theprogress bar displays complete, theSubmit SCR dialog box displays.


� To send an I/O module report

From the Tree View , right-click a pack item, then selectTroubleshoot and SendProblem Report .

When the progress bardisplays complete, theSubmit SCR dialog boxdisplays.


� To submit an SCR

Enter the appropriate information,then click the Send button.To save the report, click the Saveto File button.

To display a report preview,click the Preview button.

Sample Problem Report Contents

File Type Provides

Error Log (controller and

I/O module)

.txt All timestamped alarms in the controller. Each alarm message also contains the

code file name and line number.

Event Log (controller andI/O module)

.txt All timestamped events in the controller. Each event message also contains thecode file name and line number.

Diagnostic History(controller and I/O module)

.txt All diagnostic messages sent to the ToolboxST application and other clients.

EGD Info History

(controller)

.txt EGD information/statistics for the controller (for example, number of

produced/consumed exchanges, late counts, missed counts)

Revision Info (I/O module) .xml Boot/base/firmware revision data for I/O packs present in the ToolboxSTconfiguration and in the I/O pack to confirm revision equality.

System topology history(controller)

.xml Information about the I/O pack configuration (for example, module name,redundancy, parameters)


Software TabThe Software tab in the Component Editor contains all applicationsoftware downloaded to that controller.

The Programs item at the top of the Tree View holds all programs in the controller.Its shortcut menu contains actions that affect all programs, such as changing libraryreferences and instancing all linked user blocks. The shortcut menu also containscommands to add a new or existing program to the controller.

Password Protection

If passwords were set in the General tab Property Editor for this component,the following functions require a password


Add Program

Add Program Group

Add Task

Add Special Task

Add Variable



Adding a Program

The Programs item allows you to add programs to a controller.

� To add a program

♦ From theTree View , right-click thePrograms item to displaythe Programs shortcut menu.

From the shortcutmenu, select AddProgram . The AddProgram dialogbox displays.


Adding a Program Group

� To add a program group


Select Add ProgramGroup from theshortcut menu todisplay the Add NewProgram Groupdialog box.

Enter a name for the newprogram group then click OK.


Adding an Existing Program

� To add an existing program


Note The Add Existing Program command reads an .xml file from another systemor controller into the current controller.

Select Add ExistingProgram from the shortcutmenu. The S elect ExistingProgram screen displaysto allow you to select thedesired .xml file.


Library References

A controller has two types of libraries:

• Function block libraries that describe software that comes as partof the controller firmware

• User block libraries that combine these function blocks into user blocks

� To reference a user block library

1. From theTree View , right-click thePrograms item, then selectLibrary References . TheLibrary References dialog box displaysall block libraries in two tabs.

2. From theUser Block Libraries tab, select the check box next tolibraries that you want to reference in this controller. Clear check boxesfor libraries that should not be referenced.

If all system libraries areincluded, select the top-level check box. If all theblocks of a LibraryContainer are included,select the check box for anitem at the third level.


� To reference a function block library

1. From theTree View , right-click thePrograms item, then selectLibrary References. The Library References dialog displaysall available user block libraries.

2. From theOptional Libraries tab, select the check box next tolibraries that you want to reference this controller. Clear check boxesfor libraries that should not be referenced.

Click the Add Library button toadd an external function blocklibrary. A Browser windowdisplays the available .dll files.This command is a special casewhere the .dll file contains controller firmware and isnot covered in this document.

Instance All

The Instance All command creates a new copy of all linked user blocks fromthe referenced user block libraries. In addition to updating the user blocks, thiscommand causes the instance scripts and text substitutions to run.

Note It is not possible to undo this command.


Overridable Properties

It is possible to select properties to be overridden.

� To select overridable properties

From the Tree View, right-click the Programs item,then select OverridableProperties . TheOverridable Propertiesdialog box displays.


Adding a Task

Tasks can be inserted within a program:

� To add a task

♦ From theTree View , right-click on an embedded or unlinked programname to display the shortcut menu.

Enter a Name to insert anembedded task

ORClick the Select Library Blockcheck box to insert a linked task.

Select a category and adefinition from that category.Enter a name for the linked task.

Click All to display all ofthe Categories andDefinitions .

Click None to de-selectall Categories .


Adding a User Block

� To add a user block

From the Tree View, right-clickthe task name to select AddUser Block from the shortcutmenu. The Add User Blockdialog box displays.

Note The Add Task and the Add User Block dialog boxes are identical except for thetitle bar, which shows how the new user block is used.

A user block can either be linked from a user block library, or embedded,acting as a container for function and user blocks.

Instancing a user block updates it to the latest version from the user block library.Embedded and unlinked user blocks are disconnected from the library, so instancinggoes through the blocks in that user block and instances the linked user blocks.

� To instance a user block

Right-click the userblock to selectInstance from theshortcut menu.


The Summary View of a user block displays the block diagram for either theuser block selected in the Tree View or its container.

If the task is selected, the blockdiagram displays the contents ofthe task, as follows.

If a user block is selected within a task, and thecontents of the selected block are collapsed and notvisible, the block diagram displays the contents of thetask with the user block selected in the Summary View.


If the selected block is a user block within a task,and the contents of the selected block are expandedand visible, the block diagram displays the contentof the selected user block, as follows:

Finally, if the selected block is a function block,the block diagram displays the contents of thecontainer user block with the function blockselected in the Summary View , as follows:


Unlink Permanently

A program that is linked to a library container can be permanentlyunlinked from the component.

� To unlink a program

♦ From theTree View , right-click a program item, then selectUnlink Permanently .

The linked icon next to the item in the Tree View changes and theprogram is unlinked from the library.

Note Linked tasks and user blocks can also be unlinked permanently.


Property Editor

The Property Editor displays different properties, depending on whichitem is selected in the Tree View.

Programs Item Property Editor

The Programs Property Editor displays the following property.

Use the drop-down list to select.

Remove Unused Variables removes the unused variables for all linked userblocks in this device when the user block is instanced.

Program Property Editor

The Program Property Editor displays the following properties.


Description allows you to describe the program. Click Description

and then click to enter text.

Library Type is only used for legacy Mark VI software conversion.

Name allows you to name the program.

Protection properties control theAccess Roles, Modify Data , ModifyDesign , andView Design permissions for this program.

Execution Order sets the order of execution of this program in the controller.

Task Property Editor

The Task Property Editor displays the following properties.

BlockType is the name of the user block definition in the libraryfrom which this task started.

Description is the description of this task.

Name is the name of this task.

Protection properties control theAccess Roles, Modify Data , ModifyDesign , andView Design permissions for this task.

Version is the user-defined version of a task.

Execution Order sets the order of execution in the program.

Frame Multiplier is the number of frames at which the task runs.

Schedule Offset is the offset from beginning of frame at which the task runs.


User Block Property Editor

Block Type is the name of the library block that the selected block is an instance of.

Instance Name is a unique identifier that allows the block to be referencedfrom other locations in ToolboxST.

Instance Script causes the script to run when the block is instanced.

Height is the height of the selected block in the diagram.

Left is the location of the left of the selected block.

Selected Pin is the pin currently highlighted in the diagram.

Show Description, when set to True, displays the description of the selected block.

Top is the location of the top of the selected block.

Width is the width of the selected block.

Block Data Type is the data type for variant pins in the selected block instance.

Detached Summary File is the backsheet for the selected block.

Enable , when set to True, enables variables for the selected block.

Version is the version number for the source of the selected block instance.

Execution Order determines when this block is started.


Variables

Program variables are global variables associated with a particular program. The variablesdisplay under the Programs item in the Tree View. Undefined variables for a programare global variables that have been referenced in a controller, but have not been definedas part of a program or user block. Undefined variables for tasks and user blocks arelocal variables that have been referenced within the task or user block.

� To add a variable to a program

♦ From theSoftware tab, expand thePrograms item.

Right-click the Variables itemand select either Add Variableor Add Undefined Variablesfrom the shortcut menu.

The Add New Variable dialog box displays.

Enter the variablename, then clickOK. The newvariable displaysin the Data Grid .

User block and task variables are local by default, and display under theassociated user block item in the Tree View.


Editing Variables

Variables can be edited in the Data Grid and Property Editors. The Data Grid isused to view or edit variable definitions, and can be configured to display a subsetof the variable properties. Refer to the section,Data Grids.

Note Variables can also be added in the Summary View by directly editing the lastrow of the variable grid.


Alarm Severity is the value assigned to an alarm in the active state. The validrange is 1 through 1000, where 1 is the least severe.

Alarm , if set to True, enables the variable as an alarm. Alarms are used forproblems that require the operator’s attention and acknowledgement. The alarmqueue consists of a list of time-tagged alarm state transitions.

Alarm Class selects a System Configured Alarm Class, used by theHMI to classify and colorize alarms.

Alarm Inhibit Group selects the alarm inhibit group for the alarm variable.

Alarm On Zero , if set to True, causes the alarm on a 1-to-0 transition.Requires that the Alarm be set to True.

Event , if set to True, enables the variable as an Event. Events are stateless messagesthat are not queued within the controller. When an event occurs, a time-taggedtransition message is sent to any HMIs that have signed up for events.

Hold , if set to True, enables the variable as a Hold, which is similar to an alarm. The holdqueue contains a list of time-tagged hold states in the turbine startup sequence.

Normal Severity is the value assigned to an alarm in the normal state. Thevalid range is 1 through 1000, where 1 is the least severe.

Plant Area places variables into logical plant groupings for display inthe WorkstationST Alarm Viewer.

SOE Description cannot be modified. It is automatically entered from thehardware library if the hardware point is defined as a Sequence of Event (SOE).SOEs are similar to event messages except they are associated with I/O transitions,instead of application-variable transitions. They are also typically timestampedto a much finer resolution (1ms) than alarms or events.

Visibility determines when the pin is shown on the block diagram.

Display High Limit is the default upper limit for displays on the HMI (for example,bar-graph or trending displays). If a Format Spec has been specified and this display-highproperty is not specified, the Format Spec Engineering Max is used.

Display Low Limit is the default lower limit for displays on the HMI (for example,bar-graph or trending displays). If a FormatSpec has been specified and this display-lowproperty is not specified, the Format Spec Engineering Min is used.

Display Screen is the default HMI screen for this variable.

Entry High Limit is the default upper limit for setpoint entry on HMI (for example,bar-graph or trending displays). If a Format Spec has been specified and this entry-highproperty is not specified, the Format Spec Engineering Max is used.

Entry Low Limit is the default lower limit for setpoint entry on HMI (for example,bar-graph or trending displays). If a Format Spec has been specified and this entry-lowproperty is not specified, the Format Spec Engineering Min is used.

Format Spec allows you to assign system-owned format specifications to a variable.

HMI Resource allows you to configure access and visibility of variable and alarm data.


Precision determines the number of digits to show to the right of the decimal point. Thisis the default for precision when displaying the number on HMI. If a Format Spec has beenspecified and this precision attribute is not specified, the Format Spec Precision is used.

Units are engineering units. If a Format Spec has been specified and this Units attribute isnot specified, the Format Spec Units is used. If you are using the SDB version of the HMIdevice, this attribute is not used. Only the format specification's Units string is used.

Alias is a variable tag name that can be customized by the user, and isavailable to the WorkstationST and HMI.

Array is the number of elements in this array variable.

Connection allows a variable to be connected to another variable.

Description is the variable description.

Enumerations are values represented in separate .csv files.

Full Name is the fully qualified name of the variable. For example, a variablename gas_fuel_opt in a user block named Config under the Program COREwould have a full name of CORE.Config.gas_fuel_opt.

Inherit Description of Connected Variable , if set to True, assigns thedescription of any connected global variable to the selected pin.

Initial Value allows array length, data type, and enumeration editing.

Interface Definition is the name of the interface that the selected variable implements.

Name is the variable name.

Nonvolatile indicates that the variable should be saved in non-volatile RAM.

Type is the variable data type.

Historian Deadband enables the automatic collection by the Historian when:

Boolean and set toLogged on ChangeAnalog and set to 0 or higher

Historian Deadband Definition defines the deadband value as eitherengineering units or percent of range.

Recorder Deadband enables the automatic collection by the Recorder when:

Boolean and set toLogged Continuous or Logged on ChangeAnalog and set to 0 or higher

Recorder Deadband Definition defines the deadband value as eitherengineering units or percent of range.

Control Constant allows a variable to be configured as a setting that isinitialized at startup to its initial value. Control constants can be viewed fromthe toolbar by clicking View\Control Constant.

Download Info , if set to True, downloads extended information to the controllerthat is used by the web server, as well as other processes.

EGD Page is used to assign the variable to an Ethernet Global Data Page.


External Access is used primarily for EGD.

ReadOnly variable can be read on EGD.

ReadWrite variable can be written to through EGD.

NoAccess variable cannot be changed with the ToolboxST application.

Global Name Prefix is the variable's global name prefix type (None, Full, Block,Program, Task). This controls the form of the global name that displays on the EGDpage. For example, the name for variable IGVA in user block VG_Health in task Task1in program CORE would display (depending on the Global Name Prefix) as:

None IGVA

Full CORE.VG_Health.IGVA

Block VG_Health.IGVA

Program CORE.IGVA

Task Task1.IGVAv

Scope is the variable's scope (Global, Local.) If a variable is local, it can only be usedin the program or user block in which it is created. If it is global, it can be used in otherprograms and user blocks. A variable must be global to be used on EGD.

Usage defines the behavior of pins on a user block.

Input pins are shown on the left of the user block.

Output pins are shown on the right side of the user block.

State pins are shown on the right side of the user block.

Constant entry is a number. No live data is provided for this pin.

Virtual HMI Point , if set to True, imports the variable into the HMI as a virtual point.

Controller Collected , if set to anything other than Not Logged, logs thevalue to the Compressed Data Log in the controller.

Note The Controller Collected property is only available when the application runningis a 1.5 MW Wind Turbine.

Override Properties , if set to True, allows certain properties of a linked variable to bemodified. The allowable properties are defined in the Overridable Properties dialog box.

Note The Override Properties property is only available for global variables that arecontained within a linked program, task, or user block.

Override Value , if set to True, allows the Initial Value of a linked variable to be modified.

Note The Override Value property is only available for control constants that arecontained within a linked program, task, or user block.


Table Definitions

Many complex mechanical interactions can be modeled using lookup tables. Thecontroller implements these tables using table definitions. A table definitionis similar to a signal definition, as both are similarly named and are used ininstruction blocks. Table definitions are added under the Programs item in theTree View. Refer to the section,Importing Table .csv Files.

A table definition consists of a name, note, identification string, revision string, engineeringunits (EUs), data array dimensions, adjust flag, minimum and maximum Z values, and data.The data consists of one or two independent arrays (X and Y) and a dependent array (Z).

Tables with a single independent array are sometimes called univariant tables andconsist of X and Z linear arrays of the same length. Tables with two independent arraysare sometimes called bivariant tables and consist of X and Y linear arrays and a Ztwo-dimensional array. Bivariant table definitions display in the Summary View as follows:


Importing Table .csv Files

Table definitions are multi-dimensional variables used on specific interpolator blocks.They have either one or two input arrays and a matching one or two-dimensionaloutput array. A block input is interpolated against the input array or arrays, and anoutput is interpolated from the corresponding output array. A single data-structureis provided for this function instead of a block so that it can be better identified,maintained, and tracked. Table definitions have special Version and ID textfields, and can be imported and exported to a .csv file.

� To add a table definition

1. From theSoftware tab, select aProgram in theTree View .

2. Right-click the program name and selectImport Table.csv file from theshortcut menu to display theTable Definition dialog box.

3. Select the desired table definition file and clickOpen . The TableDefinition file is inserted into the program.


Program Variables

Program variables are global variables associated with a particular program. Thevariables display under the Programs item in the Tree View. Undefined variablesfor a program are global variables that have been referenced in a controller, buthave not been defined as part of a program or user block.

� To add a variable to a program

1. From theSoftware tab, expand thePrograms item.


2. Enter the new variable name in theAdd New Variable dialog box and clickOK. The new variable is added to the list in theSummary View .

Note Variables can also be added in the Summary View by directly editing the lastrow of the variable grid.


Summary View

The Summary View displays all user blocks and associated scheduling informationin that program. The Frame Multiplier and Schedule Offset fields can be changedfrom this view (see below). The available columns are as follows:


Task Name is the name of this task.

Frame Multiplier is the number of frames at which the user block runs.

Schedule Offset is the offset from beginning of frame at which the user block runs.

Period , in milliseconds, is the period at which this user block runs.Calculated by multiplying the frame multiplier by the controller’s frameperiod, which is set on the General tab.

Description is the description of this user block.

� To change the frame multiplier or the schedule offset

Note Since the schedule offset depends on the frame multiplier, it is possible to selecta frame multiplier for which the current schedule offset is invalid. This will cause avalidation error when you build the application.


User Block

The user blocks of a controller program display in the Tree View below thePrograms item under tasks, or other user blocks.

User Block

Instancing a user block updates it to the latest version from the user block library.Embedded and unlinked user blocks are disconnected from the library, so instancinggoes through the blocks in that user block and instances the linked user blocks.

� To instance a user block

Right-click the userblock to selectInstance from theshortcut menu.


User Block Variables

User block variables are considered local to a user block, and display under theassociated user block item in the Tree View. The variables can only be modifiedif the user block is either embedded or unlinked, and not locked with passwordprotection. Undefined variables for an embedded or unlinked user block arelocal variables that have been referenced in the user block.

� To add a variable to a user block

1. From theSoftware tab, expand theUser Block item to display theVariables item.


2. Enter the new variable name in theAdd New Variable dialog box and clickOK. The new variable is added to the list in theSummary View .

Note Variables can also be added in the Summary View by directly editing the appendrow of the variable grid.

User Attributes

User block attributes only display on linked or unlinked user blocks whose user blockdefinition contained attributes in the library. They can be modified so that when theirparent user block is instanced, the modified attributes are used in the scripts and textsubstitutions that access them. Refer to the section,Working with User Blocks.


User Block Properties

The Property Editor for a user block displays slightly different information depending onwhether it is a task or just a user block inserted under another user block. Tasks containscheduling information, but a user block contained within another user block does not.

Unlink unlinks the user block from the definition.

BlockType is the name of the user block definition in the library fromwhich this user block started.

Description is the description of this user block.

Name is the name of this user block.

Protection expands to show the access rights for this user block definition.

Version is the user-defined version of a user block.


Frame Multiplier is the number of frames at which the user block runs.

Schedule Offset is the offset from beginning of frame at which the user block runs.


Dynamic Data Recorder (DDR) TabThe Dynamic Data Recorder (DDR) feature collects data when specified triggerevents occur. The advantage of usingDDRs over capture blocks is that DDRs canbe reconfigured without having to download application code to the controller. Thisenables changes to be made to the DDRs without disrupting the controller duringruntime. Up to 12 DDRs can be configured for the controller.

Configuring DDR

� To configure a DDR

♦ From theSystem Editor , double-click theMark VIe Component .The Component Editor displays.

From the Component Editor , clickthe Dynamic Data Recorder tab.

From the Tree View ,select the DDR thatyou want to configure.


Specific DDR information displays in theSummary View . Edit this information inthe Property Editor below.

The Property Editordisplays specificinformation for theselected DDR. Clickany item in the leftcolumn to display adescription of that item.Click the right columnto edit. Descriptions ofeach item are providedbelow.


Appearance

Name is the user-defined description for this DDR, which is used for the filename.

Setup

Auto Enable , if set to True, automatically re-enables the DDR after60 seconds once it is uploaded.

Buffer Control

Normal causes the DDR to collect pre-samples before a trigger event and thereaftercontinue collecting until Enable transitions False or the collection fills the buffer.

Circular causes the DDR to collect data indefinitely until Enable transitions False.The buffer will be filled with the newest samples. No trigger is used.

Only causes the DDR to evaluate the trigger each execution and only collectdata when the trigger condition is satisfied. Data is collected until Enabletransitions False or the collection fills the buffer.

Frame Period Multiplier extends the sampling period by this multiple.The base sampling period is the frame period.

Upload Type

Manual allows the user to manually upload the DDR.

Automatic is an automatic upload by the data collection.

Trip is an automatic upload by the data collection, then added to the trip log.

Enable is the setup variable that enables the DDR.

Trigger is the setup variable that triggers the DDR.

Post-trigger Samples are the number of samples collected after thetrigger including the trigger sample.

Pre-trigger Samples are the number of samples collected before the trigger.

Setup Variables

Enable enables the DDR.

Trigger triggers the DDR.


Trigger Setup

Trigger Setup Comparison Type

EQ is the value of the trigger variable, which must be equal to the trigger value.

GT is the value of the trigger variable, which must be greater than the trigger value.

GE is the value of the trigger variable, which must be greater thanor equal to the trigger value.

LT is the value of the trigger variable, which must be less than the trigger value.

LE is the value of the trigger variable, which must be less thanor equal to the trigger value.

NE is the value of the trigger variable, which must not be equal to the trigger value.

Trigger Comparison Value is the value compared to the value of the trigger variableto determine the presence of a trigger. For Boolean trigger variables, the only validvalues for the trigger value are 1.0 for TRUE and 0.0 for FALSE. Note that if an analogtrigger variable of a different data type is configured, it may be possible to specify atrigger value that cannot be exactly represented by the trigger variable. Users shouldbe aware of this limitation when specifying the EQ trigger condition.

Trigger Type

Edge is triggered on the rising edge of the trigger variable.

Level is triggered on the true condition of the trigger variable.

Status Variables

Status variables, which indicate the status of the associated DDR, are used todetermine when to upload the data. Status variables are always integers, and areautomatically defined and placed on the EGD status page.


Adding Variables

Variables can be added to a DDR. When a trigger occurs, these variables are collectedby the buffer and are subsequently uploaded by the Recorder and/or Trender. Eachvariable is sampled for the total number of samples configured. This means that ifthe DDR is set up to record 100,000 samples with three variables assigned, 300,000items will be acquired. Up to 96 variables can be assigned to each DDR.

Note There is a 12 MB size limit on the memory that can be allocated to the DDRs. Ifthis memory allocation is exceeded, an error is reported during validation.

� To add a variable

1. From theComponent Editor , select theDynamic Data Recorderstab to display theDDR list .

Right-click the desired

DDR and select Add Variable.


The Select a Variable dialog box displays.

2. Select the desired variables and clickOK to insert the variables.

Updating DDR

DDRs can be updated separately from the application code download.

� To update a DDR

♦ From theDevice menu, selectDownload , and then selectUpdate Dynamic Data

Recorder . Or, click theUpdate Dynamic Data Recorder button .

Note DDRs cannot be downloaded if there is a major difference in the device. In thiscase, the application code must be downloaded.


Importing and Exporting DDR

� To import a DDR from a .tre file

1. From theComponent Editor , select the desiredDDR.

Right-click the DDRand select ImportConfiguration ..

2. From theImport File dialog box, select the .xml file that correspondsto the DDR you wish to import. ClickOpen .

Note If the .xml file being imported contains the formatting flags %n, it is replaced bythe Mark VIe component Design Memo (DM) number. This is a GE Power Systemsproject number and can be edited by selecting the General tab and Requisition Info.

� To export a DDR to a .xml file

1. From the list of DDRs, select the DDR to be exported.

2. From theFile menu, selectExport , andSelected Item . Or, right-click a DDRin the list and selectExport Configuration from the shortcut menu.

3. Select the desired file and clickSave.


DDR Setup

This procedure explains how to set up a DDR to capture two variables.

1. From theSoftware tab, right-clickPrograms to add a program.

2. Right-click theProg1 item and selectAdd Variable . In theAdd New Variabledialog box, enterDDREnable (Boolean) , which is used to enable the DDR.

3. From theAdd New Variable dialog box, add a variableDDRTrigger(Real), which is used to trigger the DDR.

4. From theAdd New Variable dialog box, add two variablesTriangleOutandSineOut , which are connected to the output of the function blocks. Thesevariables are added to the DDR variable collection.

5. Create aUser Block in the program, and add twoFuncGen blocks.These are in theData Collection section. Set up the pins on the twoblocks as shown below.FuncGen1 is set up as a Sine wave generator andFuncGen2 is set up as a Triangle wave generator.

6. Set up the DDR as shown below.

7. Add the two variablesSineOut andTriangleOut to the DDR. Set theFramePeriod Multiplier to 3, which means a sample is collected every 120 ms. Thebase frame period is typically 40 ms. Set thePreTrigger samples to20 and thePostTrigger samples to100, so that the entire capture takes 14.4 seconds.


8. The DDR is enabled with theDDREnable variable and the Trigger usestheDDRTrigger variable. The DDR is triggered when theDDREnable isTrue and theDDRTrigger is greater than or equal to 5.

9. Build and download the application code.

10. Go Online to the controller. FromProg 1 , select theVariables item. Double-clickthe green live data for theDDREnable variable. Set toTrue and send to the controller.


The status of the DDR can be checked on the EGD page. When theDDREnable isTrue and the DDR is not triggered, it is in theWaiting state, as shown below.


11. Set the value of theDDRTrigger variable equal to or greater than 5, then sendto the controller. The status indicates theCapturing state.


When the capture is complete, the status indicatesDone , and the DDR can be uploaded.

12. TheTrender is used to upload the capture buffer. From theView menu, selectTrenders to add a new trend. The Trender window displays.


13. Select + and theTrender wizard displays. SelectCapture Buffer to select theDDR to upload. The uploaded DDR variables are shown below.


Ethernet Global Data (EGD) TabThe Ethernet Global Data (EGD) protocol allows you to share information globallybetween controller components in a networked environment. EGD allows onecontroller component, referred to as the producer of the data, to simultaneouslysend information to any number of peer controller components (consumers) at afixed periodic rate. This protocol supports a large number of controller componentscapable of both producing and consuming information.

EGD Configuration

� To configure EGD for a component

1. From theSystem Editor , double-click a component to displaythe Component Editor .

2. From theComponent Editor , select theEGD tab.

3. From theTree View , selectEthernet Global Data .

The following properties display in the Property Editor when EthernetGlobal Data is selected in the Tree View:

Collec tion controls the collection to which this EGD component belongs whenviewed in the EGD management tool (EMT). This information is published to the EGDConfiguration server in the GUI component document, GUIDevice.xml.

Producer ID sets and displays the EGD Producer ID for this component. Thisis assigned when the component is created. The Property Editor displays theEGD Producer ID formatted as an unsigned integer, but dotted and hexadecimal

representations are available by clicking the ellipsis button.


Produced Pages

Produced Pages are data samples configured to be available to othercomponents on the network.

� To add a new Produced Page

♦ From theTree View , right-click theProduced Pages item, then selectAdd Page . The Page Name dialog box displays.

Note When the first Produced Page is created, it automatically becomes the Defaultpage.

� To display standard variables

1. From theEGD tabTree View , selectProduced Pages .

2. From theProperty Editor , select theDefault Page Property , thenselect the desired page from the drop-down list.

Tip � Any variable defined with $Default as the EGD page name is automaticallyplaced on the currently selected Default page.

� To delete a page

♦ From theTree View , right-click the page you wish to delete and selectDelete .


Editing Produced Pages

� To configure a Produced Page

♦ From theEGD tabTree View , expandEthernet Global Data .

From theTreeView, select thedesired page.

The propertiesfor the selectedpage display inthe PropertyEditor .

The following properties are available for configuration when a ProducedPage is selected in the Tree View:

Ethernet 0 , if selected, causes EGD to be broadcast on Ethernet Adapter 0. (If more thanone Ethernet Adapter has been configured for EGD, additional Ethernet properties display.)

Mode , when set to Broadcast, sends the page to all EGD nodes. When set toUnicast, the page is only sent to a single destination.

Exchanges indicates the number of exchanges in the selected page.It is updated after a build.

Default Page can be set to True if the selected page is the Default Page. Tochange the default page, refer to the section,Produced Pages.

Layout Mode , if set to Auto, automatically assigns exchange numbers and offsets assignedat build time. If set to Manual, exchange numbers and offsets can be entered manually.


Minimum Length sets the minimum length of the exchanges on this page. Somecomponents look only at the length of the exchange. This property can be setto a value larger than the current size of the exchange so that as variables areadded, the component continues to receive the exchange.

Name renames the selected page.

Period indicates the transmission period of the page in milliseconds.

Period Multiplier multiplies the value by the Controller frame period to obtainthe EGD page period. (The results display in the Period property.)

Skew is used to prevent exchanges with the same period from being produced at exactlythe same instant. The skew for the first exchange in the page is set to this value, andeach additional exchange skew differs from the previous exchange’s skew by exactlythis value. For example, if you have three exchanges in a page and a skew value of2, the first exchange’s skew is two, the second exchange’s skew is four and the thirdexchange’s skew is six. (The skew property is measured in nanoseconds.)

Starting Exchange ID is used for the first exchange on this page. Eachadditional exchange will be incremented from this number. When this propertyis changed, all exchanges are renumbered.

Status Page is used by WorkstationST to provide standard variable information.

Page Compression

When a page compression is performed, the variables are located in increasing sizeorder, starting with Booleans, then Words, Double Words, and finally all other variables.A page compression causes an exchange major signature. Consumers can mark theexchange variables as unhealthy until the consumed configuration can be rebound.

� To compress a single page

♦ From theTree View , right-click the page to compress, and then selectCompress .

� To compress all Produced Pages in a component

♦ From theTree View , right-click Produced Pages , and then selectCompress All .


Variables

� To add a variable to an EGD page

♦ From theComponent Editor Tree View , right-click the desired page, and thenselectAdd Variable . TheSelect a Variable dialog box displays.

From the Select a Variabledialog box, select one or morevariables, then click OK.


The Summary View updates todisplay the new variable(s). Theexchange IDs and locations areassigned during the Build.

Tip � If the variable to be added to the EGD page is already in use on the Softwaretab, you can add the variable without using the EGD tab. To add a variable from theSoftware tab, select the desired variable(s) in the Summary View, and then set the EGDPage property using either the Summary View or the Property Editor.

� To delete a variable from an EGD Page

♦ From theSummary View , right-click the variable to delete, andthen selectDelete Selected Row(s) .

� To copy variable information from an EGD Page to the clipboard

♦ From the Summary View , right-click a variable, and then selectCopy Selection .The data is copied in Comma Separated Value (csv) format.


Editing Exchange Signatures and Configuration Time

Normally, the exchange signature is managed automatically. The major signaturemust be incremented when the exchange content changes in any way other thanadditions to the end. If you are using the EGD Device Editor to configure EGDfor a device and the device signature changes only when the manufacturer updatesthe configuration, you may need to manually set the signature.

Note To edit exchange signatures and configuration time, set Layout Mode toManual.

� To edit exchange signatures and configuration time

1. From theEGD tab, select theConfiguration tab, then select aProduced Page in the Tree View .

2. Right-click an exchange in theSummary View , then selectEdit ExchangeSignatures andConfiguration Time .

3. Review the warning about manualExchange Signature editing, then clickOK.

4. Make any desired changes to the signatures and configuration time,then click OK to close the dialog box.


EGD Diagnostics

The EGD protocol includes a command mechanism that obtains the status of aClass 2 or higher EGD device. Mark VIe is a Class 3 EGD device. When anyEGD item in the Tree View other than a referenced device is selected, the EGDStatistics from [Device] tab displays the statistics from the open component. When aReferenced Devices item is selected, the statistics are obtained from that referenceddevice, and the name of the tab page changes accordingly.

Note You must be online to view diagnostic information.

Status columns in the Summary View include the following:

Exchange is the Exchange identifier <device name>.<exchange number>.

Configuration Time is the time that the exchange was configured.

Due Time is the time that a consumer data packet must be receivedfor an exchange to remain valid.

Status is the health of the exchange.

Length is the value for a produced exchange. This length may be the highest variableoffset in the exchange or the highest offset of a variable, which may have been removed.For a consumed exchange, the value may be the highest variable offset used or the lengthof the produced exchange, depending on the bind algorithm of the individual tool.

Message Count is the number of data production packets producedor consumed since initialization.


Missed Count is the number of data production packets missed since initialization. Amissed packet occurs when a data production message is received that has a request IDgreater by more than one than the last messagereceived (accounting for counter roll-over).

Refresh Errors are the number of times a refreshment fault has occurred. A refreshmentfault occurs when a subsequent data production packet (or initial packet at startuptime) does not arrive at a consumer within a pre-defined update period.

EGD Configuration Server Tab

The EGD Configuration Server tab in the Summary View allows you to view anddelete EGD nodes currently residing in the configuration server. The configurationserver used is the one defined in the System Editor in the Tree View. If the serveris enabled, this tab displays information from that server.

Note The EMT provides a detailed view of the configuration server contents.

The tab control contains a toolbar with two buttons:

The Filter Toggle button defaults to a filtered state. It displays items that havethe samename but have a different Producer ID as the open component.

The Delete button deletes the selected item(s). If the item(s) were savedas part of the configuration, they can be added again.

The EGD configuration server uses the producer ID to store all thedocuments for an EGD node.

Note A system can have one EGD Configuration Server only.

If you open two systems, then point to the same configuration server and save adevice of the same name with two different producer IDs to that server, you canend up with two producer ID nodes with the same device name.


EGD Configuration Server Reports

With the system item selected, the EGD Configuration Server tab can be enabled onthe System Editor Property Editor. Refer toChapter 2, System Configuration, thesectionSystem Database (SDB). When enabled, the Produced Pages item has twoadditional context menu items, Compare and UnConsumed Data.

Compare command compares the component's EGD-produced data configurationwith the EGD configuration server’s content.

UnConsumed Data command generates a report showing variables produced bythis component that are not listed in any other device’s consumed data file.

Note You can select devices to search against. The individual pages, with justvariables, perform the same Compare.

The Referenced Devices item on the EGD tab also has a Compare commandthat compares the consumed variable information for the open componentagainst the EGD configuration server’s content.


Referenced Devices

The EGD variables defined in other components can be added to the currentcomponent’s variable list by adding a reference. References can only be createdto EGD-capable devices thatare producers of pages.

� To select referenced devices

♦ From theTree View , right-click theReferenced Devices item, and thenselectSelect Devices to display theSelect Devices dialog box

Select or clear thecheck boxes nextto each componentname. Click OK.

The EGD configuration for the selecteddevices are loaded and the variablesdisplay in theSummary View .

Note When EGD configurations are edited in remote devices, you must refresh theconfiguration to ensure that the latest variable information is used. The configuration isautomatically refreshed when a component is opened, and when a Build is performedin the component.

� To refresh the configuration of a referenced device

♦ From theTree View , right-click the device to be refreshed, and selectRefresh .


Creating Undefined Variables

The Create Undefined Variables option allows you to create variables in a componentcreated from a referenced device. The list of undefined variables is generatedwhen a Build command is performed. As the variables become available fromthe referenced device, they are deleted from the list.

� To create undefined variables for a referenced device

♦ From theTree View , right-click the device, and selectCreateUndefined Variables .

� To create undefined variables for all referenced devices

♦ From theTree View , right-click Referenced Devices item, thenselectCreate Undefined Variables .


Modbus Slave TabThe Modbus® slave feature allows a Modbus master to read and/or write data directlyfrom the Mark VIe, using the Modbus protocol over Ethernet or serial ports.

This feature can be implemented using the existing controller (referred to as Mark VIeintegrated Modbus) or an additional controller (referred to as Mark VIegateway Modbus).

Using the existing controller allows for a direct Modbus interface, but would expose thecontroller to the extra loading and burden ofserial interrupts when serial communicationpaths are needed. Because a serial interrupt is critical, the Modbus slave feature supportsboth serial and Ethernet/TCP capability on Mark VIe gateway Modbus, while onlyEthernet/TCP capability is supported on Mark VIe integrated Modbus.

Mark VIe gateway Modbus is always run in simplex controller modewithout sequencing blocks.

Modbus Overview


Configuring Modbus Slave

� To configure Modbus slave for a device

♦ From aComponent Editor , click theModbus Slave tab.

From the Tree View selectthe Modbus Slave option.Configuration propertiesdisplay in the PropertyEditor .

Note Modifying Modbus properties results in a minor difference in the ToolboxSTconfiguration. However, removing all Modbus points constitutes a major configurationdifference that forces an offline load.

Ethernet

Connection Timeout specifies the time in minutes that the slave remains connected tothe master over Ethernet when no requests are being received. The valid range is one to 10.

Ethernet Port specifies the Ethernet port to be used for slave-Ethernetcommunication. The valid port choices are 502 and 503.

Interface

Interface sets the interface type:

Serial is only supported on Mark VIe gateway Modbus.

Ethernet is supported on both.

Shared (both Ethernet and serial) is only supported on Mark VIe gateway Modbus.

None indicates that the slave feature is not available.


Serial Settings

Baud Rate specifies serial communication rate (bits per second). The validchoices are 2400, 4800, 9600, 19200, 38400, and 57600.

Data Bits specifies number of bits per character. Only eight bits is supported.

Inter-Character Timeout (ICT) specifies the timeout period expressed as charactertime X 10. For example, 35 represents 3.5 character times, or 0.0036 seconds at 9600baud, 1 start bit, no parity, 1 stop bit. The valid range is 35 to 1000.

Parity specifies check character. The choices are None, Odd, Even, Mark, and Space.

Port specifies the serial communication port (COM2).

Response Delay is an additional delay time in milliseconds before the slaveresponds to a master request. The valid range is 0 to 999.

Station specifies the slave address associated with the serial port.The valid range is 1 to 255.

Stop Bits specifies serial stop-bits. The valid choices are 1 and 2.

These additional settings apply to both Ethernet and serial communications.

Command Limit limits the number of commands processed per second. Thisis based on commands that have changed, not commands that are identical topreviously received commands. The valid range is 0 to 25.

Data Swapped changes the transmission order if the data is greater than 16bits when set to True. Refer to the example below.

Settings Example

If set to True 32-bit example: 0x01234567 would be transmitted as 0x45 0x67 0x01 0x23

64-bit example: 0x0123456789ABCDEF would be transmitted as 0xCD 0xEF 0x89 0xAB 0x450x67 0x01 0x23

If set to False 32-bit example: 0x01234567 would be transmitted as 0x01 0x23 0x45 0x67

64-bit example: 0x0123456789ABCDEF would be transmitted as 0x01 0x23 0x45 0x67 0x89 0xAB0xCD 0xEF

Mode is the mode for serial communication. Only Binary is supported.

NAK Code specifies the Negative Acknowledge code to be used if data is requestedfrom a controller that is incapable of receiving the Modbus request. Code options are4, 6 or None. None is selected only if the master needs no reply when communicationfails between the Mark VIe gateway Modbus and the target processor.


Modbus Slave Register Pages

The Modbus Slave tab contains four pages that are used to exchange data with a ModbusMaster. The pages differ by the access the master receives to the data (read-only orread/write) and the type of data (a Boolean or a 16-bit word) as follows:

Data Types

Page Data Type Access

Holding Register 16-bit Register Read/Write

Coil Single Bit Read/Write

Input Register 16-bit Register Read-only

Input Single Bit Read-only

The ToolboxST application allows you to specify the variables on each page using a DataGrid. When you add a variable to a page, both the Modbus slave and the selected page areenabled on the controller. As you add and remove variables, the controller is updated sothat only pages containing variables are enabled. To completely disable the Modbus slave,remove all variables on all pages or select None as the Interface in the Property Editor.

When a variable is added, the following columns display:

Connected Variable is the variable that is read or written from the device or thereferenced device. A variable must be on an EGD page before it can be added to a Modbusslave page. A connected variable must be added before the other columns become active.


Point Data Type determines the variable data type and the registers used totransmit the variable data over a Modbus connection as follows:

• BOOL is one bit of a 16-bit word. (This is the only option if theconnected variable is a BOOL.)

• INT is a signed 16-bit word that takes one register

• UINT is an unsigned 16-bit word that takes one register

• DINT is a signed 32-bit word that takes two registers

• UDINT is an unsigned 32-bit word that takes two registers

• REAL is a signed 32-bit float that takes two registers

• LREAL is a signed 64-bit float that takes four registers

Address specifies the register address. When a variable is created, the address isautomatically set to a value adjacent to the highest address previously on the page, butthe automatic value can be modified. Any data types that are 32 bits or more (DINT,UDINT, REAL, and LREAL) should be placed on odd addresses. The valid range foraddresses is 1 to 65534. When specifying an address for a BOOL variable, the bit 0-15within the 16-bit word is represented by a decimal. For example, 1.00 selects registeraddress 1 and bit 0, and 10423.7 selects register address 10423 and bit 7.

Raw Min, Raw Max, Eng Min, andEng Max are columns that convert Modbusslave variable data into engineering units. The Raw Min and Raw Max columnscontrol the minimum and maximum for the raw data. The Eng Min 0 and Eng Maxcolumns control the minimum and maximum engineering units to which the rawdata will be scaled. (The BOOL data type cannot be scaled.)

Name is a read-only identifier automatically generated from the register pagename, the address, and, if necessary, an added unique number.

For more information, refer to the following links:

For Modbus resources, go to:http://www.modbus.org

For Modbus protocol, go to:http://www.modicon.com/techpubs/toc7.html


Mark VIe Tools

Reports

Reports provide a variety of controller information in a viewable format.Reports are displayed in a separate window and can be viewed, printed, andsaved for later use. When viewing a report on screen, you can also sort, filter,and search the report to quickly locate information.

Creating Reports

� To create a report

♦ Open a Mark VIeComponent Editor . From theView menu, selectReports ,then select the desired report type from the drop-down list. Refer to the section,Report Types. The I/O Report displays in a new window.


Saving, Retrieving and Printing Reports

� To save a report

♦ From theFile menu, selectSave Report . In theSave Report dialogbox, enter a file name and clickSave.

� To open a saved report

♦ From theFile menu, selectOpen Report . In theOpen Report dialogbox, locate the report in .csv format and clickOpen .

� To print a report

♦ From theFile menu, selectPrint . In thePrint dialog box, verify thatthe settings are correct and clickOK.

Viewing Reports

� To change the zoom level of a report

♦ From theReport View menu, selectZoom and select the desiredzoom value from the drop-down list.

� To sort a column

♦ From theReport window, click any column heading to apply a sort tothat column. The first click sorts the column in ascending order; a secondclick sorts the column in descending order.

A triangle in a columnheader indicates that therows are sorted based onthe data in that column.


� To change report columns

♦ From theReport menu, selectChange Columns to display theSelect Report Columns dialog box.


Filtering Rows

The report filter feature applies rules to a report to display a specificsubset of the original report.

� To apply a report filter

♦ From theReport window, select theReport menu and clickApply Filterto open theEdit Report Filter dialog box.

The following operators are used in a report:

< Left expression must be less than the right expression.

> Left expression must be greater than the right expression.

<= Left expression must be less than or equal to the right expression.

>= Left expression must be greater than or equal to the right expression.

<> Left expression must not equal the right expression.

= Left expression must be exactly equal to the right expression.

LIKE Expression to the left of the operator must match the wildcard expression to the right of the operator.

AND Expressions to the left and right of the AND operator must both be True.

OR Either the expression to the left or to the right of the operator must be True.

NOT Expression to the right of the operator must be False.


In addition, the following rules apply:

• You can use as many groups of parentheses as necessary to define an expression.

• Any string values must be enclosed in single quotes:'string'

• When using the LIKE operator, you can prefix or suffix a wildcard characterlike * to the right-hand value. This wildcard character * can stand for anynumber of alphanumeric characters, including zero. The wildcard character* can only be present at the beginning and/or the end of the right-handvalue (for example, *value or value* or *value*)

In this example , thefilter for the I / O reportselects all screwnames that begin with‘Pos’ and are unused.


The filter expression displayed below selects all contact and input digital I/O points[IOVariable] LIKE ‘Contact*’ AND [ModuleName] LIKE PDIA*’

� To remove a report filter

♦ From theReport window, select theReport menu and clickRemove Filter .The filter is removed and all available rows display.

� To save a filtered report

♦ From theReport window, select theFile menu and clickSave Report .


Finding Data

The report Find feature allows text searches to be performed within the report.

� To find text within the report

♦ From theReport window, select theReport menu and clickFindto display theFind dialog box.

Enter thesearch text.

If selected, thecapitalization in thereport and thesearch string mustexactly match.

If selected, the find stringmust be found as a whole(for example, ‘day’ would notmatch ‘Monday’)

Determines the directionin which the next searchwill proceed.

Click to locate and highlightthe next instance of thesearch text in the report.


Importing Reports

Six types of reports can be imported. Four can be imported from a .csvfile only. The Variable Alias report and the Second Language report canbe imported from either a .cvs or a .xml file.

• I/O Variable Report

• I/O Configuration Report

• Global Variable Report

• Block Pin Report

• Variable Alias Report

• Second Language Report

� To import a report from a .csv file


� To import an I/O Variable, I/O Configuration, Global Variable,or Block Pin report

1. From theFile menu, selectImport and the desired report. TheOpen Report… dialog box displays.

2. From theOpen Report… dialog box, select the report and clickOpen to import thedata. Any data that cannot be modified is highlighted when the report displays.

� To import a Variable Alias report

1. From theFile menu, selectImport andVariable Alias Report . TheOpen Report… dialog box displays.

2. From theOpen Report… dialog box, select either a .csv or an .xml fileand clickOpen to import the data. Any data that cannot be modifiedis highlighted when the report displays.

Note Only the Alias property can be modified.

� To import a Second Language report

1. From theFile menu, selectImport andSecond Language Report .The Open Report… dialog box displays.

2. From theOpen Report… dialog box, select either a .csv or an .xml fileand clickOpen to import the data. Any data that cannot be modifiedis highlighted when the report displays.

Note Only the Second Language property can be modified.

The following report columns can be imported from the .csv file:

I/O Variable Report

BarCode Group Name TB Location Sense Config Type

Raw Low Engr Low Raw High Engr High SeqOfEvents

Device Tag Connected Variable Config Value Jumpers Jumper Value

Screw Name Wire Number Wire Jumpers Interposing TB Screw Note

Global Variable Report

Locator Description Second Lang Desc Alias EGD Page

Entry High Entry Low Event Format Spec Global Name Prefix

Hold Access Type Alarm Alarm Class

AlarmOnZero Control Constant Display High Display Low Display Screen

NovRam Precision Virtual HMI Point Historian Deadband Historian DeadbandDefinition

Recorder Deadband Recorder Deadband

Definition

Block Pin Report

Locator Pin Description Block Description Data Type


Coding Practices Report

The Coding Practice report allows you to generate four reports:

• Unwritten Variables report

• Multiple Writes report

• Multiple Output Assigned Variables report

• Unused I/O report

� To generate a Coding Practices report

From the View menu, select Reports, then select Coding Practices .

The Coding Practice Report Options dialog box displays.


Unwritten Variables are used in blockware logic, but have no assigned values.

Multiple Writes are variables used in multiple locations, such as blockwarelogic, EGD, or I/O point configuration.

Multiple Output Assigned Variables displays all variables attachedto more than one output.

Unused I/O are connected I/O values that are not used anywhere.

Spares are unconnected and unused I/O values.

An example of a Coding Practices report is as follows:


Auto-Reconfiguration Reports

The Auto-Reconfiguration reports include: Configuration and Difference. Ifone or more I/O packs are configured in the Hardware tab, the Configurationreport displays details about what files are downloaded for the packs. Eachpack must have a unique barcode (configured in the Add Module Wizard whenthe pack is added) or it is not included in the report.

Note The contents of both types of reports can be exported to a .csv file.

Configuration Report

� To generate an Auto-Reconfiguration Configuration report

♦ From theView menu, selectReports , Auto-Reconfiguration,andConfiguration. The Auto-Reconfiguration ConfigurationReport screen displays.


An example of a Configuration report is as follows:

The Configuration Report includes all packs in the ToolboxST configuration, as well as the files (and their sizes) associated with each pack.

The download size of the total Auto-Reconfiguration displays.


Difference Report

An example of a Difference report is as follows.

The Item column displays each configured pack.

The Tool column displays information about files configured in the Auto-Reconfiguration server.

The Controller columns compare the state of each controller’s configuration to the configuration in the Auto-Reconfiguration server.

If Difference Report is selected from the View menu, but no differencesexist between the ToolboxST configuration and the Auto-Reconfigurationserver, the following message displays.


This example of a full report displays three controllers whose configurations are all equal to the configuration in the Auto-Reconfiguration server.


Status Tab

The Status tab at the bottom of the Component Editor displays four different states.

Equal displays if there are no differences between the ToolboxST configurationand the Auto-Reconfiguration server.

Unequal displays if there are differences between the ToolboxST configurationand the Auto-Reconfiguration server.

Disabled displays if the Auto-Reconfiguration property is set to Falsein the General tab Property Editor.

Downloading displays if a download is occurring.


Forced Variables

Forced variables are variables and I/O points whose value is permanentlyoverridden with a specific value. They are managed using the Forced Variableswindow while connected to a controller.

Warning



� To open the Forced Variables window

♦ Open aMark VIe Component Editor . From theView menu, selectForcedVariables to display theForced Variables window.

� To force a value or change a previously forced value

♦ From theForced Variables window, double-click a value to display theSend Value dialog box. (For more information about theSend Valuedialog box, refer to the section,Modifying Live Values.)

� To remove a single forced value

♦ Right-click a forced variable and selectRemove Selected Forces.

� To remove all forced values

♦ Right-click anywhere inside theForced Variables window andselectRemove All Forces .


� To print a report

♦ From theFile menu, selectPrint . In thePrint dialog box, verify thatthe settings are correct, then clickOK.

Global Variables

The Global Variables window displays all controller variables that have beenconfigured as Global in one central location.

� To display the Global Variables window

♦ Open aMark VIe Component Editor . From theView menu,selectGlobal Variables .

The Global Variables window is particularly useful when you want to modify aproperty for multiple variables. For example, to move multiple variables onto anEGD page, select the rows for the desiredvariables and then change the EGD Pageproperty in the Property Editor. Refer to the section,Data Grids.

Because only existing global variables can be changed, new variables cannot be addedfrom the Global Variables window. You cannot make any change that affects the nameof the global variable (like Name or Global Name Prefix). Finally, variables from aninstanced library user block can only be modified if the Merge Variables at Instanceproperty of the Programs item on the Software tab is set to True.


wiring block pins from geh6700k part 2.pdf4-16 toolboxst* user guide for mark* vie control zoom and...

Documents