Home » Campbell Scientific Manuals » Electronics Accessories » Campbell Scientific CR5000 » Manual Viewer

Campbell Scientific CR5000 CR5000 Measurement and Control Module - Page 77

CRBasic - Native Language Programming, 4.1 Format Introduction

View all Campbell Scientific CR5000 manuals

Add to My Manuals
Save this manual to your list of manuals

Page 77 highlights

Section 4. CRBasic - Native Language Programming The CR5000 is programmed in a language that has some similarities to a structured basic. There are special instructions for making measurements and for creating tables of output data. The results of all measurements are assigned variables (given names). Mathematical operations are written out much as they would be algebraically. This section describes a program, its syntax, structure, and sequence. 4.1 Format Introduction 4.1.1 Mathematical Operations Mathematical operations are written out much as they would be algebraically. For example, to convert a temperature in Celsius to Fahrenheit one might write: TempF = TempC * 1.8 + 32 With the CR5000 there may be 2 or 20 temperature (or other) measurements. Rather than have 20 different names, a variable array with one name and 20 elements may be used. A thermocouple temperature might be called TCTemp. With an array of 20 elements the names of the individual temperatures are TCTemp(1), TCTemp(2), TCTemp(3), ... TCTemp(20). The array notation allows compact code to perform operations on all the variables. For example, to convert ten temperatures in a variable array from C to F: For I=1 to 10 TCTemp(I)=TCTemp(I)*1.8+32 Next I 4.1.2 Measurement and Output Processing Instructions Measurement instructions are procedures that set up the measurement hardware to make a measurement and place the results in a variable or a variable array. Output processing instructions are procedures that store the results of measurements or calculated values. Output processing includes averaging, saving maximum or minimum, standard deviation, FFT, etc. The instructions for making measurements and outputting data are not found in a standard basic language. The instructions Campbell Scientific has created for these operations are in the form of procedures. The procedure has a keyword name and a series of parameters that contain the information needed to complete the procedure. For example, the instruction for measuring the temperature of the CR5000 input panel is: PanelTemp (Dest, Integ) 4-1

Section	Page
Revision and Copyright Information	1
Warranty and Assistance	2
Table of Contents	3
CR5000 Overview	5
OV1. Physical Description	5
OV1.1 Measurement Inputs	5
OV1.1.1 Analog Inputs	5
OV1.1.2 Signal Grounds ()	7
OV1.1.3 Power Grounds (G)	7
OV1.1.4 Ground Lug	7
OV1.1.5 Power In	7
OV1.1.6 Switched 12 Volts SW-12	7
OV1.1.7 Switched Voltage Excitation (VX)	7
OV1.1.8 Switched Current Excitation (IX)	7
OV1.1.9 Continuous Analog Outputs (CAO)	7
OV1.1.10 Control I/O	8
OV1.1.11 Pulse Inputs	8
OV1.1.12 Power Up	8
OV1.1.13 SDM Connections	8
OV1.2 Communication and Data Storage	8
OV1.2.1 PCMCIA PC Card	8
OV1.2.2 CS I/O	8
OV1.2.3 Computer RS-232	8
OV1.3 Power Supply and AC Adapter	9
OV2. Memory and Programming Concepts	9
OV2.1 Memory	9
OV2.2 Measurements, Processing, Data Storage	9
OV2.3 Data Tables	10
OV3. PC9000 Application Software	10
OV3.1 Hardware and Software Requirements	10
OV3.2 PC9000 Installation	10
OV3.3 PC9000 Software Overview	11
OV3.3.1 File	13
OV3.3.2 Edit	13
OV3.3.3 Analysis	14
OV3.3.4 Tools	14
OV3.3.5 Collect	14
OV3.3.6 Display	14
OV3.3.7 Windows	14
OV3.3.8 Help	14
OV4. Keyboard Display	15
OV4.1 Data Display	16
OV4.1.1 Real Time Tables	17
OV4.1.2 Setting up Real Time Custom Display	18
OV4.1.3 Final Storage Tables	19
OV4.2 Run/Stop Program	20
OV4.3 File Display	21
OV4.3.1 File: Edit	22
OV4.4 Configure Display	23
OV5. Specifications	24
Section 1. Installation and Maintenance	25
1.1 Protection from the Environment	25
1.2 Power Requirements	25
1.3 CR5000 Power Supplies	26
1.3.1 CR5000 Lead Acid Battery BASE	26
1.3.2 Low Profile CR5000	28
1.4 Solar Panels	28
1.5 Direct Battery Connection to the CR5000 Wiring Panel	28
1.6 Vehicle Power Supply Connections	28
1.6.1 CR5000 with Battery Base	28
1.6.2 CR5000 with Low Profile Base (No Battery)	30
1.7 CR5000 GROUNDING	30
1.7.1 ESD Protection	30
1.7.2 Effect of Grounding on Measurements: Common Mode Range	32
1.7.3 Effect of Grounding on Single-Ended Measurements	33
1.8 Powering Sensors and Peripherals	33
1.9 Controlling Power to Sensors and Peripherals	34
1.9.1 Use of Digital I/O Ports for Switching Relays	35
1.10 Maintenance	36
1.10.1 Desiccant	36
1.10.2 Replacing the Internal Battery	36
Section 2. Data Storage and Retrieval	41
2.1 Data Storage in CR5000	41
2.1.1 Internal Static RAM	41
2.1.2 PCMCIA PC Card	41
2.2 Internal Data Format	42
2.3 Data Collection	43
2.3.1 The Collect Menu	43
2.3.1.1 File Type	44
2.3.1.2 Collection Method	44
2.3.1.3 Table Selection	45
2.3.1.4 File Control	45
2.3.1.5 Status Messages	46
2.3.2 RealTime Write File	46
2.3.3 Logger Files Retrieve	47
2.3.4 Via PCMCIA PC Card	47
2.3.4.1 Inserting a PC Card	47
2.3.4.2 Removing Card from CR5000	48
2.3.4.3 Converting File Format	49
2.4 Data Format on Computer	50
2.4.1. Header Information	50
2.4.2 TOA5 ASCII File Format	51
2.4.2 TOB1 Binary File Format	52
2.4.3 TOB2 Binary File Format	52
Section 3. CR5000 Measurement Details	55
3.1 Analog Voltage Measurement Sequence	55
3.1.1 Voltage Range	55
3.1.2 Reversing Excitation or the Differential Input	56
3.1.3 Measuring Single-Ended Offset	56
3.1.4 SettlingTime	57
3.1.5 Integration	57
3.2 Single Ended and Differential Voltage Measurements	58
3.3 Signal Settling Time	59
3.3.1 Minimizing Settling Errors	60
3.3.2 Measuring the Necessary Settling Time	60
3.4 Thermocouple Measurements	61
3.4.1 Error Analysis	62
Panel Temperature	62
Thermocouple Limits of Error	65
Accuracy of the Thermocouple Voltage Measurement	66
Noise on Voltage Measurement	67
Thermocouple Polynomial: Voltage to Temperature	67
Reference Junction Compensation: Temperature to Voltage	68
Error Summary	69
3.4.2 Use of External Reference Junction or Junction Box	69
3.5 Bridge Resistance Measurements	71
3.6 Measurements Requiring AC Excitation	73
3.7 Pulse Count Measurements	74
3.8 Self Calibration	75
Section 4. CRBasic - Native Language Programming	77
4.1 Format Introduction	77
4.1.1 Mathematical Operations	77
4.1.2 Measurement and Output Processing Instructions	77
4.1.3 Inserting Comments Into Program	78
4.2 Programming Sequence	78
4.3 Example Program	80
4.3.1 Data Tables	80
4.3.2 The Scan -- Measurement Timing and Processing	82
4.4 Numerical Entries	83
4.5 Logical Expression Evaluation	83
4.5.1 What is True?	83
4.5.2 Expression Evaluation	84
4.5.3 Numeric Results of Expression Evaluation	84
4.6 Flags	84
4.7 Parameter Types	85
4.7.1 Expressions in Parameters	85
4.7.2 Arrays of Multipliers Offsets for Sensor Calibration	85
4.8 Program Access to Data Tables	86
Section 5. Program Declarations	89
Alias	89
Const	89
Dim	90
Public	90
Station Name	91
Units	91
Sub, Exit Sub, End Sub	91
Section 6. Data Table Declarations and Output Processing Instructions	95
6.1 Data Table Declaration	95
DataTable (Name, TrigVar, Size)	95
EndTable	95
6.2 Trigger Modifiers	96
DataInterval (TintoInt, Interval, Units, Lapses)	96
OpenInterval	97
DataEvent (RecsBefore, StartTrig, StopTrig, RecsAfter)	98
FillStop	99
WorstCase (TableName, NumCases, MaxMin, Change, RankVar)	100
6.3 Export Data Instructions	102
CardOut (StopRing, Size)	102
DSP4 (FlagVar, Rate)	102
GOESData (Dest, Table, TableOption, BufferControl, DataFormat)	102
GOESStatus (Dest, StatusCommand)	104
6.4 Output Processing Instructions	105
Average (Reps, Source, DataType, DisableVar)	105
Covariance (NumVals, Source, DataType, DisableVar, NumCov)	105
FFT (Source, DataType, N, Tau, Units, Option)	106
FieldNames “list of fieldnames”	109
Histogram (BinSelect, DataType, DisableVar, Bins, Form, WtVal, LoLim, UpLim)	110
Histogram4D (BinSelect, Source, DataType, DisableVar, Bins1, Bins2, Bins3, Bins4, Form, WtVal, LoLim1, UpLim1, LoLim2, UpLim2, LoLim3, UpLim3, LoLim4, UpLim4)	112
LevelCrossing (Source, DataType, DisableVar, NumLevels, 2ndDim, CrossingArray, 2ndArray, Hysteresis, Option)	113
Maximum (Reps, Source, DataType, DisableVar, Time)	117
Minimum (Reps, Source, DataType, DisableVar, Time)	117
RainFlow (Source, DataType, DisableVar, MeanBins, AmpBins, Lowlimit, Highlimit, MinAmp, Form)	118
Sample (Reps, Source, DataType)	120
StdDev (Reps, Source, DataType, DisableVar)	120
Totalize (Reps, Source, DataType, DisableVar)	121
WindVector (Repetitions, Speed/East, Direction/North, DataType, DisableVar, Subinterval, SensorType, OutputOpt)	121
Measured raw data:	123
Calculations:	124
Section 7. Measurement Instructions	127
7.1 Voltage Measurements	129
VoltDiff (Dest, Reps, Range, DiffChan, RevDiff, SettlingTime	129
VoltSE (Dest, Reps, Range, SEChan, MeasOfs, SettlingTime, In	129
7.2 Thermocouple Measurements	129
TCDiff (Dest, Reps, Range, DiffChan, TCType, TRef, RevDiff,	129
TCSE (Dest, Reps, Range, SEChan, TCType, TRef, MeasOfs, Sett	130
7.3 Half Bridges	131
BrHalf (Dest, Reps, Range, SEChan, ExChan, MeasPEx, ExmV, Re	131
BrHalf3W (Dest, Reps, Range, SEChan, ExChan, MeasPEx, ExmV,	132
BrHalf4W (Dest, Reps, Range1, Range2, DiffChan, ExChan, Meas	132
7.4 Full Bridges	134
BrFull (Dest, Reps, Range, DiffChan, ExChan, MeasPEx, ExmV,	134
BrFull6W (Dest, Reps, Range1, Range2, DiffChan, ExChan, Meas	135
7.5 Current Excitation	137
Resistance (Dest, Reps, Range, DiffChan, IxChan, MeasPEx, Ex	137
7.6 Excitation/Continuous Analog Output	139
ExciteCAO (CAOChan, CAOmV, Boost, FastUpdate)	139
ExciteI (IxChan, IxuA, XDelay)	140
ExciteV (ExChan, ExmV, XDelay)	140
7.7 Self Measurements	141
Battery (Dest)	141
PanelTemp (Dest, Integ)	141
Calibrate (Dest, AllRanges)	142
7.8 Digital I/O	145
PeriodAvg (Dest, Reps, Range, SEChan, Threshold, PAOption, C	145
PortGet (Dest, Port)	147
PortSet (Port, State)	148
PulseCount (Dest, Reps, PChan, PConfig, POption, Mult, Offse	149
PulseCountReset	151
ReadIO (Dest, Mask)	151
SW12	152
TimerIO	153
WriteIO (Mask, Source)	154
7.9 Peripheral Devices	155
AM25T (Dest, Reps, Range, AM25TChan, DiffChan, TCType, Tref,	155
AO4 (Source, Reps, SDMAdress)	156
CANBUS (Dest, SDMAddress, TimeQuanta, TSEG1, TSEG2, ID, Data	157
CD16AC (Source, Reps, SDMAddress)	162
CS7500 (Dest, Reps, SDMAddress, CS7500Cmd)	163
CSAT3 (Dest, Reps, SDMAddress, CSAT3Cmd, CSAT3Opt)	164
INT8 (Dest, Address, Config8_5, Config4_1, Funct8_5, Funct4_	165
SDMSpeed (BitPeriod)	168
SDMTrigger	168
SIO4 (Dest, Reps, SDMAddress, Mode, Command, Param1, Param2,	168
SW8A (Dest, Reps, SDMAddress, FunctOp, SW8AStartChan, Mult,	170
Section 8. Processing and Math Instructions	173
ABS (Source)	173
ACOS (Source)	174
AND	174
ASIN (Source)	175
ATN (Source)	176
ATN2()	176
AvgSpa (Dest, Swath, Source)	177
AvgRun (Dest, Reps, Source, Number)	178
Cos (Source)	179
CosH (Source)	179
Spatial Covariance	180
Exp	181
FFTSpa (Dest, N, Source, Tau, Units, Option)	181
Frac (Source)	183
GetRecord (Dest, TableName, RecsBack)	183
IfTime	184
IIF	185
IMP	185
Int, Fix	186
Log (Source)	187
LOG10 (number)	187
MemoryTest (Dest)	188
MaxSpa (Dest, Swath, Source)	188
MinSpa (Dest, Swath, Source)	189
Mod	189
Move (Dest, Swath, Source)	190
NOT	190
Or	191
PeakValley (DestPV, DestChange, Reps, Source, Hysteresis)	192
PRT (Dest, Reps, Source, Mult, Offset)	194
Randomize (Source)	194
RealTime	195
RectPolar (Dest, Source)	196
RMSSpa (Dest, Swath, Source)	197
RND (Source)	197
StrainCalc (Dest, Reps, Source, BrZero, BrConfig, GF, v)	198
Rnd	200
Sgn (Source)	201
Sin (Source)	201
SinH (Source)	202
Sqr (Source)	202
StdDevSpa	203
Tan (Source)	203
TANH (Source)	204
XOR	204
Derived Math Functions	205
Section 9. Program Control Instructions	207
BeginProg, EndProg	207
Call	208
CallTable	208
Data, Read, Restore	209
ClockSet (Source)	209
Delay (Option, Delay, Units)	210
Do	211
FileManage	212
FileMark (TableName)	213
Print list of variables or quoted text	218
RunDLDFile	218
Reset Table	219
Scan	219
Select Case Statement	221
Sleep	223
Slow Sequence	223
SubScan (SubInterval, Units, SubRatio)	225
Timer	226
While…Wend	227
Appendix A. CR5000 Status Table	229
Index	233

Match case Limit results 1 per page

4-1

Section 4.

CRBasic - Native Language

Programming

The CR5000 is programmed in a language that has some similarities to a structured basic.

There are special instructions for making measurements and for creating tables of output

data.

The results of all measurements are assigned variables (given names).

Mathematical operations are written out much as they would be algebraically.

This

section describes a program, its syntax, structure, and sequence.

4.1

Format Introduction

4.1.1

Mathematical Operations

Mathematical operations are written out much as they would be algebraically.

For example, to convert a temperature in Celsius to Fahrenheit one might

write:

TempF = TempC * 1.8 + 32

With the CR5000 there may be 2 or 20 temperature (or other) measurements.

Rather than have 20 different names, a

variable array

with one name and 20

elements may be used.

A thermocouple temperature might be called TCTemp.

With an array of 20 elements the names of the individual temperatures are

TCTemp(1), TCTemp(2), TCTemp(3), ... TCTemp(20).

The array notation

allows compact code to perform operations on all the variables.

For example,

to convert ten temperatures in a variable array from C to F:

For I=1 to 10

TCTemp(I)=TCTemp(I)*1.8+32

Next I

4.1.2

Measurement and Output Processing Instructions

Measurement instructions are procedures that set up the measurement

hardware to make a measurement and place the results in a variable or a

variable array.

Output processing instructions are procedures that store the

results of measurements or calculated values.

Output processing includes

averaging, saving maximum or minimum, standard deviation, FFT, etc.

The instructions for making measurements and outputting data are not found in

a standard basic language.

The instructions Campbell Scientific has created for

these operations are in the form of procedures.

The procedure has a keyword

name and a series of parameters that contain the information needed to

complete the procedure.

For example, the instruction for measuring the

temperature of the CR5000 input panel is:

PanelTemp

(Dest, Integ)