METER TEROS 22 Soil Water Potential Sensor User Guide

TEROS 22 INTEGRATOR GUIDE

SENSOR DESCRIPTION

The TEROS 22 Soil Water Potential Sensor measures a wide range of soil water potentials without user maintenance. This dielectric water potential sensor can be packed into a hole, plugged into a data logger, and left to log water potential data. While the TEROS 22 sensor does not have the accuracy of tensiometers, its extended range makes this sensor ideal for measuring the water potential in natural systems or other drier systems where cavitation of tensiometers is a concern. The added temperature measurements can be used to determine approximate soil water potential in frozen soils.
NOTE: The TEROS 22 measures the matric component of water potential. For more information on matric potential and the other components of water potential visit Defining water potential.

APPLICATIONS

• Deficit irrigation monitoring and control
• Water potential monitoring in the vadose zone
• Crop stress
• Waste water drainage studies
• Plant water availability

ADVANTAGES

• Three-wire sensor interface: power, ground, and data
• Digital sensor communicates multiple measurements over a serial interface
• Robust thermistor for accurate temperature measurements
• Low-input voltage requirements
• Low-power design supports battery-operated data loggers
• Robust epoxy encapsulation resists corrosive environments
• Supports SDI-12 or DDI serial communications protocols
• Modern design optimized for low-cost sensing
• Does not require a skilled operator
• Can measure drier systems where tensiometer cavitation is a concern
• Needs no user maintenance

Figure 1 TEROS 22 sensor

PURPOSE OF THIS GUIDE

METER provides the information in this integrator guide to help TEROS 22 Soil Water Potential Sensor customers establish communication between these sensors and their data acquisition equipment or field data loggers. Customers using data loggers that support SDI-12 sensor communications should consult the data logger user manual. METER sensors are fully integrated into the METER system of plug-and-play sensors, cellular-enabled data loggers, and data analysis software.

COMPATIBLE FIRMWARE VERSIONS

This guide is compatible with firmware versions 1.00 or newer for the TEROS 22.

SPECIFICATIONS

MEASUREMENT SPECIFICATIONS

Water Potential

NOTE: TEROS 22 can read up to 0 kPa when on a wetting path.
The air entry of the soil limits the performance of the sensor to −5 kPa on the drying curve.
NOTE: TEROS 22 is not well calibrated beyond −100 kPa. For more information on using the TEROS 22 beyond this range, see the TEROS 22 User Manual.
Dielectric Measurement Frequency
70 MHz
Temperature

COMMUNICATION SPECIFICATIONS
Output
DDI Serial or SDI-12 communications protocol
Data Logger Compatibility
METER ZL6 and EM60 data loggers or any data acquisition system capable of 3.9- to 15-VDC power and serial or SDI-12 communications
PHYSICAL SPECIFICATIONS
Dimensions

Sensor Diameter
3.2 cm (1.3 in)
Operating Temperature Range

NOTE: Sensors may be used at higher temperatures under certain conditions; contact Customer Support for assistance.
Cable Length
5 m (standard)
75 m (maximum custom cable length)
NOTE: Contact Customer Support if a nonstandard cable length is needed.

Connector Types
Stereo plug connector or stripped and tinned wires
Stereo Plug Connector Diameter
3.5 mm
Cable Diameter
0.165 ± 0.004 in (4.20 ± 0.10 mm), with minimum jacket of 0.030 in (0.76 mm)
Conductor Gauge
22-AWG / 24 AWG drain wire
MEASUREMENT AND TIMING CHARACTERISTICS
Supply Voltage (VCC to GND)

Digital Input Voltage (logic low)

Digital Output Voltage (logic high)

Power Line Slew Rate

Current Drain (during measurement)

Current Drain (while asleep)

Power-Up Time (DDI Serial)

Power-Up Time (SDI-12)

Power-Up Time (SDI-12, DDI Serial disabled)

Measurement Duration

COMPLIANCE
EN 55011:2016 / A1:2017 (RCM Mark)

EQUIVALENT CIRCUIT AND CONNECTION TYPES

Refer to Figure 2 and Figure 3 to connect the TEROS 22 to a data logger. Figure 2 provides a low-impedance variant of the recommended SDI-12 specification.Figure 2 Equivalent circuit diagram
PIGTAIL CABLE STEREO CABLE Figure 3 Connection type

PRECAUTION

METER sensors are built to the highest standards, but misuse, improper protection, or improper installation may damage the sensor and possibly void the warranty. Before integrating sensors into a sensor network, follow the recommended installation instructions and implement safeguards to protect the sensor from damaging interference.
POWER AND GROUNDING
Ensure there is sufficient power to simultaneously support the maximum sensor current drain for all the sensors on the bus. The sensor protection circuitry may be insufficient if the data logger is improperly powered or grounded. Refer to the data logger installation instructions. Improper grounding may affect the sensor output as well as sensor performance.
Read the application note Lightning surge and grounding practices on the METER website for more information.

CABLES

Improperly protected cables can lead to severed cables or disconnected sensors. Cabling issues can be caused by many factors, including rodent damage, driving over sensor cables, tripping over the cable, not leaving enough cable slack during installation, or poor sensor wiring connections. To relieve strain on the connections and prevent loose cabling from being inadvertently snagged, gather and secure the cable travelling between the TEROS 22 and the data acquisition device to the mounting mast in one or more places. Install cables in conduit or plastic cladding when near the ground to avoid rodent damage. Tie excess cable to the data logger mast to ensure cable weight does not cause sensor to unplug.

SENSOR COMMUNICATIONS

METER digital sensors feature a serial interface with shared receive and transmit signals for communicating sensor measurements on the data wire (Figure 3). The sensor supports two different protocols: SDI-12 and DDI Serial. Each protocol has implementation advantages and challenges. Please contact Customer Support if the protocol choice for the desired application is not obvious.
SDI-12 INTRODUCTION
SDI-12 is a standards-based protocol for interfacing sensors to data loggers and data acquisition equipment. Multiple sensors with unique addresses can share a common 3-wire bus (power, ground, and data). Two-way communication between the sensor and logger is possible by sharing the data line for transmit and receive as defined by the standard. Sensor measurements are triggered by protocol command. The SDI-12 protocol requires a unique alphanumeric sensor address for each sensor on the bus so that a data logger can send commands to and receive readings from specific sensors.
Download the SDI-12 Specification v1.3 to learn more about the latest SDI-12 protocol.
DDI SERIAL INTRODUCTION
The DDI Serial protocol is the method used by METER data loggers for collecting data from the sensor. This protocol uses the data line configured to transmit data from the sensor to the receiver only (simplex). Typically, the receive side is a microprocessor UART or a general-purpose I/O pin using a bitbang method to receive data. Sensor measurements are triggered by applying power to the sensor.
INTERFACING THE SENSOR TO A COMPUTER
The serial signals and protocols supported by the sensor require some type of interface hardware to be compatible with the serial port found on most computers (or USB-to-serial adapters). There are several SDI-12 interface adapters available in the marketplace; however, METER suggests using the AC-421 SDI-12 to USB converter from Apogee Instruments. METER data loggers can operate as a computer-to-sensor interface for making on-demand sensor measurements. For more information, please contact Customer Support.
METER SDI-12 IMPLEMENTATION
METER sensors use a low-impedance variant of the SDI-12 standard sensor circuit (Figure 2). During the power-up time, the sensors output some sensor diagnostic information and should not be communicated with until the power-up time has passed. After the power-up time, the sensors are compatible with all commands listed in the SDI-12 Specification v1.3 except for the continuous measurement commands (aR0–aR9 and aRC0– aRC9). M, R, and C command implementations are found on pages 7–8. The aXR3 and aXR4 commands are used by METER systems and as a result use a space delimiter, instead of a sign delimiter as required by the SDI-12 standard.
Out of the factory, all METER sensors start with SDI-12 address 0 and print out the DDI Serial startup string during the power-up time. This can be interpreted by non-METER SDI-12 sensors as a pseudo-break condition followed by a random series of bits.
The TEROS 22 will omit the DDI Serial startup string (sensor identification) when the SDI-12 address is nonzero or if is set to 1. Changing the address to a nonzero address is recommended for this reason.
SENSOR BUS CONSIDERATIONS
SDI-12 sensor buses require regular checking, sensor upkeep, and sensor troubleshooting. If one sensor goes down, it may take down the whole bus even if the remaining sensors are functioning normally. METER SDI-12 sensors can be power-cycled and read on the desired measurement interval or powered continuously and commands sent when a measurement is desired. Many factors influence the effectiveness of the bus configuration. Visit metergroup.com for articles and virtual seminars containing more information.
SENSOR ERROR CODES
The TEROS 22 has two error codes:

• -9999 is output in place of the measured value if the sensor detects that the measurement function has been compromised and the subsequent measurement values have no meaning
• -9992 is output in place of the measured value if the sensor detects corrupt or lost calibrations

SDI-12 CONFIGURATION
Table 1 lists the SDI-12 communication configuration.

SDI-12 TIMING
All SDI-12 commands and responses must adhere to the format in Figure 4 on the data line. Both the command and response are preceded by an address and terminated by a carriage return and line feed combination ( ) and follow the timing shown in Figure 5.Figure 4 Example SDI-12 transmission of the character 1 (0x31)    Figure 5 Example data logger and sensor communication
COMMON SDI-12 COMMANDS
This section includes tables of common SDI-12 commands that are often used in an SDI-12 system and the corresponding responses from METER sensors.
IDENTIFICATION COMMAND ( aI! )
The Identification command can be used to obtain a variety of detailed information about the connected sensor. An example of the command and response is shown in Example 1, where the command is in bold and the response follows the command.
Example 1 1I!113METER ␣ ␣ ␣ TER22 ␣ 100631800001

Request to the sensor for information from sensor address  1 .
1| 1| Sensor address.
Prepended on all responses, this indicates which sensor on the bus is returning the
following information.
13| 2| Indicates that the target sensor supports SDI-12 Specification v1.3.
METER␣ ␣ ␣| 8| Vendor identification string.
( METER  and three spaces ␣ ␣ ␣)
TER22 ␣| 6| Sensor model string.
This string is specific to the sensor type.
For the TEROS 22, the string is  TER22␣  .
100| 3| Sensor version.
This number divided by 100 is the METER sensor version (e.g.,  100  is version 1.00).
631800001| ≤13, variable| Sensor serial number.
This is a variable length field. It may be omitted for older sensors.

NOTE: In the event that the fixed length is longer than the parameter, the trailing characters will be populated with space characters.
CHANGE ADDRESS COMMAND ( aAB! )
The Change Address command is used to change the sensor address to a new address. All other commands support the wildcard character as the target sensor address except for this command. All METER sensors have a default address of 0 (zero) out of the factory. Supported addresses are alphanumeric (i.e., a – z , A – Z , and 0 – 9 ). An example output from a METER sensor is shown in Example 2, where the command is in bold and the response follows the command.
Example 2 1A0!0

Request to the sensor to change its address from  1  to a new address of  0 .
0| 1| New sensor address.
For all subsequent commands, this new address will be used by the target sensor.

ADDRESS QUERY COMMAND (?!)
While disconnected from a bus, the Address Query command can be used to determine which sensor is currently being communicated with. Sending this command over a bus will cause a bus contention where all the sensors will respond simultaneously and corrupt the data line. This command is helpful when trying to isolate a failed sensor. Example 3 shows an example of the command and response, where the command is in bold and the response follows the command. The question mark ( ? ) is a wildcard character that can be used in place of the address with any command except the Change Address command.
Example 3 ?!0

Request for a response from any sensor listening on the data line.
0| 1| Sensor address.
Returns the sensor address to the currently connected sensor.

COMMAND IMPLEMENTATION

The following tables list the relevant Measurement ( M ), Verification ( V ), Extended ( X ), Continuous ( R ), and Concurrent ( C ) commands and subsequent Data ( D ) commands, when necessary.

MEASUREMENT COMMANDS IMPLEMENTATION

The following tables list the relevant Measurement ( M ), Verification (V), Extended (X), and Concurrent (C) commands. Also listed are subsequent Data (D) commands, which are used to retrieve data from M, V, and C commands. M commands are sent to a single sensor on the SDI-12 bus and require that subsequent D commands are sent to that sensor to retrieve the sensor output data before initiating communication with another sensor on the bus.
Please refer to Table 2 and for an explanation of the command sequence and see Table 8 for an explanation of response parameters.
Table 2 aM! measurement command sequence

This command reports instantaneous values.
 aM!|  atttn
aD0!|  a-±

NOTE: The measurement and corresponding data commands are intended to be used back-to-back. After a measurement command is processed by the sensor, a service request a is sent from the sensor signaling the measurement is ready. Either wait until ttt seconds have passed or wait until the service request is received before sending the data commands. See the SDI-12 Specifications v1.3 document for more information.

CONCURRENT MEASUREMENT COMMANDS IMPLEMENTATION

Concurrent Measurement ( C ) commands are typically used with sensors connected to a bus. This sensor supports the Concurrent Measurement command; however, the implementation is not fully compliant with the SDI-12 specification for Concurrent Measurement commands. It is not possible for a recorder to interrupt a Concurrent Measurement command by issuing a second command to this sensor during the time the sensor is making a measurement (ttt). This sensor will only respond to further commands after the specified amount of time detailed in the C command response. The recorder is free to send commands to other sensors during the time the sensor is making measurements.
Please refer to Table 3 for an explanation of the command sequence and see Table 8 for an explanation of response parameters.
Table 3 aC! measurement command sequence

This command reports instantaneous values.
 aC!|  atttnn
 aD0!|  a-±

VERIFICATION COMMAND IMPLEMENTATION
The Verification ( V ) command is intended to give users a means to determine information about the current state of the sensor. The V command is sent first, followed by D commands to read the response.
Table 4 aV! measurement command sequence

EXTENDED COMMAND IMPLEMENTATION
Extended ( X ) commands provide sensors with a means of performing manufacturer-specific functions.
Additionally, the extended commands are utilized by METER systems and use a different response format than standard SDI-12 commands. X commands are required to be prefixed with the address and terminated with an exclamation point. Responses are required to be prefixed with the address and terminated with .
METER implements the following X commands: aXRx! to trigger a sensor measurement and return the data automatically after the readings are completed without needing to send additional commands and aXO! (with capital O) to suppress the DDI string.
Please refer to Table 5 through Table 7 for an explanation of the command sequence and see Table 8 for an explanation of response parameters.
Table 5 aXO! measurement command sequence

Table 6 aXR3! measurement command sequence

Table 7 aXR4! measurement command sequence

PARAMETERS

Table 8 lists the parameters, unit measurement, and a description of the parameters returned in command responses for TEROS 22.
Table 8 Parameter descriptions

2. ttt| s| Maximum time measurement will take (fixed width of 3) | —| Tab character | —| Carriage return character | —| Line feed character | kPa| Matric potential | °C| Air temperature | —| Auxiliary sensor information. See Table 9. | —| O: DDI Serial unsuppressed 1: DDI Serial suppressed | —| ASCII character denoting the sensor type For TEROS 22, the character is k | —| METER serial checksum | —| METER 6-bit CRC

SENSOR METADATA VALUE

The sensor metadata value contains information to help alert users to sensor- identified conditions that may compromise optimal sensor operation. The output of the aV! aD0 sequence will output a integer value.
This integer represents a binary bitfield, with each individual bit representing an error flag.
Table 9 lists the possible error flags that can be set by the TEROS 22. If multiple error flags are set, the sensor metadata integer value will be the sum of the individual values. To decode an integer value not explicitly in Table 9, find the largest error flag value that will fit in the integer value and accept that error as being present. Then, subtract that error flag value from the integer value and repeat the process on the remainder until the result is zero. For example, a sensor metadata integer value of 192 is the sum of the individual error flag values 128 + 64, so this sensor has corrupt firmware and a corrupt or lost sensor calibration.
Table 9 Error flag values and issue resolution

Contact Customer Support to replace sensor
128| Sensor firmware is corrupt| Contact Customer Support for instructions on reloading firmware

DDI SERIAL COMMUNICATION

The DDI Serial communications protocol is ideal for systems that have dedicated serial signaling lines for each sensor or use a multiplexer to handle multiple sensors. The serial communications are compatible with many TTL serial implementations that support active-high logic levels using 0.0- to 3.6-VDC signal levels. When the sensor is first powered, it automatically makes measurements of the integrated transducers then outputs a response over the data line. Systems using this protocol control the sensor excitation to initiate data transfers from the sensor. This protocol is subject to change as METER improves and expands the line of digital sensors and data loggers.
TEROS 22 will omit the DDI Serial startup string when the SDI-12 address is nonzero or suppressed with the aX01! command. METER recommends suppressing the DDI Serial message when this signaling causes negative issues for a sensor measurement device.
NOTE: Out of the factory, all METER sensors start with SDI-12 address 0 and print out the startup string when power cycled.
DDI SERIAL TIMING
Table 10 lists the DDI Serial communication configuration.

At power up, the sensor will pull the data line high within 100 ms to indicate that the sensor is taking a reading (Figure 6). When the reading is complete, the sensor begins sending the serial signal out the data line adhering to the format shown in Figure 7. Once the data is transmitted, the sensor goes into SDI-12 communication mode. To get another serial signal, the sensor must be power cycled.
NOTE: Sometimes the signaling from the sensor can confuse typical microprocessor UARTs. The sensor holds the data line low while taking measurements. The sensor raises the line high to signal the logger that it will send a measurement. Then the sensor may take some additional measurements before starting to clock out the first data byte starting with a typical start bit (low). Once the first start bit is sent, typical serial timing is valid; however, the signal transitions before this point are not serial signaling and may be misinterpreted by the UART.![METER TEROS 22 Soil Water Potential Sensor

• Data line DDI serial timing](https://manuals.plus/wp-content/uploads/2024/01 /METER-TEROS-22-Soil-Water-Potential-Sensor-Data-line-DDI-serial-timing.png) Figure 6 Data line DDI serial timing Figure 7 Example DDI Serial transmission of the character 9 (0x39)

DDI SERIAL RESPONSE
Table 11 details the DDI Serial response.
Table 11 DDI Serial response

NOTE: There is no actual command. The response is returned automatically upon power up.
The values in this command are space delimited. As such, a  + sign is not assigned between values and a – sign is only present if the value is negative.

DDI SERIAL CHECKSUM

These checksums are used in the commands XR3, XR4, as well as the DDI Serial response. The legacy checksum is deprecated in favor of the CRC6 check character and may be ignored. The legacy checksum is computed using the characters after the sensor address (when used with the XR3 or XR4 command) and includes the sensor identification character.
TEROS 22 example input is -34.8 22.3k@l and the resulting checksum output is @.

uint8_t LegacyChecksum(const char response)
{
uint16_t length;
uint16_t i;
uint16_t sum = 0;
// Finding the length of the response string
length = strlen(response);
// Adding characters in the response together
for(i = 0; i < length; i++)
{
sum += response[i];
if(response[i] == ‘\r’)
{
// Found the beginning of the metadata section of the response
break;
}
}
// Include the sensor type into the checksum
sum += response[++i];
// Convert checksum to a printable character
sum = sum % 64 + 32;
return sum;
}
The more robust CRC6 , if available, utilizes the CRC-6-CDMA2000-A polynomial with the value 48 added to the results to make this a printable character and is computed from the start of the transmission to the legacy checksum character.
CRC6 checksum example input is -34.8 22.3k@l and the resulting checksum output is l (lowercase L).
uint8_t CRC6_Offset(const char buffer)
{
uint16_t byte;
uint16_t i;
uint16_t bytes;
uint8_t bit;
uint8_t crc = 0xfc; // Set upper 6 bits to 1’s
// Calculate total message length—updated once the metadata section is found
bytes = strlen(buffer);
// Loop through all the bytes in the buffer
for(byte = 0; byte < bytes; byte++)
{
// Get the next byte in the buffer and XOR it with the crc
crc ^= buffer[byte];
// Loop through all the bits in the current byte
for(bit = 8; bit > 0; bit–)
{
// If the uppermost bit is a 1…
if(crc & 0x80)
{
// Shift to the next bit and XOR it with a polynomial
crc = (crc << 1) ^ 0x9c;
}
else
{
// Shift to the next bit
crc = crc << 1;
}
}
if(buffer[byte] == ‘\r’)
{
// Found the beginning of the metadata section of the response
// both sensor type and legacy checksum are part of the crc6
// this requires only two more iterations of the loop so reset
// “bytes”
// bytes is incremented at the beginning of the loop, so 3 is added
bytes = byte + 3;
}
}
// Shift upper 6 bits down for crc
crc = (crc >> 2);
// Add 48 to shift crc to printable character avoiding \r \n and !
return (crc + 48);
}

CUSTOMER SUPPORT

NORTH AMERICA
Customer service representatives are available for questions, problems, or feedback Monday through Friday, 7:00 am to 5:00 pm Pacific time.

Email: [email protected]
[email protected]
Phone: +1.509.332.5600
Fax: +1.509.332.5158
Website: metergroup.com
EUROPE
Customer service representatives are available for questions, problems, or feedback Monday through Friday, 8:00 to 17:00 Central European time.
Email: [email protected]
[email protected]
Phone: +49 89 12 66 52 0
Fax: +49 89 12 66 52 20
Website: metergroup.de
If contacting METER by email, please include the following information:
Name: Email address
Address :Instrument serial number
Phone number :Description of problem
NOTE: For products purchased through a distributor, please contact the distributor directly for assistance.
REVISION HISTORY
The following table lists document revisions.

References

• METER Group
• METER Group

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>