Vaisala WXT520 Interface (GILWND45 board) Ver1.x Command Set

file: wxt520ifcmnd.html
28 Aug 2009

Vaisala WXT520 Interface (GILWND45 Board) Ver1.x Command Set

See ASIMET MODULE OPERATIONS document for instructions on how to hook up the comms link to your PC and RS-485 adapter. This board is only used as a front-end interface board in conjunction with an VOS/ASIMET C530 logger board, typically using 'C' and 'R' commands.
Refer to Latest Version Information for reference info on latest firmware version numbers.

Note 1: All commands MUST be terminated with <cr> (ASCII carriage return). This is different from other ASIMET front-end boards.

Note 2: 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>
- example:
  #WXT01A WXT01<crlf>
- NOTE 1: WXT01 is the default address of the WXT520IF front-end; 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: The address MUST be WXT01 to operate with the C530 main logger board in a Vaisala WXT520 Weather module
C Output TCM2 Compass with Tilt data
- outputs: Direction, TiltX, TiltY
- example:
  #WXT01C 231.2 -0.2 0.1<crlf>
D Get WXT520 and TCM2 data (2 lines)
- for in-house testing; displays compass and wind raw data only
- example:
  #WXT01D 231.2 -0.2 0.1 <crlf>
  0R1Dm=071D,Sn=0.1M,Sm=0.2M,Sx=0.3M <crlf>

H Help

#WXT01H - 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:

Firmware WXT520IF v1.xx
A - Address acknowledge\r\n
C - Get Compass with Tilt\r\n
D - Get WXT520 and TCM2 data (2 lines)\r\n
H - Display Help message\r\n
R[0-3,5] - Get WXT520 data via aR# command\r\n
STAT - System Status info\r\n
T - Test mode\r\n
TV - Test mode - Verbose\r\n
UOK - Update EEPROM constants\r\n

R[0-3,5] Get WXT520 data via aR# command
- returns raw response from WXT520;
  see Vaisala WXT520 documentation for details of returned messages
- get all WXT520 data - R0
- get wind only - R1
- get RH/Temp/Pressure only - R2
- get Rain only - R3
- get Supervisor info only - R5
- examples:
  #WXT01R1 0R1,Dm=071D,Sn=0.1M,Sm=0.2M,Sx=0.3M <crlf>
  #WXT01R2 0R2,Ta=21.3C,Ua=63.2P,Pa=1020.1H <crlf>
  #WXT01R3 0R3,Rc=0.00M,Rd=20s,Ri=0.0M,Hc=0.0M,Hd=0s,Hi=0.0M,Rp=0.1M,Hp=0.0M <crlf>
STAT Report ID, serial #, cal info, etc.
- the 'STAT' 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>, 8 lines of info are provided, as follows:
```
#WXT01STAT
module id from EEPROM
module model name from EEPROM
module serial number from EEPROM
configuration date from EEPROM
firmware name and version from program EPROM
		
```

T[V] Enter test mode

in normal mode (T command), responds with continuous scans of data with <crlf> terminator only.
data is TCM2 compass degrees, tilt-x degrees, tilt-y degrees, then raw 0R0 response from WXT520 (see Vaisala WXT520 documentation - note that 0R0 response can be different from combination of 0R1, 0R2, and 0R3 commands)

for example:

#WXT01T 
251.7  -0.3  0.1 0R0,Dm=100D,Sn=0.1M,Sm=0.2M,Sx=0.3M,Ta=21.3C,Ua=63.2P,Pa=1020.1H,Rc=0.00M,Rd=20s,Ri=0.0M,Hc=0.0M,Hd=0s,Hi=0.0M
251.7  -0.3  0.1 0R0,Dm=100D,Sn=0.1M,Sm=0.2M,Sx=0.3M,Ta=21.3C,Ua=63.2P,Pa=1020.1H,Rc=0.00M,Rd=20s,Ri=0.0M,Hc=0.0M,Hd=0s,Hi=0.0M
251.7  -0.3  0.1 0R0,Dm=100D,Sn=0.1M,Sm=0.2M,Sx=0.3M,Ta=21.3C,Ua=63.2P,Pa=1020.1H,Rc=0.00M,Rd=20s,Ri=0.0M,Hc=0.0M,Hd=0s,Hi=0.0M
251.7  -0.3  0.1 0R0,Dm=100D,Sn=0.1M,Sm=0.2M,Sx=0.3M,Ta=21.3C,Ua=63.2P,Pa=1020.1H,Rc=0.00M,Rd=20s,Ri=0.0M,Hc=0.0M,Hd=0s,Hi=0.0M
      .
      .

the command terminates on receipt of an ASCII ESC (1Bh) character.
there is a verbose mode (TV command) that returns the same data in a 2-line format with line headers.

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. #WXT01UOK may be sent as one. Upon receipt of the correct 'password', the response will be UOK if current parameters are valid, or NEW if parameters have never been entered or are suspicious (i.e. EEPROM failure or bad internal checksum).
- response to an unknown command is '?'
- IMPORTANT! commands ADR or CD 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 'WRTOK' 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 'ABORT', the original settings of all parameters will remain intact.
- the following commands are available in EEPROM update mode:
  - ADR - module Address (1 to 5 characters)
  - ABORT - Abort without writing new info to EEPROM
  - CD - Setup date
  - WRTOK - Write new info to EEPROM and exit
- examples:
```
    To change the current module address:
    ADR=WXT01<cr>
    To see the address:
    ADR<cr>
    To see the current setup date:
    CD<cr>
    To change it:
    CD=12Aug09<cr>
	    
```
- NOTE: Upon completion, the newly updated module address will not take effect until the next reset or power-up.

Revision history:

28 Aug 2009 - Original Release - V1.0