14
Examples
To set M3 to measure voltage on AN2 with all other parameters set to factory default, use
1XV3+2+FD!
Which will configure the M3 command in the module at SDI-12 address “1” to measure voltage on
channel AN2 with the factory defaults of: slope=1.00, offset=0, Averaging-time=0.067seconds,
Vref-warm-up-time=0.010 seconds, no switched voltage, un-buffered input and auto-gain.
If M3 is currently set to measure something other than voltage, then
1XV3+2! is equivalent to 1XV3+2+FD!
Note:
An „FD‟ except in place of reference channel is invalid, i.e.
1XV3+FD! or
1XV3+2+3+FD! or
1XV3+2+3+2.0+FD!
are all invalid commands
To set M3 to measure the voltage on AN2 with a switched voltage of 5volts and all other parameters
set to factory default, first use
1XV3+2+FD! and then
1XV3+X+X+X+X+X+X+5!
All the X‟s in the example except the 2
nd
„X‟ means “leave the parameter unchanged” (factory
default in this example).
Note:
Using 1XV3+2+X+X+X+X+X+5! instead of sequence of two commands, in above example, will
also do the same but the parameters substituted by „X‟ may or may not be factory defaults. They
depend on what M3 was configured for prior to this set-up. If M3 is set for something other than
voltage, then parameters substituted by „X‟ will be default voltage-measurement parameters.
If M3 is set to measure voltage and you need to change just few parameters, say Vref-warm-up time
to 30 milli-seconds, use
1XV3+X+X+X+X+X+0.03!
Verification and Reading current Set-up
There are 3 options to read set-up
1.
aD0 command after XV command
2.
aXVm command (1XV3! in our examples)
3.
aXGm and aXGm+2 commands (1XG3! And 1XG3+2! in our examples)
All of the different kinds of set-up commands return
10027<CR><LF>
(it may be 3 instead of 1 depending on SDI-12 AnalogPlus module address)
which means it will return 7 parameters on a successive D0 command after 2 seconds. The response
to D0 is
1+s+o+t+v+w+x+g<CR><LF>
(the alphabetic characters in lower-case have the same meaning as
mentioned above).
You won‟t see channel information and input type because SDI-12 command D0 can not return an
alphabetic character. To determine the channel set-up of the voltage measurement on M3, you may
use the
1XV3!
Command which returns
1+p+n+s+o+t+v+i+g<CR><LF> or
1+NC<CR><LF> if M3 is not configured to measure voltage.
