How it Works
Campbell Scientific
Loading...
RTDAQ
User Manual
368 pgs14.7 Mb0
Table of contents
Loading...

Campbell Scientific RTDAQ User Manual

RTDAQ
Revision: 3/12
Copyright © 2008-2012
Campbell Scientific, Inc.

Campbell Scientific, Inc. Software End User License Agreement (EULA)

This software can be installed as a trial version or as a fully licensed copy. All terms and conditions contained herein apply to both versions of software unless explicitly stated.
TRIAL VERSION: Campbell Scientific distributes a trial version of this software free of charge to enable users to work with Campbell Scientific data acquisition equipment. You may use the trial version of this software for 30 days on a single computer. After that period has ended, to continue using this product you must purchase a fully licensed version.
This trial may be freely copied. However, you are prohibited from charging in any way for any such copies and from distributing the software and/or the documentation with any other products (commercial or otherwise) without prior written permission from Campbell Scientific.
LICENSE FOR USE: Campbell Scientific grants you a non-exclusive license to use this software in accordance with the following:
(1) The purchase of this software allows you to install and use the software on
one computer only.
(2) This software cannot be loaded on a network server for the purposes of
distribution or for access to the software by multiple operators. If the software can be used from any computer other than the computer on which it is installed, you must license a copy of the software for each additional computer from which the software may be accessed.
(3) If this copy of the software is an upgrade from a previous version, you
must possess a valid license for the earlier version of software. You may continue to use the earlier copy of software only if the upgrade copy and earlier version are installed and used on the same computer. The earlier version of software may not be installed and used on a separate computer or transferred to another party.
(4) This software package is licensed as a single product. Its component parts
may not be separated for use on more than one computer.
(5) You may make one (1) backup copy of this software onto media similar to
the original distribution, to protect your investment in the software in case of damage or loss. This backup copy can be used only to replace an unusable copy of the original installation media.
WARRANTIES: The following warranties are in effect for ninety (90) days from the date of shipment of the original purchase. These warranties are not extended by the installation of upgrades or patches offered free of charge.
Campbell Scientific warrants that the installation media on which the software is recorded and the documentation provided with it are free from physical defects in materials and workmanship under normal use. The warranty does not cover any installation media that has been damaged, lost, or abused. You are urged to make a backup copy (as set forth above) to protect your investment. Damaged or lost media is the sole responsibility of the licensee and will not be replaced by Campbell Scientific.
Campbell Scientific warrants that the software itself will perform substantially in accordance with the specifications set forth in the instruction manual when properly installed and used in a manner consistent with the published recommendations, including recommended system requirements. Campbell Scientific does not warrant that the software will meet licensee’s requirements for use, or that the software or documentation are error free, or that the operation of the software will be uninterrupted.
Campbell Scientific will either replace or correct any software that does not perform substantially according to the specifications set forth in the instruction manual with a corrected copy of the software or corrective code. In the case of significant error in the installation media or documentation, Campbell Scientific will correct errors without charge by providing new media, addenda, or substitute pages. If Campbell Scientific is unable to replace defective media or documentation, or if it is unable to provide corrected software or corrected documentation within a reasonable time, it will either replace the software with a functionally similar program or refund the purchase price paid for the software.
All warranties of merchantability and fitness for a particular purpose are disclaimed and excluded. Campbell Scientific shall not in any case be liable for special, incidental, consequential, indirect, or other similar damages even if Campbell Scientific has been advised of the possibility of such damages. Campbell Scientific is not responsible for any costs incurred as a result of lost profits or revenue, loss of use of the software, loss of data, cost of re-creating lost data, the cost of any substitute program, telecommunication access costs, claims by any party other than licensee, or for other similar costs.
This warranty does not cover any software that has been altered or changed in any way by anyone other than Campbell Scientific. Campbell Scientific is not responsible for problems caused by computer hardware, computer operating systems, or the use of Campbell Scientific’s software with non-Campbell Scientific software.
Licensee’s sole and exclusive remedy is set forth in this limited warranty. Campbell Scientific’s aggregate liability arising from or relating to this agreement or the software or documentation (regardless of the form of action; e.g., contract, tort, computer malpractice, fraud and/or otherwise) is limited to the purchase price paid by the licensee.
COPYRIGHT: This software is protected by United States copyright law and international copyright treaty provisions. This software may not be sold, included or redistributed in any other software, or altered in any way without prior written permission from Campbell Scientific. All copyright notices and labeling must be left intact.
RTDAQ Table of Contents
PDF viewers: These page numbers refer to the printed version of this document. Use the PDF reader bookmarks tab for links to specific sections.
Preface — What's New in RTDAQ? ................................ xi
1. Introduction...............................................................1-1
1.1 RTDAQ Overview................................................................................ 1-2
1.1.1 Main Screen ................................................................................ 1-2
1.1.2 Clock/Program and the EZSetup Wizard.................................... 1-3
1.1.3 Monitor Data............................................................................... 1-3
1.1.3.1 Real-time Monitors............................................................ 1-3
1.1.4 Collect Data ................................................................................ 1-6
1.1.5 Field Calibration and the Calibration Wizard ............................. 1-7
1.1.6 RTMC Development, Run-time and Pro Development.............. 1-7
1.1.7 View Pro ..................................................................................... 1-8
1.1.8 Split............................................................................................. 1-9
1.1.9 CardConvert................................................................................ 1-9
1.1.10 Short Cut................................................................................... 1-9
1.1.11 CRBasic Editor ....................................................................... 1-10
1.1.12 CR5000/CR9000X Program Generators................................. 1-10
1.2 Getting Help for RTDAQ Applications.............................................. 1-11
1.3 Windows Conventions........................................................................ 1-11
2. System Requirements ..............................................2-1
2.1 Hardware and Software ........................................................................ 2-1
3. Installation, Operation and Backup Procedures....3-1
3.1 CD-ROM Installation ........................................................................... 3-1
3.2 RTDAQ Operations and Backup Procedures ....................................... 3-2
3.2.1 RTDAQ Directory Structure and File Descriptions.................... 3-2
3.2.1.1 Program Directory............................................................. 3-2
3.2.1.2 Working Directories.......................................................... 3-2
3.2.2 Backing up the Network Map and Data Files ............................. 3-3
3.2.2.1 Performing a Backup......................................................... 3-4
3.2.2.2 Restoring the Network from a Backup File....................... 3-4
3.2.3 Loss of Computer Power ............................................................ 3-4
4. The RTDAQ Main Screen .........................................4-1
4.1 Overview .............................................................................................. 4-1
4.1.1 Program Startup and Main Screen Functionality........................ 4-1
4.1.2 Datalogger Connectivity, Help and Program Exit ...................... 4-3
4.2 EZSetup Wizard ................................................................................... 4-3
4.2.1 Add Datalogger........................................................................... 4-3
4.2.2 Communication Setup................................................................. 4-4
i
RTDAQ Table of Contents
4.2.3 Datalogger Settings .....................................................................4-4
4.2.3.1 Max Time Online............................................................... 4-5
4.2.4 Summary, Communications Test, and Clock Set........................ 4-5
4.2.5 Send Program.............................................................................. 4-5
4.2.6 Editing and Deleting Dataloggers ...............................................4-5
4.3 Clock/Program Tab............................................................................... 4-6
4.3.1 Basic Operation........................................................................... 4-6
4.4 Monitor Data Tab.................................................................................. 4-7
4.4.1 Field Monitor ..............................................................................4-7
4.4.2 Editing Variable Values ..............................................................4-7
4.4.3 Specialized Real-time Monitor Screens ......................................4-8
4.5 Collect Data Tab ...................................................................................4-8
4.6 Pull-down Menus.................................................................................. 4-9
4.6.1 File Menu ....................................................................................4-9
4.6.1.1 Saving and Loading Configurations .................................. 4-9
4.6.1.2 Exit ....................................................................................4-9
4.6.2 View Menu.................................................................................. 4-9
4.6.3 Datalogger Menu....................................................................... 4-10
4.6.3.1 Connect/Disconnect......................................................... 4-10
4.6.3.2 Update Table Definitions................................................. 4-10
4.6.3.3 Status Table .....................................................................4-10
4.6.3.4 File Control...................................................................... 4-12
4.6.3.5 Calibration Wizard ..........................................................4-15
4.6.3.6 Terminal Emulator........................................................... 4-16
4.6.4 Network Menu ..........................................................................4-17
4.6.4.1 Add/Delete/Edit/Rename Datalogger ..............................4-17
4.6.4.2 Backup/Restore Network................................................. 4-17
4.6.4.3 Computer’s Global PakBus Address ...............................4-17
4.6.5 Tools Menu ...............................................................................4-18
4.6.5.1 Auxiliary Applications ....................................................4-18
4.6.5.2 Options ............................................................................4-19
4.6.5.3 LogTool ........................................................................... 4-19
4.6.5.4 PakBus Graph.................................................................. 4-21
4.7 The RTDAQ Toolbar.......................................................................... 4-23
5. Program Creation and Editing ................................ 5-1
5.1 CRBasic Editor .....................................................................................5-1
5.1.1 Overview..................................................................................... 5-1
5.1.2 Inserting Instructions................................................................... 5-2
5.1.2.1 Parameter Dialog Box .......................................................5-2
5.1.2.2 Right-Click Functionality .................................................. 5-4
5.1.3 Toolbar ........................................................................................ 5-5
5.1.3.1 Compile .............................................................................5-7
5.1.3.2 Compile, Save, and Send................................................... 5-8
5.1.3.3 Conditional Compile and Save ........................................ 5-11
5.1.3.4 Templates......................................................................... 5-11
5.1.3.5 Program Navigation using BookMarks and GoTo .......... 5-12
5.1.3.6 CRBasic Editor File Menu............................................... 5-12
5.1.3.7 CRBasic Editor Edit Menu .............................................. 5-13
5.1.3.8 CRBasic Editor View Menu ............................................ 5-13
5.1.3.9 CRBasic Editor Tools Menu............................................ 5-16
5.1.3.10 Available Help Information........................................... 5-19
ii
RTDAQ Table of Contents
5.1.4 CRBasic Programming ............................................................. 5-20
5.1.4.1 Programming Sequence................................................... 5-20
5.1.4.2 Program Declarations...................................................... 5-21
5.1.4.3 Mathematical Expressions............................................... 5-21
5.1.4.4 Measurement and Output Processing Instructions .......... 5-22
5.1.4.5 Line Continuation............................................................ 5-22
5.1.4.6 Inserting Comments Into Program .................................. 5-23
5.1.4.7 Example Program............................................................ 5-24
5.1.4.8 Data Tables...................................................................... 5-24
5.1.4.9 The Scan -- Measurement Timing and Processing.......... 5-26
5.1.4.10 Numerical Entries.......................................................... 5-27
5.1.4.11 Logical Expression Evaluation...................................... 5-27
5.1.4.12 Flags .............................................................................. 5-29
5.1.4.13 Parameter Types............................................................ 5-29
5.1.4.14 Program Access to Data Tables..................................... 5-30
5.2 Short Cut............................................................................................. 5-31
5.2.1 Overview................................................................................... 5-31
5.2.2 Creating a Program Using Short Cut ........................................ 5-32
5.2.2.1 Step 1 – Create a New File or Open Existing File .......... 5-33
5.2.2.2 Step 2 – Select Datalogger and Specify Scan Interval .... 5-33
5.2.2.3 Step 3 – Choose Sensors to Monitor ............................... 5-36
5.2.2.4 Step 4 – Setup Output Tables.......................................... 5-43
5.2.2.5 Step 5 – Generate the Program in the Format Required
by the Datalogger .................................................................. 5-46
5.2.3 Short Cut Settings ..................................................................... 5-47
5.2.3.1 Program Security............................................................. 5-47
5.2.3.2 Datalogger ID.................................................................. 5-47
5.2.3.3 Power-up Settings ........................................................... 5-47
5.2.3.4 Select CR200 Compiler................................................... 5-48
5.2.3.5 Sensor Support ................................................................ 5-48
5.2.3.6 Integration ....................................................................... 5-49
5.2.3.7 Font ................................................................................. 5-49
5.2.3.8 Set Working Directory .................................................... 5-49
5.2.3.9 Enable Creation of Custom Sensor Files......................... 5-49
5.2.4 Editing Programs Created by Short Cut.................................... 5-49
5.2.5 New Sensor Files ...................................................................... 5-50
5.2.6 Custom Sensor Files ................................................................. 5-50
5.3 Program Creation with the RTDAQ Program Generator ................... 5-50
5.3.1 Basic Operation......................................................................... 5-50
5.3.2 Program Startup ........................................................................ 5-51
5.3.3 Using the CR5000 or CR9000X Program Generator................ 5-52
5.3.4 Supporting Functionality .......................................................... 5-53
5.3.4.1 File | New ........................................................................ 5-53
5.3.4.2 File | Open… ................................................................... 5-53
5.3.4.3 File | Save As................................................................... 5-54
5.3.4.4 File | Edit Generator Program.......................................... 5-54
5.3.4.5 File | Open Wire Diagram ............................................... 5-54
5.3.4.6 File | <Previously opened programs>.............................. 5-55
5.3.4.7 File | Exit ......................................................................... 5-55
5.3.4.8 Edit | Color Options......................................................... 5-55
5.3.4.9 Edit | CR9000X Generator Options, Edit | CR5000
Generator Options ................................................................. 5-56
5.3.4.10 Help | Program Generator.............................................. 5-56
5.3.4.11 Help | About .................................................................. 5-56
iii
RTDAQ Table of Contents
6. View Pro.................................................................... 6-1
5.3.5 Using Save and Send................................................................. 5-56
5.3.5.1 Download ........................................................................5-57
5.3.5.2 Run Options..................................................................... 5-58
5.3.5.3 Datalogger Response ....................................................... 5-58
6.1 Overview............................................................................................... 6-1
6.2 The Toolbar........................................................................................... 6-2
6.3 Opening a File....................................................................................... 6-4
6.3.1 Opening a Data File .................................................................... 6-4
6.3.2 Opening Other Types of Files ..................................................... 6-4
6.3.3 Opening a File in Hexadecimal Format.......................................6-4
6.4 Viewing a LoggerNet Database Table .................................................. 6-4
6.4.1 Selecting a Database.................................................................... 6-5
6.4.2 Selecting a Table ......................................................................... 6-8
6.5 Importing a CSV File............................................................................ 6-9
6.6 Data View ...........................................................................................6-11
6.6.1 Column Size .............................................................................. 6-12
6.6.2 Header Information ................................................................... 6-12
6.6.3 Locking the TimeStamp Column .............................................. 6-12
6.6.4 File Information ........................................................................6-12
6.6.5 Background Color ..................................................................... 6-12
6.6.6 Font ...........................................................................................6-12
6.6.7 Window Arrangement............................................................... 6-13
6.7 Graphs................................................................................................. 6-13
6.7.1 Line Graph ................................................................................6-14
6.7.1.1 Selecting Data to be Graphed .......................................... 6-15
6.6.1.2 Graph Width .................................................................... 6-15
6.7.1.3 Scrolling ..........................................................................6-16
6.7.1.4 Graph Cursor ................................................................... 6-16
6.7.1.5 Line Graph Toolbar ......................................................... 6-17
6.7.2 Histogram.................................................................................. 6-18
6.7.2.1 Selecting Data to be Viewed ........................................... 6-20
6.7.2.2 Options ............................................................................6-21
6.7.2.3 Histogram Toolbar........................................................... 6-21
6.7.3 XY Plot ..................................................................................... 6-22
6.7.3.1 Selecting Data to be Plotted............................................. 6-23
6.7.3.2 Deleting a Series from an XY Plot .................................. 6-23
6.7.3.3 XY Plot Toolbar .............................................................. 6-23
6.7.4 Rainflow Histogram .................................................................. 6-24
6.7.4.1 Selecting Data to be View ............................................... 6-25
6.7.4.2 Options ............................................................................6-26
6.7.4.3 Rainflow Histogram Toolbar........................................... 6-26
6.7.5 FFT............................................................................................ 6-28
6.7.5.1 Selecting Data to be Graphed .......................................... 6-29
6.7.5.2 Options ............................................................................6-30
6.7.5.3 FFT Toolbar..................................................................... 6-30
6.8 Right-click-Menus ..............................................................................6-31
6.8.1 Data View.................................................................................. 6-31
6.8.2 Graphs ....................................................................................... 6-33
6.8.3 Traces ........................................................................................ 6-33
iv
RTDAQ Table of Contents
6.9 Printing Options.................................................................................. 6-33
6.9.1 Print Setup................................................................................. 6-33
6.9.2 Printing Text ............................................................................. 6-34
6.9.3 Printing Graphs ......................................................................... 6-34
6.10 View Pro Online Help ...................................................................... 6-34
6.11 Assigning Data Files to View ........................................................... 6-34
7. Monitoring Data in Real-time ...................................7-1
7.1 Using the Monitor Data Screen ............................................................ 7-1
7.1.1 Connect to Target Datalogger..................................................... 7-1
7.1.2 Selecting Items for Display in the Monitor Data Screen ............ 7-2
7.1.3 Using the Start/Stop Button ........................................................ 7-3
7.1.4 Customizing the Display of Data in the Monitor Data Screen.... 7-4
7.1.5 Setting the Monitor Data Screen Options ................................... 7-4
7.1.5.1 Display Tab ....................................................................... 7-5
7.1.5.2 Alarms Tab........................................................................ 7-6
7.1.5.3 Setup Tab .......................................................................... 7-7
7.1.6 Specialized Real-time Monitoring Screens................................. 7-7
7.2 Ports and Flags...................................................................................... 7-8
7.3 Table Monitor ....................................................................................... 7-9
7.3.1 Using the Table Monitor............................................................. 7-9
7.3.2 Displaying Tables on the Table Monitor .................................. 7-11
7.3.2.1 Start and Stop .................................................................. 7-11
7.3.2.2 Reset Table...................................................................... 7-12
7.3.2.3 Fields and Values ............................................................ 7-12
7.3.2.4 Save | Load Configurations ............................................. 7-13
7.3.2.5 Saving Displayed Data to a File ...................................... 7-13
7.3.3 Moving and Resizing the Table Monitor Window ................... 7-14
7.4 Real Time Graph................................................................................. 7-14
7.4.1 Using Graph Window ............................................................... 7-14
7.4.2 Adding Items for Display on the Graph.................................... 7-16
7.4.3 Moving and Resizing the Graph Window ................................ 7-16
7.4.4 Basic Graph Operation.............................................................. 7-16
7.4.5 Zooming and Scaling the Graph Window................................. 7-18
7.4.6 Data Retrieval Methods used by the Graph Screen .................. 7-19
7.4.7 Drawing Methods used by the Graph Screen............................ 7-20
7.4.8 Graph Window Display and Print Options ............................... 7-21
7.4.9 Setting the Options for the Graph Screen ................................. 7-22
7.4.9.1 Scaling the Axes.............................................................. 7-22
7.4.9.2 Data Display Options ...................................................... 7-23
7.4.9.3 Visual Display Options ................................................... 7-25
7.4.9.4 Customizing the Traces on the Display........................... 7-26
7.4.9.5 Using Saved Configurations............................................ 7-28
7.4.10 Accepting or Abandoning Changes to the Graph Options...... 7-29
7.5 Fast Graph........................................................................................... 7-29
7.5.1 Using the Fast Graph ................................................................ 7-29
7.5.2 Similarity between the Real Time Graph and the Fast Graph... 7-30
7.6 XY Plot............................................................................................... 7-30
7.6.1 Using the XY Plot..................................................................... 7-30
7.6.2 Setting up the XY Plot for Display ........................................... 7-32
7.6.2.1 Setting Values for Display .............................................. 7-32
7.6.2.2 Number of Points per Field ............................................. 7-34
7.6.2.3 Right-Click Functionality................................................ 7-35
7.6.3 Using the Control Buttons ........................................................ 7-36
v
RTDAQ Table of Contents
7.6.4 Using the Graphical Display Area of the XY Plot .................... 7-40
7.6.5 Zooming with the XY Plot........................................................ 7-41
7.6.6 Using the Special Options of the XY Plot................................. 7-42
7.6.6.1 Scaling Tab...................................................................... 7-43
7.6.6.2 Data Display Tab............................................................. 7-44
7.6.6.3 Visual Display Tab .......................................................... 7-45
7.6.6.4 Trace Tab......................................................................... 7-45
7.6.6.5 Save Tab .......................................................................... 7-47
7.6.7 Applying Changes to the XY Plot Screen................................. 7-48
7.7 Histogram Monitoring ........................................................................7-48
7.7.1 Histogram Overview ................................................................. 7-48
7.7.2 Displaying Histograms.............................................................. 7-49
7.8 Fast Fourier Transform Spectra ..........................................................7-50
7.8.1 Brief Overview of Fourier Analysis.......................................... 7-50
7.8.2 FFT vs. FFTSample................................................................... 7-51
7.8.3 Opening FFT Viewer Windows ................................................ 7-51
7.9 Configuration of FFT and Histogram Windows................................. 7-52
7.9.1 Moving and Resizing the FFT/Histo Window .......................... 7-53
7.9.2 Displaying FFT Spectra or Histograms..................................... 7-53
7.9.3 Using the Buttons...................................................................... 7-54
7.9.4 3D View .................................................................................... 7-55
7.9.5 X-Axis Mode............................................................................. 7-57
7.9.6 Zooming in on the Spectrum or Histogram............................... 7-58
7.9.7 Save and Print Options.............................................................. 7-58
7.9.8 Setting the Options for the FFT/Histogram Screen................... 7-60
7.9.8.1 Scaling the Axes .............................................................. 7-60
7.9.8.2 Data Display Options....................................................... 7-61
7.9.8.3 Visual Display Options.................................................... 7-62
7.9.8.4 Individual Trace Options................................................. 7-63
7.9.8.5 Using Saved Configurations............................................ 7-64
7.9.9 Accepting or Abandoning Changes to the FFT/Histogram
Options .........................................................................................7-65
7.10 Rainflow Histogram Monitoring....................................................... 7-66
7.10.1 Rainflow Histogram Overview ...............................................7-66
7.10.2 Opening Rainflow Histograms................................................ 7-66
7.10.3 Movement and Resizing of the Rainflow Window................. 7-68
7.10.4 Selecting Tables and Bins For Display ...................................7-68
7.10.5 Using the Buttons and Controls ..............................................7-69
7.10.6 X-Axis Mode........................................................................... 7-72
7.10.7 Zooming in on the Histogram .................................................7-72
7.10.8 Save and Print Options............................................................ 7-73
7.10.9 Setting the Options for the Rainflow Screen........................... 7-75
7.10.9.1 Scaling the Axes ............................................................ 7-75
7.10.9.2 Visual Display Options.................................................. 7-76
7.10.9.3 Trace Options ................................................................7-77
7.10.9.4 Using Saved Configurations.......................................... 7-78
7.10.10 Accepting or Abandoning Changes to the Rainflow
Options .........................................................................................7-79
7.11 Saving and Loading Configurations .................................................7-80
7.11.1 Saving and Loading Configuration Files for Real-Time
Data Screens ................................................................................. 7-80
7.11.2 Using Configurations in the Field Monitor ............................. 7-81
7.11.3 Using Configurations in the Table Monitors........................... 7-82
7.11.4 Saving and Loading Global Configuration Files..................... 7-82
vi
RTDAQ Table of Contents
8. Real-Time Monitoring and Control Software..........8-1
8.1 Development Mode .............................................................................. 8-1
8.1.1 The RTMC Workspace ............................................................... 8-3
8.1.2 Single Datalogger RTMC Projects ............................................. 8-3
8.1.3 Display Components................................................................... 8-3
8.1.4 Functions Available from the RTMC Menus.............................. 8-5
8.1.4.1 File Menu .......................................................................... 8-5
8.1.4.2 Edit Menu.......................................................................... 8-6
8.1.4.3 View Menu........................................................................ 8-6
8.1.4.4 Project Menu ..................................................................... 8-7
8.1.4.5 Screen Menu...................................................................... 8-7
8.1.4.6 Component Menu.............................................................. 8-8
8.1.4.7 Window Menu................................................................... 8-9
8.1.4.8 Help Menu......................................................................... 8-9
8.1.5 Expressions ................................................................................. 8-9
8.1.5.1 Operators ......................................................................... 8-12
8.1.5.2 Order of Precedence........................................................ 8-12
8.1.5.3 Predefined Constants....................................................... 8-13
8.1.5.4 Predefined Time Constants ............................................. 8-13
8.1.5.5 Functions ......................................................................... 8-13
8.1.5.6 Logical Functions............................................................ 8-15
8.1.5.7 String Functions .............................................................. 8-15
8.1.5.8 Conversion Functions...................................................... 8-16
8.1.5.9 Time Functions................................................................ 8-16
8.1.5.10 Start Option Functions .................................................. 8-16
8.1.5.11 Functions with State ...................................................... 8-17
8.2 RTMC Run-time................................................................................. 8-18
9. Calibration and Zeroing ...........................................9-1
9.1 Calibration Essentials ........................................................................... 9-1
9.1.1 Definition of Calibration............................................................. 9-1
9.1.2 Basic Calibration Process............................................................ 9-1
9.2 Writing Calibration Programs with the CRBasic Editor....................... 9-2
9.2.1 The FieldCal Instruction ............................................................. 9-2
9.2.2 Calibration File Details ............................................................... 9-3
9.3 Five Kinds of Calibration ..................................................................... 9-3
9.3.1 Zeroing........................................................................................ 9-3
9.3.2 Offset Calibration........................................................................ 9-4
9.3.3 Two-Point Multiplier and Offset Calibration.............................. 9-4
9.3.4 Two-Point Multiplier Only Calibration ...................................... 9-5
9.3.5 Zero Basis Point Calibration....................................................... 9-5
9.4 Performing a Manual Calibration ......................................................... 9-6
9.4.1 How to Use the Mode Variable for Calibration Status and
Control............................................................................................ 9-6
9.4.2 Using the Mode Variable for Manual Single-Point Calibration . 9-7
9.4.3 Using the Mode Variable for Manual Two-Point Calibration .... 9-7
9.5 Generating Calibration Programs ......................................................... 9-8
9.6 Using the Calibration Wizard with Running Programs ........................ 9-9
9.6.1 Calibration Wizard Basic Operation ........................................... 9-9
9.6.2 Using the Wizard to Perform Two-Point Multiplier and Offset
Calibrations .................................................................................... 9-9
9.6.3 Using the Wizard to Perform Zeroing Calibrations .................. 9-13
9.6.4 Using the Wizard to Perform Offset Calibrations..................... 9-15
9.7 Strain and Shunt Calibration............................................................... 9-16
vii
RTDAQ Table of Contents
10. Utilities .................................................................. 10-1
10.1 CardConvert...................................................................................... 10-1
10.1.1 Input/Output File Settings ....................................................... 10-1
10.1.2 Destination File Options.......................................................... 10-2
10.1.2.1 File Format ....................................................................10-2
10.1.2.2 File Processing............................................................... 10-3
10.1.2.3 File Naming ................................................................... 10-4
10.1.2.4 TOA5/TOB1 Format .....................................................10-4
10.1.3 Converting the File.................................................................. 10-5
10.1.4 Repairing/Converting Corrupted Files .................................... 10-5
10.1.5 Viewing a Converted File .......................................................10-6
10.1.6 Running CardConvert from a Command Line........................ 10-6
10.2 Device Configuration Utility ............................................................10-7
10.2.1 Overview................................................................................. 10-7
10.2.2 Main DevConfig Screen.......................................................... 10-8
10.2.3 Downloading an Operating System......................................... 10-9
10.2.4 Terminal Tab......................................................................... 10-11
10.2.5 The Unknown Device Type .................................................. 10-12
10.2.6 Off-line Mode........................................................................ 10-12
10.3 Split................................................................................................. 10-13
10.3.1 Functional Overview............................................................. 10-13
10.3.2 Getting Started ...................................................................... 10-14
10.3.3 Split Parameter File Entries................................................... 10-20
10.3.3.1 Input Files.................................................................... 10-20
10.3.3.2 Output Files ................................................................. 10-54
10.3.4 Help Option........................................................................... 10-60
10.3.5 Editing Commands................................................................ 10-61
10.3.6 Running Split From a Command Line .................................. 10-61
10.3.6.1 Splitr Command Line Switches................................... 10-61
10.3.6.2 Using Splitr.exe in Batch Files .................................... 10-62
10.3.6.3 Processing Alternate Files ........................................... 10-62
10.3.6.4 Processing Multiple Parameter Files with One
Command Line ........................................................................... 10-66
10.3.7 Log Files................................................................................ 10-66
10.4 Log Files and the LogTool Application.......................................... 10-67
10.4.1 Event Logging....................................................................... 10-67
10.4.1.1 Log Categories............................................................. 10-67
10.4.1.2 Log File Message Formats........................................... 10-68
10.4.2 CQR Log (RF Link) .............................................................. 10-84
10.5 SDM-CAN Helper Software........................................................... 10-84
Appendices
A. Campbell Scientific File Formats........................... A-1
A.1 PC File Data Formats.......................................................................... A-1
A.1.1 TOA5......................................................................................... A-1
A.1.2 TOB1......................................................................................... A-2
A.2 Datalogger Data Formats ....................................................................A-3
A.2.1 TOB2 or TOB3.......................................................................... A-3
A.3 Binary Data Value Types.................................................................... A-5
A.3.1 FP2 (2 Byte Low Resolution Format) ....................................... A-5
A.3.2 FP4 (4 Byte High Resolution Format)....................................... A-5
viii
RTDAQ Table of Contents
A.3.3 IEEE4........................................................................................ A-5
A.3.4 IEEE8........................................................................................ A-6
A.4 Converting Binary File Formats ......................................................... A-6
A.4.1 Split........................................................................................... A-6
A.4.2 CardConvert.............................................................................. A-6
B. Importing Files into Excel ...................................... B-1
B.1 Table-Based Data File Import (TOA5) ................................................B-1
Step 1 of 3.............................................................................................B-1
Step 2 of 3.............................................................................................B-2
Step 3 of 3.............................................................................................B-3
Figures
3.2-1. Typical Working Directories for RTDAQ ....................................... 3-3
Tables
5.1-1. Formats for Output Data................................................................. 5-26
5.1-2. Formats for Entering Numbers in CRBasic.................................... 5-27
5.1-3. Synonyms for True and False......................................................... 5-28
5.1-4. Rules for Names............................................................................. 5-29
9.2-1. The FieldCal Instruction “Family”................................................... 9-2
10.3-1. Comma Separated, Field Formatted, Printable ASCII, and
Table Oriented ASCII Input File Format Types................................ 10-21
10.3-2. Example of Event Driven Test Data Set..................................... 10-30
10.3-3. Processed Data File Using Option C.......................................... 10-31
10.3-4. Input File Entries to Process the First Data Point for each Test. 10-32
10.3-5. Effects of Out of Range Values for Given Output Options........ 10-34
10.3-6. Split Operators and Math Functions........................................... 10-36
10.3-7. Time Series Functions................................................................ 10-38
10.3-8. Split SPECIAL FUNCTIONS.................................................... 10-43
10-4-1. Transaction Log Messages......................................................... 10-69
10.4-2. Communication Status Log Messages........................................ 10-82
ix
RTDAQ Table of Contents
x

Preface — What's New in RTDAQ?

The most significant changes in RTDAQ 1.1 are in the Short Cut program generator. These include:
• A new Datalogger step has been added to the Progress panel. In this step,
you select the datalogger model and set the scan interval. When generating a program for a CR9000X, the CR9000X Configuration box also appears on this screen.
• When adding a sensor, if more than one of the selected sensor can be
added, the choice of how many sensors to add is included as part of the sensor’s form rather than as a separate dialog box.
• When adding more than one sensor, a dialog box is available that allows
you to input unique values for certain calibration and/or conversion factors (e.g., multiplier, offset, gage factor) for each sensor being measured.
• Each sensor form now includes a wiring tab that shows the wiring for the
sensor. This tab allows you to manually change the wiring location, if desired.
• For some sensors that require an excitation voltage, the sensor form now
includes parameters that allow you to calculate Sensors per Excitation Channel. (Exciting more than one sensor with an excitation channel is helpful when the sensors to be measured outnumber the available excitation channels.)
• An SC115 CS I/O-to-USB Flash Memory Drive check box has been added
to the Outputs screen. When this box is selected, new data will be copied to an SC115 when it is plugged into the CS I/O port of the datalogger.
• Selected Sensors are now shown in a tree format and branches of the tree
can be collapsed or expanded as desired. This can be especially useful when the Selected Sensor tree contains multiplexers.
• New Sensor files for the 03002 Wind Speed and Direction Sensor, 105E
(chromel-constantan) Thermocouple, the WindSonic1 (RS-232) Two­Dimensional Ultrasonic Wind Sensor, the WindSonic4 (SDI-12) Two­Dimensional Ultrasonic Wind Sensor, the HMP155 Temperature and Relative Humidity Sensor, the SR50A Sonic Ranging Sensor (SDI-12 Output), the CS450/455 Pressure Transducer, a Vibrating Wire Sensor (for generic vibrating wire sensors and the AVW200), the 27106T Wind Speed Sensor, the CS525 ISFET pH Probe, the CS650/655 Water Content Reflectometer, the CS506 Fuel Moisture Sensor, the NR-LITE2 Net Radiometer, the CNR4 Net Radiometer, a Quarter Bridge Strain Gage, the Geokon 4000/4050 Vibrating Wire Strain Gage, the Geokon 4100 Series Vibrating Wire Strain Gage, the Geokon 4420 Vibrating Wire Crackmeter, and the Geokon 4500 Series Vibrating Wire Piezometer.
xi
Preface — What's New in RTDAQ?
In addition to these Short Cut changes, RTDAQ has some changes including:
• The user can now select an image for the background of a Graph, Fast
• The Add, Delete, Delete All, and Trace Option buttons have been moved
• You can now edit fields in the Table Monitor.
• You can now toggle between data displays by pressing the data display
• A status bar has been added to the graphs to show the timestamp and
• The processing and displaying of data has been optimized in the Fast
• An option to provide feedback on RTDAQ has been added to the RTDAQ
Graph, or XY Plot.
to a toolbar on the Graph, Fast Graph, and XY Plot.
type button (e.g. Graph) on the toolbar with multiple data displays of that type already open.
record number of the last record.
Graph.
Toolbar’s Help menu.
Other applications included with RTDAQ have new features as described below:
CRBasic Editor
• A “Select .PCK Values” button has been added to the SDMCAN
instruction parameter dialog box in the CRBasic Editor. When pressed, the user can specify a PCK file from which to select the CAN-bus value to be returned. (PCK files are generated by the DBC to SDMCan converter.)
• The CRBasic Editor now gives you the option to Save and Encrypt a file.
Encrypted files can be compiled in the datalogger but cannot be read by a user.
• Dim variables can now be declared within a subroutine or function and are
local to that subroutine or function. The same variable name can be used within other subroutines or functions or as a global variable without conflict. The F9 and F10 pop-up pick list will include the local variables for a specific subroutine or function if the cursor is within that subroutine or function.
• F11 can now be used to bring up a pop-up pick list that contains all user-
defined functions found in the program.
• A new button has been added to the toolbar (blue arrow) which takes the
cursor to user-defined functions and subroutines.
• A new shortcut, CTRL-Y, has been added that will delete the current line.
• Several options have been added to the Editor Preferences dialog box
including: Variable Name Matching, Create .TDF File at Compile, Clear
xii
Preface — What's New in RTDAQ?
Undo/Redo List on File Save, Syntax Highlighting for Variables and Local Variables.
• The CRBasic Editor also now has the capability to open a read-only copy
of any file. This gives you the ability to open multiple copies of a program and examine multiple areas of a very large program at the same time.
• You can also now continue an instruction onto multiple lines by placing
the line continuation indicator (a single space followed by an underscore “_”) at the end of each line that is to be continued.
• The bookmarks in a CRBasic program are now persistent from session to
session.
• A new Constant Customization feature allows you to define values for one
or more constants in a program prior to performing a conditional compile.
• A Conditional Compile and Save option has been added that is used to
generate a new CRBasic program from code that uses conditional compile syntax (#If/Else/ElseIf statements) and/or Constant Customization.
RTMC
• RTMC has a new layout toolbar which gives quick access to the Align,
Space Evenly, Make Same Size, Center, and Order menu items from RTMC's Component menu.
• Many new functions have been added that may be used when building
expressions in RTMC. These include string functions, time functions, start option functions, and function with state. The ability to declare aliases for data values used in expressions has also been added.
• Graphics Options have been added to the Edit | Preferences menu item that
allow you to choose the maximum number of frames per second, whether animation is enabled, and whether high quality or high speed is more important. From this menu item, you can also choose the visual theme for RTMC. This determines the look and feel of the application (i.e. colors, button appearance, etc.). These options are available in both RTMC Development and RTMC Run-time.
• An Edit | Customize menu item has been added which allows you to
customize RTMC's toolbars and menus. This menu item is available in both RTMC Development and RTMC Run-time.
• Panning functionality has been added to charts in RTMC Run-time.
View Pro
• The ability to lock the timestamp column on the left of the data file has
been added to View Pro. This keeps the timestamp visible as you scroll through columns of data.
• PageUp and PageDown can now be used to scroll through a graph one
graph width at a time.
xiii
Preface — What's New in RTDAQ?
• The timestamp has been placed in the status bar and is displayed when the
• The Line Graph now has the ability to add a right Y-axis.
Device Configuration Utility
• The Device Configuration Utility has a new off-line mode which allows
Split
• Split has a new “Time Sync to First Record” option that can be used with
• Also, a range of time values rather than a single time can now be entered
CardConvert
• CardConvert can now be run from a command line without user
vertical cursor is used to step through values.
you to look at the settings for a certain device type without actually being connected to a device.
the time-sync function to avoid blank lines at the start of the output file.
in a Split Copy Condition.
interaction.
Miscellaneous other changes and bug fixes have also been implemented in this version.
xiv

Section 1. Introduction

RTDAQ (Real-time Data Acquisition) is a software application targeted to industrial and other high-speed data collection implementations which use Campbell Scientific’s dataloggers. RTDAQ replaces PC9000 as the company’s flagship product offering in the industrial marketplace. This software supports configuration, programming, communications, and data collection for the majority of dataloggers using the CRBasic datalogger programming language. Support is included for the CR800, CR850, CR1000, CR3000, CR5000, and CR9000X. RTDAQ runs on the Windows XP, Windows Vista, and Windows 7 platforms.
RTDAQ contains numerous improvements over the previous PC9000 product line. It features a new user-interface, including a look and feel similar to other Campbell Scientific datalogger software such as LoggerNet and PC400. Its underlying architecture uses the same communications server used by LoggerNet (the “LoggerNet Server”). This technology enables connection to PakBus dataloggers (including the CR1000 and CR3000) as well as tight integration with other Campbell Scientific products and utilities such as RTMC and PakBus Graph.
Datalogger communications technologies supported include “direct connect” (or RS-232 via local serial cable, short haul modems, or other “transparent” links), telephone, TAPI, TCP/IP, VHF/UHF radios, RF400-series spread spectrum radios, and multidrop interfaces (MD9 and MD485).
RTDAQ represents a significant milestone in bringing ease of use, improved datalogger support, and configurable data monitoring to Campbell Scientific’s industrial customer base. Customized data monitoring is accomplished via graphical real-time windows and specialized engineering displays. RTDAQ is an ideal solution for users desiring high-speed data collection over a single telecommunications medium, but who do not rely on scheduled data collection.
1-1
Section 1. Introduction

1.1 RTDAQ Overview

1.1.1 Main Screen

The main screen of RTDAQ provides three tabs with datalogger interaction functions (Clock/Program, Monitor Data, and Collect Data), as well as a toolbar with buttons to launch frequently-used utilities and auxiliary applications.
The toolbar includes utilities for working with data files (View Pro, Split, and CardConvert) as well as utilities for generating and editing datalogger programs (Short Cut, CRBasic, and the CR5000/CR9000X Program Generator). Datalogger setup and status functions are also available, along with access to RTMC (Real-time Monitoring and Control) applications. You can also launch the Device Configuration Utility which is used to send new operating systems to dataloggers and other peripheral devices, and to configure settings in the dataloggers and other devices. All of the toolbar functionality is also accessible from the RTDAQ menu, along with other tools, such as the Terminal Emulator, PakBus Graph, and LogTool (a program for viewing and storing communication logs). Each application includes extensive, online help.
Some utilities installed with RTDAQ can be opened independently from the main RTDAQ program by using the Windows Start Menu item Programs | RTDAQ | Utilities. These utilities include the Device Configuration Utility (or DevConfig), View Pro, and CardConvert. DevConfig is described above. View Pro enables the viewing and graphing of collected data, and CardConvert converts data files originating from removable card storage into other useful formats.
1-2

1.1.2 Clock/Program and the EZSetup Wizard

Setting up the RTDAQ datalogger network is a relatively simple process with the EZSetup Wizard, which guides you through the steps necessary to add and enter settings for dataloggers. Once a datalogger is added to the list, you
Section 1. Introduction
can choose the Edit Datalogger button change those settings. Progress through the Wizard is shown on the left side of the screen, with steps for choosing a datalogger, defining the communications path between the computer and the datalogger, fine tuning settings for the datalogger (e.g., baud rate or security code), testing communications, checking or setting the clock, and finally sending a program or viewing a program file which is already running. After a datalogger has been added, you can select and connect to that datalogger from the Clock/Program tab via point and click operations.
to activate the Wizard again and

1.1.3 Monitor Data

Once you’ve added and connected to a datalogger, the Monitor Data tab switches to a view that lets you monitor the latest values measured on the datalogger. You can monitor variables as they are updated after each execution of the datalogger program scan or monitor the latest data items that have been stored into the datalogger’s tables.
The Monitor Data tab also lets you edit public variables directly, or view data using several available real-time monitors.
1.1.3.1 Real-time Monitors
RTDAQ has a variety of windows for viewing datalogger data in near real­time. After the Monitor Data tab is selected, these options show as buttons which open separate windows when pressed.
1-3
Section 1. Introduction
• The status of ports, flags, or any boolean variables can be monitored and
controlled within the Ports and Flags window.
• The Table Monitor allows quick numeric viewing of entire output tables.
• With both the Graph and Fast Graph, graphical data traces from a
datalogger can be monitored in a window width as small as 1 millisecond, with resolution support for individual points up to 100 KHz.
1-4
• The XY Plot allows up to four values to be plotted against another
measured value (other than the timestamp).
• With the Fast Fourier Transform viewer, both single-valued (amplitude
or power spectrum) and dual-valued (real-imaginary or amplitude-phase) FFT spectra can be viewed.
Section 1. Introduction
• Histograms calculated by the datalogger can be shown as they are made
available by program calculations and storage.
• Display of rainflow-style histograms is also supported using the Rainflow
viewer. This display works with programs utilizing the Rainflow output instruction in the CRBasic datalogger program.
1-5
Section 1. Introduction

1.1.4 Collect Data

Once a program is storing data in the datalogger you can collect a copy of that data to a file on the PC. The Collect Data tab shows a list of tables in the datalogger as defined by the currently running program. You can retrieve the uncollected data, appending it to a file on the PC, or you can retrieve all of the data from the datalogger. You can also use other custom configurations for the collection. The Change File Name button lets you choose a folder and file name in which to store the data.
1-6
Section 1. Introduction

1.1.5 Field Calibration and the Calibration Wizard

RTDAQ includes the Calibration Wizard for performing real-time, non­intrusive calibration of measurements. Datalogger programs that use the FieldCal CRBasic instruction activate this Wizard for use. This feature allows calibration to occur within a simple interface, instead of requiring manual calibration via the numeric displays or with the keypad display at the datalogger site.

1.1.6 RTMC Development, Run-time and Pro Development

Seamless integration with the RTMC and RTMC Pro product line allows creation of data monitoring and control screens for individual dataloggers.
Custom screens are created using the RTMC Development program
RTMC Pro Development program
.
or the
1-7
Section 1. Introduction
Execution of these screens is done with the RTMC Run-time program. Both programs can be started using buttons from the main RTDAQ interface.

1.1.7 View Pro

The Standard RTMC Development and RTMC Run-time applications are included with RTDAQ. RTMC Pro must be purchased and installed separately from RTDAQ, but will operate within the RTDAQ environment after installation.
RTDAQ includes View Pro, the “professional” version of Campbell
Scientific’s newly-updated data viewing application. View Pro examine data files (*.DAT files) collected onto the PC from the datalogger, and displays data in either comma-separated or tabular format, record by record. A graph can be displayed showing multiple traces (columns) of data. This program also allows the viewing of specialized data records such as FFT spectra and histograms.
lets you
1-8
Section 1. Introduction
View Pro can be launched from a button on RTDAQ’s main screen. View Pro is a simple analysis tool, and includes some basic printing and export capabilities.

1.1.8 Split

Split is a stand-alone application used to post-process data files on the PC and generate reports. A button on RTDAQ’s main screen launches the Split
application file, perform calculations, and change date/time formats. Split can create reports or new files for input to other data analysis and display applications, including HTML formats.

1.1.9 CardConvert

CardConvert is a utility to retrieve binary data from Compact Flash cards containing program output data, and convert the data to an ASCII file or other useful formats.

1.1.10 Short Cut

Short Cut is a datalogger program “generator.” You select the datalogger
type, sensors, and desired outputs, and then Short Cut program file to send to the datalogger. Users don’t need to learn about the individual programming instructions generated within the datalogger program. Short Cut includes support for multiplexers and a limited number of other peripherals, and also provides a wiring diagram that you can print to leave in the field with the datalogger.
. It can be used to merge data from multiple stations into one
creates a simple
1-9
Section 1. Introduction
Short Cut is also an excellent way to learn about the CRBasic programming language. The CRBasic programs created by Short Cut can be loaded directly into the CRBasic Editor for inspection or editing.

1.1.11 CRBasic Editor

The CRBasic Editor is a program editor for CRBasic datalogger programs, including programs for the CR800, CR850, CR1000, CR3000, CR5000, and CR9000X. It is used to manually create programs or to edit existing or generated programs.
Program instructions are defined within the editor for variable declarations, data table configuration, measurements and control operations, numeric processing, logical operations, data output, and program control. Extensive assistance and program examples are provided in the online help system.

1.1.12 CR5000/CR9000X Program Generators

RTDAQ includes updated versions of the program generators for the
CR9000X and CR5000
which were previously available in PC9000.
1-10
Section 1. Introduction
CR9000X and CR5000 programs can be generated using a detailed, instruction-level interface resulting in extensive control over generated programs.

1.2 Getting Help for RTDAQ Applications

Detailed descriptions of each application or tool are included in later sections of this manual. Each application also has its own built-in help system. Context sensitive help for an application can usually be accessed by moving the focus to (i.e., clicking on) a particular item and pressing the F1 key or by selecting Help from the application's menu.
Contact your Campbell Scientific representative if you are unable to resolve your questions after reviewing the above noted resources.

1.3 Windows Conventions

There are numerous conventions and expectations about the way a software program looks and behaves when running under Microsoft Windows. Campbell Scientific has adopted many of these conventions in RTDAQ.
This manual describes a collection of screens, dialogs, and functions to interoperate with Campbell Scientific’s dataloggers. As with most Windows­based software there is usually more than one way to access each function. We encourage you to look around and experiment with different options to find which methods work best for you.
To keep this manual as concise and readable as possible, we will not always list all of the methods for getting to every function. Typically each function will have two methods of access and some will have as many as four.
1-11
Section 1. Introduction
The most common methods for accessing functionality are:
Menus – Text menus are displayed at the top of most windows. Menu items are accessed either by a left mouse click, or using a hot key combination (e.g., Alt+F opens the File menu). When the menu is opened, you can click on an item to select it, or use arrow keys to highlight it and press the Enter key, or just type the underlined letter.
By convention, menu items that bring up dialog boxes or new windows requiring interaction will be followed by an ellipsis (…). Other items execute functions directly or can be switched on or off. Some menu items show a check mark if a function is enabled and no check mark if disabled.
Items with Program Focus – On each screen one button, text area, or other control is selected at a time to “have the focus.” The “Focus” is usually indicated when the item is surrounded by a dotted line or is bolded. Pressing the tab key can move the focus from item to item. Typing text changes a selected text edit box that has the focus. Pressing the space bar toggles a selected check box. A selected button can also be activated by pressing the Enter key.
Buttons – Buttons are an easy way to access a function. They are normally used for the functions that need to be called frequently or are very important. Clicking a button executes that function or brings up another window. Button functions can also be accessed from the keyboard using the tab key to move among items on a screen and pressing the Enter key to execute the button function. Most text-based buttons have a hot-key.
Right-Click Menus – Some areas have pop-up menus that bring up frequently used tasks or provide shortcuts. Just right-click on an area and if a context menu appears, left-click the menu item you want.
Hot Keys or Keyboard Shortcuts – Many of the menus and buttons can be accessed using Hot Keys. An underlined letter identifies the hot key for a button or function. To get to a menu or execute a function on a button hold down the Alt key and type the underlined letter in the menu name or the button text. The hot key letters may not appear until after you’ve pressed the Alt key.
Pop-Up Hints – Hints are available for many of the on-screen controls. Let the mouse pointer hover over a control, text box or other screen feature and the hint will appear automatically and remain visible for a few seconds. These hints will often explain the purpose of a control or a suggested action. For text boxes where some of the text is hidden, the full text will appear in the hint.
1-12
Loading...
+ 338 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use