HASSE RAIN GAUGE MODULE COMMAND SET
The following commands are available on the RS-485 communications link to the HASSE module. See "ASIMET MODULE OPERATIONS" document for instructions on how to hook up this link to your PC and RS-485 adapter.
Note: commands sent are indicated in BOLD, responses in normal text. <crlf> represents ASCII carriage return and line feed.
Command Description
A Address acknowledge
- returns address of module, terminated by <crlf>
- e.g. #HASSEA HASSE<crlf>
- NOTE: HASSE is the default address of the Rain Gauge module;
it may be changed by the 'U' command but any failure of
EEPROM will result in the use of the default address. In
addition, use of defaults is reported in the 'L' command.
C Output calibrated and raw interval mode data; switch
to 5 minute interval mode if currently in polled mode
- outputs calibrated values of rain rate in mm/hr and wind
speed in m/sec, followed by total counts for top and side
collectors and wind, then status byte (see 'S' command for
details), and interval time in seconds (fixed at 300 currently).
That is, as follows:
mm/hr, m/sec, top-count, side-count, wind-count, status, seconds <crlf>
- example:
#HASSEC 5.32, 2.33, 234, 0, 45, 0, 300<crlf>
H Help
- #HASSEH - a multiple line response with text similar to
the first line of each command description in this
document as the help line, with each line terminated
<crlf>, as follows:
A - Address acknowledge
C - Calibrated data (and goto interval mode 1)
H - Display Help message
L - Report ID, serial #, cal info
P - Counts (raw) data (and goto polled mode 0)
S - Status (status byte, elapsed time, mode)
T - Enter test mode
U - Update EEPROM constants - password 'OK'
- A,C[S,T],D,M,Q,S,WOK
L Report ID, serial #, cal info, etc.
- the 'L' command provides miscellaneous status information
about the module in a multi-line response. The number of
lines in the response may vary depending upon the
EEPROM status. Normally, after an initial <crlf>,
6 lines of info are provided, as follows:
#HASSEL
module id from EEPROM
module serial number from EEPROM
firmware name and version from program EPROM
crystal frequency from program EPROM
CT cal constant from EEPROM
CS cal constant from EEPROM
- example normal response (6 lines plus initial <crlf>):
HASSE
001
HASSE-IF v1.0
2.4576 Mhz
CT: 3.00000e-01
CS: 1.56350e-01
P Output raw polled mode data; switch to polled mode if
currently in 5 minute interval mode
- outputs total counts for top and side collectors, and wind,
then status byte (see 'S' command for details), and interval
time in seconds.
- Polling resets all counts and time to zero; i.e. the interval
between 'P' commands determines the sample interval.
- Data format is as follows:
top-count, side-count, wind-count, status, seconds <crlf>
- example:
#HASSEP 234, 0, 45, 0, 120<crlf>
S Report status
- responds with last status byte (from the PREVIOUS
interval), elapsed time of the CURRENT sample interval,
and sample mode.
- status byte format, 1 = TRUE:
bit 0 - rain detect
bit 1 - top at 8hz (failed)
bit 2 - side at 8hz (failed)
bit 3 - wide pulses (1 or more)
bit 4 - top forced 0
bit 5 - side forced 0
bit 6 - wind forced 0
bit 7 - not used
- bits 0 - 3 are not implemented in Version 1.0
- bits 4-6 are diagnostic in Version 1.0
- elapsed time is seconds from start of sample interval,
i.e. time since the last reset of the counters
- sample mode:
0 = polled mode
1 = 5 minute interval mode
- example:
#HASSES responds:
0, 123, 1<crlf>
at 123 seconds into the 5 minute interval
#HASSES responds:
32, 12, 0<crlf>
at 12 seconds into the current interval in polled mode,
and last interval reported forced 0 for side collector
counts
T Enter test mode
- responds with continuous scans of "test"
---NOT IMPLEMENTED YET---
U Update EEPROM contents
- enters the update mode after confirmation of 'OK'
'password'. New EEPROM values may be entered in this mode.
- upon initial entry, you must send the letters OK after the
command or the command is ignored, e.g. #HASSEUOK may
be sent as one. Upon receipt of the correct 'password',
the response will be OK if current parameters are valid,
or NEW if parameters have never been entered or are
suspicious (i.e. EEPROM failure or bad internal checksum).
- IMPORTANT! command letter or letters A, CS, CT, D, M,
or S, when issued followed by <cr> will respond with the
current setting. If followed by =xxxxx, where xxxxx is some
appropriate value, the EEPROM setting will be changed pending
receipt of 'WOK' command to make it permanent. Subsequent
requests for current settings will report the new value while
still in update mode. However, if update mode is exited with
'Q', the original settings of all parameters will remain intact.
- the following commands are available in EEPROM update mode:
A - module Address (1 to 5 characters)
CT - Collecter Top cal constant
CS - Collecter Side cal constant
D - Date of manufacture
M - Model info
Q - Quit without writing new info to EEPROM
S - Serial number
WOK - Write new info to EEPROM and exit
- examples:
To change the current module address:
A=HRG01<cr>
To see the address:
A<cr>
To see the current CS cal constant:
CS<cr>
To change it:
CS=1.5502<cr>
NOTE: Upon completion, the newly updated module address
will not take effect until the next reset or power-up.