beautypg.com

Campbell Scientific CR10X Measurement and Control System User Manual

Page 249

background image

C-1

APPENDIX C. ADDITIONAL TELECOMMUNICATIONS INFORMATION

C.1 TELECOMMUNICATIONS

COMMAND WITH BINARY
RESPONSES

Command

Description

[nnnnn]F

BINARY DUMP - CR10X

sends, in Final Storage Format
(binary), the number of Final
Storage locations specified
(nnnnn) from current MPTR
locations, then Signature (no
prompt).

A 40 second time out timer is
reset each F command. nnnnn
must be

≤ 65535.

DATALOGGER J AND K COMMANDS

3142J and 2413J

The older 3142J command is used to toggle
datalogger user flags and ports, request final
storage data, and to establish the input
locations returned by the K command. The
newer 2413J was added to later operating
systems and is identical to the 3412J command
except that when the datalogger receives the
2413J command, it ignores the bytes that toggle
flags and ports. Setting ports and flags in the
new operating systems is done with the U
command which adds checksums for improved
reliability.

A note on datalogger OS versions:
Beginning with Version 1.10 of the CR10X
operating system (released October 1999), the
datalogger can use either the new 2413J
command or the older 3412J command. Since
the J command is not sent with a checksum, the
older 3142J could, over a noisy communications
link, be misinterpreted and cause unintended
changes to flags or ports. The advantage of the
new version of the J command is that it does
not attempt to set flags or ports; instead,
software can use the new U command which is
sent with a checksum to accomplish setting of
flags, ports and input locations.
Telecommunications software can determine
whether the new J command is available in a
particular datalogger by issuing an A command
to request the datalogger’s status (Section 5,
Telecommunications). If the datalogger version

number is reported as V4, the datalogger OS
can use the new 2413J, as well as the new S, T
and U commands. See Section 5,
Telecommunications, for a description of these
commands.

The format of the J command is as follows:

2413Jabcd…nNULL

or

3142Jabcd...nNULL

where

1) either "2413J" or "3142J" is the

command.

2) "a" is a 1 byte value representing the user

flags to be toggled. The most significant bit
(MSB), if set, will toggle datalogger user flag
8. Likewise, the 2nd most significant bit, if
set, will toggle user flag 7, and so on to the
least significant bit which, if set, toggles
user flag 1. Toggle means that if a flag is
set, it will be then reset, or if it is reset, it will
be set.

3) "b" is a 1 byte value whose MSB will

determine whether Final Storage Data is
returned after the K command. If the bit is
set, Final Storage Data, if any, will be
returned after the next K command. The
datalogger initially has this bit reset upon
entering telecommunications, but once set by
a J command, it will remain set until reset by
another J command or telecommunications is
terminated.

The 2nd MSB set means a port toggle byte
will follow and port status is to be returned
with the K command. Like the MSB, this bit
is reset upon entering telecommunications,
but remains set once set until reset by
another J command or telecommunications
is terminated.

The 3rd MSB is ignored.

The 4th MSB indicates if the input locations
requested by the J command are 2 byte (B4
set) or 1 byte. In the case of 2 byte
locations (most significant byte first), the
terminating location is a 2 byte NULL. FF in