VOSHPS SENSOR FRONT-END BOARD COMMAND SET
Last Modified: 21 Jun 99
The following commands are available on the RS-485 communications link to the VOSHPS board. This board may be used both as a front-end interface board in conjunction with an VOS/ASIMET C51 logger board or in a "standalone IMET-compatible module" mode.
See "ASIMET MODULE OPERATIONS" document for instructions on how to hook up this comms 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.
A Address acknowledge - returns address of module, terminated by <crlf> - e.g. #HPS01A HPS01<crlf> - NOTE 1: HPS01 is the default address of the HPS 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. - NOTE 2: All 3 ASIMET modules (HRH, PRC, SWR) based on this board expect address HPS01 only. C Output calibrated interval mode data; also switch to 1 minute interval mode if currently in polled mode - outputs most recent calibrated values of relative humidity in %, air temperature in degrees C, precipitation level in mm, and shortwave radiation in w/m^2. That is, as follows: rh%, degC, mm, w/m^2 <crlf> - example: #HPS01C 65.32, 24.33, 23.4, 453.1<crlf> H Help - #HPS01H - 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 IMET-style interval mode 1) H - Display Help message L - Report ID, serial #, cal info P - Calibrated data (and goto polled mode 0) 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 and HPS Model (All sensors, HRH only, PRC only, or SWR only) Normally, after an initial <crlf>, 8 lines of info are provided, as follows: #HPS01L module id from EEPROM module serial number from EEPROM firmware name and version from program EPROM RH% cal constant from EEPROM RHT cal constant from EEPROM PRC cal constant from EEPROM SWR cal constant from EEPROM - example normal response (8 lines plus initial <crlf>): HPS01 001 VOSHPS v1.0 RH%: 0.00000e+00 2.40000e-02 0.00000e+00 0.00000e+00 RHT: -4.00000e+01 2.50000e-02 0.00000e+00 0.00000e+00 PRC: 0.00000e+00 2.40000e-02 0.00000e+00 0.00000e+00 SWR: 1.03200e+01 4.32000e-02 0.00000e+00 0.00000e+00 - HRH, PRC, or SWR only models display only the appropriate cal constants; i.e. HRH will display only cal sets #1 and #2, and SWR or PRC will display only cal set #1. (See 'U' command). M Output first set of calibration constants (HRH, PRC, SWR models only) - returns cal set #1 values A B C D without heading, space separated (for easy access from VOS/ASIMET C51 logger board) - example: #HPS01M 0.00000e+00 2.40000e-02 0.00000e+00 0.00000e+00 N Output second set of calibration constants (HRH model only) - returns cal set #2 values A B C D without heading, space separated (for easy access from VOS/ASIMET C51 logger board) - example: #HPS01N -4.00000e+01 2.50000e-02 0.00000e+00 0.00000e+00 P Output polled mode data; also switch to polled mode if currently in 1 minute IMET-style interval mode - outputs same info as 'T' command, i.e. both calibrated and raw data, after slight delay to acquire new data. T Enter test mode - responds with continuous scans (about 1 second interval) of all 4 parameters ( 2 or 1 parameters if HRH, PRC, or SWR only) including raw counts from A/D converter, as follows: rh%, degC, mm, w/m^2 : rhcount, tmpcount, prccount, swrcount<crlf> - example: #HPS01C 65.32, 24.33, 23.4, 453.1 : 45123, 23124, 3452, 12984<crlf> - exits on receipt of ESC character. 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. #HPS01UOK 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, Cxy, D, M, or S, will respond with the current setting when issued followed by <cr> only . If followed by =xxxxx<cr>, 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) Cxy - Cal Constants, where x is set 1 to 4, and y is constant A to D 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 - Cal Constant Sets apply as follows: - All Sensors HPS model: 1 - RH% 2 - TMP 3 - PRC 4 - SWR - HRH only HPS model: 1 - RH% 2 - TMP - PRC only HPS model: 1 - PRC - SWR only HPS model: 1 - SWR - Cal constants are used in a polynomial of form: A + Bx + Cx^2 + Dx^3 - examples: To change the current module address: A=HRG01<cr> To see the address: A<cr> To see the current C2A cal constant: C2A<cr> To change it: C2A=1.5502<cr> - 'D' and 'M' only available in all-sensors configuration. - NOTE: Upon completion, the newly updated module address will not take effect until the next reset or power-up.