How it Works
Campbell
Loading...
LoggerNet 4.2
Instruction Manual
580 pgs12.31 Mb0

Campbell LoggerNet, LoggerNet 4.2 Instruction Manual

LoggerNet
Version 4.2
Revision: 7/13
Copyright © 1999-2013
Campbell Scientific, Inc.
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.
This software may not be sold, included or redistributed in any other software, or altered in any way without prior written permission from Campbell Scientific. All copyright notices and labeling must be left intact.
Limited Warranty
The following warranties are in effect for ninety (90) days from the date of shipment of the original purchase. These warranties are not extended by the installation of upgrades or patches offered free of charge.
Campbell Scientific warrants that the installation media on which the software is recorded and the documentation provided with it are free from physical defects in materials and workmanship under normal use. The warranty does not cover any installation media that has been damaged, lost, or abused. You are urged to make a backup copy (as set forth above) and record the CD key to protect your investment. Damaged or lost media is the sole responsibility of the licensee and will not be replaced by Campbell Scientific.
Campbell Scientific warrants that the software itself will perform substantially in accordance with the specifications set forth in the instruction manual when properly installed and used in a manner consistent with the published recommendations, including recommended system requirements. Campbell Scientific does not warrant that the software will meet licensee’s requirements for use, or that the software or documentation are error free, or that the operation of the software will be uninterrupted.
Campbell Scientific will either replace or correct any software that does not perform substantially according to the specifications set forth in the instruction manual with a corrected copy of the software or corrective code. In the case of significant error in the installation media or documentation, Campbell Scientific will correct errors without charge by providing new media, addenda, or substitute pages. If Campbell Scientific is unable to replace defective media or documentation, or if it is unable to provide corrected software or corrected documentation within a reasonable time, it will either replace the software with a functionally similar program or refund the purchase price paid for the software.
All warranties of merchantability and fitness for a particular purpose are disclaimed and excluded. Campbell Scientific shall not in any case be liable for special, incidental, consequential, indirect, or other similar damages even if Campbell Scientific has been advised of the possibility of such damages. Campbell Scientific is not responsible for any costs incurred as a result of lost profits or revenue, loss of use of the software, loss of data, cost of re-creating lost data, the cost of any substitute program, telecommunication access costs, claims by any party other than licensee, or for other similar costs.
This warranty does not cover any software that has been altered or changed in any way by anyone other than Campbell Scientific. Campbell Scientific is not responsible for problems caused by computer hardware, computer operating systems, or the use of Campbell Scientific’s software with non-Campbell Scientific software.
Licensee’s sole and exclusive remedy is set forth in this limited warranty. Campbell Scientific’s aggregate liability arising from or relating to this agreement or the software or documentation (regardless of the form of action; e.g., contract, tort, computer malpractice, fraud and/or otherwise) is limited to the purchase price paid by the licensee.
Table of Contents
PDF viewers: These page numbers refer to the printed version of this document. Use the PDF reader bookmarks tab for links to specific sections.
Preface — What’s New in LoggerNet 4?...........................xv
1. System Requirements .............................................1-1
1.1 Hardware and Software.................................................................... 1-1
1.2 Configuration of TCP/IP Service ..................................................... 1-1
2. Installation, Operation and Backup Procedures...2-1
2.1 CD-ROM Installation....................................................................... 2-1
2.2 Upgrade Notes.................................................................................. 2-2
2.3 LoggerNet Operations and Backup Procedures ............................... 2-2
2.3.1 LoggerNet Directory Structure and File Descriptions............... 2-3
2.3.1.1 Program Directory.......................................................... 2-3
2.3.1.2 Working Directories....................................................... 2-3
2.3.2 Backing up the Network Map and Data Files ........................... 2-5
2.3.2.1 Performing a Manual Backup......................................... 2-5
2.3.2.2 Performing Scheduled Backups ..................................... 2-6
2.3.2.3 Performing Backups from the Task Master.................... 2-6
2.3.2.4 Restoring the Network from a Backup File.................... 2-7
2.3.3 Loss of Computer Power........................................................... 2-7
2.3.4 Program Crashes ....................................................................... 2-8
2.4 Installing/Running LoggerNet as a Service...................................... 2-8
2.4.1 Issues with Running LoggerNet as a Service............................ 2-9
2.4.1.1 Write Access .................................................................. 2-9
2.4.1.2 Network Drives ............................................................ 2-10
2.5 Special Note on Windows XP Service Pack 2 ............................... 2-10
3. Introduction..............................................................3-1
3.1 What is LoggerNet? ......................................................................... 3-1
3.1.1 What Next? ............................................................................... 3-1
3.2 Overview of Major LoggerNet Functions and Associated
Software Applications .................................................................. 3-2
3.2.1 The Heart of it All – LoggerNet Toolbar .................................. 3-2
3.2.1.1 Toolbar Views................................................................ 3-2
3.2.1.2 Favorites Category ......................................................... 3-3
3.2.1.3 Toolbar Menus ............................................................... 3-4
3.2.1.4 Command Line Arguments ............................................ 3-4
3.2.1.5 Alternate Language Support........................................... 3-5
3.2.2 LoggerNet Admin/LoggerNet Remote...................................... 3-6
3.2.3 Setting Up Datalogger Communication Networks.................... 3-6
3.2.4 Real Time Tools........................................................................ 3-7
3.2.5 Network Status and Problem Solving ....................................... 3-7
3.2.6 Network Management Tools..................................................... 3-8
3.2.7 Creating and Editing Datalogger Programs .............................. 3-8
3.2.8 Working with Data Files ........................................................... 3-9
i
Table of Contents
3.2.9 Automating Tasks with Task Master....................................... 3-10
3.2.10 Managing External Data Storage Devices............................... 3-10
3.2.11 Optional Client Products Compatible with LoggerNet ...........3-10
3.2.11.1 LoggerNetData ............................................................. 3-10
3.2.11.2 Data Display Clients..................................................... 3-11
3.2.11.3 Baler ............................................................................. 3-11
3.2.11.4 CSIOPC Server (PC-OPC) ........................................... 3-11
3.2.11.5 Software Development Kit ........................................... 3-11
3.3 Getting Help for LoggerNet Applications ...................................... 3-11
4. Setting up Datalogger Networks............................ 4-1
4.1 Setup Screen – EZ View (EZSetup Wizard) ....................................4-1
4.2 Setup Screen — Standard View .......................................................4-3
4.2.1 Adding Devices to the Network ................................................ 4-4
4.2.2 Applying Changes, Undo and Redo ..........................................4-6
4.2.3 Renaming Network Devices...................................................... 4-7
4.2.4 Device Settings.......................................................................... 4-7
4.2.4.1 ComPort.......................................................................... 4-7
4.2.4.2 IPPort (Internet Protocol Serial Port).............................. 4-8
4.2.4.3 TAPIPort (Telephony API)............................................. 4-9
4.2.4.4 Datalogger .................................................................... 4-11
4.2.4.4.1 Hardware Tab .................................................... 4-11
4.2.4.4.2 Schedule Tab...................................................... 4-13
4.2.4.4.3 Final Storage Area 1 and 2 Tab (Edlog Dataloggers with Mixed-array Operating
System)........................................................... 4-17
4.2.4.4.4 Data Files Tab (CRBasic Dataloggers, and Edlog Dataloggers with Table Data and
PakBus Operating systems)............................ 4-18
4.2.4.4.5 Clock Tab........................................................... 4-21
4.2.4.4.6 Program Tab ...................................................... 4-22
4.2.4.4.7 File Retrieval Tab (CR1000, CR3000, CR800 Series, and Edlog Dataloggers with PakBus
Operating Systems) ........................................ 4-22
4.2.4.5 PhoneBase .................................................................... 4-23
4.2.4.6 PhoneRemote................................................................ 4-24
4.2.4.7 RFBase ......................................................................... 4-25
4.2.4.8 RFRemote..................................................................... 4-26
4.2.4.9 RFBase-TD................................................................... 4-27
4.2.4.10 RF RemoteTD .............................................................. 4-31
4.2.4.11 RFRemote-PB............................................................... 4-31
4.2.4.12 MD9 Base..................................................................... 4-32
4.2.4.13 MD9 Remote ................................................................ 4-34
4.2.4.14 RF400 ........................................................................... 4-35
4.2.4.15 RF400 Remote.............................................................. 4-36
4.2.4.16 Generic Modem............................................................ 4-38
4.2.4.17 PakBusPort ................................................................... 4-39
4.2.4.18 PakBus Router.............................................................. 4-42
4.2.4.19 PakBusPort HD ............................................................ 4-43
4.2.4.20 PakBusTcpServer ......................................................... 4-44
4.2.4.21 SerialPortPool............................................................... 4-46
4.2.4.22 TerminalPortPool..........................................................4-49
4.2.5 Setting Up Scheduled Data Collection .................................... 4-52
4.2.5.1 Data Collection Scheduling Considerations ................. 4-52
4.2.5.2 Intervals........................................................................ 4-53
ii
Table of Contents
4.2.5.2.1 Datalogger Program Intervals............................ 4-53
4.2.5.2.2 Data Collection Setting Intervals....................... 4-53
4.2.5.2.3 Communications Path Considerations............... 4-54
4.2.5.3 Setting Up Scheduled Data Collection ......................... 4-54
4.2.6 Setting the Clock..................................................................... 4-56
4.2.7 Sending a Program to the Datalogger from Setup................... 4-57
4.2.8 Setup’s Tools Menu ................................................................ 4-57
4.2.8.1 LoggerNet Server Settings ........................................... 4-57
4.2.8.1.1 LoggerNet Settings............................................ 4-57
4.2.8.1.2 PakBus Settings ................................................. 4-58
4.2.8.1.3 LoggerNet Defaults ........................................... 4-58
4.2.8.1.4 IPManager Settings............................................ 4-58
4.2.8.1.4.1 Troubleshooting Tips ......................................... 4-59
4.2.8.2 Copy Device Settings ................................................... 4-59
4.2.8.3 Troubleshooter ............................................................. 4-60
4.2.9 Setup’s Backup Menu ............................................................. 4-60
4.2.10 Selecting a Remote Server ...................................................... 4-60
4.2.11 Selecting a View ..................................................................... 4-60
4.3 Network Planner............................................................................. 4-62
4.3.1 Functional Overview............................................................... 4-62
4.3.2 The Drawing Canvas............................................................... 4-62
4.3.2.1 Adding a Background Image........................................ 4-63
4.3.2.2 Scrolling the Drawing Canvas...................................... 4-63
4.3.2.3 Changing the Canvas Scale .......................................... 4-65
4.3.3 Adding Stations to the Network.............................................. 4-65
4.3.4 Adding Peripherals to a Station............................................... 4-65
4.3.5 Adding Stations Links............................................................. 4-66
4.3.6 Adding Activities .................................................................... 4-68
4.3.7 The Station Summary.............................................................. 4-71
4.3.8 Configuring Devices ............................................................... 4-72
4.3.8.1 Configuring Using the Device Configuration
Protocol..................................................................... 4-73
4.3.8.1.1 Avoiding Conflicts with the LoggerNet
Server ............................................................. 4-74
4.3.8.1.2 Settings Generated............................................. 4-75
4.3.8.2 Configuring a LoggerNet Server.................................. 4-75
4.3.9 Saving Your Work .................................................................. 4-78
4.3.10 Arranging Screen Components ............................................... 4-79
4.4 Device Configuration Utility.......................................................... 4-79
5. Real-Time Tools .......................................................5-1
5.1 The Connect Screen ......................................................................... 5-1
5.1.1 Connecting to the Datalogger — or Not ................................... 5-1
5.1.2 Data Collection ......................................................................... 5-3
5.1.2.1 Collect Now ................................................................... 5-3
5.1.2.2 Custom Collection.......................................................... 5-4
5.1.2.2.1 Mixed-array Dataloggers..................................... 5-4
5.1.2.2.2 Table-based Dataloggers ..................................... 5-5
5.1.3 Ports and Flags.......................................................................... 5-8
5.1.4 Datalogger Clock .................................................................... 5-10
5.1.5 Program Management ............................................................. 5-11
5.1.5.1 Sending a Datalogger Program..................................... 5-11
5.1.5.2 CR200 Series Programs................................................ 5-12
5.1.5.3 Retrieving Datalogger Programs.................................. 5-12
5.1.6 Program Association ............................................................... 5-12
iii
Table of Contents
5.1.7 Data Displays .......................................................................... 5-13
5.1.7.1 Data Display Limitations.............................................. 5-14
5.1.7.2 Numeric Display Screens ............................................. 5-14
5.1.7.2.1 Adding and Removing Values........................... 5-15
5.1.7.2.2 Display Options ................................................. 5-17
5.1.7.2.3 Right Click Menu Options ................................. 5-18
5.1.7.3 Graphical Display Screens............................................ 5-18
5.1.7.3.1 Displaying Values on a Graph ........................... 5-19
5.1.7.3.2 Graph Options.................................................... 5-20
5.1.7.3.3 Trace Options..................................................... 5-25
5.1.7.3.4 Right Click Menu Options ................................. 5-26
5.1.7.3.5 Additional Capabilities ...................................... 5-28
5.1.8 Table Monitor.......................................................................... 5-28
5.1.9 File Control for CR5000, CR1000, CR800 Series, CR3000,
and CR9000 Dataloggers..................................................... 5-29
5.1.10 Terminal Emulator .................................................................. 5-33
5.1.11 Station Status........................................................................... 5-34
5.1.12 Calibration Wizard .................................................................. 5-35
5.2 Real-Time Monitoring and Control................................................ 5-36
5.2.1 Development Mode ................................................................. 5-36
5.2.1.1 The RTMC Workspace................................................. 5-37
5.2.1.2 Display Components..................................................... 5-38
5.2.1.3 Functions Available from the RTMC Menus ............... 5-39
5.2.1.4 Expressions................................................................... 5-44
5.2.1.4.1 Operators............................................................ 5-46
5.2.1.4.2 Order of Precedence........................................... 5-47
5.2.1.4.3 Predefined Constants ......................................... 5-47
5.2.1.4.4 Predefined Time Constants ................................ 5-47
5.2.1.4.5 Functions............................................................ 5-48
5.2.1.4.6 Logical Functions .............................................. 5-49
5.2.1.4.7 String Functions................................................. 5-50
5.2.1.4.8 Conversion Functions ........................................ 5-50
5.2.1.4.9 Time Functions .................................................. 5-51
5.2.1.4.10 Start Option Functions ....................................... 5-51
5.2.1.4.11 Statistical Functions........................................... 5-52
5.2.1.5 Remote Connection ...................................................... 5-53
5.2.2 RTMC Run-Time ....................................................................5-53
6. Network Status and Resolving Communication
Problems ............................................................... 6-1
6.1 Status Monitor .................................................................................. 6-1
6.2 LogTool.......................................................................................... 6-12
6.1.1 Visual Status Indicators............................................................. 6-2
6.1.2 Status Monitor Functions .......................................................... 6-3
6.1.2.1 Selecting Columns.......................................................... 6-3
6.1.2.2 Display/Subnet ............................................................... 6-8
6.1.2.3 Toggle Collection On/Off............................................... 6-8
6.1.2.4 Reset Device................................................................... 6-8
6.1.2.5 Collect Now/Stop Collection.......................................... 6-8
6.1.2.6 Pool Statistics ................................................................. 6-9
6.1.2.7 Pool Devices................................................................. 6-10
6.1.2.8 State of Operations ....................................................... 6-10
6.2.1 Log Types................................................................................ 6-13
6.2.2 Using LogTool ........................................................................ 6-13
iv
Table of Contents
6.2.3 Saving Logs to File ................................................................. 6-14
6.3 Comm Test..................................................................................... 6-15
6.4 PakBus Graph ................................................................................ 6-16
6.4.1 Selecting the PakBus Network to View .................................. 6-17
6.4.2 Dynamic and Static Links ....................................................... 6-17
6.4.3 Viewing/Changing Settings in a PakBus Datalogger.............. 6-17
6.4.4 Right-Click Functionality ....................................................... 6-18
6.4.5 Discovering Probable Routes between Devices...................... 6-18
6.5 Troubleshooter ............................................................................... 6-18
6.5.1 Status Information................................................................... 6-19
6.5.2 Buttons.................................................................................... 6-20
6.5.3 Archiving Troubleshooter Results .......................................... 6-26
6.5.4 Other Tools in Troubleshooter................................................ 6-27
6.6 LoggerNet Server Monitor............................................................. 6-27
7. Creating and Editing Datalogger Programs ..........7-1
7.1 Review of CSI Datalogger Models .................................................. 7-1
7.2 Short Cut .......................................................................................... 7-2
7.2.1 Overview................................................................................... 7-2
7.2.2 Creating a Program Using Short Cut ........................................ 7-3
7.2.2.1 Step 1 – Create a New File or Open Existing File.......... 7-3
7.2.2.2 Step 2 – Select Datalogger and Specify Scan Interval ... 7-4
7.2.2.3 Step 3 – Choose Sensors to Monitor .............................. 7-7
7.2.2.4 Step 4 – Setup Output Tables ....................................... 7-14
7.2.2.5 Step 5 – Generate the Program in the Format
Required by the Datalogger...................................... 7-17
7.2.3 Short Cut Settings ................................................................... 7-18
7.2.3.1 Program Security.......................................................... 7-18
7.2.3.2 Datalogger ID............................................................... 7-18
7.2.3.3 Power-up Settings ........................................................ 7-18
7.2.3.4 Select CR200 Compiler................................................ 7-19
7.2.3.5 Sensor Support ............................................................. 7-19
7.2.3.6 Integration .................................................................... 7-20
7.2.3.7 Font .............................................................................. 7-20
7.2.3.8 Set Working Directory ................................................. 7-20
7.2.3.9 Enable Creation of Custom Sensor Files...................... 7-20
7.2.4 Editing Programs Created by Short Cut.................................. 7-20
7.2.5 New Sensor Files .................................................................... 7-21
7.2.6 Custom Sensor Files................................................................ 7-21
7.3 CRBasic Editor............................................................................... 7-21
7.3.1 Overview................................................................................. 7-21
7.3.2 Inserting Instructions............................................................... 7-22
7.3.2.1 Parameter Dialog Box .................................................. 7-22
7.3.2.2 Right-Click Functionality............................................. 7-24
7.3.3 Toolbar.................................................................................... 7-25
7.3.3.1 Compile........................................................................ 7-27
7.3.3.2 Compile, Save, and Send.............................................. 7-27
7.3.3.3 Conditional Compile and Save..................................... 7-31
7.3.3.4 Templates ..................................................................... 7-31
7.3.3.5 Program Navigation using BookMarks and GoTo ....... 7-32
7.3.3.6 CRBasic Editor File Menu ........................................... 7-32
7.3.3.7 CRBasic Editor Edit Menu........................................... 7-33
7.3.3.7.1 Other Options .................................................... 7-33
7.3.3.8 CRBasic Editor View Menu......................................... 7-33
7.3.3.8.1 Editor Preferences.............................................. 7-33
v
Table of Contents
7.3.3.8.2 Instruction Panel Preferences............................. 7-35
7.3.3.8.3 Other Options..................................................... 7-35
7.3.3.9 CRBasic Editor Tools Menu......................................... 7-36
7.3.3.9.1 Edit Instruction Categories ................................ 7-36
7.3.3.9.2 Constant Customization..................................... 7-37
7.3.3.9.3 Other Options..................................................... 7-39
7.3.3.10 Available Help Information.......................................... 7-40
7.3.4 CRBasic Programming............................................................ 7-40
7.3.4.1 Programming Sequence................................................ 7-40
7.3.4.2 Program Declarations ................................................... 7-41
7.3.4.3 Mathematical Expressions............................................ 7-42
7.3.4.4 Measurement and Output Processing Instructions........ 7-42
7.3.4.5 Line Continuation......................................................... 7-43
7.3.4.6 Inserting Comments Into Program................................7-43
7.3.4.7 Example Program ......................................................... 7-44
7.3.4.8 Data Tables................................................................... 7-44
7.3.4.9 The Scan — Measurement Timing and Processing...... 7-46
7.3.4.10 Numerical Entries......................................................... 7-47
7.3.4.11 Logical Expression Evaluation..................................... 7-47
7.3.4.11.1 What is True?..................................................... 7-47
7.3.4.11.2 Expression Evaluation ....................................... 7-48
7.3.4.11.3 Numeric Results of Expression Evaluation........ 7-48
7.3.4.12 Flags ............................................................................. 7-49
7.3.4.13 Parameter Types ........................................................... 7-49
7.3.4.13.1 Expressions in Parameters .................................7-49
7.3.4.13.2 Arrays of Multipliers and Offsets for Sensor
Calibration...................................................... 7-50
7.3.4.14 Program Access to Data Tables.................................... 7-50
7.4 Edlog .............................................................................................. 7-51
7.4.1 Overview................................................................................. 7-51
7.4.1.1 Precompiler................................................................... 7-51
7.4.1.2 Context-sensitive Help ................................................. 7-52
7.4.1.3 Programming Efficiency............................................... 7-52
7.4.1.4 Input Location Labels................................................... 7-52
7.4.1.5 Final Storage Label Editor............................................ 7-52
7.4.1.6 Expression Compiler .................................................... 7-52
7.4.2 Creating a New Edlog Program............................................... 7-53
7.4.2.1 Program Structure......................................................... 7-54
7.4.2.2 Edlog File Types........................................................... 7-55
7.4.2.3 Inserting Instructions into the Program ........................7-56
7.4.2.4 Entering Parameters for the Instructions ......................7-57
7.4.2.5 Program Comments ...................................................... 7-57
7.4.2.6 Expressions................................................................... 7-58
7.4.2.7 Editing an Existing Program......................................... 7-63
7.4.2.8 Editing Comments, Instructions, and Expressions .......7-65
7.4.2.9 Cut, Copy, Paste, and Clipboard Options .....................7-65
7.4.3 Library Files ............................................................................ 7-65
7.4.4 Documenting a DLD File........................................................ 7-65
7.4.5 Display Options....................................................................... 7-66
7.4.5.1 Graphical Toolbar......................................................... 7-66
7.4.5.2 Renumbering the Instructions....................................... 7-67
7.4.5.3 Compress VIEW........................................................... 7-67
7.4.5.4 Indention....................................................................... 7-67
7.4.6 Input Locations........................................................................ 7-67
7.4.7 Entering Input Locations ......................................................... 7-68
7.4.8 Repetitions............................................................................... 7-68
vi
Table of Contents
7.4.9 Input Location Editor .............................................................. 7-69
7.4.10 Input Location Anomalies....................................................... 7-70
7.4.11 Final Storage Labels................................................................ 7-71
7.4.12 Datalogger Settings Stored in the DLD File ........................... 7-73
7.4.13 Program Security .................................................................... 7-73
7.4.13.1 Setting Passwords in the DLD...................................... 7-73
7.4.13.2 Disabling Passwords .................................................... 7-73
7.4.14 Final Storage Area 2 ............................................................... 7-74
7.4.15 DLD File Labels ..................................................................... 7-74
7.4.15.1 Mixed-array Dataloggers.............................................. 7-74
7.4.15.2 Table-Based Dataloggers ............................................. 7-74
7.4.16 Power Up Settings/Compile Settings...................................... 7-75
7.4.17 Datalogger Serial Port Settings ............................................... 7-75
7.4.18 PakBus Settings ...................................................................... 7-76
7.4.18.1 Network........................................................................ 7-76
7.4.18.2 Beacon Intervals........................................................... 7-76
7.4.18.3 Neighbor Filter ............................................................. 7-77
7.4.18.4 Allocate General Purpose File Memory....................... 7-77
7.5 Transformer Utility ........................................................................ 7-77
7.5.1 Transforming a File................................................................. 7-77
7.5.2 Controls................................................................................... 7-79
8. Working with Data Files on the PC.........................8-1
8.1 View Pro .......................................................................................... 8-1
8.1.1 Overview................................................................................... 8-1
8.1.2 The Toolbar............................................................................... 8-2
8.1.3 Opening a File........................................................................... 8-4
8.1.3.1 Opening a Data File........................................................ 8-4
8.1.3.2 Opening Other Types of Files ........................................ 8-4
8.1.3.3 Opening a File in Hexadecimal Format.......................... 8-4
8.1.4 Viewing a LoggerNet Database Table ...................................... 8-4
8.1.4.1 Selecting a Database....................................................... 8-4
8.1.4.2 Selecting a Table ............................................................ 8-8
8.1.5 Importing a CSV File................................................................ 8-8
8.1.6 Data View ............................................................................... 8-11
8.1.6.1 Column Size ................................................................. 8-12
8.1.6.2 Header Information ...................................................... 8-12
8.1.6.3 Locking the TimeStamp Column ................................. 8-12
8.1.6.4 File Information............................................................ 8-12
8.1.6.5 Background Color ........................................................ 8-12
8.1.6.6 Font .............................................................................. 8-12
8.1.6.7 Window Arrangement .................................................. 8-13
8.1.7 Graphs..................................................................................... 8-13
8.1.7.1 Line Graph ................................................................... 8-15
8.1.7.1.1 Selecting Data to be Graphed ............................ 8-15
8.1.7.1.2 Graph Width ...................................................... 8-16
8.1.7.1.3 Scrolling ............................................................ 8-16
8.1.7.1.4 Graph Cursor ..................................................... 8-16
8.1.7.1.5 Line Graph Toolbar ........................................... 8-17
8.1.7.2 Histogram..................................................................... 8-19
8.1.7.2.1 Selecting Data to be Viewed.............................. 8-20
8.1.7.2.2 Options .............................................................. 8-21
8.1.7.2.3 Histogram Toolbar............................................. 8-21
vii
Table of Contents
8.1.7.3 XY Plot......................................................................... 8-22
8.1.7.3.1 Selecting Data to be Plotted............................... 8-23
8.1.7.3.2 XY Plot Toolbar................................................. 8-23
8.1.7.4 Rainflow Histogram ..................................................... 8-24
8.1.7.4.1 Selecting Data to be View.................................. 8-25
8.1.7.4.2 Options............................................................... 8-26
8.1.7.4.3 Rainflow Histogram Toolbar ............................. 8-26
8.1.7.5 FFT ............................................................................... 8-27
8.1.7.5.1 Selecting Data to be Graphed............................. 8-28
8.1.7.5.2 Options............................................................... 8-29
8.1.7.5.3 FFT Toolbar....................................................... 8-29
8.1.8 Right-click-Menus................................................................... 8-30
8.1.8.1 Data View..................................................................... 8-30
8.1.8.2 Graphs .......................................................................... 8-32
8.1.8.3 Traces ...........................................................................8-32
8.1.9 Printing Options ...................................................................... 8-32
8.1.9.1 Print Setup .................................................................... 8-32
8.1.9.2 Printing Text................................................................. 8-33
8.1.9.3 Printing Graphs............................................................. 8-33
8.1.10 View Pro Online Help ............................................................. 8-33
8.1.11 Assigning Data Files to View.................................................. 8-33
8.2 Split ................................................................................................ 8-33
8.2.1 Functional Overview ............................................................... 8-33
8.2.2 Getting Started......................................................................... 8-34
8.2.3 Split Parameter File Entries..................................................... 8-40
8.2.3.1 Input Files..................................................................... 8-40
8.2.3.1.1 File Info ............................................................. 8-42
8.2.3.1.2 File Offset/Options ............................................ 8-42
8.2.3.1.3 Start Condition ................................................... 8-46
8.2.3.1.4 Stop Condition ...................................................8-49
8.2.3.1.5 Copy................................................................... 8-52
8.2.3.1.6 Select.................................................................. 8-53
8.2.3.1.7 Ranges................................................................ 8-54
8.2.3.1.8 Variables............................................................ 8-55
8.2.3.1.9 Numerical Limitations ....................................... 8-55
8.2.3.1.10 Mathematical Functions, Details, and
Examples........................................................ 8-56
8.2.3.1.11 Time Series Functions, Details, and Examples.. 8-58
8.2.3.1.12 Special Functions, Details, and Examples ......... 8-63
8.2.3.1.13 Split Functions Example .................................... 8-68
8.2.3.1.14 Summary of Select Line Syntax Rules ..............8-70
8.2.3.1.15 Time Synchronization........................................ 8-71
8.2.3.2 Output Files .................................................................. 8-74
8.2.3.2.1 Description of Output Option Commands .........8-75
8.2.3.2.2 Report Headings ................................................ 8-80
8.2.3.2.3 Column Headings .............................................. 8-80
8.2.4 Help Option ............................................................................. 8-80
8.2.5 Editing Commands.................................................................. 8-81
8.2.6 Running Split From a Command Line .................................... 8-81
8.2.6.1 Splitr Command Line Switches .................................... 8-81
8.2.6.1.1 Closing the Splitr.exe Program After
Execution (/R or /Q Switch)........................... 8-81
8.2.6.1.2 Running Splitr in a Hidden or Minimized
State (/H Switch) ............................................ 8-81
8.2.6.1.3 Running Multiple Copies of Splitr (/M Switch) 8-82
8.2.6.2 Using Splitr.exe in Batch Files .....................................8-82
viii
Table of Contents
8.2.6.3 Processing Alternate Files ............................................ 8-82
8.2.6.3.1 Input/Output File Command Line Switches for
Processing Alternate Files.............................. 8-83
8.2.6.4 Processing Multiple Parameter Files with One
Command Line ......................................................... 8-86
8.2.7 Log Files ................................................................................. 8-86
8.3 CardConvert................................................................................... 8-86
8.3.1 Input/Output File Settings ....................................................... 8-87
8.3.2 Destination File Options ......................................................... 8-87
8.3.2.1 File Format ................................................................... 8-88
8.3.2.2 File Processing ............................................................. 8-88
8.3.2.3 File Naming.................................................................. 8-89
8.3.2.4 TOA5/TOB1 Format .................................................... 8-90
8.3.3 Converting the File.................................................................. 8-90
8.3.3.1 Repairing/Converting Corrupted Files ......................... 8-90
8.3.4 Viewing a Converted File ....................................................... 8-91
8.3.5 Running CardConvert From a Command Line ....................... 8-91
9. Automating Tasks with Task Master......................9-1
9.1 Task Master...................................................................................... 9-1
9.1.1 Setup Tab .................................................................................. 9-2
9.1.1.1 Adding Tasks.................................................................. 9-2
9.1.1.2 Logger Event Tasks........................................................ 9-3
9.1.1.3 Scheduled Event Tasks................................................... 9-5
9.1.1.3.1 Interval Tasks ...................................................... 9-5
9.1.1.3.2 Calendar............................................................... 9-6
9.1.1.4 Define What the Task Does............................................ 9-8
9.1.2 Status Tab................................................................................ 9-13
9.1.3 Remote Administration of the Task Master ............................ 9-15
9.1.4 Task Master Logs.................................................................... 9-15
10. Utilities Installed with LoggerNet .........................10-1
10.1 Device Configuration Utility.......................................................... 10-1
10.1.1 Overview................................................................................. 10-1
10.1.2 Main DevConfig Screen.......................................................... 10-2
10.1.3 Downloading an Operating System ........................................ 10-3
10.1.4 Terminal Tab........................................................................... 10-5
10.1.5 The Unknown Device Type .................................................... 10-5
10.1.6 Off-line Mode ......................................................................... 10-6
10.2 CoraScript ...................................................................................... 10-7
10.2.1 CoraScript Fundamentals........................................................ 10-7
10.2.2 Useful CoraScript Operations ................................................. 10-7
10.2.2.1 Connecting to the LoggerNet Server............................ 10-8
10.2.2.2 Checking and Setting Device Settings ......................... 10-8
10.2.2.3 Creating and using a Network Backup File.................. 10-8
10.2.2.4 Hole Management ........................................................ 10-9
10.2.2.5 Scripting CoraScript Commands................................ 10-10
10.3 RWIS Administrator .................................................................... 10-10
10.3.1 Overview............................................................................... 10-10
10.3.2 Adding a New RWIS Station................................................ 10-11
10.3.3 Editing Station Settings......................................................... 10-12
10.3.3.1 Station Communication Settings ................................ 10-12
10.3.3.2 Schedule Settings ....................................................... 10-13
10.3.3.3 Snapshots Settings...................................................... 10-15
ix
Table of Contents
10.3.3.4 Clock Settings............................................................. 10-16
10.3.3.5 Data Tab .....................................................................10-18
10.3.4 Deleting a Station .................................................................. 10-18
10.3.5 Organization of RWIS Data in LoggerNet............................ 10-18
10.4 File Format Convert .....................................................................10-19
10.4.1 Overview............................................................................... 10-19
10.4.2 Options .................................................................................. 10-20
10.5 Toa_to_tob1.................................................................................. 10-22
11. Utilities Installed with LoggerNet Admin and
LoggerNet Remote.............................................. 11-1
11.1 Security Manager ........................................................................... 11-1
11.1.1 Initial Configuration of Security Manager ..............................11-1
11.1.2 Managing User Accounts ........................................................ 11-2
11.1.3 Resetting Security ................................................................... 11-5
11.1.4 Remote Task Management...................................................... 11-5
11.2 Hole Monitor .................................................................................. 11-5
11.2.1 Hole Collection Activity ......................................................... 11-6
11.2.2 Message Log ...........................................................................11-7
11.3 Data Filer........................................................................................ 11-8
11.3.1 Data Filer Requirements.......................................................... 11-8
11.3.2 Using the Data Filer ................................................................ 11-8
11.3.2.1 Connecting to a Computer Running the LoggerNet
Server Software......................................................... 11-8
11.3.2.1.1 Setting Up the Data Filer ...................................11-9
11.3.2.2 Collection Options........................................................ 11-9
11.3.3 The Collected Data................................................................ 11-11
11.3.4 Determining the Data Available in the Data Cache............... 11-11
11.3.5 Record Number Anomalies................................................... 11-12
11.3.6 Communication Status ..........................................................11-12
11.4 Data Export................................................................................... 11-12
11.4.1 Functional Overview ............................................................. 11-12
11.4.2 Theory of Operation .............................................................. 11-14
11.4.3 Custom Data Retrieval Client................................................ 11-15
11.4.4 Custom Client/Data Export Interface Description................. 11-15
11.4.5 RTMS Format Description.................................................... 11-20
11.4.6 Standard Format Description................................................. 11-21
12. Optional Client Applications Available for
LoggerNet............................................................ 12-1
12.1 Allowing Remote Connections to the LoggerNet Server ............... 12-1
12.2 LoggerNetData ............................................................................... 12-1
12.3 RTMC Run-Time ........................................................................... 12-2
12.4 RTMC Pro ...................................................................................... 12-2
12.5 LNDB............................................................................................. 12-2
12.6 Baler ............................................................................................... 12-2
12.7 CSIOPC Server (PC-OPC)............................................................. 12-3
12.8 Software Development Kit............................................................. 12-3
x
Table of Contents
13. Implementing Advanced Communications
Links .....................................................................13-1
13.1 Phone to RF.................................................................................... 13-1
13.1.1 Setup ....................................................................................... 13-1
13.1.2 Operational Considerations..................................................... 13-2
13.1.2.1 Scheduled Data Collection ........................................... 13-2
13.1.2.2 Extra Response Time.................................................... 13-2
13.1.2.3 RF Address................................................................... 13-2
13.1.2.4 Max Time Online ......................................................... 13-2
13.1.3 Attaching a Datalogger to the RF Base................................... 13-2
13.1.3.1 Hardware Setup............................................................ 13-3
13.1.3.2 Network Setup in LoggerNet ....................................... 13-3
13.2 Phone to MD9 ................................................................................ 13-3
13.2.1 Setup ....................................................................................... 13-3
13.2.2 Operational Considerations..................................................... 13-4
13.2.2.1 Scheduled Data Collection ........................................... 13-4
13.2.2.2 MD9 Addresses............................................................ 13-4
13.2.2.3 Extra Response Time.................................................... 13-4
13.2.2.4 Max Time Online ......................................................... 13-4
13.2.2.5 1Grounding .................................................................. 13-5
13.3 TCP/IP to RF.................................................................................. 13-5
13.3.1 Setup ....................................................................................... 13-5
13.3.2 Operational Considerations..................................................... 13-5
13.3.3 Special Considerations............................................................ 13-6
14. Troubleshooting Guide .........................................14-1
14.1 What’s Changed? ........................................................................... 14-1
14.2 LoggerNet Server Problems........................................................... 14-1
14.2.1 Starting LoggerNet and Connecting to the Server .................. 14-1
14.2.2 Socket Errors........................................................................... 14-2
14.2.3 Data Collection Issues............................................................. 14-4
14.3 Application Screen Problems......................................................... 14-4
14.4 General Communication Link Problems........................................ 14-4
14.5 Terminal Emulator to Test Communications ................................. 14-5
14.6 RF Communication Link Issues..................................................... 14-8
14.6.1 Checking RF Components and Connections........................... 14-9
14.6.2 RF Signal Strength Testing ..................................................... 14-9
14.6.3 Troubleshooting with Attenuation Pads................................ 14-11
14.7 Using Data Table Monitor............................................................ 14-13
14.8 Troubleshooting PakBus Communications.................................. 14-17
Appendices
A. Glossary of Terms .................................................. A-1
B. Campbell Scientific File Formats .......................... B-1
B.1 PC File Data Formats.......................................................................B-1
B.1.1 Comma Separated .....................................................................B-1
B.1.2 ASCII Printable.........................................................................B-2
xi
Table of Contents
B.1.3 TOACI1.................................................................................... B-2
B.1.3.1 Field Name Suffixes ...................................................... B-3
B.1.4 TOA5........................................................................................ B-4
B.1.5 TOB1........................................................................................ B-4
B.1.6 Array Compatible CSV ............................................................ B-6
B.1.7 CSIXML................................................................................... B-6
B.1.7.1 A Short Introduction to XML........................................ B-6
B.1.7.2 File Syntax..................................................................... B-8
B.1.7.3 The csixml Element..................................................... B-10
B.1.7.3.1 The head Element ................................................ B-11
B.1.7.3.2 The data Element ................................................. B-12
B.1.7.4 File Example................................................................ B-13
B.1.8 CSIJSON................................................................................ B-14
B.1.8.1 A Short Introduction to JSON ..................................... B-15
B.1.8.2 File Syntax................................................................... B-15
B.1.8.2.1 The head Object ................................................... B-15
B.1.8.2.2 The data Array ..................................................... B-18
B.1.8.3 File Example................................................................ B-18
B.2 Datalogger Data Formats............................................................... B-19
B.2.1 TOB2 or TOB3....................................................................... B-19
B.3 Binary Data Value Types .............................................................. B-21
B.3.1 FP2 (2 Byte Low Resolution Format) .................................... B-21
B.3.2 FP4 (4 Byte High Resolution Format).................................... B-21
B.3.3 IEEE4 ..................................................................................... B-21
B.3.4 IEEE8 ..................................................................................... B-21
B.4 Converting Binary File Formats.................................................... B-22
B.4.1 Split ........................................................................................ B-22
B.4.2 View Pro................................................................................. B-22
B.4.3 CardConvert ........................................................................... B-22
B.4.4 File Format Convert ............................................................... B-22
B.4.5 TOB32.EXE........................................................................... B-23
B.5 RTMS Format Description............................................................ B-23
C. Table-Based Dataloggers .......................................C-1
C.1 Memory Allocation for Final Storage.............................................. C-1
C.1.1 CR10X-TD Family Table-Based Dataloggers ......................... C-1
C.1.2 CR5000/CR1000/CR3000/CR800/CR9000 Memory for
Programs and Data Storage................................................... C-2
C.1.3 CR200 Series Dataloggers........................................................ C-2
C.2 Converting an Array-Based Program to a CR10X-TD Table-
Based Program using Edlog......................................................... C-3
C.2.1 Steps for Program Conversion ................................................. C-3
C.2.2 Program Instruction Changes ................................................... C-4
C.3 Table Data Overview....................................................................... C-5
C.4 Default Tables ................................................................................. C-6
D. Software Organization ............................................D-1
D.1 LoggerNet/Client Architecture ........................................................ D-1
D.2 LoggerNet Server Data Cache......................................................... D-1
D.2.1 Organization............................................................................. D-1
D.2.2 Operation.................................................................................. D-1
D.2.3 Retrieving Data from the Cache............................................... D-2
D.2.4 Updating Table Definitions...................................................... D-2
xii
Table of Contents
D.3 Directory Organization.................................................................... D-3
D.3.1 C:\CampbellSci Directory (Working Directory)...................... D-3
D.3.2 C:\Program Files\CampbellSci\LoggerNet Directory
(Program File Directory) ...................................................... D-4
E. Log Files .................................................................. E-1
E.1 Event Logging..................................................................................E-1
E.1.1 Log Categories .......................................................................... E-1
E.1.2 Enabling Log Files.................................................................... E-2
E.1.3 Log File Message Formats ........................................................ E-2
E.1.3.1 General File Format Information....................................E-2
E.1.3.2 Transaction Log Format ................................................. E-3
E.1.3.3 Communications Status Log Format............................ E-18
E.1.3.4 Object State Log Format ..............................................E-21
E.2 CQR Log (RF Link) ....................................................................... E-22
F. Calibration and Zeroing.......................................... F-1
F.1 Calibration Essentials....................................................................... F-1
F.1.1 Definition of Calibration........................................................... F-1
F.1.2 Basic Calibration Process.......................................................... F-1
F.2 Writing Calibration Programs with the CRBasic Editor .................. F-2
F.2.1 The FieldCal Instruction ........................................................... F-2
F.2.2 Calibration File Details ............................................................. F-3
F.3 Four Kinds of Calibration ................................................................ F-3
F.3.1 Zeroing...................................................................................... F-3
F.3.2 Offset Calibration...................................................................... F-4
F.3.3 Two-Point Multiplier and Offset Calibration............................ F-4
F.3.4 Two-Point Multiplier Only Calibration..................................... F-5
F.4 Performing a Manual Calibration..................................................... F-5
F.4.1 How to Use the Mode Variable for Calibration Status and
Control................................................................................... F-5
F.4.2 Using the Mode Variable for Manual Single-Point
Calibration............................................................................. F-6
F.4.3 Using the Mode Variable for Manual Two-Point
Calibration............................................................................. F-7
F.5 Using the Calibration Wizard with Running Programs.................... F-8
F.5.1 Calibration Wizard Basic Operation .........................................F-8
F.5.2 Using the Wizard to Perform Two-Point Multiplier and
Offset Calibrations ................................................................ F-8
F.5.3 Using the Wizard to Perform Zeroing Calibrations ................ F-12
F.5.4 Using the Wizard to Perform Offset Calibrations................... F-13
F.6 Strain and Shunt Calibration .......................................................... F-15
G. Importing Files into Excel ...................................... G-1
Tables
G.1 Array-Based Data File Import......................................................... G-1
G.2 Table-Based Data File Import......................................................... G-4
7-1. Formats for Output Data ................................................................ 7-46
7-2. Formats for Entering Numbers in CRBasic.................................... 7-47
7-3. Synonyms for True and False......................................................... 7-48
7-4. Rules for Names............................................................................. 7-49
xiii
Table of Contents
7-5. Operators and Functions................................................................. 7-59
7-6. Editor Keystrokes ........................................................................... 7-64
8-1. Comma Separated, Field Formatted, Printable ASCII, and
Table Oriented ASCII Input File Format Types ......................... 8-41
8-2. Example of Event Driven Test Data Set......................................... 8-50
8-3. Processed Data File Using Option C .............................................. 8-51
8-4. Input File Entries to Process the First Data Point for each Test ..... 8-52
8-5. Effects of Out of Range Values for Given Output Options ............ 8-54
8-6. Split Operators and Math Functions ............................................... 8-56
8-7. Time Series Functions .................................................................... 8-58
8-8. Split SPECIAL FUNCTIONS........................................................ 8-63
8-9. Definition of Blank or Bad Data for each Data File Format...........8-77
11-1. Security Manager Access Table ..................................................... 11-3
14-1. Socket Error Messages ................................................................... 14-3
B-1. Output Instruction Suffixes ............................................................. B-3
B-2. Pre-Defined XML Entities .............................................................. B-7
B-3. Field Data Types ........................................................................... B-12
C-1. Example of Status Table Entries (CR10T)...................................... C-7
E-1. Transaction Log Messages ...............................................................E-3
E-2. Communication Status Log Messages............................................E-19
F-1. The FieldCal Instruction “Family”................................................... F-2
xiv
Preface — What’s New in LoggerNet 4?
Product History
LoggerNet 4 continues the original design of client-server functionality that first appeared when Version 1.0 was released for Windows to replace Real Time Monitoring Software (RTMS) that ran on OS/2 operating systems.
Versions in the 1.x series supported only table-based dataloggers and provided large network users with sophisticated capabilities to develop clients to the server to move data without having to store it in interim files.
Version 2.0 added support for dataloggers with mixed-array operating systems, the CRBasic dataloggers, and additional communications devices. It also supported client applications’ requests for data via TCP/IP, and automatically created files on the PC for final storage data. Subsequent revisions in the 2.x series added support for hardware as it was released and refined the client­server architecture to make it more robust and flexible. Software development kits and standalone clients were released to provide additional functionality.
NOTE
One of the main efforts in the development of LoggerNet 3.1 was to incorporate support for the CR1000 datalogger. This included datalogger management (connect, collect data, set clock, send program, etc.) in LoggerNet, as well as programming support in CRBasic and Short Cut. To help with creating CR1000 programs, a Transformer utility was developed to convert existing CR10X Edlog programs to CR1000 CRBasic programs.
LoggerNet 3.2 added support for our new CR3000 datalogger. In addition, LoggerNet Admin and LoggerNet Remote were developed, which provide tools to support larger networks. These tools include security and remote management capabilities, and the ability to run LoggerNet as a service.
LoggerNet 3.3 added support for the CR800 datalogger. A new file output option was also added for table-based dataloggers. This CSV file format option allows the creation of data files similar to those from mixed array dataloggers.
LoggerNet 3.4 improved LoggerNet’s performance on Windows Vista. In addition, changes were made to the user interface of the Numeric Display and Graphs.
Beginning with LoggerNet 3.4, Windows NT is no longer supported.
LoggerNet 4.0 introduces a new look and feel to the LoggerNet Toolbar. Applications are divided into categories to make navigating the Toolbar easier. You can also organize a Favorites category for the applications that you use most often. A new file viewing application, View Pro, is introduced which allows multiple data files to be opened, multiple graphs to be created, and graphing in a variety of formats (Line Graph, X-Y Plot, Histogram, Rainflow Histogram, and FFT). Another new application, the Network Planner, is included. This is a graphical application that assists the user in designing
xv
Preface — What’s New in LoggerNet 4?
PakBus datalogger networks. It allows the development of a model of the PakBus network, proposes and verifies valid connections between devices, and allows integration of the model directly into LoggerNet 4.0.
See below for more details on what is new in LoggerNet 4.0 and each individual application.
One of the main efforts in the development of LoggerNet 4.1 was the ability to use LNDB databases with View Pro. The ability to lock the timestamp column on the left of the data file has also been added to View Pro. This keeps the timestamp visible as you scroll through columns of data. The Device Configuration Utility adds an off-line mode which allows you to look at the settings for a certain device type without actually being connected to a device. The CRBasic Editor 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 the each line that is to be continued. Also, bookmarks in a CRBasic program are now persistent from session to session. In the Troubleshooter and the Setup Screen (Standard View), you can now click on a potential problem to bring up a menu that allows you to go the Setup Screen or Status Monitor to fix the potential problem, bring up help describing the problem, or in some cases fix the problem directly. Campbell Scientific’s new wireless sensors have been added to the Network Planner. An option to provide feedback on LoggerNet is now available from the LoggerNet Toolbar’s Help menu.
NOTE
Beginning with LoggerNet 4.1, Windows 2000 is no longer supported.
LoggerNet 4.2 adds support for IPv6 addresses. IPv6 addresses are written as eight two-byte address blocks separated by colons and surrounded by brackets (e.g., [2620:24:8080:8600:85a1:fcf2:2172:11bf]). Prior to LoggerNet 4.2, only IPv4 addresses were supported. IPv4 addresses are written in dotted decimal notation (e.g., 192.168.11.197). Leading zeroes are stripped for both IPv4 and IPv6 addresses. Note that while LoggerNet now supports IPv6 addresses and they can be used to specify servers, CR1000/CR3000/CR800 series dataloggers will not support IPv6 until a future OS release. Check the OS revision history on our website to determine when IPv6 support is added to the OS.
LoggerNet now supports display and input of Unicode characters/strings in many areas of the product. Unicode is a universal system for encoding characters. It allows LoggerNet to display characters in the same way across multiple languages and countries. See Unicode in the LoggerNet help file index for more information on Unicode and what applications support Unicode characters. To support Unicode, an Insert Symbol dialog box has been added to the CRBasic Editor. This allows you to insert Unicode symbols into your CRBasic program for use in Strings and Units declarations.
The ability to set up subnets of the network map has been added to LoggerNet Admin. The Setup Screen’s View | Configure Subnets menu item is used to configure the subnets. Within each subnet, you can also specify groups of dataloggers. The datalogger groups create folders than can be collapsed or expanded when viewing the subnet. Once subnets have been configured, you
xvi
Preface — What’s New in LoggerNet 4?
can choose to view a subnet rather that the entire network in the Setup Screen, Connect Screen, and Status Monitor.
You can now set up defaults for the Setup Screen’s Schedule, Data Files, Clock, and File Retrieval tabs that will be used when new stations are added to the network. There is also the ability to copy these defaults to existing stations.
The ability to use 24:00 (rather than the default of 00:00) for the timestamp at midnight has been added. (This is accessed from the
button next to the Output Format field on the datalogger’s Data Files tab in the Setup Screen. It is also available in the Connect Screen’s Custom Collection options.)
PakBus Encryption is now supported for communication between LoggerNet and CR1000, CR3000, and CR800 series dataloggers. Note that the datalogger must be running OS 26 or later in order for PakBus Encryption to be used. A PakBus Encryption Key must be entered in both the datalogger’s device settings and LoggerNet’s Setup Screen. AES-128 encryption is used.
Two new root devices, SerialPortPool and TerminalServerPool, have been added to allow for modem pooling (Pooled Devices may be useful in cases where LoggerNet is used to call, by phone, multiple remote dataloggers and there is more than one modem and phone line available to make the connections.)
NOTE
You can now access a datalogger’s Settings Editor from the Connect Screen either by right-clicking on the datalogger or from the Datalogger menu. You can also manually set the datalogger’s clock from the Connect Screen either by double-clicking in the Station Date/Time field or from the Datalogger menu. Boolean values displayed in the Connect Screen’s Numeric Display now have an LED icon next to them to allow for easy toggle.
You can now view additional statistics in the Status Monitor for table-based dataloggers including watchdog errors, skipped scans, and battery errors. (Note that there is a Poll for Statistics check box on the datalogger’s Schedule tab in the Setup Screen that must be enabled to poll for these statistics.)
The Task Master has been integrated into the LoggerNet server. This allows for remote administration of the Task Master. (See Section 9.1.3 Remote Administration of the Task Master for conditions that must be met for remote administration of the Task Master.)
Integrating the Task Master into the server involved extensive changes. When upgrading to LoggerNet 4.2 from a previous version, an attempt will be made to import all previously­configured tasks. However, imports have only been tested back to LoggerNet 3.4.1. After upgrading (from any previous version of LoggerNet), you should verify that all of your tasks have imported correctly.
Calendar-based scheduling has been added to the Task Master. This allows for non-interval task execution (including data collection). See Example #3 in Section 9.1.1.4 Define What the Task Does for an example of calendar-based data collection.
xvii
Preface — What’s New in LoggerNet 4?
A Constant Customization feature has been added to the CRBasic Editor. This allows you to define values for one or more constants in a program prior to performing a conditional compile. The constants can be set up with an edit box, a spin box field for selecting/entering a value, or with a list box. A step increase/decrease can be defined for the spin box, as well as maximum and minimum values.
The CRBasic Editor now allows you to Save and Open Display Settings. Display settings affect the look and feel of the CRBasic Editor. This includes font and background, as well as syntax highlighting.
View Pro has a new View Record option in the right-click menu that can be used to view an entire record in a new window.
LoggerNet Products
Campbell Scientific offers four LoggerNet software packages, LoggerNet, LoggerNetData, LoggerNet Admin, and LoggerNet Remote and several
standalone client products. Each of these packages is purchased separately. LoggerNet is the main software application and comes with all of the applications needed to set up and configure a network of dataloggers including tools to write programs and monitor retrieved data. LoggerNetData is a complementary product that includes applications that can be used on a remote computer to monitor data, or retrieve, view, and analyze data that was collected by LoggerNet into a file. LoggerNet Admin and LoggerNet Remote enhance the capabilities of LoggerNet by providing management tools for more complex networks. The difference in the two is that LoggerNet Admin offers a complete LoggerNet package, while LoggerNet Remote, which was designed to be run remotely, does not include the LoggerNet server.
New and Improved Applications
Several new applications, as well as improvements to previously available applications, are included with the release of LoggerNet 4.0.
Toolbar
The LoggerNet 4.0 Toolbar has a completely new look and feel. Applications are divided into categories to make navigating the Toolbar easier. You can also organize a Favorites category for the applications that you use most often. Then, if you prefer a smaller version of the toolbar, you can select Favorites View from the View menu. This will switch to a small view of the toolbar containing only icons for applications in the Favorites category.
Additional options are available including the ability to show a LoggerNet system tray icon (either whenever LoggerNet is running or only when LoggerNet is minimized), the option of hiding the LoggerNet taskbar button when LoggerNet is minimized and the system tray icon is showing, the option of whether or not to minimize clients when the Toolbar is minimized, and the ability to hide or show the main menu.
xviii
Setup Screen
Preface — What’s New in LoggerNet 4?
The Setup Screen now has the option of being used in an EZ View or a Standard View. The Standard View is similar to the Setup Screen in older versions of LoggerNet. In the EZ View, the EZ Setup Wizard is used to add dataloggers and edit their settings.
Standard View Changes
A new menu item has been added to enable a Stations Only view. When this is enabled, only stations will be shown in the Network Map and they will be listed in alphabetical order. This can be especially helpful, when working with a large network.
A Scheduled Backup menu item has also been added. This opens a dialog box from which you can setup automatic backups of LoggerNet on a user-defined schedule.
A new root device, the PakBus TcpServer, has been added. This device can accommodate multiple incoming PakBus/TCP connections to service the stations attached to it. Therefore, it allows the same IP port to be used to listen for incoming connections from multiple dataloggers. The device has a Routing tab that can be used to specify IP addresses and port numbers to be used for outgoing connections to specific dataloggers attached to the PakBus TcpServer. The Routing tab can also be used to cause LoggerNet to maintain a connection with a range of dataloggers, once an incoming connection has been established.
Connect Screen
An Image Files tab has been added to the Setup Screen for the CR1000, CR3000, and CR800 Series dataloggers. This tab provides an easy way to retrieve image files from the datalogger on a specified interval. (Note this tab is renamed File Retrieval in LoggerNet 4.1.)
A Notes tab has been added to all devices to allow the user to keep notes about the device for future reference. This is purely for the user’s convenience. (The information in a datalogger’s Notes tab is displayed in the Connect Screen, when that datalogger is selected.)
A new File Output Format option, CSIXML, has been added. When this option is selected, data is stored in XML format with Campbell Scientific defined elements and attributes.
Individual devices and/or device branches of the Network Map can be copied and pasted into the network.
Various other settings have been added including BMP1 Station ID, BMP1 Low Level Delay, PakBus Verify Interval, TCP Password, Enable Automatic Hole Collection, Stay on Collect Schedule, and Collect At Most. See Section
4.2.4, Device Settings, or LoggerNet’s online help for information about these settings and what devices they apply to.
The Connect Screen has been reorganized with most of the buttons now residing on a toolbar at the top of the window.
xix
Preface — What’s New in LoggerNet 4?
A Table Monitor has been added in the middle of the window that can be used to monitor the values for one entire table.
A Notes field has been added that displays the information from the Setup Screen’s Notes tab of the selected datalogger.
A connection made in the Connect Screen is now subject to the Maximum Time On-Line configured in the Setup Screen. (See the Device Settings help in Section 4, Setting up Datalogger Networks, for information on how the Maximum Time On-Line setting will affect a connection made using LoggerNet Admin or LoggerNet Remote 4.0 to connect to a remote server running an older version of LoggerNet.)
The Pause Data Displays option has been moved to the Edit menu. (In previous versions it was available as a check box on the Connect Screen.)
The Update Interval for data displays has been moved from the Options dialog to the display’s main window.
New options added to the data displays include an Auto Format option (rather than specifying the number of decimal places to display), the ability to format the timestamp for numeric displays, and the ability to specify what will happen when a NAN is encountered in a graph.
Status Monitor
Task Master
The configuration of the data displays can now be saved.
A new File Format option, CSIXML, has been added to Custom Collection. When this option is selected, data is stored in XML format with Campbell Scientific defined elements and attributes. For Custom Collection, you also now have the option of whether or not to include timestamps and/or record numbers.
Two new statistics are now available to be monitored: Link Time Remaining (the time remaining, in milliseconds, until Maximum Time On-Line is reached and the device is automatically disconnected) and RFTD Blacklisted (indicates that a station has been blacklisted by an RF Base because of a failed communication attempt).
A new event type, After File Closed, has been added to the Task Master. Using this event type, a task will be executed anytime a data file being written to is closed.
Along with the above event type, FTP and SFTP capabilities have been added which allow the just closed file to be transferred to a designated FTP server.
Short Cut
Support has been added to Short Cut for the CR9000X datalogger, the ET107 Evapotranspiration Monitoring Station, and the AVW200 Two-Channel Vibrating Wire Spectrum Analyzer.
xx
Preface — What’s New in LoggerNet 4?
New sensor files have been added for the CMP3 Pyranometer, the IRR-P Precision Infrared Temperature Sensor, the JC Ultrasonic Depth Sensor, the CNR2 Net Radiometer, the CS106 Barometric Pressure Sensor, the OBS-3+ Turbidity Sensor, the 03002 Wind Speed and Direction Sensor, the 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), and a saturation vapor pressure calculation
An Advanced tab has been added to the Finish screen for CRBasic dataloggers, which allows the user to view the CRBasic code and launch the CRBasic Editor.
There is now an option to send the program to the datalogger from the Results tab on the Finish screen.
The user now has the ability to create custom sensor files using existing sensor files as templates.
CRBasic Editor
The user can now manually set advanced outputs to high or low resolution.
The Add Device button has been removed. Peripheral devices are now listed in and selected directly from the Available Sensors and Devices tree.
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 – When enabled variable names will be capitalized based on how they are declared in the program, regardless of how the user may have typed them.
Create .TDF File at Compile – The user can then associate a .TDF file with a datalogger. This can be useful if communication is taking place
xxi
Preface — What’s New in LoggerNet 4?
over a slow or unreliable communication link where the attempt to receive table definitions back from the datalogger fails.
Clear Undo/Redo List on File Save – Clears the change tracking in the program when the file is saved. Otherwise change tracking is kept until the file is closed.
Syntax Highlighting for Variables and Local Variables – Variables and Local Variables can now be given their own syntax highlighting to make them easier to identify.
You can now drag and drop a file onto the CRBasic Editor workspace to open the file. Also, multiple files can be selected from the File | Open dialog box. All selected files will be opened.
Support has been added for custom voice files for the VoiceSpeak instruction. When inserting a VoiceSpeak instruction, the user then has the option of choosing words from the standard Voice.txt file or from a user-created custom voice file.
The CRBasic Editor now has alternate language support, if a separate LoggerNet language package has been installed.
RTMC
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. See Section 5.2.1.4, Expressions, or the Expressions topic in RTMC’s online help for more information.
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.
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.
In RTMC Run-Time, all alarms on a screen can be acknowledged by right­clicking on the screen and then choosing “Acknowledge All On-Screen Alarms”.
xxii
View Pro
Preface — What’s New in LoggerNet 4?
Miscellaneous other changes have been made to the settings for specific components.
View Pro is included for the first time in LoggerNet 4.0. It maintains the ease of use of our former data file viewer with greatly enhanced capabilities.
Large files can be loaded more quickly. Scrolling is more responsive for large files.
View Pro allows you to have multiple data files opened at one time. Multiple graphs can be created from the same file or from multiple files. There is no limit to the number of traces per graph. Data can be graphed in a variety of formats including a Line Graph, X-Y Plot, Histogram, Rainflow Histogram, or FFT (2D or 3D).
You have the ability to create a Line Graph containing multiple strip charts. This allows you to simultaneously display data from multiple files (one strip chart per file) to compare data from multiple stations. The X-axes (timestamps) of the strip charts can be synchronized to facilitate cross file comparisons.
Split
A Line Graph can use record numbers rather than timestamps on the X-Axis. This allows you to display data files containing gaps in the timestamps.
From the toolbar of a Line Graph, you can bring up a Statistics box which shows the average, standard deviation, minimum, and maximum of the displayed points. From the toolbar you can also add a graph cursor to a Line Graph. The cursor can be scrolled across the graph and the data values and timestamp at the current cursor position will be shown.
View Pro has zoom capability to allow you to zoom in on a certain area of a graph. You can also scroll a graph either from the graph itself or from the opened data file.
You can print a graph either from a preview screen or directly from the graph toolbar. The graph can also be saved in a variety of formats (BMP, JPEG, WMF, EMF, or PCX).
Binary files (TOB1, TOB2, TOB3) can be opened directly in View Pro.
A Time Offset option has been added. This allows the user to specify a time offset that will be applied to each item on the Select line that uses the Date or Edate function to output a date. This may be useful when adjusting for different time zones.
Split now maintains a log file, splitr.log, each time Splitr is run. The main purpose of this log file is to enable users running Splitr in command line mode to identify what happened with each execution of Splitr. If a second instance of Splitr is started when one is already running, another log file, splitrunning.log, will be written. This file simply identifies the time that the second instance of Splitr was started and that Splitr was already running.
xxiii
Preface — What’s New in LoggerNet 4?
CardConvert
A new File Format option, CSIXML, has been added to the Destination File Options. When this option is selected, data is stored in XML format with Campbell Scientific defined elements and attributes.
Troubleshooter
The Troubleshooter now allows the user to customize the possible problems for which warnings will be given. In addition, you can click on any highlighted warning to bring up additional information about the warning.
For array-based dataloggers, you now have the option to do a full hardware reset. You can also now bring up Station Status information for array-based dataloggers. (Previously this was only available for table-based dataloggers.)
Capability has been added to the Comm Test to report Invalid Datalogger Security and Invalid LoggerNet Security.
Network Planner
The Network Planner, a graphical application that assists the user in designing PakBus datalogger networks, is introduced for the first time in LoggerNet 4.0. The Network Planner allows the development of a model of the PakBus network, proposes and verifies valid connections between devices, and allows integration of the model directly into LoggerNet 4.0.
Data Filer
A new File Format option, CSIXML, has been added. When this option is selected, data is stored in XML format with Campbell Scientific defined elements and attributes.
You now have the option of whether or not to include timestamps and/or record numbers in the data file.
RWIS Administrator
RWIS Administrator is a new application that has been added to LoggerNet which provides support for communication with RWIS (Road Weather Information Systems) weather stations.
Alternate Language Support
Certain LoggerNet clients can display the user interface component text (for buttons, dialog boxes, etc.) in a language other than English if a separate LoggerNet language package has been installed. If a language package is installed on your machine, you will see the language in the list for the Languages menu (Options | Languages).
In LoggerNet 4.0, additional applications now have alternate language support. The applications that now support alternate languages are Setup, Connect, Status Monitor, Task Master, Short Cut, CRBasic Editor, View Pro, Card
xxiv
Preface — What’s New in LoggerNet 4?
Convert, TroubleShooter, Network Planner, PakBus Graph, LogTool, the Device Configuration Utility, Data Export, and the RWIS Administrator.
NOTE
Available alternate language packages are provided by Campbell Scientific’s international representatives or on the CSI website. They are not included in a standard LoggerNet installation.
xxv
Preface — What’s New in LoggerNet 4?
xxvi
Loading...
+ 550 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use