Model H-5223 Owner’s Manual
Model H-5223 Data Collection Platform Owner’s Manual Rev: 1.00 NOTICE This product embodies technology that is confidential and proprietary technology of DESIGN ANALYSIS ASSOCIATES, INC., and which is protected by United States copyright laws and international copyright treaty provisions, and/or by contract and applicable laws of trade secrecy. These include all Software, Printed Circuit Board Artwork, Schematic Diagrams, and Technologies applied therein.
H-5223 Features ! Programming and data retrieval is through the serial port to a PC or a PDA using off the shelf software. No special software required for normal operation. ! Same type of serial user interface as the XL series data logger allows current XL users a quick learning curve. ! Compact menus built around PDA systems. ! Four general purpose analog input channels. Very high resolution with differential measurements on channels 1 and 2. ! A precision 5.
User Agreement/ WATERLOG® Warranty 1. NATURE OF THE PRODUCT This agreement accompanies a pressure measuring system comprising firmware, circuitry and other electronic equipment in an enclosed housing, and packaged together with written instructional materials. The packaged electronic circuitry and instructional materials herein are collectively referred to as the “PRODUCT.” The PRODUCT is made available from DESIGN ANALYSIS ASSOCIATES, INC.
If the product fails to satisfy the above warranty, USER must notify DESIGN ANALYSIS in writing within the applicable period specified above and reasonably cooperate with the directions they received from DESIGN ANALYSIS. (c) What DESIGN ANALYSIS Will Do DESIGN ANALYSIS will repair the PRODUCT or will endeavor to provide a replacement of same within a reasonable period of time.
Table of Contents User Agreement/WATERLOG® Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . W-1 Chapter 1 Introduction 1.1 1.2 1.3 1.4 1.5 Introduction to the H-5223 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unpacking the H-5223 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About the Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5.3 Generic SDI-12 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 3.6 Data Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14 3.7 Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16 3.7.1 L - Logging Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1 Introduction 1.1 Introduction to the H-5223 The H-5223 is an entry level Data Collection Platform (DCP) system for applications requiring low cost and with limited parameters to be measured. The H-5223 DCP incorporates a high data rate GOES transmitter with built in GPS, the most common sensor input options, and a basic data logger. The ease of use and similarities to the XL Series DCP’s and data loggers make the H5223 very attractive to current and future XL users.
1.3 About the Manual This manual will show you how to properly install and operate your H-5223. The installation procedures and operational functions are very simple and easy to use. Please take time to read through the manual, it will help answer most questions you have concerning the H-5223 and it’s capabilities. The web page at http://www.waterlog.com will have manual updates and advanced sections of the manual in PDF format, allowing customers to print extra copies or newer versions of the manual. 1.
Chapter 2 Hardware Options and Installation 2.1 Hardware Overview This chapter describes the basic procedure for installing the H-5223 including wiring for power, sensors and communications. For proper installation you will need: ! ! ! ! ! ! The H-5223 mounting hardware Small flat blade screw driver Power and communication cables Sensors as needed. The H-5223 owner’s manual Sensor owners manuals. 2.2 Front Panel Connections Figure 2-1 illustrates the physical location for the I/O of the H-5223.
2.2.2 Com Port RS-232 This is the main RS-232 port for communicating to the H-5223. The RS-232 port is used to connect to a PC, PDA, modem, or other type of serial equipment for standard serial communications. This port is configured as a DCE type of device. This means it will plug directly into a PC (a DTE type device), but will require a NULL modem adaptor for connecting to most PDA’s or a modem (a DCE type device).
2.2.3.1 Analog Input Channels There are four analog input channels labeled Vin1 to Vin4. The input range is 0 to 5 volts DC and the maximum input should not exceed 5.0 volts. Each input can be programmed with a slope and an offset allowing the final value recorded for the input to be scaled to some units of measure like temperature or wind direction. Programming the slope and offset will be discussed in detail in chapter 3. 2.2.3.1.
2.2.3.3 Switched +5.00 Volt Reference Excitation The +5 Volt reference output is used for analog sensors requiring a precision reference voltage. The output current source maximum level is 10 milliamps. Exceeding this limit will cause the excitation to possibly sag, and result in possible data errors. The Analog to Digital converter uses this excitation for its reference to provide a ratio-metric relationship for sensors using the excitation.
2.2.4 Digital I/O 1 and 2 Pins 9 and 10 of the terminal block provide connection points for the two digital I/O signals. Notice pin 8 is a digital ground and is grouped with these two pins. When using the digital I/O’s this ground pin should be used as the reference point. Do not use the analog grounds. The two digital I/O signals can be configured independently as inputs or as outputs. In the input mode, the signal has an internal pull up resistor of 51K Ohms.
2.2.5 SDI-12 Section Pins 11, 12, and 13 of the terminal block provide connection points for SDI-12 senors. The +12Vsw power connection under the SDI-12 section is limited to about one amp so it may be necessary to connect the SDI-12 sensor power line directly to the battery or to main power. This excitation can be set to stay on continuously or to be switched on only at scan time.
2.3 Top Panel Description On the top of the H-5223 are antenna connectors, power connectors, host and auxiliary connectors, GOES fail safe button, and LED indicators 2.3.1 GOES Antenna This is the GOES RF antenna connector and is a male SMA type of connector. Most GOES RF antenna cables have an N type of connector so an adaptor will be needed to go from the one connector type to the other. 2.3.2 +12VDC / Ground This is the primary power connection to supply power to the transmitter. 2.3.
NOTE: When power is first applied to the unit it will try to sync the GOES time clock causing the current draw to be around 35 mA. Once the time sync is complete the current will return to the normal low power state. If the antenna is not installed the system may continually draw higher current. 2.3.5 Host and Aux Port (RS-232) The host port is used to connect the transmitter to an external data logger. The Aux port is used to debug and monitor the status of the transmitter. 2.
Chapter 3 Menu Mode Operation 3.1 Menu Mode Interface All communications with the H-5223 are through a command interface or menu interface using the main RS-232 Serial Port. The menu interface is the default mode of operation. If in the command interface, entering the command “MENU” will cause the system to enter the menu mode. The menu mode is used to display a menu on the screen allowing simple human access to the system options.
pressed that allows a system parameter to be changed, any additional information for that option will be displayed after the prompt. There are two types of system parameter change options, first is an option that requires direct keyboard input like a ‘Site Id’ or a column header label. The second is an option that has a pick list of valid options such as an input source option. This type of option allows the user to scroll through the valid options using UP and DOWN arrow keys.
Displays system status information. V - View status: I - Sensor Input Setup: Used to configure the sensor input parameters. D - Data Options: Allows the user to retrieve data from the unit, and check other data file statistics. O - Output Options: Defines how the data is stored, transmitted or displayed. S - Scan Setup: Defines when and how often the unit scans the sensors. C - Configure System: Sets basic system options such as time and date.
Date: This is a status screen that shows the current date. There is no option here to change the date. To change the date use the ‘Configure System’ menu. Scanning: This is a status screen that shows if scanning is on or off. To turn scanning on or off use the ‘Scan Setup’ menu. Next Scan: This is a count down timer until the next scan. GOES Mode: This identifies the current GOES Mode of operation. If the GOES radio is not functioning a N/A will be displayed.
system resets to zero. On the next visit to the site, review the condition of the battery since the last visit by looking at the max and min values and the number of system resets. Ideally, the number of resets would still be zero and the max and min battery values would be within a normal operating range. A low minimum battery voltage could indicate a weak charging system, a battery that is too small for the site, or bad wiring, etc. A low battery could also cause the system to reset.
input and encoder input) the value can be set to an initial starting point. Below is an explanation of how this option works for each possible mode for the I/O pins. Digital Input: This option is used as a status indicator showing the current state of the digital I/O 1 pin. The value will always be a 1 or a 0. A 1 indicates the pin is high or at approximately 5 volts, and a 0 indicates that it is low or at approximately 0 volts.
General purpose input returns a 1 or a 0. Typical application is a gate position, open or closed. This is the default mode. Counter Input: The pin is used as a counter input. A falling edge (5 volts to 0 volts) causes a counter to increment by the count / encoder inc value. Typical application is a tipping bucket rain gauge. Encoder Input: If both inputs are set to this mode then a standard quadrature shaft encoder may be used for stage readings.
is set for pulsed output mode and the trigger condition is true, then the output will be set high for a duration based on this option. The range is from 1 to 9999 milliseconds. On At Scan: At the beginning of each scan the system checks the mode of the digital I/O and if it is set for ‘On At Scan’ then the digital I/O is set high and the system delays before processing the scan for a duration based on this option. After the scan process is complete the digital I/O will be turned off.
or for on at scan, pressing the 1 key will cause the output to toggle between high and low. If the pin is configured as an input of any type the message ‘NA’ will be displayed. N - Next This option is used to move to digital I/O number 2. NOTE: Digital I/O 2 is configured the same as digital I/O 1 so no further discussion is given for the second digital I/O pin.
3.5.2 A - Analog Setup These sub menus allow the user to configure an analog input channel with a slope and an offset, and to view the current voltage applied to the input. Each analog input can be configured independently. The screens below show the current state of the analog inputs and the default slopes and offsets. --- Analog Input Setup --Analog 1: 0.191 S - Slope: 1.000 O - Offset: 0.000 D - Differential Mode = Off N - Next Input Enter Option > --- Analog Input Setup --— Analog n: 2.462 S - Slope: 1.
offset to be edited. An example of using the offset could be for a temperature sensor that has a 0 to 5 volt output that represents a -40 to +60 degree C range respectfully. First calculate a slope as follows: Slope = (Max Degrees - Min Degrees) / (Max Volts - Min Volts) Slope = (60 - (-40)) / (5 - 0) = 100 / 5 = 20 Now look at the basic equation and fill it in with known data. The slope is now known, and we know that at 0 volts the temperature is -40 degrees.
T - Test Address This is the SDI-12 address that will be used when any of the commands are sent to connected sensors. This allows a single key press to send any of the standard SDI-12 commands. If “0” was used as the Test Address, all SDI-12 commands would be directed to the sensor with address “0.” A - Acknowledge This command sends the address followed by the “!” terminator. The normal response is the sensor address followed by a Carriage Return and Line Feed.
S - Send Extended This command sends the test address followed by the user entered text in the “Edit Extended Cmd” command option followed by “!”. If an error occurs, the H-5223 responds with “Communication Timed Out.” Refer to the sensor manufacturer for proper response to the corresponding Extended Command. E - Edit Extended This options is used to enter a non standard SDI-12 extended command to be sent to the sensor.
For example, if there are 574000 bytes free, and the unit is set to log Date, Time, Ana1, Ana2, and Battery every 15 minutes, that would be 5 columns defined, or 5 data values per scan. (574000 * 15) / (5760 * 5) = 298.95 days. If all memory was available: (2159520 * 15) / (5760 * 5) = 1124 days or just over 3 years. The value 5760 comes from 4 bytes per data value multiplied by 1440 minutes in a day. File Count: There can be up to 8 files of data stored on H-5223.
R - Reset New Data Pointer This option resets the new data pointer to the current file position. If the new data pointer is reset to the current file position, then the next time the ‘Transmit New Data’ option is used the data transfer will start at this point in time. F - Erase Last File This option is used to erase the last file only. This frees up room for the next file. When this option is used the user will be prompted to confirm the erase operation.
--- Logging Options --Column | [01] ---------------|---------S - Source: | Date H - Header: | MM/DD/YY D - Digits: | 2 -> Next <- Previous Enter Option > S - Source This selects what input will be used to provide data for the selected column. Options included are Date, Time, Ana1 to Ana4, Dig1, Dig2, Batt, SDI-12 inputs, etc. If “None” is selected as the source, the selected column and all subsequent columns will be disabled.
--- GOES Main Menu —-M A S R D - Time: HH:MM:SS Mode: Off Address: ABCD1234 Self Timed Options Random Options Diagnostics Enter Option > Time This is the DCP time and is automatically set to international standard time by the GPS system. The user cannot set or change the time manually. The data logger time clock is separate from this time clock and is can be set to local time. M - Mode This allows the user to define the GOES Radio mode of operation.
C - Channel Number This is the Self Timed channel number assigned by NESDIS. This may also be referred to as the primary channel. R - Transmit Rate This is the transmit rate assigned by NESDIS. O - Tx Offset Time This is the transmission time relative to midnight. This is assigned by NESDIS. The offset time must be less than the transmit rate value. W - Self Timed Window NESDIS will assign a window length indicating how much time is allowed to transmit data. The default is a 15 second window.
D - Data Order The options here are ‘Scan Order’ which is the default mode and ‘Channel Order’. In ‘Scan Order’, each line of data will contain one data value from each sensor all measured at the same time. There will be one data value for each sensor set for transmission and the number of lines is equal to the scans per transmission. In ‘Channel Order’, each line of data will contain data values from a single input over a range of time.
T - Transmit Options This screen shows the “Self Timed Transmit Options”. This is used to define the data to be transmitted. --- ST Transmit Options --Column | [01] ---------------|-----------S - Source: | None C - SHEF Code: | F - Format: | XX.XX -> Next <- Previous Enter Option > S - Source This selects what input will be used to provide data for the selected column. Options include Date, Time, Stage, Temp, Batt, AnaX, Counts, SDI-12 inputs, etc.
3.7.2.1.1 Random Options This screen shows the “Random Transmissions” options: --- Random Options —-C R U A Y P T - Channel Number: Transmit Rate: Random BaudRate: Alarm Source: Alarm Type: Alarm Set Point: Transmit Options 000 00:00:00 100 None > Set Pt 1.00 Enter Option > C - Channel Number This is the random channel number assigned by NESDIS. This may also be referred to as the secondary channel. R - Transmit Rate This option defines the time interval in which the random transmissions will be sent.
P - Alarm Set Point This option is used to set the value the data source will be compared with to see if the unit should transmit. T - RR Transmit Options This screen shows the “RR Transmit Options” screen. This screen is used to select the data that will be transmitted during a random transmission. Pressing the S key allows the user to select a valid data source from a list of valid options. Valid options are the same as those with the ST Transmit Options such as AnaX, Dig1, or SDI01.
an easy way to see if the data format and setup information is correct. Radio ST Buffer Byte Count The data in the main buffer will be transferred to the radio buffer at the end of the last scan before the next scheduled transmission. This status screen normally shows a 0 byte count except after the scan just before the transmission. One minute after the transmission is sent this value will go back to 0 indicating the data has been sent.
Current Time This shows the current data logger time. This is for reference only and can not be changed here. Next Scan This shows the time remaining until the next scan occurs. Normally it will be less than the scan rate. S - Scanning This option allows the user to enable or disable the scanning process. NOTE: If scanning is off no data will be logged and no data will be transmitted. R - Scan Rate This option allows the user to define how often the H-5223 will scan the sensors.
Z -UTC offset This option allows the user to specify an +/- offset in minutes from the UTC time obtained from the GPS receiver. I - Site ID This option allows the user to enter in an eight character label that defines the site. This will also be used as the filename for the data file when scanning is turned on. Valid site ID names may include letters, numbers, or the underscore. Spaces and the decimal point are not valid characters for the site ID and should be avoided. NOTE: 3.9.
(RTS) and ‘Clear to Send’ (CTS). Normally a PC connected to the H-5223 will turn on the CTS signal when it is ready to communicate and watches the RTS signal before it sends anything to the H-5223. The same type of monitoring will be done by the H-5223, It will not send anything to the PC if CTS is not on and will turn on RTS indicating to the PC it is ready. NOTE: Hardware flow control should only be enabled on the PC when the H-5223 is turned on.
P - Setup from PC File This option is used to setup the H-5223 from a file previously stored on the PC. R - Reset Defaults This option will reset all of the H-5223 user definable options back to the factory default values. U - Update Firmware This option is used when loading new firmware into the H-5223. When this option is used follow the instructions on the screen and in any readme type of files provided with the new firmware. New firmware will be available as needed from the web page, www.waterlog.com.
Chapter 4 Maintenance/Trouble Shooting 4.1 Maintenance Sustained operation of the H-5223 is almost maintenance-free. There are no desiccant or serviceable parts to maintain. As with any precision instrument, the calibration should be checked or verified on a regular basis. 4.2 Trouble Shooting It is unlikely that this manual will ever contain trouble shooting tips to cover every problem that will be encountered.
Artificially High or Low Data: 1 - Check the slope and offset for the channel reading high. If it is an SDI-12 sensor make sure it is programmed correctly. 2 - Measure the +5.0 volt excitation to see if it is ok. 3 - Try using a warm up delay before taking measurements. 4 - Check battery voltage and all connections. GOES not transmitting: 1 - Check power to the GOES radio, do so under a load. 2 - See if the GOES time is correct, if it is stopped, it indicates power to the radio was lost, stopping the clock.
Appendix A Specifications Performance General Analog Channels: Resolution: Accuracy: Input Range: Excitation Input 4 (Single Ended / Differential on 1 and 2) 20-Bit Resolution (1 Part in 1,048,576) ± 0.075% 0 to 5 Volts (All Channels) 5.000V Switched, with 10mA (max load) ± 3.5 mV Over Load and Temperature Range Frequency Stability Over Temperature: Long Term: Frequency Setting: Output Power 100 / 300: 1200: 7.1 Watts (nominal) Linear 11.
Appendix B SDI-12 Command and Response Protocol B.1 SDI-12 Command and Response Protocol This is a brief description of the Serial Digital Interface (SDI-12) Command and Response protocol used by the W ATERLOG® Series Model H-5223. Refer to the document "A SERIAL DIGITAL INTERFACE STANDARD FOR HYDROLOGIC AND ENVIRONMENTAL SENSORS." Version 1.1 November, 1993 Coordinated by Campbell Scientific, Inc., Logan, Utah.
All ASCII-Hex commands, arguments and data values are transmitted most significant digit first. B.2 Standard SDI-12 Command Set All SDI-12 sensors should incorporate a set of standard commands. These commands are used for making measurements, collecting data, identifying the sensor and verifying the sensor is working properly. Since all sensors use the same basic commands it is easy to memorize and use these commands on any sensor.
B.2.2 Send Data Command The Send Data command returns sensor data generated as the result of previous "aM!" or "aV!" command. Values returned will be sent in 33 characters or less. The sensor's data buffer will not be altered by this command. Command ------------- Response -------------------------------------- "aD0!" through "aD9!" "apd.d ... pd.d" Where: a Is the sensor address ("0" to "9", "A" to "Z", or "*"). D0..D9 Are upper-case ASCII characters. p Is a polarity sign (+ or -). d.
B.2.3 Initiate Verify Command The Verify Command may cause a verify of tests or procedures to be performed. The result of this command is similar to the "aM!" command except that the values generated can be fixed test data, test results, etc. The data generated in response to this command is placed in the sensor's buffer for subsequent collection using "D" commands. The data will be retained in the sensor until another command is executed.
The Send Identification command responds with sensor vendor, model, and version data. Any measurement data in the sensor's buffer is not disturbed. Command ------------- Response ------------------------------------------------------------ "aI!" "allccccccccmmmmmmvvvxx...xx" Where: a Is the sensor address ("0" to "9", "A" to "Z", or "*"). I Is an upper-case ASCII character. ll Is the SDI-12 version compatibility level, e.g. version 1.0 is represented as "10".
stored in non-volatile EEPROM within the sensor. The H-5223 will not respond if the command was invalid, the address was out of range, or the EEPROM programming operation failed. Command ------------- Response ------------------------- "aAn!" "n" Description --------------------------Change sensor address Where: a Is the current (old) sensor address ("0" to "9","A" to "Z", or "*").
Appendix C Remote Operation (Command Mode) Rev 1.01 C.1 Command Interface The H-5223 has a command interface mode for applications that require another computer systme to communicate with the H-5223 through the RS-232 port. Commands are used to setup, monitor and control the H-5223. To access the command interface, the H-5223 must have the startup mode set to command mode.
used to edit characters on the command line. Echoing the command may be turned off using the ‘ECHO=OFF’ command. The commands listed below are grouped into categories based on the function of the command. The H-5223 has three basic types of commands: Read Commands: The command to read each value consists of the value name, followed by “?”. For example, to read the time, the command is “TIME?”. The H-5223 response will be similar to “TIME = 12:34:56".
STATUS COMMANDS FIRMWAREVERSION? XL™ firmware version CHECKSUM? Diagnostic to verify firmware integrity BATTERY? Current battery voltage BATTMIN? Lowest measured battery voltage BATTMAX? Highest measured battery voltage SYSTEMRESETS? Number of system resets RESETSTATUSVALUES Resets BattMin, BattMax, and SystemResets DATA FILE COMMANDS ERASEINTERNALDATA Erase data from internal memory DIRINTERNALDATA Directory of internal data DUMPINTERNALDATAFILE Transmit the file out the serial po
SCANNING COMMANDS SCANNING?/= Scanning on or off SCANRATE?/= Amount of time between scans NEXTSCAN? Amount of time until next scan NEXTSCANAT?/= Time of next scan SENSOR INPUT COMMANDS (Analog Inputs) ANALOG1-4? Analog sensor value ANALOG1-4SLOPE?/= Analog sensor slope ANALOG1-4OFFSET?/= Analog sensor offset DIGITAL I/O COMMANDS DIGITAL1-2? Return the value of digital 1 or 2. DIGITAL1-2= Set digital x to the indicated value (for counter mode).
SDI-12 COMMANDS SDITESTADDRESS?/= Address used when sending SDI-12 commands SDIACKNOWLEDGE Send an acknowledge command SDIIDENTIFY Send an identify command SDIVERIFY Send a verify command SDIMEASURE Send a measure command SDIDATAn Send a collect data command SDIEXTENDED= Send a custom extended command OUTPUT COMMANDS AUTOPRINT?/= Data being logged also gets sent out serial port LOGGING COMMANDS LOGGING?/= Log data to internal memory LOGCOLUMN1-25SOURCE?/= Source of flash card out
GOES COMMANDS GOESMODE?/= Off, Timed, Random, Both GOESADDRESS?/= 8 character address, assigned by NESDIS GOESTIME?/= International standard time GOESSTCHANNEL?/= Self timed channel number GOESSTRATE?/= Self Timed transmit rate GOESSTOFFSET?/= Offset from midnight to first transmit GOESSTFORMAT?/= Format of Self Timed data (SHEF, binary, etc.
C.2 System Commands Command: TIME? Description: Read the current time. Parameters: None. Response: An ASCII text string is returned with the time formatted as hh:mm:ss. The response is terminated using a carriage return, line feed. Example: -> TIME?5 Time = 15:37:21rs Command: TIME=hh:mm:ss Description: Set the current time in the real time clock. The new time is tested for proper values and is then used to update the real time clock.
and is then used to update the real time clock. Parameters:This command expects an input of the format mm/dd/yy, where m is the month, d m is the day, and y is the year. Response: None, use the DATE? command to see the new value. Example: -> DATE=03/21/065 Command: SITEID? Description: Read the Site ID. The Site ID is the text description of the site. It is 8 characters in length. Parameters: None. Response: An ASCII text string is returned with the Site ID formatted as XXXXXXXX.
Description: Read the baud rate for the serial communications port. Parameters: None. Response: An ASCII text string is returned with the baud rate. The baud rate can be “ 300”, “1200”, “2400”, “4800”, “9600”, or “19.2”. The response is terminated using a carriage return, line feed. Example: -> BAUDRATE?5 Baud Rate = 9600rs Command: BAUDRATE=XXXX Description: Set the baud rate for the serial communications port.
Parameters: There are 4 valid flow control settings, “None”, “HW”, “SW”, and “Both”. Response: None, use the FLOWCONTROL? command to see the new value. Example: -> FLOWCONTROL=HW5 rs Command: CHARACTERDELAY? Description: Read the delay that the XL™ puts between sending characters out the serial communications port. Parameters: None. Response: An ASCII text string is returned with the character delay. The character delay is and integer between 0 and 999.
Parameters: None. Response: An ASCII text string is returned with the line feed delay. The line feed delay is an integer value. The response is terminated using a carriage return, line feed. Example: -> LINEFEEDDELAY?5 Line Feed Delay = 0rs Command: LINEFEEDDELAY=XXX Description: Set the character delay. The character delay is how long the XL™ delays in milliseconds between sending characters out the serial communications port.
Parameters: None. Response: The response is an ASCII text string showing the version number, followed with a carriage return, line feed. See the example below: Example: -> FIRMWAREVERSION?5 Firmware Version = 1.00rs Command: CHECKSUM? Description: When this command is issued, the XL™ performs a diagnostic checksum test. Parameters: None. Response: After the test is done, the XL™ will respond either “PASS”, or “FAIL”.
Response: An ASCII string representing the battery voltage in volts is returned. The response is terminated with a carriage return, line feed. Example: -> BATTMIN?5 10.8rs Command: BATTMAX? Description: The XL™ keeps track of the highest battery voltage reading. This command reads that value. Parameters: None. Response: An ASCII string representing the battery voltage in volts is returned. The response is terminated with a carriage return, line feed. Example: -> BATTMAX?5 13.
Example: ->RESETSTATUSVALUES5 rs Command sent to XL™. Response sent to the host system. C.4 Data File Commands Command: ERASEDATACARD Description: Format the flash card in the card slot. This is an irreversible process. Parameters: None. Response: None. Example: ->ERASEDATACARD5 rs Command: ERASEINTERNALDATA Description: Format the internal flash memory. This is an irreversible process. Parameters: None. Response: None.
Example: ->DIRDATACARD5 Site01.001 26,103 Site01.002 45,228 Site01.003 6,846 rs Command: DIRINTERNALDATA Description: Get a list of the files in the internal data memory. Parameters: None. Response: See DIRDATACARD above. Example: See DIRDATACARD above. Command: DUMPDATACARDFILE Description: Transmits the file, specified by filename, through the serial port. If filename is not found, nothing is transmitted. Use DIRDATACARD to get the names of the files on the data card.
found, nothing is transmitted. Use DIRINTERNALDATA to get the names of the files in internal data memory. Parameters: None. Response: See DUMPDATACARDFILE above. Example: See DUMPDATACARDFILE above. Command: COPYDATATOCARD Description: Copies all of the files from internal memory to the data card. Files are renamed as they are copied. The file extension gets changed so that the first letter is alphabetic. For example, 000 gets changed to A00, 001 gets changed to A01.
Description: Calculates the total number of bytes free on the data card. This number reflects the total space free on the card. Parameters: None. Response: The response will be an ASCII string representing the number of bytes free. Example: ->DATACARDBYTESFREE?5 Command sent to the XL™. Data Card Bytes Free = 9710234rs Response from the XL™. Command: INTERNALDATABYTESUSED? Description: Calculates the total number of bytes used in internal memory.
Command: SCANNING? Description: Reads the scanning flag. This value determines whether or not the XL™ is set to scan. Parameters: None. Response: The response will be either the “ON” or “OFF”. Examples: -> SCANNING?5 OFFrs Command: SCANNING=XXX Description: Set the scanning flag. Parameters: This flag can be set to either “ON” or “OFF”. Response: None. Example: -> SCANNING=ON5 rs Command SCANRATE? Description: Read the current scan rate interval. Parameters: None.
Parameters: The parameter string is formatted for two digits used for the hours, (hh); two digits used for the minutes, (mm); and two digits used for the seconds, (ss). The hour, minute and second values must be separated with some character as shown above. Note the space between the command and the parameter. Response: None, use the SCANRATE command to see the new value. Example: -> SCANRATE=00:01:005 rs Command sent to the XL™. This sets the scan rate to force a scan once every minute.
Response: None Examples: -> NEXTSCANAT=12:00:005 Command sent to the XL™. rs Response sent to the host system. C.6 Sensor Input Commands Command: ANALOGn? Description: Read the analog input channel n. Parameters: The parameter ‘n’ is 1-4 for the four analog channels. Response: An ASCII string representing a voltage between -5.00 and +5.00 volts. The response is terminated with a carriage return and a line feed. Example: -> ANALOG1?5 Command sent to XL™. Analog 1 = 3.
Response: None. Example: -> ANALOG2SLOPE=1.44E-65 Command sent to the XL™. rs Response sent to the host system. Command ANALOGnOFFSET? Description: Read the offset for the nth analog sensor. This value is used in the equation to calculate the sensor value from the raw voltage reading. Parameters: ‘n’ is either 1 or 2. Response: A real number is returned, represented in ASCII text format. Example: -> ANALOG1OFFSET?5 Analog 1 Offset = 0.0rs Command ANALOGnOFFSET=XXX.
Parameters: There are two digital channels, so n can be either 1 or 2. Response: An ASCII string is returned containing the mode. The mode can be “Digital Input”, “Trigger Pulse”, “Trigger Cont.”, or “On For Scan”. See the Digital I/O chapter of the user’s manual for more information. Example: -> DIGITAL1MODE?5 Command sent to the XL™. Digital 1 Mode = Digital Inputrs Response from the XL™. Command DIGITALnMODE= Description: Write the operation mode of the nth digital channel.
Parameters: There are two digital channels, so n can be either 1 or 2. For the trigger source, this command expects an ASCII string. The trigger source can be “Stage”, “PSI”, “Temp”, etc. Response: None. Example: -> DIGITAL1TRIGGERSOURCE=Stage5 rs Command DIGITALnTRIGGERTYPE? Description: Read the trigger type of the nth digital channel. The trigger type determines the way in which the value of the trigger source is compared to the trigger point.
by the trigger type, the channel is activated. Parameters: There are two digital channels, so n can be either 1 or 2. Response: An ASCII string containing a real number is returned for the trigger point. Example: -> DIGITAL1TRIGGERPOINT?5 Command sent to the XL™. Digital 1 Trigger Point = 5.75rs Response from the XL™. Command DIGITALnTRIGGERPOINT= Description: Write the trigger point of the nth digital channel.
Parameters: There are two digital channels, so n can be either 1 or 2. The command accepts an integer number for the pulse length. Response: None. Example: -> DIGITAL1PULSELENGTH=1505 rs Command COUNTERSLOPE? Description: Read the counter slope. This value scales raw counts to the value given to the user. Parameters: None. Response: The response is an ASCII text string representing the slope value. The response will be followed by a carriage return, line feed.
C.8 SDI-12 Commands Command: SDITESTADDRESS? Description: Read the address that the XL™ uses when issuing SDI-12 commands. Parameters: None. Response: An ASCII text string is returned with the address. Example: -> SDITESTADDRESS?5 SDI Test Address = 1rs Command: SDITESTADDRESS=x Description: Set the address that the XL™ uses when issuing SDI-12 commands. Parameters: The address can be 0-9 or A-Z. Response: None.
Description: Issue an identify command on the SDI-12 bus using the address specified by SDITESTADDRESS. Parameters: None. Response: The XL™ takes the response it receives on the SDI-12 bus and returns it. If no response is received, the XL™ responds with “Communication Timed Out”. The response to the identify command is as follows: allccccccccmmmmmmvvvxx...xx a: sensor address (“0-9", “A-Z”, “a-z”, “*”, “?”). ll: SDI-12 version compatibility level, e.g. version 1.2 is represented as “12”.
Example: -> SDIVERIFY5 11234rs Command sent to XL™. Response from XL™. Command: SDIMEASURE Description: Issue a measure command on the SDI-12 bus using the address specified by SDITESTADDRESS. Parameters: None. Response: The XL™ takes the response it receives on the SDI-12 bus and returns it. If no response is received, the XL™ responds with “Communication Timed Out”. The response to the measure command is as follows: atttn a: sensor address (“0-9", “A-Z”, “a-z”, “*”, “?”).
x.xxx: channel A voltage y.yyy: channel B voltage Example: -> SDIDATA05 +1.234+9.876rs Command sent to the XL™. Response from the XL™. Command: SDIEXTENDED= Description: Issue an extended command on the SDI-12 bus using the address specified by SDITESTADDRESS. Parameters: “command” is the command that is to be issued on the SDI-12 bus. It needs to be a valid SDI-12 command. Response: The XL™ takes the response it receives on the SDI-12 bus and returns it.
Description: Set the auto print flag. Parameters: The flag can be set to either “On ” or “Off“. Response: None. Example: -> AUTOPRINT=ON5 rs C.10 Logging Commands Command sent to the XL™. Response from the XL™. Command: LOGGING? Description: Read the logging status flag. If this flag is set, then the XL™ will log data to the internal data memory. Parameters: None. Response: An ASCII text string is returned with either “Yes” or “No “.
Example: -> LOGCOLUMN2SOURCE?5 Log Column 2 Source = Date rs Command sent to the XL™. Response from the XL™. Command: LOGCOLUMNnSOURCE=XXXXXX Description: Set the source of the nth data column going to the card. Parameters: ‘n’ ranges from 1-25. The XL™ expects the new source of the data column corresponding to ‘n’ (e.g. Stage, PSI, Temp). Response: None.
Command: LOGCOLUMNnDIGITS? Description: Read the number of digits to be displayed after the decimal point. Parameters: ‘n’ can range from 1-25. Response: The response is an ASCII text string with the number of digits for the nth column. Example: -> LOGCOLUMN2DIGITS?5 Log Column 2 Digits = 1rs Command: LOGCOLUMNnDIGITS=XX Description: Set the number of digits to which the corresponding value is to be expressed when it is logged to the flash card. Parameters: ‘n’ ranges from 1-25.
Parameters: The flag can be set to “None ”, “Timed ”, “Random”, or “Both “. Response: None. Example: -> GOESMODE=RANDOM5 rs Command: GOESADDRESS? Description: Read the 8 hexadecimal character DCP address that the GOES radio uses to interface with the collection satellite. Parameters: None. Response: An ASCII text string is returned with the DCP address. It is 8 characters long, and each character ranges from 0-9, A-F.
Command: GOESTIME=hh:mm:ss Description: Set the time of the GOES radio. Parameters: The new time is to be entered in the format of HH:MM:SS, where H is hours, M is minutes, and S is seconds. Response: None. Example: -> GOESTIME=08:30:005 rs Command: GOESSTCHANNEL? Description: Read the 3 character Self Timed channel number. Parameters: None. Response: An ASCII text string is returned with the channel number. It is 3 characters long, and each character ranges from 0-9.
Parameters: None. Response: An ASCII text string is returned in the format of hh:mm:ss. Example: -> GOESSTRATE?5 GOES ST Rate = 00:04:00rs Command: GOESSTRATE=hh:mm:ss Description: Set the transmission rate for the Self Timed mode of the GOES radio. Parameters: The new rate is to be entered in the format of HH:MM:SS, where H is hours, M is minutes, and S is seconds. Response: None.
Command: rs GOESSTFORMAT? Response sent to the host system. Description: Read the Self Timed transmission data format. This is the format in which the data is transmitted. The format can be either SHEF or BINARY. Parameters: None. Response: An ASCII text string is returned indication the format. Example: -> GOESSTFORMAT?5 GOES ST Format = BINARYrs Command: GOESSTFORMAT=XXXXXX Description: Set the data format for the Self Timed mode of the GOES radio.
Response: None. Example: -> GOESSTORDER=CHANNEL5 rs Command: GOESSTSENDSHEFCODES? Description: Read the send SHEF codes flag. If this is set to “YES”, each self timed GOES transmission will include SHEF code column headers. Parameters: None. Response: An ASCII text string is returned consisting of either “Yes” or “No “.
Command: GOESSTAPPENDBATTERY=XXX Description: Set the append battery flag. Parameters: The flag can be set to either “Yes” or “No “. Response: None. Example: -> GOESSTAPPENDBATTERY=NO5 rs Command: GOESSTSCANSPERXMIT? Description: Read the number of scans to be transmitted with each transmission. Parameters: None. Response: An ASCII text string with the number of scans per transmission.
Example: -> GOESSTBUFFERCOUNT?5 GOES ST Buffer Count = 512rs Command: GOESSTCOLUMNnSOURCE? Description: Read the source of the nth column of data to be sent in the GOES self timed transmission. Parameters: ‘n’ can range from 1-20, indicating the corresponding column. Response: The source of the column corresponding to ‘n’ (e.g. Stage, PSI, Temp). Example: -> GOESSTCOLUMN2SOURCE?5 GOES ST Column 2 Source = Date Command sent to the XL™. Response from XL™. rs Command sent to XL™.
Command: GOESSTCOLUMNnSHEFCODE=XX Description: Set the SHEF code for the nth column of self timed GOES data. Parameters: ‘n’ ranges from 1-20. Response: None. Example: -> GOESSTCOLUMN3SHEFCODE=DT5 rs Command: GOESRRCHANNEL? Description: Read the channel to be used for GOES random transmissions. Parameters: None. Response: An ASCII text string is returned with the channel.
Example: -> GOESRRRATE?5 GOES RR Rate = 00:00:30rs Command sent to the XL™. Response sent to the host system. Command: GOESRRRATE=hh:mm:ss Description: Set the transmission rate for the random report mode of the GOES radio. Parameters: The new rate is to be entered in the format of HH:MM:SS, where H is hours, M is minutes, and S is seconds. Response: None.
Command: GOESRRTRIGGERSOURCE? Description: Read the source that will be evaluated when determining whether or not to trigger a random report. Parameters: None Response: The response will be an ASCII text string with the current RR trigger source (e.g. Stage, PSI, Temp). Example: -> GOESRRTRIGGERSOURCE?5 GOES RR Trigger Source = Stage rs Command: GOESRRTRIGGERSOURCE=XXXXXX Description: Set the GOES random report trigger source. Parameters: The new trigger source value for the random report (e.
Description: Set the RR trigger point. Parameters: The XL™ accepts a real number represented in ASCII text format. Response: None. Example: -> GOESRRTRIGGERPOINT=3.35 rs Command: GOESRRFORCEXMIT? Description: Immediately forces a GOES random report transmission. Parameters: None. Response: None Example: -> GOESRRFORCEXMIT5 rs Command: GOESRRBUFFERCOUNT? Description: Counts the number of bytes currently in the GOES random report buffer. Parameters: None.
GOES RR Column 2 Source = Date rs Response from XL™. Command: GOESRRCOLUMNnSOURCE=XXXXXX Description: Set the source of the nth data column of the RR GOES transmission. Parameters: ‘n’ ranges from 1-5. The XL™ expects the new source of the data column corresponding to ‘n’ (e.g. Stage, PSI, Temp). Response: None. Example: -> GOESRRCOLUMN1SOURCE=Time5 rs Command sent to the XL™. Response from the XL™. C.12 Miscellaneous Commands Command: OFF Description: Turn the XL™ off.
Response: None. Example: -> ECHOOFF5 Command sent to the XL™. The logger will no longer echo key presses to the host system. C.13 Advanced Commands Command: MENU Description: Display a menu structure on the host system. This will use a VT52 terminal emulation mode. When leaving the menu the XL™ will turn off. This will be the normal mode of operation for human interaction. Chapter 3 is devoted completely to this command. Parameters: None. Response: None.
-> TESTSCAN5 23.153 459.21 9.1388rs C-46 Remote Operation (Command Mode) Command sent to the XL™. Response sent to the host system.
H-5223 Menu Tree Version 1.0 H-5223 Main Menu View Status (B - Back) View Status (B - Back) V - View Status I - Sensor Input Options D - Data Options O - Output Options S - Scan Options C - Configure System X - Exit Site ID: Site_ID Time: 01:02:03 Date: 08/27/04 Scanning: Off Next Scan:XX:XX:XX GOES Mode:Off M - More Battery: 12.4 Batt Max: 13.6 Batt Min: 11.2 System Resets: 1 Version: 1.
H-5223 Menu Tree From Front Page Continued NOTES: Log Options (Columns 2 to 20) Log Options (B - Back) Column | [01] ------------------------S - Source: | Date H - Header: | MM/DD/YY D - Digits: | 0 -> Next <- Previous Enter Option > (B - Back) Self Timed Options (B - Back) ST Data Format Time: 00:00:00 M - Mode: Off A - Address: ABCD1234 P - Preamble: Short S - Self Timed Options R - Random Options D - Diagnostics C - Channel: R - Transmit Rate: HH:MM:SS O - Tx Offset Time: HH:MM:SS W - Self Timed
