Model SDI-12 Inclinometer - WaterLOG® Inclinometer Model H-335 Owner's Manual Version 1.3 Design...

32
SDI-12 Inclinometer Model H-335 Owner's Manual Version 1.3 Design Analysis Associates 75 West 100 South Logan, UT 84321 USA Phone: (435) 753-2212 Fax: (435) 753-7669 Internet: www.waterlog.com E-mail: [email protected]

Transcript of Model SDI-12 Inclinometer - WaterLOG® Inclinometer Model H-335 Owner's Manual Version 1.3 Design...

SDI-12 Inclinometer

ModelH-335

Owner's ManualVersion 1.3

Design Analysis Associates 75 West 100 South Logan, UT 84321 USA Phone: (435) 753-2212 Fax: (435) 753-7669 Internet: www.waterlog.com E-mail: [email protected]

User Agreement/WATERLOG® Warranty

H-355 User Agreement/WATERLOG® Warranty W-1

1. NATURE OF THE PRODUCTThis agreement accompanies an interface module comprising firmware, circuitry and other electronicequipment in an enclosed housing, and packaged together with written instructional materials. Thepackaged electronic circuitry and instructional materials herein are collectively referred to as the“PRODUCT.” The PRODUCT is made available from DESIGN ANALYSIS ASSOCIATES, INC., of75 West 100 South, Logan, Utah 84321 (hereinafter referred to as “DESIGN ANALYSIS”), and containsinformation and embodies technology that is confidential and proprietary to DESIGN ANALYSIS, and theavailability and use of the PRODUCT is extended to you, the USER, solely on the basis of the terms ofagreement which follow.

2. ACKNOWLEDGMENTS BY USEROpening the package which encloses the accompanying PRODUCT indicates your acceptance of the termsand conditions of this agreement and constitutes an acknowledgment by you of the confidential andproprietary nature of the rights of DESIGN ANALYSIS in the PRODUCT.

3. DUTIES OF YOU, THE USERIn consideration for the access to and use of the PRODUCT extended to you by DESIGN ANALYSIS andto protect the confidential and proprietary information of DESIGN ANALYSIS, USER agrees as follows:

(a) USER agrees that they will not remove from the exterior of the housing of the PRODUCT any safetywarnings or notices of proprietary interest placed thereon by DESIGN ANALYSIS.

(b) USER agrees that they shall not disassemble or otherwise reverse engineer the PRODUCT.

(c) USER agrees to treat the PRODUCT with the same degree of care as USER exercises in relation totheir own confidential and proprietary information.

4. TERMUSER may enjoy these rights only as long as their possession of the PRODUCT shall continue to berightful. These rights will cease if the PRODUCT is returned to DESIGN ANALYSIS under the terms ofany redemption offer, warranty, or money-back guarantee, or if USER transfers the PRODUCT to anotherparty on terms inconsistent with this agreement.

5. LIMITED WARRANTY(b) What is CoveredDESIGN ANALYSIS warrants that for a period of twelve months from the time of purchase thefunctions to be performed by the PRODUCT will be substantially in compliance with USERdocumentation. DESIGN ANALYSIS also warrants that the PRODUCT will be free from defectsin materials and workmanship for a period of ONE YEAR from the date of purchase.

(b) What USER Must DoIf the product fails to satisfy the above warranty, USER must notify DESIGN ANALYSIS inwriting within the applicable period specified above and reasonably cooperate with the directionsthey received from DESIGN ANALYSIS.

W-2 User Agreement/WATERLOG® Warranty H-355

(c) What DESIGN ANALYSIS Will DoDESIGN ANALYSIS will repair the PRODUCT or will endeavor to provide a replacement ofsame within a reasonable period of time. In the event that DESIGN ANALYSIS is unable to makethe necessary repairs or replacement within a reasonable period of time, the original purchase pricewill be refunded upon the return of the PRODUCT to DESIGN ANALYSIS.

(d) Limitations

(i) THE ENTIRE REMEDY FOR BREACH OF THIS LIMITED WARRANTY SHALLBE LIMITED TO REPLACEMENT OF THE DEFECTIVE PRODUCT ORREFUNDING OF THE PURCHASE PRICE, AS SET FORTH ABOVE. IN NOEVENT WILL THE LIABILITY OF DESIGN ANALYSIS TO USER OR TO ANYOTHER PARTY EXCEED THE ORIGINAL PURCHASE PRICE OF THE PRODUCT,REGARDLESS OF THE FORM OF THE CLAIM.

(ii) EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, DESIGN ANALYSISSPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES, INCLUDING,WITHOUT LIMITATION, ALL IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A PARTICULAR PURPOSE.

(iii) UNDER NO CIRCUMSTANCES WILL DESIGN ANALYSIS BE LIABLE FORSPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT, OR ANY OTHERDAMAGES OR CLAIMS ARISING FROM THE USE OF THIS PRODUCT, THISINCLUDES LOSS OF PROFITS OR ANY OTHER COMMERCIAL DAMAGES,EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENTWILL DESIGN ANALYSIS BE LIABLE FOR ANY CLAIMS, LIABILITY, ORDAMAGES ARISING FROM MODIFICATION MADE THEREIN, OTHER THANBY DESIGN ANALYSIS.

(iv) THIS LIMITED WARRANTY GIVES USER SPECIFIC LEGAL RIGHTS. USERMAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE. SOME STATES DO NOT ALLOW LIMITATIONS ON HOW LONG AN IMPLIEDWARRANTY LASTS OR THE EXCLUSION OF INCIDENTAL ORCONSEQUENTIAL DAMAGES, SO THOSE LIMITATIONS OR EXCLUSIONSMAY NOT APPLY.

6. GOVERNING LAWThis Agreement and its validity and interpretation shall be governed by the laws of the State of Utah,notwithstanding any choice of law rules of Utah or any other state or jurisdiction.

Chapter 1H-335 Operation

H-335 H-335 Operation 1-1

Chouteau Lock and Dam, OklahomaCopan Lake, Oklahoma

1.1 OperationThe WATERLOG® H-335 is a precision, single axis, wide range inclinometer which measures the angle(position) of radial water control gates. The H-335 is easy to use, works with any data recorder/logger witha SDI-12 interface and can be interfaced with SCADA systems. The “Serial-Digital Interface” is ideal fordata logging applications with the following requirements:

� Multiple sensors on a 3-wire bus� Low system cost� Up to 200 feet of cable between a sensor and the data recorder

The H-335 has the following features:

� Easily attaches to I-beam of gate structure� Gravity referenced sensor allows installation anywhere on the gate structure� Scales the gate position into user units of feet, inches, meters, etc.� Built-in intelligence automatically calculates both gate height and arc length� No hysteresis or backlash� 0.03� accuracy over full position and temperature range� Sealed water-tight enclosure� No moving parts or bearings

1-2 Introduction H-335

1.2 Theory of OperationThe H-335 has a single axis tilt sensor, signal processing circuitry, 14-bit analog to digital converter and amicroprocessor. The sensor is a ceramic based electrolytic tilt sensor which provides high resolution andvery good linearity. The sensor is constructed as a hermetically sealed ceramic cavity with electrodespartially submerged in a conductive fluid. The ratio between submersed areas of the facing electrodes isproportional to the inclination angle. The electronics provide an AC sensor excitation together with aprecision, ratiometric peak-hold detector. Because scale factor of electrolytic sensors is sensitive totemperature, the H-335 has a built-in digital temperature sensor. The microprocessor uses a mathpolynomial to correct for temperature induced effects and any non-linear characteristics of sensor.

1.3 Problems with Winch Mechanism and Existing Measurement SystemsTainter gates are typically controlled with a motor operated winch mechanism. The gear box for the winchhas a “sundial” scale and pointer which shows the current gate opening. Often the mechanism also has aselsyn transmitter which allows the gate position to be monitored in a nearby control room. The sundial andselslyn driven scales are usually marked in units of “feet”. Unfortunately most winch mechanisms have noprovisions for monitoring the gate position with a data logger or SCADA (System Control and DataAcquisition) system. In the past, users have tried using incremental shaft encoders connected to the winchwith a sprocket and chain. This technique has the following shortcomings:

� The radius of the winch drum changes as the cable winds up, giving a non-linear readout.� The lift cables stretch as the gate is raised off the sill.� The backlash (hysteresis) in the drive chain between the winch drum and encoder can be large.� Each installation requires custom mechanisms, enclosures and setup.� The winch shaft is not accessible on some gearboxes.

The H-335 overcomes many of the problems associated with measuring the position of a tainter gate bydirectly monitoring the angle of the gate structure. Backlash and non-linear effects of the winch drum andcables are completely bypassed.

H-335 H-335 Operation 1-3

1.4 Gate GeometryMost users are interested in measuring the gate opening or “height”. Upon closer examination, however, thegeometry of a tainter gate is somewhat complex. The following definitions and illustration shows thegeometry of a typical tainter gate.

1.4.1 Terms and Definitions

Trunnion Bearing: The pivot point of the gate structure.

Sill Elevation: The elevation relative to a datum of the point where the gate seals against thebottom of the spillway.

Gate Radius: The distance between the center of the trunnion bearing and the outside of the gateskin plate.

Gate Angle: The angle, in degrees, through which the gate has opened (0� = closed).

Gate Arc Length: The distance the gate face moves through the partial curve of a circle.

Gate Height: The vertical distance between the bottom of the gate and a horizontal line passingthrough the sill.

Sill Angle: The angle, in degrees, between a horizontal line through the trunnion bearing andthe point at which the gate rests on the spillway.

The tilt sensor in the H-335 measures the angle of the gate structure referenced to gravity. The H-335 canbe installed anywhere on the gate structure since the entire structure rotates the same relative to gravity.The sensor does not need to be on the center of the gate’s rotating axis.

The H-335 measures and reports the UserAngle relative to the closed position (0� = closed). Forconvenience, the H-335 also internally calculates and reports GateHeight and GateArcLength. Normally,users program their data recorder to record only one of the three parameters. Each of these threemeasurement parameters has advantages and disadvantages:

1-4 Introduction H-335

Figure 1 Gate Geometry

UserAngle = (SensorAngle UserSlope) - UserOffset×

1.4.2 User AngleThe UserAngle is the angle, in degrees, thru which the gate has moved relative to the closed position. Allother calculations are based on this measurement. Some dams have a spillway which slopes rapidlydownward from the point where the gate contacts the sill. For these structures, the water flow calculation isa complex geometric problem because the actual weir opening (distance between the gate and the spillway)changes as the vertical point from the bottom of the gate first moves upward, then down the incline of thespillway. For complex gate geometries, program your data logger to record the UserAngle and do thenecessary calculations during post-processing of the data. The UserAngle parameter is calculated internallyin the H-335 using the following equation:

The UserSlope is a constant set to either +1.0 or -1.0 and must be programmed into the H-335 atinstallation (see Section 1.8). The UserOffset value is automatically calculated when the extended “aXZO”command is issued after the installation is completed.

H-335 H-335 Operation 1-5

GateArcLength =UserAngle GateRadius

180× ×π

( ) ( )[ ]GateHeight = GateRadius sin SillAngle sin SillAngle - UserAngle−

1.4.3 Arc LengthThe ArcLength is distance the gate face moves through the partial curve of a circle. Normally this value isnot recorded by the data logger. The H-335 calculates and reports this value for field test and verificationpurposes and is calculated internally in the H-335 using the following equation:

If water is flowing through the gate, the GateHeight cannot be directly measured with a measuring tapebecause the water flow sweeps the tape away. However, if the tape is attached to the face of the gate, and istangent to the gate, the Arc Length can be directly measured in the field.

1.4.4 Gate HeightThe GateHeight is the vertical distance between the bottom of the gate and a horizontal line passing thruthe sill. Normally this value is recorded and used in a weir calculation to determine water flow. TheGateHeight parameter is calculated internally in the H-335 using the following equation:

The GateRadius and SillAngle are constants and must be programmed into the H-335 during installation.

1.5 Programming the Data RecorderYou must prepare your data recorder to receive and record the H-335 data. Since data recorders differwidely, refer to your recorder manufacturer's directions. In general, program the data recorder to input fourvalues via the SDI-12 port. Usually only one or two of the parameters is actually recorded. Your datarecorder must issue an “aM!” command, then collect the data with a “aD0 ” command, as explained inChapter 2. The H-335 places four data values in its data buffer:

a+AA.AA+BB.BB+CC.CC+DD.DD<CR><LF>

Where:+AA.AA = GateArcLength (inches, meters etc.)+BB.BB = GateHeight (inches, meters etc.)+CC.CC = UserAngle (Degrees of angle)+DD.DD = SensorTemperature (�C)

1-6 Introduction H-335

1.6 InstallationSince the H-335 is a gravity referenced tilt sensor, it can be installed anywhere on the gate structure. TheH-335 must be installed exactly vertical and in the plane the tainter gate rotates. If the H-335 is not verticalthe senor will suffer an off-axis trigonemetric error as the gate is raised. The mount clamp has a 2-axisgimbal which allows the inclinometer to be adjusted to compensate for camber in the gate structure.

The best place to install the sensor is near the trunnion bearing between the I-beam of the gate arm and theconcrete pier. Either the left or right arm will work. This location is protected from direct sunlight, logs anddebris, and allows for a short cable. The beam clamps allow easy installation with no drilling and will workfor beams up to 2.0 inches thick. Make certain the cable has sufficient slack for the entire rotation of thegate.

The UserAngleSlope coefficient in the H-335 must be programmed appropriately depending on whether theH-335 is installed on the left or right arms of a gate and whether on the inside or outside of the I-beam (seeFigure 2).

1.7 Making Connections to the H-335Since the H-335 is normally exposed to the sun and weather, a cable rated for water immersion andsunlight resistance is required. A black urethane or similar sunlight/waterproof rated cable is recommended.

Make certain the power is OFF before making any connections. To access the wiring terminal block, openthe cover of the H-335 by removing the four cover screws. Whenever tightening or loosening the coverscrews, turn each screw only a turn or two at a time. Try to equalize the stress on the lid. This is especiallyimportant when the O-ring in the lid is near full compression.

Make certain the cable properly seals in the grommet of the liquid-tight cable fitting and that the O-ring inthe fitting is tight against the box. The connection must be water tight. Other grommet diameters andfittings are available from the factory.

The H-335 has a removable 4-pin wiring terminal block for connecting the SDI-12 cable. Unplug theterminal block and make the connections to the cable. The connections are labeled on the circuit board.Check to make certain the connections are correct, then plug the terminal block into the H-335 circuit

H-335 H-335 Operation 1-7

SillAngle = ArcSinTrunnionElevation -SillElevation

GateRadius���

���

ArcSin391'-363'

36'���

��� = 51057.

board. This eliminates stressing the connector and circuit board while tightening the terminal block screws.Make certain the wires do not touch any of the internal components, especially if your cable has a baredrain wire.

1.8 Programming the H-335The H-335 has several fixed constants which must be programmed before installation. We recommenddoing this in the lab, before installing the H-335 on the tainter gate.

Step 1: Program the sensor with the proper SDI-12 address, make certain each sensor has a uniquesensor address. See Chapter 2 for details of the “aAn” change address command.

The H-335 comes from the factory with the following settings:Sensor Address: 0UserAngleSlope: +1.0UserAngleOffset: 0.0GateRadius: 36.0SillAngle: 51.057

With these values the GateHeight and GateArcLength parameters will be in units of feet for a gate with aradius of 36.0 feet. The setup is stored in EEPROM within the H-335 and will not be lost if the power isdisconnected. The extended commands for changing these settings is described in detail in Chapter 2.

Use the extended SDI-12 commands “aXWCn” and “AaXRCn” to write and read respectively thefollowing settings:

Step 2 (coefficient 1): Set the UserAngleSlope as needed for your installation. Set the slope to +1.0for a gate which opens clockwise while facing the H-335 cover. Set the slope to-1.0 for a gate which opens counter-clockwise while facing the sensor cover(see Figure 2).

Step2 (coefficient 2): Make certain the UserAngleOffset value is set to 0.0.

Step3 (coefficient 3): Set the GateRadius as needed for your tainter gate. This is the distance betweenthe center of the trunnion bearing and the outside face of the skin plate. This value also determines the unitsfor the GateArcLength and GateHeight data output values. If this value is in units of feet, the data outputwill be in units of feet etc.

Step4 (coefficient 4): Set the SillAngle as needed for your tainter gate. Use a calculator and thefollowing formula to compute the proper value:

For Example:

1-8 Introduction H-335

1.9 Installing the H-335 and setting the mechanical sensor offsetThe tilt sensor in the H-335 has a physical ±40� calibrated range. This allows sufficient dynamic range tomeasure a gate which opens up to 80�. To work properly, the sensor must be mechanically adjusted duringinstallation to preserve the available physical dynamic range. This is done by loosening two screws androtating the internal sensor assembly. The mechanical offset adjustments are made while monitoring theSensorAngle parameter. This is the raw sensor reading with no adjustment for slope or offset. TheUserAngle parameter is processed with a slope and offset term to produce the more useful 0.0� to +80.0�reading for the data recorder.

With the gate closed the mechanical offset must be set near (but not beyond) one end of the sensor’smeasurement range. The proper setting depends on which gate arm the H-335 is installed and which side ofthe I-beam the H-335 is mounted (see Figure 2). For example; with a gate which can open up to 70� andwhich the inclinometer rotates clockwise (while facing the H-335 cover) as the gate opens, the sensorshould be rotated until SensorAngle reads ~ -35�. When this gate is fully open the raw SensorAngle willread +35�. With the same gate but with the inclinometer installed such that it rotates counter-clockwise(while facing the H-335 cover) as the gate opens, the sensor must be mechanically adjusted to +35�. Whenthis gate is fully open the raw SensorAngle will read -35�.

The H-335 fiberglass enclosure can be installed in anyposition in the plane of rotation. If possible, locate theconnector on the bottom to prevent water from standingon the connector. The internal ceramic sensor elementis symmetrical and will still make measurements ifinstalled upside down. However, if the sensor is upsidedown, the calibration will be invalid, the slope will bewrong and the output data confusing. Check to makecertain the wires exit the red plastic cover at the 2:00o’clock position when the gate is in the center of itstravel arc.

H-335 H-335 Operation 1-9

Figure 2 Installation Configurations

In practice the following steps must be done with two people. One working on the gate pier and the other onthe dam catwalk with a data logger or laptop computer connected to the SDI-12 bus. A hand held radiomakes it easier to communicate be between the two workers. During the installation procedure theSensorAngle must be monitored in real time. Ignore the UserAngle value at this time. The offset adjustmentcan be done in two ways:

1-10 Introduction H-335

1.9.1 Method IIssue repeated SDI-12 “aM1” and “aD0” commands.

For the “aM1” command, the H-335 places 6 parameters in its data buffer where:

a = Sensor Address (0-9,A-Z)+AA.AA = UserAngle (degrees of angle)+BB.BBB = SensorAngle (degrees of angle)+CCCC = Raw A/D Positive Count (±8192)+DDDD = Raw A/D Negative Count (±8192)+EEEE = Raw A/D Positive Count (±16384)+FF.FF = SensorTemperature (�C)

1.9.2 Method IIUse the “aXTEST” command (see Chapter 2).

This command is primarily used for production testing and requires the use of a H-419 Sidekick interfaceand a PC. This command causes the H-335 to transmit unsolicited real-time data for testing purposes. Thisis not compliant with the SDI-12 specification and is not used with data loggers.

XTEST continually prints the following parameters in a single line:

Sensor Address (0-9, A-Z)SensorAngle (�Angle)

For example:

1 +1.2001 +1.2001 +1.5001 +1.7001 +1.900etc.

Step 5: Remove the cover from the H-335 and make the wiring connections. Leave the cover off, donot bolt the assembly to the I-beam at this time.

Step 6: Connect the +12V power. Issue an “aI” identifiy command to make certain the sensor isconnected and working.

Step 7: Make certain the tainter gate is fully closed and resting on the sill.

H-335 H-335 Operation 1-11

Step 8: Slightly loosen the two #4-40 allen socket head screws which retain the ceramic sensorassembly. Some dams have the tainter gate I-beam located above the platform on the concretepier. If you can access the sensor after installation, follow steps 9a-11a. If you cannot accessthe sensor when it is bolted to the I-beam, follow steps 9b-11b.

For Installations where the sensor is accessible

Step 9a: Tightly bolt the H-335 to the I-beam with the beam clamps.

Step 10a: Use the data logger or laptop computer to monitor the SensorAngle. Carefully rotate theinternal sensor assembly for the desired value. Make certain the internal ceramic sensor is notupside down. Sensors mounted such that the inclinometer rotates clockwise as the gate opensmust be set to -34�to -38�. Sensors mounted such that the inclinometer rotates counter-clockwise as the gate opens must be set to +34�to +38�. The adjustment is quite sensitive andrequires a bit of patience. When the desired setting is reached, tighten the two allen screws.

Step 11a: Re-install the cover and proceed to Step 12. Whenever tightening or loosening the coverscrews, turn each screw only a turn or two at a time. Try to equalize the stress on the lid. Thisis especially important when the O-ring in the lid is near full compression.

For Installations where the sensor is NOT accessible

Step 9b: Temporarily rest the H-335 flush against the top of the I-Beam while holding it exactlyvertical.

Step 10b: Use the data logger or laptop computer to monitor the SensorAngle. Carefully rotate theinternal sensor assembly for the desired value. Make certain the internal ceramic sensor is notupside down. Sensors mounted such that the inclinometer rotates clockwise as the gate opensmust be set to -34�to -38. Sensors mounted such that the inclinometer rotates counter-clockwise as the gate opens must be set to +34�to +38�. The adjustment is quite sensitive andrequires a bit of patience. When the desired setting is reached, tighten the two allen screws.The angle setting can be approximate because it is more accurately fine tuned in the next step.

Step 11b: Re-install the cover. Whenever tightening or loosening the cover screws, turn each screw onlya turn or two at a time. Try to equalize the stress on the lid. This is especially important whenthe O-ring in the lid is near full compression. Loosely bolt the H-335 to the I-beam with thebeam clamps. While monitoring the SensorAngle fine tune the angle by tapping or prying thealuminum mounting plate with a screw driver. When the desired angle is obtained, tighten thebeam clamp bolts.

1-12 Introduction H-335

Test the Installation

Step 12: Check to make certain the sensor is still at the desired SensorAngle. Make certain the gate isfully closed and resting on the sill. Wait at least 15 minutes or so for the sensor temperatureto stabilize before proceeding to the next step.

Step 13: Issue the extended “aXZO” Zero Offset command. The H-335 will make a fresh anglemeasurement and use this value to automatically update the UserAngleOffset value toproduce a UserAngle reading = 0.0 .

Step 14: Make a “aM” measurement. The GateArcLength, GateHeight and UserAngle parametersshould all be zero. Raise the gate and check for proper (increasing) readings.

The SDI-12 “aM” command makes the following measurements:

a +AA.AA+BB.BB+CC.CC+DD.DD<CR><LF>

Where:a = Sensor Address (0-9, A-Z)+AA.AA = GateArcLength (inches, meters etc.)+BB.BB = GateHeight (inches, meters etc.)+CC.CC = UserAngle (degrees of angle)+DD.DD = SensorTemperature (�C)

This completes installation and testing of the H-335.

Chapter 2SDI-12 Command and Response Protocol

H-335 SDI-12 Command and Response Protocol 2-1

2.1 SDI-12 Command and Response ProtocolThis is a brief description of the Serial Digital Interface (SDI-12) Command and Response protocol used bythe WATERLOG® Series Model H-335 sensor. Included is a description of the commands and data formatsupported by the H-335.

Refer to the document "A SERIAL DIGITAL INTERFACE STANDARD FOR HYDROLOGIC ANDENVIRONMENTAL SENSORS". Version 1.2 April 12, 1996 Coordinated by the SDI-12 Support Group,135 East Center, Logan, Utah.

During normal communication, the data recorder sends an address together with a command to the H-335 SDI-12 sensor. The H-335 then replies with a "response". In the following descriptions, SDI-12 commands andresponses are enclosed in quotes. The SDI-12 address and the command/response terminators are defined asfollows:

"a" Is the sensor address. The following ASCII Characters are valid addresses: "0-9", "A-Z", "a-z", "*", "?". Sensors will be initially programmed at the factory with theaddress of "0" for use in single sensor systems. Addresses "1 to 9" and "A to Z" or"a to z" can be used for additional sensors connected to the same SDI-12 bus.Address "*" and "?" are "wild card" addresses which select any sensor, regardless ofits actual address.

"!" Is the last character of a command block.

"<cr><lf>" Are carriage return (0D) hex and line feed (0A) hex characters. They are the last twocharacters of a response block.

Notes:

� All commands/responses are upper-case printable ASCII characters.� Commands must be terminated with a "!" character.� Responses are terminated with <cr><lf> characters.� The command string must be transmitted in a contiguous block with no gaps of more than 1.66

milliseconds between characters.

2-2 SDI-12 Command and Response Protocol H-335

Example of a H-335 "aM!" command:

Command Response Time Values Description"aM!" "a0034<cr><lf>" 3 sec 4 Make current measurement

Subsequent Command Response"aD0" a+AA.AA+BB.BB+CC.CC+DD.DD<cr><lf> Where:AA.AA = Gate Arc LengthBB.BB = Gate HeightCC.CC = User Angle (Degrees)DD.DD = Sensor Temperature (C)

2.2 Measure CommandThe Measure Command causes a measurement sequence to be performed. The H-335 supports three differentmeasure commands (“aM”, “aM1" and “aM2"). Data values generated in response to this command are storedin the sensor's buffer for subsequent collection using "D" commands. The data will be retained in the sensoruntil another "M", “C” or "V" command is executed.

Command Response Description------------------ ---------------------- ------------------------------------"aM!" "atttn<cr><lf>" Initiate measurement

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

M is an upper-case ASCII character

ttt is a three digit integer (000-999) specifying the maximum time, in seconds,the sensor will take to complete the command and have measurement dataavailable in its buffer.

n is a single digit integer (0-9) specifying the number of values thatwill be placed in the data buffer. If "n" is zero (0), no data will beavailable using subsequent "D" commands.

Upon completion of the measurement, a service request "a<cr><lf>" is sent to the data recorder indicating thesensor data is ready. The data recorder may wake the sensor with a break and collect the data anytime afterthe service request is received or the specified processing time has elapsed.

H-335 SDI-12 Command and Response Protocol 2-3

Example of a H-335 "aM1!" command:

Command Response Time Values Description"aM1!" "a0036<cr><lf>" 3 sec 6 Make measurement

Subsequent Command Response"aD0" a+AA.AA+BB.BBB+CCCC+DDDD+EEEE+FF.FF<cr><lf> Where:+AA.AA = User Angle+BB.BBB = Sensor Angle+CCCC = Raw A/D Positive Count (±8192)+DDDD = Raw A/D Negative Count (±8192)+EEEE = Raw A/D Count (±16384)+FF.FF = Sensor Temperature (C)

Example of a H-335 "aM2!" command:

Command Response Time Values Description"aM2!" "a0031<cr><lf>" 3 sec 1 Make measurement

Subsequent Command Response"aD0" a+AA.AA<cr><lf> Where:+AA.AA = Gate Height

“aM1" Command

“aM2" Command

2-4 SDI-12 Command and Response Protocol H-335

2.3 Concurrent Measure CommandThis is a new command for the Version 1.2 SDI-12 Specification. A concurrent measurement is one whichoccurs while other SDI-12 sensors on the bus are also taking measurements. This command is similar to the“aM!” command, however, the nn field has an extra digit and the sensor does not issue a service request whenit has completed the measurement. Communicating with other sensors will NOT abort a concurrentmeasurement. Data values generated in response to this command are stored in the sensor's buffer forsubsequent collection using "D" commands. The data will be retained in the sensor until another "M", “C” or"V" command is executed.

Command Response Description"aC!" "atttnn<cr><lf>" Initiate measurementWhere:

a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").C is an upper-case ASCII characterttt is a three digit integer (000-999) specifying the maximum time, in seconds,

the sensor will take to complete the command and have measurement data available in its buffer.

nn is a two digit integer (00-99) specifying the number of values that willbe placed in the data buffer. If "n" is zero (0), no data will be availableusing subsequent "D" commands.

The data recorder may wake the sensor with a break and collect the data anytime after the specified processingtime has elapsed.

H-335 SDI-12 Command and Response Protocol 2-5

Example of a H-335 "aD0!" command:

Previous command Response"aM!" "a0034<cr><lf>"

Subsequent Command Response"aD0" a+AA.AA+BB.BB+CC.CC+DD.DD<cr><lf> Where:AA.AA = Gate Arc LengthBB.BB = Gate HeightCC.CC = User Angle (Degrees)DD.DD = Sensor Temperature (C)

2.4 Send Data CommandThe Send Data command returns sensor data generated as the result of previous "aM!", aM1!", aM2!", “aC!”or "aV!" commands. Values returned will be sent in 33 characters or less. The sensor's data buffer will notbe altered by this command.

Command Response"aD0!" through "aD9!" "apd.d ... pd.d<cr><lf>"

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

D0..D9 are upper-case ASCII characters.

p Is a polarity sign (+ or -)

d.d represents numeric digits before and/or after the decimal. A decimal may be used inany position in the value after the polarity sign. If a decimal is not used, it will beassumed to be after the last digit.

For example: +3.29 +23.5 -25.45 +300

If one or more values were specified and a "aD0!" returns no data (a<CR><LF> only), it means that themeasurement was aborted and a new "M" command must be sent.

2-6 SDI-12 Command and Response Protocol H-335

Example of a H-335 "aV!" command: Command Response Time Values Description"aV!" "a0013<cr><lf>" 1 sec 3 Return fixed data and diagnostic

data for testing purposes.Subsequent Command Response"aD0" a+123.456+78.9+y<cr><lf>

Key Description Units +123.456 Fixed test data +78.9 Fixed test data y ROM checksum test 0 = Failed, 1 = Passed

2.5 Continuous MeasurementsThis is a new command for the Version 1.2 SDI-12 Specification. Sensors that are able to continuously monitorthe phenomena to be measured, such as a cable position, do not require a start measurement command. Theycan be read directly with the R commands (R0!...R9!). The R commands work exactly like the D (D0!...D9!)commands. The only difference is that the R commands do not need to be preceded with an M command. TheH-335 DOES NOT supports the aR0! continuous measurement commands.

2.6 Initiate Verify CommandThe Verify Command causes a verify sequence to be performed. The result of this command is similar to the"aM!" command except that the values generated are fixed test data and the results of diagnostic checksumtests. The data generated in response to this command is placed in the sensor's buffer for subsequent collectionusing "D" commands. The data will be retained in the sensor until another “M”, “C” or “V” command isexecuted.

Command Response Description"aV!" "atttn<cr><lf>" Initiate verify sequence

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

V is an upper-case ASCII character.

ttt is a three digit integer (000-999) specifying the maximum time, in seconds, thesensor will take to complete the command and have data available in its buffer.

n is a single digit integer (0-9) specifying the number of values that will be placedin the data buffer. If "n" is zero (0), no data will be available usingsubsequent "D" commands.

H-335 SDI-12 Command and Response Protocol 2-7

2.7 Send Acknowledge CommandThe Send Acknowledge Command returns a simple status response which includes the address of the sensor.Any measurement data in the sensor's buffer is not disturbed.

Command Response"a!" "a<cr><lf>"

Where:a Is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

2-8 SDI-12 Command and Response Protocol H-335

Example of a H-335 "aI!" command:

"a12 DAA H-335vvvS#nnnnnnVkkk<cr><lf>"

H-335 implementation of the optional 13 character field:S#nnnnnnVkkk (12 bytes total)

Where: "nnnnnn" is a six character sensor serial number"kkk" is a three digit sensor firmware revision level

2.8 Send Identification CommandThe Send Identification command responds with sensor vendor, model, and version data. Any measurementdata in the sensor's buffer is not disturbed.

Command Response"aI!" "allccccccccmmmmmmvvvxx...xx<cr><lf>"

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

I is an upper-case ASCII character.

ll is the SDI-12 version compatibility level, e.g. version 1.2 is represented as "12".

cccccccc is an 8 character vendor identification to be specified by the vendor and usually in theform of a company name or its abbreviation.

mmmmmm is a 6 character field specifying the sensor model number.

vvv is a 3 character field specifying the sensor version number.

xx...xx is an optional field of up to a maximum of 13 characters to be used for serial numberor other specific sensor information not relevant to operation of the data recorder.

H-335 SDI-12 Command and Response Protocol 2-9

Example of a "Change Sensor Address" command:

Command Response Description"aA2!" "2<cr><lf>" Change sensor address to "2"

2.9 Change Sensor AddressThe Change Sensor Address Command allows the sensor address to be changed. The address is stored innon-volatile EEPROM within the sensor. The H-335 will not respond if the command was invalid, the addresswas out of range, or the EEPROM programming operation failed.

Command Response Description"aAn!" "n<cr><lf>" Change sensor address

Where:a is the current (old) sensor address ("0-9", "A-Z", "a-z", "*", "?"). An ASCII "*"

may be used as a "wild card" address if the current address is unknown and only onesensor is connected to the bus.

A is an upper-case ASCII character.

n is the new sensor address to be programmed ("0-9", "A-Z", "a-z", "*", "?").

NOTE: To verify the new address use the "Identify Command."

2-10 SDI-12 Command and Response Protocol H-335

Example of a H-335 Extended "Read Coefficient" command:

Command Response Time Values Description"aXRC3!" "a0011<cr><lf>" 1 sec 1 Read Coefficient 3

(gate radius)Subsequent Command Response"aD0" a+36.000<cr><lf>

2.10 Extended “Read Coefficient” CommandThe H-335 processes the sensor measurement data with a set of coefficients. Each coefficient isprogrammable, allowing the H-335 to be used on gates with different geometries, and to scale theheight and distance output values to user desired engineering units. This command allows the userto read any of the coefficients. At the factory the coefficients are set to the following values.

Coefficient Default Value DescriptionC1 +1.0 User angle slope (compensates for clockwise or counter-

clockwise mounting )C2 0.0 User angle offset (provides zero output with gate against sill)C3 36.0 (Feet) Gate Radius (determines user units; inches, feet etc.)C4 51.05756 Degrees Sill Angle (angle of the gate sill with respect to trunnion

bearing)

Command Response Description"aXRCn!" "a0011<cr><lf>" Read Coefficient

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

XRC are upper case characters

n is coefficient number 1 to 4.

This command takes 001 seconds to complete and places 1 value in the data buffer. Use the “aD0"command to collect and view the data.

H-335 SDI-12 Command and Response Protocol 2-11

Example of a H335 extended "Write Coefficient" command:

Command Response Tim e Values Description"aXWC1-1!" "a0011<cr><lf>" 1 sec 1 Set Coefficient 1 to -1 indicating

the inclinometer rotatescounter-clockwise as the gate

opens.Subsequent Command Response"aD0" a-1<cr><lf>

2.11 Extended “Write Coefficient” CommandThe H-335 processes the sensor measurement data with a set of coefficients. Each coefficient isprogrammable, allowing the H-335 to be used on gates with different geometries, and to scale theheight and distance output values to user desired engineering units. This command allows the userto write (change) any of the coefficient values. The new value is stored in non-volatile EEPROMwithin the sensor. Once the new value is written to the EEPROM, a copy is sent to the sensor databuffer for verification. This data can be viewed by using a subsequent "D" command. To verify anycoefficient any other time, use the "Read Coefficient" command.

Command Response Description"aXWCnddd!" "a0011<cr><lf>" Write Coefficient n

Where:a is the sensor address ("0-9", "A-Z", "a-z", "*", "?").

XWC are upper case characters.

n is the coefficient number to program, 1 to 4

ddd is the new coefficient value. The input format is very flexible. Some examples are shown below.

20.0 0.195-5005.93E-4

This command takes 001 seconds to complete and places 1 value in the data buffer. Use the “aD0"command to collect and view the data.

2-12 SDI-12 Command and Response Protocol H-335

2.12 Extended “XTEST” and “XRAW” CommandsThese commands are used for installation or production testing and requires the use of a H-419Sidekick interface and a PC. These commands causes the H-335 to transmit unsolicited real-timedata for testing purposes. This is not compliant with the SDI-12 specification and is not used withdata loggers.

To activate the test mode, first send the command “aXTEST!” or “aXRAW” from the PC. The H-335 will automatically display a new line of data about once per second. This test mode may be usedto help troubleshoot the installation by providing a continuous readout of sensor data. The test modeis exited by sending any new command on the SDI-12 bus (a BREAK terminates the test). It maytake a few tries to exit if the command is sent at the same time data is being sent from the H-335.Removing power from the H-335 also causes it to exit this mode.

“aXTEST” displays the following data:a (sensor address)SensorAngle (degrees)

Example of the XTEST test display:

a +1.200a +1.500a +1.700a +1.900etc.

“aXRAW” displays the following data:a (sensor address)Gate Arc Length (feet, meters etc.)Gate Height (feet, meters etc.)User Angle (degrees)Sensor Angle (degrees)Raw Positive A/D count (±8192)Raw Negative A/D count (±8192)Raw Positive - Negative A/D count (±16384)Sensor Temperature. (�C)

Example of the “XRAW” test display:

a +1.200 +.1.103 +4.565 -32.231 -2639 +5836 +8475 +23.52a +1.500 +.1.213 +5.183 -31.613 -2234 +5835 +8069 +23.51a +1.700 +.1.451 +5.397 -31.399 -2656 +5848 +8504 +23.54a +1.900 +.1.602 +5.565 -31.231 -2678 +5786 +8464 +24.03

H-335 SDI-12 Command and Response Protocol 2-13

Example of a H-335 Extended "Zero Offset" command:

Command Response Time Values Description"aXZO!" "a0031<cr><lf>" 3 sec 1 Zero the UserAngle

Subsequent Command Response"aD0" a+12.000<cr><lf> The new UserAngleOffset

2.13 Extended “XZO” CommandThis command is used to automatically zero the gate angle offset. The “aXZO” command causes the H-335 to make a fresh angle measurement and use this value to automatically update theUserAngleOffset value to produce a UserAngle reading = 0.00

Make certain the gate is fully closed and resting on the sill. Wait at least 15 minutes or so afterapplying +12V power for the sensor temperature to stabilize before issuing the “aXZO” command.This command should be used only during installation or maintenance.

Appendix ASpecifications

H-335 Appendix A Specifications A-1

GeneralSensor: ceramic, single axis, linear, wide angleType: electrolytic fluidRange: -40� to +40� (80� total)Resolution: 0.005� Accuracy: +-0.03� (absolute over full range)

(0.25 inch gate height with 36' gate radius)(0.13 inch gate height with 20' gate radius)

Offset Adjust: software command with gate against sillTemperature: -30� to +50 �C (calibrated range)Settling Time: <300msSDI-12 Measurement Time: 2 Sec

SDI-12 OutputBaud Rate: 1200Protocol: SDI-12, 7-bit even parity, 1 stop bit

Output Voltage Levels: minimum high level: 3.5 volts maximum low level: 0.8 volts maximum cable length: 250 ft.

SDI-12 Output Data Parameters: 1 - Gate Arc Length (feet, inches, meters, etc.) 2 - Gate Height (feet, inches, meters etc.) 3 - Gate Angle (degrees) 4 - Temperature (�C )

Power RequirementsVoltage Input: 10.0 to 16.0 Volts DCCurrent

Measuring: 30 mA Standby 20 mA typical

EnvironmentalOperating Temperature: -30� to +60� CStorage Temperature: -50� to +70� C

MechanicalMaterial: 40% graphite filled fiberglassSize: 4.76" x 4.76" x 2.5" highRating: NEMA 4X, 6Connector: liquid tight strain relief fitting

.08" to .24" dia cableBeam Clamp: 2-Inch max I-beam thickness.

Mount fixture is adjustable in3-axis to compensate for camberin the gate structure.

Cable: not includedRecommended Cable:

polyurethane or similar, rated forwater immersion and sunlightresistance.

WarrantyThe WATERLOG® H-335 is warranted against defectsin materials and workmanship for one year from dateof shipment.

H-335 Appendix A Specifications A-2