VWNDRAIN Module Ver1.xx Command Set

file: vwndrcmd.html
15 Apr 2003

VWNDRAIN Wind Speed and Rain Detector Module V1.xx COMMAND SET

The VWNDRAIN Wind Speed and Rain Detector Module provides wind speed and rain detection for sampling systems to determine when it is OK to sample, i.e. is it too windy (or windy enough) or raining. Values are updated once per minute and available via the "C" command.

- ALL COMMANDS MUST BE TERMINATED IN CARRIAGE RETURN <cr> - don't forget! It's assumed for all commands below

Standard commands (i.e. #WDR01L<cr> to get status):

A address acknowledge
- returns address of module, terminated by <crlf>
- e.g. #WDR01A WDR01
- NOTE: WDR01 is the default address of the WNDRAIN 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.
AD[0-4] to request a sample from AD channel 0 - 4
- returns a single calibrated value from the given channel
- Example: send AD0
  - typical response: 4095.000 for 0,1,0,0 cal constants and NO input
- NOTE: cal constants 0 - 4 apply to AD channels 0 - 4
APWR[0-1][=0,1] to get or set AD channel 0 or 1 power (ON = 0, OFF = 1)
- returns the current value from the given channel
- Example: to turn AD Channel 1 power ON, send APWR1=0
  - response will be 0
C to display 1 minute data
- responds with a single line of data from most recent 60 second sample interval; wind pulses are counted over a 55 second interval, then "crunched" through a polynomial using constants from cal Set 5. The rain detector is checked at the end of the sample interval.
- outputs most recent raw pulses and calibrated value of wind speed from the RM Young cup anemometer, and rain detector status 0 or 1 (0 = RAINING)
- Firmware Ver 1.30 displays:
  - raw pulse count, calibrated wind speed, rain detect status
  - Typical response: 913 12.7 1
CAD[0-4] to display continuous AD channel conversions
- conttinuously does a new AD conversion then displays it
- outputs the calibrated result.
- Example: send CAD0
  - typical response: 4095.000 for 0,1,0,0 cal constants and NO input
CAL[0-5] to display cal constant set 0 - 5
- responds with a single line of calibration constants
- Example: send CAL5
  - typical response: 2.00000e-01 1.36360e-02 0.00000e+00 0.00000e+00

HELP displays a brief list of all the commands. Each line is terminated in "\r\n".


   Example:

   Firmware VWNDRAIN V1.30
   A - Address acknowledge
   AD[0-4] - Get AD channel
   APWR[0-1][=0,1] - Get/Set AD channel 0 or 1 power
   C - Get latest Wind Speed and Rain (0 = raining)
   CAD[0-4] - Get AD channel continuous (ESC quits)
   CAL[0-5] - Display cal constants for set 0 - 5
   H - Help
   L - Get info (serial #, firmware version, all cal constants
   T - Test (ESC to exit)
   U - Update EEPROM constants - password 'OK'
       - A,Cxy,D,M,Q,S,WOK

L lists EPROM and EEPROM settings in multiline format. On an EEPROM failure, the first line will be "\r\nDEFAULT OPERATION\r\n".
- Normal Operation:
  Instrument Address (not used)
  Serial Number
  Firmware Name and Version (from EPROM)
  Latest Checkout/Calibration Date
  Set0 cal constant from EEPROM (AD CH0)
  Set1 cal constant from EEPROM (AD CH1)
  Set2 cal constant from EEPROM (AD CH2)
  Set3 cal constant from EEPROM (AD CH3)
  Set4 cal constant from EEPROM (AD CH4)
  Set5 cal constant from EEPROM (wind speed calibration)
- Example:
```
WDR01
101
VWNDRAIN v1.30
24FEB03
Set 0: -5.76367e+05  1.75800e+01  0.00000e+00  0.00000e+00
Set 1: -5.76401e+05  1.75810e+01  0.00000e+00  0.00000e+00
Set 2:  0.00000e+00  1.00000e+00  0.00000e+00  0.00000e+00
Set 3:  0.00000e+00  1.00000e+00  0.00000e+00  0.00000e+00
Set 4: -2.01341e+04  6.12140e-01  0.00000e+00  0.00000e+00
Set 5:  1.36261e-04  2.00000e-01  0.00000e+00  0.00000e+00
```
T Test mode
- sends continuous wind pulses and speed plus rain detector status at 5 second intervals
- wind speed is a little less accurate than C command because only 5 seconds of pulses are counted then multiplied times 11 before the standard Set 5 cal constants are applied.
- ESC to quit test mode
- typical output line: 83 12.7 1
UOK enter configuration update mode (held in EEPROM)
- Commands tagged with * will respond individually with their current settings if terminated immediately with <cr>; i.e. to see the current value of Cal Constant B in Set 2, send C2A<cr>
- Remain in update mode until Q or WOK command.
- Sampling MUST be STOPPED to enter update mode.
  - * A=xxxxx to set 1 to 5 character address (default is WDR01). These must be alpha-numeric.
  - * Cxy=fffff to set cal constants, where x is cal constant set 0 - 5, y is constant A to D, and fffff is the cal constant (float engineering units)
    - Cal constants are used in a polynomial of form:
      A + Bx + Cx^2 + Dx^3
    - Sets 0 to 4 apply to AD Channels 0 to 4 respectively; set 5 is applied to the wind speed count to produce wind speed in m/s (set constant A = 2.0e-01 and B = 1.3636e-02, C = 0, D = 0, for approximate meters/second).
  - * D=xxxxxxx to set a free format, 7 characters max, configuration date. For reference only, not used internally by instrument. Displayed in L command.
  - * M=[1 to 15 char] to set a free format, 15 characters max, manufacturer. For reference only, not used internally by instrument.
  - Q to quit without updating the EEPROM
  - * S=xxxxxxx to set a free format, 7 characters max, serial number. For reference only, not used internally by instrument. Displayed in L command.
  - WOK to write all EEPROM parameters. Update mode exits upon completion of write.