MultiLogger

Software
USER’S GUIDE
Version 5.5

Disclaimer: The following document is provided to assist users with the installation, operation
and training in the use of our products. This document and our products are intended to be used
by technically qualified personnel. Contained herein is information that is proprietary to Canary
Systems and may not be reproduced or copied in any form, nor disclosed to outside parties by
any means whether directly or indirectly, without the written consent of Canary Systems. This
document is subject to change without notice and Canary Systems assumes no responsibility for
errors, omissions or misinterpretation. Furthermore Canary Systems makes no warranty as to the
suitability of this information and/or products for any given application or use.

Copyright1997-2013 Canary Systems, Inc. All Rights Reserved.

multilogger_usersguide_55.doc Doc Rev 11-13

5 Gould Road, PO Box 2155

New London, NH 03257 USA
Voice: (603) 526-9800
e-mail: support@canarysystems.com
web: www.canarysystems.com
Table of Contents
Section 1 Introduction 3
1.1 MultiLogger Features ......................................................................................................................................... 4
1.2 What‘s New in MultiLogger Version 5 ................................................................................................................ 5
1.2 System Requirements........................................................................................................................................ 5
1.3 Technical Support .............................................................................................................................................. 5

Section 2 Getting Started............................................................................................................................................................ 6

2.1 Network Manager ............................................................................................................................................... 6
2.1.1 Network Manager Menus ............................................................................................................. 7
2.1.2 Network Manager Toolbar............................................................................................................ 8
2.2 Network Configuration Example ........................................................................................................................ 9
2.3 Logger Form....................................................................................................................................................... 15
2.3.1 Logger Form Menus ..................................................................................................................... 16
2.3.2 Logger Form Toolbar ................................................................................................................... 18
2.3.3 Logger Form Tab Control ............................................................................................................. 21

Section 3 Network Configuration ................................................................................................................................................ 22

3.1 Node Types ........................................................................................................................................................ 22
3.1.1 Gateways ..................................................................................................................................... 23
3.1.2 Communication Ports ................................................................................................................... 28
3.1.3 Communication Devices .............................................................................................................. 31
3.1.4 Dataloggers .................................................................................................................................. 34
3.1.5 Tasks ............................................................................................................................................ 36
3.2 Data Collection ................................................................................................................................................... 37
3.3 Data Collection Status ....................................................................................................................................... 40

Section 4 Logger Configuration .................................................................................................................................................. 42

4.1 Project Tab ......................................................................................................................................................... 43
4.1.1 Configuration File ......................................................................................................................... 43
4.1.2 Project Path .................................................................................................................................. 44
4.1.3 Description ................................................................................................................................... 44
4.1.4 Download File............................................................................................................................... 44
4.1.5 Datalogger Model ......................................................................................................................... 45
4.1.6 Last Updated ................................................................................................................................ 45
4.1.7 Datalogger ID ............................................................................................................................... 45
4.2 Program Tab ...................................................................................................................................................... 46
4.2.1 Data Output .................................................................................................................................. 47
4.2.2 Alarm Action ................................................................................................................................. 47
4.2.3 Output Device............................................................................................................................... 47
4.2.4 Interval Type................................................................................................................................. 48
4.2.5 Read Times .................................................................................................................................. 48
4.2.6 Start and Stop Time ..................................................................................................................... 48
4.2.7 Logarithmic Intervals .................................................................................................................... 48
4.3 Configure Direct Connect Channels .................................................................................................................. 49
4.3.1 Channel ........................................................................................................................................ 50
4.3.2 Identification ................................................................................................................................. 50
4.3.3 Measurement ............................................................................................................................... 50
4.3.4 Conversion Method ...................................................................................................................... 51
4.3.5 Linear Coefficients........................................................................................................................ 51
4.3.6 Polynomial Coefficients ................................................................................................................ 51
4.3.7 Units Conversion .......................................................................................................................... 52
4.3.8 Temperature Correction ............................................................................................................... 52
4.3.9 Processing File ............................................................................................................................. 52
4.3.10 Check Alarms ............................................................................................................................. 54
4.3.11 Channel B ................................................................................................................................... 55
4.3.12 Upper Channel ........................................................................................................................... 56
4.3.13 Upper Channel Identification ...................................................................................................... 57
4.3.14 Upper Channel Measurement .................................................................................................... 57
4.4. Configure Multiplexers ...................................................................................................................................... 58
4.4.1 Multiplexer Model ......................................................................................................................... 58
4.4.2 Multiplexer Gage Type ................................................................................................................. 58
4.4.3 Channel Configuration ................................................................................................................. 58
4.4.4 Multiplexer Channels .................................................................................................................... 59
4.4.5 Multiplexer Wires .......................................................................................................................... 59
4.4.7 Multiplexer Enable ........................................................................................................................ 59
4.4.8 Multiplexer Clock .......................................................................................................................... 59
4.5 Configure Input Locations .................................................................................................................................. 60
4.6 Program Information .......................................................................................................................................... 61
4.6.1 Program Instructions .................................................................................................................... 61
4.6.2 Program Bytes.............................................................................................................................. 61
4.6.3 Final Storage Locations ............................................................................................................... 61
4.6.4 Overwrite in Hours........................................................................................................................ 62
4.6.5 Input Storage Assignments .......................................................................................................... 62
4.6.6 Final Storage Assignments .......................................................................................................... 62
 Table of Contents (continued)

Section 5 Logger Monitoring ....................................................................................................................................................... 63

5.1 Configure Text Monitor ...................................................................................................................................... 63
5.2 Text Monitor Tab ................................................................................................................................................ 64
5.2.1 Monitor Status Panel .................................................................................................................... 64
5.2.2 Logger Flags ................................................................................................................................ 65
5.2.3 Logger Ports ................................................................................................................................. 65
5.2.4 Monitor Clocks.............................................................................................................................. 65
5.2.5 Set Clock ...................................................................................................................................... 65
5.2.6 Reset Errors ................................................................................................................................. 65
5.2.7 Cancel Monitor ............................................................................................................................. 65
5.2.8 Logger Status ............................................................................................................................... 66
5.2.9 MS Excel Link............................................................................................................................... 67
5.2.10 Capture Status ........................................................................................................................... 67
5.2.11 Auto Configure Locations ........................................................................................................... 67
5.2.12 Monitor Errors............................................................................................................................. 67
5.2.13 Monitor Label.............................................................................................................................. 67
5.3 Configure Graphical Monitor .............................................................................................................................. 68
5.3.1 Chart Type .................................................................................................................................... 69
5.3.2 X Data........................................................................................................................................... 69
5.3.3 X as Label .................................................................................................................................... 69
5.3.4 Y1 Locations................................................................................................................................. 69
5.3.5 Y2 Locations................................................................................................................................. 69
5.4 Graphical Monitor Tab ....................................................................................................................................... 70
5.4.1 Graphical Monitor Toolbar............................................................................................................ 70
5.5 Configure Capture Intervals ............................................................................................................................... 76
5.5.1 Data File ....................................................................................................................................... 76
5.5.2 Include Date/Time Information ..................................................................................................... 77
5.5.3 Capture Method............................................................................................................................ 77
5.5.4 Capture Intervals .......................................................................................................................... 77
5.6 Terminal Tab ...................................................................................................................................................... 78
5.7 Configure Terminal Font .................................................................................................................................... 78
5.8 Configure MS Excel Link.................................................................................................................................... 79
5.9 Configure Notification System ........................................................................................................................... 80
5.9.1 Notification Method ..................................................................................................................... 80
5.9.2 Message Format .......................................................................................................................... 81
5.9.3 Data Arrays Format ...................................................................................................................... 81
5.9.4 Notify Actions ............................................................................................................................... 81
5.10 Configure Preferences ..................................................................................................................................... 82
5.10.1 General ....................................................................................................................................... 82
5.10.2 Text Monitor ............................................................................................................................... 83
5.10.3 Graphical Monitor ....................................................................................................................... 84

Section 6 Logger Node Types .................................................................................................................................................... 85

6.1 Campbell CR10/CR21X/CR7X/CR10X/CR500/CR23X/CR510 ........................................................................ 85
6.2 Campbell CR2xx ................................................................................................................................................ 90
6.3 Campbell CR800/CR1000 ................................................................................................................................. 91
6.4 Sisgeo ADR-2VWT ............................................................................................................................................ 92
6.5 Kinemetrics K2 ................................................................................................................................................... 93
6.6 RefTek 130 Recorder ......................................................................................................................................... 97
6.7 Syscom MR2002 ................................................................................................................................................ 101
6.8 Virtual Datalogger .............................................................................................................................................. 105

Section 7 Roobrik ............................................................................................................................................................... 106

Section 8 MultiLogger Setup....................................................................................................................................................... 107

8.1 MultiLogger Editor (MLEditor) ............................................................................................................................ 107
8.1.1 Text File Mode.............................................................................................................................. 108
8.1.2 Instruction File Mode .................................................................................................................... 108
8.1.3 Download File Mode .................................................................................................................... 109
8.2 MultiLogger Setup (MLSetup) ............................................................................................................................ 110

Appendix A – Tables
A.1 Julian Day .......................................................................................................................................................... 111
A.2 ASCII Characters ............................................................................................................................................... 112

Appendix B – Advanced Topics

B.1 MultiLogger Gateway (MLGateway) .................................................................................................................. 113
B.2 MultiLogger Server (MLServer) ......................................................................................................................... 121
B.3 Configuring Generic Modems ............................................................................................................................ 122
B.4 Configuration Mode ........................................................................................................................................... 123
B.5 Call-Back ........................................................................................................................................................... 124
B.6 Logging Functions ............................................................................................................................................. 125
 Section 1- Introduction

Section 1 – Introduction
MultiLogger is a Windows client application for MLGateway. It provides for configuring the programming
and data collection automation of MLGateway. It has been designed to make the job of configuring and
acquiring data from numerous types of data acquisition equipment faster, easier, and simpler. It is
compatible with Windows 95/98/ME/NT/2000/XP/2003/Vista/7/8 and supports a number of data collection
devices such as the Campbell Scientific CR500, CR510, CR10, CR10X, CR21X, CR23X, CR7, CR2xx,
CR800/850 and CR1000, Geokon LC-1 and 8500/8510, and Kinemetrics K2. For more information on the
control modules see the Operator‘s Manual for the respective unit.

MultiLogger performs the following basic functions:

Configuration of data acquisition equipment networks.
Program generation automation with user defined form options.
Automation of program download and various logger operational modes.
Logger monitoring modes including text and graphical types.
Data collection automation configuration and monitoring.

MultiLogger is highly integrated with the other MultiLogger Suite applications and serves as a client
application of MLGateway and MLServer. Communication between the various software components of
MultiLogger Suite is depicted in the illustration below. Communications between MultiLogger, MLGateway
and MLServer are implemented using a highly reliable custom designed TCP based transport system.

MLGateway and MLServer installation and configuration information is found in Appendix B.1 and B.2

Note: MultiLogger is a client application for MLGateway and hence does not need to be running to
provide for data collection automation and monitoring.

See the MultiLogger Suite Installation Guide for direction with installing MultiLogger.

MultiLogger Software User’s Guide 3

 Section 1 – Introduction

1.1 MultiLogger Features

Networking Features
 Client/server operation using MLGateway software.
 Multi-user network support using MLGateway.
 Automated data collection can operate as Application or Service model.
 Multiple users can easily share network and datalogger configurations.

Program Options
 Datalogger ID to help identify data files.
 Three basic measurement intervals including single interval, read times and logarithmic.
 Up to 8 different logarithmic intervals are supported as well as 8 read times.
 Single interval with a range of 1 to 604,800 (once per week) seconds.
 User defined Start and Stop times.
 Configurable alarm action including control port activation and voice calls.
 Up to (16) direct connect instruments can be specified.
 Up to (10) 8, 16, 32, or 48 channel multiplexers can be used.
 Each multiplexer channel can be configured by instrument type, conversion factors and units,
temperature measurement and correction and alarm limits.
 Numerous program options including Gage Types, Units Conversion, Upper Channel devices,
Check Alarms types, Output Data, Alarm Action and Output Device are user configurable.

Communication System
 Native support for TAPI devices (phone modems) and TCP/IP Socket devices.
 Complete automation of data collection functions, including database update.
 Security code can be used to prevent unauthorized program modifications and data collection.
 Maximum connect time can be used to prevent extended long distance connection.
 Many communication peripherals are supported.
 Data collection can be specified as since last collection, all data or number of arrays.
 Data file formats including comma, space or tab delineated ASCII.
 Up to 1000 Input Storage locations can be monitored via the text based monitor.
 Up to 128 Input Storage locations can be monitored via 4 charts on the graphical monitor.
 Graphical monitor charts may be saved, loaded, printed and extensively configured.

Data Reduction
 Roobrik, a powerful data processing tool is supplied with MultiLogger.
 Data selector that allows you to select data based on start/stop/copy criteria.
 Additional elements may be calculated using a powerful formula editor.
 Data may be used to create a report, chart or OLE/DDE copied directly into Microsoft Excel.
 Operation of Roobrik can be completely automated using its command line feature.

Help System
 Context sensitive help available for most software options.

MLEditor Accessory Software

 Create/modify instruction or download files.

MLSetup Accessory Software

 Easily modify the options and functionality of MultiLogger.

4 MultiLogger Software User’s Guide

 Section 1- Introduction

1.2 What‘s New in MultiLogger Version 5

MultiLogger version 5 includes a number of enhancements such as:

 Complete re-architecting to support true client/server deployment with MLGateway acting as the
server and MultiLogger acting as a client.
 Improved support for multiple MLGateway clients.
 Improved logging and monitoring functions.
 Data collection settings can now be customized for each node.
 Improved communications reliability and improved message logging.
 Monitoring and configuration of data import automation.
 New VirtualDL for measurement automation using devices connected directly to the computer.
 Improved functionality for creation and management of Gateway Folders.
 Data collection from all Campbell CR800 and CR1000 tables now supported.
 Configuration of multiple nodes for After Call-Back Do.
 Ability to make multiple changes to Network Configuration and Save/Cancel in single step.

Please review our FAQ #28 found in our support directory at http://www.canarysystems.com/nsupport/ for
a more detailed list of enhancements.

1.3 System Requirements

MultiLogger is designed to run on Microsoft Windows 95/98/ME/NT/2000/XP/2003/Vista/7 operating

systems.

Minimum screen resolution should be 800x600, 1024x768 or higher is best.

Recommended system resources:

Memory: 1 GB
Hard Disk: 80 MB

Recommended Operating System is Microsoft Windows 7 Professional.

1.4 Technical Support

Check the About box in MultiLogger for contact information.

Canary Systems may be contacted directly via phone, fax or e-mail. Unlimited support via phone and
email is provided for 30 days after installation. Ongoing support via phone, email and Webex is available
for a nominal annual fee.

Phone: (603) 526-9800

e-mail: support@canarysystems.com

NOTE: The latest versions of the software components are available without charge from the
support area of www.canarysystems.com. Older versions may be subject to upgrade fees. Contact
your software vendor or Canary Systems directly for more information.

Our website also provides numerous Application Notes and all the latest User‘s Guides. Press the
Support button at www.canarysystems.com to access these resources.

MultiLogger Software User’s Guide 5

 Section 2 – Getting Started

Section 2 – Getting Started

Note: To get started MLGateway must be activated on the workstation or server that the
MultiLogger client software will be connecting to. See Appendix B.1 for complete information on
MLGateway activation. DO NOT PROCEED UNTIL ACTIVATION IS COMPLETED.

2.1 Network Manager

Once the installation is complete and activation has been completed, the software can be started by
clicking Start | MultiLogger or Start | Programs | MultiLogger then double-click the MultiLogger icon.

A view typical of an empty Network Configuration shown after installation is depicted below. This is the
Network Manager view.
Menu Toolbar

Hints Network Configuration Node Configuration Panel

The menu and toolbar at the top of the form provide access to commonly used functions.

6 MultiLogger Software User’s Guide

 Section 2 – Getting Started

2.1.1 Network Manager Menus

The menus at the top of the Network Manager form provide

access to commonly used functions of MultiLogger. Press the
<ALT> key to show the hot-keys for the menu, and for the
submenus.
The File menu, shown at right, provides access to various
configuration options and status and logging forms.
Gateway List Configuration – Provides for creating a default
Gateway List, creating a new Gateway List, selecting a Gateway
List previously created or obtaining the Gateway List from
MLServer. Gateway Lists are lists of gateways including path
information for locating the Gateway Folder on the computer.
Configuration Mode – Will be checked (default) to indicate the
Network Manager is currently in configuration or edit mode, or unchecked indicating the Network
Manager is in read-only mode. To enter Configuration Mode if unchecked select the menu option and
enter the password. The default Configuration Mode password is multilogger. See Appendix B.4 for
more information on Configuration Mode.
Change Configuration Mode Password – Select to change the Configuration Mode password. See
Appendix B.4 for more information.
MLGateway License – Display the current MLGateway licensing status. See Appendix B.1 for complete
information on MLGateway.
Deactivate MLGateway – Deactivate the MLGateway licensing status. See Appendix B.1 for complete
information on MLGateway.
DB Import Configuration – Displays the DB Import Configuration form of MLServer. DB Import
functionality provides for integrating other data sources including files and other data servers. See
Appendix B.1 for more information on MLServer and see the MLDBConsole User‘s Guide for complete
information on MLServer.
DB Import Status – Displays the status of the current DB Import configuration. See the MLDBConsole
User‘s Guide for information on this form.
Show MultiLogger Log File – Show the MultiLogger.log file which details events and status messages
related to the various operations of MultiLogger. See Appendix B.6 for more information on the log files.
Show Gateway Log File – Show the MLGateway.log file which details events and status messages
related to the various operations of MLGateway. The log file for the currently selected Gateway will be
retrieved and shown. See Appendix B.6 for more information on the MLGateway log file.
Exit – Close MultiLogger. MLGateway will continue to run in the background as an
Application or Service.
The Function menu is duplicated with the buttons on the toolbar at the top of the
Network Configuration, see the following section for more information.

The Help menu provides access to the Help Contents section of the MultiLogger
help file. Select About to display the MultiLogger About form with version running
and support information.

MultiLogger Software User’s Guide 7

 Section 2 – Getting Started

2.1.2 Network Manager Toolbar

These functions are also duplicated in the Function menu at the top of the form.

Add – Add Gateways, Tasks, Communication Ports, Communication Devices or Dataloggers.

Delete – Delete the selected Gateway, Task, Communication Port, Communication Device or Datalogger.
Save – Save the current Network Configuration.
Hint: The Save button will be disabled unless there are changes to be saved.
Cancel – Cancel the changes that have been made to the Network Configuration.
Hint: The Cancel button will be disabled unless there are changes that can be canceled.
Logger – Invoke the Logger form for the datalogger currently selected in the Network Configuration. Left
double-click of a datalogger will also invoke the Logger form. The Logger form is the primary interface for
configuring, updating, and monitoring dataloggers.
Hint: The Logger button will be disabled unless a datalogger is selected in the Network Configuration.
Roobrik – Invoke Roobrik to perform data reduction and generate reports, charts and spreadsheets. See
the Roobrik User‘s Guide for information on this software.
MLDBConsole – Invoke the MLDBConsole database management software. See the MLDBConsole
User‘s Guide for information on this software.
Insite – Invoke the Insite database client software. See the Insite User‘s Guide for information on this
software.
Help – Display the Help Contents section of the MultiLogger help file.

8 MultiLogger Software User’s Guide

 Section 2 – Getting Started

2.2 Network Configuration Example

Hint: This section will provide an example exercise getting started with MultiLogger to create a basic
network configuration to access a Campbell CR800 through a direct serial connection.

When starting MultiLogger for the first time,

the Gateway List must be configured.

The Gateway List form will display.

Gateway Lists are lists of gateways, or

collections of data acquisition gear that are
being managed by MLGateway.

Gateways may be Local or Remote. A Local

Gateway means the local computer which is
running MLGateway. This is the most
common configuration.

A Remote Gateway means a remote

computer, either accessible on the same
network as the computer running MultiLogger
or via Internet connection.

Select Create default Gateway List file to get started.

The MultiLogger
Network Manager view
will update with the
default Gateway List. It
will be blank because
no configuration has
been defined yet.

Press the Add button

to get started with
configuring the
Network.

The Add new

Gateway or Device
form will display. All
Networks must start
with a Gateway. Press
Accept with Gateway
selected.

MultiLogger Software User’s Guide 9

 Section 2 – Getting Started

The Network
Configuration will
update with a default
Gateway.

Before additional
nodes can be added
to the Gateway the
Configuration Mode
must be activated.

Use the menu option

File | Configuration
Mode to display the
Configuration Mode
password prompt.

10 MultiLogger Software User’s Guide

 Section 2 – Getting Started

By default it is required to enter the password for all new

Gateways.

The default Configuration Mode password is multilogger.

Check Remember Password to avoid having to enter the

Configuration Mode each time MultiLogger is launched.

Press OK to enter Configuration Mode.

You are now

ready to add
communication
devices and
datalogger
nodes.

Select the
default
Gateway1 and
click the Add
button, the Add
new Gateway
or Device form
will display.

Five items will display in the Add new Gateway or Device form. Gateway is a top-level node, the
remaining items are added to the currently selected Gateway.

Following is a brief glossary of terminology:

Gateway – A Gateway is a computer used to access the data acquisition equipment.
Task – Programs or batch files to run in conjunction with automated data collection.
COM – A serial port on the Gateway computer used to provide access to the data acquisition equipment.
TCP/IP Socket – A TCP/IP connection on the Gateway computer used to provide access to the data
acquisition equipment.
Phone Modem – A Phone Modem installed on the Gateway computer used to provide access to the data
acquisition equipment.

Hint: See Section 3 for complete information on the Network Configuration node types.

For our example select COM and press Accept.

MultiLogger Software User’s Guide 11

 Section 2 – Getting Started

The Network Configuration will update with the COM port added to the Gateway.

Note the Com Port drop-down on the configuration panel to the right.

Configure the appropriate Com Port to match the port or adaptor used for accessing the data acquisition
equipment.

Note: The list of available ports is derived from

the configuration of the computer. If the ports list
is incorrect or otherwise it‘s not clear which port
to select then use Control Panel | Device
Manager to view current adaptors and Com port
assignments.

It will show available ports for the computer and

the port assignment.

Consult the system documentation or installation

instructions for your adaptor if the port does not
show in the list.

12 MultiLogger Software User’s Guide

 Section 2 – Getting Started

Next, add the data acquisition device, in this case the Campbell CR800. Press the Add button to display
the Add new Gateway or Device form. Note that devices are organized by type, to add the CR800 use
the button to expand the Campbell Current Loggers group and select CR800.

After pressing Accept a prompt will

immediately display to Select Logger
Configuration File, this allows browsing to an
existing configuration file for the node, or to
assign a default configuration file.

Configuration files store the configuration of

the data acquisition equipment, e.g. channel
configuration, interval, alarm actions, etc.

Select the appropriate option and click Accept,

the Network Configuration will display.

Hint: When creating data acquisition nodes a default folder will be created in the [Shared
Docs]\MLGateway\Default (since this is the default Gateway) to be used for

Note: When using the Assign a new Configuration File option you’ll have opportunity to rename
the default folder name.

MultiLogger Software User’s Guide 13

 Section 2 – Getting Started

For example, the option Assign a new Configuration File was selected. The Network Configuration
updated to show the new node, however the default CR800 nodename was changed to MyCR800.

Note the default Project Path was also updated once the nodename was changed.

The Configuration File hasn‘t been created yet, the Logger form needs to be used to create the
Configuration File, as the message at the bottom of the configuration panel indicates.

Press Save to save the changes made.

Hint: MultiLogger version 5 differs from previous versions in that multiple changes to the Network
Configuration can be made requiring only a single press of the Save button.

To create the configuration file for the new CR800 node, double-click it or use the Logger button at the
top of the form.

This invokes the Logger form, see the following section.

14 MultiLogger Software User’s Guide

 Section 2 – Getting Started

2.3 Logger Form

The Logger form is used for configuring and monitoring the data acquisition gear, in this case a Campbell
CR800. It consists of several controls and interfaces for the various functions.

Menus Toolbar Monitor Status Animation

Tabbed Logger Function Control

Additional information on the Logger form components will follow, more detailed information follows in
sections 4 and 5.

MultiLogger Software User’s Guide 15

 Section 2 – Getting Started

2.3.1 Logger Form Menus

The pull-down menus provide access to basic file operations, additional program configuration forms, the
functions depicted on the toolbar and the on-line help system. The pull-down menus are accessed using
the mouse or <Alt> key combinations, where key is the letter underlined in each menu option. For
example, pressing <Alt> F displays the File menu.

The File menu, depicted at right, provides the following functions:

New configuration file – Creates a new configuration file.

Open configuration file – Opens a file dialog so you can load a different
configuration file. The file selected using the file dialog becomes
associated with the selected datalogger.

Hint: Configuration files must always reside in the Project Path, if a file
outside the current Project Path is selected it will be copied automatically
to the Project Path after selection.

Save configuration file – Saves the current configuration using the name already specified.

Save configuration file as… – Saves the current configuration using a name you will select using the
save file dialog.

Print configuration file – Sends a report to the default printer detailing the program and connection
configuration.

Print setup – Opens the print setup dialog so you can modify the default printer settings.

Exit – Closes the Logger Configuration form. If a monitoring session is active it will be terminated. If
changes were made to the configuration without saving you will be prompted to save these changes.

The Program menu, depicted at right, provides access to datalogger

program configuration options, stored in your configuration file.

Direct Connect Channels – Invokes the Channel Configuration form to

select and configure instruments that are directly connected to the control
module wiring panel.

Multiplexers – Invokes the Configure Multiplexers form to configure multiplexers.

Input Locations – Invokes the Configure Input Locations form for configuring the pre-defined locations
for data values, or for defining new locations.

Total Station – To configure an attached Robotic Total Station. See the Canary Systems Total Station
User‘s Guide for information on this option.

Hint: The choices on the Program menu will depend on the datalogger selected. Review section 6 for
information on the dataloggers supported by MultiLogger.

16 MultiLogger Software User’s Guide

 Section 2 – Getting Started

The Configure menu, depicted at right, provides access to additional monitoring configuration options.

Text Monitor – Invokes the Select Locations form which is used to select
locations for the text monitor. See section 6.3 for more information.

Graphical Monitor – Invokes the Configure Graphical Monitor form which is

used to configure the charts used for the graphical real-time monitor. See
section 6.4 for more information.

Capture Intervals – Configures the data capture facility that operates while the
monitor mode is active. See section 6.6 for more information.

Terminal Font – Displays a font dialog which configures the font for the terminal emulation window. See
section 6.8 for more information.

MS Excel Link – Configures the OLE linking to Excel for data that is captured during monitoring. See
section 6.9 for more information.

Notification System – Configures the notification system which allows you to send e-mail using data
collected through data collection or monitor mode capture. See section 6.10 for more information.

Preferences – Configures various display and function parameters. See section 6.11 for more
information.

The Function menu, duplicates the functions of the Logger Toolbar.

The Logger toolbar can be hidden to maximize the display for monitoring. The functions
are then accessed through this menu.

In addition, right clicking anywhere in the configuration form (except on the charts) will
display a pop-up menu which also duplicates the functions of the configuration form
toolbar.

See the following section on the functions of the Logger Toolbar.

The Help menu, depicted at right, accesses the on-line help system, and About box.

Help Contents – Displays the contents of the MultiLogger on-line help system.

About – Displays the About MultiLogger form. Note the

version number of your MultiLogger software. This is required
when obtaining technical support.

It also displays information on how to obtain technical support

for MultiLogger.

Press the Resources button to display information about your

computer system including available disk space, memory and
other system resources.

Press Close to close the About box.

MultiLogger Software User’s Guide 17

 Section 2 – Getting Started

2.3.2 Logger Form Toolbar

The toolbar at the top of the configuration form speeds access to the most common datalogger functions.
These functions are duplicated in the Function menu displayed at the top of the form and by right-clicking
anywhere on the form.

The Zero, Start, Collect, Monitor, Stop, Clear and Test functions all
require a connection to the selected datalogger. When these functions
are initiated MultiLogger will first attempt to connect (unless the
connection has already been established) using the devices you have
specified on your Network Configuration. This may include dialing
modems, making socket connection connections, sending transceiver
ID‘s or addresses, etc.

The Zero, Start, Stop, Clear and Test functions also require a program to be downloaded into the
datalogger.

Hint: You should never Abort any of the program download functions!

After successfully connecting to the datalogger the program download

dialog will display, as shown at right. Programs are downloaded in
blocks, the progress will be indicated in the text on the dialog. If the
program download fails, perhaps due to a lost connection, an attempt
will be made to re-establish the connection and continue the download.
However it is not unusual for the retries to fail also, due to the
datalogger being in an incorrect mode. It is often required to wait 1-2
minutes before re-attempting a download to allow time for the
datalogger to reset itself to receive the program again.

After successful download the program will be compiled and loaded into
memory for execution by the datalogger. The dialog will update as
shown.

After successful compile the progress dialog will update to show the
download succeeded.

Alternately, any compile or download errors will be shown.

Last, the Monitor Mode will start automatically.

The operation of the specific program download modes will follow.

18 MultiLogger Software User’s Guide

 Section 2 – Getting Started

Zero - Downloads the Zero mode program into the datalogger which reads all channels without any
conversions as listed on the Channel Configuration form so the baseline readings can be obtained.
All interval and start/stop time configurations are also ignored.

Hint: The readings taken in the Zero mode are not stored for collection.

Once the Zero mode starts and readings are obtained, the Configure Zero Readings form will
display automatically when selecting Start, or any other program download function.

Hint: Only channels that were configured in the Text Monitor will display in the Zero Readings form.

The purpose of the Configure Zero Readings form is to allow selection of zero readings from
specific channels. For example, perhaps only a few of the channels required a new zero reading. Use
the checkbox list on the left side of the form to select the Zero Readings to be updated. The form also
lists the Location, Label, Description, Current Zero and New Zero for reference.

Use the Select All or Clear All buttons to select all zero readings, or clear the selections,
respectively.

Press Accept when finished reviewing, press Cancel to cancel selection of any new Zero Readings.

MultiLogger Software User’s Guide 19

 Section 2 – Getting Started

Start - Downloads the Start mode program which is generated from all the various program
configuration options.

After successful Start mode download the Monitor Mode will start automatically.

Hint: After the Start function is first run, the caption on the button will change to Update, as below.

Collect - Data are collected from the datalogger using the settings
defined on the Data Collection tab of the Network Manager. During
the data collection a status gauge will indicate the progress of the data
collection. A message will display at completion if the operation
succeeds. If successful, the Last Data Collection edit box will update
with the current date and time. Monitoring will be paused during the
data collection procedure.

A status form will display at the end indicating how many arrays of data
were collected or if the collection failed.

Data collected will also be processed according to any configuration

defined on the Configure | Notification System form. See section 5.10
for more information on the Notification System.

Monitor - The Monitor mode is a real-time display of datalogger memory locations using text and
graphical monitoring.

Stop - Stops the datalogger program that is currently executing.

Clear - The storage memory of the datalogger is cleared by pressing this button.

Hint: If there is a program currently operating in the datalogger it will be cleared by the Clear
operation! You must restart the datalogger by pressing Start/Update after running the Clear function!

20 MultiLogger Software User’s Guide

 Section 2 – Getting Started

Test - Downloads the Test mode program which allows you to selectively monitor individual
multiplexer channels. This is useful when troubleshooting instruments on large systems. Simply click
on the instrument channel to monitor, this channel will be selected as shown by its display shown with
a yellow background on the text monitor. The selected channel will be continually read until a different
mode (either Zero or Start/Update) or channel is activated. The units of the Test mode are the same
as the Zero mode, i.e. no math conversions are applied. All interval and start/stop time configurations
are also ignored.

Click on
the Value
cell for the
channel to
read in Test
mode

Hint: The readings taken in the Test mode are not stored for collection.

Info - Calculates or tallies information pertaining to the current program.

Roobrik - Invokes the data reduction program Roobrik. Roobrik is a software tool included with
MultiLogger that can process data files, calculate values and generate reports, charts and
spreadsheets. See the Roobrik User‘s Guide for complete information on Roobrik.

2.3.3 Logger Form Tab Control

The tabs of the page control on the Logger form have the following functions. Each is explained in greater
detail in other sections of this manual.

The first tab, the Project tab, describes the Project configuration.
The next tab, the Program tab, describes how the datalogger is programmed.
The Text Monitor tab contains the controls and displays of the text based monitoring.
Graphical Monitor contains the charts used for the graphical monitor.
Terminal provides you access to the terminal emulation window.

MultiLogger Software User’s Guide 21

 Section 3 – Network Configuration

Section 3 – Network Configuration

Section 2 provided a brief overview of the Network Configuration functions, this section will provide more
detailed information on the functionality of the Network Manager and the specific nodes that may be used
in the construction of the network.

3.1 Node Types

Essentially there are 5 types of nodes in the Network Configuration:

 Gateways
 Communication Ports
 Communication Devices
 Dataloggers
 Tasks

Hint: To display the properties for any element of the Network Manager click on the element, the panel on
the right will update with respective property fields.

Following are explanations for the various parameters associated with each type of node.

22 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

3.1.1 Gateways

Essentially a Gateway is a computer, whether local or remote, that provides a way to access the
dataloggers that are attached. If the datalogger(s) are connected directly to the PC on which MultiLogger
is running then the Gateway is considered Local, if the datalogger(s) are connected to a PC that is
accessible via TCP/IP then the Gateway is considered Remote.

Hint: Whether a Gateway is Local or Remote the MLGateway application included with the installation
provides for access to the Gateway. See Appendix B.1 for more information on installing and activating
MLGateway.

Hint: MultiLogger supports multiple Local and Remote Gateways. Gateway Lists can also be retrieved by
connecting to MLServer and retrieving the list of Gateways that have been configured. Information on this
functionality will be detailed in the following sections.

MultiLogger Software User’s Guide 23

 Section 3 – Network Configuration

The following information must be entered into the Gateway panel which displays to the right of the
Network Configuration Tree when a Gateway is selected in the tree.
Gateway Name – The Gateway Name is shown in the Network Manager frame, to change the name
use the Windows slow left double click on the Gateway name. The cursor will switch to edit mode and
the name can be changed. The Gateway Name is limited to 32 characters. Press Save on the toolbar
after changing the name. When adding new Gateways the default name is "Gateway" plus a
sequence number which is the number of Gateways, plus one, currently defined. A Folder needs to
be defined for each Gateway.
Gateway Enabled – Check whether the Gateway is enabled, this primarily affects the start-up
operation of MultiLogger, no connections are attempted to Gateways that are disabled. If the
Gateway has data collection configured it will still be automated by MLGateway.
Gateway Type – Select whether the Gateway is Local or Remote. Local would be selected when
MultiLogger is connecting to MLGateway on the local computer. Remote refers to a remote computer
running MLGateway.
IP Address - Enter the address of the computer which is running MLGateway. For Local Gateways
the IP Address edit will be disabled, the local IP of 127.0.0.1 is automatically used. For Remote
Gateways the machine name or IP of the computer running MLGateway must be entered.
Port – Configure the Port used for communication to the Gateway. The default of 9001 is used for
Local and Remote Gateways. Multiple copies of MLGateway can be running on a single computer
with different Port assignments.
Folder – Configure the folder where the Network Configuration is stored. The default folder path is
[Shared Docs]\MLGateway\Default.
Hint: When editing folders on Remote Gateways you must have read/write access to the [Shared
Docs]\CanarySys\MLGateway path.

Click on the to configure Gateway Folders. This displays the Configure Gateway Folders form.
The Default folder will be shown, use the button to
configure the Folders.

Press to Add another Gateway Folder.

This will create a folder in the [Shared
Docs]\MLGateway\ path.

Press to Copy the currently selected

Folder to another folder to be specified. Note: This will
copy the entire path to the new folder including all
datalogger folders and their contents.

Press to Rename the currently selected

Folder. You will be asked for confirmation prior to
prompting for the new Folder name. Note: This will
change the Gateway Folder pathname.

Press to Delete the currently selected Folder. You will be asked to confirm deleting the
Folder as this deletes the entire folder path. Note: You cannot delete the Default folder.

Press to Select the currently selected Folder as the Folder for the selected Gateway.

Press to Cancel changes made. Note: This will not cancel changes made to the
Folders. Note: This does not cancel most changes made to the folder configuration.

24 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

For example, to add a new Gateway Folder first press the Add
button. Enter the new Gateway Folder name in the edit.
Press OK to save the new Gateway Folder name and return to the
Configure Gateway Folders form.

The form will update with the new Folder.

Press the Select button to select this folder as the new
folder for the Gateway.

Notice the Network Manager will now update with the new Gateway Folder. Notice the Network
Configuration is blank because the new Gateway Folder does not have any nodes defined yet.
Hint: To copy the settings of one Gateway to another use the Copy button on the Configure Gateway
Folders form.

MultiLogger Software User’s Guide 25

 Section 3 – Network Configuration

Notice also that a new path was created in the [Shared Docs]\MLGateway folder.
Use My Computer to browse to the Public Documents folder, Vista/W7 path is shown.

Alternately browse from the root of the drive to find the Public Documents folder. Note the actual path
is \Users\Public\Public Documents\CanarySys\MLGateway.

26 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

When running on Windows XP or Windows 2003/2008 the Public Documents path is found in the
\Documents and Settings\All Users\Documents folder.

Note the new folder, MyGatewayFolder, named using the Configure Gateway Folders form.
Hint: To allow other users on the network access to the Gateway Folders on this computer you will need
to configure the Sharing for the CanarySys folder.
Pakbus Address – Enter the Pakbus address of the computer, the default is 4094.
Database Alias - This drop-down will only be
enabled if the Gateway List Configuration is
configured for Get Gateway List from MLServer.
The Gateway List stores the list of available
Gateways as well as the list of databases that have
been configured on the Gateway computers. The
Database Alias will then update with the list of
databases that have been configured. If no database
is shown or the database to be used for the Gateway
is not shown then check the configuration of
MLServer on the Gateway computer. See the
MLDBConsole User‘s Guide for complete information
on MLServer including the configuration and
management of databases.

Gateway Log File Settings – Configure the messaging detail for the Gateway log file, or the log file
generated by MLGateway. Check all options for maximum detail. See Appendix B.6 for complete
information on the Gateway log file and message types.

MultiLogger Software User’s Guide 27

 Section 3 – Network Configuration

3.1.2 Communication Ports

There are 3 types of Ports that can be connected to the Gateway for
building connections to the DAU‘s (as shown in the Add new Gateway or
Device form shown at right), COM or serial ports, TCP/IP Sockets and
TAPI based Phone Modems.

These devices can only be added directly to the Gateway.

Following are additional configuration details for each of these devices.

COM – These are installed serial communication ports of the Gateway.

The following settings can be configured for each COM port:

Port Name - Specify a name of up to 32 characters that will be used to identify the COM port in the
Network Configuration. Change the name by left slow-clicking on the name shown in the Network
Configuration tree. The name is NOT related to the actual port that will be used.
Com Port – Use the drop-down to select the port to be used for communications. The list is
populated with ports available on the computer, if an adaptor is not listed then check the driver
installation for the com port device.
Allow Call-back – Check to open the port during the Agent operation to accept incoming call-back
events from connected dataloggers. See Appendix B.7 for more information on call-back.
Highest Call-back Baud Rate – If Call-back is enabled then this edit will be enabled, specify the
baud rate for configuring the port to accept call-back events. Usually 9600 is used.

28 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

TCP/IP Socket – This selects the installed TCP/IP networking of the Gateway to connect to a
terminal server or similar device which has a datalogger or network of dataloggers connected to it.
Common terminal server devices include Campbells NL100, NL105, or NL120 or the Lantronix UDS-
10 or UDS-1100 Device Servers.

The following settings can be configured for each TCP/IP Socket:

Socket Name - Specify a name of up to 32 characters that will be used to identify the Socket in the
Network Configuration. Change the name by left slow-clicking on the name shown in the Network
Configuration tree.

Allow Call-back – Check to open the socket and port to accept incoming connections from the
remote TCP/IP devices that have dataloggers attached which are generating call-back events. See
Appendix B.5 for more information on call-back.

Port – Specify the port that should be opened for accepting connections from TCP/IP devices that
have dataloggers attached which are generating call-back events. This should be a different port than
what is configured for the outgoing connection to the remote TCP/IP device.

Extra Response Time (msec) – Specify any additional time in milliseconds that should be allowed
for receiving responses through the socket. This is particularly helpful where network latencies may
be delaying the communications, a value of 500 (0.5 second) or higher may be required to allow for
these latencies. Note: It is important to specify a value that approximates the actual latencies of the
network, because setting an unnecessarily high value can slow down communications and recovery
mechanisms in certain cases. Use the Windows utility PING or other network testing tools to check
the network latency for a particular connection.

MultiLogger Software User’s Guide 29

 Section 3 – Network Configuration

Phone Modem – This selects a phone modem that has been installed on the Gateway.

The following settings can be configured for each Phone Modem:

Modem Name - Specify a name of up to 32 characters that will be used to identify the Phone Modem
in the Network Configuration. Change the name by left slow-clicking on the name shown in the
Network Configuration tree.

Modem – A list of available phone modems will be shown in the drop-down list, select from one of the
available modems. If the Modem list is empty or the wrong modems are shown, then use the Control
Panel | Phone and Modem to check the installed modems.

Note: Modem configuration is determined through the Control Panel of Windows, MLGateway
uses the Windows Telephony Application Interface, or TAPI, to control modems. If connection
difficulties are experienced when using the Phone Modem then changes to the modem settings,
using the Control Panel, will probably be required. Common problems involve the communication
rate and error correcting protocol, older modems in use with some data acquisition hardware may
not support the higher speeds and complex error correcting protocols common in newer
modems. It may be necessary to fix the baud rate, usually at 9600, and disable any error
correcting protocols. Contact Canary Systems for additional application assistance.

Allow Call-back – Check to enable the Phone Modem for Auto-Answer, to accept incoming calls to
accept incoming call-back events from phone modem equipped dataloggers. See Appendix B.5 for
more information on call-back.

30 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

3.1.3 Communication Devices

A datalogger may be connected to the Gateway using one or more Communication Devices. These
include the RF Modem, MD9 Modem or Generic Modem. Select a port and press Add to include any of
these devices in the Network Configuration.

RF Modem – This refers to the Campbell Scientific RF network devices.

The following settings can be configured for each RF Modem Device:

RF Modem Name - Specify a name of up to 32 characters that will be used to identify the RF Modem
in the Network Configuration. Change the name by left slow-clicking on the name shown in the
Network Configuration tree.
Baud Rate – Configure the speed at which RF Modem will be communicated with, this setting must
match the speed of the connected modems. Note: This option will only display if the RF Modem
is attached to a COM port.
IP Address, Port – Configure the IP Address and Port to be used to connect to the RF Modem.
Note: This option will only display if the RF Modem is attached to a TCP/IP Socket.
Dialed Using Phone Number – Configure the Phone Number to be used for connected to the RF
Modem. Note: This option will only display if the RF Modem is attached to a Phone Modem.
Extra Response Time (msec) – Specify any additional time in milliseconds that should be allowed
for receiving responses through the radio network. This is particularly helpful where network latencies
may be delaying the communications, a value of 500 (0.5 second) or higher may be required to allow
for these latencies.

MultiLogger Software User’s Guide 31

 Section 3 – Network Configuration

MD9 Modem – This refers to the Campbell Scientific multi-drop networking devices, either the MD9
or MD485.

The following settings can be configured for each MD9 Modem Device:
MD9 Modem Name - Specify a name of up to 32 characters that will be used to identify the MD9
Modem in the Network Configuration. Change the name by left slow-clicking on the name shown in
the Network Configuration tree.
Baud Rate – Configure the speed at which MD9 Modem will be communicated with, this setting must
match the speed of the connected modems. Note: This option will only display if the MD9 Modem
is attached to a COM port.
IP Address, Port – Configure the IP Address and Port to be used to connect to the MD9 Modem.
Note: This option will only display if the MD9 Modem is attached to a TCP/IP Socket.
Dialed Using Phone Number – Configure the Phone Number to be used for connected to the MD9
Modem. Note: This option will only display if the MD9 Modem is attached to a Phone Modem.
Extra Response Time (msec) – Specify any additional time in milliseconds that should be allowed
for receiving responses through the radio network. This is particularly helpful where network latencies
may be delaying the communications, a value of 500 (0.5 second) or higher may be required to allow
for these latencies.

32 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

Generic Modem – Generic Modems are specialized communication devices, defined by the user‘s
needs. It includes a simple scripting system to provide for sending commands and receiving
responses to establish connections. See Appendix B.3 for complete information on this device.

The following settings can be configured for each Generic Modem Device:
Generic Modem Name - Specify a name of up to 32 characters that will be used to identify the
Generic Modem in the Network Configuration. Change the name by left slow-clicking on the name
shown in the Network Configuration tree.
Baud Rate – Configure the speed at which Generic Modem will be communicated with, this setting
must match the speed of the connected modems. Note: This option will only display if the
Generic Modem is attached to a COM port.
IP Address, Port – Configure the IP Address and Port to be used to connect to the Generic Modem.
Note: This option will only display if the Generic Modem is attached to a TCP/IP Socket.
Dialed Using Phone Number – Configure the Phone Number to be used for connecting to the
Generic Modem. Note: This option will only display if the Generic Modem is attached to a
Phone Modem.
Extra Response Time (msec) – Specify any additional time in milliseconds that should be allowed
for receiving responses through the modem network. This is particularly helpful where network
latencies may be delaying the communications, a value of 500 (0.5 second) or higher may be
required to allow for these latencies.
Half Duplex – Check this box when the modem is incapable of simultaneously receiving and
transmitting characters.

MultiLogger Software User’s Guide 33

 Section 3 – Network Configuration

3.1.4 Dataloggers

Dataloggers read instruments and store the data for later collection by MLGateway. Numerous models
are supported as detailed in Section 6. See the respective Operators Manual for more information on
specific models. An example Campbell CR800 is selected in the Network Configuration below.

The following settings can be configured for each Datalogger:

Datalogger Name - Specify a name of up to 32 characters that will be used to identify the Datalogger
in the Network Configuration. Change the name by left slow-clicking on the name shown in the
Network Configuration tree. A default name is assigned when adding new dataloggers by using the
model number and a sequence number.
Hint: If you rename a Datalogger you will be prompted to change the Project Path folder as well.
Connection Settings
PakBus Address – Specify the address of the datalogger in the PakBus network. Note: This option
will only display if the datalogger is PakBus compatible.
Baud Rate – Configure the speed at which datalogger will be communicated with, this setting must
match the speed of the connected datalogger. Note: This option will only display if the datalogger
is attached to a COM port.
IP Address, Port – Configure the IP Address and Port to be used to connect to the datalogger. Note:
This option will only display if the datalogger is attached to a TCP/IP Socket.
Dialed Using Phone Number – Configure the Phone Number to be used for connecting to the
Datalogger. Note: This option will only display if the datalogger is attached to a Phone Modem.

34 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

Security Code – If the datalogger has a security code other than 0, the security code will need to be
entered or certain operations such as program Update will fail. See the datalogger Operators Manual
for a description of security settings.
Extra Response Time (msec) – Enter the Extra Response Time in milliseconds.
Set Clock Offset (sec) – During scheduled data collection datalogger clock can be compared to the
Gateway clock and automatically adjusted if the difference exceeds the amount specified. Set to 0 to
disable the clock check. Even if collecting data more than once per day, only one clock adjustment
will be made per day. Allow enough offset to account for poor communication link quality. For
example, when using a direct connection a setting of 1 second will work reliably, however for a radio
connection the setting should be on the order of 10 seconds or more.
Time Zone Offset (hrs) – Use this edit to allow for adjusting clocks in time zones different from the
Gateway time zone. Enter a value positive or negative to reflect the difference between the
datalogger clock and the PC clock. For example if the PC clock is 4:29:57PM but the datalogger clock
is 2:29:57PM then enter an Offset of –2.
Maximum Time On-Line (sec) - Specify the maximum number of seconds allowed for scheduled
data collection during an individual call. This value also sets the length of time for manual collection
when the data is collected via the Logger form. Data collection will be terminated if the number of
seconds is exceeded.
Maximum Packet Size - The data are transmitted and received in groups called packets. When
referring to array loggers (CR510, CR10X) a packet is actually 2 bytes, when referring to table
loggers (CR2xx, CR800, CR1000) a packet is a single byte. Valid values are 32 to 2048. Optimum
packet size is a function of the communication link quality and the type of logger connected. The
defaults assigned for each datalogger type should generally be used.
Project Settings
Configuration File – This file stores the
configuration information for the selected
datalogger. Note: When first adding a
datalogger to the Network Configuration you
will need to select a configuration file using
the button located to the right of the edit.
Alternately Multilogger can create a file for
you, press Save to invoke the Select Logger
Configuration Form, shown below:
Select Browse to an existing
Configuration File to select a previously
created configuration file, select Assign a new Configuration File to start the Logger configuration
form with a default configuration. This configuration can then be saved to a different file if desired.
Project Path – See section 4.1 for more information.
Description – Verbose description of the datalogger, up to 255 characters may be entered.
Datalogger ID – See section 4.1.7 for more information.
Last Updated – See section 4.1.6 for more information.
Last Data Collection – See section 5.1.1 for more information.
Last Battery Voltage – This edit indicates the battery voltage from the last collected array of data,
whether collected using the Agent or the Logger configuration form. If the data have not been
collected yet, or the battery was otherwise unavailable, then the edit will be blank. It is a READ-ONLY
field and can only be modified by the system.

MultiLogger Software User’s Guide 35

 Section 3 – Network Configuration

3.1.5 Tasks

Tasks are programs or batch files that are designed to be run after collecting data due to a call-back
event or after collecting data from all the dataloggers on a particular Gateway.

The follow settings can be configured for each Task:

Task Name - Specify a name of up to 32 characters that will be used to identify the Task in the
Network Configuration. This name will also be displayed in the After Call-back Do drop-down list
shown on the datalogger editing frame. Change the name by left slow-clicking on the name shown in
the Network Configuration tree.
Name of Program to Start - This specifies the executable file to invoke. This can be a COM or EXE
filename, as well as Windows batch file (BAT) or Windows Program Information File (PIF). Use the
file open button to the right of the edit to select the file to execute using a file browse dialog. The path
and filename for the executable must be enclosed in quotes if the path or filename include spaces,
include any command line parameters in the edit following the program filename.
After Task Do - Use this to select other Tasks that would execute at the completion of this task. This
is useful to link a number of Tasks together. (This can also be accomplished using the Windows
batch file mechanism.) Other Tasks configured on the Gateway will automatically display in the drop-
down control.
Desktop Interactive – Check if the Task, whether executable or batch file, requires a desktop
interactive window. By default MLGateway will run these in the Service model, unless MLGateway
was installed as an Application.

36 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

3.2 Data Collection

The Data Collection panel shown when clicking on the tab control that displays when a datalogger is
selected provides for configuring the automated data collection for this datalogger.
Hint: MultiLogger is a client for the MLGateway application which actually performs the automated data
collection. Once the Data Collection is configured MultiLogger can be closed down and data collection will
be performed autonomously by MLGateway.

The follow settings can be configured to customize the Data Collection for each datalogger:
Schedule
Enable Schedule – Check this option to enable scheduled collection of data from this datalogger. If
unchecked data can still be collected but it must be done manually using the Logger form.
Automatic Database Import – Check to enable automatic import of the collected data into the
database. This option will only be enabled if the Gateway List is retrieved from MLServer, since
MLServer imports the data collected by MLGateway.
Schedule – There are 3 basic options for the collection schedule:
 ASAP – Collect the data continuously as soon as possible. The actual interval will depend on
how many other stations have scheduled data collection enabled.
 Interval – Select between 1 minute and 12 hours as an interval for data collection. Use the
Offset Hour and Minute spin-edits to offset the interval from the even time increments, e.g. if
Interval is 1 hour and Offset Minute is 5 then data collection will be scheduled at 5 minutes after
the top of each hour.
 Daily at Time - Specify the time of day to be used for data collection. Check which days of the
week to collect data using the Sunday – Saturday checkboxes to the right.

MultiLogger Software User’s Guide 37

 Section 3 – Network Configuration

Call-back Schedule

Enable Schedule – Check this option to enable scheduled collection of data from this datalogger
AFTER a call-back event. If unchecked call-back data collection will still be initiated but only when a
call-back event is received from the sending dataloggers. This functionality provides for automatically
increasing the frequency of data collection after a call-back event.

Interval – Select between 1 minute and 12 hours as an interval for the call-back data collection. Use
the Offset Hour and Minute spin-edits to offset the interval from the even time increments, e.g. if
Interval is 1 hour and Offset Minute is 5 then call-back data collection will be scheduled at 5 minutes
after the top of each hour.

Duration – Select between 1 minute and 48 hours as the duration of the Call-back Schedule.
Failure Settings

Retries - Specify how many attempts should be made to collect from this datalogger. Generally the
default should be used, however if the connection is known to be unreliable this may be increased.

Delayed Retries – Specify whether and how many retries will be made at the delayed interval if the
Retries setting is exceeded during a data collection attempt. Specify 0 to disable. The maximum
setting is 99.

Delayed Retries Interval – Select the interval for the delayed retries, between 1 minutes and 60
minutes. Data collection for this datalogger will be paused if Delayed Retries and the Delayed
Retries Interval are exceeded. For example, if Delayed Retries is configured for 24 and the Delayed
Retries Interval is 60 minutes then data collection for this node will be paused after 24 hours of
unsuccessful data collection attempts. A successful collection resets the Delayed Retries counter.

Resume Schedule After Delayed Retries – Check this option to resume the scheduled collection in
the event of collection failure and the failure of the Delayed Retries at the Delayed Retries Interval.
For example, if scheduled collection is once per day at noon and Delayed Retries is configured for 10
and the Delayed Retries Interval is 60 Minutes, then collection attempts will continue for 10 hours
after the failed collection at noon, with the option checked collection will continue the next day at
noon.

After Collection Do

The control shown in the group lists all other datalogger nodes and any Tasks that have been configured.
Use the check box located to the left of each datalogger or Task to select that option for execution after
data collection for the current node. If selecting a datalogger then data will be collected automatically. If
selecting a Task then the Task will be run. The data collection can be a scheduled data collection or as a
result of a Call-Back event.

Data Collection Method

Data Recorded Since Last Collection - When selected the pointer recorded at the last data
collection will determine how many arrays are to be collected in subsequent attempts.

Hint: First data collections from new dataloggers will ALWAYS collect ALL DATA.

All Data - All data in the dataloggers memory will be collected at each collection.

Number of Arrays - Only the specified number of arrays will be collected at each collection.

38 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

File Format Options

Specify the format of the data files that will be stored after a successful data collection.

Note: The stored data format will always follow English locale regardless of the Locale setting of
the computer being used to collect data.

Comma Delineated ASCII - This is a standard format for importing into spreadsheets and other data
processing programs. Values in the array are separated by commas.
Example array; 1997.0,275.00,1253.0,30.000,0.75164,0.0000,0.0000,0.0000,11.849,23.130

Space Delineated ASCII - Values in the array are separated by the space character (ASCII #32).
Example array: 1997.0 275.00 1253.0 30.000 0.75164 0.0000 0.0000 0.0000 11.849 23.130

Tab Delineated ASCII - Values in the array are separated by the tab character (ASCII #9).
Example array: 1997.0 275.00 1253.0 30.000 0.75164 0.0000 0.0000 0.0000 11.849 23.130

Check Convert Decimal Day to Y1900 Format to replace the decimal day value with Y1900 value,
calculated from the date and time values stored in the array of data. The Y1900 format is a very useful
format for representing the date/time stamp of the data, this format is supported by many data reduction
and graphing software packages such as Microsoft Excel.

The Y1900 Format is an integer representing the number of days that have elapsed since January 1st,
1900, then a fractional part to represent the portion of the day that has passed, for example the number
37623.375 represents January 2, 2003 at 9:00AM

Data File Options

Data are collected from datalogger nodes and stored in files that have a root name using the
configuration file name. For example, using the example Network Configuration and node
name/configuration file name created previously, the primary data file to be collected will be
MyCR800.dat. This file will be stored in the Project Path for the node, in this case:
[Shared Docs]\MLGateway\MyGatewayFolder\MyCR800.

Hint: Remember the actual [Shared Docs] path differs between Windows versions.
On Windows XP/2003/2008: \Documents and Settings\All Users\Documents\CanarySys
On Windows Vista/7: \Users\Public\Public Documents\CanarySys\

When data collection is initiated and successful the collected arrays are copied to the file name in one of
the following ways;
Append to Data File - The collected arrays of data will be appended to the node data file.
Overwrite Data File - The collected arrays of data will overwrite the data file named in node data file.
Create New Data File - A new file name will be generated using the node data file name and a 4
digit sequence number and then collected arrays of data will be stored to this file. If the file exists
prior to collection the 4 digit sequence number will be increased until the file name is unique.

Note: If the data collection is aborted or otherwise does not complete the data file will not be modified.
During data collection the file tempfile.dat is used to store the collected arrays in binary format. Once
data collection successfully completed the data are processed and copied into the data file.

See Section 6 for specific information on data collection from each type of datalogger supported.

MultiLogger Software User’s Guide 39

 Section 3 – Network Configuration

3.3 Data Collection Status

Click on the Data Collection Status tab to show the current status of data collection. The following
information and controls are provided.

Collection Animation Data Collection Status Tab Current Status Information

Current Collection Progress Press to Abort current collection

If data collection fails for a

node, and the number of
Retries is exceeded at the
Retry Interval, and the
checkbox Resume
Schedule After Delayed
Retries is UNCHECKED
then collection will stop for
that node.

To restart collection for a

failed node press the
Restart Collection button
that will display on the Data
Collection Status panel.

The button will not be

displayed if collection is
currently not scheduled or
collection is proceeding as
normal.

40 MultiLogger Software User’s Guide

 Section 3 – Network Configuration

In addition to the Data Collection Status panel, the Network Configuration tree will highlight the
datalogger nodes in various colors to describe the collection status. When first creating the Network
Configuration for the project, or when adding dataloggers to an existing network, no color will be
assigned. If scheduled data collection has been enabled, the background color of the node will indicate
the status of the collection.

There are 6 possible background colors:

(no background color) The node is enabled but scheduled data collection is disabled.

The last data collection attempt succeeded.

The schedule was changed and the agent is waiting for the next collection interval.

The last data collection attempt failed and the Agent is in Delayed Retries.
Due to the Retries sequence being complete, scheduled data collection is now disabled.
The node is disabled. Communications and scheduled data collection are disabled.

In addition, an hourglass icon will display to the left of the node name during active data collection
tasks to indicate that the Agent is busy.

MultiLogger Software User’s Guide 41

 Section 4 – Logger Configuration

Section 4 – Logger Configuration

The Logger form is used to configure the selected datalogger. When configuring the Campbell based
dataloggers it provides various options related to the function of the datalogger, once completed
MultiLogger builds and downloads a program to the datalogger based on the selections. No Campbell
programming knowledge, either legacy style programming or CRBasic, is required to successfully deploy
the Campbell dataloggers. For users with Campbell programming expertise MultiLogger also provides
extensive customization of the programming options.

Note the button located throughout the forms, these provide for modifying the datalogger
programming. Included with MultiLogger is an application, MLEditor, which provides for editing the
programming files. See Section 7 for more information on MLEditor.

The general organization of the form and its functions are similar between different types of dataloggers.
See Section 6 for additional details on the differences in the form depending on the type of datalogger
being configured.

This section will provide information on the Project and Program tabs, the components of the Logger form
that involve configuration and programming of the dataloggers. The following section will provide
information on the monitoring features of the Logger form.

42 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.1 Project Tab

The Project tab displays basic settings related to the configuration of the system. A typical screen is
depicted below.

The features are explained in the following sections.

4.1.1 Configuration File

The configuration file stores the interval, measurement and connection configuration for a given
datalogger. Essentially, all the settings displayed on the Project tab, Program tab, the Program menu
options and the Configure menu.
Load a different configuration file using then button. Save the current configuration file to the default
name by pressing the button. Save the current configuration to a different file (and path if desired) by
pressing the button. Print the current configuration by pressing the button. The configuration may
be saved to a different file by using the pull-down menu option File | Save configuration file as…
The file that is currently loaded is associated with the current node, or the datalogger that was selected
when the configuration form was activated. If a different configuration is loaded or the current settings are
saved to a different file and/or path these settings will be applied to the selected datalogger.

Hint: See the following section regarding path limitations for loading/saving of the Configuration Files.

MultiLogger Software User’s Guide 43

 Section 4 – Logger Configuration

4.1.2 Project Path

The Project Path informs you of the default folder where the configuration file was saved to or loaded
from. In addition this path will be used for all files that are related to a configuration and monitoring
session. To change this path you must open a new configuration file or save your current configuration to
a new folder. The default path is assigned when the datalogger node is added to the Network
Configuration by creating a folder with the same name as the node in the [Shared
Docs]\MLGateway\Folder path.

Hint: You can load configuration files from outside the Gateway Folder path, however if they are outside
the path of the current Gateway Folder path they will be copied to the current path. You cannot save a
configuration file outside the Gateway Folder path.

See Section 3.1.1 for additional information on the Gateway Folder paths.

The following files will be created and stored in the Project Path:
File Type Extension Description
Configuration File .cfg Contains all your program and monitoring settings
Download File .??? Extension matches datalogger type
Instruction Files .??? Extension matches datalogger type
Location File .loc Contains input storage/final storage definitions
Data File .dat Contains data that you collect
Temp Data File .tmp A temporary data file used during data collection
Chart Template .tee The templates used for your Graphical Monitor

4.1.3 Description

Provide a more verbose description of the datalogger using this edit. Up to 255 characters may be
entered.

Hint: Do not use any commas in your Description!

4.1.4 Download File

By default the download file loaded into the datalogger when pressing Start/Update on the MultiLogger
toolbar is the one named by using the Configuration File root name, with the extension to match the
datalogger type. This file is automatically created by MultiLogger when the Zero, Start/Update or Test or
Info functions are run.

However, if an alternate file should be used by the Start/Update function, specify that name in the
Download File edit. Select the file by pressing the button.

Hint: When specifying a Download File that differs from the default file all of the Program file options are
disabled. In addition, the Zero and Test modes are also disabled. The reason for this is that, with a non-
default file name, MultiLogger assumes that the download file does not need to be generated.

The Download File may be loaded into the MultiLogger Editor by pressing the button.

44 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.1.5 Datalogger Model

This displays the type of datalogger being configured with the Logger form. This cannot be changed in the
Logger form, it is selected when the Network Configuration is built.

4.1.6 Last Updated

Records the date and time when the Start function was last run. You cannot edit this field, it is auto-
generated by MultiLogger and saved in the configuration file as a reference.

4.1.7 Datalogger ID

The Datalogger ID is a number that is stored as the first element in every array of Final Storage data. This
is useful for identifying data when collecting data from multiple dataloggers using multiple configuration
files. The ID should be unique for each datalogger ensuring that the collected data files are not confused.
Once assigned, the Datalogger ID should not be changed for a given datalogger.

When adding dataloggers and assigning new Configuration Files, Datalogger ID‘s will be automatically
assigned beginning with ID 100. However the default ID may be changed by modifying the ID shown in
the Datalogger ID edit.

Hint: For older Campbell Control Modules such as the CR510 and CR10X, the ID is limited to a value of
1-511, for newer dataloggers such as CR2xx, CR800 and CR1000, the ID is limited to a value of 1-9999.

When changing the Datalogger ID a

message will display to remind you
to use the Start or Update function to
update the datalogger. Until the
datalogger is updated it will continue
to record data using the previously
assigned Datalogger ID. Press OK
to close the dialog.

Further, the Datalogger ID is used as the root file name for the Location File used to define how to import
data from each datalogger configured in the Network Manager. For example, if the Datalogger ID is 100,
the Location File created by MultiLogger will be 100.loc. This file is found in the Project Path and is
automatically updated whenever the program for the datalogger is modified. See the MLDBConsole
User‘s Guide for more information on the format of Location Files.

When using the Network Manager to enable

scheduled collection on multiple nodes that share the
same Datalogger ID, whether as a result of assigning
the same Configuration File to multiple nodes or
assigning the same Datalogger ID to multiple
Configuration Files, a dialog will display to warn of
this, as shown at right.

Press OK to ignore the error and continue with enabling the scheduled data collection. Press Cancel to
uncheck the Enable Schedule option for the datalogger node currently selected in the Network Manager.

MultiLogger Software User’s Guide 45

 Section 4 – Logger Configuration

4.2 Program Tab

The Program tab displays and provides access to all the programming options of the datalogger.

Configure instruments Configure Multiplexers and Configure Configure Data Output,

connected directly to instruments connected to datalogger Alarm Action, Output
datalogger Multiplexers memory locations Device

Configure when Configure Read Times Configure Logarithmic Configure reading

datalogger takes (only enabled when Intervals (only enabled when Start and Stop Times
readings Interval Type is selected) Interval Type is selected)

Hint: The options shown on the page will differ slightly depending on the type of datalogger selected. See
Section 6 for complete information on Program options for all supported dataloggers.

The options are explained in greater detail in the following sections.

46 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.2.1 Data Output

The Data Output refers to an instruction file that contains the programming that determines when data
are actually stored. For example, you may select an interval of 60 seconds using the Single Interval
option but select Every 1 Hour as the data storage interval. When you are monitoring readings you will
see them update every minute but when you collect data it will have an hourly interval.

Another use of this feature is in the case of alarm monitoring, you may read instruments at some defined
interval, say every 300 seconds ( 5 minutes), but with 'During Alarm' selected as the Data Output option
data are only stored when one of the instruments exceeds it's high or low alarm settings.

Hint: To output data every time readings are taken select Always as the Data Output option.

WARNING: Certain combinations of Interval Types and Data Output options may not necessarily
work as intended. In general you should follow these guidelines when using the Data Output
feature, only use Single Interval with a scan rate that is faster than the Data Output option. For
example, selecting a Single Interval of 3600 seconds (every hour) but selecting 'Every 15 Minutes'
as the Data Output option will only output data when readings are taken, at the hourly interval! To
be sure your selections of Interval Type and Data Output are working correctly you should
conduct a test to verify proper data storage.

The selected Data Output instruction file may be loaded into the MultiLogger Editor by pressing the
button. Additional Data Output options may be defined by editing the MultiLogger setup files.

4.2.2 Alarm Action

The Alarm Action refers to an instruction file that contains the programming that executes in the event of
an alarm. Alarms are enabled by checking Use Alarms in Channel Configuration and then entering high
and low limits to check. See section 5.3 for more information on the Use Alarms feature of the Channel
Configuration form.

Select None to disable the alarm actions.

The selected Alarm Action instruction file may be loaded into the MultiLogger Editor by pressing the
button. Additional Alarm Action options may be defined by editing the MultiLogger setup files.

4.2.3 Output Device

The Output Device refers to an instruction file that contains the programming that is executed following
storage of data. Often this is used for outputting the stored data to another device such as memory
module or printer.

Select None to disable this feature.

Hint: Do not specify a device, such as an external data storage module, that is not connected to the
datalogger!

The selected Storage Device instruction file may be loaded into the MultiLogger Editor by pressing the
button. Additional Storage Device options may be defined by editing the MultiLogger setup files.

MultiLogger Software User’s Guide 47

 Section 4 – Logger Configuration

4.2.4 Interval Type

Specify whether the Single Interval, the Logarithmic Intervals Table or the Special Read Times are
used to schedule readings.
When using the Single Interval option, select from the drop-down the desired interval. The interval
selection will synchronize with the datalogger clock, for example selecting ‗1 Hour‘ will synchronize
readings on the hour and every hour. The maximum interval length is once per week, ‗7 Day‘, the
minimum will depend on the datalogger being configured.
When using the Logarithmic Intervals the Logarithmic Intervals Table will be used to schedule
readings. Enter up to 8 different interval lengths and iterations.
When using the Special Read Times the Read Times Table will be used to schedule measurements.

4.2.5 Read Times

Enter up to 8 times each day that the datalogger will take measurements. To disable a particular time
clear the Enable Read Time n, where n is 1 through 6, check box. Time is entered in 24 hour format, a
warning will display if the format is incorrect.

Hint: Avoid enabling multiple Read Times with the same time configuration.

4.2.6 Start and Stop Times

Check or clear the corresponding checkbox to enable or disable the Start Time and Stop Time. If
enabled, the time as selected for the respective month, day, hour and minute will be used. The Start
Time and Stop Time can be used with any of the Interval Types.

4.2.7 Logarithmic Intervals Table

If the Logarithmic Intervals are enabled the Length and Iterations table will be used to schedule
readings. See the following guidelines for the Length and Iterations entries.
Length - The units are seconds. The maximum interval length is 86,400 seconds or one set of
readings per day. The minimum interval length is 1 second. An entry of 0 is not allowed. The intervals
do not synchronize with real time.
Iterations - The repetitions of each interval length. The maximum is 99,999. Entering 0 will repeat the
interval length indefinitely.
Default Intervals and Iterations:
Interval Length Iterations Elapsed Time
1 30 20 10 minutes
2 60 40 50 minutes
3 120 25 100 minutes
4 300 80 500 minutes
5 600 50 1000 minutes
6 3600 24 2440 minutes
7 7200 48 5320 minutes
8 86400 0 Indefinite

Hint: When Logarithmic Intervals are selected for the Interval Type then the Elapsed Hours, Elapsed
Minutes and Elapsed Seconds storage locations will be utilized to display the elapsed time from the first
logarithmic interval.

48 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.3 Configure Direct Connect Channels

Each Direct Connect channel can be customized using the options on this form. It is displayed by
pressing the Direct Connect button on the Program tab, or by selecting the corresponding Program
menu item.

Hint: This same form is used when configuring multiplexer channels.

Press to copy the current channel configuration to the clipboard.

Press to paste the channel configuration currently stored in the clipboard to the current
channel. Note: The Labels and Descriptions are NOT copied.

Press to print the current channel settings on the default printer.

Press to display the Channel Configuration topic from the on-line help system.

Press to save your changes and close the form.

Press to cancel the changes you have made to the channel configuration.

See the following topics for more information on the channel configuration form.

MultiLogger Software User’s Guide 49

 Section 4 – Logger Configuration

4.3.1 Channel

Use your mouse to select the channel to edit. The maximum number of channels available will be a
function of the Direct Connect Channels setting for the specified datalogger (usually 16) on when being
used to edit multiplexer channels the setting on the Configure Multiplexers form. The channel number
you have selected will display in the upper left of the Channel Configuration form on the channel
caption.

4.3.2 Identification

Configure the Label, or Name, for the channel, as well as the Description which provides additional
reference information for the channel.

The channel number caption will display which channel is selected using the Channel list.

Label - The channel Label is used to identify a particular channel. This label is used to identify Input
Storage usage (as displayed in the Monitor mode) and Final Storage usage when reducing data using
Roobrik or for import into the database. You may enter up to 24 alpha-numeric characters for each
Label.

Please note the following acceptable characters for use in your labels:
 Lower case alphabet, a through z.
 Upper case alphabet, A through Z.
 Numeric, 0 through 9.
 The underscore character, _.
 The dollar sign, $.

Note: You will not be allowed to use any other characters, such as comma or spaces in your labels!

Description - The description field is used to provide additional information regarding the instrument
channel (or Input Channel). Up to 255 ASCII characters are allowed, all characters except the comma
are allowed.

Note: Do not use any commas in your description!

4.3.3 Measurement

Configure the Gage Type | Make | Model to be used to make the measurement for the selected channel.

Gage Type - The Gage Type identifies the basic category of instrument that is connected to the
selected channel. The Gage Type | Make | Model selections are derived from the list of gage types
stored in the MultiLogger setup files. See section 8 for more information.

Hint: When using the Channel Configuration form to configure multiplexer channels there may be some
limitations on the selection of Gage Types. If the multiplexer Gage Type is set to MultiSensor or VWDSP
then you will be able to select all the gage types available. However, if the multiplexer Gage Type is
specified as a particular gage type, such as Vibrating Wire, then the only gage types that will be available
are None and the specified gage type, in this example, Vibrating Wire.

Make - Select the Make of the instrument connected to the channel. The Make list is derived from the
list of gage types stored in the MultiLogger setup files. See section 8 for more information.

50 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

Model - Select the model of the instrument connected to the channel. The Model is sub-category of
the Make. The Model list is derived from the list of gage types stored in the MultiLogger setup files.
Press to edit the instruction file for the specified instrument. See section 8 for more information.
Press to display additional information on the selected instrument.

4.3.4 Conversion Method

Select Linear to use the Linear Coefficients for converting the instrument reading to engineering units.
When Linear is selected the Polynomial Coefficients box will be disabled.

Select Polynomial to use the Polynomial Coefficients for converting the instrument reading to
engineering units. When Polynomial is selected the Linear Coefficients box will be disabled.

4.3.5 Linear Coefficients

When Linear is selected as the Conversion Method the Zero Reading, Gage Factor and Offset
entered will be used to convert the raw instrument reading to engineering units.

The equation follows this form;

Output  R  Zero Re ading  GageFactor  CF  Offset

Where R represents the current instrument reading and CF represents the units conversion factor.

The Zero Reading and Gage Factor are normally included on a calibration certificate from the instrument
manufacturer. They can also be generated with a spreadsheet program by performing a linear regression
on the output units versus reading.

If the Input Units and Output Units feature is being used then the Gage Factor will be multiplied by the
appropriate factor to complete the conversion.

You may use scientific notation to enter values. For example, '1.234E-2' will represent '.01234'.

4.3.6 Polynomial Coefficients

When Polynomial is selected as the Conversion Method the three coefficients entered as Coefficient
A, Coefficient B and Coefficient C will be used to convert the raw instrument reading to engineering
units.

The equation follows this form;

 
Output  A  CF  R 2  B  CF  R   C  CF

Where R represents the current instrument reading and CF represents the units conversion factor.

The coefficients are normally included on a calibration certificate from the instrument manufacturer. They
can also be generated with a spreadsheet program by performing a linear regression on the output units
versus reading and reading squared.

You may use scientific notation to enter values. For example, '8.91E-6' will represent '.00000891'.

MultiLogger Software User’s Guide 51

 Section 4 – Logger Configuration

4.3.7 Units Conversion

The Units Type defines the category of engineering units conversions currently in use. For example,
Pressure, Load and Distance are the standard categories. Select None to disable (actually still applies
a factor of 1.0) the conversion of the gage reading as defined by the Input Units and Output Units.

After selecting the Units Type select an appropriate Input Units and Output Units setting. The Input
Units refers to the engineering units of the calibration factors that are being used, either the Linear
Coefficients or Polynomial Coefficients. The Output Units refers to the units that are desired. For
example, assume a pressure transducer was calibrated in psi but, being used to measure water level, it is
desired to output feet of water. As shown in the example above, select Pressure as the Units Type, psi
as the Input Units and Feet H20 as the Output Units.

Note: Additional engineering Units Types, Input Units and Output Units can be added by editing the
MultiLogger setup file. See section 8 for more information.

4.3.8 Temperature Correction

Linear temperature may be applied to measurements to correct for temperature change.

Apply - Check Apply to enable the temperature correction for the particular channel.

Note: The Temperature Correction options will be disabled unless Upper Channel is configured.

Initial Temp – Enter the initial temperature to be used for the correction, units must match the output
of the Upper Channel temperature measurement.

Temp Factor – Enter the linear correction factor to be used for the correction. The units must match
the output of the selected Conversion Method.

Hint: If using the Units Conversion the output of the temperature correction will be adjusted accordingly.

The linear temperature correction equation follows this form:

Corrected Re ading  Output  CurrentTemp  InitialTemp  TempFactor  CF

Where Output is the result of the linear or polynomial conversion and CF represents the Units
Conversion factor.

4.3.9 Processing File

The Processing File drop-down allows for inclusion of additional processing or programming for the
selected channel. Select None to disable the inclusion of additional programming for the channel. The list
of available Processing Files is derived from the multilogger.ini setup file.

Press to load the selected Processing File into the MultiLogger editor.

Press to display additional information regarding the selected Processing File.

Press to edit any Extended Properties contained in the Processing File.

52 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

For example, select the option Convert 6 Channels to

Load, then press Edit Properties.

The Configure Extended

Properties form will
display.

The form consists of 2

lists, the File Properties
list shown on the left
and the Available
Properties list shown on
the right.

Note rows shown in

blue in the File
Properties list, these
must be configured for
proper function of the
selected Processing
File.

Values may be selected from the Available Properties grid on the right by left double-clicking the row
with the value to be used, or entered manually by clicking in the Value cell in the File Properties grid.

In this example the

Processing File requires
enter of 2 values,
MLLCZERO and
MLLCFACTOR.

Enter values for the two

properties, example
shown at right, press
Accept when changes
are complete.

Note: Please consult MultiLogger Application Note #16, available in the Support area of our
website at www.canarysystems.com for more information on this topic including the creating of
new Processing File options and the format of the files.

MultiLogger Software User’s Guide 53

 Section 4 – Logger Configuration

4.3.10 Check Alarms

Alarm checking can be enabled or disabled on particular channels using the Check Alarms selections.

Type - The drop down list is used to select an alarm checking procedure for the selected channel. To
disable alarm checking select None as the type. Common alarm types and their function include:
 Low and High - This alarm type is designed to indicate alarm if the measurement falls outside
the range specified by Alarm Low and Alarm High.
 Rate of Change - This alarm type is designed to indicate alarm if the change in measurement
falls outside the range specified by the Alarm Low and Alarm High.
 Rate of Change/High Level - This alarm type is designed to indicate alarm if the absolute
change in measurement falls outside the value specified by Alarm Low and the value exceeds
Alarm High.
 Two Level Alarm - This alarm type is designed to indicate alarm if the measurement value
exceeds either Alarm Low or Alarm High. If the measurement exceeds the Alarm Low value
then a low level alarm is activated, if it exceeds Alarm High then a high level alarm is activated.

Note: Alarm Low and Alarm High values are also used to configure the display of the alarm status
when using the Text Monitor. The cells that show measurements that exceed the Alarm Low value
(function depends on the alarm type configured) will display in yellow, cells that show
measurements that exceed the Alarm High value (function depends on the alarm type configured)
will display in red.

Contact Canary Systems regarding information on other types listed. Numerous support documents are
available at www.canarysystems.com regarding other options.

Alarm Low – Enter the low value to be used for the configured alarm type. The function of Alarm Low
will depend on the alarm type configured.

Alarm High – Enter the low value to be used for the configured alarm type. The function of Alarm
Low will depend on the alarm type configured.

Hint: Alarm Low and Alarm High will be disabled if None is selected as the alarm type.

Press to edit the instruction file for the selected alarm type.

Press to display additional information on the selected alarm type.

54 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.3.11 Channel B

Certain controllers such as the Campbell CR800 and Campbell CR1000 support a secondary
measurement, or Channel B, for each channel, whether a Direct Connect channel or Multiplexer channel.
Click Channel B to display the Channel B configuration.

Hint: The Channel B tab will not display for controllers that don’t support it and it will not display if the
Configure Multiplexer | Wires setting is less than 4.

See the previous sections on configuring the Channel B options.

MultiLogger Software User’s Guide 55

 Section 4 – Logger Configuration

4.3.12 Upper Channel

Select the Upper Channel tab on the Channel Configuration form to display the Upper Channel
configuration options.

Hint: The Upper Channel will be disabled unless Channel A Measurement is configured. It may also be
disabled for certain multiplexer types, for example 2-wire multiplexers.

Typically the Upper Channel selection is used for temperature devices that are connected or associated
with the measurement configured on the Channel A or Channel B tabs.

Hint: Configuration of an Upper Channel device is required to use the Channel A or Channel B
Temperature Correction functions.

56 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.3.13 Upper Channel Identification

Configure the Label, or Name, for the channel, as well as the Description which provides additional
reference information for the channel.

The channel number caption will display which channel is selected using the Channel list.

Label - The channel Label is used to identify a particular channel. This label is used to identify Input
Storage usage (as displayed in the Monitor mode) and Final Storage usage when reducing data using
Roobrik or for import into the database. You may enter up to 24 alpha-numeric characters for each
Label.

Please note the following acceptable characters for use in your labels:
 Lower case alphabet, a through z.
 Upper case alphabet, A through Z.
 Numeric, 0 through 9.
 The underscore character, _.
 The dollar sign, $.

Hint: You will not be allowed to use any other characters, such as comma or spaces in your labels!

Description - The description field is used to provide additional information regarding the instrument
channel (or Input Channel). Up to 255 ASCII characters are allowed, all characters except the comma
are allowed.

4.3.14 Upper Channel Measurement

Configure the measurement device and units for the Upper Channel.

Device – Select the measurement device from the drop-down list. Devices can be added to this list
by editing the MultiLogger setup file.

Press to edit the instruction file for the specified Upper Channel device..

Press to display information regarding the selected device.

Units – Select the appropriate units from the drop-down list. The units available are derived from the
units.ini file which can be edited using MLSetup.
Hint: The Units configuration does not apply a mathematical conversion to the measurement, it is for
display purposes only.

MultiLogger Software User’s Guide 57

 Section 4 – Logger Configuration

4.4 Configure Multiplexers

Configure the multiplexers that are connected

to the datalogger. The Model, Gage Type,
Channel, Enable and Clock settings are all
specified using this form. Press the Edit
Channels button (or left double-click the MUX
number) to configure the individual channels of
the respective multiplexer.

Select the multiplexer you wish to configure

from the list below MUX. You may configure up
to 10 multiplexers.

A description of the multiplexer currently

selected is also available by pressing the
button.

Press to display the Configure Multiplexers topic from the on-line help system.

Press to save your changes and close the form.

Press to cancel the changes you have made to the multiplexer configuration.

Hint: You will not be able to access other MultiLogger forms and/or functions until you close this form.

See the following topics for more information on the form selections.

4.4.1 Multiplexer Model

Select the Model of the multiplexer connected. Select None if no

multiplexer is connected. The source for this list comes from the
Model section in the multilogger.ini file in the folder for the respective datalogger. See section 8.2 for
more information on the multilogger.ini files.

4.4.2 Multiplexer Gage Type

Select the Gage Type of the multiplexer connected. Select None

if no multiplexer is connected. The source for this list comes from
the Gage Types section in the multilogger.ini file in the folder for
the respective datalogger. See section 8.2 for more information on the multilogger.ini files.

Hint: When using the VWDSP Interface the Multiplexer Gage Type must be set to VWDSP.

4.4.3 Channel Configuration

Press to edit the individual channels of the multiplexer. You must select a multiplexer
Model and Gage Type to be allowed access to the Channel Configuration form. See
section 5.3 for more information on the Channel Configuration form.

58 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.4.4 Multiplexer Channels

Select the number of Channels to be configured. The available Channels selections

are based on the configuration settings for the selected multiplexer Model. This
configuration is stored in the multilogger.ini file for the respective datalogger. See
section 8.2 for more information on the multilogger.ini files.

Hint: The maximum number of multiplexer channels allowed for array based loggers is 256, for table
based loggers it is 320. You will not be able to program your system if the number of channels exceeds
these values.

4.4.5 Multiplexer Wires

This option configures the wire switching of the multiplexer. The available Channels
and Wires selections are dependent on the Model of multiplexer selected. This
configuration is stored in the multilogger.ini file for the respective datalogger. See section 8.2 for more
information on the multilogger.ini files.

Hint: When using a Wires selection of 2 the Channel Configuration Upper Channel Device selections will
be disabled. You must use a Wires selection of 4 or higher for the Upper Channel Devices to be enabled.

4.4.6 Multiplexer Enable

Select the digital I/O port of the datalogger that will be used to enable the
multiplexer. Note that certain ports may be selected that are not actually available
depending on the model of datalogger. In this case the selection will revert to a working port.

Hint: Multiplexers from certain manufacturers support “daisy-chaining” where a single control port is used
to activate a series of multiplexers that share this control port. To activate this feature in MultiLogger be
sure to specify the same Enable port for each multiplexer that will be sharing this port.

4.4.7 Multiplexer Clock

Select the digital I/O port of the datalogger that will be used to clock, or advance the
channels, of the respective multiplexer. Note that certain ports may be selected that
are not actually available depending on the model of datalogger. In this case the selection will revert to a
working port.

Generally the clock port used for multiplexers is C8.

Hint: If the Multiplexer Gage Type is set to VWDSP this setting is ignored.

MultiLogger Software User’s Guide 59

 Section 4 – Logger Configuration

4.5 Configure Input Locations

All of the available Input Storage locations may

be configured using this form.

Press to display the Configure

Input Locations topic from the help system.

Press to accept the changes

and close the form.

Press to cancel your changes

and close the form.

The location is selected using the list on the left

of the form. The selected location is displayed
in blue in the location number panel at the top. If the location cannot be modified because it is assigned
by MultiLogger (i.e. channels in use by a multiplexer) then the location number panel displays with a
yellow background and you cannot modify the settings.

Store Location – Check to store the location to Final Storage.

Label - You may enter up to 24 alpha-numeric characters to identify each location. See section 4.3.2
for guidelines regarding proper label format. See the on-line help for more information on adding and
deleting locations using the Label field.

Alias - You may enter up to 24 alpha-numeric characters as an alias, or alternate name, for the
corresponding location.

Description - You may enter up to 255 alpha-numeric characters to identify each location. See
section 5.3.3 for more information on the format of this field.

Units - You may select from the drop-down list a Units identifier to describe the Units of the
measurement. Note: This does not apply any conversion to the data values, it is simply a field
reference. The list of available units can be modified – see section 7.2 for more information on the
Multilogger setup files.

Reserved – Some Input Storage locations have keywords assigned to them that instruction files or
MultiLogger itself may use to identify the location. These keywords are assigned in the MultiLogger
setup file. You cannot change these keywords using this form, you must edit the MultiLogger setup
file directly. Note: For CRBasic programmed dataloggers such as the Campbell CR2xx,
CR800/850 and CR1000 you cannot change the Label for Reserved keywords. In these cases
you can modify the Alias to display and use an alternate Label for the location.

Check Alarms - Alarm checking can be enabled for a particular Input Storage location by selecting
the Type. Enter the Low Limit and High Limit values which may be used for the alarm checking. If
the Database System is installed this information will be used to control the alarm functionality of the
database client tools.

60 MultiLogger Software User’s Guide

 Section 4 – Logger Configuration

4.6 Program Information

This form displays information about the program that has been generated for the datalogger including
the number of instructions, size of program in bytes, Final Storage locations used, data overwrite in
hours, Input Storage assignments and Final Storage assignments.

Press to print the program information on the default printer.

Press to display the Datalogger Program Information topic from the on-line help system.

Press to close the form.

See the following topics for more information.

4.6.1 Program Instructions

The Program Instructions caption indicates the total number of instructions that
are used in the datalogger program. It is not a very useful piece of information. See
Program Bytes for a more useful number.

4.6.2 Program Bytes

The Program Bytes caption indicates how many bytes the current datalogger program
requires of program storage memory. This is particularly an issue with older control
modules that only have 1986 bytes of program memory.

4.6.3 Final Storage Locations

The FS Locations caption indicates how many Final Storage locations are required to
store each array of data. This is useful in determining how long the datalogger can
store data before overwriting of the oldest data occurs.

MultiLogger Software User’s Guide 61

 Section 4 – Logger Configuration

4.6.4 Overwrite in Hours

MultiLogger will attempt to approximate how long the datalogger can store data
before overwriting of the oldest data occurs. You must have run the Status
operation while in the Monitor mode for this calculation to work. The Status
operation interrogates the control module and returns the amount of available data
memory. Press the button on the Text Monitor tab to run the Status operation.

Hint: The value shown may be inaccurate depending on specific Program settings. For example, if Single
Interval is configured for 1 Hour, but Output Data is configured for Once Per Day, the calculation result
will be based on the 1 Hour interval, NOT the daily data storage.

If the Status operation has not been run for this control module the Overwrite in Hours will display 0.
There may also be other circumstances which produce 0, for example using Special Read Times as the
Interval Type but then not enabling any of the times.

Hint: If the result > 24 hours the caption will change to Overwrite in Days and the result will be re-
calculated to show overwrite in days.

4.6.5 Input Storage Assignments

The Input Storage Assignments list depicts the order and labeling of locations that
may be monitored in the Monitor mode. This list is useful when building the
Locations list for the text monitor or the Locations lists for the Graphical Monitor.

4.6.6 Final Storage Assignments

The Final Storage Assignments list depicts the number and position of data points
in the Final Storage array. This is useful to verify the measurements being stored
and when reducing data using the Analyze Data File form.

62 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

Section 5 – Logger Monitoring

MultiLogger includes several monitoring and related communication options and tools to assist with
viewing the current state of measurements whether for checking the operation of a datalogger or
performing specific test or other troubleshooting exercises. This section will detail these functions.

5.1 Configure Text Monitor

Select Configure | Text Monitor from the pull-down menu to select locations for the Text Monitor. You
may also left double-click a location label in the Text Monitor to display the select locations form.

The Available Locations list details the Input Storage locations that are available for monitoring. The
Selected Locations list details the locations that are currently selected.

The buttons have the following functions:

Press to move locations from the Available Locations list to the Selected Locations list.

Press to delete locations from the Selected Locations list.

Press to clear the Selected Locations list.

Press to display the help topic for the locations form from the on-line help system.

Press to accept the changes made to the Selected Locations list and close the form.

Press to cancel changes made to the Selected Locations list and close the form.

MultiLogger Software User’s Guide 63

 Section 5 – Logger Monitoring

5.2 Text Monitor Tab

The Text Monitor tab provides access to various monitor mode functions and displays the monitor
locations values that were selected in the Locations list on the Setup tab. The Monitor mode is started
by pressing the Monitor button on the toolbar.

Monitor Datalogger and Monitor Function Capture Auto Monitor

Status Panel Computer Clocks Buttons Status Configuration Animation

Datalogger Datalogger Monitor Low High Click to Configure Click to Load

Port Status Flag Status Grid Alarm Alarm Locations Values

Hint: While the Text Monitor is running you may press the D key to change the number of digits shown to
the right of the decimal point. This setting will be saved in the configuration file for later retrieval.

5.2.1 Monitor Status Panel

The panel in the upper left corner indicates the status of the monitor. Left click to start the Text Monitor.

Indicates that the Monitor mode is not active.

Indicates that the Monitor mode is active.

Indicates that the Zero mode is active.

Indicates that the Test mode is active.

64 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.2.2 Logger Flags

Datalogger flags are software flags accessible to the program running in the
datalogger. They are usually used for range checking or other Boolean type
operations. Two of the flags, flags 7 and 8 are generally used for the alarm routines,
the rest are available for your program. Flag 7 disables the alarm function, high
indicates alarms are disabled, low indicates alarms are enabled. Flag 8 indicates the
current state of the alarms, high indicates an active alarm, low indicates not active.
In the low state the flag button is colored green, in the high state, red.

To toggle the state of a flag simply left click the respective button while the monitor
mode is active. Only click once, it usually takes a second or two to actually toggle the
flag.

5.2.3 Logger Ports

Datalogger ports are the digital I/O ports of the datalogger. They are usually used for
enabling and clocking multiplexers but are also used for power control, SDM devices,
the MultiSensor Interface or SDI sensors.

In the low state the port button is colored green, in the high state, red.

To toggle the state of a port left click the respective button while the monitor mode is
active. Only click once, it usually takes a second or two to actually toggle the port.

Hint: Depending on the port configuration there may be times when the ports do not toggle.

5.2.4 Monitor Clocks

The two clock displays indicate the computer time (updated once per second) and datalogger time
(updated when the last set of monitor locations were processed). The clocks, assuming the datalogger
clock has been updated, should agree within 2 or 3 seconds.

5.2.5 Set Clock

Press to match the datalogger clock to the computer clock. It usually takes 2-3 seconds for the
operation to complete. This button will be disabled unless the Monitor Mode is Active.

5.2.6 Reset Errors

Press to reset the various error counters that the control module records. The reset process usually
takes 2 to 3 seconds after which the monitor mode will resume. This button will be disabled unless
the Monitor Mode is Active.

5.2.7 Cancel Monitor

Press to cancel the monitor mode that is currently active and close the port that is open. If the
connection was made using a phone modem the modem will be hung up. This button will be
disabled unless the Monitor Mode is Active.

MultiLogger Software User’s Guide 65

 Section 5 – Logger Monitoring

5.2.8 Logger Status

Press to interrogate various system settings and status indicators of the datalogger. If the status
check completes successfully then the Datalogger Status form will display. This button will be
disabled unless the Monitor Mode is Active.

Note: Some of the indicators do not display for the older control modules such as the CR10. Also for
newer dataloggers such as the CR2xx, CR800/850 or CR1000 the Status table will be retrieved. See the
respective Operators Manual for details regarding the Status table listing for these units.

Datalogger Model - The datalogger model.

Datalogger ID - The datalogger ID.
Datalogger Version - The datalogger version.
Program Signature – The Program Signature is
a unique value calculated from the currently loaded
datalogger program and allocation of memory. It
can be used to verify the integrity of a program
operating in a datalogger. When the program is first
downloaded make a note of the Program
Signature. Subsequent checks of this value should
match. Otherwise the program or memory has
been corrupted and needs to be reset.
Program Bytes Available – The number of bytes
available for the program.
OS Version - The version of the datalogger
firmware.
OS Revision - The revision level of the datalogger
firmware.
OS Signature – A unique value for verifying the integrity of the OS firmware.
Memory Size - The size of the datalogger memory in K (1024) bytes.
Final Storage Locations - The total of Final Storage locations available.
Filled Storage Locations - The number of filled Final Storage locations. If this number matches the
Final Storage Locations then the memory has wrapped and the oldest data is being overwritten.
Storage Pointer - The current position of the user Final Storage pointer.
Watchdog Resets (E08) - The number of times that the hardware watchdog timer has reset the
datalogger. This can result from transients, noise or other electrical problems, such as a power
outage.
Overrun Errors - Overrun errors are generated when the processing time of your program exceeds
the scan interval.
Power Loss Count - The number of times that the datalogger paused measurements due to low
voltage (less than 9.6 volts).
Lithium Battery Voltage - The current voltage of the internal lithium battery used to maintain the real
time clock and data in the event of a power outage.
Extended Memory Errors - The number of errors reading/writing to the extended memory of the
datalogger.

66 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.2.9 MS Excel Link

Press to enable the Excel DDE link. When data are captured they will be sent via DDE to Excel.

Indicates that the Excel DDE link is enabled. Press to disable the DDE link.

5.2.10 Capture Status

The text of the button indicates the status of the monitor data capturing. Monitor data capturing is useful
as a backup means of data collection. See section 5.7 for more information on the data capture facility.

Indicates that monitor data capturing is on (default). Click to toggle capture OFF.

Indicates that monitor data capturing is off. Click to toggle capture ON.

5.2.11 Auto Configure Locations

Select this option to automatically select locations for the Text Monitor based on locations that are
actually stored by the program. This is a very useful option to help manage the display of the Text
Monitor as changes are made to the channel configuration.

5.2.12 Monitor Errors

The Errors displayed represents the number of times an incomplete packet of data (or the signature
calculated from the packet differs from signature sent with the packet as calculated by the datalogger)
was received while the monitor mode was active. A noisy connection, such as is common with phone
connections, will generate monitor errors.

5.2.13 Monitor Label

The display at right illustrates the monitor labels and corresponding values.
All monitor labels are prefixed by the Input Storage number. The Input
Storage number and corresponding label are derived from a combination of
three sources, the MultiLogger setup file, the user defined labels associated
with the Direct Connect Instrument Configuration and the labels entered
for Multiplexer Channel Configuration.

The list of Input Storage numbers and corresponding labels can be displayed
on the Program Information form generated by pressing the Info button on
the MultiLogger toolbar.

The caption illustrates the first 10 Input Storage locations, their corresponding Input Location numbers,
labels and monitor values. To change the number of digits shown press the D key.

The list of locations can be configured by selecting Configure | Text Monitor from the pull down menu or
left clicking the location label.

If a monitor value exceeds alarm settings the value will display in red.

Monitor values being monitored in the Test mode will display in yellow.

MultiLogger Software User’s Guide 67

 Section 5 – Logger Monitoring

Values may be loaded directly into the Input Storage of the

datalogger by left clicking the value of the location you wish
to modify. For example, left clicking the value for location
#19 will display a dialog box similar to that depicted at right.
Type the value to wish to enter in the New Value edit box
(12345 has been typed) and then press Accept. If the
value was entered properly the next monitoring pass will
display the updated value.

To abort the input location load press Cancel.

Press Help to display the Enter Input Storage Value topic from the on-line help system.

Hint: When the Test mode is Active, left clicking the location values will select that location for monitoring.
This only applies to instruments connected to multiplexers. For other locations left clicking the value will
have no effect.

5.3 Configure Graphical Monitor

The real-time monitor charts are configured by selecting Configure | Graphical Monitor from the pull-
down menu. Up to 4 charts may be activated for the graphical monitor.

Press to display the Configure Graphical Monitor topic from the on-line help system.

Press to accept the changes you have made and close the form.

Press to cancel the changes you have made and close the form.

68 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.3.1 Chart Type

Select the type of chart that will display. Generally Lines is used, select None to disable the chart.

5.3.2 X Data

Select the data that will be used for the X axis. The available data includes the sequence number, or the
number of data points plotted in the current session, and all the Input Storage values of the datalogger.

5.3.3 X as Label

This option configures the format of the X data supplied to the graphical monitor for the selected chart. If
checked then the X data is considered a label, and hence spacing will be equal along the bottom axis of
the chart, if unchecked then the X data will be considered a value and plotted.

For example, if the Time(HHMM) is selected as the X Data then you will want to check X as Label.

5.3.4 Y1 Locations

Press to select locations for the Y1 axis (left-side) of the chart. The locations form will display. See section
5.1 for an explanation of how the Locations form works.

5.3.5 Y2 Locations

Press to select locations for the Y2 axis (right-side) of the chart. The locations form will display. See
section 5.1 for an explanation of how the Locations form works.

MultiLogger Software User’s Guide 69

 Section 5 – Logger Monitoring

5.4 Graphical Monitor Tab

The Graphical Monitor displays the charts that have been enabled using the Configure Graphical
Monitor form. Up to 4 charts may be displayed. They are automatically sized to fit the viewable area of
the form.

The chart display is configured using the Graphical Monitor Toolbar.

The charts may be printed by clicking the printer icon at the top of the chart.

5.4.1 Graphical Monitor Toolbar

The toolbar at the top of the chart provides access to the functions of the charting tool, in addition to
allowing customization of many of the charting options.

The following section will provide brief explanations for the button functions and chart functionality.

70 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

Allows zooming
in on select portions
of the chart or
scrolling the chart. To
zoom in on a section
of the chart hold the
left mouse button and
drag down to the
lower right. You will
see a box outline
display over the chart.
When the left mouse
button is released the
boxed section will be
expanded to fill the
chart area. To revert
back to the original
size simply hold the
left mouse button and
drag to the upper left,
you will again see a
boxed section display, release the left mouse button to revert back to the original size. To scroll hold the
right mouse button and drag left-right or up-down. Dragging left-right will scroll the X-axis, dragging up-
down will scroll the Y-axis. Release the button to hold the scroll position (the MultiLogger popup menu will
display when releasing the right mouse button, simply left mouse button click on the chart to hide the
popup menu).

Click to activate
the Rotate function.
Hold the left mouse
button and drag left-
right to rotate in the
left to right plane,
drag up-down to
rotate in the up and
down plane. The
degree of rotation for
each orientation is
shown on the status
line to the right of the
toolbar, as shown.

MultiLogger Software User’s Guide 71

 Section 5 – Logger Monitoring

Activates the
Move function. Hold
the left mouse button
and drag left-right or
up-down to move the
chart. Offset values will
display to indicate in
pixels how far the chart
has been moved, as
shown.

Activates Zoom,
to scale the size of the
chart. Hold the left
mouse button and drag
up-down to decrease
the size of the chart.
Drag down-up to
increase the size of the
chart. Drag left-right or
right-left to decrease
the size of the chart.
The Zoom factor will
show on the status
line.

72 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

Adjust 3-D
depth. Hold the left
mouse button and
drag left-right to
increase the depth,
drag right-left to
decrease the depth.
The 3-D depth will be
shown in the status
line, as shown.

Toggle the 3-D

display. If the button
is depressed 3-D is
enabled, otherwise
the chart is shown
without 3-D, as
shown. The previous
3-D settings, included
the depth, rotation
and position are
retained so pressing
3-D again will revert
the chart.

MultiLogger Software User’s Guide 73

 Section 5 – Logger Monitoring

Display the Chart Editor. This

provides access to all of the configuration
options of the charting tool, of which
there are many. Scales may be changed,
titles added, and a myriad other
modifications made to the display of the
chart, including access to all the
configuration options discussed so far.
These settings will be saved in a chart
template file, you will need to save your
configuration file after adjusting the chart
settings to save this template file. By
saving the template file (it will be named
using the root name of your configuration
file, a sequence number for charts 1-4,
and the extension .tee) you will be able to
re-load the settings the next time you
activate the Logger form for this datalogger.

Note the button located in the upper

right corner of the form. Press this button
and then click on the chart editor option
to display the help topic for that option.

For example, to change the minimum

value on the left scale on the chart click
on the Chart | Axis | Left Axis option in
the tree navigator on the left, then the
Change button on the Minimum tab, as
shown at right. A Minimum Left Axis
dialog will display, enter the new
minimum value and press OK. Likewise
to change the Maximum click the
Maximum tab and then Change and
enter a new Maximum value. The scales
can also be configured for Auto ranging
by checking the Auto checkbox.

To change the panel background color

select Chart | Panel in the tree navigator
on the left, then the Color button on the
panel to the right. A Color dialog will
display, select the desired color and
press OK.

The chart will update immediately

whenever changes are made to the
appearance using the Chart Editor.

Press Close in the lower right corner

when appearance changes are complete.

74 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

Display the TeeChart Print

Preview form, as shown. You may
change the default printer, setup of
the printer, margins and other
options prior to printing.

Press Print to print the chart.

Press Close to exit the Print Preview

form.

Copy the
current chart image
as a bitmap to the
Windows clipboard.
This image may then
be pasted into other
Windows applications
using the Paste
button. Only the
image is copied,
example shown at
right.

Save the current chart image in one of 4 formats, Teechart Pro (template file, extension .tee),
Enhanced Metafile (graphic format, extension .emf), Metafile (graphic format, extension .wmf) or Bitmap
(graphic format, extension .bmp).

Hint: A viewing/editing tool called TeeOffice is available for download from our website to load the .tee
format files for customization, export or printing.

MultiLogger Software User’s Guide 75

 Section 5 – Logger Monitoring

5.5 Configure Capture Intervals

When the Monitor mode is active the values that are being
monitored may be automatically saved to a data file. This is
useful where backup of test data is desirable or when a
specific sequence of data capture is required. You still have
the option of collecting data the ―traditional‖ way (by
pressing the Collect button) and processing the test results
using this data. The Configure Capture Intervals form
configures how the data capture functions. The button on
the Text Monitor tab indicates the status of the data capture
function. By default data capture is enabled.

The Configure Capture Intervals form is depicted at right

with the default settings.

Press Help to display the Configure Capture Intervals topic

from the on-line help system. Press Cancel to ignore
changes that were made to the Capture Intervals. Press
Accept to accept and process the changes that were made
to the Capture Intervals configuration.

See the following sections for more information on the

options.

5.5.1 Data File

The name of the data file that will be used to store the monitor capture data is indicated in the edit box.
Press to select a different data file. If you want to save the data to a new file press , type the name of
the file and then press OK.

Hint: The default file name is always the nodename followed by “_capture.dat”. The default path is the
[Shared Docs]\MultiLogger path. You cannot save the capture data file to an alternate path.

The Data Capture file format is as follows (with Include Date/Time Information checked):

ID,Year,JulianDay,Time,Seconds,DecimalDay,ValueN,ValueN+1

ValueN refers to the first Input Storage location value that is being monitored. ValueN+1 refers to the
second Input Storage location value that is being monitored. The sequence of <comma>Value would
continue for all of the Text Monitor locations. In addition a label file (extension .txt) using the root name of
the capture data file name (ie for the file ―MyCR800_capture.dat‖ the label file is ―MyCR800_capture.txt‖)
is created for the current monitoring session. The capture data file can be loaded into Roobrik and the
label file will identify the array positions of the data.

The Data Capture file format is as follows (with Include Date/Time Information NOT checked):

ID,ValueN,ValueN+1

ValueN refers to the first Input Storage location value that is being monitored. ValueN+1 refers to the
second Input Storage location value that is being monitored. The sequence of <comma>Value would
continue for all of the Text Monitor locations.

76 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.5.2 Include Date/Time Information

You have the option of storing computer generated date and time information along with the monitor
values. Generally, if you are monitoring locations 1-8 (by default these locations are included in the
monitor set) you will have date and time information that the datalogger records when the readings are
taken. Including the computer generated date and time information is useful to verify the operation of the
capture intervals when using the Capture Data using Intervals option.

5.5.3 Capture Method

Check Capture Data on Change to ignore the Capture Intervals and only store data in the monitor data
capture file when the data changes. This is often preferable to using the Capture Intervals because
duplication of data is avoided.

Select Capture Data using Intervals to schedule the capturing using the Length and Iterations list.

5.5.4 Capture Intervals

The Length may be specified between 0 and 99,999 seconds. If the length is specified as 0 then the
capture of monitor data stops with this interval.

The Iterations may be specified between 0 and 99,999. This setting indicates how many times the
interval length is repeated. If the Iterations is set to 0 then the interval is repeated indefinitely.

For example, the Configure Capture Intervals screen capture will capture the monitor data every 30
seconds for as long as the monitor data capture is enabled.

MultiLogger Software User’s Guide 77

 Section 5 – Logger Monitoring

5.6 Terminal Tab

The terminal emulator is enabled by left mouse button clicking in the terminal window. Press <ENTER> a
few times to get the attention of the connected datalogger. Responses will vary depending on the type of
datalogger, see the respective datalogger documentation for information on the terminal mode
commands.

If the Monitor mode was active it will be paused.

See your control module Operator‘s Manual for a list of datalogger commands.

5.7 Configure Terminal Font

Select to change the font type and size used for the terminal emulator. Depending on the resolution and
font size settings of your display setup it may be necessary to adjust the size of the font for better viewing.
The changes you make to the font type and size are saved in the MultiLogger setup file.

78 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.8 Configure MS Excel Link

While the monitor mode is active the captured

data may be sent via an OLE link to Microsoft
Excel. Excel will start automatically when the
link is enabled and capture data are available.
You must have Microsoft Excel installed on
your system for this option to work!

Press to display the Configure

Excel Link topic from the help system.

Press to accept the changes

you have made and close the form.

Press to cancel the changes you have made and close the form.

The options are explained below.

Enable Excel Link for Capture Data – Check to enable the Excel linking. When the Excel link is
enabled the other form options will be accessible.
Close Excel when MultiLogger Closes – By default Excel is left running when the link is enabled
and MultiLogger is closed. Check to also close Excel when MultiLogger closes. Note: You will be
asked to save your changes made to the Excel worksheet that was opened.
Workbook – You may specify a workbook to load when the link is first started. Press to locate the
workbook using a file dialog. Note: The workbook must be copied to your Project Path to be loaded
when the Excel link is activated!
Worksheet – You may also specify a worksheet within the specified
workbook to actually send the capture data to while the link is enabled.
Press to open the specified workbook, obtain a list of worksheet names
and allow you select the worksheet from the list. A sample display is shown
at right. If the workbook you specified does not exist a message will display
to this effect.
Also, Excel cannot be running for this option to work. A check is made of
your system to verify that Excel is NOT running, a message will display if
true.
Starting Column – Specify which column the capture data are sent to when the link is first enabled.
Valid range is 1-256.
Starting Row – Specify which row the capture data are sent to when the link is first enabled. Valid
range is 1-16483. With each subsequent set of capture data the row is automatically incremented by
1.
Current Row – This indicates the row that will be used for the next set of capture data.
Reset – Once the link is enabled capture data are sent to the row indicated by Starting Row and
then the row is incremented with each new set of data. Check this to reset the row where capture
data are being sent back to the Starting Row.

MultiLogger Software User’s Guide 79

 Section 5 – Logger Monitoring

5.9 Configure Notification System

MultiLogger can be used to send messages via e-mail to alert others of alarm situations or to relay data
that can then be imported into spreadsheets or databases.

This form allows you to configure how the Notification System will function. You must also set the
appropriate options in the Configure Mail Messaging form.

5.9.1 Notification Method

These settings determine if the Notification System is operational and how it will function. These settings
are stored in your station file.

Disable Notification System - The Notification System will be inactive. The Message Server may
still be running but MultiLogger will not generate messages for the server.

After Collecting Data - After each data collection MultiLogger will process the data and create
messages based on the Message Format and Data Arrays Format selections. The data collection
may be initiated by pressing the Collect button on the toolbar or by using the Collection Agent.

Monitor Mode Capture Data - This enables the Notification System to process Monitor mode data
and create messages based on the Message Format and Data Arrays Format selections. Note: Data
are selected for possible message creation based on the Capture Intervals configuration. In other
words, messages are only created when a data capture event occurs.

80 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

5.9.2 Message Format

These options configure the basic data handling procedures when the Notification System is enabled.

Always Send All Data - This option will always send all the data available for the message.

Send All Data Only if Alarm - This option will only send all the data if there is an alarm in one or
more arrays of data. Note: When using the Monitor Mode Capture Data option as the Notification
Method there is only 1 array available each time a capture data event occurs.

Send Only Alarm Arrays - This option will only send the arrays of data that contain a value that
exceed an alarm limit. Other arrays will be discarded. Note: When using the Monitor Mode Capture
Data option as the Notification Method there is only 1 array available each time a capture data event
occurs.

No Data No Message - If it is found that no arrays of data meet the above criteria for creating
messages then no message is sent.

5.9.3 Data Arrays Format

These options configure the format of the arrays that satisfy the Message Format options.

Send All Elements – All elements in the selected arrays are selected.

Send Selected Elements – Specific elements may be selected from the selected arrays by selecting
this option. Press the button to display and configure the selected locations list. If the Notification
Method is set to Wait – Then Collect Data or After Collecting Data then the list displayed will be the
Final Storage elements. If the Notification Method is set to Monitor Mode Capture Data then the list
displayed will be the Input Storage elements that are currently selected for the Text Monitor.

Include Element Labels – Check to include the labels for the elements that are selected.

5.9.4 Notify Actions

The Notify Actions determine who to send messages to. Up to 10 mail messages may be sent for each
message that is successfully created.

E-Mail? - Click on the cells below to toggle between Yes and No to enable or disable respectively the
corresponding message number.

To - Specify the address of the recipient. Format is user@domain. If the the address is incorrect the
message will be deleted (and a note made in the Message Server log).

Subject - Specify an option subject to be sent in the header of the message.

MultiLogger Software User’s Guide 81

 Section 5 – Logger Monitoring

5.10 Configure Preferences

The Configure Preferences form is designed to allow customization of various display and function
parameters.

The settings configured using this form are stored in the multilogger.ini setup file for use by all nodes and
configuration files.

The form is divided into 3 groups, organized as a tabbed notebook:

General - Settings pertaining to various functional and display attributes.

Text Monitor - Settings pertaining to the Text Monitor tab.

Graphical Monitor - Settings pertaining to the Graphical Monitor tab.

See the following sections for more information.

5.10.1 General

These settings configure various display

parameters and functions related to
logging of communication data.

Heading - The heading shown at the

top of MultiLogger may be changed by
editing this field. Typically a company
or project name is used to help identify
the installation.

Animation - The animation is shown

on the Logger toolbar, to the right. It
becomes active during active
monitoring sessions. The animated
GIF may be changed by using the file
browse button to select a different file.
A selection of animated GIFs is
available for download from the
Canary Systems website. Canary
Systems makes no warranty regarding
the function of any animated GIFs or
their use with MultiLogger.

Hint: If an animation file is selected outside the [Shared Docs]\MultiLogger folder a prompt will display to
copy the file to the [Shared Docs]\MultiLogger folder.

Show Logger Toolbar - The Logger Toolbar may be hidden by unchecking this box. This may be
done to provide more room for the Text or Graphical Monitor, usually in cases where the display is of
limited resolution. By default the Toolbar is shown.

Show Network Toolbar - The Network Toolbar may be hidden by unchecking this box. This may be
done to provide more room for display of the Network Configuration, usually in cases where the
display is of limited resolution. By default the Network Toolbar is shown.

82 MultiLogger Software User’s Guide

 Section 5 – Logger Monitoring

Stop Logger Communication on Failure - While the Text Monitor is Active retries will be attempted
should the connection fail. Check this box to disable automatic retries.

5.10.2 Text Monitor

These settings configure various options associated with the Text Monitor:

Grid Height - Configure the height of

the grid used in the Text Monitor, in
pixels. Usually this value is scaled
according to the Font Size.

Font Size - Configure the size of the

font used in the Text Monitor, in point
size. When increasing the font size be
sure to increase the height of the grid.

Auto Configure Locations - Select

this option to automatically select
locations for the Text Monitor based on
locations that are actually stored by the
program. This is a very useful option to
help manage the display of the Text
Monitor as changes are made to the
channel configuration.

Overrange Text - Select different text

to display when over-range, or invalid
values, are obtained.

Normal Background - Click on the panel to display the Windows color dialog, to allow selecting a
different color for the cells showing normal range values.

Normal Text - Click on the panel to display the Windows color dialog, to allow selecting a different
color for the text of normal range values.

Alarm Low Background - Click on the panel to display the Windows color dialog, to allow selecting a
different color for the cells showing Alarm Low values.

Low Font - Click on the panel to display the Windows color dialog, to allow selecting a different color
for the text of Alarm Low values.

Alarm High Background - Click on the panel to display the Windows color dialog, to allow selecting
a different color for the cells showing Alarm High values.

Alarm High Font - Click on the panel to display the Windows color dialog, to allow selecting a
different color for the text of Alarm High values.

MultiLogger Software User’s Guide 83

 Section 5 – Logger Monitoring

5.10.3 Graphical Monitor

These settings configure various options associated with the Graphical Monitor:

Max Chart Values - Specify the

number of values to display in the
Graphical Monitor charts, between
10 and 1000. Fewer values
provides for better performance.

Keep Chart Data - Check this

option to retain the values
previously stored in the Graphical
Monitor charts when re-starting
MultiLogger. Note: Any changes to
the Graphical Monitor charts will
reset the values in the charts.

Auto Save Chart Data - Check

this option to automatically save
the values in the chart when
closing the Logger form. If this is
unchecked you will receive a
prompt to Save Changes when
attempted to close the Logger form
while the Graphical Monitor had
been active.

84 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

Section 6 – Logger Node Types

This section will provide information on the specific dataloggers supported by MultiLogger and the detail
on the specific form options and functionality for these dataloggers.

6.1 Campbell CR500/CR510/CR10/CR10X/CR7X/CR21X/CR23X

There are several key differences in the function of MultiLogger when using these older dataloggers.
1. Programming of these dataloggers is in the Legacy programming language, the Download File
extension is .dld, instruction file extension is .ins.
2. In the Network Manager there is no Pakbus ID edit in the Connection Settings.

MultiLogger does not support the Pakbus OS

versions of the older controllers.
3. The Input Locations form functions different from
the Campbell CR2xx, CR800 and CR1000.
Note that the Alias edit is disabled, this is not
supported.
The Location list shows all available locations,
compared to the CR2xx/CR800/CR1000 which
only show locations that have been assigned.

MultiLogger Software User’s Guide 85

 Section 6 – Logger Node Types

4. The Logger form Program tab includes additional buttons for accessing the forms specific to
these controllers.

Note the Advanced and Tables buttons on the Program tab.

5. The Advanced options are specialized program

settings.

86 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

The Final Storage Array Format options configure the format of the stored Final Storage data.

Optimize Memory

Check to optimize the number of Final Storage locations used by the program that MultiLogger
will generate for the datalogger.

This option only applies to locations used by the multiplexers. Normally, 32 Final Storage
locations are allocated for each multiplexer that is enabled (by specifying a Model and Gage
Type on the Configure Multiplexers form). When Optimize Memory is checked only locations
that are being used by active channels are stored. This can, depending on the configuration of
the multiplexers, result in significant memory savings. However, be aware that this may cause
difficulties when reducing data because the position of data points will change in the array if
channels are enabled or disabled using the Channel Configuration form. As such, unless the
channel configuration is fixed, it is recommended that Optimize Memory be left unchecked.

To find out how many Final Storage memory locations are being used by the current program
configuration press the Info button on the MultiLogger toolbar.

The number of locations that can be stored depends on the memory size of the control module.
Use the Datalogger Status function (the button on the Monitor tab) while monitoring to check
the exact number of locations available. The Info displays the overwrite time in hours or days.

Store Data at High Resolution

Generally you will want to leave the default setting of storing data at high resolution. High
resolution stores data in a 5 digit format, maximum range ±99999. Low resolution (unchecked)
stores data in a 4 digit format, maximum range ±6999. High resolution uses 4 bytes of memory
for every data point, low resolution uses 2.

Position User Locations at End of FS Array

User Locations are defined as Input Storage locations in the range of 11 to 62. You have the
option of storing these values in these locations at the end of the multiplexer locations in your
Final Storage array instead of before.

The default order of locations in your Final Storage array:

Input Storage Locations 1-62 (that are selected for storage, usually just locations 1-10)
Input Storage Locations 63-254 (multiplexer channel locations)

The order with Position User Locations at End of FS Array checked:

Input Storage Locations 1-10 (system information locations)
Input Storage Locations 63-254 (multiplexer channel locations)
Input Storage Locations 11-62 (that are selected for storage)

This feature is primarily included to maintain compatibility with the Geokon MICRO-10 program
generation software which stored user locations after the multiplexer locations.

It may be desirable to check Position User Locations at End of FS Array anyway because
User Locations are more likely to be selected for storage at a later date and if they are added
after the multiplexer locations it will result in less confusion regarding Final Storage array
positions when reducing the data.

MultiLogger Software User’s Guide 87

 Section 6 – Logger Node Types

The Pulse Measurement group configures the pulse measurement instructions.

When using a tipping bucket rain or similar pulse accumulation type instrument you will need to
check the respective box which refers to where the instrument is connected.

Accumulate P1 Pulses

Check to enable accumulation of pulses for sensors connected to P1.

Accumulate P2 Pulses

Check to enable accumulation of pulses for sensors connected to P2.

The Memory Allocation group configures the memory settings for the control module.

Input Storage Allocation

Input storage refers to the memory of the control module used to store readings temporarily
before sending to Final Storage. These locations are displayed in the Monitor mode.

Intermediate Storage Allocation

Intermediate storage refers to the memory of the control module that is used for temporary
storage of readings during various processing operations. These locations are not accessible for
monitoring or data collection.

Final Storage Area 2 Allocation

Two Final Storage areas can be allocated in the control module. A second storage area can be
used for example to store data sampled at a different scan interval. The default allocation is 0.

The Output Labels group configures storage of the Input Storage labels to the download file.

Check Output Labels to DLD to store the labels in the Download File. The default is to store the
labels.

If the program will be edited by MLEditor then the labels should be output, otherwise the
checkbox can be left blank.

Hint: Program download takes less time when this option is disabled (the default selection).

88 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6. The Configure Tables form allow for

overriding some of the datalogger program
settings made by MultiLogger.

Intervals configures alternate

measurement intervals.

Two programs may be loaded into the

datalogger for concurrent execution. The
programs are stored in areas of memory
referred to as "Table 1" and "Table 2".
Each of these tables may have their own
scan interval, entered in seconds to the
right of the respective check box. Valid
range is from 1 to 8199 seconds.

See the respective Control Module Operator's Manual for more information on the program
tables.

Instructions configures alternate Table programming.

The Control Module has 3 areas of memory for program instructions. Tables 1 and 2 are used to
store programs that can run concurrently while Table 3 stores subroutines that may be called
from either Table 1 or 2. By default MultiLogger uses only Table 1 to store instructions that control
the intervals by which measurements are taken. MultiLogger also uses Table 3 to store all the
subroutines that actually acquire measurements and perform other tasks such as storing data.

Check the section [Subroutine Assignments] in the multilogger setup file for a list of subroutine
assignments used by MultiLogger.

You may override the default instructions generated by MultiLogger for Tables 1 and 2 (normally
empty) by checking the respective checkbox and using the file open dialog to select an instruction
file.

You may add subroutines to Table 3 by checking the respective checkbox and using the file open
dialog to select an instruction file (that contains subroutines).

Use MLEditor to create/modify the instruction files that are specified for Tables 1, 2 or 3.

See the respective Control Module Operator's Manual for more information on the program
tables.

7. The Clocks on the Text Monitor will only show the time,
no date will be shown.

8. Control port selection for CR500/CR510 Multiplexer Enable is constrained to C1 and C2.

9. Control port selection for CR500/CR510 Multiplexer Clock is constrained to C1, C2 and E1 and
E2.

10. Configure of Channel B on the Channel Configuration form is not supported.

11. The folder [Shared Docs]\MLGateway\Lib\ins contains the multilogger.ini setup file and related
instruction files.

MultiLogger Software User’s Guide 89

 Section 6 – Logger Node Types

6.2 Campbell CR2xx

The Campbell CR2xx is limited in its programming and data storage capability.

1. Programming of the CR2xx is in the CRBasic programming language, the Download File and
instruction file extension is .cr2.

2. The maximum number of multiplexer channels is 32, this can be configured as (2) 16-channel
multiplexers or (1) 32-channel multiplexer.

3. The maximum number of memory locations that can be allocated is 47.

4. The maximum number of stored locations that can be allocated is 60.

5. The minimum Single Interval is 1 second.

6. The Logarithmic Intervals Interval Type is not supported.

7. Control port selection for Multiplexer Enable is constrained to C1 and C2.

8. Control port selection for Multiplexer Clock is constrained to C1, C2 and E1 and E2.

9. Configure of Channel B on the Channel Configuration form is not supported.

10. The folder [Shared Docs]\MLGateway\Lib\CR2xx contains the multilogger.ini setup file and
related programming files.

90 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6.3 Campbell CR800/CR1000

The Campbell CR800 and CR1000 provide extensive programming and control capabilities.

Hint: The Campbell CR850 has equivalent functionality as the CR800.

1. Programming of the CR800 and CR1000 is in the CRBasic programming language, the Download
File and instruction file extensions are .cr8 and .cr1, respectively.

2. There is no limit on the number of multiplexer channels, beyond the limit on the number and
configuration of multiplexers themselves.

3. The maximum number of memory locations shown in the Text Monitor defaults to 1000.

4. The Program tab includes a Total Station

form for configuring automation of Robotic
Total Stations. Consult the Total Station
Automation User‘s Guide for complete
information on using this form.

For each prism configured 4 locations are

automatically configured, using the Label as
the root name. For example, using the
default label shown, additional locations
Target_1_H, Target_1_V, Target_1_D and
Target_1_S, for Horizontal angle, Vertical
angle, Distance and Status will be
automatically allocated.

5. Control port selection for Multiplexer Clock when using the CR800 is constrained to C1-C4 and
E1 and E2.

6. Control port selection for Multiplexer Clock when using the CR800 is constrained to C1-C4 and
E1 and E2.

7. When using the CR800, the Text Monitor will disable the display and status updates for the
unsupported control ports C5-C8.

8. For the Campbell CR800, the folder [Shared Docs]\MLGateway\Lib\CR800 contains the
multilogger.ini setup file and related programming files.

9. For the Campbell CR1000, the folder [Shared Docs]\MLGateway\Lib\CR1000 contains the
multilogger.ini setup file and related programming files.

10. Collection from multiple data tables is supported. MLGateway automatically appends the table
name following the node configuration file name. For example, if the node configuration file is
MyCR800 and FSDATA_AVG has been defined then the collected data will be stored in the
MyCR800_FSDATA_AVG.dat file.

MultiLogger Software User’s Guide 91

 Section 6 – Logger Node Types

6.4 Sisgeo ADR-2VWT

The Logware software that supports the Sisgeo ADR-2VWT single-channel vibrating wire datalogger is
included in MultiLogger.

See the Logware User‘s Guide for complete information on the Logware form.

92 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6.5 Kinemetrics K2

MultiLogger supports data collection and automated

database import for the Kinemetrics K2 Digital
Recorders. Data collection may be scheduled for
automatic collection of the event files (extension
.evt) which can be directly imported to the database
and analyzed using the Event Output of Insite. Event
Output provides complete analysis tools including
entry of gage factors, filtering and numerous output
types including acceleration, FFT, PSD and others.

When adding nodes to communication ports,

whether COM, Phone Modem or Socket, open the
Seismic Recorders group using the button and
select Kinemetrics K2, as shown at right.

Select the node type and then press Accept to add

a Kinemetrics K2 node to the selected
communication port.

The K2 node will be

added to the Network
Configuration and the
Select Logger
Configuration File
dialog will display.

Use the Browse to an

existing
Configuration File
option to select an
existing K2
configuration file,
otherwise select the
option Assign a new
Configuration File
and press Accept.

MultiLogger Software User’s Guide 93

 Section 6 – Logger Node Types

The Network Manager will display, left slow click the node to rename it.

Press Save when finished. The Network Configuration will re-display with the K2 node updated with
default path, an example is shown on the following page.
Note that several Connection Settings options will be disabled – these settings don‘t apply to the K2
nodes. When connecting a K2 to a COM port you will see a Baud Rate drop-down (as shown), when
connecting a K2 to a Phone Modem you will see a Dialed Using Phone Number edit and when
connecting a K2 to a Socket you will see a Port edit. Enter Extra Response Time as needed to support
any anticipated communication delays for the selected communication port.

The K2 node is not configured using MultiLogger, software from Kinemetrics provides that functionality
(although the Terminal window does provide a command line interface to configuring the K2 – see the
following sections), however several configuration items are stored in the MultiLogger configuration file
(extension .cfg) associated with the K2 node.

These include:

 Description – Used to provide a more verbose description for the unit.

 Datalogger ID – The project under which the collected .evt files will be imported. This is usually
configured as a 3 digit numeric value.
 Last Updated – The date and time when the node was added to the network.
 Last Data Collection – The date and time of the last collection attempt.
 Last Battery Voltage – The battery voltage returned as a result of the last data collection
attempt.

94 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

In addition the configuration file stores the results of the last Status command – the contents of the
configuration file can be reviewed for trigger status, memory status and other device settings. Please
consult the K2 User Documentation for more information on the Status command.

After pressing Save the Network Manager will update, however the configuration file doesn‘t exist yet.
Left double-click logger node to invoke the Logger form and create the Configuration File. The Logger
form for the K2 consists of a menu and tabbed control for Project settings and a Terminal emulator.

Project Settings – Configure the various configuration file and path settings for the K2 node. See the
previous explanation regarding the various edits.
The Last Folder drop-down will actually display a date picker to be used to populate the Last Folder edit.
Event files are organized by date and time in the K2 memory, the Last Folder edit will select the starting
date for .evt collection. Generally you will only need to collect files from the current date forward but this
will depend on the importance of collecting the historical event files.
After successfully collecting event files the Last Data Collection and Last Battery Voltage fields (read
only fields) will update.

Hint: The Datalogger ID is normally a read-only field in the Network Configuration however for K2 nodes it
is editable.

MultiLogger Software User’s Guide 95

 Section 6 – Logger Node Types

Click on the Terminal tab to display the terminal window (font may be configured using the Configure |
Terminal Font menu item) to activate the window, this includes opening the port and dialing/connecting
using the Network Configuration settings if needed. After connecting you will see the * prompt indicating
connection to the K2. If the * prompt does not display then try typing \ to force entry into monitor mode.

Hint: The K2 must be configured for Tree File System to function properly with MultiLogger. Also – Be
sure to delete file folders as they are created by the K2 to keep the display within a single page otherwise
MultiLogger will not be able to read the folder list and retrieve new event files.

An example session is shown below.

Commands are followed by <CR>. Useful commands are as follows:

A:, B: - Change the current drive.
aq file 0 – To set the Recorder to Tree File System (factory default). Use aq fil to check current setting.
cd folder – To change the current folder. Use CD .. to move up one level in the directory structure.
dir – To view the contents of a folder. Event files are organized by date in the file structure.
del file – To delete an event file.
rd folder – To delete an event folder.
summary file – Display a summary header of the event file.
status – To display the Recorder status.
pw password – Use to enter the Recorder password if enabled.
ans – Hang up the current connection and ready the Recorder for auto-answer.

Consult the Altus Monitor Mode Communications (302219) document available from
www.kinemetrics.com for a complete listing of the Terminal mode commands.

96 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6.6 RefTek 130 Recorder

MultiLogger supports data collection and automated

database import for the RefTek 130 Recorders.
Data collection may be scheduled for automatic
collection of the event files (extension .rte) which
can be directly imported to the database and
analyzed using the Event Output of Insite. Event
Output provides complete analysis tools including
entry of gage factors, filtering and numerous output
types including acceleration, FFT, PSD and others.

When adding nodes to communication ports,

whether COM, Phone Modem or Socket, open the
Seismic Recorders group using the button and
select RefTek 130, as shown at right

Select the node type and then press Accept to add

a RefTek 130 node to the selected communication
port.

The RefTek node will be added to the

Network Configuration and the Select
Logger Configuration File dialog will
display.

Use the Browse to an existing

Configuration File option to select an
existing RefTek configuration file,
otherwise select the option Assign a
new Configuration File and press
Accept.

MultiLogger Software User’s Guide 97

 Section 6 – Logger Node Types

The Network Manager will display, left slow click the node to rename it.

Press Save when finished. The Network Configuration will re-display the RefTek node updated with
default path, ans example is shown on the following page.

Note that several Connection Settings options will be disabled – these settings don‘t apply to the RefTek
nodes. When connecting a RefTek to a COM port you will see a Baud Rate drop-down, when connecting
a RefTek to a Phone Modem you will see a Dialed Using Phone Number edit and when connecting a
RefTek to a Socket you will see Port edit (as shown). Enter Extra Response Time as needed to support
any anticipated communication delays for the selected communication port.

The RefTek node is not configured using MultiLogger, software from RefTek provides that functionality
(although the Terminal window does provide a command line interface to configure the RefTek – see the
following sections), however several configuration items are store in the MultiLogger configuration file
(extension .cfg) associated with the RefTek node.

These include:

 Description – Used to provide a more verbose description for the unit.

 Datalogger ID – The project under which the collected .evt files will be imported. This is usually
configured as a 3 digit numeric value.
 Last Updated – The date and time when the node was added to the network.
 Last Data Collection – The date and time of the last collection attempt.
 Last Battery Voltage – The battery voltage returned as a result of the last data collection attempt

98 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

After pressing Save the Network Manager will update, however the configuration file doesn‘t exist yet.
Left double-click the logger node to invoke the Logger form and create the Configuration File. The
Logger form for the RefTek consists of a menu and tabbed control for Project setting and a Terminal
emulator.

Project Settings – Configure the various configuration file and path settings for the RefTek node. See
the previous explanation regarding the various edits.
The Last Folder drop-down will actually display a date picker to be used to populate the Last Folder edit.
Event files are organized by date and time in the RefTek memory, the Last Folder edit will select the
starting date for .evt collection. Generally you will only need to collect files from the current date forward
but this will depend on the importance of collecting the historical event files.
After successfully collecting event files the Last Data Collection and Last Battery Voltage fields (read
only fields) will update.

Hint: The Datalogger ID is normally a read-only field in the Network Configuration however for RefTek
nodes it is editable.

MultiLogger Software User’s Guide 99

 Section 6 – Logger Node Types

Click on the Terminal tab to display the terminal window (font may be configured using the Configure |
Terminal Font menu item) to activate the window, this includes opening the port and
initializing/connecting using the Network Configuration setting if needed. After connecting you will be able
to type commands to send to the RefTek. Initially there will not be a prompt character. All commands to
the RefTek start with the ‗{‗ character and include two letters for the command and the ID of the unit.
Note, since you are connected directly to a single RefTek unit, you may use a ID value of 0.

An example session is shown below. This session displays a list of the event files currently stored on the
recorder‘s harddrive using the file maintenance command: ‗{FM,0,ev‘

Refer to the 130 Cmd Line Reference document available from www.reftek.com for a complete listing for
the Terminal mode commands and responses.

100 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6.7 SYSCOM MR2002 Seismic Recorder

MultiLogger supports data collection and

automated database import for the SYSCOM
MR2002 Seismic Building Monitoring System.
Data collection may be scheduled for automatic
collection of the event files (extension .xmr) which
can be directly imported to the database and
analyzed using the Event Output of Insite.

The Event Output provides complete analysis tools

including entry of gage factors, filtering and
numerous output types including acceleration,
FFT, PSD and others.

When adding nodes to communication ports,

whether COM, Phone Modem or Socket, open the
Seismic Recorders group using the button and
select SYSCOM MR2002, as shown at right.

Select the node type and then press Accept to

add a SYSCOM MR2002 node to the selected
communication port.

The MR2002 node will be added to the

Network Configuration and the Select
Logger Configuration File dialog will
display.

Use the Browse to an existing

Configuration File option to select an
existing MR2002 configuration file,
otherwise select the option Assign a
new Configuration File and press
Accept.

MultiLogger Software User’s Guide 101

 Section 6 – Logger Node Types

The Network Manager will display, left slow click the node to rename it.

Press Save when finished. The Network Configuration will re-display the MR2002 node updated with
default path, an example is shown on the following page.

Note that several Connection Settings options will be disabled – these settings don‘t apply to the MR2002
nodes. When connecting a MR2002 to a COM port you will see a Baud Rate drop-down, when
connecting a MR2002 to a Phone Modem you will see a Dialed Using Phone Number edit and when
connecting a MR2002 to a Socket you will see Port edit (as shown). Enter Extra Response Time as
needed to support any anticipated communication delays for the selected communication port. Enter the
Password (Default is SWISS) to be used to authenticate the connection.

The MR2002 node is not generally configured using MultiLogger, the WINCOM software from SYSCOM
provides that functionality (although the Terminal window does provide a command line interface to
configure the MR2002 – see the following sections), however several configuration items are store in the
MultiLogger configuration file (extension .cfg) associated with the MR2002 node.

These include:
 Description – Used to provide a more verbose description for the unit.
 Datalogger ID – The project under which the collected .xmr files will be imported. This is usually
configured as a 3 digit numeric value.
 Last Updated – The date and time when the node was added to the network.
 Last Data Collection – The date and time of the last collection attempt.
 Last Battery Voltage – The battery voltage returned during the last data collection attempt.

102 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

After pressing Save the Network Manager will update, however the configuration file doesn‘t exist yet.
Left double-click the logger node to invoke the Logger form and create the Configuration File. The
Logger form for the MR2002 consists of a menu and tabbed control for Project setting and a Terminal
emulator.

Project Settings – Configure the various configuration file and path settings for the MR2002 node. See
the previous explanation regarding the various edits.
The Last Folder drop-down will display a date picker to be used to populate the Last Folder edit. Event
files are organized by date and time in the MR2002 memory, the Last Folder edit will select the starting
date for .xmr collection. Generally you will only need to collect files from the current date forward but this
will depend on the importance of collecting the historical event files.
After successfully collecting event files the Last Data Collection and Last Battery Voltage fields (read
only fields) will update.

Hint: The Datalogger ID is normally a read-only field in the Network Configuration however for MR2002
nodes it is editable.

MultiLogger Software User’s Guide 103

 Section 6 – Logger Node Types

Click on the Terminal tab to display the terminal window (font may be configured using the Configure |
Terminal Font menu item) to activate the window, this includes opening the port and
initializing/connecting using the Network Configuration settings (e.g. Com, Phone Modem, Socket), and
sending the login and configured Password. After connecting and logging in you will be able to type
commands to send to the MR2002. Initially there will be a ? prompt character. All commands to the
MR2002 start with the left parenthesis ‗(‗ character, followed by the command, then ‗++‘ then a right
parenthesis ‗)‘.

An example session is shown below.

Note that no <ENTER> is required to terminate commands, as soon as the right parenthesis is received
the MR2002 will execute the command. Successful execution returns the command response (default is
‗*‘) and then an echo of the command.

Common Terminal mode commands are as follows:

Command Description
(BP++) Return primary battery voltage
(BB++) Return backup battery voltage
(MfSWISS++) Erase all events in SRAM memory (change default password as needed)
(MqSWISS++) Erase all events in Memory Card (change default password as needed)
(AsSWISS++) Reset Alarm Status (change default password as needed)
(SbSWISS++) Reboot system (change default password as needed)
(LiSWISS++) Login with default password ‗SWISS‘
(LpNEWPW++) Change password to NEWPW

Refer to the MR2002 command reference document (Contact Canary Systems) for a complete list.

104 MultiLogger Software User’s Guide

 Section 6 – Logger Node Types

6.8 Virtual Datalogger

The Virtual Datalogger uses the Gateway computer as the datalogger. It includes a scripting language similar to the
Campbell CRBasic programming to provide for automating the function of the Gateway computer. Scripting
commands can include communication commands including sending and receiving characters, processing replies,
applying math or logical evaluations, and storing data, among others. Vibrating Wire instruments may be connected
directly to the Gateway computer and read using the Canary Systems VWDSP Interface. This provides for reading up
to 8 multiplexers of vibrating wire instrumentation. Contact Canary Systems regarding support for other sensor
interfaces.

1. Programming of the VirtualDL is a type of CRBasic programming language, the Download File
and instruction file extension is .dls.

2. Most of the Connection Settings options in the Network Manager are disabled for the Virtual Datalogger as
they are not applicable to this node type.

3. The Logger form has several differences in the interface when using the Virtual Datalogger, including:

 There is no Logger Ports group.

 There are no Collect or Clear buttons on the Logger toolbar.

4. The folder [Shared Docs]\MLGateway\Lib\VirtualDL contains the multilogger.ini setup file and
related programming files.

MultiLogger Software User’s Guide 105

 Section 7 – Roobrik

Section 7 – Roobrik
Included with MultiLogger is a powerful data reduction program called Roobrik (program file roobrik.exe).
This program is loaded (or selected if already loaded) when the Data button is pressed on the
MultiLogger toolbar. By default Roobrik will be passed the root name of the currently loaded configuration
file, with the extension changed from .cfg to .par, if the file does not exist one will be created. The
parameter file stores all of the settings related to the data reduction to be performed with Roobrik.

Essentially it is the function of Roobrik to process the ASCII data files that have been collected, calculate
additional values (if configured) and output the results to a report, chart or directly into Microsoft Excel
using OLE/DDE linking. You must have Microsoft Excel, version 5.0 or higher, installed on your machine
for the Excel linking to work!

A view of the main form of Roobrik is shown below, please see the Roobrik User’s Guide for information
regarding the operation of the program. The User‘s Guide is available in our support directory at
http://www.canarysystems.com/nsupport/ or by contacting your software vendor or Canary Systems
directly.

106 MultiLogger Software User’s Guide

 Section 8 – MultiLogger Setup

Section 8 – MultiLogger Setup

MultiLogger includes 2 programs for customizing the options and functionality of MultiLogger. The first is
MLEditor, which has 3 modes of operation, text editing such as would be used for the editing various
setup files (files with *.ini extension), instruction file editing such as would be used when modifying or
creating program instruction files and download file editing where the actual datalogger programs may be
modified or created. The second program is MLSetup, designed specifically for editing the multilogger.ini
files, see the following section on MLSetup.

8.1 MLEditor

When the gear button is pressed the contents of the specified instruction file are loaded into MLEditor, an
example is shown below.

Move the scroll bars at the bottom and right of the editor window to view the entire file.

The toolbar at the top of the editor window has the following functions:
New – Create a new file. If you have made changes to the current file you will be prompted to save
your changes.
Open – Open an existing file. If you have made changes to the current file you will be prompted to
save your changes.
Save – Save the current file using the default file name.
Save As… – Save the current file using a different name.
Print – Print the current file to the default printer.
Cut – Cut the current editor selection to the clipboard.
Copy – Copy the current editor selection to the clipboard.
Paste – Paste the clipboard contents to the current cursor position.
Delete – Delete the current editor selection.
Select All – Select the entire contents of the editor.
Help – Display the MultiLogger Editor topic from the help file.

MultiLogger Software User’s Guide 107

 Section 8 – MultiLogger Setup

The mode of the editor depends on the extension of the file you are loading. The table below lists the
MultiLogger extensions and respective editor mode.

Extension File Type Description Editor Mode

.txt Text Store label assignments. Text
.dat Data Usually an ASCII format. Text
.ini Setup Stores MultiLogger settings. Text
.ins Instruction Programming used by Legacy programmed dataloggers Instruction
such as CR510, CR10X, etc.
.cr1 CRBasic CRBasic programming used by CR1000 dataloggers. Text
.cr2 CRBasic CRBasic programming used by CR2xx dataloggers. Text
.cr8 CRBasic CRBasic programming used by CR800 dataloggers. Text
.dld Download Download file, or program file, used by the Legacy Download
programmed dataloggers such as CR510, CR10X, etc.

The following sections explain the three modes in greater detail.

8.1.1 Text File Mode

This mode functions as a basic text editor, similar to the Windows program Notepad. Any file may be
edited using this mode, all changes are recorded in simple text format.

8.1.2 Instruction File Mode

Datalogger instruction files for Legacy programmed dataloggers such as the CR510 and CR10X may be
created or modified using this mode. A typical display is shown below.

108 MultiLogger Software User’s Guide

 Section 8 – MultiLogger Setup

A few notes regarding the format of the editor contents:

 Instructions are indicated by lines beginning with ‗P‘, the instruction number follows the ‗P‘. A
description of the instruction follows to the right of the instruction number.

 Instructions may be entered when the cursor is between instructions by entering the instruction
number and pressing <ENTER>.

 Instruction parameters are indicated by lines beginning with a numeric value and followed by a colon
and brackets indicating where the parameter value is located.

 Descriptions for each parameter are shown in blue to the right of the parameter value brackets.

 Comments may be inserted before instructions and after the instruction or parameter description on
each line. Comments are preceded by a semi-colon and display in blue italic.

 The <TAB> key will advance the cursor between parameter value locations (between brackets) and
comments.

 Press <F1> when the cursor is located between instructions to load a list of instructions for the
particular control module being used. Press <F1> when the cursor is located at a parameter value
and you will be shown a list of possible values for a parameter.

 Press <F1> when the cursor is located at an Input Storage location (parameter description ‗Loc‘
shown in example) and a list of numeric values and labels will display. You may select a numeric
value or the label to enter as the location parameter. You may also append the parameter with the
loop indexing (‗—‗) characters or the channel indexing (‗++‘) if you like. The list of numeric values and
labels is derived by loading the Input Storage Assignments list from your configuration file and the
MultiLogger setup file. In addition a list of subroutine assignments and miscellaneous variables are
also loaded from the MultiLogger setup file.

8.1.3 Download File Mode

The datalogger Download File for the Legacy programmed dataloggers such as the CR510 and CR10X
may be edited using this mode. A Download File contains the type of control module, the Input Storage
labeling, the instructions that operate the datalogger and special configuration codes like memory settings
and security codes.

The Download File mode functions very much like the Instruction File mode, the key difference is the way
the labeling is handled, or in other words the values for parameters that refer to Input Storage locations.
In the Instruction file mode you can actually enter a descriptive label for your location parameter which
MultiLogger then resolves to a value when the program is generated. In the Download File mode all Input
Storage location references must be numeric.

The header of the Download File stores the Input Storage labels, up to 254 may be specified. When the
Download File is loaded by the editor a table is created of Input Storage locations and labels. When you
press <F1> at a location parameter you will be shown this table. You may select an Input Storage location
number to enter for the location parameter by clicking on the label in the list. The corresponding Input
Storage number is then entered as the location parameter value. You may also append the indexing
characters (‗—‗) after the numeric value if you like. You may edit the values or labels of the list shown by
pressing <F1>.

See the previous section describing the Instruction file mode for more information.

MultiLogger Software User’s Guide 109

 Section 8 – MultiLogger Setup

8.2 MLSetup

Many of the program generation options such as Gage Type | Make | Model selections are customizable,
this includes modifying the programming for a given application or adding new options to extend the
functionality of the program generation.

The drop-down list selections are stored in a multilogger.ini file in the folder related to each type of
datalogger that MultiLogger can manage, as follows:

Legacy: [Shared Docs]\CanarySys\MLGateway\lib\ins\multilogger.ini

CR2xx: [Shared Docs]\CanarySys\MLGateway\lib\CR2xx\multilogger.ini
CR800/CR850: [Shared Docs]\CanarySys\MLGateway\lib\CR800\multilogger.ini
CR1000: [Shared Docs]\CanarySys\MLGateway\lib\CR1000\multilogger.ini
Virtual DL: [Shared Docs]\CanarySys\MLGateway\lib\VirtualDL\multilogger.ini

Launch MLSetup by using the shortcut found in the MultiLogger group. Use the File | Open menu option,
or the Open button, to open a file browse dialog and browse to the appropriate multilogger.ini file.

The configurable options are shown in tree form, expanding the node will show the selections available
for each option. Nodes may be added, deleted or modifying using the toolbar.

Hint: The Units section is derived from the units.ini file located in the [Shared Docs]\CanarySys folder.

When finished making changes press Save to record your changes.

110 MultiLogger Software User’s Guide

 Appendix A – Tables

A.1 Julian Day

The Julian Day is a value between 1-366 that represents the day of the year. See the following table.

JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC
1 1 32 60 91 121 152 182 213 244 274 305 335
2 2 33 61 92 122 153 183 214 245 275 306 336
3 3 34 62 93 123 154 184 215 246 276 307 337
4 4 35 63 94 124 155 185 216 247 277 308 338
5 5 36 64 95 125 156 186 217 248 278 309 339
6 6 37 65 96 126 157 187 218 249 279 310 340
7 7 38 66 97 127 158 188 219 250 280 311 341
8 8 39 67 98 128 159 189 220 251 281 312 342
9 9 40 68 99 129 160 190 221 252 282 313 343
10 10 41 69 100 130 161 191 222 253 283 314 344
11 11 42 70 101 131 162 192 223 254 284 315 345
12 12 43 71 102 132 163 193 224 255 285 316 346
13 13 44 72 103 133 164 194 225 256 286 317 347
14 14 45 73 104 134 165 195 226 257 287 318 348
15 15 46 74 105 135 166 196 227 258 288 319 349
16 16 47 75 106 136 167 197 228 259 289 320 350
17 17 48 76 107 137 168 198 229 260 290 321 351
18 18 49 77 108 138 169 199 230 261 291 322 352
19 19 50 78 109 139 170 200 231 262 292 323 353
20 20 51 79 110 140 171 201 232 263 293 324 354
21 21 52 80 111 141 172 202 233 264 294 325 355
22 22 53 81 112 142 173 203 234 265 295 326 356
23 23 54 82 113 143 174 204 235 266 296 327 357
24 24 55 83 114 144 175 205 236 267 297 328 358
25 25 56 84 115 145 176 206 237 268 298 329 359
26 26 57 85 116 146 177 207 238 269 299 330 360
27 27 58 86 117 147 178 208 239 270 300 331 361
28 28 59 87 118 148 179 209 240 271 301 332 362
29 29 60 88 119 149 180 210 241 272 302 333 363
30 30 89 120 150 181 211 242 273 303 334 364
31 31 90 151 212 243 304 365

Cells shown in grey must have 1 added to them for leap years.

Leap years occur every 4 years, i.e. 2000, 2004, 2008, etc.

MultiLogger Software User’s Guide 111

 Appendix A – Tables

A.2 ASCII Characters

Decimal Character Decimal Character Decimal Character Decimal Character

0 CTRL @ 32 SPACE 64 @ 96 '
1 CTRL A 33 ! 65 A 97 a
2 CTRL B 34 " 66 B 98 b
3 CTRL C 35 # 67 C 99 c
4 CTRL D 36 $ 68 D 100 d
5 CTRL E 37 % 69 E 101 e
6 CTRL F 38 & 70 F 102 f
7 CTRL G (bell) 39 '' 71 G 103 g'
8 CTRL H (bksp) 40 ( 72 H 104 h
9 CTRL I (tab) 41 ) 73 I 105 i
10 CTRL J (lf) 42 * 74 J 106 j
11 CTRL K (home) 43 + 75 K 107 k
12 CTRL L 44 ' 76 L 108 l
13 CTRL M (cr) 45 - 77 M 109 m
14 CTRL N 46 . 78 N 110 n
15 CTRL O 47 / 79 O 111 o
16 CTRL P 48 0 80 P 112 p
17 CTRL Q (XON) 49 1 81 Q 113 q
18 CTRL R 50 2 82 R 114 r
19 CTRL S (XOFF) 51 3 83 S 115 s
20 CTRL T 52 4 84 T 116 t
21 CTRL U 53 5 85 U 117 u
22 CTRL V 54 6 86 V 118 v
23 CTRL W 55 7 87 W 119 w
24 CTRL X 56 8 88 X 120 x
25 CTRL Y 57 9 89 Y 121 y
26 CTRL Z (EOF) 58 : 90 Z 122 z
27 CTRL [ (esc) 59 ; 91 [ 123 {
28 CTRL \ (right) 60 < 92 \ 124 |
29 CTRL ] (left) 61 = 93 ] 125 }
30 CTRL ^ (up) 62 > 94 ^ 126 ~
31 CTRL _ (down) 63 ? 95 _ 127 DEL

112 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

B.1 MultiLogger Gateway (MLGateway)

The release of MultiLogger version 5.0 represents a significant advancement in the architecture of our
applications for managing networks of data acquisition hardware including automating of data collection.
MLGateway has been re-designed to operate as a server, MultiLogger is now simply a client of
MLGateway. MLGateway performs all the actual functions related to system management, programming,
monitoring and data collection.
The following illustration depicts the interaction of the various software components included with
MultiLogger Suite. These various software components may be distributed throughout a LAN/WAN
connected group of computers or all the applications, including the database server, may be installed and
running on the same computer.

Hint: When MultiLogger connects to MLGateway to make sure it is connecting to a compatible version. If
the version of MultiLogger is not compatible with MLGateway then one or both installations may need to
be updated to the current versions.

MLGateway performs the following functions:

 Management of Network Configuration.
 Management of Gateway configuration folders.
 Multi-User access to dataloggers and other hardware.
 Automation of program generation and download.
 MultiLogger Text and Graphical Monitoring functions.
 Automation of data collection.
 Automation of database data import (using MLServer).
Note: If MLGateway is installed by a user with Administrative permissions, MLGateway will install as a
service. If installed as a non Admin user, MLGateway will install as an application.

MultiLogger Software User’s Guide 113

 Appendix B – Advanced Topics

MLGateway Start – As Service (Admin Users)

If MLGateway was installed as a Service no icon will
display in the tray. To manage the configuration of
MLGateway, run the MLGateway program in the
MultiLogger Programs Group. The form (shown at right)
functions similarly when operated as an application.
Hint: Closing the form does not close MLGateway. To exit MLGateway you will need to stop the Service
using the Windows Services form and then uninstall it as a Service. See the following section for more
information.

MLGateway Startup – As Application (Non-Admin Users)

After installation MLGateway will be started automatically and also placed into the Startup group to launch
after re-boots of the machine. Note the MLGateway icon, , in the tray area to the lower right.
Double-click to display the console, shown at right. Click the x in the upper right corner of the form to
close the form.
Hint: Closing the form does not exit MLGateway. To exit MLGateway right-click on the icon in the tray to
display the pop-up menu, then select Exit.

MLGateway – Switching between Service and Application operation

If installed and running as a Service, follow these steps to convert to Application operation:
1. Go to Control Panel | Administrative Tools | Services. Locate the MLGateway entry, right-click
and select Stop. The Services view should update to show it stopped.
2. Start a command window by typing cmd <ENTER> using the Start | Run option of Windows (or
the Start | Search edit Vista and Windows 7).
3. Change to the folder where MultiLogger is installed, if the default folder was used then enter cd
\program files\multilogger <ENTER>.
4. Unload MLGateway as a Service by typing mlgateway
/uninstall <ENTER>. A message should display indicating
successful unloading of the Service. Close the cmd window by
typing exit <ENTER>.
5. Locate the MLGateway icon in the Programs | MultiLogger group.
Double-click to launch the Application.
6. Include a shortcut to MLGateway in the Startup folder so when the machine is booted it will load
automatically as an Application.

If installed and running as an Application, follow these steps to convert to Service operation:
1. Use the right-click pop-up menu to exit the application.
2. Start a command window by typing cmd <ENTER> using the Start | Run option
of Windows (or the Start | Search edit Vista and Windows 7).
3. Change to the folder where MultiLogger is installed, if the default folder was used
then enter cd \program files\multilogger <ENTER>.
4. Start MLServer as a Service by typing mlgateway /install
<ENTER>. A message should display indicating successful loading of
the Service. Close the cmd window by typing exit <ENTER>.
5. The Service must be started. Go to Control Panel | Administrative
Tools | Services. Locate the MLGateway entry, right-click and select
Start Service. The Services view should update to show it started.

114 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

MLGateway – Interface

The MLGateway interface is shown below. It provides status information as well as buttons to access the
various forms and functions.

Function
Buttons

The Function Buttons perform the following:

Settings – Configure the Port used for MultiLogger to MLGateway communications, see the following
section for more information.

License – Configure the MLGateway license, see the following section for more information.

Deactivate – Deactivate the MLGateway license, see the following section for more information.

Log File – Display the log file viewer.

Help – Display the main on-line help topic.

About – Display the current version and support contact information.

MultiLogger Software User’s Guide 115

 Appendix B – Advanced Topics

Configure Settings

Multiple copies of MLGateway can operate on a single computer to

provide access to multiple networks by configuring the Port. The
default Port can also be changed to accommodate firewalls or other
security systems/software.

The default port is 9001.

Note: When MLGateway is used to

provide access to the network from
remote computers it will need to be
added to the Firewall settings on the
machine running MLGateway.

Windows will usually provide

notification of this when MLGateway is
launched, example dialog is shown at
right.

Clock Allow access to automatically

add MLGateway to the Firewall
settings.

To manually configure the Firewall, or to view the current Firewall settings, use the Control Panel |
Firewall applet, an example view showing MLGateway (and MLServer) is shown below.

116 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

MLGateway Activation

MLGateway must be licensed and activated on each machine where it is running. There are two steps:

1. Enter License Key

2. Obtain Authorization Code (activation)

Press the License button on MLGateway

to display the License Activation form.

At startup the License Key is blank, enter

the key supplied with the MultiLogger Suite
documentation, this is usually found on the
Final QA Report document.

Press Demo Key to obtain a 30 day demo

key.

Contact Canary Systems if unable to locate

the License Key.

After entering the License Key MLGateway

must be activated.

Press the Activate button to begin the

activation process.

If registration information has not been

entered on this computer you will first be
prompted to complete the Product
Registration Form, shown at right.

You will need to fill out First Name, Last

Name, Company, Country, City, State,
Postal Code and Email at a minimum,
filling out the remaining fields is highly
recommended.

Once complete then press Activate (button

shows Update if registration information has
been previously entered) to attempt
connecting to our Authorization Code Server
to obtain your Authorization Code.

Note: Your computer requires Internet

connectivity for the automated
Authorization Code delivery to function.
If unable to use the electronic system
then print the form using the Print button
and email/fax to Canary Systems.

See the following section for messages you

may see after pressing Activate.

MultiLogger Software User’s Guide 117

 Appendix B – Advanced Topics

If all fields are entered correctly, the License Key is valid and
the computer has Internet connectivity, the Authorization Code
will be delivered electronically and the software will be
activated.

The following messages may display:

A required field is blank.

This displays because one of the required fields isn‘t filled in. The fields in bold are required fields. Press
OK to return to the Product Registration Form, complete the form and press Activate again.

The License Key is not valid.

The format is incorrect or the number is not valid. Verify correct entry of the License Key.

The Vendor is not valid (can be blank).

The Vendor field is not filled out correctly – this is usually the result of incorrect spelling. If the software
was provided directly by Canary Systems then leave Vendor blank. Contact your vendor to clarify the
exact entry of the field.

Authorization Granted – Thank you for registering.

You have succeeded in activating the software.

Authorization Pending – Press Activate at a later time.

You have succeeded in registering your software however the Authorization Code request is waiting to be
reviewed and approved. These requests are processed in the same business day assuming the request
was submitted during US EST business hours. Call or email if you need activation immediately.

Unable to reach the Canary Systems Authorization Server.

This is usually due to lack of Internet connectivity on the computer attempting to activate the software.
This may be due to Firewall configuration other network security configuration. If applicable contact your
systems administrator for assistance. If unable to resolve the connectivity issues then you will need to re-
start the software, then press Register and Print on the Product Registration Form. Fax or email this
form to Canary Systems or your software vendor. You may also call or email Canary Systems or your
software vendor to obtain your Authorization Code. You will receive an Authorization Code that must be
manually entered into the Software Activation form.

Authorization Failed.
There was an error in the negotiation for the Authorization Code. Try pressing Activate again and if it fails
again then contact your vendor or Canary Systems for further direction.

Software Authorization inactive.

This may be the result of incorrect configuration of the authorization server. Double-check the License
Key entry. If it fails again then contact your vendor or Canary Systems directly.

Demo Authorization Denied – Too many requests.

MLGateway can be activated with a demo Authorization Code which lasts 30 days. This period can be
extended but by default it expires after a single period. Contact your vendor or Canary Systems if you
require a longer demo period.

118 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

MLGateway Deactivation

Use the Deactivate button to deactivate the MLGateway installation. This

provides for activating MLGateway on another computer.

Once pressed a confirmation dialog will display, press OK to confirmation

deactivation, otherwise press Cancel.

If successfully de-activated an Information dialog will display.

MultiLogger Suite can now be un-installed by using the Control Panel | Add
Remove Programs applet.

Log File Viewer

Press the Log button to display the Log File Viewer.

Open Saved Save Current Clear Current Open Set Search Log
Log File Log File Log File Filter Form Contents

Filter Record Log File Events

Status Count Entry Detail Grid

The form provides for viewing the status messages as well as saving them and filtering what records are
shown. Typically the log file is used for troubleshooting and performance evaluation. Contact Canary
Systems for information on specific messages.

MultiLogger Software User’s Guide 119

 Appendix B – Advanced Topics

Use the Log File Filter form to configure which

messages are shown in the viewer.

Configure the Type of message to be shown. By

default all messages are shown. Uncheck specific
messages which are to be hidden in the viewer.

Configure additional filtering with the Message

Contains and Source edits.

Last configure the Priority. Worst case messages

have a Priority of 0. Setting the Priority to 10 will
show all messages.

Click Apply to update the Log File Viewer to only

show the selected messages.

Click Clear to remove all customized Log File Filter settings.

Click Cancel to cancel Set Filter changes.

The example shows only Transport messages.

120 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

B.2 MultiLogger Server (MLServer)

MLServer is the application included with the MultiLogger Suite software that is integral to managing
databases and notifications. It performs the following functions:

 Licensing of the database.

 Import of data sent to it by MLGateway.

 Import of data collected by other systems and/or software though import folders.

 Processing of data in the database and generation of alarms and other notifications.

 Processing and generation of automated outputs.

 Processing and notification of MultiLogger Notification Configuration.

 Management of MultiLogger Gateway Lists.

It can be deployed as an application or as a Windows Service. If the user installing MultiLogger Suite has
Administrator rights then it will be installed as a Service, otherwise it will install as an Application. Running
as a service provides the advantage of not requiring a user to be logged in for MLServer to function.

Several notification methods are available including email, pager, COM port, e.g. sending a command
string out a serial port of the PC, digital I/O port events, e.g. using a Keithley digital I/O card to activate a
dialer or other attached notification device and running executables. See the Insite User‘s Guide for more
information on configuring and using these notification methods.

MLServer Startup – As Service (Admin User Default)

After installation MLServer will be

started automatically, to access the
Control Panel Applet then browse to
the Programs | MultiLogger group
and click MLServer. A view of the
Control Panel Applet is shown at
right.

Click the x in the upper right corner of the form to close the form.

MLServer checks every 60 seconds for pending messages. Message information is generated by
MLGateway when the Notification System is enabled, this information is stored in a file called
notifylist.txt. MLServer also processes data stored in the Firebird database and generates notifications
based on the notification configuration of the database. If there are pending messages then action is
taken depending on the type of message.

Complete detail on the installation and configuration of MLServer are found in the MLDBConsole User‘s
Guide.

MultiLogger Software User’s Guide 121

 Appendix B – Advanced Topics

B.3 Configuring Generic Modems

Generic Modems are communication devices that require custom control strings for proper operation.
These devices may include wireless network adaptors, rs-485 multidrop adaptors or other specialized
communication devices. Note the following guidelines for defining the dial strings to be used with such
devices.

 Enclose any information that is being sent to the modem in quotation marks (e.g., phone
numbers, carriage return code).

 Enter control characters by preceding the character with a ^. For example, enter "^m" to send
control m which is a carriage return character. Alternately the # character, followed by a number
in the range 0-255, may be used to send non-printable ASCII codes. For example to send a
carriage return, include #13 in the quoted string.

 Enter "^^" to send a ^.

 Enter "^~" or "^>" to send a control ^.

 Enter Delay Commands in the form of Dn where n is the specified number of milliseconds that the
transmission is delayed. A Delay Command forces the preceding portion of the command string
to be sent then delays for the specified number of milliseconds before sending more characters.
Characters received during a delay are accepted and discarded.

 Enter Wait for Response Commands in the form of R"xx"n. A Wait for Response Command
forces the preceding portion of the command string to be sent then waits for up to n milliseconds
for the quoted string, xx, to be returned. When the last character of the quoted string is received,
the command is complete and the command string continues with the next command. If the
quoted string is not received, the dialing command is aborted.

Hint: Only the order and existence of the quoted string is checked. Other characters may be mixed in the
response and the string will be accepted if the specified characters are in the correct order.

 Enter T"xx" commands to transmit the quoted string, xx, without waiting for any echo.

 If desired, spaces can be used between commands and quote strings; the spaces are ignored.
For example, "^m" D250 "^m" D250 "ATZ^m" R"OK"250 does the following: sends a carriage
return, pauses 250 milliseconds, sends another carriage return, pauses another 250 milliseconds,
sends ATZ followed by a carriage return, then waits up to 250 milliseconds for OK to be returned
from the modem.

 Enter a ^m (carriage return) after each command string to send the command string to the
modem.

Notes:
A ^m must be entered after each command string or the command string won't be sent to the modem
(e.g., if a phone number is in a command string and a ^m is not entered, the phone number will not be
dialed).

After each character has been sent, MultiLogger waits for its echo. If an echo has not been received
within the time-period specified in the Extra Response Time, MultiLogger will continue with the next
character.

122 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

B.4 Configuration Mode

Beginning with MultiLogger version 2.0.5 access may be restricted to the various datalogger configuration
options, this includes the network as well as program configuration. It is designed so that an administrator
can build a network and datalogger configuration and then restrict access to this configuration from
unauthorized personnel. Configuration Mode is enabled by entering the password in the edit that displays
when selecting the menu option File | Configuration Mode from the Network Configuration screen.

To exit Configuration Mode simply re-select File | Configuration

Mode, while in Configuration Mode you will see the option
checked on the menu.

To automatically enter Configuration Mode at startup of

MultiLogger check the Remember Password option.

By default MultiLogger is configured to enter Configuration Mode

at startup.

The default password is multilogger.

Use the menu item File | Change

Configuration Mode Password to modify
the default password for MultiLogger.

Enter the current password in the Old

Password edit.

Enter the new password in the New

Password edit.

Confirm the new password in the Retype

Password edit.

For security none of the edits will display the passwords that you enter. Passwords may be from 6 to 255
characters in length.

Press Help to display the on-line help topic.

Press Accept to accept the New Password/Enter Password settings.

Press Cancel to cancel the password entries.

MultiLogger Software User’s Guide 123

 Appendix B – Advanced Topics

B.5 Call-Back
Call-back is a mechanism where the dataloggers in your Network Configuration can originate a call or
message to signal to the answering or receiving computer that data collection must be performed. The
call-back event is usually the result of an alarm condition where one or more values have exceeded the
programmed limits and user intervention is required. Call-back should not be used for routine data
collection, configuring the schedule of the datalogger nodes is better suited for this purpose.

There are two aspects to configuring the call-back system, first the Gateway computer must be configured
to properly handle the call-back events, second, the datalogger must be programmed to initiate the call-
back.

Gateway Configuration Guidelines

The PC must be powered and MLGateway must be running. It is not recommended to use ASAP for
data collection schedule for nodes for which call-back is configured. The collection agent may be too
busy processing data collection that the call-back notifications are missed.
The checkbox Allow Call-back On This Port on the Com Port panel must be checked for each port
you need to receive call-back events on. You must also specify the appropriate Highest Call-back
Baud Rate for the device which will be calling on this port. For example, a Campbell DC112 modem
should use 1200, a Campbell COM200/210 should use 9600, etc. Consult your hardware vendor for
the correct setting of the Baud Rate that will be used for the call-back event.
The Datelogger ID on the datalogger configuration panel must match the ID that is used in the
datalogger programming. See the following section for further direction regarding this setting.
You will need to specify what should occur in the event of a call-back. There are basically two
options. First, if Automatic Database Import is checked for the datalogger node then data that are
collected will be automatically imported into the database. Second, the option, After Collect Do is
configured on the datalogger node Data Collection panel to describe other Tasks or nodes that are to
also have their data collected.

Datalogger Programming Guidelines

The datalogger must be programmed to initiate a call-back event, this is accomplished using the
programming for the respective datalogger. These are usually configured using the Alarm Action
option of the Logger form. Consult your software vendor or check the support area of the Canary
Systems website at www.canarysystems.com for information on using this option.

The datalogger must be programmed with the correct Datalogger ID, this is usually accomplished
automatically by running the Update procedure in the Logger form with the correct Datalogger ID
setting and the appropriate Alarm Action option.

Usually the datalogger must have a flag reset after a call-back event, although this would depend on
the programming method used. Consult your software vendor or Canary Systems for guidelines
regarding resetting of flags in the vent of a call-back event. Flags are usually reset by activating the
Text Monitor for the selected datalogger and clicking on the flag that is used to reset the call-back
mechanism.

124 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

B.6 Logging Functions

The File menu at the top of the Network Manager form provides access
to the logging functions of MultiLogger and MLGateway.

These logging functions provide 2 types of feedback regarding the

operation of the software, first the MultiLogger Log File which details
basic program operations and status/error messages generated by
MultiLogger which detail various Logger form operations and
MLGateway communications, second the Gateway Log File, or
MLGateway Log File, which details the actual communications
between the Gateway and connected dataloggers.

The level of detail of the

Gateway Log File may be
expanded by checking the
options on the Gateway panel
of the Network Manager.

B.6.1 MultiLogger Log File

The menu item Show MultiLogger Log File will invoke the Log File Viewer, an example is shown
following. The MultiLogger Log File is the text file, multilogger.log, found in the [Shared
Docs]\MultiLogger path. The MultiLogger Log File includes messages such as the software version
numbers, launch status, status of various communication functions and any error messages returned.
The date and time of the message is noted, the Gateway name and the Priority.

There are several different types of messages generated:

Priority Type
Client Client messages between MultiLogger and MLGateway.
Internal These are internal messages, usually errors in the function of MultiLogger.
Transport Messages detailing the connections and disconnections between MultiLogger and
MLGateway.
Logger Event messages usually generated by various Logger actions such as Start.

MultiLogger Software User’s Guide 125

 Appendix B – Advanced Topics

The Log File Viewer formats and displays the multilogger.log file and includes options for saving, opening,
filtering the messages, among other options.

Open Saved Save Current Clear Current Open Set Search Log
Log File Log File Log File Filter Form Contents

Filter Record Log File Events

Status Count Entry Detail Grid

Use the Log File Filter option to filter which records are
shown in the viewer. To select specific record types simply
click in the Type group.

Additional filters may also be specified with the Message

Contains, Source Contains and Priority options.

Priority messages with lower numbers are more critical.

Most messages are simply status messages and do not
indicate any fault with the operation of the software.

Contact Canary Systems with questions on specific

messages.

126 MultiLogger Software User’s Guide

 Appendix B – Advanced Topics

B.6.2 Gateway Log File

The menu item Show Gateway Log File will invoke the Log File Viewer, an example is shown following.
The Gateway Log File is the text file, mlgateway.log, found in the [Shared Docs]\MLGateway path. The
Gateway Log File includes messages such as the software version numbers, status of various
communication functions including low-level communications and any error messages returned. The date
and time of the message is noted, the Gateway name and the Priority.
There are several different types of messages generated:

Priority Type
ComDebug Messages related to debugging of the communications.
Hardware These are typically errors in the communications between MLGateway and
connected hardware.
Internal Various internal messages of MLGateway, usually related to deleting records from
the log file or other house-keeping.
Low Level Low-level communications between MLGateway and dataloggers. (Must be
enabled using the option on the Gateway panel of the Network Manager)
Server Messages detailing specific actions of MLGateway such as Task execution or other
functions.
Status Status messages which are generally low-priority updates of various functions.
Transport Messages detailing the connections and disconnections between MultiLogger and
MLGateway.

Use the Set Filter form to control which messages are shown, the example below illustrates the view with
the option Include low-level info checked on the Gateway panel, then the filter configured to only show
low-level log events, or the communications between the Gateway and specific dataloggers.

See the previous section on other controls and functions of the Log Viewer form.
Contact Canary Systems with questions on specific messages.

MultiLogger Software User’s Guide 127