Campbell Scientific CR1000KD CR800 and CR850 Measurement and Control Systems - Page 126

Table 12., TOA5 Environment Line, FieldNames

Page 126 highlights

Section 7. Installation • name of the CRBasic program running in the datalogger • name of the data table (limited to 20 characters) • alphanumeric field names to attach at the head of data columns This information is referred to as "table definitions." Table Typical Data Table (p. 127) shows a data file as it appears after the associated data table has been downloaded from a CR800 programmed with the code in CRBasic example Definition and Use of a Data Table (p. 127). The data file consists of five or more lines. Each line consists of one or more fields. The first four lines constitute the file header. Subsequent lines contain data. Note Discrete data files (TOB1, TOA5, XML) can also be written to CR800 CPU memory using the TableFile() instruction. The first header line is the Environment Line. It consists of eight fields, listed in table TOA5 Environment Line (p. 126). Table 12. TOA5 Environment Line Field Description 1 file type (always TOA5) 2 station name 3 datalogger model 4 datalogger serial number 5 datalogger OS version 6 datalogger program name 7 datalogger program signature 8 table name Changed via no change DevConfig or CRBasic program no change no change send new OS send new program send / change Program change program The second header line reports field names. This line consists of a set of commadelimited strings that identify the name of individual fields as given in the datalogger program. If the field is an element of an array, the name will be followed by a comma-separated list of subscripts within parentheses that identifies the array index. For example, a variable named values that is declared as a two-by-two array in the datalogger program will be represented by four field names: values(1,1), values(1,2), values(2,1), and values(2,2). Scalar variables will not have array subscripts. There will be one value on this line for each scalar value defined by the table. Default field names are a combination of the variable names (or alias) from which data are derived and a three-letter suffix. The suffix is an abbreviation of the data process that output the data to storage. For example, Avg is the abbreviation for average. If the default field names are not acceptable to the programmer, FieldNames() instruction can be used to customize field names. "TIMESTAMP", "RECORD", "Batt_Volt_Avg", "PTemp_C_Avg", "TempC_Avg(1)", and "TempC_Avg(2)" are default field names in table Typical Data Table (p. 127). 126

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510
  • 511
  • 512
  • 513
  • 514
  • 515
  • 516
  • 517
  • 518
  • 519
  • 520
  • 521
  • 522
  • 523
  • 524
  • 525
  • 526
  • 527
  • 528
  • 529
  • 530
  • 531
  • 532
  • 533
  • 534
  • 535
  • 536
  • 537
  • 538
  • 539
  • 540
  • 541
  • 542
  • 543
  • 544
  • 545
  • 546
  • 547
  • 548
  • 549
  • 550
  • 551
  • 552
  • 553
  • 554
  • 555
  • 556
  • 557
  • 558
  • 559
  • 560
  • 561
  • 562
  • 563
  • 564
  • 565
  • 566

Section 7.
Installation
126
name of the CRBasic program running in the datalogger
name of the data table (limited to 20 characters)
alphanumeric field names to attach at the head of data columns
This information is referred to as "table definitions."
Table
Typical Data Table
(p. 127)
shows a data file as it appears after the associated
data table has been downloaded from a CR800 programmed with the code in
CRBasic example
Definition and Use of a Data Table
(p. 127).
The data file
consists of five or more lines.
Each line consists of one or more fields.
The first
four lines constitute the file header.
Subsequent lines contain data.
Note
Discrete data files (TOB1, TOA5, XML) can also be written to CR800 CPU
memory using the TableFile() instruction.
The first header line is the Environment Line. It consists of eight fields, listed in
table
TOA5 Environment Line
(p. 126).
Table 12.
TOA5 Environment Line
Field
Description
Changed via
1
file type (always TOA5)
no change
2
station name
DevConfig
or CRBasic program
3
datalogger model
no change
4
datalogger serial number
no change
5
datalogger OS version
send new OS
6
datalogger program name
send new program
7
datalogger program signature
send / change Program
8
table name
change program
The second header line reports field names.
This line consists of a set of comma-
delimited strings that identify the name of individual
elds as given in the
datalogger program.
If the
eld is an element of an array, the name will be
followed by a comma-separated list of subscripts within parentheses that
identifies the array index. For example, a variable named values that is declared as
a two-by-two array in the datalogger program will be represented by four
eld
names: values(1,1), values(1,2), values(2,1), and values(2,2). Scalar variables will
not have array subscripts.
There will be one value on this line for each scalar
value de
ned by the table.
Default field names are a combination of the variable
names (or alias) from which data are derived and a three-letter suffix.
The suffix
is an abbreviation of the data process that output the data to storage.
For example,
Avg
is the abbreviation for average.
If the default field names are not acceptable
to the programmer,
FieldNames()
instruction can be used to customize field
names.
“TIMESTAMP”, “RECORD”, “Batt_Volt_Avg”, “PTemp_C_Avg”,
“TempC_Avg(1)”, and “TempC_Avg(2)” are default field names in table
Typical
Data Table
(p. 127).