Home

XL Remote Commands

1. GOESRRCOLUMNnSOURCE XXxxxx Set the source of the n data column of the RR GOES transmission n ranges from 1 5 The XL expects the new source of the data column corresponding to n e g Stage PSI Temp None Command sent to the XL Response from the XL gt GOESRRCOLUMN1SOURCE Time eas Commands BUBBLERATE Read the H 355 bubble rate The value indicates bubbles per minutes None An ASCII text string is returned with the bubble rate Command sent to the XL Response sent to the host system gt BUBBLERATE lt Bubble Rate 45 Rr Remote Operation Command Mode C 65 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 66 Remote Operation Command Mode BUBBLERATE XXX Set the H 355 bubble rate The range for the bubble rate is 30 120 None Command sent to the XL Response sent to the host system gt BUBBLERATE 60 lt Cale PURGEPSI Read the H 355 purge pressure This is the pressure with which the Bubbler purges None An ASCII text string is returned indicating the purge pressure Command sent to the XL Response sent to the host system gt PURGEPSI Purge PSI 40 Rr PURGEPSI XX Set the H 355 purge pressure The pressure range for Purge PSI is 15 80
2. Command Description Parameters Response Example C 16 Remote Operation Command Mode Command sent to XL Response sent to the host system gt STATUSISOURCE lt Status 1 Source Stage r STATUSnSOURCE XXXxXxxxX Set the source of the n status value n is from 1 5 The XL expects the new source of the status value corresponding to n e g Stage PSI Temp None Command sent to XL Response sent to the host system gt STATUSISOURCE PSI lt Cp Le STATUSnLABEL Read the label of the n status value There are 5 status values 1 5 The specific status value is determined by n The label of the n status value e g Stage WaterLvl Batt The label is 8 characters long Command sent to XL Response sent to the host system gt STATUS3LABEL lt Status 3 Label Battv Rr STATUSnLABEL XXXXXXXX Set the label of the n status value The label for the n status value is set to the entered text The text can be up to 8 characters Entries shorter than 8 chars are padded with spaces to make 8 None Command sent to XL Response sent to the host system gt STATUSSLABEL WatLvl lt Cpl WATERL G XL SERIES Command Description Parameters Response Example STATUSnVALUE Read the actual value of the n status value Based on the source of the n status value the XL scans the appropriate value The
3. Command sent to the XL Response sent to the host system gt COUNTERMODE Count Only on RESETCOUNTERS Reset both total and summation counters to zero None None Command sent to the XL Response sent to the host system gt RESETCOUNTERS Cale WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES ANALOGn Read the analog input channel n The parameter n is 1 4 for the four analog channels 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 gt ANALOG1 lt Command sent to XL Analog 1 3 23265mlr Response sent to the host system ANALOGnSLOPE Read the slope for the n analog sensor This value is used in the equation to calculate the sensor value from the raw voltage reading n is 1 4 A real number is returned represented in ASCII text format gt ANALOG2SLOPE lt Command sent to the XL Analog 2 Slope 12 441 Rr Response sent to the host system ANALOGnSLOPE XXX XX Set the slope for the n analog sensor This value is used in the equation to calculate the sensor value from the raw voltage reading n is 1 4 XXX XX is a real number It is to be in the format of lt gt
4. Site01 001 26 103 04 04 01 18 01 Site01 002 45 228 04 04 03 04 15 Site01 003 6 846 04 04 04 21 33 Cale Response sent to the host system DIRINTERNALDATA Get a list of the files in the internal data memory None See DIRDATACARD above See DIRDATACARD above DUMPDATACARDFILE lt filename gt 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 The filename is specified by filename The XL responds by transmitting the specified file gt DUMPDATACARDFILE SITE1 001 Command sent to XL ERLE Data file sent from the XL MM DD YY HH MM SS Stage Temp 03 01 01 12 00 00 24 83475 12 58436 RF 03 01 01 12 01 00 24 72364 12 54357 Re 03 01 01 12 02 00 24 63845 12 56457 Re 03 01 0 3 45 00 24 38375 12 52645 R4 03 01 0 3 46 00 24 83375 12 55673 R 03 01 0 3 47 00 24 83745 12 56535R Cpl Done Close Filer WATERLOG xL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES DUMPINTERNALDATAFILE lt ilename gt Transmits the file specified by filename through the serial port If filename is not found nothing is transmitted Use DIRI
5. Logging Yes Rr LOGGING XXX Set the logging status flag The flag can be set to either Yes or No None Command sent to the XL Response from the XL gt LOGGING NO Cpl LOGCOLUMNnSOURCE Read the source of the n column of data to be logged to the flash card n can range from 1 25 indicating the corresponding column The source of the column corresponding to n e g Stage PSI Temp Command sent to the XL Response from the XL gt LOGCOLUMN2SOURCE Log Column 2 Source Date Rr LOGCOLUMNnSOURCE XXxXxxxX Set the source of the n data column going to the card WATERL G XL SERIES Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters WATERL G XL SERIES n ranges from 1 25 The XL expects the new source of the data column corresponding to n e g Stage PSI Temp None Command sent to the XL Response from the XL gt LOGCOLUMN1SOURCE Time Cp Le LOGCOLUMNnHEADER Read the column header of the n column of data to be sent to the flash card This value will be placed at the top of each column in the file logged to the card n can range from 1 25 indicating the corresponding column The response will be an 8 character ASCII text string Co
6. Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response C 58 Remote Operation Command Mode GOESSTSENDSHEFCODES XXX Set the flag to send SHEF codes with each self timed transmission The flag can be set to either Yes or No None Command sent to the XL Response from the XL gt GOESSTSENDSHEFCODES NO Cale GOESSTAPPENDBATTERY Read the append battery flag If this flag is set a battery reading will be appended to each GOES self timed transmission None An ASCII text string is returned indicating whether or not the XL will append a battery reading when transmitting data The response is either Yes or No Command sent to the XL Response from the XL gt GOESSTAPPENDBATTERY lt GOES ST Append Battery Yes rR GOESSTAPPENDBATTERY XXX Set the append battery flag The flag can be set to either Yes or No None Command sent to the XL Response sent to the host system gt GOESSTAPPENDBATTERY NO lt Cale GOESSTSCANSPERXMIT Read the number of scans to be transmitted with each transmission None An ASCII text string with the number of scans per transmission WATERL G XL SERIES Example Command Description Parameters Response Exam
7. ALERTnTRIGGERMODE Read the current mode of operation of the n ALERT alarm This value along with the source determines what conditions are checked when evaluating whether or not to send an ALERT transmission None An ASCII text string is returned The response will be Always gt Set Pt lt Set Pt or Delta Command sent to XL Response from XL gt ALERT1LTRIGGERMODE lt ALERT 1 Trigger Mode Always re ALERTnTRIGGERMODE XXXXXX Set the current mode of operation for the n ALERT alarm n can range from 1 5 The flag can be set to Always gt Set Pt lt Set Pt or Delta None Command sent to XL Response from XL gt ALERT2TR Cole GGERMODE gt Set Pte ALERTnTRIGGERPOINT Read the trigger point for the ALERT condition check The value indicated by the ALERT source is compared to this value Depending on the ALERT trigger mode different comparisons will be made If the trigger conditions are met an ALERT radio transmission is generated None An ASCII text string is returned with a real number indicating the trigger point Command sent to XL Response from XL gt ALERT5TRIGGERPOINT ALERT 5 Trigger Point 2 5 mRlr WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example
8. Command Description Parameters Response Example WATERL G XL SERIES ALERTnTRIGGERPOINT XXXXX Set the trigger point The XL accepts a real number represented in ASCII text format None gt ALERT4TRIGGERPOINT 3 3 Command sent to XL ERLE Response from XL ALERTnHOLDOFF Read the hold off value for the n ALERT alarm Hold off is a delay in milliseconds which comes after a transmission n ranges from 1 5 Hold off is an integer representing milliseconds Command sent to XL Response from XL gt ALERT4HOLDOFF lt ALERT 4 Hold Off 100 R ALERTnHOLDOFF XXX Set the hold off value for the n ALERT alarm n ranges from 1 5 Hold off is an integer representing milliseconds None Command sent to XL Response from XL gt ALERT3HOLDOFF 300 lt Cale Remote Operation Command Mode C 49 C 10 Logging Commands Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description C 50 Remote Operation Command Mode LOGGING Read the logging status flag If this flag is set then the XL will log data to the internal data memory None An ASCII text string is returned with either Yes or No Command sent to the XL Response from the XL gt LOGGING
9. Description Parameters Response Example Command Description C 14 Remote Operation Command Mode CHECKSUM When this command is issued the XL performs a diagnostic checksum test None After the test is done the XL will respond either PASS or FAIL If the test fails the FAIL response will be followed by a number indicating how far the checksum failed by This number is useful for diagnosing problems gt CHECKSUM lt Command sent to the XL BATTERY Read the internal battery voltage input channel None An ASCII string representing the battery voltage in volts is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt BATTERY 12 5ERbE BATTMIN The XL keeps track of the lowest battery voltage reading This command reads that value None An ASCII string representing the battery voltage in volts is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt BATTMIN lt 10 8 Rte BATTMAX The XL keeps track of the highest battery voltage reading This command reads that value WATERL G XL SERIES Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command De
10. Response from the XL gt LOGCOLUMN1SKIPRATE 1 lt Cale LOGCOLUMNnDIGITS Read the number of digits to be displayed after the decimal point n can range from 1 25 The response is an ASCII text string with the number of digits for the n column Command sent to the XL Response from the XL gt LOGCOLUMN2DIGITS lt Log Column 2 Digits 1a LOGCOLUMNnDIGITS XX Set the number of digits to which the corresponding value is to be expressed when it is logged to the flash card n ranges from 1 25 None Command sent to the XL Response from the XL gt LOGCOLUMNIDIGITS 2 lt Cale WATERL G XL SERIES C 11 GOES Commands Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES GOESMODE Read the current mode of operation of the GOES radio None An ASCII text string is returned The response will be None Timed Random or Both Command sent to the XL Response sent to the host system gt GOESMODE lt GOES Mode Timed Rr GOESMODE XXXXXX Set the current mode of GOES radio operation The flag can be set to None Timed Random or Both None Command sent to the XL Response sent to the hos
11. 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 extended command depends entirely on the command gt SDIEXTENDED Ae 1 ERLE Command sent to the XL Response from the XL C 9 Output Commands Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response C 38 Remote Operation Command Mode AUTOPRINT Read the auto print flag If this flag is set all data being logged also gets sent out the serial port None An ASCII text string is returned with either On or Off Command sent to the XL Response from the XL gt AUTOPRINT lt Auto Print Off Rl AUTOPRINT XXX Set the auto print flag The flag can be set to either On or Off None Command sent to the XL Response from the XL gt AUTOPRINT ON Cp Le REMOTEDISPLAYLABEL Read the remote display label This label will be printed with the data value on the display None An 8 character ASCII text string with the label WATERL G XL SERIES Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response
12. None Command sent to the XL Response sent to the host system gt PURGEPSI 40 lt Cale PURGETHRESHOLD Read the H 355 purge threshold The purge threshold is the pressure at which the H 355 automatically purges None WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES An ASCII text string is returned indicating the purge threshold Command sent to the XL Response sent to the host system gt PURGETHRESHOLD lt Purge Threshold 40 Rr PURGETHRESHOLD XX Set the H 355 purge threshold The range for the purge threshold is 10 65 None Command sent to the XL Response sent to the host system gt PURGETHRESHOLD 50 lt Cp Le PURGEDURATION Read the H 355 purge duration This is the length of time in seconds for which the bubbler will purge None An ASCII text string is returned indicating the purge duration of the H 355 Command sent to the XL Response sent to the host system gt PURGEDURATION lt Purge Duration 120 PURGEDURATION XXX Set the H 355 purge duration The new time is to be entered in seconds ranging from 30 240 None Command sent to the XL Response sent to the host system gt PURGEDURATION 90 lt Co
13. XL Response sent to the host system gt GOESTIME 08 30 00 Cale GOESSTCHANNEL Read the 3 character Self Timed channel number None WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES An ASCII text string is returned with the channel number It is 3 characters long and each character ranges from 0 9 Command sent to the XL Response sent to the host system gt GOESSTCHANNEL lt GOES ST Channel 123 R GOESSTCHANNEL XXX Set the channel number for the GOES radio to be used with the Self Timed mode The channel number can range from 000 999 None Command sent to the XL Response sent to the host system gt GOESSTCHANNEL 321 lt Cale GOESSTRATE Read the Self Timed transmission rate This is how often the GOES radio will transmit when in Self Timed mode None An ASCII text string is returned in the format of hh mm ss Command sent to the XL Response sent to the host system gt GOESSTRATE lt GOES ST Rate 00 04 00R GOESSTRATE hh mm ss Set the transmission rate for the Self Timed mode of the GOES radio 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 None Command sent to the XL
14. XXX lt gt XX lt E XX gt In other words optional sign digits optional decimal point digits optional exponent optional sign exponent digits None gt ANALOG2SLOPE 1 44E 6 lt Command sent to the XL Cale Response sent to the host system Remote Operation Command Mode C 29 Command ANALOGnOFFSET Description Read the offset for the n analog sensor This value is used in the equation to calculate the sensor value from the raw voltage reading Parameters m is either 1 or 2 Response A real number is returned represented in ASCII text format Example gt ANALOGLOFFSET Command sent to the XL Analog 1 Offset 0 0 Rte Response sent to the host system Command ANALOGnOFFSET XXX XX Description Set the offset for the n analog sensor This value is used in the equation to calculate the sensor value from the raw voltage reading Parameters m is either 1 or 2 XXX XX is a real number It is to be in the format of lt t gt XXX lt gt XX lt E XX gt In other words optional sign digits optional decimal point digits optional exponent optional sign exponent digits Response None Example gt ANALOG2OFFSET 1 5 Command sent to the XL ERLE Response sent to the host system C 7 Digital I O Commands Command DIGITALnMODE Description Read the operation mode of the n digital channel The mode determines whether the channel is an input or out
15. and a line feed character The character in the examples is used to represent the ENTER key and signifies a carriage return and a line feed being sent to the XL Any parameters must follow the command as described with the proper spacing between the command and the parameter The command may be in upper or lower case When entering the command mode the characters typed on the host system will be received by the XL and echoed back to the host system This allows the user to verify that what was typed was also received by the XL The BACKSPACE key may be 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 WATER LOG XL SERIES Remote Operation Command Mode C 1 SERI S The XL has three basic types of commands Read Commands The command to read each value consists of the value name followed by 2 For example to read the time the command is TIME The XL response will be similar to TIME 12 34 56 Write commands The command to write each value consists of the value name followed by and then the new value For example to set the date the command is DATE 05 05 99 There is no response to a write command Action Commands These simply consist of the command For example RESETSTATUSVALUES or PURGENOW Below is a table
16. channel The trigger point is compared to the value of the trigger source and if the comparison meets the condition specified by the trigger type the channel is activated There are two digital channels so n can be either 1 or 2 The command accepts a real number for the trigger point None gt DIGITALITRIGGERPOINT 4 25 lt Command sent to the XL ERLE Response from the XL DIGITALnPULSELENGTH Read the pulse length of the n digital channel The pulse length is the amount of time in milliseconds that the digital channel outputs a signal There are two digital channels so n can be either 1 or 2 An ASCII string containing an integer number is returned for the pulse length gt DIGITALIPULSELENGTH Command sent to the XL Digital 1 Pulse Length 200 R r Response from the XL DIGITALnPULSELENGTH Write the pulse length of the n digital channel The pulse length is the amount of time in milliseconds that the digital channel outputs a signal There are two digital channels so n can be either 1 or 2 The command accepts an integer number for the pulse length None gt DIGITALIPULSELENGTH 150 Command sent to the XL Pate Response from the XL Remote Operation Command Mode C 33 Command Description Parameters Response Example Command Description Parameters Response Example DIGITALnNWARMUPDELAY Read th
17. example the general equation for stage is Stage Slope Pressure Offset For stage in feet the slope is 2 3067 In meters it s 0 70308 A custom slope value of 1 234 can be entered as UserDef 1 234 None Command sent to XL Response sent to the host system gt STAGEUNITS Feet Cole STAGEOFFSET Directly read the offset for the stage value None An ASCII string representing the offset is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt STAGEOFFSET lt Stage Offset 0 21 STAGEOFFSET X XXX Set the user offset for stage This command accepts a real number representing stage offset None Command sent to XL Response sent to the host system gt STAGEOFFSET 0 lt Cp Le WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description WATERL G XL SERIES TEMPERATURE Get a reading from the internal temperature sensor This input is expecting a type T thermocouple None An ASCII string representing the temperature is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt TEMPERATURE Temperature 23 65PRbE TEMPE
18. is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt STAGE 4 25 Rte STAGE X XXX Calibrates the user offset for stage The XL performs a pressure measurement and compares the measured value to the entered value to get the offset To perform this calibration measure the stage with a reference and enter the reference value into this function This command accepts a real number representing stage level None Command sent to XL Response sent to the host system gt STAGE 8 6 Eat STAGEUNITS Check which units the XL is reporting stage in None An ASCII string representing the stage units The response can be any of the following Feet Meters Inches or UserDef Remote Operation Command Mode C 23 Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 24 Remote Operation Command Mode Command sent to XL Response sent to the host system gt STAGEUNITS lt Stage Units Feet Rr STAGEUNITS XXXXXXX Set which units the XL is reporting stage in This command takes an ASCII string representing the units in which stage should be reported This value tells the XL what slope value to use when calculating stage from pressure For
19. maximum range for the n ALERT alarm n ranges from 1 5 WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES Max range is a floating point number Command sent to XL Response from XL gt ALERT4MAXRANGE lt ALERT 4 Max Range 12 5 Rle ALERTnMAXRANGE XXXXXX Set the maximum range for the n ALERT alarm n ranges from 1 5 Max range is a floating point number None Command sent to XL Response from XL gt ALERT3MAXRANGE 10 75 lt en ALERTnMINRANGE Read the minimum range for the n ALERT alarm n ranges from 1 5 Min range is a floating point number Command sent to XL Response from XL gt ALERT4MINRANGE ALERT 4 Min Range 0 0 Rlr ALERTnMINRANGE XXXXXX Set the minimum range for the n ALERT alarm n ranges from 1 5 Min range is a floating point number None Command sent to XL Response from XL gt ALERT3MINRANGE 1 5 lt Cole Remote Operation Command Mode C 47 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 48 Remote Operation Command Mode
20. of commands In the table commands followed by are values that can be read commands followed by are values that can be written and commands followed by are values that can be read and written Action commands have no special character following SYSTEM COMMANDS COMMAND DESCRIPTION TIME Current time normally set to local time DATE Current date normally set to local date SDIADDRESS SDI 12 address FLOWCONTROL Hardware or software flow control or none C 2 Remote Operation Command Mode WATERLOG XL SERIES S STATUS COMMANDS Diagnostic to verify firmware integrity BATTMIN Lowest measured battery voltage STATUS1 5SOURCE Source for the status value Label for the status value STATUSI SVALUE DATA FILE COMMANDS DIRDATACARD Directory of data card COPYDATATOCARD Copy the internal data files to the data card WAT ERI 6 u XL SERIES Remote Operation Command Mode C 3 SCANNING COMMANDS SCANNING SCANRATE NEXTSCAN NEXTSCANAT STAGE SENSOR INPUT COMMANDS LASTSTAGE STAGEUNITS STAGEOFFSET TEMPERATURE TEMPERATUREUNITS COUNTERTOTAL COUNTERSUM COUNTERSLOPE SUMINTERVAL COUNTERMODE RESETCOUNTERS ANALOG1 4 ANALOG1 4SLOPE ANALOG1 4OFFSET C 4 Remote Operation Command Mode Current stage level Current stage level o Offset for stage Counts since last interval Reset all of
21. the counters Analog sensor value Analog sensor slope Analog sensor offset WATERLOG XL SERIES S DIGITAL I O COMMANDS Trigger type always gt set point DIGITAL1 2TRIGGERPOINT Point with which the source value is compared SDI 12 COMMANDS SDITIDENTIFY Send an identify command WAT ERI 6 u XL SERIES Remote Operation Command Mode C 5 OUTPUT COMMANDS EMAIL E mail modem on off EMAILALARMS Send e mail based on alarm conditions yes no ALERT ALERT radio on off ALERTI 5ID ALERT1 5MAXRANGE Maximum range for this datum A ALERT1 5HOLDOFF Delay after transmitting LOGGING COMMANDS LOGGING Log data to internal memory LOGCOLUMN1 25SOURCE Source of flash card output column LOGCOLUMN1 25HEADER Column header for flash card output C 6 Remote Operation Command Mode WATER LOG XL SERIES SERIES LOGCOLUMN1 25SKIPRATE Skip rate for flash output column LOGCOLUMNI1 25DIGITS of digits to print for flash column GOESMODE Off Timed Random Both GOESSTRATE Self Timed transmit rate Offset from midnight to first transmit GOESSTSENDSHEFCODES Send SHEF codes with each transmit yes no of bytes in transmit buffer GOESSTCOLUMN1 20SOURCE Source of ST output column SHEF code of ST output column GOESRRRATE Random Report transmit rate Trigger point GOESRRFORCEXMIT Force a random transmission E E WAT ERI 6 u XL SERIES Remo
22. 260 e mail modem None An ASCII text string is returned with either On or Off gt EMAIL Command sent to the XL Email off Response from the XL EMAIL XxXxX Set the e mail modem enable flag Setting this flag enables support for the H 260 e mail modem The flag can be set to either On or Off None Command sent to the XL Response from the XL gt EMATL ON Cp Le EMAILSENDRATE Read the e mail send rate This rate determines how often e mail messages are to be sent None An ASCII text string is returned with the send rate The send rate can be Daily Hourly or Each Scn Command sent to the XL Response sent to the host system gt EMATLSENDRATE lt Email Send Rate Daily R EMAILSENDRATE xxxxxxxx Set the transmission rate for the e mail modem 99 66 The new rate can be Daily Hourly or Each Scn WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES None Command sent to the XL Response sent to the host system gt EMAILSENDRATE Each Scn CRLF EMAILSENDHEADERS Read the e mail modem send headers flag If this flag is set headers will be included with each e ma
23. Appendix C Remote Operation Command Mode Rev 1 01 C 1 Command Interface All communications with the XL are through a command interface using the RS 232 Serial Port Commands are used to setup monitor and control the XL To access the command interface the XL must be connected to a computer that is running some terminal program The terminal program must use the following terminal and communication settings BAUD RATE 9600 DATA BITS 8 STOP BITS 1 PARITY N DUPLEX FULL TERMINAL EMULATION VT52 When the computer is connected and ready to communicate pressing the ENTER key will cause the command interface prompt to be displayed This prompt is an arrow gt on the left side of the screen It may take a couple of key presses to wake up the XL Once the prompt is displayed the XL is ready to receive commands If no commands are received in a two minute time period the XL will turn off automatically returning to a low power mode The command interface is best suited for communications with other computer equipment The command interface allows a user to easily develop his her own custom interface or for RS 232 devices to access the XL inputs and outputs For human interaction with the XL the menu interface is normally used as discussed in chapter 3 This chapter will give a detailed description of the commands used by the command interface All commands must be terminated with a carriage return
24. DIGITAL1ITRIGGERTYPE Command sent to the XL Digital 1 Trigger Type Always r r Response from the XL DIGITALnTRIGGERTYPE Write the trigger type of the n digital channel The trigger type determines the way in which the value of the trigger source is compared to the trigger point There are two digital channels so n can be either 1 or 2 For the trigger type this command expects an ASCII string The trigger type can be Always gt Set Pt or lt Set Pt None gt DIGITALITRIGGERTYPE gt Set Pte Command sent to the XL Cele Response from the XL DIGITALnTRIGGERPOINT Read the trigger point of the n digital channel The trigger point is compared to the value of the trigger source and if the comparison meets the condition specified by the trigger type the channel is activated There are two digital channels so n can be either 1 or 2 An ASCII string containing a real number is returned for the trigger point WATERL G XL SERIES Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES gt DIGITALITRIGGERPOINT lt Command sent to the XL Digital 1 Trigger Point 5 75 R Response from the XL DIGITALnTRIGGERPOINT Write the trigger point of the n digital
25. Example WATERL G XL SERIES Command sent to XL Response from XL gt REMOTEDISPLAYLABEL lt Remote Display Label WtrLvl Rte REMOTEDISPLAYLABEL XXXXxXX Set the remote display label This label will be printed with the data value on the display The XL expects an ASCII string for the new label This label is 8 characters in length None Command sent to the XL Response from the XL gt REMOTEDISPLAYLABLE Stage lt sb REMOTEDISPLAYSOURCE Read the source of the data to be sent to the remote display None The source assigned to the remote display e g Stage PSI Temp Command sent to XL Response from XL gt REMOTEDISPLAYSOURCE lt Remote Display Source StageR REMOTEDISPLAYSOURCE XXXXxX Set the source assigned to the remote display The XL expects an ASCII string for the new source e g Stage PSI Temp None Command sent to the XL Response from the XL gt REMOTEDISPLAYSOURCE PSI Cp Le Remote Operation Command Mode C 39 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 40 Remote Operation Command Mode EMAIL Read the e mail modem enable flag Setting this flag enables support for the H
26. LERT radio type can be either HS 3210 or H 3400 None Command sent to XL Response from XL gt ALERTRADIOTYPE H 3400 lt Cp Le ALERTnSOURCE Read the source for the n ALERT alarm n ranges from 1 5 The source can be any input source such as Stage Batt Temp etc Remote Operation Command Mode C 45 Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 46 Remote Operation Command Mode Command sent to XL Response from XL gt ALERT1SOURCE lt ALERT 1 Source Stagelr ALERTnSOURCE XXXXX Set the source for the n ALERT alarm The source can be any input source such as Stage Batt Temp etc None Command sent to XL Response from XL gt ALERT2SOURCEH PSI Goi ALERTnID Read the ID for the n ALERT alarm n ranges from 1 5 The ID is a four digit integer Command sent to XL Response from XL gt ALERT ALERT 1 ID ID 0123 R e ALERTnID XXXX Set the ID for the n ALERT alarm n ranges from 1 5 The ID is a four digit integer None Command sent to XL Response from XL gt ALERT21ID 4321 lt Cp Le ALERTnMAXRANGE Read the
27. NNING Reads the scanning flag This value determines whether or not the XL is set to scan None The response will be either the ON or OFF gt SCANNING OFFERLE Command sent to the XL Response sent to the host system SCANNING XXX Set the scanning flag This flag can be set to either ON or OFF None Command sent to the XL Response from the XL gt SCANNING ON Cp Le SCANRATE Read the current scan rate interval None An ASCII text string is returned with the time formatted as hh mm ss The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt SCANRATE lt 00 00 30 Rlr SCANRATE hh mm ss Set the time interval for the scanning operation Keep in mind that the scan rate should be as fast as or some multiple faster than the report intervals See the note at the end of this section Remote Operation Command Mode C 21 Parameters Response Example Command Description Parameters Response Examples Command Description Parameters Response Examples Command Description Parameters C 22 Remote Operation Command Mode 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 chara
28. NTERNALDATA to get the names of the files in internal data memory None See DUMPDATACARDFILE above See DUMPDATACARDFILE above COPYDATATOCARD 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 If files already exist with A then B is used and so on None The XL reports each file being copied It gives the name before and after renaming gt COPYDATATOCARD Command sent to XL Copying Site_ID 000 gt Site_ID AOOR Response from XL Copying Site_ID 001 gt Site_ID A0i Response from XL Copying Site_ID 002 gt Site_ID A02 R Response from XL ERLE Response from XL DATACARDBYTESUSED Calculates the total number of bytes used on the data card This number reflects the total space used on the card None The response will be an ASCII string representing the number of bytes used Command sent to the XL Response from the XL gt DATACARDBYTESUSED lt Data Card Bytes Used 20311R F Remote Operation Command Mode C 19 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 20 Remot
29. NTROL HW lt Cpe CHARACTERDELAY Read the delay that the XL puts between sending characters out the serial communications port None An ASCII text string is returned with the character delay The character delay is and integer between 0 and 999 The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt CHARACTERDELAY lt Character Delay Ott CHARACTERDELA Y XXX Set the character delay The character delay is how long the XL delays in milliseconds between sending characters out the serial communications port This command accepts an integer between 0 and 999 None use the CHARACTERDELAY command to see the new value Command sent to the XL Response from the XL gt CHARACTERDELAY 50 lt Cale LINEFEEDELAY Read the line feed delay The XL waits this amount of time in milliseconds after each line feed it sends out the serial communications port None 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 Command sent to the XL Response sent to the host system gt LINEFEEDDELAY lt Line Feed Delay Olle WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example LINEFEEDDELAY XXX Se
30. RATUREUNITS Get the units in which temperature is being reported This will be either Deg C for Celsius or Deg F for Fahrenheit None An ASCII string representing the temperature units is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt TEMPERATUREUNITS lt Temperature Units Deg FERE TEMPERATUREUNITS XXXxX Set the units in which temperature is being reported This can be either Deg C for Celsius or Deg F for Fahrenheit This command accepts an ASCII string of either Deg C or Deg F None Command sent to XL Response sent to the host system gt TEMPERATUREUNITS Deg Fea Cp Le COUNTERTOTAL Read the total event counter variable Reading the counter will not clear it Remote Operation Command Mode C 25 Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 26 Remote Operation Command Mode None The response is an ASCII text string representing a value between 0 and 65535 The response will be followed by a carriage return line feed Command sent to the XL Response sent to the host system gt COUNTERTOTAL lt Counter Total 124s COUNTERTOTAL XXXXX Set the counter to
31. Response sent to the host system gt GOESSTRATE 00 08 00 lt Cale Remote Operation Command Mode C 55 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 56 Remote Operation Command Mode GOESSTOFFSET Read the Self Timed transmission offset This is a time value indicating how long after midnight the first transmission takes place None An ASCII text string is returned in the format of hh mm ss Command sent to the XL Response sent to the host system gt GOESSTOFFSET lt GOES ST Offset 00 02 00RF GOESSTOFFSET hh mm ss Set the transmission offset for the Self Timed mode of the GOES radio The new offset is to be entered in the format of HH MM SS where H is hours M is minutes and S is seconds None Command sent to the XL Response sent to the host system gt GOESSTOFFSET 00 03 00 lt Cale GOESSTFORMAT 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 None An ASCII text string is returned indication the format Command sent to the XL Response sent to the host system gt GOESSTFORMAT GOES ST Format BINARYERbF GOESSTFORMAT XXXXxXX Set the data format for the Self Timed mode of the GOES ra
32. action Chapter 3 is devoted completely to this command None None gt MENU Command sent to the XL The logger displays a menu structure on the host systems terminal screen TESTSCAN This command causes the XL to execute the scan list Any values returned will depend on the scan list If the scan list utilizes the scan list command TXA then the value in the A register will be returned See the description for the TXA command in chapter 7 for more information on possible uses None The response will vary based on the scan list commands The response may or may not be terminated with a carriage return line feed Suppose the scan list commands were as follows SDIM 3 read SDI12 sensor at address 3 TXA it has 3 parameters send the first value PULL put next value in the A register TXA transmit the second value PULL put the third value in the A register TXA send the third value TCR send a carriage return and line feed Now if the SCN command was sent to the logger gt TESTSCAN Command sent to the XL 23 153 459 21 9 1388 R t Response sent to the host system WATERLO G XL SERIES Remote Operation Command Mode C 71
33. ameters Response Example WATERL G XL SERIES Command sent to the XL Response sent to the host system gt AUTOPURGE lt Auto Purge No Rr AUTOPURGE XXX Set the Auto Purge flag The flag can be set to either Yes or No None Command sent to the XL Response sent to the host system gt AUTOPURGE YES lt Cale TIMEDPURGE Read the Timed Purge value Based on this value the XL will trigger an automatic purge If set to 1 the XL purges the bubbler daily if set to 2 the XL will purge every 2 days if set to 3 every 3 days and so on If this value is set to 0 the XL will not purge the bubbler on a timed basis None An ASCII text string is returned indicating the timed purge interval in days Command sent to the XL Response sent to the host system gt TIMEDPURGE lt Timed Purge 1R TIMEDPURGE XXX Set the Timed Purge value This is the number of days between automatic purges If this value is set to 0 the XL will not trigger a timed purge The new timed purge value in days None Command sent to the XL Response sent to the host system gt TIMEDPURGE 2 lt Cale Remote Operation Command Mode C 69 Command Description Parameters Response Example LASTPURGE Read the time at which the H 355 last purged None An ASCII text string is returned indicating the time of the most recent purge Command sent
34. cter as shown above Note the space between the command and the parameter None use the SCANRATE command to see the new value Command sent to the XL This sets the scan rate to force a scan once every minute Response sent to the host system gt SCANRATE 00 01 00 lt Cale NEXTSCAN Get the amount of time until the next scan None The response will be an ASCII string in the format of HH MM SS indicating the amount of time until the next scan Command sent to the XL Response sent to the host system gt NEXTSCAN lt 00 14 59 R F NEXTSCANAT Get the scheduled time of the next scan None The response will be an ASCII string in the format of HH MM SS Command sent to the XL Response sent to the host system gt NEXTSCANAT lt 16230 00 NEXTSCANAT hh mmiss Set the time at which the XL will performs its next scan The format for the time is HH MM SS The time ranges from 00 00 00 to 23 59 59 WATERL G XL SERIES Response Examples None Command sent to the XL Response sent to the host system gt NEXTSCANAT 12 00 00 lt Cp Le C 6 Sensor Input Commands Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response WATERL G XL SERIES STAGE Get a reading from the internal pressure sensor None An ASCII string representing the stage
35. dio The new format can be either BINARY or SHEF WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES None Command sent to the XL Response sent to the host system gt GOESSTFORMAT SHEF lt Cale GOESSTORDER Read the Self Timed transmission data order This is the order in which the data is transmitted The order can be either SCAN or CHANNEL None An ASCII text string is returned indication the format Command sent to the XL Response sent to the host system gt GOESSTORDER lt GOES ST Order SCAN rte GOESSTORDER XXXXXX Set the data order for the Self Timed mode of the GOES radio The new order can be either CHANNEL or SCAN None Command sent to the XL Response sent to the host system gt GOESSTORDER CHANNEL Cale GOESSTSENDSHEFCODES Read the send SHEF codes flag If this is set to YES each self timed GOES transmission will include SHEF code column headers None An ASCII text string is returned consisting of either Yes or No Command to XL Response from XL gt GOESSTSENDSHEF CODES GOES ST Send SHEF Codes No rie Remote Operation Command Mode C 57 Command Description
36. e Operation Command Mode DATACARDBYTESFREE Calculates the total number of bytes free on the data card This number reflects the total space free on the card None The response will be an ASCII string representing the number of bytes free Command sent to the XL Response from the XL gt DATACARDBYTESFREE lt Data Card Bytes Free 9710234 Rte INTERNALDATABYTESUSED Calculates the total number of bytes used in internal memory This number reflects the total space used in the internal memory None The response will be an ASCII string representing the number of bytes used Command sent to XL Response from XL gt INTERNALDATABYTESUSED lt 710234 Rte Internal Data Bytes Used INTERNALDATABYTESFREE Calculates the total number of bytes free in internal memory This number reflects the total space free in the internal memory None The response will be an ASCII string representing the number of bytes free Command sent to XL Response from XL gt INTERNALDATABYTESFREE 9710234 Rte Internal Data Bytes Free WATERL G XL SERIES C 5 Scanning Commands Command Description Parameters Response Examples Command Description Parameters Response Example Command Description Parameters Response Example Command Description WATERL G XL SERIES SCA
37. e from XL gt GOESRRTRIGGERPOINT lt GOES RR Trigger Point 2 5 Rte GOESRRTRIGGERPOINT XXXXX Set the RR trigger point The XL accepts a real number represented in ASCII text format None gt GOESRRTRIGGERPOINT 3 3 Command sent to XL ERLE Response from XL GOESRRFORCEXMIT Immediately forces a GOES random report transmission None None Command sent to the XL Response from XL gt GOESRRFORCEXMIT lt Cale GOESRRBUFFERCOUNT Counts the number of bytes currently in the GOES random report buffer None WATERL G XL SERIES Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 11 Bubbler Command Description Parameters Response Example WATERL G XL SERIES An ascii text string is returned with an integer number representing the buffer count Command sent to the XL Response from XL gt GOESRRBUFFERCOUNT lt GOES RR Buffer Count 232 R GOESRRCOLUMNnSOURCE Read the source of the n column of data to be sent in the GOES random report transmission n can range from 1 5 indicating the corresponding column The source of the column corresponding to n e g Stage PSI Temp Command sent to XL Response from XL gt GOESRRCOLUMN2SOURCE lt GOES RR Column 2 Source Date r
38. e of the n data column of the self timed GOES transmission n ranges from 1 20 The XL expects the new source of the data column corresponding to n e g Stage PSI Temp None Command sent to the XL Response from the XL gt GOESSTCOLUMN15SOURCE Temp lt Eat GOESSTCOLUMNnSHEFCODE Read the SHEF code of the n column of data to sent in the GOES self timed transmission The SHEF code is included as a description of the value The SHEF code pneumonics are pre defined See GOES section for details n can range from 1 20 The response is an ASCII text string with the SHEF code for the n column Command Response gt GOESSTCOLUMN1 SHEFCODE lt GOES ST Column 1 SHEF Code SH Rr GOESSTCOLUMNnSHEFCODE XX Set the SHEF code for the n column of self timed GOES data n ranges from 1 20 None Command sent to the XL Response from the XL gt GOESSTCOLUMN3SHEFCODE DT lt Cp Le WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters WATERL G XL SERIES GOESSTCOLUMNnSKIPRATE Read the skip rate for the n column of GOES self timed data The skip rate determines how often this value is generated in the data A skip rate of 1 means the value wil
39. e warm up delay of the n digital channel The warm up delay is the amount of time in milliseconds that the digital channel waits before beginning an input or output There are two digital channels so n can be either 1 or 2 An ASCII string containing an integer number is returned for the warm up delay gt DIGITALIWARMUPDELAY lt Command sent to the XL Digital 1 Warm Up Delay 200 t Response from the XL DIGITALnWARMUPDELAY Write the warm up delay of the n digital channel The warm up delay is the amount of time in milliseconds that the digital channel waits before beginning an input or output There are two digital channels so n can be either 1 or 2 The command accepts an integer number for the warm up delay None gt DIGITAL1IWARMUPDELAY 150 lt Command sent to the XL ERE Response from the XL C 8 SDI 12 Commands Command Description Parameters Response Example C 34 Remote Operation Command Mode SDITESTADDRESS Read the address that the XL uses when issuing SDI 12 commands None An ASCII text string is returned with the address Command sent to the XL Response from the XL gt SDITESTADDRESS lt SDI Test Address 1 ERLE WVATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Desc
40. etecting a random trigger None An ASCII text string is returned in the format of hh mm ss gt GOESRRRATE lt GOES RR Rate Command sent to the XL 00 00 30 Response sent to the host system GOESRRRATE hh mm ss Set the transmission rate for the random report mode of the GOES radio 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 None gt GOESRRRATE 00 01 00 lt Cale Command sent to the XL Response sent to the host system GOESRRTRIGGERMODE Read the current mode of random report operation of the GOES radio This value along with trigger source determines what conditions are checked when evaluating whether or not to generate a GOES random report None An ASCII text string is returned The response will be Always gt Set Pt lt Set Pt or Delta See GOES section for details gt GOESRRTRIGGERMODE lt GOES RR Trigger Mode Command sent to XL Always rer Response from XL WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES GOESRRTRIGGERMODE XXXXxX Set the current mode of GOES radio random report operation The flag can be set to Always gt Set Pt lt Set Pt or Del
41. il transmission None An ASCII text string is returned with either On or Off Command sent to the XL Response from the XL gt EMAILSENDHEADERS Email Send Headers Off Rl EMAILSENDHEADERS XXX Set the e mail modem send headers flag If this flag is set headers will be included with each e mail transmission The flag can be set to either On or Off None gt EMAILSENDHEADERS ON Command sent to the XL Pate Response from the XL EMAILSENDSITEID Read the e mail modem send site ID flag If this flag is set the site ID will be included with each e mail transmission None An ASCII text string is returned with either On or Off gt EMAILSENDSITE Email Send Site ID Command sent to the XL Response from the XL Dies off tte Remote Operation Command Mode C 41 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description C 42 Remote Operation Command Mode EMAILSENDSITEID XXX Set the e mail modem send site ID flag If this flag is set the site ID will be included with each e mail transmission The flag can be set to either On or Off None gt EMAILSENDHSITEID ON Command sent to the XL B
42. l be in each row of data A skip rate of 4 means the value will be in every 4 row of data n can range from 1 20 The response is an ASCII text string with the skip rate for the n column Command Response gt GOESSTCOLUMNI1SKIPRATE lt GOES ST Column 2 Skip Rate 4RLE GOESSTCOLUMNnSKIPRATE XX Set the skip rate for the n column of self timed GOES data n ranges from 1 20 None Command sent to the XL Response from the XL gt GOESSTCOLUMNISKIPRATE 1 lt Cp Le GOESRRCHANNEL Read the channel to be used for GOES random transmissions None An ASCII text string is returned with the channel Command sent to the XL Response sent to the host system gt GOESRRCHANNEL lt GOES RR CHANNEL 123 R GOESRRCHANNEL XXX Set the channel for random transmissions of the GOES radio The channel is a 3 character decimal value ranging from 000 200 Remote Operation Command Mode C 61 Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 62 Remote Operation Command Mode None gt GOESRRCHANNEL 111 lt Cale Command sent to the XL Response sent to the host system GOESRRRATE Read the random transmission rate This determines the window during which the GOES radio will transmit after d
43. le Remote Operation Command Mode C 67 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response C 68 Remote Operation Command Mode TANKPSI Read the tank pressure in the H 355 None An ASCII text string representing the current tank pressure Command sent to the XL Response sent to the host system gt TANKPSI Tank PSI 24 35 LINEPSI Read the line pressure in the H 355 None An ASCII text string representing the current line pressure gt LINEPSI Command sent to the XL Line PSI 18 0 Response sent to the host system PURGENOW Force the H 355 to purge immediately None None Command sent to the XL Response sent to the host system gt PURGENOW Cale AUTOPURGE Read the Auto Purge flag The XL can trigger a purge when the H 355 pressure gets to a certain point See Also Purge Threshold None An ASCII text string is returned indicating whether or not the XL will trigger the H 355 to purge at the purge threshold The response is either Yes or No WATERL G XL SERIES Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Par
44. lue for the e mail e g Stage PSI Temp None gt EMAILTRIGGERSOURCE PSI Command sent to the XL ERLE Response sent to the host system EMAILTRIGGERMODE Read the current mode of operation of the H 260 e mail modem This value along with trigger source determines what conditions are checked when evaluating whether or not to send an e mail message None An ASCII text string is returned The response will be Always gt Set Pt lt Set Pt or Delta Command sent to XL Response from XL gt EMATLTRIGGERMODE lt Email Trigger Mode Always Cale EMAILTRIGGERMODE XXXXXX Set the current mode of email operation The flag can be set to Always gt Set Pt lt Set Pt or Delta None Remote Operation Command Mode C 43 Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 44 Remote Operation Command Mode gt EMAILTRIGGERMODE gt Set Pte Command sent to XL Ente Response from XL EMAILTRIGGERPOINT Read the trigger point for the e mail condition check The value indicated by the e mail trigger source is compared to this value Depending on the e mail trigger mode different comparisons will be made If the trigger conditions are met an e
45. mail message is generated None An ASCII text string is returned with a real number indicating the trigger point Command sent to XL Response from XL gt EMA Email LTRIGGERPO Trigger Point NT 2 5 Rte EMAILTRIGGERPOINT XXXXX Set the e mail trigger point The XL accepts a real number represented in ASCII text format None gt EMAILTRIGGERPOINT 3 3 Command sent to XL Cele Response from XL ALERT Read the flag enabling the ALERT radio None The ALERT flag can be either On or Off Command sent to XL Response from XL gt ALERT ALERT Off Rte WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response WATERL G XL SERIES ALERT XXX Set the flag enabling or disabling the ALERT radio The XL accepts a value of either On or Off None Command sent to XL Response from XL gt ALERT O0On Ete ALERTRADIOTYPE Read the ALERT radio type None The ALERT radio type can be either HS 3210 or H 3400 Command sent to XL Response from XL gt ALERTRADIOTYPE ALERT Radio Type HS 3210 R r ALERTRADIOTYPE XXXXXXX Set the ALERT radio type The A
46. mmand sent to the XL Response from the XL gt GOESRRCOLUMN3HEADER Log Column 3 Header WaterLvl R LOGCOLUMNnHEADER XXXXXXxXX Set the n column header n ranges from 1 25 The new column header can be up to 8 characters of ASCII text If the value is shorter that 8 characters it will be padded on the right side with spaces so the length equals 8 None gt LOGCOLUMN4HEADER Temp C Command sent to the XL Cele Response from the XL LOGCOLUMNnSKIPRATE Read the skip rate for the n column of data being logged to the card The skip rate determines how often this value is generated in the data A skip rate of 1 means the value will be in each row of data A skip rate of 4 means the value will be in every 4 row of data n can range from 1 25 Remote Operation Command Mode C 51 Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 52 Remote Operation Command Mode The response is an ASCII text string with the skip rate for the n column Command sent to the XL Response from the XL gt LOGCOLUMN2SKIPRATE Log Column 2 Skip Rate 4R LOGCOLUMNnSKIPRATE XxX Set the skip rate for the n column of data to be logged to the flash card n ranges from 1 25 None Command sent to the XL
47. n Command Mode ceccccce 8 character vendor identification to be specified by the vendor and usually in the form of a company name or its abbreviation mmmmmm 6 character field specifying the sensor model number VW 3 character field specifying the sensor version number XX XX variable length field up to a maximum of 13 to be used for serial number or other specific sensor information not relevant to the operation of the data recorder gt SDIIDENTIFY Command sent to XL 112 DAA H 415vvvS 123456V101 Rr Response from XL SDIVERIFY Issue a verify command on the SDI 12 bus using the address specified by SDITESTADDRESS None 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 verify command depends on the manufacturer of the sensor Consult the documentation for the sensor for further information gt SDIVERIFY lt Command sent to XL 11234 RI Response from XL SDIMEASURE Issue a measure command on the SDI 12 bus using the address specified by SDITESTADDRESS None 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 WATERL G XL SERIES Example Command Description Paramete
48. ne Command sent to the XL Response sent to the host system gt COUNTERSLOPE 1 0 lt Cp Le SUMINTERVAL Read the sum interval This interval is the amount of time after which the XL resets COUNTERSUM None The response is an ASCII text string representing the sum interval The format of the sum interval is HH MM SS Command sent to the XL Response sent to the host system gt SUMINTERVAL lt Sum Interval 04 00 00 R SUMINTERVAL hh mm ss Set the sum interval Remote Operation Command Mode C 27 Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameter Response Example C 28 Remote Operation Command Mode This format for the new sum interval is HH MM SS None Command sent to the XL Response sent to the host system gt SUMINTERVAL 01 00 00 lt Cale COUNTERMODE Read the counter mode None The response is an ASCII text string representing the counter mode The response will be followed by a carriage return line feed Command sent to the XL Response sent to the host system gt COUNTERMODE lt Counter Mode Off Cale COUNTERMODE XXXXX Set the counter slope This value scales raw counts to the value given to the user This command accepts an ASCII string representing the new slope value None
49. ng a carriage return line feed Command sent to the XL Response sent to the host system gt BAUDRATE lt Baud Rate 9600 RLF BAUDRATE XXXX Set the baud rate for the serial communications port Any of the following are valid baud rate parameters 300 1200 2400 4800 9600 and 19 2 None use the BAUDRATE command to see the new value Command sent to the XL Response from the XL gt BAUDRATE 1200 lt Cp Le FLOWCONTROL Read the flow control setting for the serial communications port None An ASCII text string is returned with the flow control The flow control can be None HW SW or Both The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt FLOWCONTROL lt Flow Control Nonelr FLOWCONTROL XXXX Set the flow control for the serial communications port There are 4 valid flow control settings None HW SW and Both None use the FLOWCONTROL command to see the new value Remote Operation Command Mode C 11 Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 12 Remote Operation Command Mode Command sent to the XL Response from the XL gt FLOWCO
50. ple Command Description Parameters Response Example Command Description Parameters Response Example WATERL G XL SERIES Command sent to the XL Response from the XL gt GOESSTSCANSPERXMIT lt GOES ST Scans Per Xmit 16 Rtr GOESSTSCANSPERXMIT XXX Set the number of scans per transmission None Command sent to the XL Response sent to the host system gt GOESSTSCANSPERXMIT 32 lt ale GOESSTBUFFERCOUNT Counts the number of bytes currently in the GOES self timed buffer None An ascii text string is returned with an integer number representing the buffer count Command sent to the XL Response from XL gt GOESSTBUFFERCOUNT lt GOES ST Buffer Count 512 R GOESSTCOLUMNnSOURCE Read the source of the n column of data to be sent in the GOES self timed transmission n can range from 1 20 indicating the corresponding column The source of the column corresponding to n e g Stage PSI Temp Command sent to XL Response from XL gt GOESSTCOLUMN2SOURCE lt GOES ST Column 2 Source Date RH Remote Operation Command Mode C 59 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 60 Remote Operation Command Mode GOESSTCOLUMNnSOURCE XxxxxxX Set the sourc
51. put and which type 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 gt DIGITALIMODE Command sent to the XL C 30 Remote Operation Command Mode 1 Mode Digital Digital Input R Response from the XL WATERL G xL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response WATERL G XL SERIES DIGITALnMODE Write the operation mode of the n digital channel The mode determines whether the channel is an input or output and which type There are two digital channels so n can be either 1 or 2 For the mode this command expects an ASCII string 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 None gt DIGITALIMODE Trigger Pulses Command sent to the XL Cate Response from the XL DIGITALnTRIGGERSOURCE Read the trigger source for the n digital channel This is the source of the value which is compared against the trigger point The
52. re are 5 status values 1 5 The specific status value is determined by n The XL scans the n status value and returns it Command sent to XL Response sent to the host system gt STATUS2VALUE lt Status 2 Value 23 41 C 4 Data File Commands Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters WATERL G XL SERIES ERASEDATACARD Format the flash card in the card slot This is an irreversible process None None gt ERASEDATACARD Command sent to XL Cale Response sent to the host system ERASEINTERNALDATA Format the internal flash memory This is an irreversible process None None Command sent to XL Response sent to the host system gt ERASEINTERNALDATA Cp Le DIRDATACARD Get a list of the files on the data card None Remote Operation Command Mode C 17 Response Example Command Description Parameters Response Example Command Description Parameters Response Example C 18 Remote Operation Command Mode The response is a list of files in the following format ffffffffieee sssssssss mm dd yy hh mm Where ffffffff eee is the filename in an 8 3 format sssssssss is the filesize mm dd yy is the file date and hh mm is the file time gt DIRDATACARD Command sent to XL
53. re are two digital channels so n can be either 1 or 2 An ASCII string is returned containing the source The source can be Stage PSI Temp etc Command sent to XL Response from XL gt DIGITALITR Digital 1 GGERSOURCE lt Trigger Source Stage DIGITALnTRIGGERSOURCE Write the trigger source of the n digital channel The mode determines whether the channel is an input or output and which type 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 PSP Temp etc None Remote Operation Command Mode C 31 Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response C 32 Remote Operation Command Mode gt DIGITALITRIGGERSOURCE Stagee Command sent to XL Ente Response from XL DIGITALnTRIGGERTYPE Read the trigger type of the n digital channel The trigger type determines the way in which the value of the trigger source is compared to the trigger point There are two digital channels so n can be either 1 or 2 An ASCII string is returned containing the trigger type The trigger type can be Always gt Set Pt or lt Set Pt gt
54. ription Parameters Response WATERL G XL SERIES SDITESTADDRESS x Set the address that the XL uses when issuing SDI 12 commands The address can be 0 9 or A Z None Command sent to the XL Response from the XL gt SDITESTADDRESS 1 lt Cp Le SDIACKNOWLEDGE Issue an acknowledge command on the SDI 12 bus using the address specified by SDITESTADDRESS None The XL takes the response it receives on the SDI 12 bus and returns it In the case of the acknowledge command an SDI 12 sensor will respond with its address If no response is received the XL responds with Communication Timed Out Command sent to the XL Response from the XL gt SDIACKNOWLEDGE lt 1 ERLE SDITDENTIFY Issue an identify command on the SDI 12 bus using the address specified by SDITESTADDRESS None 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 allecccceccmmmmmmvvvxx XX a sensor address 0 9 A Z a z Il SDI 12 version compatibility level e g version 1 2 is represented as 12 Remote Operation Command Mode C 35 Example Command Description Parameters Response Example Command Description Parameters Response C 36 Remote Operatio
55. rs Response Example Command Description Parameters atttn a sensor address 0 9 A Z a z ttt 3 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 n single digit integer 0 9 specifying the number of values that will be placed in the data buffer If n is zero 0 no data will be available using subsequent D commands gt SDIMEASURE Command sent to the XL 10022 Rle Response from the XL SDIDATAn Issue a data command on the SDI 12 bus using the address specified by SDITESTADDRESS n is an integer specifying which data command to issue DATAO DATA etc 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 data command is as follows TXX XXXTY VVV X XXX channel A voltage y yyy channel B voltage gt SDIDATA0 lt Command sent to the XL 1 234 9 876 Re Response from the XL SDIEXTENDED lt command gt Issue an extended command on the SDI 12 bus using the address specified by SDITESTADDRESS command is the command that is to be issued on the SDI 12 bus It needs to be a valid SDI 12 command WATERL G XL SERIES Remote Operation Command Mode C 37 Response Example
56. s Response from the XL EMAILALARMS Read the e mail modem alarms flag If this flag is set the alarm conditions will be evaluated during each scan to determine whether or not to send an e mail message None An ASCII text string is returned with either On or Off Command sent to the XL Response from the XL gt EMATLALARMS lt Email Alarms Off Rr EMAILALARMS XXX Set the e mail modem alarms flag If this flag is set the alarm conditions will be evaluated during each scan to determine whether or not to send an e mail message The flag can be set to either On or Off None Command sent to the XL Response from the XL gt EMATLALARMS ON Cp Le EMAILTRIGGERSOURCE Read the source that will be evaluated when determining whether or not to trigger an e mail transmission WATERL G XL SERIES Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response WATERL G XL SERIES None The response will be an ASCII text string with the current e mail trigger source e g Stage PSI Temp Command sent to XL Response from XL gt EMAILTRIGGERSOURCE lt Email Trigger Source Stage PRE EMAILTRIGGERSOURCE XXXxxX Set the e mail trigger source The new trigger source va
57. scription Parameters Response WATERL G XL SERIES None An ASCII string representing the battery voltage in volts is returned The response is terminated with a carriage return line feed gt BATTMAX lt 13 3 RbF Command sent to XL Response sent to the host system SYSTEMRESETS The XL keeps track of the number of times it has been reset These resets could have been caused by power failures or watchdog resets This command reads that value None An ASCII string representing the number of system resets is returned The response is terminated with a carriage return line feed Command sent to XL Response sent to the host system gt SYSTEMRESETS lt 3ERLE RESETSTATUSVALUES This command causes the XL to reset the status values This includes the reset counter the max battery and the min battery None None gt RESETSTATUSVALUES lt Command sent to XL Cale Response sent to the host system STATUSnSOURCE The status values are a way to get quick access to certain values This reads the source of an individual status value There are 5 status values 1 5 The specific status value is determined by n The source of the status value corresponding to n e g Stage PSI Temp Remote Operation Command Mode C 15 Example Command Description Parameters Response Example Command Description Parameters Response Example
58. sent date in the real time clock The input is tested for proper values 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 Example Command Description Parameters Response Example WATERL G XL SERIES None use the DATE command to see the new value Command sent to the XL This sets the current date to March 21st 2006 gt DATE 03 21 06 lt SITEID Read the Site ID The Site ID is the text description of the site It is 8 characters in length None An ASCII text string is returned with the Site ID formatted as XXXXXXXX The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt SITE SiteID RIVERI Dee Cale Remote Operation Command Mode C 9 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description C 10 Remote Operation Command Mode SITEID XXXXXXXX Set the site ID The Site ID is the text description of the site It is 8 characters in length The site ID gets assigned to the entered text If the text is shorter than 8 characters the site ID will be padded with spaces None use
59. t system gt GOESMODE RANDOM lt Cp Le GOESADDRESS Read the 8 hexadecimal character DCP address that the GOES radio uses to interface with the collection satellite None 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 sent to the XL Response sent to the host system gt GOESADDRESS lt GOES Address 14C028AFERbF Remote Operation Command Mode C 53 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 54 Remote Operation Command Mode GOESADDRESS XXXXXXXX Set the GOES DCP address The address is to be 8 characters long Each character ranges from 0 9 A F None Command sent to the XL Response sent to the host system gt GOESADDRESS 02A488C5 lt Cole GOESTIME Read the time from the GOES radio This time is used to synchronize with the satellite None An ASCII text string is returned with the GOES time Command sent to the XL Response sent to the host system gt GOESTIME lt GOES Time 17 42 25 R GOESTIME hh mm ss Set the time of the GOES radio 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 None Command sent to the
60. t the character delay The character delay is how long the XL delays in milliseconds between sending characters out the serial communications port There are 4 valid flow control settings None HW SW and Both None use the LINEFEEDDELAY command to see the new value gt LINEFEEDDELAY 50 Cale Command sent to the XL Response from the XL RESETDEFAULTS This command is used to force the unit to run through the power up sequence This will cause the unit to reinitialize some of the system variables initialize the real time clock and then turn off The ENTER key must be pressed a few times again to wake up the unit This has the same effect as if the power is removed and then restored None None Command sent to the XL gt RESETDEFAULTS lt C 3 Status Commands Command Description Parameters Response Example WATERL G XL SERIES FIRMWAREVERSION Read the XL s firmware version number None The response is an ASCII text string showing the version number followed with a carriage return line feed See the example below Command sent to the XL Response sent to the host system gt FIRMWAREVERSION lt Firmware Version 1 00 Rr Remote Operation Command Mode C 13 Command Description Parameters Response Example Command Description Parameters Response Example Command
61. ta None Command sent to XL Response from XL gt GOESRRTRIGGERMODE gt Set Pte Cale GOESRRTRIGGERSOURCE Read the source that will be evaluated when determining whether or not to trigger a random report None The response will be an ASCII text string with the current RR trigger source e g Stage PSI Temp Command sent to XL Response from XL gt GOESRRTRIGGERSOURCE lt GOES RR Trigger Source Stage Rr GOESRRTRIGGERSOURCE XXXxXxX Set the GOES random report trigger source The new trigger source value for the random report e g Stage PSI Temp None Command sent to the XL Response sent to the host system gt GOESRRTRIGGERSOURCE PSI Cale Remote Operation Command Mode C 63 Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters C 64 Remote Operation Command Mode GOESRRTRIGGERPOINT Read the trigger point for the GOES random report The value indicated by RR source is compared to this value Depending on the RR trigger mode different comparisons will be made If the trigger conditions are met a random report is generated None An ASCII text string is returned with a real number indicating the trigger point Command sent to XL Respons
62. tal to a specific value The range for the counter total is 0 65535 None Command sent to the XL Response sent to the host system gt COUNTERTOTAL 100 lt Cale COUNTERSUM Read the counter sum Reading the counter will not clear it None The response is an ASCII text string representing a value between 0 and 65535 Command sent to the XL Response sent to the host system gt COUNTERSUM lt Counter Sum 124 Rr COUNTERSUM XXXxXX Set the counter sum to a specific value The range for the counter sum is 0 65535 None Command sent to the XL Response sent to the host system gt COUNTERSUM 4534 lt Cale WATERL G XL SERIES Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description WATERL G XL SERIES COUNTERSLOPE Read the counter slope This value scales raw counts to the value given to the user None The response is an ASCII text string representing the slope value The response will be followed by a carriage return line feed Command sent to the XL Response sent to the host system gt COUNTERSLOPE lt Counter Slope 0 01 Rl COUNTERSLOPE XXXXX Set the counter slope This value scales raw counts to the value given to the user This command accepts an ASCII string representing the new slope value No
63. te Operation Command Mode C 7 BUBBLER COMMANDS PURGEPSI Pressure with which the bubbler purges LINEPSI Pressure in the line C 2 System Commands Command Description Parameters Response Example Command Description Parameters TIME Read the current time None An ASCII text string is returned with the time formatted as hh mm ss The response is terminated using a carriage return line feed gt TIME Command sent to the XL Time 152372214 Response sent to the host system TIME hh mm ss 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 This command expects an input of the format hh mm ss where h is hours m is minutes and s is seconds C 8 Remote Operation Command Mode WATERLOG XL SERIES Response Example Command Description Parameters Response Example Command Description None use the TIME command to see the new value Command sent to the XL This sets the current time to 1PM 53 minutes and 45 seconds gt TIME 13 53 45 DATE Read the current date None An ASCII text string is returned with the date formatted as mm dd yy The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt DATE Date 03 21 06TRbF DATE mm dd yy Set the pre
64. the SITEID command to see the new value Command sent to the XL This sets the site ID to Site 15 gt SITEID Site 15 SDIADDRESS Read the SDI 12 sensor address This address is how the XL is identified when used as a sensor None An ASCII text string is returned with the SDI 12 address The address is a single character The response is terminated using a carriage return line feed Command sent to the XL Response sent to the host system gt SDIADDRESS SDIAddress 1 SDIADDRESS X Set the SDI 12 sensor address This address is how the XL is identified when used as a sensor The SDI 12 address gets assigned to the entered character The valid range for addresses is 0 9 and A Z None use the SDIADDRESS command to see the new value Command sent to the XL This sets the SDI 12 address to 0 gt SDIADDRESS 0 lt BAUDRATE Read the baud rate for the serial communications port WATERL G XL SERIES Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response Example Command Description Parameters Response WATERL G XL SERIES None 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 usi
65. to the XL Response sent to the host system gt LASTPURGE lt Last Purge 08 21 48 mr C 12 Miscellaneous Commands Command Description Parameters Response Example Command Description Parameters Response Example C 70 Remote Operation Command Mode OFF Turn the XL off This command is also automatically executed if there has been no user interaction for the last two minutes None The text string Off will be sent back to the host This is useful when the unit times out and turns off automatically gt OFFS Command sent to the XL OFF Rl The unit powers down to a low power mode ECHOOFF Turn off the echoing of the commands This is most useful if a user develops there own interface to the logger Not having to work with the echoing command makes the design of the custom interface much simpler To turn the echo back on use the OFF command and then turn the logger back on None None Command sent to the XL The logger will no longer echo key presses to the host system gt ECHOOFF lt WATERL G XL SERIES C 13 Advanced Commands Command Description Parameters Response Example Command Description Parameters Response Example MENU 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 inter

XL Remote Commands

Contents

Download Pdf Manuals

Related Search

Related Contents