Campbell Scientific CR23X Micrologger User Manual
Page 269
C-1
APPENDIX C. ADDITIONAL TELECOMMUNICATIONS INFORMATION
C.1 TELECOMMUNICATIONS
COMMAND WITH BINARY
RESPONSES
Command
Description
[nnnnn]F
BINARY DUMP - CR23X
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.7 of the CR23X
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:
2413J
or
3142J
where
1) either "2413J
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 set means a flags 11..18 byte
will follow the port toggle byte (if present)
and flags 11..18 byte 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