Professional Documents
Culture Documents
Wiring Block Pins: Wire Styles and Colors
Wiring Block Pins: Wire Styles and Colors
Block pins are wired together to direct the flow of data through the software. You
can 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 form
pin connections, which forms connections to both normal blocks and to blocks
with a configurable number of inputs (called Rubber Pins).
♦ From anywhere in the diagram, press and hold the right-mouse button. The
cursor displays as a hand, allowing you to pan in any direction.
Note While using the zoom tool, hyperlinks in the diagram are active.
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 block
is automatically added to the new Trender.
Add to Watch allows you to open a new Watch Window. The block is
automatically added to the Watch Window.
Edit Block Pins displays the Edit Block Connections dialog box.
Copy allows you to copy a block. Paste displays to allow you to paste
the 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 and Send to Back reorder blocks, causing them to appear above or
below 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 execution
order of the blocks to be immediately after the right-clicked block.
Creates a new
variable in the
user block.
Pins represent inputs and outputs of a block. Parameters are a special type of Pin
that 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.
♦ From the Connection column, select the cell for the desired pin. Either enter
a new value or click the down arrow to select a value.
Note Clicking the Connection column displays a drop-down list that includes Browse
Globals and Browse Locals. If either of these is selected, the Select a Variable dialog
box displays to allow you to select a variable. Any enumerated values that are legal
for the selected pin also display in the drop-down list.
Note All block pin connection changes take effect immediately (there is no OK or
Cancel button in the Edit Block Pin Connections dialog box). From the Edit menu in
the Component Editor, select the Undo option to reverse any changes.
Tip Pressing Enter while entering text selects the next pin on the block, allowing
rapid entry of connections.
♦ From the diagram Layer toolbar, click the down arrow to select the desired action.
♦ From anywhere variables are used in the Software tab, double-click a variable value
to display the Send Value dialog box. A dialog box displays that is appropriate
to the data type of the variable. Refer to the following variables.
Boolean Values
Select an option to
select a True or False
value for the variable.
Click here to send the Next Click here to invert the current
Value to the controller and value and immediately send it
close the dialog box. to the controller without closing
the dialog box.
Enter a value to
be added to or
subtracted from
the variable.
Click to increase or Click here to send the Click here to send the Next
decrease the variable by the Next Value to the Value to the controller without
delta value and send the controller and close the closing the dialog box.
result to the controller. dialog box.
Array Values
When you are finished
changing values, click here
to close the dialog box.
Double-click an element of
the array to display the
associated Send Value
dialog box.
The Variable Rail Tool arranges inputs along the left side of a particular
sheet and outputs along the right side to improve readability. It inserts a variable
reference that can be wired to a block pin and moved around freely.
Inputs Outputs
Variables on a variable rail display with symbols and cross references that
indicate 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 that
allows you to switch to this mode.
Global
variable
Undefined
variable
EGD
variable
Pin
callout
Note For each variable on the rail, cross references to other variable usages display.
To define a rectangular
area for the rail, click
and drag the cursor.
Note Clicking in the right or left two inches of the sheet docks the rail to the sheet’s
edge.
Note Variables from other windows (Watch Windows, Trenders, and such) can be
dragged and dropped into a variable rail, as well.
♦ Click to select a desired variable, then drag the variable from the rail and
drop it onto a block pin to form a wired connection.
♦ Drag a variable from the rail and drop it into a block pin to form a wired connection.
♦ Select and drag the variable from the rail to the desired location.
♦ Right-click anywhere in the Variable Rail to display the following shortcut menu.
Go To Where Used displays a list of all places that the selected variable
is used (hardware I/O, EGD page, and such)
Change Live Value displays the Change Live Value dialog box (you
must be online to use this menu option).
Add To EGD allows you to set the EGD page for the selected variable.
♦ Click at the desired upper left corner of the text field, drag to the desired lower
right corner and release the mouse button. Enter the text in the dialog box that
displays and click OK. The new shape is added to the drawing.
The shape created by the text tool has the following properties:
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.
♦ Click the desired upper left corner of the shape, drag to the desired lower right corner
and release the mouse button. The new shape is added to the drawing.
Filled, when set to True, causes the shape to be filled with the color
specified in the Fill Color property.
Fill Color displays the color the shape is filled with when Filled is set to True.
♦ Click the desired upper left corner of the shape, drag to the desired lower
right corner, and release the mouse button. Then, in the Browse for Image
dialog box, provide the path to the .wmf or .emf file that contains the image
and click OK. The image is added as a shape to the drawing.
Note The image file is not embedded in the diagram. All images must be distributed
separately from the .xml files for the diagram.
Metafile Path displays the path to the .wmf or .emf file containing
the image that is displayed.
Tip To ensure that images can be found when the diagram is moved on the hard
disk, avoid hard-coded path names or mapped drive names. Relative names, such as
..\Metafiles\bom1.wmf are best.
Detached View Window displays a new window containing a Block Diagram Editor
by itself (without the TreeView or InfoView). The new window displays the same
diagram 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 for
moving pins from one drawing to another drawing.
Alignment Tools are available when multiple drawing shapes are selected (either by
drawing a selection rectangle around multiple shapes using the Pointer tool or by holding
the CTRL key while selecting additional shapes). The tool modifies the location, width, or
height of each shape to match the selected aspect of the primary selected object (denoted
with green selection handles). The Top, Bottom, Left, and Right alignment tools affect
location, while Width and Height adjust size. Arrange Horizontal and Arrange Vertical
equally space all of the selected shapes along the Horizontal or Vertical axis.
Diagram
User
Device or Library
System
For example, if the system settings specify the paper size as Letter, the library
and user settings specify Use Parent Setting, and the diagram settings set the
paper size to Legal, that diagram would be shown on legal-size paper while all
other diagrams would be shown on letter-size paper.
The Edit Diagram Settings dialog box allows you to edit the following options:
Landscape, when checked, makes the longest dimension of the paper, the horizontal
dimension, creating a drawing that is wider than it is tall.
Show Wired Pin Connection Text, when unchecked, hides the connection
text for wired pins, reducing clutter on the drawing.
Tip Selecting the Default to parent setting or a dimmed check box indicates that
you have no preference at the current level. The diagram uses the settings from the
next level down in the hierarchy.
The Rung block controls variable values using Boolean logic equations. While you
can specify a Boolean logic equation directly by connecting it to the EQN pin of the
rung block, a graphical RLD Editor is also available to simplify the process.
Or,
♦ Right-click a Rung Block. From the shortcut menu, select Edit Ladder Logic.
To add a contact
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 open
the Connect Contact dialog box.
Wires
Wires are used to connect contacts to the coil and to each other.
To add a wire
♦ Select the Wire tool , and then click a location on the grid.
♦ Drag the boundary between any row or column. Blue text will display
indicating the result of the action.
Errors
You can create rung diagrams in the RLD Editor that do not convert to compatible
Boolean 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 a
short circuit. If you make one of these mistakes, text will display on the status bar
to help you resolve the error. (When the output equation is displayed on the status
bar, the diagram is correctly drawn and no errors are detected.)
Creating an SFC
To create an SFC
1. From the Mark VIe Component Editor, select the Software tab, then right-click
the Programs item and select Add Program to add a program.
From the Tree View, click newSFC From the toolbar, click the Edit SFC
to display the SFC logic editor . button 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 the
SFC item is selected in the Tree View:
EGD is the EGD page that contains all published variables from the SFC.
Put Step Active Times on EGD, if set to True, publishes the Active
Time variable for each Step on the EGD page.
Put Transition Progression Status on EGD, if set to True, publishes the Transition
progression status variable for each Transition on the EGD page.
HMI Link Source is the source file containing visuals for SFC elements.
HMI Linked Object for SFC Network is the HMI object that
visualizes 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.
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.
Toolbar Buttons
Button Use to
Toggle between editing and viewing modes
Edit SFC
Run the SFC
Run SFC
Pause the SFC
Pause SFC
Reset a paused SFC (if the SFC is running, Reset is disabled)
Reset the SFC
Place a Hold on every Transition in the SFC
Single Step
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 Change the zoom level of the SFC logic editor
Out
Select Steps and Transitions
Select Tool
Create a new Step
Step Tool
Create a new Transition
Transition Tool
Create a new END Transition
END Transition Tool
Align multiple selected shapes
Alignment Tool
To add an Action
♦ From the SFC toolbar, click the Select button , then double-click a
step. The Edit actions for step dialog box displays.
Click the Add Action From the Qualifier column, select the Select the check box to make
button to add an action. action qualifier (refer to the table below). this an Action of Interest.
From the Action Logic Sheet column, From the Qualifier drop-down list, select
click Edit Action Logic to edit the P:Pulse (Action runs once), which causes
blockware logic for the action. the Action to run only once when the Step
becomes active.
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.
The PERMIT standardizes the Transition conditions so that HMI screens have a
common method to display information about Transitions.
Note The Active and Finished fields indicate the status of the Action.
♦ From the SFC toolbar, click the Select button, then double-click a step.
The Edit actions for step dialog box displays.
♦ From the toolbar, click the Transition button , then move the cursor to
the sheet and click. The Add Transition dialog box displays.
♦ From the toolbar, click the Select button, then double-click a Transition.
♦ From the toolbar, click the Select button, then double-click a Transition.
Using a Transition condition’s Boolean expression, such as defining whether or not the
configured Actions of Interest for the Initial Step have been completed, add a Move Block
whose source (SRC) pin is “MySFC.Initial_Actions_Of_Interest_Status” global variable
and whose destination (DEST) pin is “Transition_Condition_Value” local variable.
♦ From the toolbar, click the Select button, then click the Step to be linked.
When defining a Step’s Action Logic, always connect a Boolean expression to the
Action_Finished local variable. This enables Actions of Interest Control to be used in the
SFC by having the Action state when it has finished. This is recommended even if Actions
of Interest Control is not being used in the application. It makes using the Actions of
Interest Control feature in the application much easier later in development if needed.
3. From the toolbar, click the Run button . The Run SFC dialog box displays.
Click OK to
continue.
4. To pause the SFC, click the Pause icon to display the Pause
SFC dialog box, then click OK.
♦ From the toolbar, click Reset button to display the Reset SFC dialog
box, then click OK. The reset Initial Step displays green.
1. From the toolbar, click the Mode button to display the Single
Step Mode SFC dialog box, then click OK.
2. To place the SFC back into Free Running mode, click the Mode button again to
display the Free Running mode SFC dialog box, then click OK.
Note When the SFC is placed into Single Step Mode, all Implicit Holds are removed
from Transitions, and previously set Operator Holds are restored.
♦ From the logic sheet, right-click the Transition that has a HOLD applied, then
select Acknowledge Hold to display the Acknowledge Hold dialog box.
Click Yes to
acknowledge
the Hold.
Note If the Transition Condition for Trans1 was set to True at the time the HOLD was
acknowledged, the SFC would continue.
♦ From the logic sheet, right-click the Transition then select Force Transition
to display the Force Transition dialog box.
• Run
• Reset
• Transition Hold
• Transition Hold Acknowledge
• Transition Force variables
In addition, the SFC’s Step Active Flags, Transition Active Flags, and Transition
Condition Value are placed onto EGD automatically.
The user has an option to place items from the SFC Monitor Interface on
EGD. These items include Action of Interest Status, Transition Progression
Status, and Step Active Times variables. By default, the Step Active Times are
automatically placed on EGD in the ToolboxST application.
2. To remove the SFC from EGD, use the same drop-down list and select the blank entry.
Creation Wizard
Mark VIe components are created from the System Editor by using
the Mark VIe Creation Wizard screens.
To create a component
♦ From the System Editor Tree View, right-click the system name and
select Insert New from the shortcut menu.
♦ From either the System Editor Tree View or the Summary View, double-click
the Mark VIe component. The Mark VIe Component Editor displays.
The Component
InfoView displays
feedback information on
the currently selected tab.
♦ From the Component Editor, click an item in the Tree View. The configuration
information for that item displays in the Summary View and Property Editor.
Summary View
The information displayed in the Summary View depends on the item selected in
the Tree View. There are many types of summary views ranging from the block
diagram to simple lists of referenced files where no editing is possible.
Property Editor
The 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 item
displays in the left field and the value displays in the right field.
♦ From the Property Editor, select an item by clicking its value field.
The field can display several options:
Click the Ellipsis button to change the value from a dialog box.
If no button displays, edit the value directly in the corresponding text box
on the right side of the Property Editor.
The Component InfoView contains several tabs that provide status information.
(Depending on the open component type, additional tabs may also be available.)
Tip If there is a build problem, the error is listed on the Log tab. Double-click
the error. The input focus goes to the location in the component configuration where
the error occurred.
History tab keeps a navigation history for each user session and allows you to return
to different places in the editor. Each time an item is selected in the Tree View or
Summary 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 displays
all other places in the controller where they are used.
Tip From the Where Used tab, double-click the desired item. The input focus goes
to the view represented by that line and the item is selected.
The write icon that displays at the beginning of some lines indicates
that the variable is being written at that location.
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 is
generated 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.
Note Some Data Grids, especially those without an Append Row, may not support all
features described in this chapter.
Editing Data
To... Do this:
Edit a text or numeric value
Left-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 a
drop-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 Left-click the row header for the first row to be edited. Then, while pressing the CTRL key,
same value for multiple rows left-click added row headers. After selecting all desired rows, use the Property Editor to
change properties for all selected rows. (Some properties are omitted when a group of rows is
selected, and properties with conflicting values will display no value in the property editor.)
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 original Right-click any column header and select Default Column Organization.
configuration
Add or remove columns Right-click any column header and select Organize Columns to display the
Organize Columns dialog box.
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, select
Copy 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 or Click the top left cell of the desired range and drag to the bottom right cell. Right-click
more cells the selected region and select Copy Selected/Current Rows to place the cells on the
clipboard. 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 inside
the 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 first
row. Then, while pressing CTRL, click any added row headers to be moved. Release
the CTRL key and drag a row header to the new data grid.
Add a variable to a block diagram, Arrange windows on screen so both the source grid and a destination block diagram,
Trender window or Watch Window Trender window or watch window are visible. Then, drag the row header for the variable
from a data grid to the destination window.
Tip You can copy and paste rows between different data grids if the columns match
by following the above procedures and navigating to a different data grid before
pasting 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 column
names. To make sure pasted data is placed into the proper columns, do not change
column ordering and always select the exact destination range in the ToolboxST
configuration before pasting data from Excel.
♦ From the Component Editor, select the Options menu, then select
Settings to display the Settings dialog box.
Note In the Settings dialog box, categories are listed in a Tree View on the left side
of the dialog box.
Show Boot Loader displays the boot loader in the Download Wizard
when it does not have to be downloaded.
Enable I/O diagnostic Alarm Events, when set to True, makes available I/O
diagnostic alarm events for automatic updates in the I/O Diagnostic Viewer.
Show More Enhanced Diagnostic Icons, when set to True, displays enhanced
diagnostic icons in the Tree View and the Summary View (Show Diagnostic
Icons must be set to True for this option to be enabled).
Refer to Chapter 2, the • Access Roles allows you to set Modify Data and Modify Design access
section SecurityST for more rights to pre-defined user roles. Once roles have been assigned to a protected
information. object, only users with those roles can access the object.
• Modify Data allows you to make changes to data values associated with an
object without changing how it works. For example, it protects the initial value of
a variable defined in a controller. The purpose of this right is generally to keep
unauthorized 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 within
a library block diagram. The purpose of this right is to limit the ability to
change how the system works to authorized persons.
A protected object can have one or more of these access rights (refer to
the section, Protected Objects). Each right can have a different password
set. Some objects can be protected if they are contained in another parent
object, 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.
Protected Location
indicates which object is
protected within the system.
Although some object(s)
may not be protected, the
object can be contained
within another protected
object. It is important to
know which object is asking
you to enter a password.
Note Passwords are case-sensitive – secret and Secret are not considered to be the
same password.
button. If there is already a password on that access right and it has not yet
been entered, you are first asked for the password before being allowed to change
it. The Change Modify Design Password dialog box opens.
Password Caching
The security system caches passwords that were previously entered so that once
you enter a unique password, you don’t have to enter that password again. Separate
caches are maintained for the system and each major component (such as a Library
Container). A cached password remains until the component is closed.
Note From the Device menu, select Restore Password Protection to clear all passwords
and protect the component.
Tip If you have performed an operation in the ToolboxST application that requires
entering a password, it is recommended to close the protected component when you are
done so that an unauthorized user does not gain inappropriate access.
Access Roles allows you to set modifying data and design rights
to previously defined user roles.
Modify Data allows you to modify data values and forcing of variables.
Protected Objects
Specific actions governed by each access right depend on the specific component
type. Examples of protected objects are:
Component can have Modify Data and Modify Design passwords. Modify Data
prevents you from saving changes or changing initial values for variables defined in
the component's application software. Modify Design prevents you from modifying
any aspect of the hardware or software configuration for the component.
User Block Library can have passwords for all three access rights. They have no direct
effect 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 block
passwords 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 Data
and Modify Design protection for the parent component. The passwords assigned to
an instance of some block in a user block library are initially set to the passwords that
were in force in the definition of that block. Once instanced though, any changes to the
protection on the block definition do not propagate to instances of that block.
♦ Install the new version. Refer to the section, Installation. The icons on your desktop
and in your Start menu are updated to start the most recently installed version.
To upgrade a component
1. Install new software for the component type that you want to upgrade by
installing the latest version of the ToolboxST application.
2. Start the ToolboxST application and open the system file. Double-click
a component to open its Component Editor.
3. From the File menu, select Upgrade. The Mark VIe Product
Version Upgrade Wizard displays.
Click Next.
The report displays configuration differences in areas such as hardware and software.
Differences are arranged in appropriate groups and sub-groups.
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 diagnostics
and I/O status
Profiler Display the Controller Load Profiler window
EGD Management Start the EGD Management Tool (refer to GEI-100619, EGD Management Tool
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.
Device Online Connect or disconnect from a controller
Build Convert the current configuration into binary files that can be downloaded to a
controller
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 code
to the controller and distributed I/O modules
Update Dynamic Data Recorder exchanges updated information with
the DDRs in the controller
View/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 new
controller 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
Restore Password Clear all passwords and protect the component
Protection
♦ From the System Editor, double-click the Mark VIe Component to display the
Mark VIe Component Editor. The General tab is selected by default.
Property Editor
allows you
to edit the item
currently 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 be
viewed for analysis by an external client through a web interface.
% Command Size specifies the maximum size (as a percentage) of both the
command and event portions of the Command and Event log.
Time specifies the number of days that the Command and Event log is
kept if the allocated space is not exceeded.
Compressed Data Log activates the compressed data logging, which causes
selected variables to be collected in the controller data log file.
Note The Compressed Data Log property is only available when the application
running is a 1.5 MW Wind Turbine.
% Size specifies the maximum size (as a percentage) of the Compressed Data log.
Enable Compressed Data Log, when set to True, activates the Compressed Data
Log. 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 offline
load.
Time specifies the number of days the Compressed Data log is kept so
long as the allocated space is not exceeded
Controller Web Pages, when set to True, enables access to controller web pages
if they are provided by the controller or another product. The controller can provide
a set of default pages as part of the firmware download. Product web pages can
also be downloaded to the controller. For example, the 1.5MW Wind Turbine uses
product-specific web pages that are downloaded separately.
Enable Controller Web Pages, when set to True, activates the Web server
on the controller. It also displays the Web Page Tab.
Note When set to False, a major configuration difference occurs that forces an offline
load.
Web File Path is the directory used as the web page source when
downloading product web pages to the controller.
Automatic, the default, creates backup files in a device.zip file during a Build
command, and provides an option in the Download Wizard to download the device.zip file.
Enable Alias Prefix, if set to False, disables the prefixing of the alias
with the device name (the default is False).
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 minor
change (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-only
in the Mark VIe Component Editor and can only be changed from the System Editor.
NTP Configuration Mode determines how the Network Time Protocol client
synchronizes the controller time. Valid options are:
Note Disabling NTP results in a major configuration difference that forces an offline
load.
Configuration Manual Override, when set to True, allows you to manually override
all settings for the local device rather than use the settings configured at the system level.
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 VIe
product associated with the selected component. The version number is set when the
configuration is first created, and is updated with each upgrade operation.
• Access Roles are assigned to protect each access right for this component.
• Modify Data permits modification of data values and the forcing of variables.
Frame Period determines the frame period in milliseconds. A frame is the basis for
Mark VIe scheduling; the frame period determines the fastest scan time, the rate at which
first 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 a
1.5 MW Wind Turbine.
Enable Wind Farm Management System, when set to True, allows a wind
turbine to be controlled by the wind farm controller.
Note When set to False, a major configuration difference occurs that forces an offline
load.
Note The four properties below are only available when the application running is a
Wind Control.
Max Wind Farm Turbines is the maximum number of wind turbines for this
Wind Control. If this number is reduced after the turbines have connected, those
turbines are disconnected from Wind Control when the timeout parameter set
in 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.
Password Protection
If passwords were set for this component, changing the following
properties requires a password.
Note The first time you attempt a password-protected function, the Enter Password
dialog box displays. All protected functions performed during the remainder of the
ToolboxST session do not require re-entering the password.
♦ From an attribute Data Grid, click a Value Cell, and then click the ellipsis
button. The Modify Value dialog box displays.
The name of
the attribute
being modified
The value of
the attribute
If checked, the
attribute values
are restricted to
an enumeration
(a predefined set
of allowable
values).
Host Name is the Internet Protocol (IP) host name for the selected network adapter.
Wire Speed is the speed of the network to which the selected adapter is connected.
Subnet Mask controls which portions of the IP address are deemed significant.
(This property is usually unavailable; for I/O networks, the subnet mask is
always a fixed value, and for other networks defined at the system level, the
subnet mask is configured in the System Editor.)
Note The Auto-Reconfiguration feature applies only to I/O packs; it is not available
for controllers or terminal boards. Refer to GEH-6721, Mark VIe Control System Guide,
Volume II, for a list of I/O packs
To help with identification and version management, each I/O pack has an I/O
compatibility code and a configuration compatibility code. These codes identify the I/O
map layout and the configuration area for a pack. For each compatibility code set, there
are multiple hardware forms used to identify physical characteristics of the pack. Each
I/O pack module that can be added to a Mark VIe controller is identified by both its
hardware form factor and its compatibility codes. For example, PDOA_2_2 represents
the discrete output module with I/O compatibility code 2 and configuration code 2.
Note Removing all WCBM packs causes a major configuration difference that forces
an offline load.
Password Protection
If passwords were set in the General tab Property Editor for this component,
the following functions require a password.
Note The first time you attempt a password-protected function, the Enter Password
dialog box displays. All protected functions performed during the remainder of the
ToolboxST session do not require re-entering the password.
♦ From the Hardware tab Tree View, select the Distributed I/O item.
♦ From the Hardware tab, right-click the Distributed I/O item in the Tree View
and select Add Module to display the Add Module Wizard.
Click Next.
Note If the module being added does not have an auxiliary terminal board, the window
shown below does not display.
Click Next to
preview
configuration
information.
To create a group
♦ From the Hardware tab Tree View, right-click the Distributed I/O item and
select Add Group. The Add Group dialog box displays.
Enter a
Description of
the group
(optional).
Click OK.
♦ From the Hardware tab Tree View, drag a module to the desired
♦ From the Tree View, right-click the module to modify, then select Modify... from
the shortcut menu to display the Modify: [module name] dialog box.
Group Layout
Network Layout
When you select a module from the Tree View, several tabs display in the
Summary View. Each module contains four common tabs (Summary, Parameters,
Variables, and Diagnostics). Many modules also contain custom tabs that configure
available I/O capabilities. For information about the settings configured by I/O
pack-specific tabs, refer to the I/O pack documentation.
For example, the following set of tabs (taken from a PDOA module) contains
the base set, as well as two other tabs, Inputs and Outputs.
Note Some infrequently used parameters are classified as Advanced and are hidden
Variables Tab
The Variables tab displays available variables from the module that have no
physical endpoint. These variables exist only internally in the module, and
can 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 meaning
to software or firmware, such as those used for excitation.
ExtraCircuits Tab
This tab contains input/output variables found on the module terminal boards, which
can be associated with the application software. For some modules, these tabs are split
into 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.
If the variable name entered is undefined, the Undefined Variable dialog box
displays. Click Yes to select the desired software item, as shown above.
The state
of the fault.
Inactive Alarm(s)
Active Alarm(s)
Note Modules can be upgraded to a different compatibility code set if one is available.
♦ From the Hardware tab Tree View, right-click the module to be upgraded and
select Upgrade. The Upgrade Module Wizard displays.
For the example module shown below, there are two module versions available: a PDOA
with compatibility code set 2,1 and a PDOA with compatibility code set 3,1.
Click a new m
version to upg
the module.
Note When the ToolboxST V03.05 application is installed, the Upgrade option allows
you 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 or
a previous revision. Only newer revisions display in the drop-down list of revision
options in the Upgrade Wizard.
The I/O Diagnostic viewer provides a utility to interrogate I/O pack faults,
version, and diagnostic communication data. Diagnostic I/O pack reports can
be generated on a pack, module, or component level.
Normal
Inactive Alarm(s)
Active Alarm(s)
Link broken
Link error
Link warning
Link information
Note Place the mouse over the icon to display detailed messages regarding the
problem.
♦ From the Summary tab, left-click an I/O pack or terminal board, then select
Troubleshoot and Status from the context menu to display the viewer.
♦ Left-click an I/O pack or terminal board in the Summary tab, then select Create
module Report. The desired I/O pack report is created.
Downloading Parameters
After modifying parameters in a module, you must download to the module before the new
settings take effect. Downloads to a module are separate from downloads to a controller.
Comparing Parameters
While making changes to a module’s configuration, it is often useful to compare
the downloadable configuration items currently stored in the pack with the current
configuration of the same items in the ToolboxST application.
♦ From the Hardware tab Tree View, right-click a module to compare and select
Compare Parameters. The Differences dialog box displays.
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 library
references and instancing all linked user blocks. The shortcut menu also contains
commands 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
Note The first time you attempt a password-protected function, the Enter Password
dialog box displays. All protected functions performed during the remainder of the
ToolboxST session do not require re-entering the password.
To add a program
Note The Add Existing Program command reads an .xml file from another system
or controller into the current controller.
Instance All
The Instance All command creates a new copy of all linked user blocks from
the referenced user block libraries. In addition to updating the user blocks, this
command causes the instance scripts and text substitutions to run.
To add a task
Note The Add Task and the Add User Block dialog boxes are identical except for the
title 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 instancing
goes through the blocks in that user block and instances the linked user blocks.
To unlink a program
♦ From the Tree View, right-click a program item, then select Unlink Permanently.
The linked icon next to the item in the Tree View changes and the
program is unlinked from the library.
Note Linked tasks and user blocks can also be unlinked permanently.
Remove Unused Variables removes the unused variables for all linked user
blocks in this device when the user block is instanced.
Execution Order sets the order of execution of this program in the controller.
Schedule Offset is the offset from beginning of frame at which the task runs.
Block Type is the name of the library block that the selected block is an instance of.
Instance Script causes the script to run when the block is instanced.
Show Description, when set to True, displays the description of the selected block.
Block Data Type is the data type for variant pins in the selected block instance.
Enable, when set to True, enables variables for the selected block.
Version is the version number for the source of the selected block instance.
User block and task variables are local by default, and display under the
associated user block item in the Tree View.
Note Variables can also be added in the Summary View by directly editing the last
row of the variable grid.
Alarm, if set to True, enables the variable as an alarm. Alarms are used for
problems that require the operator’s attention and acknowledgement. The alarm
queue consists of a list of time-tagged alarm state transitions.
Alarm Inhibit Group selects the alarm inhibit group for the alarm variable.
Event, if set to True, enables the variable as an Event. Events are stateless messages
that are not queued within the controller. When an event occurs, a time-tagged
transition 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 hold
queue 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. The
valid range is 1 through 1000, where 1 is the least severe.
Plant Area places variables into logical plant groupings for display in
the WorkstationST Alarm Viewer.
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-high
property 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 Format Spec has been specified and this display-low
property is not specified, the Format Spec Engineering Min is used.
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-high
property 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-low
property is not specified, the Format Spec Engineering Min is used.
HMI Resource allows you to configure access and visibility of variable and alarm data.
Units are engineering units. If a Format Spec has been specified and this Units attribute is
not specified, the Format Spec Units is used. If you are using the SDB version of the HMI
device, 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 is
available to the WorkstationST and HMI.
Full Name is the fully qualified name of the variable. For example, a variable
name gas_fuel_opt in a user block named Config under the Program CORE
would have a full name of CORE.Config.gas_fuel_opt.
Initial Value allows array length, data type, and enumeration editing.
Interface Definition is the name of the interface that the selected variable implements.
EGD Page is used to assign the variable to an Ethernet Global Data Page.
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 EGD
page. For example, the name for variable IGVA in user block VG_Health in task Task1
in 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 used
in the program or user block in which it is created. If it is global, it can be used in other
programs and user blocks. A variable must be global to be used on EGD.
Output pins are shown on the right side of the user block.
State pins are shown on the right side of the user block.
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 the
value to the Compressed Data Log in the controller.
Note The Controller Collected property is only available when the application running
is a 1.5 MW Wind Turbine.
Note The Override Properties property is only available for global variables that are
contained 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 are
contained within a linked program, task, or user block.
A table definition consists of a name, note, identification string, revision string, engineering
units (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 and
consist of X and Z linear arrays of the same length. Tables with two independent arrays
are sometimes called bivariant tables and consist of X and Y linear arrays and a Z
two-dimensional array. Bivariant table definitions display in the Summary View as follows:
2. Enter the new variable name in the Add New Variable dialog box and click
OK. The new variable is added to the list in the Summary View.
Note Variables can also be added in the Summary View by directly editing the last
row of the variable grid.
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.
Note Since the schedule offset depends on the frame multiplier, it is possible to select
a frame multiplier for which the current schedule offset is invalid. This will cause a
validation error when you build the application.
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 instancing
goes through the blocks in that user block and instances the linked user blocks.
2. Enter the new variable name in the Add New Variable dialog box and click
OK. The new variable is added to the list in the Summary View.
Note Variables can also be added in the Summary View by directly editing the append
row of the variable grid.
User Attributes
User block attributes only display on linked or unlinked user blocks whose user block
definition contained attributes in the library. They can be modified so that when their
parent user block is instanced, the modified attributes are used in the scripts and text
substitutions that access them. Refer to the section, Working with User Blocks.
BlockType is the name of the user block definition in the library from
which this user block started.
Protection expands to show the access rights for this user block definition.
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.
Configuring DDR
To configure a DDR
Name is the user-defined description for this DDR, which is used for the filename.
Setup
Buffer Control
Normal causes the DDR to collect pre-samples before a trigger event and thereafter
continue 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 collect
data when the trigger condition is satisfied. Data is collected until Enable
transitions False or the collection fills the buffer.
Upload Type
Trip is an automatic upload by the data collection, then added to the trip log.
Pre-trigger Samples are the number of samples collected before the trigger.
Setup Variables
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.
LT is the value of the trigger variable, which must be less than 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 variable
to determine the presence of a trigger. For Boolean trigger variables, the only valid
values for the trigger value are 1.0 for TRUE and 0.0 for FALSE. Note that if an analog
trigger variable of a different data type is configured, it may be possible to specify a
trigger value that cannot be exactly represented by the trigger variable. Users should
be aware of this limitation when specifying the EQ trigger condition.
Trigger Type
Status Variables
Status variables, which indicate the status of the associated DDR, are used to
determine when to upload the data. Status variables are always integers, and are
automatically defined and placed on the EGD status page.
Note There is a 12 MB size limit on the memory that can be allocated to the DDRs. If
this memory allocation is exceeded, an error is reported during validation.
To add a variable
1. From the Component Editor, select the Dynamic Data Recorders
tab to display the DDR list.
Updating DDR
DDRs can be updated separately from the application code download.
To update a DDR
♦ From the Device menu, select Download, and then select Update Dynamic Data
Note DDRs cannot be downloaded if there is a major difference in the device. In this
case, the application code must be downloaded.
2. From the Import File dialog box, select the .xml file that corresponds
to the DDR you wish to import. Click Open.
Note If the .xml file being imported contains the formatting flags %n, it is replaced by
the Mark VIe component Design Memo (DM) number. This is a GE Power Systems
project number and can be edited by selecting the General tab and Requisition Info.
5. Create a User Block in the program, and add two FuncGen blocks.
These are in the Data Collection section. Set up the pins on the two
blocks as shown below. FuncGen1 is set up as a Sine wave generator and
FuncGen2 is set up as a Triangle wave generator.
12. The Trender is used to upload the capture buffer. From the View menu, select
Trenders to add a new trend. The Trender window displays.
EGD Configuration
To configure EGD for a component
1. From the System Editor, double-click a component to display
the Component Editor.
2. From the Component Editor, select the EGD tab.
3. From the Tree View, select Ethernet Global Data.
Collection controls the collection to which this EGD component belongs when
viewed in the EGD management tool (EMT). This information is published to the EGD
Configuration server in the GUI component document, GUIDevice.xml.
Producer ID sets and displays the EGD Producer ID for this component. This
is assigned when the component is created. The Property Editor displays the
EGD Producer ID formatted as an unsigned integer, but dotted and hexadecimal
♦ From the Tree View, right-click the Produced Pages item, then select
Add Page. The Page Name dialog box displays.
Note When the first Produced Page is created, it automatically becomes the Default
page.
Tip Any variable defined with $Default as the EGD page name is automatically
placed on the currently selected Default page.
To delete a page
♦ From the Tree View, right-click the page you wish to delete and select Delete.
♦ From the EGD tab Tree View, expand Ethernet Global Data.
From theTree
View, select the
desired page.
The properties
for the selected
page display in
the Property
Editor.
Ethernet 0, if selected, causes EGD to be broadcast on Ethernet Adapter 0. (If more than
one 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 to
Unicast, the page is only sent to a single destination.
Default Page can be set to True if the selected page is the Default Page. To
change the default page, refer to the section, Produced Pages.
Layout Mode, if set to Auto, automatically assigns exchange numbers and offsets assigned
at build time. If set to Manual, exchange numbers and offsets can be entered manually.
Period Multiplier multiplies the value by the Controller frame period to obtain
the EGD page period. (The results display in the Period property.)
Skew is used to prevent exchanges with the same period from being produced at exactly
the same instant. The skew for the first exchange in the page is set to this value, and
each additional exchange skew differs from the previous exchange’s skew by exactly
this value. For example, if you have three exchanges in a page and a skew value of
2, the first exchange’s skew is two, the second exchange’s skew is four and the third
exchange’s skew is six. (The skew property is measured in nanoseconds.)
Starting Exchange ID is used for the first exchange on this page. Each
additional exchange will be incremented from this number. When this property
is changed, all exchanges are renumbered.
Page Compression
When a page compression is performed, the variables are located in increasing size
order, starting with Booleans, then Words, Double Words, and finally all other variables.
A page compression causes an exchange major signature. Consumers can mark the
exchange variables as unhealthy until the consumed configuration can be rebound.
♦ From the Tree View, right-click the page to compress, and then select Compress.
♦ From the Tree View, right-click Produced Pages, and then select Compress All.
♦ From the Component Editor Tree View, right-click the desired page, and then
select Add Variable. The Select a Variable dialog box displays.
Tip If the variable to be added to the EGD page is already in use on the Software
tab, you can add the variable without using the EGD tab. To add a variable from the
Software tab, select the desired variable(s) in the Summary View, and then set the EGD
Page property using either the Summary View or the Property Editor.
♦ From the Summary View, right-click a variable, and then select Copy Selection.
The data is copied in Comma Separated Value (csv) format.
Note To edit exchange signatures and configuration time, set Layout Mode to Manual.
3. Review the warning about manual Exchange Signature editing, then click OK.
4. Make any desired changes to the signatures and configuration time,
then click OK to close the dialog box.
Due Time is the time that a consumer data packet must be received
for an exchange to remain valid.
Length is the value for a produced exchange. This length may be the highest variable
offset 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 length
of the produced exchange, depending on the bind algorithm of the individual tool.
Refresh Errors are the number of times a refreshment fault has occurred. A refreshment
fault occurs when a subsequent data production packet (or initial packet at startup
time) does not arrive at a consumer within a pre-defined update period.
Note The EMT provides a detailed view of the configuration server contents.
The Filter Toggle button defaults to a filtered state. It displays items that have
the same name but have a different Producer ID as the open component.
The Delete button deletes the selected item(s). If the item(s) were saved
as part of the configuration, they can be added again.
The EGD configuration server uses the producer ID to store all the
documents for an EGD node.
If you open two systems, then point to the same configuration server and save a
device of the same name with two different producer IDs to that server, you can
end up with two producer ID nodes with the same device name.
Note You can select devices to search against. The individual pages, with just
variables, perform the same Compare.
The Referenced Devices item on the EGD tab also has a Compare command
that compares the consumed variable information for the open component
against the EGD configuration server’s content.
♦ From the Tree View, right-click the Referenced Devices item, and then
select Select Devices to display the Select Devices dialog box
The EGD configuration for the selected devices are loaded and the variables
display in the Summary View.
Note When EGD configurations are edited in remote devices, you must refresh the
configuration to ensure that the latest variable information is used. The configuration is
automatically refreshed when a component is opened, and when a Build is performed
in the component.
♦ From the Tree View, right-click the device to be refreshed, and select Refresh.
♦ From the Tree View, right-click the device, and select Create
Undefined Variables.
This feature can be implemented using the existing controller (referred to as Mark VIe
integrated Modbus) or an additional controller (referred to as Mark VIe gateway Modbus).
Using the existing controller allows for a direct Modbus interface, but would expose the
controller to the extra loading and burden of serial interrupts when serial communication
paths are needed. Because a serial interrupt is critical, the Modbus slave feature supports
both serial and Ethernet/TCP capability on Mark VIe gateway Modbus, while only
Ethernet/TCP capability is supported on Mark VIe integrated Modbus.
Modbus Overview
Ethernet
Connection Timeout specifies the time in minutes that the slave remains connected to
the master over Ethernet when no requests are being received. The valid range is one to 10.
Interface
Shared (both Ethernet and serial) is only supported on Mark VIe gateway Modbus.
Baud Rate specifies serial communication rate (bits per second). The valid
choices are 2400, 4800, 9600, 19200, 38400, and 57600.
Data Bits specifies number of bits per character. Only eight bits is supported.
Parity specifies check character. The choices are None, Odd, Even, Mark, and Space.
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.
Command Limit limits the number of commands processed per second. This
is based on commands that have changed, not commands that are identical to
previously received commands. The valid range is 0 to 25.
Data Swapped changes the transmission order if the data is greater than 16
bits 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 0x45
0x67 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 0xAB
0xCD 0xEF
NAK Code specifies the Negative Acknowledge code to be used if data is requested
from a controller that is incapable of receiving the Modbus request. Code options are
4, 6 or None. None is selected only if the master needs no reply when communication
fails between the Mark VIe gateway Modbus and the target processor.
The Modbus Slave tab contains four pages that are used to exchange data with a Modbus
Master. The pages differ by the access the master receives to the data (read-only or
read/write) and the type of data (a Boolean or a 16-bit word) as follows:
Data Types
The ToolboxST application allows you to specify the variables on each page using a Data
Grid. When you add a variable to a page, both the Modbus slave and the selected page are
enabled on the controller. As you add and remove variables, the controller is updated so
that 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.
Connected Variable is the variable that is read or written from the device or the
referenced device. A variable must be on an EGD page before it can be added to a Modbus
slave page. A connected variable must be added before the other columns become active.
• BOOL is one bit of a 16-bit word. (This is the only option if the
connected 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 is
automatically set to a value adjacent to the highest address previously on the page, but
the 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 for
addresses is 1 to 65534. When specifying an address for a BOOL variable, the bit 0-15
within the 16-bit word is represented by a decimal. For example, 1.00 selects register
address 1 and bit 0, and 10423.7 selects register address 10423 and bit 7.
Raw Min, Raw Max, Eng Min, and Eng Max are columns that convert Modbus
slave variable data into engineering units. The Raw Min and Raw Max columns
control the minimum and maximum for the raw data. The Eng Min 0 and Eng Max
columns control the minimum and maximum engineering units to which the raw
data will be scaled. (The BOOL data type cannot be scaled.)
Creating Reports
To create a report
♦ Open a Mark VIe Component Editor. From the View menu, select Reports,
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.
♦ From the File menu, select Save Report. In the Save Report dialog
box, enter a file name and click Save.
♦ From the File menu, select Open Report. In the Open Report dialog
box, locate the report in .csv format and click Open.
To print a report
♦ From the File menu, select Print. In the Print dialog box, verify that
the settings are correct and click OK.
Viewing Reports
To change the zoom level of a report
♦ From the Report View menu, select Zoom and select the desired
zoom value from the drop-down list.
To sort a column
♦ From the Report window, click any column heading to apply a sort to
that column. The first click sorts the column in ascending order; a second
click sorts the column in descending order.
A triangle in a column
header indicates that the
rows are sorted based on
the data in that column.
♦ From the Report window, select the Report menu and click Apply Filter
to open the Edit Report Filter dialog box.
♦ From the Report window, select the Report menu and click Remove Filter.
The filter is removed and all available rows display.
♦ From the Report window, select the File menu and click Save Report.
♦ From the Report window, select the Report menu and click Find
to display the Find dialog box.
If selected, the
capitalization in the
report and the
search string must
exactly match.
The following report columns can be imported from the .csv file:
Unused I/O are connected I/O values that are not used anywhere.
Note The contents of both types of reports can be exported to a .csv file.
Configuration Report
To generate an Auto-Reconfiguration Configuration report
♦ Open a Mark VIe Component Editor. From the View menu, select Forced
Variables to display the Forced Variables window.
♦ From the File menu, select Print. In the Print dialog box, verify that
the settings are correct, then click OK.
Global Variables
The Global Variables window displays all controller variables that have been
configured as Global in one central location.
The Global Variables window is particularly useful when you want to modify a
property for multiple variables. For example, to move multiple variables onto an
EGD page, select the rows for the desired variables and then change the EGD Page
property in the Property Editor. Refer to the section, Data Grids.
Because only existing global variables can be changed, new variables cannot be added
from the Global Variables window. You cannot make any change that affects the name
of the global variable (like Name or Global Name Prefix). Finally, variables from an
instanced library user block can only be modified if the Merge Variables at Instance
property of the Programs item on the Software tab is set to True.