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.

Command Description

        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:
                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>):
                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:
                    To see the address:
                    To see the current C2A cal constant:

                    To change it:

                - '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.

Revision history: