CR310 Manual
CR310 Manual
l Prior to performing site or installation work, obtain required approvals and permits. Com-
ply with all governing structure-height regulations, such as those of the FAA in the USA.
l Use only qualified personnel for installation, use, and maintenance of tripods and towers,
and any attachments to tripods and towers. The use of licensed and qualified contractors is
highly recommended.
l Read all applicable instructions carefully and understand procedures thoroughly before
beginning work.
l Wear a hardhat and eye protection, and take other appropriate safety precautions while
working on or around tripods and towers.
l Do not climb tripods or towers at any time, and prohibit climbing by other persons. Take
reasonable precautions to secure tripod and tower sites from trespassers.
l Use only manufacturer recommended parts, materials, and tools.
Maintenance
l Periodically (at least yearly) check for wear and damage, including corrosion, stress cracks,
frayed cables, loose cable clamps, cable tightness, etc. and take necessary corrective
actions.
l Periodically (at least yearly) check electrical ground connections.
DANGER: Fire, explosion, and severe-burn hazard. Misuse or improper installation of the internal
lithium battery can cause severe injury. Do not recharge, disassemble, heat above 100 °C (212 °F),
solder directly to the cell, incinerate, or expose contents to water. Dispose of spent lithium bat-
teries properly.
WARNING:
l When primary power is continuously connected to the datalogger, the battery will last up
to 10 years or more.
l When primary power is NOT connected to the datalogger, the battery will last about three
years.
l See Internal battery (p. 86) for more information.
IMPORTANT: Maintain a level of calibration appropriate to the application. Campbell Scientific
recommends factory recalibration of the datalogger every three years.
WHILE EVERY ATTEMPT IS MADE TO EMBODY THE HIGHEST DEGREE OF SAFETY IN ALL
CAMPBELL SCIENTIFIC PRODUCTS, THE CUSTOMER ASSUMES ALL RISK FROM ANY INJURY
RESULTING FROM IMPROPER INSTALLATION, USE, OR MAINTENANCE OF TRIPODS, TOWERS,
OR ATTACHMENTS TO TRIPODS AND TOWERS SUCH AS SENSORS, CROSSARMS,
ENCLOSURES, ANTENNAS, ETC.
Warranty and
Acknowledgements
The datalogger is warranted for three (3) years subject to this limited warranty: https://www.camp-
bellsci.com/terms#warranty.
Acknowledgements
lwIP
Copyright (c) 2001-2004 Swedish Institute of Computer Science.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted
provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of con-
ditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of con-
ditions and the following disclaimer in the documentation and/or other materials provided
with the distribution.
3. The name of the author may not be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR “AS IS” AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
Table of Contents
1. Data acquisition system components 1
1.1 Sensors 2
1.2 The CR300 Series Datalogger 3
1.2.1 CR300 Series Product Line 3
1.2.2 Overview 3
1.2.3 Operations 4
1.2.4 Programs 4
Table of Contents - i
3.1.4.1 Configuring the datalogger to host a Wi-Fi network 20
3.1.4.2 Connecting your computer to the datalogger over Wi-Fi 20
3.1.4.3 Setting up Wi-Fi communications between the datalogger and the data-
logger support software 21
3.1.4.4 Configuring dataloggers to join a Wi-Fi network 22
3.1.4.5 Wi-Fi LED indicator 23
3.1.5 Cellular Communications 23
3.1.5.1 Cellular (TX/RX) LED Indicator 25
3.1.6 Radio communications 26
3.1.6.1 Configuration options 26
3.1.6.2 RF407-Series radio communications with one or more dataloggers 27
Configuring the RF407-Series radio 28
Setting up communications between the RF407-Series datalogger and the
computer 28
3.1.6.3 RF407-Series radio communications with multiple dataloggers using one
datalogger as a router 29
Configuring the RF407-Series radio 30
Configuring the datalogger acting as a router 30
Adding routing datalogger to LoggerNet network 31
Adding leaf dataloggers to the network 31
Using additional communications methods 32
3.2 Testing communications and completing EZ Setup 32
3.3 Connecting the datalogger to a computer 33
3.4 Creating a program in Short Cut 33
3.5 Sending a program to the datalogger 35
3.5.1 Program run options 36
Table of Contents - ii
5. Data memory 45
5.1 Flash memory 45
5.2 Serial flash memory 45
5.2.1 Data memory 45
5.2.2 CPU drive 46
6. Measurements 47
6.1 Voltage measurements 47
6.1.1 Single-ended measurements 48
6.1.2 Differential measurements 48
6.2 Current-loop measurements 49
6.2.1 Voltage Ranges for Current Measurements 49
6.2.2 Example Current-Loop Measurement Connections 49
6.3 Resistance measurements 51
6.3.1 Resistance measurements with voltage excitation 51
6.3.2 Strain measurements 54
6.3.3 Accuracy for resistance measurements 56
6.4 Period-averaging measurements 57
6.5 Pulse measurements 58
6.5.1 Low-level ac measurements 59
6.5.2 High-frequency measurements 59
6.5.3 Switch-closure and open-collector measurements 59
6.5.3.1 P_SW Terminal 60
6.5.3.2 C terminals 60
6.5.4 Quadrature measurements 60
6.5.5 Pulse measurement tips 62
6.5.5.1 Input filters and signal attenuation 62
6.5.5.2 Pulse count resolution 62
6.6 Vibrating wire measurements 63
6.6.1 VSPECT® 63
7. Communications 64
7.1 General serial communications 65
7.2 Modbus communications 65
7.2.1 About Modbus 66
7.2.2 Modbus protocols 67
7.2.3 Understanding Modbus Terminology 68
Table of Contents - iv
8.4.1 Replacing the internal battery 87
8.5 Electrostatic discharge and lightning protection 88
8.6 Power budgeting 89
8.7 Updating the operating system 89
8.7.1 Sending an operating system to a local datalogger 90
8.7.2 Sending an operating system to a remote datalogger 91
Table of Contents - v
9.10.2.1 Ground potential differences 106
9.10.3 Minimizing power-related artifacts 107
9.10.3.1 Minimizing electronic noise 107
9.10.4 Filtering to Reduce Measurement Noise 108
9.10.5 Minimizing settling errors 110
9.10.5.1 Measuring settling time 110
9.10.6 Factors affecting accuracy 113
9.10.6.1 Measurement accuracy example 113
9.10.7 Minimizing offset voltages 114
9.11 Field calibration 115
9.12 File name and resource errors 115
9.13 Information tables and settings (advanced) 115
9.13.1 Information tables directories 116
9.13.1.1 Frequently used 117
9.13.1.2 Communications 117
General communications 117
PakBus communications 118
TCP_IP communications 118
Cellular communications 118
RF407-Series radio communications 118
Wi-Fi communications 119
9.13.1.3 Background calibration 119
9.13.1.4 Data 119
9.13.1.5 OS and hardware versions 119
9.13.1.6 Power monitoring 119
9.13.1.7 Security 119
9.13.1.8 Signatures 119
9.13.2 Information tables and settings descriptions 120
9.13.2.1 DataTableInfo table system information and settings 120
9.13.2.2 Status Table system information and settings 121
9.13.2.3 Device Configuration Utility settings 127
Cellular settings 145
RF407-series radio settings 152
Wi-Fi settings 157
Table of Contents - vi
10.2 Physical specifications 164
10.3 Power requirements 164
10.4 Power output specifications 166
10.5 Analog measurements specifications 167
10.5.1 Voltage measurements 167
10.5.2 Resistance measurements specifications 169
10.5.3 Period-averaging measurement specifications 169
10.5.4 Current-loop measurement specifications 170
10.6 Pulse measurement specifications 170
10.6.1 Switch-closure input 170
10.6.2 High-frequency input 171
10.6.3 Low-level ac input 171
10.6.4 Quadrature input 171
10.7 Digital input/output specifications 171
10.7.1 Pulse-width modulation specifications 172
10.8 Communications specifications 172
10.8.1 Wi-Fi option specifications 173
10.8.2 RF radio option specifications 173
10.8.3 Cellular option specifications 175
10.8.3.1 -CELL200 (International) 175
10.8.3.2 -CELL205 (North America) 176
10.8.3.3 -CELL210 (United States) 176
10.8.3.4 -CELL215 (EMEA) 176
10.8.3.5 -CELL220 (Australia and New Zealand) 177
10.9 Standards compliance specifications 177
l Sensors - Electronic sensors convert the state of a phenomenon to an electrical signal (see
Sensors (p. 2) for more information).
l Datalogger - The datalogger measures electrical signals or reads serial characters. It con-
verts the measurement or reading to engineering units, performs calculations, and reduces
data to statistical values. Data is stored in memory to await transfer to a computer by way of
an external storage device or a communications link.
l Data Retrieval and Communications - Data is copied (not moved) from the datalogger, usu-
ally to a computer, by one or more methods using datalogger support software. Most com-
munications options are bi-directional, which allows programs and settings to be sent to
the datalogger. For more information, see Sending a program to the datalogger (p. 35).
1.1 Sensors
Sensors transduce phenomena into measurable electrical forms by modulating voltage, current,
resistance, status, or pulse output signals. Suitable sensors do this with accuracy and precision.
Smart sensors have internal measurement and processing components and simply output a
digital value in binary, hexadecimal, or ASCII character form.
Most electronic sensors, regardless of manufacturer, will interface with the datalogger. Some
sensors require external signal conditioning. The performance of some sensors is enhanced with
specialized input modules. The datalogger, sometimes with the assistance of various peripheral
devices, can measure or read nearly all electronic sensor output types.
The following list may not be comprehensive. A library of sensor manuals and application notes
is available at www.campbellsci.com/support to assist in measuring many sensor types.
l Analog
o Voltage
o Current
o Strain
o Thermocouple
o Resistive bridge
l Pulse
o High frequency
o Switch-closure
o Low-level ac
o Quadrature
l Period average
l Vibrating wire (through interface modules)
l Smart sensors
o SDI-12
o RS-232
o Modbus
o DNP3
o TCP/IP (CR310 only)
The CR300 series can include Wi-Fi, cellular, or the following radio options for different regions:
1.2.2 Overview
The CR300 series datalogger is the main part of a data acquisition system (see Data acquisition
system components (p. 1) for more information). It has a central-processing unit (CPU), analog
and digital measurement inputs, analog and digital outputs, and memory. An operating system
(firmware) coordinates the functions of these parts in conjunction with the onboard clock and
the CRBasic application program.
The CR300 series can simultaneously provide measurement and communications functions. Low
power consumption allows the datalogger to operate for extended time on a battery recharged
with a solar panel, eliminating the need for ac power. The CR300 series temporarily suspends
1.2.3 Operations
The CR300 series measures almost any sensor with an electrical response, drives direct com-
munications and telecommunications, reduces data to statistical values, performs calculations,
and controls external devices. After measurements are made, data is stored in onboard, non-
volatile memory. Because most applications do not require that every measurement be recorded,
the program usually combines several measurements into computational or statistical summaries,
such as averages and standard deviations.
1.2.4 Programs
A program directs the datalogger on how and when sensors are measured, calculations are
made, data is stored, and devices are controlled. The application program for the CR300 series is
written in CRBasic, a programming language that includes measurement, data processing, and
analysis routines, as well as the standard BASIC instruction set. For simple applications, Short Cut,
a user-friendly program generator, can be used to generate the program. For more demanding
programs, use the full featured CRBasic Editor.
If you are programming with CRBasic, you can utilize the extensive help available within the
CRBasic Editor (also see https://help.campbellsci.com/CRBasic/CR300/ for searchable, CRBasic
online help).
l Analog input
l Pulse counting
l Analog output
l Communications
l Digital I/O
l Power input
To establish an uninterruptible power supply (UPS), connect the primary power source (often a
transformer, power converter, or solar panel) to the CHG terminals and connect a nominal 12 Vdc
sealed rechargeable battery to the BAT terminals. See Power budgeting (p. 89) for more inform-
ation.
WARNING:
Sustained input voltages in excess of 32 Vdc on CHG or BAT terminals can damage the tran-
sient voltage suppression.
Ensure that power supply components match the specifications of the device to which they are
connected. When connecting power, switch off the power supply, insert the connector, then turn
the power supply on. See Troubleshooting power supplies (p. 102) for more information.
Following is a list of CR300 series power input terminals and the respective power types sup-
ported.
l BAT terminals: Voltage input is 10 to 18 Vdc. This connection uses the least current since
the internal datalogger charging circuit is bypassed. If the voltage on the BAT terminals
exceeds 19 Vdc, power is shut off to certain parts of the datalogger to prevent damaging
connected sensors or peripherals.
l CHG terminals: Voltage input range is 16 to 32 Vdc. Connect a primary power source, such
as a solar panel or Vac-to-Vdc transformer, to CHG. The voltage applied to CHG terminals
must be at least 0.3 V higher than that needed to charge a connected battery. When within
the 16 to 32 Vdc range, it will be regulated to the optimal charge voltage for a lead acid bat-
tery at the current datalogger temperature, with a maximum voltage of approximately 15
Vdc. A battery need not be connected to the BAT terminals to supply power to the data-
NOTE:
The Status field Battery value and the destination variable from the Battery() instruction
(often called batt_volt or BattV) in the Public table reference the external battery
voltage. For information about the internal battery, see Internal battery (p. 86).
2.3 Grounds
Proper grounding lends stability and protection to a data acquisition system. Grounding the data-
logger with its peripheral devices and sensors is critical in all applications. Proper grounding will
ensure maximum ESD protection and measurement accuracy. It is the easiest and least expensive
insurance against data loss, and often the most neglected. The following terminals are provided
for connection of sensor and datalogger grounds:
l Signal Ground ( ) - reference for single-ended analog inputs, excitation returns, and a
ground for sensor shield wires.
o 5 common terminals
l Power Ground (G) - return for 3.3 V, 5 V, 12 V, current loops, and digital sensors. Use of G
grounds for these outputs minimizes potentially large current flow through the analog-
voltage-measurement section of the wiring panel, which can cause single-ended voltage
measurement errors.
o 6 common terminals
l Earth Ground Lug ( ) - connection point for heavy-gage earth-ground wire. A good earth
connection is necessary to secure the ground potential of the datalogger and shunt tran-
sients away from electronics. Campbell Scientific recommends 14 AWG wire, minimum.
NOTE:
Several ground wires can be connected to the same ground terminal.
A good earth (chassis) ground will minimize damage to the datalogger and sensors by providing
a low-resistance path around the system to a point of low potential. Campbell Scientific recom-
mends that all dataloggers be earth grounded. All components of the system (dataloggers,
sensors, external power supplies, mounts, housings) should be referenced to one common earth
ground.
l Computers
l Smart sensors
l Modbus and DNP3 networks
l Ethernet (CR310)
l Modems
l Campbell Scientific PakBus® networks
l Other Campbell Scientific dataloggers
l RS-232
l USB
l Ethernet
l C terminals
l SDI-12
l RS-232 (0 to 5 V)
Some communications types require more than one terminal, and some are only available on spe-
cific terminals. This is shown in the datalogger specifications.
Control decisions can be based on time, an event, or a measured condition. Controlled devices
can be physically connected to C, VX, SE1 -SE4, P_SW, or SW12 terminals. Short Cut has pro-
visions for simple on/off control. Control modules and relay drivers are available to expand and
augment datalogger control capacity.
l C terminals are selectable as binary inputs, control outputs, or communication ports. These
terminals can be set low (0 Vdc) or high (5 Vdc) using the PortSet() or WriteIO()
instructions (see PortSet() and WriteIO() in the CRBasic help for more information).
Other functions include device-driven interrupts, asynchronous communications and SDI-
12 communications. A C terminal configured for digital I/O is normally used to operate an
external relay-driver circuit because the terminal itself has limited drive capacity.
The following image illustrates a simple application wherein a C terminal configured for digital
input, and another configured for control output are used to control a device (turn it on or off)
and monitor the state of the device (whether the device is on or off).
In the case of a cell modem, control is based on time. The modem requires 12 Vdc power, so con-
nect its power wire to a datalogger SW12 terminal. The following code snip turns the modem on
for the first ten minutes of every hour using the TimeIsBetween() instruction embedded in
an If/Then logic statement:
If TimeIsBetween (0,10,60,Min)Then
SW12(1) 'Turn phone on.
Else
SW12(0) 'Turn phone off.
EndIf
For other configurations, see the LoggerNet EZSetup Wizard help. Context-specific help is given
in each step of the wizard by clicking the Help button in the bottom right corner of the window.
For complex datalogger networks, use Network Planner.
Initial setup instruction follows. These settings can be revisited using the datalogger support soft-
ware Edit Datalogger Setup option .
NOTE:
The Power LED on the datalogger indicates the program and power state. Because the
datalogger ships with a program set to run on power-up, the Power LED flashes 3 times
every 10 seconds when powered over USB. When powered with a 12 V battery, it flashes
1 time every 10 seconds.
7. From the COM Port list, select the COM port used for your datalogger.
8. USB and RS-232 connections do not typically require a COM Port Communication Delay -
this allows time for the hardware devices to "wake up" and negotiate a communications
link. Accept the default value of 00 seconds and click Next.
9. The baud rate and PakBus address must match the hardware settings for your datalogger.
NOTE:
Unlike the RS-232 port on some other Campbell Scientific dataloggers that autobaud,
the CR300 RS-232 port does not. If the hardware and software settings for baud rate
and PakBus address do not match, you will not be able to connect.
10. Set an Extra Response Time if you have a difficult or marginal connection and you want
the datalogger support software to wait a certain amount of time before returning a com-
munication failure error.
11. LoggerNet and PC400 users can set a Max Time On-Line to limit the amount of time the
datalogger remains connected. When the datalogger is contacted, communication with it
is terminated when this time limit is exceeded. A value of 0 in this field indicates that there
is no time limit for maintaining a connection to the datalogger.
12. Click Next.
13. By default, the datalogger does not use a security code or a PakBus encryption key. There-
fore, the Security Code can be set to 0 and the PakBus Encryption Key can be left blank. If
either setting has been changed, enter the new code or key. See Datalogger security (p. 82)
for more information.
14. Click Next.
15. Review the Communication Setup Summary. If you need to make changes, click Previous to
return to a previous window and change the settings.
Setup is now complete, and the EZSetup Wizard allows to you click Finish or click Next to test
communications, set the datalogger clock, and send a program to the datalogger. See Testing
communications and completing EZ Setup (p. 32) for more information.
2. Physically connect your datalogger to your computer using a USB cable, then open Device
Configuration Utility and select your datalogger.
3. Select the communication port used to communicate with the datalogger from the COM
Port list.
4. Press Connect, click the Settings Editor tab >Advanced sub-tab > USB Configuration list >
Virtual Ethernet (RNDIS).
5. Click Apply.
6. Retrieve your IP Address. On the bottom, left side of the screen, select Use IP Connection,
then click the browse button next to the Communication Port box. Note the IP Address
(default is 192.168.66.1). If you have multiple dataloggers in your network, more than one
datalogger may be returned. Ensure you select the correct datalogger by verifying the data-
logger serial number or station name (if assigned).
7. A virtual IP address can be used to connect to the datalogger using Device Configuration
Utility or other computer software, or to view the datalogger internal web page in a
browser. To view the web page, open a browser and enter www.linktodevice.com or the IP
address you retrieved in the previous step (for example, 192.168.66.1) into the address bar.
To secure your datalogger from others who have access to your network, we recommend that you
set security and establish access permissions using .csipasswd. For more information, see
Creating a .csipasswd file (p. 84).
7. Click Connect.
8. On the Deployment tab, click the Ethernet subtab.
9. The Ethernet Power setting allows you to reduce the power consumption of the datalogger.
If there is no Ethernet connection, the datalogger will turn off its Ethernet interface for the
time specified before turning it back on to check for a connection. Select Always On, 1
Minute, or Disable.
10. Enter the IP Address, Subnet Mask, and IP Gateway. These values should be provided by
your network administrator. A static IP address is recommended. If you are using DHCP,
note the IP address assigned to the datalogger on the right side of the window. When the
IP Address is set to the default, 0.0.0.0, the information displayed on the right side of the
window updates with the information obtained from the DHCP server. Note, however, that
this address is not static and may change. An IP address here of 169.254.###.### means
the datalogger was not able to obtain an address from the DHCP server. Contact your net-
work administrator for help.
11. Apply to save your changes.
NOTE:
PC200W does not support IP connections.
2. Click Next.
3. Select the CR300 Series from the list, enter a name for your datalogger (for example, a site
or project name), Next.
4. Select the IP Port connection type and click Next.
5. Type the datalogger IP address followed by a colon, then the port number of the data-
logger in the Internet IP Address box (these were set up through the Ethernet com-
munications (p. 17)) step. They can be accessed in Device Configuration Utility on the
Ethernet subtab. Leading 0s must be omitted. For example:
l IPv4 addresses are entered as 192.168.1.2:6785
l IPv6 addresses must be enclosed in square brackets. They are entered as [2001:d-
b8::1234:5678]:6785
6. The PakBus address must match the hardware settings for your datalogger. The default
PakBus address is 1.
l Set an Extra Response Time if you want the datalogger support software to wait a cer-
Setup is now complete, and the EZSetup Wizard allows you Finish or select Next. The Next steps
take you through testing communications, setting the datalogger clock, and sending a program
to the datalogger. See Testing communications and completing EZ Setup (p. 32) for more inform-
ation.
NOTE:
The user is responsible for emissions if changing the antenna type or increasing the gain.
NOTE:
PC200W does not support IP connections.
tain amount of time before returning a communication failure error. This can usually
be left at 00 seconds.
l You can set a Max Time On-Line to limit the amount of time the datalogger remains
Setup is now complete, and the EZSetup Wizard allows you click Finish or click Next to test com-
munications, set the datalogger clock, and send a program to the datalogger. See Testing com-
munications and completing EZ Setup (p. 32) for more information.
this, make sure the IP Address is set to 0.0.0.0. Click Apply to save the con-
figuration changes. Then reconnect. The IP information obtained through DHCP is
updated and displayed in the Status section of the Wi-Fi subtab. Note, however, that
l Off: Insufficient power, Wi-Fi disabled, or datalogger failed to join or create a network
(periodic retries will occur).
l Solid for 2 seconds: Attempting to join or create a network.
l Flashing: Successfully joined or created a network. Flashes with network activity and once
every four seconds.
NOTE:
See Cellular option specifications (p. 175) for more information and carrier compatibility.
1. Obtain an access point name (APN) from your cellular network provider. You will need this
to configure the connection.
2. Insert a supported SIM card into the back of the unit.
l Click the Deployment tab, then click the Cellular sub-tab. Type your APN into the
box, then click Apply. This will disconnect the datalogger from Device Configuration
Utility.
l Reconnect the datalogger using Device Configuration Utility. From the same sub-tab,
copy the IP address from the Cellular Network Status box, then click the Disconnect
button.
7. Using datalogger support software, launch the EZSetup Wizard.
l PC400 users, click the Add Datalogger button ( ).
l LoggerNet users, click the Setup ( ) option, click the View menu to ensure you are
in the EZ (Simplified) view, then click the Add Datalogger button.
l
NOTE:
PC200W does not allow IP connections.
8. Click Next.
9. Select the datalogger from the list, type a name for your datalogger (for example, a site or
project name), and click Next.
10. Select the IP Port connection type and click Next.
l Off: Cellular modem off, insufficient power, or failure to establish a connection with the
provider (periodic retries will occur).
l Solid: Cellular modem is powering up and attempting to establish a connection with a pro-
vider.
l Quick Flashing (approximately 1 second duration): Indicates successful network regis-
tration.
l Flashing: Flashes with network activity.
See also Cellular option specifications (p. 175). For Device Configuration Settings Editor Cellular
settings, see Cellular communications (p. 118).
l The RF407 option has a 902 to 928 MHz operating-frequency range appropriate for use in
the United States and Canada (FCC / IC compliant).
l The RF412 option has a 915 to 928 MHz operating-frequency range appropriate for use in
Australia and New Zealand (ACMA compliant).
l The RF422 option has an 863 to 873 MHz operating-frequency range appropriate for use in
most of Europe and some of Asia (ETSI compliant).
l The RF427 option has a 902 to 907.5 MHz/915 to 928 MHz operating-frequency range
appropriate for use in Brazil.
NOTE:
This equipment has been tested and found to comply with the limits for a Class A digital
device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable
protection against harmful interference when the equipment is operated in a commercial
environment. This equipment generates, uses, and can radiate radio frequency energy and, if
not installed and used in accordance with the instruction manual, may cause harmful inter-
ference to radio communications. Operation of this equipment in a residential area is likely to
cause harmful interference in which case the user will be required to correct the interference
at his or her own expense.
Radio options cannot be mixed within a network. An RF407 can only be used with other RF407-
type radios, an RF412 can only be used with other RF412-type radios, an RF422 can only be used
with other RF422-type radios, and an RF427 can only be used with other RF427-type radios.
Throughout these instructions, RF407-series represents each of the RF407, RF412, RF422, and
RF427 radio options, unless otherwise noted. Similarly, the RF407-series standalone, or inde-
pendent radio represents each of the RF407, RF412, RF422, and RF427 models, unless otherwise
noted.
l Ensure your datalogger and RF407-series radio are connected to an antenna and power.
l Configure the connection to the RF407-series device using Device Configuration Utility.
l If you are connecting to multiple dataloggers, you will have to assign unique PakBus
addresses to each datalogger using Device Configuration Utility. (Connect to each data-
logger, set the PakBus Address on the Deployment | Datalogger tab.)
l Use datalogger support software to set up communications between the RF407-series radio
and the dataloggers.
NOTE:
This procedure assumes the RF407 series devices are using factory default settings.
Setup is now complete, and the EZSetup Wizard allows you to click Finish or click Next to test
communications, set the datalogger clock, and send a program to the datalogger. See Testing
communications and completing EZ Setup (p. 32) for more information.
If you experience network communications problems, see Troubleshooting Radio Com-
munications (p. 100) for assistance.
l Ensure your dataloggers and RF407-series radios are each connected to an antenna and
power.
7. Set the Verify Interval to something slightly greater than the expected communications
interval between the router and the other (leaf) dataloggers in the network (for example,
90 seconds).
8. Click the Advanced sub-tab and set Is Router to True.
9. Apply your changes.
1. Using LoggerNet, click Setup and click the View menu to ensure you are in the Standard
view.
2. Click Add Root .
3. Click ComPort, then PakBusPort (PakBus Loggers), then CR300Series.
4. Click Close.
5. In the Entire Network pane on the left side of the window, select the ComPort.
6. On the Hardware tab on the right, click the ComPort Connection list and select the com-
munication port assigned to the RF407-series radio.
7. In the Entire Network pane on the left side of the window, select PakBusPort.
8. On the Hardware tab on the right, select the PakBus Port Always Open check box.
l If you would like to prevent the possibility of LoggerNet communicating with any
other dataloggers in the network without going through the router, set the Beacon
Interval to 00 h 00 m 00s.
9. In the Entire Network pane on the left side of the window, select the router datalogger
(CR300Series) from the list.
10. On the Hardware tab on the right, type the PakBus Address you assigned to the router data-
logger in Device Configuration Utility.
11. Optionally, click the Rename button ( ) to provide the datalogger a descriptive name.
12. Apply your changes.
1. In the LoggerNet Standard Setup view (click the Setup ( ) option and click the View menu
to ensure you are in the Standard view), right-click on the router datalogger in the Entire
Network pane on the left side of the window and select CR300Series.
2. With the newly added datalogger selected in the Entire Network pane, set the PakBus
Address to the address that was assigned to the leaf datalogger in Device Configuration
Utility.
3. Click Rename. Enter a descriptive name for the datalogger.
If you experience problems with network communications, see Troubleshooting Radio Com-
munications (p. 100) for assistance.
puter time when setting the datalogger clock. This offset will allow you to set the
collected from the datalogger and the output file name. By default, all data tables set
up in the datalogger program will be included for collection. Make note of the Out-
put File Name and location. Click Next.
l Check Scheduled Collection Enabled to have LoggerNet automatically collect data
from the datalogger according to a schedule. When the Base Date and Time are in
the past, scheduled collection will begin on the first Collection Interval. Click Next
twice.
7. Click Finish.
l PC200W and PC400 users, select the datalogger from the list and click Connect .
l LoggerNet users, select Main and click Connect on the LoggerNet toolbar, select the
datalogger from the Stations list, then Connect .
NOTE:
The first time Short Cut is run, a prompt will ask for a noise rejection choice. Select 60 Hz
Noise Rejection for North America and areas using 60 Hz ac voltage. Select 50 Hz Noise Rejec-
tion for most of the Eastern Hemisphere and areas that operate at 50 Hz.
A second prompt lists sensor support options. Campbell Scientific, Inc. (US) is usually the best
fit outside of Europe.
To change the noise rejection or sensor support option for future programs, use the Program
menu.
4. A list of Available Sensors and Devices and Selected Measurements Available for Output dis-
play. Battery voltage BattV and internal temperature PTemp_C are selected by default.
During operation, battery and temperature should be recorded at least daily to assist in
monitoring system status.
5. Use the Search feature or expand folders to locate your sensor or device. Double-click on a
sensor or measurement in the Available Sensors and Devices list to configure the device (if
needed) and add it to the Selected list.
6. If the sensor or device requires configuration, a window displays with configuration
options. Click Help at the bottom of the window to learn more about any field or option.
7. Click OK.
8. Click Wiring Diagram on the left side of the window to see how to wire the sensor to the
datalogger. With the power disconnected from the datalogger, insert the wires as directed
in the diagram. Ensure you clamp the terminal on the conductor, not the wire insulation.
Use the included flat-blade screwdriver to open/close the terminals.
9. Click Sensors on the left side of the window to return to the sensor selection window.
10. Use the Output Setup options to specify how often measurements are to be made and how
often outputs are to be stored. Note that multiple output intervals can be specified, one for
each output table (Table1 and Table2 tabs).
11. In the Table Name box, type a name for the table.
12. Select a Data Output Storage Interval.
13. Click Next.
15. Click Finish to compile the program. Replace the untitled.cr300 default name and click
Save.
16. If LoggerNet or other datalogger support software is running on your computer, and the
datalogger is connected to the computer (see Connecting the datalogger to a computer (p.
33) for more information), you can choose to send the program.
NOTE:
A good practice is to always retrieve data from the datalogger before sending a program; oth-
erwise, data may be lost. See Collecting data (p. 38) for detailed instruction.
If your data acquisition requirements are simple, you can probably create and maintain a data-
logger program exclusively with Short Cut. If your data acquisition needs are more complex, the
files that Short Cut creates are a great source for programming code to start a new program or
add to an existing custom program using CRBasic. See the CRBasic Editor help for detailed
information on program structure, syntax, and each instruction available to the datalogger.
NOTE:
Once a Short Cut generated program has been edited with CRBasic Editor, it can no longer
be modified with Short Cut.
1. Connect the datalogger to your computer (see Connecting the datalogger to a computer
(p. 33) for more information).
2. Using your datalogger support software, click Send New or Send Program (located in the
Current Program section on the right side of the window).
3. Navigate to the the program, select it, and click Open.
4. Confirm that you would like to proceed and erase all data tables saved on the datalogger.
The program will send, compile, then display results.
After sending a program, it is a good idea to monitor the data to make sure sensors are taking
good measurements. See Working with data (p. 37) for more information.
l The Public table is configured by the datalogger program, and updated at the scan interval
set within the datalogger program, It shows measurement and calculation results as they
are made.
l The Status table includes information about the health of the datalogger and is updated
only when viewed.
l The DataTableInfo table reports statistics related to data tables. It also only updates when
viewed.
l User-defined data tables update at the schedule set within the program.
For information on collecting your data, see Collecting data (p. 38).
Use these instructions or follow a tutorial to monitor real-time data.
PC200W and PC400 users, click Connect , then Monitor Data. When this tab is first opened for
a datalogger, values from the Public table are displayed. To view data from other tables, click
Add ( ), select a table or field from the list, then drag it into a cell on the Monitor Data tab.
ted tables stored since the last data collection and appends this data to the end of
the existing table files on the computer. This is the default, and most often used
option.
l All data from datalogger (Overwrite data files): Collects all of the data in the selected
Once the datalogger has had enough time to store multiple records, you should collect and
review the data.
1. To view the most recent data, connect the datalogger to your computer and collect your
data (see Collecting data (p. 38) for more information).
2. Open View Pro:
l LoggerNet users select Data and click View Pro on the LoggerNet toolbar.
l PC200W and PC400 users click View Data Files via View Pro .
3. Click Open , navigate to the directory where you saved your tables (the default directory
is C:\Campbellsci\[your datalogger software application]).
The second header row reports field names. Default field names are a combination of the vari-
able names (or aliases) from which data is derived, and a three-letter suffix. The suffix is an abbre-
viation of the data process that outputs the data to storage. A list of these abbreviations follows
in Data processing abbreviations (p. 42).
If a field is an element of an array, the field name will be followed by a indices within parentheses
that identify the element in the array. For example, a variable named Values, which is declared
as a two-by-two array in the datalogger program, will be represented by four field names: Val-
ues(1,1), Values(1,2), Values(2,1), and Values(2,2). There will be one value in
the second header row for each scalar value defined by the table.
If the default field names are not acceptable to the programmer, the FieldNames() instruc-
tion can be used in the CRBasic program to customize the names. TIMESTAMP, RECORD,
BattV_Avg, PTemp_C_Avg, and Temp_C_Avg are the default field names in the previous
Example data (p. 40).
The third header row identifies engineering units for that field. These units are declared at the
beginning of a CRBasic program using the optional Units() declaration. In Short Cut, units are
chosen when sensors or measurements are added. Units are strictly for documentation. The data-
logger does not make use of declared units, nor does it check their accuracy.
The fourth header row reports abbreviations of the data process used to produce the field of
data.
Use the DataTable() instruction to define the number of records, or rows, allocated to a data
table. You can set a specific number of records, which is recommended for conditional tables, or
allow your datalogger to auto-allocate table size. With auto-allocation, the datalogger balances
the memory so the tables “fill up” (newest data starts to overwrite the oldest data) at about the
same time. It is recommended you reserve the use of auto-allocation for data tables that store
data based only on time (tables that store data based on the DataInterval() instruction).
Event or conditional tables are usually set to a fixed number of records. View data table fill times
for your program on the Station Status | Table Fill Times tab (see Checking station status (p. 94)
for more information). An example of the Table Fill Times tab follows. For information on data
table storage, see the CRBasic help and Data memory (p. 45).
5. Data memory 45
5.2.2 CPU drive
The serial flash memory CPU drive contains datalogger programs and other files. This memory is
managed in File Control.
NOTE:
When writing to files under program control, take care to write infrequently to prevent pre-
mature failure of serial flash memory. Internal chip manufacturers specify the flash tech-
nology used in Campbell Scientific CPU: drives at about 100,000 write/erase cycles. While
Campbell Scientific's in-house testing has found the manufacturers' specifications to be very
conservative, it is prudent to note the risk associated with repeated file writes via program con-
trol.
Also, see System specifications (p. 163) for information on datalogger memory.
5. Data memory 46
6. Measurements
6.1 Voltage measurements 47
6.2 Current-loop measurements 49
6.3 Resistance measurements 51
6.4 Period-averaging measurements 57
6.5 Pulse measurements 58
6.6 Vibrating wire measurements 63
1. Set PGIA gain for the voltage range selected with the CRBasic measurement instruction
parameter Range. Set the ADC for the first notch frequency selected with fN1.
2. If used, turn on excitation to the level selected with ExmV.
3. Multiplex selected terminals (SEChan or DiffChan).
4. Delay for the entered settling time (SettlingTime).
5. Perform the analog-to-digital conversion.
6. Repeat for input reversal as determined by parameter RevDiff.
7. Apply multiplier (Mult) and offset (Offset) to measured result.
Conceptually, analog voltage sensors output two signals: high and low. For example, a sensor
that outputs 1000 mV on the high signal and 0 mV on the low has an overall output of 1000 mV.
A sensor that outputs 2000 mV on the high signal and 1000 mV on the low also has an overall out-
put of 1000 mV. Sometimes, the low signal is simply sensor ground (0 mV). A single-ended meas-
urement measures the high signal with reference to ground; the low signal is tied to ground. A
differential measurement measures the high signal with reference to the low signal. Each con-
figuration has a purpose, but the differential configuration is usually preferred.
6. Measurements 47
In general, use the smallest input range that accommodates the full-scale output of the sensor.
This results in the best measurement accuracy and resolution (see Analog measurements spe-
cifications (p. 167) for more information).
A set overhead reduces the chance of overrange. Overrange limits are available in the spe-
cifications. The datalogger indicates a measurement overrange by returning a NAN for the meas-
urement.
WARNING:
Sustained voltages in excess of -6 V or +9 V (SE1, SE2), ±17 V (SE3 to SE6) applied to ter-
minals configured for analog input will damage CR300 series circuitry.
6. Measurements 48
For more information on voltage measurements, see Improving voltage measurement quality (p.
104) and Analog measurements specifications (p. 167).
Use a CURS100 terminal input module when an application needs more than 2 current inputs or
measurements. For detailed instructions, see http://www.campbellsci.com/curs100.
6. Measurements 49
Sensor Type Connection Example
6. Measurements 50
Sensor Type Connection Example
6. Measurements 51
Resistive-Bridge Type and CRBasic Instruction and
Relational Formulas
Circuit Diagram Fundamental Relationship
Half Bridge1
CRBasic Instruction:
BrHalf()
Fundamental Relationship:
CRBasic Instruction:
BrHalf3W()
Fundamental Relationship:
CRBasic Instruction:
BrHalf4W()
Fundamental Relationship:
6. Measurements 52
Resistive-Bridge Type and CRBasic Instruction and
Relational Formulas
Circuit Diagram Fundamental Relationship
Full Bridge1,2
CRBasic Instruction:
BrFull() These relationships
Fundamental Relationship: apply to
BrFull()
and BrFull6W()
CRBasic Instruction:
BrFull6W()
Fundamental Relationship:
1 Key: V = excitation voltage; V , V = sensor return voltages; Rf = fixed, bridge or completion resistor; Rs = vari-
x 1 2
able or sensing resistor.
2 Campbell Scientific offers terminal input modules to facilitate this measurement.
Offset voltage compensation applies to bridge measurements. RevDiff and MeasOff para-
meters are discussed in Minimizing offset voltages (p. 114). Much of the offset error inherent in
bridge measurements is canceled out by setting RevDiff and MeasOff to True.
CRBasic Example 1: : Four-Wire Full Bridge Measurement and Processing
6. Measurements 53
CRBasic Example 1: : Four-Wire Full Bridge Measurement and Processing
6. Measurements 54
Table 6-1: StrainCalc() configuration codes
BrConfig Code Configuration
Quarter-bridge strain gage1:
Half-bridge strain gage. One gage parallel to +ɛ, the other parallel
to -ɛ1:
3
Full-bridge strain gage. Two gages parallel to +ɛ, the other two par-
allel to -ɛ1:
4
6. Measurements 55
Table 6-1: StrainCalc() configuration codes
BrConfig Code Configuration
Full-bridge strain gage. Half the bridge has two gages parallel to +ɛ
and -ɛ, and the other half to +νɛ and -νɛ 1:
5
Full-bridge strain gage. Half the bridge has two gages parallel to +ɛ
and -νɛ , and the other half to -νɛ and +ɛ1:
6
1 Where
and where:
• "source": the result of the full-bridge measurement (X = 1000 • V1 / Vx) when multiplier = 1 and offset = 0.
• "zero": gage offset to establish an arbitrary zero.
NOTE:
Error discussed in this section and error-related specifications of the CR300 series do not
include error introduced by the sensor, or by the transmission of the sensor signal to the data-
logger.
6. Measurements 56
For accuracy specifications of ratiometric resistance measurements, see Resistance measurements
specifications (p. 169). Voltage measurement is variable V1 or V2 in Resistance measurements (p.
51). Offset is the same as that for simple analog voltage measurements.
Assumptions that support the ratiometric-accuracy specification include:
TIP:
Both pulse count and period-average measurements are used to measure frequency output
sensors. However, their measurement methods are different. Pulse count measurements use
dedicated hardware - pulse count accumulators, which are always monitoring the input sig-
nal, even when the datalogger is between program scans. In contrast, period-average meas-
urements use program instructions that only monitor the input signal during a program scan.
Consequently, pulse count scans can occur less frequently than period-average scans. Pulse
counters may be more susceptible to low-frequency noise because they are always "listening",
whereas period-averaging measurements may filter the noise by reason of being "asleep"
most of the time.
Pulse count measurements are not appropriate for sensors that are powered off between
scans, whereas period-average measurements work well since they can be placed in the scan
to execute only when the sensor is powered and transmitting the signal.
6. Measurements 57
6.5 Pulse measurements
The output signal generated by a pulse sensor is a series of voltage waves. The sensor couples its
output signal to the measured phenomenon by modulating wave frequency. The datalogger
detects the state transition as each wave varies between voltage extremes (high-to-low or low-to-
high). Measurements are processed and presented as counts, frequency, or timing data. Both
pulse count and period-average measurements are used to measure frequency-output sensors.
For more information, see Period-averaging measurements (p. 57).
The datalogger includes terminals that are configurable for pulse input to measure counts or fre-
quency as shown in the following image.
Table 6-2: Pulse input terminals and the input types they can measure
Input Type Pulse Input Terminal Data Option
C (all)
High-frequency
SE 1-4
P_SW
P_LL l Counts
l Frequency
l Running average of fre-
Low-level ac
quency
P_LL
C (all)
Switch-closure
P_SW
6. Measurements 58
Using the PulseCount() instruction, P_LL, P_SW, SE 1-4, and C terminals are configurable for
pulse input to measure counts or frequency. Maximum input frequency is dependent on input
voltage. If pulse input voltages exceed the maximum voltage, third-party external-signal con-
ditioners should be employed. Do not measure voltages greater than 20 V.
Terminals configured for pulse input have internal filters that reduce electronic noise, and thus
reduce false counts. Internal ac coupling is used to eliminate dc offset voltages. For tips on work-
ing with pulse measurements, see Pulse measurement tips (p. 62).
See also Pulse measurement specifications (p. 170).
l Counts
l Frequency (Hz)
l Running average
l Photo-chopper anemometers
l Flow meters
6. Measurements 59
imum high-frequency measurement frequency. Sensors that commonly output a switch-closure
or an open-collector signal include:
Data output options include counts, frequency (Hz), and running average.
6.5.3.2 C terminals
Switch-closure measurements on C terminals require a 100 kΩ pull-up resistor to 12 V. Switch-clos-
ure mode is a special case edge-count function that measures dry-contact switch-closures or
open collectors. The operating system filters bounces.
6. Measurements 60
In the following example, channel A leads channel B, therefore the encoder is determined to be
moving in a clockwise direction. If channel B led channel A, it would be determined that the
encoder was moving in a counterclockwise direction.
Terminals SE1 and SE2 or C1 and C2 can be configured as digital pairs to monitor the two chan-
nels of an encoder. The Quadrature() instruction can return:
l The accumulated number of counts from channel A and channel B. Count will increase if
channel A leads channel B. Count will decrease if channel B leads channel A.
l The net direction.
l Number of counts in the A-leading-B direction.
l Number of counts in the B-leading-A direction.
Counting modes:
l Counting the increase on rising edge of channel A when channel A leads channel B. Count-
ing the decrease on falling edge of channel A when channel B leads channel A.
l Counting the increase at each rising and falling edge of channel A when channel A leads
channel B. Counting the decrease at each rising and falling edge of channel A when chan-
nel A leads channel B.
l Counting the increase at each rising and falling edge of both channels when channel A
leads channel B. Counting the decrease at each rising and falling edge of both channels
when channel B leads channel A.
6. Measurements 61
6.5.5 Pulse measurement tips
The PulseCount() instruction uses dedicated 32-bit counters to accumulate all counts over
the programmed scan interval. The resolution of pulse counters is one count or 1 Hz. Counters
are read at the beginning of each scan and then cleared. Counters will overflow if accumulated
counts exceed 4,294,967,296 (232), resulting in erroneous measurements.
Counts are the preferred PulseCount() output option when measuring the number of tips
from a tipping-bucket rain gage or the number of times a door opens. Many pulse-output
sensors, such as anemometers and flow meters, are calibrated in terms of frequency (Hz) so are
usually measured using the PulseCount() frequency-output option.
Use the LLAC4 module to convert non-TTL-level signals, including low-level ac signals, to TTL
levels for input to C terminals
Understanding the signal to be measured and compatible input terminals and CRBasic instruc-
tions is helpful. See Pulse input terminals and the input types they can measure (p. 58).
6. Measurements 62
6.6 Vibrating wire measurements
The datalogger can measure vibrating wire sensors through vibrating-wire interface modules.
Vibrating wire sensors are the sensor of choice in many environmental and industrial applications
that need sensor stability over very long periods, such as years or even decades. A thermistor
included in most sensors can be measured to compensate for temperature errors.
6.6.1 VSPECT®
Measuring the resonant frequency by means of period averaging is the classic technique, but
Campbell Scientific has developed static and dynamic spectral-analysis techniques (VSPECT) that
produce superior noise rejection, higher resolution, diagnostic data, and, in the case of dynamic
VSPECT, measurements up to 333.3 Hz. For detailed information on VSPECT, see Vibrating Wire
Spectral Analysis Technology.
6. Measurements 63
7. Communications
Dataloggers communicate with datalogger support software, other Campbell Scientific data-
loggers, and other hardware and software using a number of protocols including PakBus, Mod-
bus, DNP3, and TCP/IP. Several industry-specific protocols are also supported.See also
Communications specifications (p. 172).
l Declare Public only those variables that need to be public. Other variables should be
declared as Dim.
l Be conservative with use of string variables and string variable sizes. Make string variables
as big as they need to be and no more. The default size, if not specified, is 24 bytes, but the
minimum is 4 bytes. Declare string variables Public and sample string variables into data
tables only as needed.
l When using GetVariables() / SendVariables() to send values between data-
loggers, put the data in an array and use one command to get the multiple values. Using
one command to get 10 values from an array and swath of 10 is more efficient (requires
only 1 transaction) than using 10 commands to get 10 single values (requires 10 trans-
actions).
l Set the datalogger to be a PakBus router only as needed. When the datalogger is a router,
and it connects to another router like LoggerNet, it exchanges routing information with
that router and, possibly (depending on your settings), with other routers in the network.
Network Planner set this appropriately when it is used. This is also set through the IsRouter
setting in the Settings Editor.
l Set PakBus beacons and verify intervals properly. For example, there is no need to verify
routes every five minutes if communications are expected only every 6 hours. Network Plan-
7. Communications 64
ner will set this appropriately when it is used. This is also set through the Beacon and Verify
settings in the Settings Editor.
For information on Designing a PakBus network using the Network Planner tool in LoggerNet,
watch a video.
l SerialOpen()
l SerialClose()
l SerialIn()
l SerialInRecord()
l SerialInBlock()
l SerialOut()
l SerialOutBlock()
To communicate over a serial port, it is important to be familiar with protocol used by the device
with which you will be communicating. Refer to the manual of the sensor or device to find its pro-
tocol and then select the appropriate options for each CRBasic parameter. See the application
note Interfacing Serial Sensors with Campbell Scientific Dataloggers for more programming
details and examples.
NOTE:
Though Com1 uses RS-232 logic levels, it is limited to 0 V (logic high) and 5 V (logic low) out-
put. This may make Com1 incompatible with some serial devices.
Com1 is not capable of TTL logic levels and so is not compatible with TTL-to-RS-232 con-
verters for the purpose of presenting a true RS-232 interface.
Com1 also has a low input resistance that may make it incompatible with some serial devices
with the addition of in-line resistance.
7. Communications 65
networks. Dataloggers can communicate using Modbus on all available communication ports.
The datalogger communicates using Modbus over RS-232 using a RS-232-to RS-485 adapter and
over TCP using an Ethernet or Wireless connection.
CRBasic Modbus instructions include (see CRBasic Editor help for the most recent information on
each of these instructions and for program examples):
l ModbusMaster()
l ModbusSlave()
l MoveBytes()
Because Modbus has a set command structure, programming the datalogger to get data from
field instruments can be much simpler than from some other serial sensors. Because Modbus uses
a common bus and addresses each node, field instruments are effectively multiplexed to a data-
logger without additional hardware.
When doing Modbus communications over RS-232, the datalogger, through Device Con-
figuration Utility or the Settings editor, can be set to keep communication ports open and awake,
but at higher power usage. Set RS-232Power to Always on. Otherwise, the datalogger goes into
sleep mode after 40 seconds of communications inactivity. Once asleep, two packets are required
before it will respond. The first packet awakens the datalogger; the second packet is received as
data. This would make a Modbus master fail to poll the datalogger, if not using retries.
More information on Modbus can be found at:
l www.simplyModbus.ca/FAQ.htm
l www.Modbus.org/tech.php
l www.lammertbies.nl/comm/info/modbus.html
7. Communications 66
The popularity of Modbus has grown because it is freely available and because its messaging
structure is independent of the type of physical interface or connection that is used. Modbus can
coexist with other types of connections on the same physical interface at the same time. You can
operate the protocol over several data links and physical layers.
Modbus is supported by many industrial devices, including those offered by Campbell Scientific.
Not only can intelligent devices such as microcontrollers and programmable logic controllers
(PLCs) communicate using Modbus, but many intelligent sensors have a Modbus interface that
enables them to send their data to host systems. Examples of using Modbus with Campbell
Scientific dataloggers include:
l Modbus RTU — Modbus RTU is the most common implementation available for Modbus.
Used in serial communications, data is transmitted in a binary format. The RTU format fol-
lows the commands/data with a cyclic redundancy check checksum.
7. Communications 67
NOTE:
The Modbus RTU protocol standard does not allow a delay between characters of 1.5 times or
more the length of time normally required to receive a character. This is analogous to “pizza”
being understood, and “piz za” being gibberish. It's important to note that communications
hardware used for Modbus RTU, such as radios, must transfer data as entire packets without
injecting delays in the middle of Modbus messages.
Campbell Scientific dataloggers support Modbus RTU, Modbus ASCII, and Modbus TCP pro-
tocols. If the connection is over IP, Campbell Scientific dataloggers always use Modbus TCP. Mod-
bus slave functionality over other comports use RTU. When acting as a master, the datalogger
can be switched between ASCII and RTU protocols using an option in the ModbusMaster()
instruction.
7. Communications 68
7.2.5 About Modbus communications
Modbus is a master-slave protocol. The device requesting the information is called the Modbus
master, and the devices supplying information are Modbus slaves. In a standard Modbus net-
work, there is one master and up to 247 slaves. A master does not have a Modbus address.
However, each Modbus slave on a shared network has a unique address from 1 to 247.
A single Modbus master device initiates commands (requests for information), sending them to
one or more Modbus slave devices on the same network. Only the Modbus master can initiate
communications. Modbus slaves, in turn, remain silent, communicating only when responding to
requests from the Modbus master.
Every message from the master will begin with the slave address, followed by the function code,
function parameters, and a checksum. The slave will respond with a message beginning with its
address, followed by the function code, data, and a checksum. The amount of data in the packet
will vary, depending on the command sent to the slave. Slave devices only process one command
at a time. So, the master needs to wait for a response, or timeout before sending the next com-
mand.
A broadcast address is specified to allow simultaneous communications with all slaves. Because
response time of slave devices is not specified by the standard, and device manufacturers also
rarely specify a maximum response time, broadcast features are rarely used. When implementing
a system, timeouts in the master will need to be adjusted to account for the observed response
time of the slaves.
Campbell Scientific dataloggers can be programmed to be a Modbus master or Modbus slave -
or even both at the same time! This proves particularly helpful when your datalogger is a part of
two wider area networks. In one it uses Modbus to query data (as a master) from localized
sensors or other data sources, and then in the other, it serves that data up (as a slave) to another
Modbus master.
7. Communications 69
7.2.6.1 Endianness
Endianness refers to the sequential order in which bytes are arranged into larger numerical values
when stored in memory. Words may be represented in big-endian or little-endian format,
depending on whether bits or bytes or other components are ordered from the big end (most sig-
nificant bit) or the little end (least significant bit).
In big-endian format, the byte containing the most significant bit is stored first, then the fol-
lowing bytes are stored in decreasing significance order, with the byte containing the least sig-
nificant bit stored last. Little-endian format reverses this order: the sequence stores the least
significant byte first and the most significant byte last. Endinness is used in some Modbus pro-
gramming so it is important to note that the CR300 is a little-endian instrument.
The write-register functions will only work on holding registers. Function 06 only changes one 16-
bit register, whereas function 16, changes multiple registers. Note, when writing registers, the
Variable parameter for the ModbusMaster() instruction refers to a source, not a des-
tination.
7. Communications 70
7.2.7 Modbus information storage
With the Modbus protocol, most of the data values you want to transmit or receive are stored in
registers. Information is stored in the slave device in four different entities. Two store on/off dis-
crete values (coils) and two store numerical values (registers). The four entities include:
l Coils – 1-bit registers, used to control discrete outputs (including Boolean values),
read/write.
l Discrete Input – 1-bit registers, used as inputs, read only.
l Input Registers – 16-bit registers, used as inputs, read only.
l Holding Registers – 16-bit registers; used for inputs, output, configuration data, or any
requirement for “holding” data; read/write.
7.2.7.1 Registers
In a 16-bit memory location, a 4-byte value takes up two registers. The Modbus protocol always
refers to data registers with a starting address number, and a length to indicate how many
registers to transfer.
Campbell Scientific uses 1-based numbering (a common convention for numbering registers in
equipment) in the ModbusMaster() instruction. With 1-based numbering, the first data loc-
ation is referred to as register number 1. Some equipment uses 0-based numbering (check the
equipment documentation). With 0-based numbering, the first register is referred to as 0.
Reading register numbers can be complicated by the fact that register numbers are often written
with an offset added. Input registers are written with an offset of 30000. So, the first input register
is written as 30001, with 1-based numbering. Holding registers are numbered with an offset of
40000. You must remove the offset before writing the number as the Start parameter of Mod-
busMaster().
There are rare instances when equipment is designed with the registers mapped including the off-
set. That means 40001 in the documentation is really register number 40001. Those are rare
instances, and the equipment is deviating from standards. If 1 or 2 don’t work for the Start para-
meter, try 40001 and 40002.
7.2.7.2 Coils
Discrete digital I/O channels in Modbus are referred to as coils. The term coil has its roots in
digital outputs operating solenoid coils in an industrial environment. Coils may be read only or
read/write. A read only coil would be a digital input. A read/write coil is used as an output. Coils
are read and manipulated with their own function codes, apart from the registers. Many modern
devices do not utilize coils at all.
7. Communications 71
When working with coils, the datalogger requires Boolean variables. When reading coils, each
Boolean in an array will hold the state of one coil. A value of True will set the coil, a value of
False will unset the coil.
7. Communications 72
them as the Variable parameter in ModbusMaster(). Select the appropriate ModbusOption
to avoid post-processing.
l www.simplyModbus.ca/FAQ.htm
l www.Modbus.org/tech.php
l www.lammertbies.nl/comm/info/modbus.html
7. Communications 73
An uncommon cause for the -01 result is a device with an incomplete implementation of Mod-
bus. Some devices do not fully implement parsing Modbus commands. Instead, they are hard-
coded to respond to certain Modbus messages. The result is that the device will report an error
when you try selectively polling registers. Try requesting all of the registers together.
l EmailRelay() l HTTPPut()
l EmailSend() l IPInfo()
l EmailRcv() l PPPOpen()
7. Communications 74
l FTPClient()
l PPPClose()
l HTTPGet()
l TCPOpen()
l HTTPOut()
l TCPClose()
l HTTPPost()
See the CRBasic help for detailed information and program examples.
For additional information on DNP3 see:
7. Communications 75
In a PakBus network, each datalogger is assigned a unique address. The default PakBus address
in most devices is 1. To communicate with the datalogger, the datalogger support software must
know the datalogger PakBus address. The PakBus address is changed using Device Configuration
Utility, datalogger Settings Editor, or PakBus Graph software.
CRBasic PakBus instructions include:
l GetDataRecord()
l GetVariables()
l SendData()
l SendGetVariables()
l SendVariables()
7. Communications 76
Transparent mode is entered while the computer is communicating with the datalogger through
a terminal emulator program such as through Device Configuration Utility or other datalogger
support software. Keyboard displays cannot be used. For how-to instructions for communicating
directly with an SDI-12 sensor using a terminal emulator, watch this video.
To enter the SDI-12 transparent mode, enter the datalogger support software terminal emulator:
1. Press Enter until the datalogger responds with the prompt CR300 series>.
2. Type SDI12 at the prompt and press Enter.
3. In response, the query Enter Cx Port is presented with a list of available ports. Enter
the port number assigned to the terminal to which the SDI-12 sensor is connected, and
press Enter. For example, 1 is entered for terminal C1.
4. An Entering SDI12 Terminal response indicates that SDI-12 transparent mode is
active and ready to transmit SDI-12 commands and display responses.
The terminal-mode utility allows monitoring of SDI-12 traffic by using the watch command
(sniffer mode). Watch an instructional this video or use the following instructions.
l Sensor address ( a): A single character and the first character of the command. Sensors are
usually assigned a default address of zero by the manufacturer. The wildcard address ( ?) is
used in the Address Query command. Some manufacturers may allow it to be used in
7. Communications 77
other commands. SDI-12 sensors accept addresses 0 through 9, a through z, and A through
Z.
l Command body (for example, M1): An upper case letter (the “command”) followed by
alphanumeric qualifiers.
l Command termination ( !): An exclamation mark.
An active sensor responds to each command. Responses have several standard forms and ter-
minate with <CR><LF> (carriage return–line feed).
7. Communications 78
Details of using the SDI12SensorSetup() / SDI12SensorResponse() instruction pair
can be found in the CRBasic Editor help.
When programmed as an SDI-12 sensor, the datalogger will respond to SDI-12 commands M, MC,
C, CC, R, RC, V, ?, and I.
When acting as a sensor, the datalogger can be assigned only one SDI-12 address per SDI-12
port. For example, a datalogger will not respond to both 0M! and 1M! on SDI-12 port C1.
However, different SDI-12 ports can have unique SDI-12 addresses.
l Quiescent: 0.25 mA
l Active: 66 mA
l Measurement: 120 mA
Measurement time: 15 s
Timeout: 15 s
Probes 1, 2, 3, and 4 are connected to SDI-12 port C1.
The time line in the following table shows a 35-second power-usage profile example.
For most applications, total power usage of 318 mA for 15 seconds is not excessive, but if 16
probes were wired to the same SDI-12 port, the resulting power draw would be excessive. Spread-
ing sensors over several SDI-12 terminals helps reduce power consumption.
7. Communications 79
Table 7-1: Example power use for a network of SDI-12 probes
All Time
Time into Meas- Probe Probe Probe Probe Total
Command Probes Out
urement Processes 1 (mA) 2 (mA) 3 (mA) 4 (mA) (mA)
Awake Expires
15 Yes 120 66 66 66 318
16 1D0! Yes 66 66 66 66 264
17-29 66 66 66 66 264
30 Yes 66 66 66 66 264
Sleep 0.25 0.25 0.25 0.25 1
7. Communications 80
8. Maintaining your datalogger
Protect the datalogger from humidity and moisture. When humidity levels reach the dewpoint,
condensation occurs, and damage to datalogger electronics can result. Adequate desiccant
should be placed in instrumentation enclosure to provide protection, and control humidity. Desic-
cant should be changed periodically.
If sending the datalogger to Campbell Scientific for calibration or repair, consult first with Camp-
bell Scientific. If the datalogger is malfunctioning, be prepared to perform some troubleshooting
procedures (see Tips and troubleshooting (p. 93)).
Also, consider checking, or posting your question to, the Campbell Scientific user forum
http://www.campbellsci.com/forum. Our web site https://www.campbellsci.com has additional
manuals (with example programs), FAQs, specifications and compatibility information for all of
our products.
Video tutorials https://www.campbellsci.com/videos and blog articles https://www.camp-
bellsci.com/blog are also useful troubleshooting resources.
If calibration or repair is needed, the procedure shown on: https://www.campbellsci.com/repair
should be followed when sending the product.
You can download and print calibration certificates for many products you have purchased by
logging in to the Campbell Scientific website and going to: https://www.camp-
bellsci.com/calcerts.
NOTE:
Note, you will need your product's serial number to access its certificate.
l Sending the latest operating system to the datalogger. See Updating the operating system
(p. 89) for more information.
l Disabling unused services and securing those that are used. This includes disabling HTTP,
HTTPS, FTP, Telnet, and Ping network services (Device Configuration Utility > Deployment
> Network Services tab). These services can be used to discover your datalogger on an IP
network.
NOTE:
FTP, Telnet, and Ping services are disabled by default.
WARNING:
All security features can be subverted through physical access to the datalogger. If absolute
security is a requirement, the physical datalogger must be kept in a secure location.
l Device Configuration Utility: Security codes are set on the Deployment> Datalogger tab.
l Network Planner: Security codes can be set as dataloggers are added to the network.
Alternatively, in CRBasic the SetSecurity() instruction can be used. It is only executed at pro-
gram compile time. This is not recommended because deleting SetSecurity() from a
CRBasic program is not equivalent to SetSecurity(0,0,0). Settings persist when a new pro-
gram is downloaded that has no SetSecurity() instruction.
Up to three levels of security can be set. Valid security codes are 1 through 65535 ( 0 confers no
security). Security 1 must be set before Security 2. Security 2 must be set before Security 3. If any
one of the codes is set to 0, any security code level greater than it will be set to 0. For example, if
Security 2 is 0 then Security 3 is automatically set to 0. Security codes are unlocked in reverse
order: Security 3 before Security 2, Security 2 before Security 1.
See Security (p. 119) for the related fields in the Settings Editor.
For additional information on datalogger security, see:
NOTE:
All levels of access allow data collection.
Create an encrypted password file or modify an existing password file using Device Configuration
Utility:
When a .csipasswd file is used, the PakBus/TCP Password security setting is not used when
accessing the datalogger via HTTP. If the .csipasswd file is blank or does not exist, the default
user name is "anonymous" with no password and a user level of read only.
When access to the datalogger web server is attempted without the appropriate security level,
the datalogger will prompt the web client to display a username and password request dialog. If
an invalid username or password is entered, the datalogger web server will default to the level of
access assigned to “anonymous”. As noted previously, anonymous is assigned a user level of
read-only, though this can be changed using Device Configuration Utility.
If the numeric security code has been enabled, and no .csipasswd file is on the datalogger,
then that numeric security code must be entered to access the datalogger. If a .csipasswd file
is on the datalogger, the username and password employed by the basic access authentication
will eliminate the need for entering the numeric security code.
WARNING:
Do not completely seal the enclosure if lead-acid batteries are present; hydrogen gas gen-
erated by the batteries may build to an explosive concentration.
The following details a typical installation using a Campbell Scientific enclosure. The datalogger
has mounting holes through which small screws are inserted into nylon anchors in the backplate.
NOTE:
The battery is replaced during regular factory recalibration, which is recommended every 3
years. For more information, see Datalogger calibration (p. 81).
A replacement lithium battery can be purchased from Campbell Scientific or another supplier.
l 3 V coin cell CR2016 for battery-backed clock. 6-year life with no external power source.
WARNING:
Misuse or improper installation of the internal lithium battery can cause severe injury. Fire,
explosion, and severe burns can result. Do not recharge, disassemble, heat above 100 °C (212
°F), solder directly to the cell, incinerate, or expose contents to water. Dispose of spent lith-
ium batteries properly.
NOTE:
The Status field Battery value and the destination variable from the Battery() instruction
(often called batt_volt) in the Public table reference the external battery voltage.
WARNING:
Any damage made to the datalogger during user replacement of the internal battery is not
covered under warranty.
Electrostatic discharge (ESD) can originate from several sources, the most common and destruct-
ive are primary and secondary lightning strikes. Primary lightning strikes hit instrumentation dir-
ectly. Secondary strikes induce voltage in power lines or wires connected to instrumentation.
While elaborate, expensive, and nearly infallible lightning protection systems are on the market,
Campbell Scientific, for many years, has employed a simple and inexpensive design that protects
most systems in most circumstances. The system consists of a lightning rod, metal mast, heavy-
gauge ground wire, and ground rod to direct damaging current away from the datalogger. This
system, however, is not infallible. The following image displays a typical application of the sys-
tem:
See also:
WARNING:
Because sending an OS resets datalogger memory and resets all settings on the datalogger to
factory defaults, data loss will certainly occur. Depending on several factors, the datalogger
may also become incapacitated for a time.
TIP:
It is recommended that you retrieve data from the datalogger and back up your programs
and settings before updating your OS. To collect data using LoggerNet, connect to your data-
logger and click Collect Now . To backup your datalogger, connect to it in Device Con-
figuration Utility, click the Backup menu and select Backup Datalogger.
If you have a datalogger that is already deployed, you can update the OS over a tele-
communications link by sending the OS to the datalogger as a program. In most instances, send-
ing an OS as a program preserves settings. This allows for sending supported operating systems
remotely (check the release notes). However, this should be done with great caution as updating
the OS may reset the datalogger settings, even settings critical to supporting the tele-
communication link.
l Any peripherals being powered through the SW12 terminal will be turned off until the pro-
gram logic turns them on again.
l Operating systems are very large files. Be cautious of data charges. Sending over a direct
serial or USB connection is recommended, when possible.
1. Using a voltmeter, check the voltage of the primary power source at the CHG and BAT ter-
minals on the face of the datalogger, it should be 10 to 18 Vdc. If connecting to a power
source via the CHG terminals, voltage measured should be 16 to 32 Vdc.
2. Check wires and cables for the following:
l Incorrect wiring connections. Make sure each sensor and device are wired to the ter-
minals assigned in the program. If the program was written in Short Cut, check wiring
against the generated wiring diagram. If written in CRBasic Editor, check wiring
against each measurement and control instruction.
l Loose connection points
l Faulty connectors
l Cut wires
l Damaged insulation, which allows water to migrate into the cable. Water, whether or
not it comes in contact with wire, can cause system failure. Water may increase the
dielectric constant of the cable sufficiently to impede sensor signals, or it may
migrate into the sensor, which will damage sensor electronics.
3. Check the CRBasic program. If the program was written solely with Short Cut, the program
is probably not the source of the problem. If the program was written or edited with
CRBasic Editor, logic and syntax errors could easily have crept in. To troubleshoot, create a
simpler version of the program, or break it up into multiple smaller units to test indi-
vidually. For example, if a sensor signal-to-data conversion is faulty, create a program that
only measures that sensor and stores the data, absent from all other inputs and data.
4. Reset the datalogger. Sometimes the easiest way to resolve a problem is by resetting the
datalogger (see Resetting the datalogger (p. 100) for more information).
l From LoggerNet: Click Connect , then Station Status to view the Summary tab.
l From PC200W and PC400: Select the Datalogger menu and Station Status to view the
Summary tab.
l Transient voltage
l Incorrectly wired or malfunctioning sensor
l Poor ground connection on the power supply
l Numerous PortSet() instructions back-to-back with no delay
l High-speed serial data on multiple ports with very large data packets or bursts of data
The error "Results for Last Program Compiled: Warning: Watchdog Timer IpTask Triggered" can
result from:
l The IP communications on the datalogger got stuck, and the datalogger had to reboot
itself to recover. Or communications failures may cause the datalogger to reopen the IP
connections more than usual. Check your datalogger operating system version; recent oper-
ating system versions have improved stability of IP communications.
If any of these are not the apparent cause, contact Campbell Scientific for assistance (see
https://www.campbellsci.com/support). Causes that may require assistance include:
l Memory corruption
l Operating System problem
l Hardware problem
l IP communications problem
l Input signals exceed the voltage range chosen for the measurement.
l An invalid SDI-12 command is sent
l An SDI-12 sensor does not respond or aborts without sending data
l Undefined arithmetic expressions, such as 0 ÷ 0.
NAN is a constant that can be used in expressions. This is shown in the following code snip that
sets a CRBasic variable to False when the wind direction is NAN:
If WindDir = NAN Then
WDFlag = False
Else
WDFlag = True
EndIf
NOTE:
There is no such thing as NAN for integers. Values that are converted from float to integer
will be expressed in data tables as the most negative number for a given data type. For
example, the most negative number of data type FP2 is –7999; so, NAN for FP2 data will
appear in a data table as –7999. If the data type is Long, NAN will appear in the data table as
–2,147,483,648.
Because NAN is a constant, it can be used in conjunction with the disable variable parameter
(DisableVar) in output processing instructions. Use variable = NAN in the DisableVar
parameter to discard NANs from affecting the other good values.
9.3 Timekeeping
Measurement of time is an essential datalogger function. Time measurement with the onboard
clock enables the datalogger to run on a precise interval, attach time stamps to data, measure
the interval between events, and time the initiation of control functions. Details on clock accur-
acy and resolution are available in the System specifications (p. 163). An internal lithium battery
backs the clock when the datalogger is not externally powered (see Internal battery (p. 86)).
time skew = reps * (settling time + integration time + ADC time) + instruction setup
time
where ADC time equals 170 µs, and instruction setup time is 15 µs.
If reps (repetitions) > 1 (multiple measurements by a single instruction), no setup
time is required. If reps = 1 for consecutive voltage instructions, include the setup
time for each instruction.
l Program execution times are usually short; so, time-stamp skew is only a few milliseconds.
Most measurement requirements allow for a few milliseconds of skew.
l Data processed into averages, maxima, minima, and so forth are composites of several
measurements. Associated time stamps only reflect the time of the scan when processing
calculations were completed; so, the significance of the exact time a specific sample was
measured diminishes.
Applications measuring and storing sample data wherein exact time stamps are required can be
adversely affected by time-stamp skew. Skew can be avoided by:
l The datalogger has a different operating system than the computer compiler. Check the
two versions if in doubt. The computer compiler version is shown on the first line of the
compile results. Update the computer compiler by first downloading the executable OS file
from www.campbellsci.com. When run, the executable file updates the computer compiler.
To update the datalogger operating system, see Updating the operating system (p. 89).
l The program has large memory requirements for data tables or variables and the data-
logger does not have adequate memory. This normally is flagged at compile time in the
compile results. If this type of error occurs:
o Check the CPU drive for copies of old programs. The datalogger keeps copies of all
program files unless they are deleted, the drive is formatted, or a new operating sys-
tem is loaded with Device Configuration Utility.
l Processor reset
l Program send reset
TIP:
It is good practice to always collect data before sending a program to the datalogger.
When a program compiles, all variables are initialized. A program is recompiled after a power fail-
ure or a manual stop. For instances that require variables to be preserved through a program
recompile, the CR300 series have the PreserveVariables() and Pre-
serveOneVariable() instructions and User Settings. Entries in User Settings are not erased
when a program is recompiled.
User Settings can be entered manually in Device Configuration Utility in the Settings Editor >
User Settings tab, or they can be written through a CRBasic program using the SetSetting()
instruction.
NOTE:
User settings are stored in flash memory. To avoid corrupting the flash memory, edit these set-
tings infrequently.
l Datalogger support software: Station Status > Table Fill Times tab, Reset Tables.
l Device Configuration Utility: Data Monitor tab, Reset Table button.
See Updating the operating system (p. 89) for more information.
l Battery-voltage test
l Charging-circuit test (when using an unregulated solar panel)
l Charging-circuit test (when using a transformer)
l Adjusting charging circuit
With Rg in the resistor network, the signal measured from the sensor is described by the fol-
lowing equation:
where
RsRf/Rg is the source of error due to the ground loop. When Rg is large, the error is negligible.
Note that the geometry of the electrodes has a great effect on the magnitude of this error. The
Delmhorst gypsum block used in the Campbell Scientific 227 probe has two concentric cylindrical
l Not enough differential terminals are available. Differential measurements use twice as
many analog input terminals as do single-ended measurements.
l Rapid sampling is required. Single-ended measurement time is about half that of dif-
ferential measurement time.
l Sensor is not designed for differential measurements. Some Campbell Scientific sensors are
not designed for differential measurement, but the drawbacks of a single-ended meas-
urement are usually mitigated by large programmed excitation and/or sensor output
voltages.
Sensors with a high signal-to-noise ratio, such as a relative-humidity sensor with a full-scale out-
put of 0 to 1000 mV, can normally be measured as single-ended without a significant reduction
in accuracy or precision.
Sensors with a low signal-to-noise ratio, such as thermocouples, should normally be measured
differentially. However, if the measurement to be made does not require high accuracy or pre-
cision, such as thermocouples measuring brush-fire temperatures, which can exceed 2500 °C, a
single-ended measurement may be appropriate. If sensors require differential measurement, but
adequate input terminals are not available, an analog multiplexer should be acquired to expand
differential input capacity.
Because a single-ended measurement is referenced to datalogger ground, any difference in
ground potential between the sensor and the datalogger will result in an error in the meas-
urement. For more information on grounds, see Grounds (p. 9) and Minimizing ground potential
differences (p. 105).
If offset problems occur because of shield or ground wires with large current flow, tying the prob-
lem wires into terminals next to terminals configured for excitation and pulse-count should help.
Problem wires can also be tied directly to the ground lug to minimize induced single-ended off-
set voltages.
l Minimize time skew between successive measurements Avoiding time skew (p. 98).
l Maximize throughput rate.
l Maximize life of the datalogger power supply.
l Minimize polarization of polar sensors such as those for measuring conductivity, soil mois-
ture, or leaf wetness. Polarization may cause measurement errors or sensor degradation.
l Do not use leads with PVC-insulated conductors. PVC has a high dielectric constant, which
extends input settling time.
l Where possible, run excitation leads and signal leads in separate shields to minimize tran-
sients.
l When measurement speed is not a prime consideration, additional time can be used to
ensure ample settling time.
l In difficult cases where measurement speed is a consideration, an appropriate settling time
can be determined through testing.
Each trace in the following image contains all twenty PT() mV/V values (left axis) for a given
record number and an average value showing the measurements as percent of final reading
(right axis). The reading has settled to 99.5% of the final value by the fourteenth measurement,
which is contained in variable PT(14). This is suitable accuracy for the application, so a settling
time of 1400 µs is determined to be adequate.
where percents-of-reading and offsets are displayed in the Analog measurements specifications
(p. 167).
NOTE:
Error discussed in this section and error-related specifications of the datalogger do not
include error introduced by the sensor, or by the transmission of the sensor signal to the data-
logger.
Remedies include:
Single-ended measurements are susceptible to voltage drop at the ground terminal caused by
return currents from another device that is powered from the datalogger wiring panel, such as
another manufacturer's communications modem, or a sensor that requires a lot of power. Cur-
rents greater than 5 mA are usually undesirable. The error can be avoided by routing power
grounds from these other devices to a power ground G terminal, rather than using a signal
ground ( ) terminal. Ground currents can be caused by the excitation of resistive-bridge
sensors, but these do not usually cause offset error. These currents typically only flow when a
voltage excitation is applied. Return currents associated with voltage excitation cannot influence
other single-ended measurements because the excitation is usually turned off before the data-
logger moves to the next measurement. However, if the CRBasic program is written in such a way
that an excitation terminal is enabled during an unrelated measurement of a small voltage, an
offset error may occur.
The Seebeck effect results in small thermally induced voltages across junctions of dissimilar
metals as are common in electronic devices. Differential measurements are more immune to
these than are single-ended measurements because of passive voltage cancellation occurring
between matched high and low pairs such as 1H/1L. So, use differential measurements when
measuring critical low-level voltages, especially those below 200 mV, such as are output from
pyranometers and thermocouples.
When analog voltage signals are measured in series by a single measurement instruction, such as
occurs when VoltSE() is programmed with Reps = 2 or more, measurements on sub-
sequent terminals may be affected by an offset, the magnitude of which is a function of the
voltage from the previous measurement. While this offset is usually small and negligible when
l Status table: The Status table is an automatically created data table. View the Status table
by connecting the datalogger to your computer (see Connecting the datalogger to a com-
puter (p. 33) for more information) Station Status , then clicking the Status Table tab.
display it.
l LoggerNet users, select DataTableInfo from the Table Monitor list.
l Device Configuration Utility Settings: Access settings, using Device Configuration Utility.
Clicking on a setting in Device Configuration Utility also provides information about that
setting.
l Terminal Mode: A list of setting field names is also available from the datalogger's terminal
mode (from Device Configuration Utility, click the Terminal tab) using command "F".
l Setting values may be accessed programmatically using Tablename.Fieldname syn-
tax. For example: Variable = Settings.Fieldname.
Communications and processor bandwidth are consumed when generating the Status and other
information tables. If datalogger is very tight on processing time, as may occur in very fast, long,
or complex operations, retrieving these tables repeatedly may cause skipped scans.
Settings that affect memory usage force the datalogger program to recompile, which may cause
loss of data. Before changing settings, it is a good practice to collect your data (see Collecting
data (p. 38) for more information). Examples of settings that force the datalogger program to
recompile:
l IP address
l PakBus encryption key
l IP default gateway
l PakBus/TCP server port
l Subnet mask
l HTTP service port
l PPP interface
l FTP service port
l PPP dial string
l PakBus/TCP service port
l PPP dial response
l PakBus/TCP client connections
l Baud rate change on control ports
l Communications allocation
l Maximum number of TLS server connections
9.13.1.2 Communications
For detailed information on communication protocols, see Communications (p. 64).
General communications
Baudrate
CommsMemAlloc
RS232Power
CommsMemFree
TCP_IP communications
HTTPPort
DNS
EthernetPower IPAddressEth IPTraceComport
FTPEnabled IPGateway PingEnabled
FTPPassword TelnetEnabled
FTPPort UDPBroadcastFilter
FTPUserName IPMaskEth
HTTPEnabled IPTraceCode
Cellular communications
CellAPN CellPDPAuth
CellRSRP
CellECIO CellPDPPassword
CellRSRQ
CellEnabled CellPDPUserName
CellRSSI
CellInfo CellPwrDuration
CellState
CellKeepAlive CellPwrRepeat
CellStatus
CellKeepAliveTime CellPwrStartTime
CalGain
CalOffset
9.13.1.4 Data
DataFillDays DataTableName
SkippedRecord
DataRecordSize SecsPerRecord
Battery
LithiumBattery
9.13.1.7 Security
See Datalogger security (p. 82) for more information.
PakBusTCPPassword
PakBusEncryptionKey
Security
9.13.1.8 Signatures
OSSignature ProgSignature RunSignature
l PC200W and PC400 users, click the Monitor Data tab and add the DataTableInfo to display
it.
l LoggerNet users, select DataTableInfo from the Table Monitor list.
l Cellular Settings
l RF407-Series Radio Settings
l Wi-Fi Settings
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
RouteFilters If a message is encoded using PakBus encryption, the router will forward
that message regardless of its content. If, however, the routes filter set-
ting is active in the destination node and the unencrypted message is of
a state changing type, the route filter will be applied by that end node.
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Cellular settings
Access cellular settings, using Device Configuration Utility. Clicking on a setting in Device Con-
figuration Utility also provides information about that setting. These settings are available for
dataloggers with integrated CELL modules.
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
l Start (Power-On) Time: Specifies the time of day in terms of hours and
minutes in which the datalogger will first enable the cellular interface.
If left at the default value of Always On, the datalogger will power the
cellular interface at all times.
l On Duration: Specifies the interval, in minutes, to power the data-
logger cellular interface for the first time of any day as well as for any
repeat cycles (if applicable).
CellPwrDuration l Repeat Cycle: Specifies the interval after the first time that the data-
logger powers on its cellular interface, that the datalogger will power
its cellular interface at subsequent times throughout the day.
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
l Power off
l Powering up
l Powered up
l SIM authorized
l Setting baud rate
l Waiting for baud rate
l Baud rate set
l Baud rate failure
l Power off. Waiting for retry
l Powered up. SIM auth failure
l Querying modem
l Waiting for network registration
l Configuring modem
l Dialing
l Dialing (retry)
CellState
l Dialed
l PPP negotiation
l Network ready
l PPP closing
l PPP paused
l PPP dropped
l Terminal AT command mode
l Firmware update mode
l Shutting down
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
l None - 0
l Low - 2
RadioRetries l Medium - 4
l High - 6
Set Retry Level to None when the Protocol setting is set to Transparent for the
purpose of communicating with other RF407 series radios.
Where to find:
Where to find:
Where to find:
Where to find:
Wi-Fi settings
Access Wi-Fi settings, using Device Configuration Utility. Clicking on a setting in Device Con-
figuration Utility also provides information about that setting. These settings are available for
dataloggers with integrated WIFI modules.
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Where to find:
Specifications
NOTE:
CR300 series dataloggers with serial numbers 2812 and older have a 5 MB CPU drive and 10
MB serial flash storage. CR300 series dataloggers with serial numbers 2813 and newer, and all
CR310 dataloggers have an 80 MB CPU drive and 30 MB serial flash storage.
Wiring Panel Temperature: Measured using a thermistor, located on the processor board.
NOTE:
The measurement from the PanelTemp() instruction does not accurately reflect the tem-
perature of the wiring panel, since it measures the temperature of the main processing board.
Therefore, if the datalogger processor, or charge (CHG) input are active, the PanelTemp()
measurement will be warmer than ambient. This should be taken into consideration if this
measurement is used as a reference temperature for other measurements such as ther-
mocouples.
l CR300: 13.97 x 7.62 x 4.56 cm (5.5 x 3.0 x 1.8 in). For CAD files, see CR300 Images and CAD
2D Drawings.
l CR310: 16.26 x 7.62 x 5.68 cm (6.4 x 3.0 x 2.2 in). For CAD files, see CR310 Images and CAD
2D Drawings.
Weight/Mass
l 16 – 32 Vdc
l Current limited to 0.9 A maximum
l Power converter or solar panel input
l 10 – 18 Vdc input
l 12 Vdc, lead-acid 7 Ah battery, typical
Internal Lithium Battery (see Internal battery (p. 86) for more information): 3 V coin cell CR2016
for battery-backed clock. 6-year life with no external power source.
Average Current Drain (assumes 12 Vdc on BAT terminals — add 2 mA if using CHG terminals):
l Idle: 1.5 mA
l Active 1 Hz Scan with One Analog Measurement: 5 mA
l Serial (RS-232): Active + 25 mA
l Active (Processor Always On): 23 mA
l Ethernet Power Requirements (CR310 Only):
o Ethernet Idle: 32 mA
o Ethernet Link: Active + 51 mA
USB Power: Functions that will be active with USB 5 Vdc include sending programs, adjusting
datalogger settings, and making some measurements. If USB is the only power source, then the
VX1 – VX2 range is reduced to 150 to 2500 mV, the SW12V terminal will not be operational,
voltage output for the control terminals (C1, C2) is limited to 4.75 V, and current output for the
control terminals (C1, C2) is limited to 8 mA.
Wi-Fi Additional Current Contribution at 12 Vdc:
l Transmit
o RF407, RF412, and RF427: < 80 mA
o RF422: 20 mA
NOTE:
CR300 series dataloggers are not capable of applying reverse excitation. Set the RevEx para-
meter of all bridge measurement instructions to False.
l Thermal Fuse Hold Current (Overload causes voltage drop. Disconnect and let cool to reset.
Operate at limit if the application can tolerate some fluctuation.):
o 1200 mA @ -40 °C
o 1100 mA @ 20 °C
l SE 1-2: –6 V, +9 V
l SE 3-6: ±17 V
l >71 dB at 50 Hz
l >74 dB at 60 Hz
l P_SW
l C1-C2 (Requires an external 100 kΩ resistor connected from the terminal to BAT+.)
l SE terminals 1-4
l P_LL
l P_SW
l C1-C2
l SE 1-4: 35 kHz
l P_LL: 20 kHz
l P_SW: 35 kHz
l C1-C2: 3 kHz
l SE terminals 1-4
l P_SW
l C1-C2
See also Power output (p. 8) and Pulse measurement specifications (p. 170).
Frequency
Channel Capacity
Receive Sensitivity
RF Data Rate
For RF additional current contribution specifications, see Power requirements (p. 164).
See also Radio communications (p. 26).
l Transfer/Receive:
l -CELL200 minimum = 20 mA. Average = 105 mA
RF407 Option
RF412 Option
l ACMA RCM
l United States FCC Part 15.247:
l MCQ-XB900HP
l Industry Canada (IC): 1846A-XB900HP
NOTE:
The user is responsible for emissions if changing the antenna type or increasing the gain.
ac
Alternating current (see Vac).
accuracy
The degree to which the result of a measurement, calculation, or specification conforms
to the correct value or a standard.
ADC
Analog to digital conversion. The process that translates analog voltage levels to digital
values.
alias
A second name assigned to variable in CRBasic.
amperes (A)
Base unit for electric current. Used to quantify the capacity of a power source or the
requirements of a power-consuming device.
analog
Data presented as continuously variable electrical signals.
argument
Part of a procedure call (or command execution).
array
A group of variables as declared in CRBasic.
ASCII/ANSI
Abbreviation for American Standard Code for Information Interchange / American
National Standards Institute. An encoding scheme in which numbers from 0-127 (ASCII)
or 0-255 (ANSI) are used to represent pre-defined alphanumeric characters. Each number
is usually stored and transmitted as 8 binary digits (8 bits), resulting in 1 byte of storage
per character of text.
asynchronous
The transmission of data between a transmitting and a receiving device occurs as a series
of zeros and ones. For the data to be "read" correctly, the receiving device must begin
reading at the proper point in the series. In asynchronous communication, this coordin-
ation is accomplished by having each character surrounded by one or more start and stop
bits which designate the beginning and ending points of the information. Also indicates
the sending and receiving devices are not synchronized using a clock signal.
AWG
AWG ("gauge") is the accepted unit when identifying wire diameters. Larger AWG values
indicate smaller cross-sectional diameter wires. Smaller AWG values indicate large-dia-
meter wires. For example, a 14 AWG wire is often used for grounding because it can carry
large currents. 22 AWG wire is often used as sensor wire since only small currents are car-
ried when measurements are made.
baud rate
The rate at which data is transmitted.
beacon
A signal broadcasted to other devices in a PakBus network to identify "neighbor" devices.
A beacon in a PakBus network ensures that all devices in the network are aware of other
devices that are viable. If configured to do so, a clock-set command may be transmitted
with the beacon. This function can be used to synchronize the clocks of devices within
the PakBus network.
binary
Describes data represented by a series of zeros and ones. Also describes the state of a
switch, either being on or off.
BOOL8
A one-byte data type that holds eight bits (0 or 1) of information. BOOL8 uses less space
than the 32 bit BOOLEAN data type.
boolean
Name given a function, the result of which is either true or false.
burst
Refers to a burst of measurements. Analogous to a burst of light, a burst of meas-
urements is intense, such that it features a series of measurements in rapid succession,
and is not continuous.
calibration wizard
The calibration wizard facilitates the use of the CRBasic field calibration instructions
FieldCal() and FieldCalStrain(). It is found in LoggerNet (4.0 and later) or RTDAQ.
callback
A name given to the process by which the datalogger initiates communications with a
computer running appropriate Campbell Scientific datalogger support software. Also
known as "Initiate Comms."
CardConvert software
A utility to retrieve binary final data from memory cards and convert the data to ASCII or
other formats.
CD100
An optional enclosure mounted keyboard/display for use with dataloggers.
CDM/CPI
CPI is a proprietary interface for communications between Campbell Scientific data-
loggers and Campbell Scientific CDM peripheral devices. It consists of a physical layer
definition and a data protocol. CDM devices are similar to Campbell Scientific SDM
devices in concept, but the use of the CPI bus enables higher data-throughput rates and
use of longer cables. CDM devices require more power to operate in general than do
SDM devices.
CF
CompactFlash®
code
A CRBasic program, or a portion of a program.
COM port
COM is a generic name given to physical and virtual serial communication ports.
COM1
When configured as a communication port, terminals C1 and C2 act as a pair to form
Com1.
command
An instruction or signal that causes a computer to perform one of its basic functions (usu-
ally in CRBasic).
command line
One line in a CRBasic program. Maximum length, even with the line continuation char-
acters <space> <underscore> ( _), is 512 characters. A command line usually consists of
one program statement, but it may consist of multiple program statements separated by a
<colon> (:).
CompactFlash
CompactFlash® (CF) is a memory-card technology used in some Campbell Scientific
card-storage modules.
conditioned output
The output of a sensor after scaling factors are applied.
connector
A connector is a device that allows one or more electron conduits (wires, traces, leads,
etc) to be connected or disconnected as a group. A connector consists of two parts —
male and female. For example, a common household ac power receptacle is the female
portion of a connector. The plug at the end of a lamp power cord is the male portion of
the connector.
constant
A packet of memory given an alpha-numeric name and assigned a fixed number.
control I/O
C terminals configured for controlling or monitoring a device.
CoraScript
CoraScript is a command-line interpreter associated with LoggerNet datalogger support
software.
CPU
Central processing unit. The brains of the datalogger.
cr
Carriage return.
CRBasic Editor
The CRBasic programming editor; supplied as part of LoggerNet, PC400, and RTDAQ soft-
ware.
CRC
Cyclic Redundancy Check
CRD
An optional memory drive that resides on a memory card.
CS I/O
Campbell Scientific proprietary input/output port. Also, the proprietary serial com-
munications protocol that occurs over the CS I/O port.
CVI
Communication verification interval. The interval at which a PakBus® device verifies the
accessibility of neighbors in its neighbor list. If a neighbor does not communicate for a
period of time equal to 2.5 times the CVI, the device will send up to four Hellos. If no
response is received, the neighbor is removed from the neighbor list.
DAC
Digital to analog conversion. The process that translates digital voltage levels to analog
values.
data cache
The data cache is a set of binary files kept on the hard disk of the computer running the
datalogger support software. A binary file is created for each table in each datalogger.
These files mimic the storage areas in datalogger memory, and by default are two times
the size of the datalogger storage area. When the software collects data from a data-
logger, the data is stored in the binary file for that datalogger. Various software functions
retrieve data from the data cache instead of the datalogger directly. This allows the sim-
ultaneous sharing of data among software functions.
data table
A concept that describes how data is organized in memory, or in files that result from col-
lecting data in memory. The fundamental data table is created by the CRBasic program as
a result of the DataTable() instruction and resides in binary form in main-memory SRAM.
The data table structure also resides in the data cache, in discrete data files on datalogger
drives, and in binary or ASCII files that result from collecting final-data memory with data-
logger support software.
DC
Direct current.
DCE
Data Communication Equipment. While the term has much wider meaning, in the limited
context of practical use with the datalogger, it denotes the pin configuration, gender,
and function of an RS-232 port. The RS-232 port on the datalogger is DCE. Interfacing a
DCE device to a DCE device requires a null-modem cable.
desiccant
A hygroscopic material that absorbs water vapor from the surrounding air. When placed
in a sealed enclosure, such as a datalogger enclosure, it prevents condensation.
differential
A sensor or measurement terminal wherein the analog voltage signal is carried on two
wires. The phenomenon measured is proportional to the difference in voltage between
the two wires.
Dim
A CRBasic command for declaring and dimensioning variables. Variables declared with
Dim remain hidden during datalogger operations.
dimension
To code a CRBasic program for a variable array as shown in the following examples: DIM
example(3) creates the three variables example(1), example(2), and example(3); DIM
example(3,3) creates nine variables; DIM example(3,3,3) creates 27 variables.
DNP3
Distributed Network Protocol is a set of communications protocols used between com-
ponents in process automation systems. Its main use is in utilities such as electric and
water companies.
DNS
Domain name server. A TCP/IP application protocol.
DTE
Data Terminal Equipment. While the term has much wider meaning, in the limited con-
text of practical use with the datalogger, it denotes the pin configuration, gender, and
function of an RS-232 port. The RS-232 port on the datalogger is DCE. Attachment of a
null-modem cable to a DCE device effectively converts it to a DTE device.
duty cycle
The percentage of available time a feature is in an active state. For example, if the data-
logger is programmed with 1 second scan interval, but the program completes after only
100 milliseconds, the program can be said to have a 10% duty cycle.
earth ground
A grounding rod or other suitable device that electrically ties a system or device to the
earth. Earth ground is a sink for electrical transients and possibly damaging potentials,
such as those produced by a nearby lightning strike. Earth ground is the preferred ref-
erence potential for analog voltage measurements. Note that most objects have a "an
electrical potential" and the potential at different places on the earth - even a few meters
away - may be different.
endian
The sequential order in which bytes are arranged into larger numerical values when
stored in memory.
engineering units
Units that explicitly describe phenomena, as opposed to, for example, the datalogger
base analog-measurement unit of millivolts.
ESD
Electrostatic discharge.
ESS
Environmental sensor station.
execution interval
The time interval between initiating each execution of a given Scan() of a CRBasic pro-
gram. If the Scan() Interval is evenly divisible into 24 hours (86,400 seconds), it is syn-
chronized with the 24 hour clock, so that the program is executed at midnight and every
Scan() Interval thereafter. The program is executed for the first time at the first occurrence
of the Scan() Interval after compilation. If the Scan() Interval does not divide evenly into
24 hours, execution will start on the first even second after compilation.
execution time
Time required to execute an instruction or group of instructions. If the execution time of
a program exceeds the Scan() Interval, the program is executed less frequently than pro-
grammed and the Status table SkippedScan field will increment.
expression
A series of words, operators, or numbers that produce a value or result.
FAT
File Allocation Table - a computer file system architecture and a family of industry-stand-
ard file systems utilizing it.
FFT
Fast Fourier Transform. A technique for analyzing frequency-spectrum data.
field
Data tables are made up of records and fields. Each row in a table represents a record and
each column represents a field. The number of fields in a record is determined by the
number and configuration of output processing instructions that are included as part of
the DataTable() declaration.
final-storage data
Data that resides in final-data memory.
final-storage memory
The portion of SRAM memory allocated for storing data tables with output arrays. Once
data is written to final-data memory, they cannot be changed but only overwritten when
they become the oldest data. Final-data memory is configured as ring memory by default,
with new data overwriting the oldest data.
Flash
A type of memory media that does not require battery backup. Flash memory, however,
has a lifetime based on the number of writes to it. The more frequently data is written,
the shorter the life expectancy.
FLOAT
Four-byte floating-point data type. Default datalogger data type for Public or Dim vari-
ables. Same format as IEEE4.
FP2
Two-byte floating-point data type. Default datalogger data type for stored data. While
IEEE4 four-byte floating point is used for variables and internal calculations, FP2 is
adequate for most stored data. FP2 provides three or four significant digits of resolution,
and requires half the memory as IEEE4.
frequency response
Sample rate is how often an instrument reports a result at its output; frequency response
is how well an instrument responds to fast fluctuations on its input. By way of example,
sampling a large gage thermocouple at 1 kHz will give a high sample rate but does not
ensure the measurement has a high frequency response. A fine-wire thermocouple,
which changes output quickly with changes in temperature, is more likely to have a high
frequency response.
FTP
File Transfer Protocol. A TCP/IP application protocol.
full-duplex
A serial communication protocol. Simultaneous bi-directional communications. Com-
munications between a serial port and a computer is typically full duplex.
garbage
The refuse of the data communication world. When data is sent or received incorrectly
(there are numerous reasons why this happens), a string of invalid, meaningless char-
acters (garbage) often results. Two common causes are: 1) a baud-rate mismatch and 2)
synchronous data being sent to an asynchronous device and vice versa.
global variable
A variable available for use throughout a CRBasic program. The term is usually used in
connection with subroutines, differentiating global variables (those declared using Public
or Dim) from local variables, which are declared in the Sub() and Function() instructions.
ground currents
Pulling power from the datalogger wiring panel, as is done when using some com-
munication devices from other manufacturers, or a sensor that requires a lot of power,
can cause voltage potential differences between points in datalogger circuitry that are
supposed to be at ground or 0 Volts. This difference in potentials can cause errors when
measuring single-ended analog voltages.
half-duplex
A serial communication protocol. Bi-directional, but not simultaneous, communications.
SDI-12 is a half-duplex protocol.
handshake
The exchange of predetermined information between two devices to assure each that it is
connected to the other. When not used as a clock line, the CLK/HS (pin 7) line in the data-
logger CS I/O port is primarily used to detect the presence or absence of peripherals.
hello exchange
In a PakBus network, this is the process of verifying a node as a neighbor.
hertz
SI unit of frequency. Cycles or pulses per second.
HTML
Hypertext Markup Language. Programming language used for the creation of web pages.
HTTP
Hypertext Transfer Protocol. A TCP/IP application protocol.
Hz
SI unit of frequency. Cycles or pulses per second.
I2C
Inter-Integrated Circuit is a multi-master, multi-slave, packet switched, single-ended,
serial computer bus.
IEEE4
Four-byte, floating-point data type. IEEE Standard 754. Same format as Float.
Include file
A file containing CRBasic code to be included at the end of the current CRBasic program,
or it can be run as the default program.
INF
A data word indicating the result of a function is infinite or undefined.
initiate comms
A name given to a processes by which the datalogger initiates communications with a
computer running LoggerNet. Also known as Callback.
input/output instructions
Used to initiate measurements and store the results in input storage or to set or read con-
trol/logic ports.
instruction
Usually refers to a CRBasic command.
intermediate memory
SRAM memory automatically allocated for intermediate calculations performed by
CRBasic data output processing instructions. Data output processing memory cannot be
monitored.
IP
Internet Protocol. A TCP/IP internet protocol.
IP address
A unique address for a device on the internet.
IP trace
Function associated with IP data transmissions. IP trace information was originally
accessed through the CRBasic instruction IPTrace() and stored in a string variable. Files
Manager setting is now modified to allow for creation of a file on a datalogger memory
drive, such as USR:, to store information in ring memory.
isolation
Hardwire communication devices and cables can serve as alternate paths to earth ground
and entry points into the datalogger for electromagnetic noise. Alternate paths to ground
and electromagnetic noise can cause measurement errors. Using opto-couplers in a con-
necting device allows communication signals to pass, but breaks alternate ground paths
and may filter some electromagnetic noise. Campbell Scientific offers optically isolated
RS-232 to CS I/O interfaces as an accessory for use on the CS I/O port.
JSON
Java Script Object Notation. A data file format available through the datalogger or Log-
gerNet.
keep memory
keep memory is non-volatile memory that preserves some settings during a power-up or
program start up reset. Examples include PakBus address, station name, beacon intervals,
neighbor lists, routing table, and communication timeouts.
keyboard/display
The datalogger has an optional external keyboard/display.
leaf node
A PakBus node at the end of a branch. When in this mode, the datalogger is not able to
forward packets from one of its communication ports to another. It will not maintain a list
of neighbors, but it still communicates with other PakBus dataloggers and wireless
sensors. It cannot be used as a means of reaching (routing to) other dataloggers.
lf
Line feed. Often associated with carriage return (<cr>). <cr><lf>.
linearity
The quality of delivering identical sensitivity throughout the measurement.
local variable
A variable available for use only by the subroutine in which it is declared. The term dif-
ferentiates local variables, which are declared in the Sub() and Function() instructions,
from global variables, which are declared using Public or Dim.
LoggerNet
Campbell Scientific's datalogger support software for programming, communications,
and data retrieval between dataloggers and a computer.
LONG
Data type used when declaring integers.
loop
A series of instructions in a CRBasic program that are repeated for a programmed number
of times. The loop ends with an End instruction.
loop counter
Increments by one with each pass through a loop.
LSB
Least significant bit (the trailing bit).
LVDT
The linear variable differential transformer (LVDT) is a type of electrical transformer used
for measuring linear displacement (position).
mains power
The national power grid.
MD5 digest
16 byte checksum of the TCP/IP VTP configuration.
micro SD
A removable memory-card technology used in CR6 and CR1000X dataloggers.
milli
The SI prefix denoting 1/1000 of a base SI unit.
Modbus
Communication protocol published by Modicon in 1979 for use in programmable logic
controllers (PLCs).
modem/terminal
Any device that has the following: ability to raise the ring line or be used with an optically
isolated interface to raise the ring line and put the datalogger in the communication com-
mand state, or an asynchronous serial communication port that can be configured to
communicate with the datalogger.
modulo divide
A math operation. Result equals the remainder after a division.
MSB
Most significant bit (the leading bit).
multiplier
A term, often a parameter in a CRBasic measurement instruction, that designates the
slope (aka, scaling factor or gain) in a linear function. For example, when converting °C
to °F, the equation is °F = °C*1.8 + 32. The factor 1.8 is the multiplier.
mV
The SI abbreviation for millivolts.
NAN
Not a number. A data word indicating a measurement or processing error. Voltage over-
range, SDI-12 sensor error, and undefined mathematical results can produce NAN.
neighbor device
Device in a PakBus network that communicates directly with a device without being
routed through an intermediate device.
Network Planner
Campbell Scientific software designed to help set up dataloggers in PakBus networks so
that they can communicate with each other and the LoggerNet server. For more inform-
ation, see https://www.campbellsci.com/loggernet.
NIST
National Institute of Standards and Technology.
node
Devices in a network — usually a PakBus network. The communications server dials
through, or communicates with, a node. Nodes are organized as a hierarchy with all
NSEC
Eight-byte data type divided up as four bytes of seconds since 1990 and four bytes of
nanoseconds into the second.
null modem
A device, usually a multi-conductor cable, which converts an RS-232 port from DCE to
DTE or from DTE to DCE.
Numeric Monitor
A digital monitor in datalogger support software or in a keyboard/display.
offset
A term, often a parameter in a CRBasic measurement instruction, that designates the y-
intercept (aka, shifting factor or zeroing factor) in a linear function. For example, when
converting °C to °F, the equation is °F = °C*1.8 + 32. The factor 32 is the offset.
ohm
The unit of resistance. Symbol is the Greek letter Omega (Ω). 1.0 Ω equals the ratio of 1.0
volt divided by 1.0 ampere.
Ohm's Law
Describes the relationship of current and resistance to voltage. Voltage equals the
product of current and resistance (V = I • R).
output
A loosely applied term. Denotes a) the information carrier generated by an electronic
sensor, b) the transfer of data from variable memory to final-data memory, or c) the trans-
fer of electric power from the datalogger or a peripheral to another device.
output array
A string of data values output to final-data memory. Output occurs when the data table
output trigger is True.
output interval
The interval between each write of a record to a data table.
PakBus
® A proprietary communication protocol developed by Campbell Scientific to facilitate
communications between Campbell Scientific devices. Similar in concept to IP (Internet
Protocol), PakBus is a packet-switched network protocol with routing capabilities. A
registered trademark of Campbell Scientific, Inc.
PakBus Graph
Software that shows the relationship of various nodes in a PakBus network and allows for
monitoring and adjustment of some registers in each node.
parameter
Part of a procedure (or command) definition.
PC200W
Basic datalogger support software for direct connect. It supports a connection between
computer and datalogger and includes Short Cut for creating datalogger programs. Tools
for setting the datalogger clock, sending programs, monitoring sensors, and on-site view-
ing and collection of data is also included.
PC400
Datalogger support software that supports a variety of communication options, manual
data collection, and data monitoring displays. Short Cut and CRBasic Editor are included
for creating datalogger programs. PC400 does not support complex communication
options, such as phone-to-RF, PakBus® routing, or scheduled data collection.
PDP
Packet Data Protocol
period average
A measurement technique using a high-frequency digital clock to measure time dif-
ferences between signal transitions. Sensors commonly measured with period average
include water-content reflectometers.
PGIA
Programmable Gain Input Amplifier
ping
A software utility that attempts to contact another device in a network.
pipeline mode
A CRBasic program execution mode wherein instructions are evaluated in groups of like
instructions, with a set group prioritization.
PLC
Programmable Logic Controllers
Poisson ratio
A ratio used in strain measurements.
ppm
Parts per million.
precision
The amount of agreement between repeated measurements of the same quantity (AKA
repeatability).
PreserveVariables
CRBasic instruction that protects Public variables from being erased when a program is
recompiled.
print peripheral
Any device capable of receiving output over pin 6 (the PE line) in a receive-only mode.
Printers, "dumb" terminals, and computers in a terminal mode fall in this category.
processing instructions
CRBasic instructions used to further process input-data values and return the result to a
variable where it can be accessed for output processing. Arithmetic and transcendental
functions are included.
program statement
A complete program command construct confined to one command line or to multiple
command lines merged with the line continuation characters <space><underscore> ( _).
A command line, even with line continuation, cannot exceed 512 characters.
public
A CRBasic command for declaring and dimensioning variables. Variables declared with
Public can be monitored during datalogger operation.
pulse
An electrical signal characterized by a rapid increase in voltage follow by a short plateau
and a rapid voltage decrease.
ratiometric
Describes a type of measurement or a type of math. Ratiometric usually refers to an
aspect of resistive-bridge measurements - either the measurement or the math used to
process it. Measuring ratios and using ratio math eliminates several sources of error from
the end result.
record
A record is a complete line of data in a data table or data file. All data in a record share a
common time stamp. Data tables are made up of records and fields. Each row in a table
represents a record and each column represents a field. The number of fields in a record
is determined by the number and configuration of output processing instructions that are
included as part of the DataTable() declaration.
regulator
A setting, a Status table element, or a DataTableInformation table element. Also a device
for conditioning an electrical power source. Campbell Scientific regulators typically con-
dition ac or dc voltages greater than 16 Vdc to about 14 Vdc.
resistance
A feature of an electronic circuit that impedes or redirects the flow of electrons through
the circuit.
resistor
A device that provides a known quantity of resistance.
resolution
The smallest interval measurable.
ring line
Ring line is pulled high by an external device to notify the datalogger to commence RS-
232 communications. Ring line is pin 3 of a DCE RS-232 port.
ringing
Oscillation of sensor output (voltage or current) that occurs when sensor excitation
causes parasitic capacitances and inductances to resonate.
RMS
Root-mean square, or quadratic mean. A measure of the magnitude of wave or other vary-
ing quantities around zero.
RNDIS
Remote Network Driver Interface Specification - a Microsoft protocol that provides a vir-
tual Ethernet link via USB.
router
A device configured as a router is able to forward PakBus packets from one port to
another. To perform its routing duties, a datalogger configured as a router maintains its
own list of neighbors and sends this list to other routers in the PakBus network. It also
obtains and receives neighbor lists from other routers. Routers maintain a routing table,
which is a list of known nodes and routes. A router will only accept and forward packets
that are destined for known devices. Routers pass their lists of known neighbors to other
routers to build the network routing system.
RS-232
Recommended Standard 232. A loose standard defining how two computing devices can
communicate with each other. The implementation of RS-232 in Campbell Scientific data-
loggers to computer communications is quite rigid, but transparent to most users.
Features in the datalogger that implement RS-232 communication with smart sensors are
flexible.
RTDAQ
Datalogger support software for industrial and real-time applications.
RTU
Remote Telemetry Units
Rx
Receive
sample rate
The rate at which measurements are made by the datalogger. The measurement sample
rate is of interest when considering the effect of time skew, or how close in time are a
series of measurements, or how close a time stamp on a measurement is to the true time
the phenomenon being measured occurred. A 'maximum sample rate' is the rate at which
a measurement can repeatedly be made by a single CRBasic instruction. Sample rate is
how often an instrument reports a result at its output; frequency response is how well an
instrument responds to fast fluctuations on its input. By way of example, sampling a large
gage thermocouple at 1 kHz will give a high sample rate but does not ensure the meas-
urement has a high frequency response. A fine-wire thermocouple, which changes out-
put quickly with changes in temperature, is more likely to have a high frequency
response.
SCADA
Supervisory Control And Data Acquisition
scan time
When time functions are run inside the Scan() / NextScan construct, time stamps are
based on when the scan was started according to the datalogger clock. Resolution of
scan time is equal to the length of the scan.
SDI-12
Serial Data Interface at 1200 baud. Communication protocol for transferring data
between the datalogger and SDI-12 compatible smart sensors.
SDK
Software Development Kit
SDM
Synchronous Device for Measurement. A processor-based peripheral device or sensor that
communicates with the datalogger via hardwire over a short distance using a protocol
proprietary to Campbell Scientific.
Seebeck effect
Induces microvolt level thermal electromotive forces (EMF) across junctions of dissimilar
metals in the presence of temperature gradients. This is the principle behind ther-
mocouple temperature measurement. It also causes small, correctable voltage offsets in
datalogger measurement circuitry.
send button
Send button in datalogger support software. Sends a CRBasic program or operating sys-
tem to a datalogger.
sequential mode
A CRBasic program execution mode wherein each statement is evaluated in the order it is
listed in the program.
serial
A loose term denoting output of a series of ASCII, HEX, or binary characters or numbers in
electronic form.
Settings Editor
An editor for observing and adjusting settings. Settings Editor is a feature of Log-
gerNet|Connect, PakBus Graph, and Device Configuration Utility.
Short Cut
A CRBasic programming wizard suitable for many datalogger applications. Knowledge of
CRBasic is not required to use Short Cut.
SI
Système Internationale. The uniform international system of metric units. Specifies accep-
ted units of measure.
simplex
A serial communication protocol. One-direction data only. Serial communications
between a serial sensor and the datalogger may be simplex.
single-ended
Denotes a sensor or measurement terminal wherein the analog voltage signal is carried
on a single wire and measured with respect to ground (0 V).
skipped scans
Occur when the CRBasic program is too long for the scan interval. Skipped scans can
cause errors in pulse measurements.
slow sequence
A usually slower secondary scan in the CRBasic program. The main scan has priority over
a slow sequence.
SMS
Short message service. A text messaging service for web and mobile device systems.
SMTP
Simple Mail Transfer Protocol. A TCP/IP application protocol.
SNP
Snapshot file.
SP
Space.
SRAM
Static Random-Access Memory
start bit
The bit used to indicate the beginning of data.
state
Whether a device is on or off.
stop bit
The end of the data bits. The stop bit can be 1, 1.5, or 2.
string
A datum or variable consisting of alphanumeric characters.
support software
Campbell Scientific software that includes at least the following functions: datalogger
communications, downloading programs, clock setting, and retrieval of measurement
data.
synchronous
The transmission of data between a transmitting and a receiving device occurs as a series
of zeros and ones. For the data to be "read" correctly, the receiving device must begin
reading at the proper point in the series. In synchronous communication, this coordin-
system time
When time functions are run outside the Scan() / NextScan construct, the time registered
by the instruction will be based on the system clock, which has a 10 ms resolution.
table
See data table.
task
Grouping of CRBasic program instructions automatically by the datalogger compiler.
Tasks include measurement, SDM or digital, and processing. Tasks are prioritized when
the CRBasic program runs in pipeline mode. Also, a user-customized function defined
through LoggerNet Task Master.
TCP/IP
Transmission Control Protocol / Internet Protocol.
TCR
Temperature Coefficient of Resistance. TCR tells how much the resistance of a resistor
changes as the temperature of the resistor changes. The unit of TCR is ppm/°C (parts-per-
million per degree Celsius). A positive TCR means that resistance increases as temperature
increases. For example, a resistor with a specification of 10 ppm/°C will not increase in res-
istance by more than 0.000010 Ω per ohm over a 1 °C increase of the resistor temperature
or by more than .00010 Ω per ohm over a 10 °C increase.
Telnet
A software utility that attempts to contact and interrogate another specific device in a net-
work. Telnet is resident in Windows OS.
terminal emulator
A command-line shell that facilitates the issuance of low-level commands to a datalogger
or some other compatible device. A terminal emulator is available in most datalogger sup-
port software available from Campbell Scientific.
thermistor
A thermistor is a temperature measurement device with a resistive element that changes
in resistance with temperature. The change is wide, stable, and well characterized. The
output of a thermistor is usually non-linear, so measurement requires linearization by
means of a Steinhart-Hart or polynomial equation. CRBasic instructions Therm107(),
Therm108(), and Therm109() use Steinhart-Hart equations.
throughput rate
Rate that a measurement can be taken, scaled to engineering units, and the stored in a
final-memory data table. The datalogger has the ability to scan sensors at a rate exceed-
ing the throughput rate. The primary factor determining throughput rate is the pro-
cessing programmed into the CRBasic program. In sequential-mode operation, all
processing called for by an instruction must be completed before moving on to the next
instruction.
time domain
Time domain describes data graphed on an X-Y plot with time on the X axis. Time series
data is in the time domain.
TLS
Transport Layer Security. An Internet communication security protocol.
TTL
Transistor-to-Transistor Logic. A serial protocol using 0 Vdc and 5 Vdc as logic signal
levels.
Tx
Transmit
UART
Universal Asynchronous Receiver/Transmitter for asynchronous serial communications.
UINT2
Data type used for efficient storage of totalized pulse counts, port status (status of 16
ports stored in one variable, for example) or integer values that store binary flags.
unconditioned output
The fundamental output of a sensor, or the output of a sensor before scaling factors are
applied.
UPS
Uninterruptible Power Supply. A UPS can be constructed for most datalogger applic-
ations using ac line power, a solar panel, an ac/ac or ac/dc wall adapter, a charge con-
troller, and a rechargeable battery.
URI
Uniform Resource Identifier
user program
The CRBasic program written by you in Short Cut program wizard.
USR drive
A portion of memory dedicated to the storage of image or other files.
Vac
Volts alternating current.
variable
A packet of SRAM given an alphanumeric name. Variables reside in variable memory.
Vdc
Volts direct current.
VisualWeather
Datalogger support software specialized for weather and agricultural applications. The
software allows you to initialize the setup, interrogate the station, display data, and gen-
erate reports from one or more weather stations.
volt meter
An inexpensive and readily available device useful in troubleshooting data acquisition sys-
tem faults.
voltage divider
A circuit of resistors that ratiometrically divides voltage. For example, a simple two-res-
istor voltage divider can be used to divide a voltage in half. So, when fed through the
volts
SI unit for electrical potential.
VSPECT®
® A registered trademark for Campbell Scientific's proprietary spectral-analysis, fre-
quency domain, vibrating wire measurement technique.
watchdog timer
An error-checking system that examines the processor state, software timers, and pro-
gram-related counters when the CRBasic program is running. The following will cause
watchdog timer resets, which reset the processor and CRBasic program execution: pro-
cessor bombed, processor neglecting standard system updates, counters are outside the
limits, voltage surges, and voltage transients. When a reset occurs, a counter is incre-
mented in the WatchdogTimer entry of the Status table. A low number (1 to 10) of watch-
dog timer resets is of concern, but normally indicates that the situation should just be
monitored. A large number of errors (>10) accumulating over a short period indicates a
hardware or software problem. Consult with a Campbell Scientific support engineer.
weather-tight
Describes an instrumentation enclosure impenetrable by common environmental con-
ditions. During extraordinary weather events, however, seals on the enclosure may be
breached.
web API
Application Programming Interface
wild card
A character or expression that substitutes for any other character or expression.
XML
Extensible markup language.
τ
Time constant
B USB 15
backup 89 wifi 20
bandwidth 64 RS-232 11
big-endian 70 Modbus 65
data E
dataloggers fieldname 41
I
period-averaging 57
pulse 58-59, 62, 170
INF 96
quadrature 60
info tables 116, 121
resistance 51, 56
internal battery 86
single-ended 47, 104
internet communications 74, 172
strain 54
over USB 16
switch closure 170
K vibrating wire 63
updating OS 89
USB 7, 10, 15, 165
Ethernet 16
Australia Germany
Location: Garbutt, QLD Australia Location: Bremen, Germany
Email: info@campbellsci.com.au Email: info@campbellsci.de
Website: www.campbellsci.com.au Website: www.campbellsci.de
China Spain
Location: Beijing, P. R. China Location: Barcelona, Spain
Email: info@campbellsci.com.cn Email: info@campbellsci.es
Website: www.campbellsci.com.cn Website: www.campbellsci.es
Costa Rica UK
Location: San José, Costa Rica Location: Shepshed, Loughborough, UK
Email: info@campbellsci.cc Email: sales@campbellsci.co.uk
Website: www.campbellsci.cc Website: www.campbellsci.co.uk
France USA
Location: Antony, France Location: Logan, UT USA
Email: info@campbellsci.fr Email: info@campbellsci.com
Website: www.campbellsci.fr Website: www.campbellsci.com