Campbell Scientific RTMC User Manual
RTMC Pro
Revision: 7/13
Copyright © 2006-2013
Campbell Scientific, Inc.
License for Use
This software is protected by United States copyright law and international
copyright treaty provisions. The installation and use of this software constitutes
an agreement to abide by the provisions of this license agreement.
Campbell Scientific grants you a non-exclusive license to use this software in
accordance with the following:
(1) The purchase of this software allows you to install and use the software on
one computer only.
(2) This software cannot be loaded on a network server for the purposes of
distribution or for access to the software by multiple operators. If the
software can be used from any computer other than the computer on which
it is installed, you must license a copy of the software for each additional
computer from which the software may be accessed.
(3) If this copy of the software is an upgrade from a previous version, you
must possess a valid license for the earlier version of software. You may
continue to use the earlier copy of software only if the upgrade copy and
earlier version are installed and used on the same computer. The earlier
version of software may not be installed and used on a separate computer
or transferred to another party.
(4) This software package is licensed as a single product. Its component parts
may not be separated for use on more than one computer.
(5) You may make one (1) backup copy of this software onto media similar to
the original distribution, to protect your investment in the software in case
of damage or loss. This backup copy can be used only to replace an
unusable copy of the original installation media.
This software may not be sold, included or redistributed in any other software,
or altered in any way without prior written permission from Campbell
Scientific. All copyright notices and labeling must be left intact.
Limited Warranty
The following warranties are in effect for ninety (90) days from the date of
shipment of the original purchase. These warranties are not extended by the
installation of upgrades or patches offered free of charge.
Campbell Scientific warrants that the installation media on which the software
is recorded and the documentation provided with it are free from physical
defects in materials and workmanship under normal use. The warranty does not
cover any installation media that has been damaged, lost, or abused. You are
urged to make a backup copy (as set forth above) to protect your investment.
Damaged or lost media is the sole responsibility of the licensee and will not be
replaced by Campbell Scientific.
Campbell Scientific warrants that the software itself will perform substantially
in accordance with the specifications set forth in the instruction manual when
properly installed and used in a manner consistent with the published
recommendations, including recommended system requirements. Campbell
Scientific does not warrant that the software will meet licensee’s requirements
for use, or that the software or documentation are error free, or that the
operation of the software will be uninterrupted.
Campbell Scientific will either replace or correct any software that does not
perform substantially according to the specifications set forth in the instruction
manual with a corrected copy of the software or corrective code. In the case of
significant error in the installation media or documentation, Campbell
Scientific will correct errors without charge by providing new media, addenda,
or substitute pages. If Campbell Scientific is unable to replace defective media
or documentation, or if it is unable to provide corrected software or corrected
documentation within a reasonable time, it will either replace the software with
a functionally similar program or refund the purchase price paid for the
software.
All warranties of merchantability and fitness for a particular purpose are
disclaimed and excluded. Campbell Scientific shall not in any case be liable for
special, incidental, consequential, indirect, or other similar damages even if
Campbell Scientific has been advised of the possibility of such damages.
Campbell Scientific is not responsible for any costs incurred as a result of lost
profits or revenue, loss of use of the software, loss of data, cost of re-creating
lost data, the cost of any substitute program, telecommunication access costs,
claims by any party other than licensee, or for other similar costs.
This warranty does not cover any software that has been altered or changed in
any way by anyone other than Campbell Scientific. Campbell Scientific is not
responsible for problems caused by computer hardware, computer operating
systems, or the use of Campbell Scientific’s software with non-Campbell
Scientific software.
Licensee’s sole and exclusive remedy is set forth in this limited warranty.
Campbell Scientific’s aggregate liability arising from or relating to this
agreement or the software or documentation (regardless of the form of action;
e.g., contract, tort, computer malpractice, fraud and/or otherwise) is limited to
the purchase price paid by the licensee.
Table of Contents
PDF viewers: These page numbers refer to the printed version of this document. Use the
PDF reader bookmarks tab for links to specific sections.
1. Introduction.................................................................1
1.1 What’s New in RTMC Pro 4.1?...........................................................2
2. Development Mode.....................................................3
2.1 The RTMC Pro Workspace..................................................................4
2.2 Display Components............................................................................4
2.3 Functions Available from the RTMC Pro Menus ..............................13
2.4 Expressions ........................................................................................19
2.4.1 Operators.....................................................................................22
2.4.2 Order of Precedence....................................................................22
2.4.3 Predefined Constants...................................................................23
2.4.4 Predefined Time Constants.........................................................23
2.4.5 Functions.....................................................................................23
2.4.6 Logical Functions........................................................................24
2.4.7 String Functions..........................................................................25
2.4.8 Conversion Functions .................................................................26
2.4.9 Time Functions ...........................................................................26
2.4.10 Start Option Functions ................................................................26
2.4.11 Statistical Functions ....................................................................27
2.4.12 Expression Builder......................................................................28
2.5 Managing Data Sources .....................................................................31
2.5.1 Server Data Source......................................................................32
2.5.2 File Data Source..........................................................................33
2.5.3 Database Data Source .................................................................34
2.5.4 HTTP Datalogger Source............................................................38
2.5.5 Virtual Data Source Properties....................................................38
2.6 Reports in RTMC...............................................................................39
3. RTMC Run-time.........................................................42
4. CSI Web Server .........................................................43
4.1 CSI Web Server Administrator ..........................................................44
4.1.1 Status...........................................................................................44
4.1.2 Configuration ..............................................................................45
4.1.2.1 Edit Root Permissions......................................................45
4.1.2.2 HTTP................................................................................45
4.1.2.3 HTTPS..............................................................................45
4.1.2.4 Log Control ......................................................................46
4.2 Web Publisher....................................................................................47
4.2.1 Creating Websites .......................................................................48
4.2.2 Managing Websites.....................................................................51
4.3 Web Security......................................................................................51
4.3.1 PC Websites ................................................................................51
4.3.1.1 Using the CSI Web Server Administrator........................52
i
Table of Contents
4.3.1.2
Using the Web Publisher ................................................. 54
4.3.2 Datalogger Websites .................................................................. 54
4.4 API Commands ................................................................................. 55
4.4.1 Command Syntax ....................................................................... 55
4.4.2 Data Access Commands............................................................. 55
4.4.3 Control Commands .................................................................... 60
4.4.4 File Management Commands..................................................... 63
ii
RTMC Pro
1. Introduction
The RTMC (Real-Time Monitor and Control) Pro software provides the ability
to create and run graphical screens to display real-time data as LoggerNet or
RTDAQ collects it from the dataloggers. Controls are also provided to view
and set datalogger ports and flags, as well as input locations or variables. In
LoggerNet, RTMC Pro can combine data from multiple dataloggers on a single
display. In RTDAQ, RTMC Pro projects are limited to a single datalogger. As
LoggerNet or RTDAQ collects data from the dataloggers, the displays in
RTMC Pro are automatically updated.
RTMC Pro is used to create and edit a real-time graphic display screen to
display the data collected from the dataloggers. Once the screen is built and
saved as a project, *.rtmc2, the screen can be displayed using RTMC Run-time.
This allows graphic display screens to run on other computers with just the
RTMC Run-time program.
RTMC Pro is an enhanced version of the standard RTMC Development that
ships with LoggerNet and RTDAQ. RTMC Pro contains more graphical
components than RTMC. For example, more alarms (multi-state), alarm
events (email, FTP, run/open), switches (lever, rocker, rotary), charts (XY and
scope), gauges (rotary, compass), and layout components (group box, bevel,
panel) are available. For components that exist in both versions, more
properties have been exposed in RTMC Pro resulting in more design control.
RTMC Pro also includes run/open button, hotspot, snapshot, and alarm log
capabilities. In LoggerNet, you also have the ability to add data files,
databases, HTTP dataloggers, virtual data sources, and additional LoggerNet
servers as data sources for RTMC Pro projects. See Section 2.5, Managing
Data Sources, for more information.
NOTE
A project that is created with the standard RTMC Development
version can be converted to RTMC Pro format. However, once a
project is converted to RTMC Pro format, it cannot be opened in
standard RTMC.
For help in getting started with RTMC, there is a tutorial provided on the
Downloads page of our website, www.campbellsci.com/downloads. The
tutorial is done using standard RTMC development, but the same concepts
apply to RTMC Pro.
The same RTMC Run-time is used to run projects developed in either RTMC
Pro or the standard RTMC Development.
One copy of RTMC Run-time is provided with LoggerNet and RTDAQ. For
LoggerNet, additional copies to run on remote machines can be purchased
separately.
Also included with RTMC Pro is the CSI Web Server. This allows you to view
your RTMC projects using a web browser. See Section 4, CSI Web Server, for
more information.
1
RTMC Pro
NOTE
In LoggerNet, data must be collected from the datalogger for
RTMC’s displays to be updated. Typically this is done by
setting up a schedule in LoggerNet’s Setup Window. It can also
be done from RTMC’s Project | Configure Override Scheduled
Collection menu item.
In RTDAQ, RTMC performs a manual poll to update project
data when RTDAQ is connected to the datalogger. Therefore,
RTDAQ must be connected to the datalogger for RTMC’s
display to be updated. You can override the default one-second
interval from the Project | Configure Override Scheduled
Collection menu item.
1.1 What’s New in RTMC Pro 4.1?
RTMC Pro 4.1 includes the following enhancements from 4.0:
• Added an Expression Builder to simplify creating expressions.
• Added a Rainflow Chart component that displays rainflow data created by
a CRBasic Rainflow or RainflowSample instruction.
• Added Email Profiles that allow you to easily use the same SMTP Server,
Username, Password, From, To, Cc and Bcc fields for multiple alarms
and/or Report Export components.
• A Backed/Veered tab has been added to the Compass that allows you to
display backed/veered wind direction as a bar on the compass.
• In multi-screen projects, a red flag now appears on the tab for any screen
with an active alarm. This allows you to see when an alarm occurs on a
screen that you are not currently viewing.
• In CSI Web Server, when an alarm is acknowledged by one web client, all
others web clients viewing the page will now see the acknowledgement.
• Alarm emails now work in CSI Web Server.
• The Value Forwarder now works in CSI Web Server.
• Added the functions SelectSwitch, AvgSpa, MaxSpa, and MinSpa to be
used in expressions.
• You can now select what columns to view on a Table Display in RTMC
Run-time.
• A Time Series Chart, XY Chart, Scope, or Rainflow Chart can now be
customized in RTMC Run-time if that option has been enabled in RTMC
Pro.
• RTMC Pro now supports IPv6 addresses. IPv6 addresses are written as
eight two-byte address blocks separated by colons and surrounded by
brackets (e.g., [2620:24:8080:8600:85a1:fcf2:2172:11bf]). Prior to RTMC
2
Pro 4.1, only IPv4 addresses were supported. IPv4 addresses are written in
dotted decimal notation (e.g., 192.168.11.197). Leading zeroes are
stripped for both IPv4 and IPv6 addresses. Note that while RTMC Pro
now supports IPv6 addresses and they can be used to specify servers,
CR1000/CR3000/CR800 dataloggers will not support IPv6 until a future
OS release. Check the OS revision history on our website to determine
when IPv6 support is added to the OS.
• Miscellaneous other changes.
2. Development Mode
RTMC Pro is a graphic display editor that allows the user to easily place
graphical components on the display screen and associate them with data
values.
The RTMC Pro window, as shown below, has three sections.
Project Tree - The panel on the left shows the hierarchy of the display
components and how they are associated with each other. Every component of
the display screen is shown in this list and it provides a shortcut to get to any
graphical component.
RTMC Pro
Project Workspace - The middle panel is the display screen workspace. The
graphic components are placed in the workspace, as they should appear on the
final display.
Component Toolbox - The toolbox on the right contains the display screen
components that can be placed in the workspace. Selecting a component and
clicking in the workspace places the component and brings up the Properties
window for that component.
RTMC Pro was designed to be easy and straightforward to use. Experiment
with different combinations and options to get the display results you are
looking for.
3
RTMC Pro
2.1 The RTMC Pro Workspace
2.2 Display Components
As seen in the example screen above, different types of graphical components
can be combined to create an attractive real-time display. Company logos,
maps, or any image stored in a standard graphic file format can be placed on
the screen.
Many images have been included with RTMC Pro. The default directory in
which these files are stored is C:\Campbellsci\Lib\RTMCMediaLib. Custom
images can be used as well; these should be placed in the media library
directory to make them available for RTMC Pro’s use.
The RTMC Pro workspace is a container for holding one or more display
screens. As new display screens are added (Project | Add New Screen) they
appear in the project tree. In RTMC Run-time, each screen will be displayed
as a tab. The size of the workspace and the run-time window can be changed
by selecting Project | Configure WorkSpace. Refer to Project Menu in Section
2.3, Functions Available from the RTMC Pro Menus, for additional
information on sizing options.
NOTE
Display components are the objects that are used to display data. Available
components for each component type can be displayed by clicking the arrow
on each tab in the Component Toolbox. To add a component to the workspace,
click an item on the Component Toolbox and then click anywhere in the
workspace or click and drag to the desired size. The component’s Properties
window is automatically displayed when the object is first placed in the
workspace. The Properties window is used to customize colors, scale values,
text, etc., and to assign the data value to be displayed by the component.
When a display component is linked to a data value, if Use Live
Data is active, the value will be automatically updated on the
display if data is available. (Refer to View Menu in Section 2.3,
Functions Available from the RTMC Pro Menus, for more
information on Use Live Data.)
In LoggerNet, if data collection is not set up for the station, the
values will not update and an exclamation point will appear in
the upper right corner of the component. Data collection can be
set-up through the LoggerNet Setup window or with RTMC’s
Project | Configure Override Scheduled Collection menu item.
Input locations, ports and flags for mixed-array dataloggers are
collected at the scheduled collection interval or any time a
manual collection is done. The Public table must be enabled for
scheduled collection to display these values for table-data
dataloggers.
4
In RTDAQ, if RTDAQ is not connected to the station, the values
will not update and an exclamation point will appear in the upper
right corner of the component.
As changes are made to component properties, they appear on the screen in
real-time. After a component’s properties have been set, select OK to keep the
RTMC Pro
changes and close the Properties window. Once the link to the data value has
been applied, if there is data available from LoggerNet or RTDAQ for the
component, the value on the display will update, if Use Live Data is active.
To make changes in display component settings, the Properties window can be
opened by double-clicking the component or right-clicking the component and
then choosing Properties from the drop-down menu. If you make changes to a
component’s properties but then decide to reject those changes, press the
Cancel button to return the properties to the last applied state. If Cancel is
selected when a component is first placed in the work area (and OK has not
been pressed), the display component will be removed from the screen.
Available Components
The following is an overview of the display components available. The online
help has detailed information about each of the components and their
properties.
All Tabs
Returns the cursor to a normal selection tool.
Alarms Tab
Provides visual and/or audible notification that a
data value has exceeded a defined limit. An
audible alarm can be disabled by right-clicking the
component with your mouse and selecting
Acknowledge Alarm. An alarm can also cause an
email to be sent to a specified email address and/or
a specified file to be opened. All events (audio,
email, run/open) and alarm acknowledgement
occur only when running the project in RTMC
Run-time or CSI Web Server.
Provides visual and/or audible notification that a
data value has exceeded a defined limit. An
audible alarm can be silenced by right-clicking the
component with your mouse and selecting
Acknowledge Alarm. An alarm can also cause an
email to be sent to a specified email address and/or
a specified file to be run or opened. All events
(audio, email, run/open) and alarm
acknowledgement occur only when running the
project in RTMC Run-Time or CSI Web Server.
5
RTMC Pro
Provides visual and/or audible notification that the
rate of change of a data value has exceeded a
defined limit. An audible alarm can be disabled by
right-clicking the component with your mouse and
selecting Acknowledge Alarm. An alarm can
also cause an email to be sent to a specified email
address and/or a specified file to be opened. All
events (audio, email, run/open) and alarm
acknowledgement occur only when running the
project in RTMC Run-time or CSI Web Server.
Provides visual and/or audible notification that no
data has been received from a selected table for a
specified period of time. An audible alarm can be
disabled by right-clicking the component with
your mouse and selecting Acknowledge Alarm.
An alarm can also cause an email to be sent to a
specified email address and/or a specified file to be
opened. All events (audio, email, run/open) and
alarm acknowledgement occur only when running
the project in RTMC Run-time or CSI Web
Server.
Provides visual and/or audible notification when
scheduled collection is disabled in the Setup
Screen, the schedule is paused from the Status
Monitor, or communication has failed a sufficient
number of times to put the datalogger into a
Primary or Secondary Retry mode (the retry mode
used is based on the Condition property for the
component). An audible alarm can be disabled by
right-clicking the component with your mouse and
selecting Acknowledge Alarm. An alarm can
also cause an email to be sent to a specified email
address and/or a specified file to be opened. All
events (audio, email, run/open) and alarm
acknowledgement occur only when running the
project in RTMC Run-time or CSI Web Server.
Note that if RTMC is launched from RTDAQ, a
Comm Status Alarm will only be triggered when
an RTDAQ real-time display is started or stopped.
This is because RTDAQ uses scheduled collection
to temporarily collect areas in order to update the
real-time displays.
6
RTMC Pro
Provides visual and/or audible notification that a
data value has exceeded a defined limit. An
audible alarm can be disabled by right-clicking the
component with your mouse and selecting
Acknowledge Alarm. An alarm can also cause an
email to be sent to a specified email address and/or
a specified file to be opened. All events (audio,
email, run/open) and alarm acknowledgement
occur only when running the project in RTMC
Run-time or CSI Web Server.
Provides visual and/or audible notification of the
state of a data value. Default states include Off,
Warning and Critical. These can be changed and
additional states can be added. An image, sound
file, email, and/or run/open can be defined for each
state. An audible alarm can be disabled by rightclicking the component with your mouse and
selecting Acknowledge Alarm. All events (audio,
email, run/open) and alarm acknowledgement
occur only when running the project in RTMC
Run-time or CSI Web Server.
Commands Tab
Digital Displays Tab
Provides a button that will run/open a specified file
(*.exe, *.bat, *.doc, etc.) when pressed in run-time
mode.
Provides a button that will execute a specified
CoraScript command when pressed in run-time
mode. CoraScript is a set of commands that can
be used to interact with the LoggerNet server. For
more information, see RTMC Pro’s online help.
Provides a hotspot that will jump to a specified
RTMC screen or open a web browser to a
specified web address when clicked in the runtime mode. In RTMC Run-time the hotspot will
be invisible. The only indication of a hotspot will
be the changing of the cursor to a hand (
) when
over the hotspot. A label, button, or other
component can be used to indicate what the
hotspot will do when clicked.
Depicts the selected data value as a numeric value,
text string, or Boolean.
7
RTMC Pro
Gauges Tab
Depending upon the option chosen, displays the
server time, server time at last data collection,
station time, station time of last record stored, PC
time, or a time stored in the data table (such as
time of minimum or maximum).
Depicts the selected data value as a numeric value,
text string or Boolean.
Depending upon the option chosen, displays the
server time, server time at last data collection,
station time, station time of last record stored, PC
time, or a time stored in the data tables (such as
time of maximum or minimum).
Displays the selected data value on a gauge. In
run-time mode, max and min pointers can be reset
by right-clicking the component.
Displays the selected data value on a rotary gauge.
Layout Tab
Provides an eight-point compass on which to
display data.
Displays wind speed and wind direction from a
datalogger table in the form of a windsock.
Displays a static text string that can be used to
label other components.
Allows you to place a static image on the display.
Allows you to place a box on the display in order
to group components together.
Places a panel on the display that can be used to
group components together.
Places a beveled edge on the display that can be
used to bevel the edges of other components.
Allows you to place a circle, ellipse, square,
rectangle, or rounded rectangle on the display.
8
Allows you to place a gradient on the display.
Miscellaneous Tab
Reports Tab
RTMC Pro
Displays a static text string that can be used to
label other components or simply add text to the
project.
Provides a motor that can be depicted as on or off
based on a data value.
Displays a pipe. The flow through the pipe can be
determined by a data value. A pipe is horizontal
by default. To make a vertical pipe, unlock the
aspect ratio and resize it so that it is taller than it is
wide.
Provides a pipe joint that can be used to connect
two pipes.
Provides a valve that can be depicted as opened or
closed based on a data value.
Status Bars Tab
Provides a button bar that allows the user to
customize the date range of their report. It also
provides buttons in run-time to step through data
or jump to a specific date.
Displays the report range. The user can customize
the dates shown and the format used. In run-time
mode, the header updates as the report date range
changes.
Allows the user to insert custom notes at run-time
before the report is exported. Notes are temporary
and are lost when the report is closed.
Provides options for controlling how reports get
exported. Export options include HTML, PDF,
PDF (Image), PNG, JPEG, GIF, and BMP. The
reports can also be setup so they are printed,
emailed, or FTP’d when the report is exported.
The component also allows you to specify which
of the above export options are available in RTMC
Run-time.
Depicts the selected data value as a single vertical
or horizontal bar. In run-time mode, max and min
pointers can be reset by right-clicking the
component.
9
RTMC Pro
Switches Tab
Displays the data value on the image of a
thermometer. In run-time mode, max and min
pointers can be reset by right-clicking the
component.
Displays the data value as the level in a tank.
Indicates the state of a port, flag, input location, or
public variable. A 0 is considered Off (false); any
non-zero number is considered On (True). In runtime mode, right-click a switch to change its state.
The option to change the state of a switch with a
double-click or a single-click can be enabled in the
Properties window.
Indicates the state of a port, flag, input location, or
public variable by the color of an LED. A 0 is
considered Off (false); any non-zero number is
considered On (True). In run-time mode, rightclick a switch to change its state. The option to
change the state of a switch with a double-click or
a single-click can be enabled in the Properties
window.
Indicates the state of a port, flag, input location, or
public variable by the position of a lever. A 0 is
considered Off (false); any non-zero number is
considered On (True). In run-time mode, rightclick a switch to change its state. The option to
change the state of a switch with a double-click or
a single-click can be enabled in the Properties
window.
Indicates the state of a port, flag, input location, or
public variable by the position of a rocker. A 0 is
considered Off (false); any non-zero number is
considered On (True). In run-time mode, rightclick a switch to change its state. The option to
change the state of a switch with a double-click or
a single-click can be enabled in the Properties
window.
Indicates the state of a port, flag, input location, or
public variable by the position of a rotary dial.
The default switch has two positions. A 0 is
considered Off (false); any non-zero number is
considered On (True). Other positions can be
added. In run-time mode, click on a position to
change to that state.
10
Trends Tab
RTMC Pro
Indicates the state of a port, flag, input location, or
public variable by the position of a horizontal or
vertical bar. The default switch has two positions.
A 0 is considered Off (false); any non-zero number
is considered On (True). Other positions can be
added. In run-time mode, click on a position to
change to that state.
Indicates the state of a port, flag, input location, or
public variable by displaying an option from a list
designated by the user. The default drop list has
two options. A 0 is considered Off (false); -1 is
considered On (True). Other options can be added.
In run-time mode, click on the component to
display the list of options and change the value of
the variable.
Displays one or more time domain series on a
chart. The time stamp on the X axis reflects the
data timestamp. In run-time mode, it is possible to
zoom in by clicking and dragging a box around the
desired zoom area. Also, in run-time mode, rightclicking the chart will bring up a menu that allows
the chart to be printed, copied, or exported.
Displays one or more XY series on a chart. The
user specifies what will be used for both the X axis
data values and the Y axis data values. Each X
axis data value is plotted against the Y axis data
value with an identical timestamp. In run-time
mode, it is possible to zoom in by clicking and
dragging a box around the desired zoom area.
Also, in run-time mode, right-clicking the chart
will bring up a menu that allows the chart to be
printed, copied, or exported.
Displays one or more series on a chart. The time
stamp on the X axis reflects the data timestamp.
The Scope is similar to the Time Series Chart, but
has the appearance of an oscilloscope screen and
has the ability to display data at a faster rate. In
run-time mode, right-clicking the Scope will bring
up a menu that allows the Scope to be printed,
copied, or exported.
11
RTMC Pro
Displays Rainflow data on a chart. In run-time
mode, a portion of the chart can be “zoomed in
on” by dragging a frame around the area to be
viewed. Right-clicking the chart will bring up a
menu that allows the chart to be printed, copied,
saved, or zoomed to all data. If the Allow Runtime Customization check box is selected in
RTMC Pro, this menu will also include a
Customize item that allows the Run-time user to
change any of the Rainflow Chart’s properties.
Note: RTMC Pro does not create rainflow data
from time series information. It only displays
rainflow data. Rainflow data is created by using
the CRBasic Rainflow or RainflowSample
instruction in a CRBasic program Data Table.
Displays the data from a datalogger table in a row
and column format. In run-time mode, rightclicking the table will bring up a menu that allows
the table to be printed, copied, or exported.
Displays wind speed and wind direction from a
datalogger table in the form of a wind rose.
Value Setters Tab
Depicts the selected data value as a single
horizontal or vertical bar. In run-time mode, the
data value can also be set to a new value by
dragging the slider.
Like the Digital component, depicts the selected
data value as a numeric value, text string, or
Boolean. However, in run-time mode, a data value
can also be set to a new value by double-clicking
the component and entering a new value in the
resulting dialog box.
In run-time mode, reads a value in a datalogger
and writes to another value in that datalogger or a
different datalogger. The value that is written can
be the value read, a 0 or -1, or a specified constant.
Note that in RTDAQ, RTMC projects are limited
to a single station. Therefore, the value read can
only be forwarded to another value in the same
datalogger.
Depicts the selected data value as a pointer on a
dial. In run-time mode, the data value can also be
set to a new value by dragging the pointer.
12
RTMC Pro
NOTE
A description of each field in a component’s Properties box can
be displayed by pressing F1 or clicking the help button (?) in the
top right-hand corner of the dialog box.
2.3 Functions Available from the RTMC Pro Menus
All of the RTMC Pro operations are available from the menus at the top of the
RTMC Pro window. Many of the options are also available as buttons on the
toolbar, or by right clicking the components or other parts of the window or
project tree.
File Menu
New Project starts a new RTMC Pro project. The currently opened project
will be closed. If there are changes that have not been saved, the user will be
prompted to save changes.
Open brings up the File Open dialog to open a previously saved project.
Save will save the changes in the current project to the RTMC Pro project file.
If this is the first time the project has been saved, a Save As dialog will open to
select the file name and directory for the project file.
Save As brings up the Save As dialog to save the current project with another
name or in a different directory.
NOTE
Run Project displays the current project in a run-time window.
Save and Run Project saves the changes in the current project and displays it
in the run-time window.
This option is not available when RTMC Pro is run from inside
RTDAQ.
Publish to Web opens the Web Publisher which allows you to publish your
project to the web. See Section 4, CSI Web Server, for more information.
Exit closes RTMC Pro. If there are unsaved changes, the user will be
prompted to save changes before exiting.
Edit Menu
Cut/Copy/Paste are standard editing operations to add selected objects to the
Windows clipboard and paste them into RTMC Pro or other applications.
Undo cancels the last change made to the project.
Redo repeats the change that was just undone.
Find and Replace allows you to find all occurrences of a designated string and
replace them with a different string. Some instances where this may be useful
are if a datalogger name in your network map has changed or a variable name
in the datalogger program has changed. The user determines if the find and
13
RTMC Pro
replace applies to the entire project, only the current screen, or only the current
component.
Select All selects all of the components in the workspace. The components can
then be cut, copied, deleted, etc.
Clear Selection clears the selection of components currently highlighted on the
active screen.
The Preferences menu item is used to change some global settings that affect
all projects in RTMC Pro. The Visual Theme determines the look and feel of
the application (i.e., colors, button appearance, etc.). The Working Directory is
the directory in which to store RTMC Pro project files. By default, this is
C:\Campbellsci\RTMC. Press the Change Default Font button to set a new
font for components that have text (numeric value text, chart titles and axes
labels, etc.).
Component summaries (“tooltips”) are small boxes that are displayed on the
screen beside a component when your mouse cursor hovers over the
component for a few seconds. The box displays information on the type of
component, the data value linked to the component, images used, series
plotted, etc. Select the Show Component Summaries box to display these hint
boxes or clear the box to turn off the display of the information.
The Grid Options settings allow you to turn on or disable the display of a grid
in the project workspace and lets you set the size of the grid.
With the Graphics Options settings, you can control the maximum number of
times the RTMC screens will be updated per second, disable animation when a
data value changes, and specify whether high quality or high speed is more
important. (Disabling animation disables the smooth transition between values
on gauges, status bars, etc. When a data value changes, the component will
jump to the new value. This greatly enhances performance when dealing with
fast data or large, complex projects.)
The Customize menu item brings up a dialog box which allows you to
customize RTMC Pro’s toolbars and menus.
View Menu
All of the View menu items are toggles. When a check mark appears to the left
of the menu item, it is enabled. When the check mark is absent, the option is
disabled. These options are toggles—if an option is off (unchecked), select it
once to turn it on (checked) and vice versa.
Full Screen Mode
When selected, the RTMC workspace expands to fill the entire computer
screen. This provides more space to work with in designing your project. In
this mode, you must use the right-click menus to add components and perform
other functions available from RTMC’s toolbar. Press the Esc key to exit this
mode.
14
RTMC Pro
Use Live Data
LoggerNet – When selected, RTMC Pro uses the data that has been collected
by LoggerNet and stored in LoggerNet’s data cache. Therefore, if LoggerNet is
running and data is being actively collected from the datalogger network, the
values displayed by the components will be updated as data is collected.
However, run-time events (audio, email, run/open, alarm acknowledgement,
switch state changing, value changing, value forwarder, etc.) will not be active.
When Use Live Data is not selected, RTMC Pro does not use the data stored in
LoggerNet’s data cache. Therefore, the values displayed by the components
will not be updated until RTMC-RT is launched.
RTDAQ – When selected, RTMC Pro performs a manual poll to update the
project data every second if RTDAQ is connected to the datalogger. Therefore,
if RTDAQ is connected to the datalogger, the values displayed by the
components will be updated every second. However, run-time events (audio,
email, run/open, alarm acknowledgement, switch state changing, value
changing, value forwarder, etc.) will not be active. When Use Live Data is not
selected, RTMC Pro does not perform manual polls to update project data.
Therefore, the values displayed by the components will not be updated until
RTMC-RT is launched.
This menu item can also be toggled off or on by selecting an icon on the tool
bar. The icon has a different appearance, depending on whether or not Use
Live Data is currently off or on. When Use Live Data is off, the icon will
appear as
. When Use Live Data icon is on, the icon will appear as .
Show Project Tree hides or displays the Project Tree (left pane of the default
window).
Show Toolbox hides or displays the Component Toolbox.
Show Layout Toolbar hides or displays the Layout Toolbar.
Show Tabs hides or displays the tabs at the top of the RTMC workspace which
allow the user to switch between screens. When tabs are not shown, you can
switch between screens by selecting a screen from the Project Tree. (Note this
menu item is disabled for projects with only one screen.)
Show Standard Toolbar hides or displays the Standard Toolbar.
Show Status Bar hides or displays the Status bar at the bottom of the screen.
The Status Bar provides hints on objects, window size, and the server
connection.
Show Grid hides or displays a grid background for the workspace.
Project Menu
Project Menu options work with the whole project or workspace.
Configure Workspace allows you to specify the size of both the development
workspace and the RTMC Run-time screen. For Development, the size of the
RTMC Pro workspace is set by choosing a size from the drop-down list. If you
choose custom, you will be asked to specify the width and height in
15
RTMC Pro
millimeters, inches, or pixels. For Run-time, when Auto Size is selected, the
size of an RTMC display is set automatically by dragging the boundaries of the
screen to a new size. The components will resize to match the new screen size.
The aspect ratio of the components will be maintained only if Lock Aspect
Ratio is selected. When Fixed Size is selected, the screen size is fixed. It is
determined by the size set in the development mode.
Manage Data Sources opens a dialog box which allows you to manage the
data sources for your RTMC project. See Section 2.5, Managing Data
Sources, for additional information.
Configure Alarm Log opens a dialog box that allows an alarm log to be
configured for all alarms that are generated. Options include enabling alarm
logging, log directory, base file name, number of alarm log files kept, size or
time interval of alarm log files, and whether a text entry is required for alarm
acknowledgement. The text entry will be included in the log file. It can be
used to log information about who acknowledged the alarm and other
comments. The alarm log will be an XML document. See Alarm Log
Structure in the online help file for more information about the XML structure
of the alarm log.
Configure Auto Tabbing lets you enable or disable the automatic switching
between project tabs when an RTMC form is run, and set the rate at which a
new tab will be displayed. When RTMC is in AutoTab mode, it will display a
tab for a set amount of time and then display the next tab. If a screen is
interacted with or a different tab is selected, auto tabbing stops and a button
appears by the menu,
, that can be clicked to resume tabbing.
Configure Snapshot & FTP opens a dialog box that allows the configuration
of a snapshot of the current RTMC Pro state. A snapshot is a *.png file of the
current state. It can be configured to include selected screens or only selected
components. For a snapshot of selected screens, a file will be saved for each
screen with a filename of screenname.png. For a snapshot of only select
components, a file will be saved for each component with a filename of
componentname.png. A snapshot will be saved in Run-time to the designated
directory at the specified interval. It can also be transferred to a designated
FTP server on the same interval. Only the most current snapshot will be kept.
It will be overwritten each time a new snapshot is saved.
Configure Override Scheduled Collection opens a dialog box that allows the
collection interval to be specified. In LoggerNet, this data collection will be in
addition to the scheduled collection specified in LoggerNet’s Setup window. In
RTDAQ, this will override RTDAQ’s automatic one second polling to update
the project data.
Configure Email Profiles opens a dialog box that allows you to configure
email profiles that allow you to easily use the same SMTP Server, Username,
Password, From, To, Cc and Bcc fields for multiple alarms and/or Report
Export components.
16
RTMC Pro
Load as Template enables you to easily use the same project for multiple
stations. When a project designated as “Load as Template” is loaded in RTMCRT, the following dialog box will appear:
The Template Station drop-down list will contain all of the stations used in
your template project. After selecting a station from the drop-down list, you
can open the Data Source Browser by pressing the button to the right of the
Replace with field. From the Data Source Browser, you can select a station to
replace the template station. Each reference to the template station in the
project will be replaced by the designated station.
Add New Screen adds a new screen to the project. Each screen appears in the
project tree. In run-time mode, each screen appears as a tabbed page on the
display. When the project is run the user can click the tab to bring each screen
to the front.
Change Screen Order allows you to change the order that the screens will
appear. In development mode, this is the project tree order. In run-time mode,
it is the order of tabs, left to right.
Screen Menu
Screen Menu options work with the tabbed screens in the project. The Screen
Menu is also available by right clicking any blank area of the workspace.
Screen Properties brings up the dialog to choose the background image and
color for the current screen.
Delete Screen removes the current screen from the project. If there are
components on the screen, they will also be removed.
Rename Screen brings up a dialog to change the name of the current screen.
This is the name that appears on the screen tab in run-time mode.
Duplicate Screen duplicates the current screen and all of its components on a
new screen.
Paste is a standard editing operation to paste an object from the Windows
clipboard into RTMC Pro.
Insert New brings up a submenu allowing you select one of the components to
insert on the screen. When the component is added to the screen the Properties
window for the new component will come up.
17
Loading...