CR1000 Manual - Campbell Scientific

Section 7. Installation
7.8.3.2 SDI-12 Programmed Modes
7.8.3.2.1 SDI-12 Recorder Mode
Send Data Commands (aD0! to aD9!)
These commands requests data from the sensor. They are normally issued
automatically by the CR1000 after measurement commands aMv! or aCv!. In
transparent mode, the user asserts these commands in series to obtain data. If the
expected number of data values are not returned in response to a aD0! command,
the data logger issues aD1!, aD2!, etc., until all data are received. In transparent
mode, a user does likewise. The limiting constraint is that the total number of
characters that can be returned to a aDv! command is 35 characters (75 characters
for aCv!). If the number of characters exceed the limit, the remainder of the
response are obtained with subsequent aDv! commands wherein v increments (v =
0 to 9) with each iteration.
Continuous Measurement Command (aR0! to aR9!)
Sensors that are able to continuously monitor the phenomena to be measured,
such as a shaft encoder, do not require a Start Measurement (M) command. They
can be read directly with the Continuous Measurement Command (R0! to R9!).
For example, if the sensor is operating in a continuous measurement mode, then
aR0! will return the current reading of the sensor. Responses to R commands are
formatted like responses to D commands. The main difference is that R
commands do not require a preceding M command. The maximum number of
characters returned in the part of the response is 75.
Each R command is an independent measurement. For example, aR5! need not
be preceded by aR0! through aR4!. If a sensor is unable to take a continuous
measurement, then it must return its address followed by (carriage
return and line feed) in response to an R command. If a CRC was requested, then
the must be preceded by the CRC.
The CR1000 can be programmed to act as an SDI-12 recording device, or as an
SDI-12 sensor.
For troubleshooting purposes, responses to SDI-12 commands can be captured in
programmed mode by placing a variable declared As String in the variable
parameter. Variables not declared As String will capture only numeric data.
Another troubleshooting tool is the terminal-mode snoop utility, which allows
monitoring of SDI-12 traffic. Enter terminal mode as described in SDI-12
Transparent Mode (p. 173), issue CRLF ( Key) until CR1000> prompt
appears. Type W and then . Type 9 in answer to Select:, 100 in answer
to Enter timeout (secs):, Y to ASCII (Y). SDI-12 communications are then
opened for viewing.
The SDI12Recorder() instruction automates the issuance of commands and
interpretation of sensor responses. Commands entered into the SDIRecorder()
instruction differ slightly in function from similar commands entered in
transparent mode. In transparent mode, for example, the operator manually enters
aM! and aD0! to initiate a measurement and get data, with the operator providing
the proper time delay between the request for measurement and the request for
data. In programmed mode, the CR1000 provides command and timing services
within a single line of code. For example, when the SDI12Recorder() instruction
177