WXT520

The Vaisala WXT520 is a small and lightweight transmitter that offers six weather parameters in one compact package. WXT520 measures wind speed and direction, precipitation, atmospheric pressure, temperature and relative humidity.

The HSYCO WXT520 driver supports the RS-232 and RS-485 serial interface version, with the ASCII automatic protocol on the WXT520.

Communication

Connectthe WXT520 to HSYCO through a direct serial connection or a supporter TCP/IP to serial gateway.

The default RS-232 parameters are:

Baud rate	19200
Data bits	8
Stop bit	1
Parity	none
Flow control	none

WXT520 configuration

The WXT520 must be configured to automatically send all relevant measured data to the serial port using its proprietary ASCII protocol.

Select the ASCII protocol and uncheck the "Polling only" option, so that automatic transmission is enabled. If the "Response with CRC" option is enabled, the WXT520 driver will check the CRC in received messages and discard messages with CRC errors.

The composite message transmission interval should be set to no more than 30 seconds, otherwise the driver could be occasionally restarted due to the intervention of the keep-alive watch-dog.

HSYCO Configuration

Add a WXT520 I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

• Comm ID: select the comm port connected to the device.

High Availability

• Shutdown when inactive: defaults to true.

Options

ID	Default	Values	Description
gui	false	true	enable support for the UI object, UISET actions and USER commands
		false	disable UI support
altitude	0	n >= 0	the station's installation altitude above mean sea level. This optional parameter is used to convert the measured local atmospheric pressure to mean sea level pressure (MSLP). The conversion function takes into account the altitude and local temperature. If this paramter is not set or set to 0, the measured pressure value will be returned unmodified.

Datapoints

ID	Value	R/W	Description
connection	online	R	connection established
	offline	R	HSYCO can’t connect to the panel
k<n>.<addr>.name	<name>	R	the name of the addressed thermostat is set to the reported string
k<n>.<addr>.temp	<val>	R	the room temperature measured by the addressed thermostat is equal to <val> in °C/10
k<n>.<addr>.setpoint.temp	<val>	R	the set-point temperature measured by the addressed thermostat is equal to <val> in °C/10
		W	set the set-point temperature of the addressed thermostat to <val> in °C/10
k<n>.<addr>.humidity	<val>	R	the relative humidity measured by the addressed thermostat is equal to <val>
season	summer	R	the current season is set to summer
		W	set the current season to summer
	winter	R	the current season is set to winter
		W	set the current season to winter
k<n>.<addr>.mode	off	R	the addressed thermostat is set to mode “OFF”
		W	set the addressed thermostat to mode “OFF”
	com	R	the addressed thermostat is set to mode “Comfort”
		W	set the addressed thermostat to mode “Comfort”
	stb	R	the addressed thermostat is set to mode “Stand-by”
		W	set the addressed thermostat to mode “Stand-by”
	ngt	R	the addressed thermostat is set to mode “Night"
		W	set the addressed thermostat to mode “Night”
mode	off	W	set all the thermostats to mode “OFF”
	com	W	set all the thermostats to mode “Comfort”
	stb	W	set all the thermostats to mode “Stand-by”
	ngt	W	set all the thermostats to mode “Night”
k<n>.pump	0	R	the pump of the addressed KPM20 module is not active
	1	R	the pump of the addressed KPM20 module is active
k<n>.in.temp	<val>	R	the inlet temperature of the addressed KPM20 module is equal to <val>
k<n>.out.temp	<val>	R	the return temperature of the addressed KPM20 module is equal to <val> in °C/10
k<n>.setpoint.temp	<val>	R	the working set-point temperature of the addressed KPM20 module is equal to <val> in °C/10
k<n>.valve	<val>	R	the opening percentage value of the mixing valve calculated by the addressed KPM20 module is equal to val
ext.temp	<val>	R	the measured external temperature is equal to <val> in °C/10
t1.winter	<val>	R	the T1 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T1 temperature parameter’s value for winter climatic compensation to <val> in °C/10
t2.winter	<val>	R	the T2 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T2 temperature parameter’s value for winter climatic compensation to <val> in °C/10
lim.winter	<val>	R	the T-Lim temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T-Lim temperature parameter’s value for winter climatic compensation to <val> in °C/10
setpoint.winter	<val>	R	the minimum set-point temperature for winter is equal to <val> in °C/10
		W	set the minimum set-point temperature for winter to <val> in °C/10
setpoint.summer	<val>	R	the minimum set-point temperature for summer is equal to <val> in °C/10
		W	set the minimum set-point temperature for summer to <val> in °C/10

UISET Actions

ID	Attribute	Set to
k<n>.<addr>.name	value	shows the name assigned to the addressed thermostat
k<n>.<addr>.temp	value	shows the measured room temperature in °C by the addressed thermostat
k<n>.<addr>.setpoint.temp	value	shows the set-point temperature in °C on the addressed thermostat
k<n>.<addr>.humidity	value	shows the measured relative humidity by the addressed thermostat
k<n>.in.temp	value	shows the inlet temperature of the addressed KPM20 module
k<n>.out.temp	value	shows the return temperature of the addressed KPM20 module
k<n>.setpoint.temp	value	shows the working set-point temperature in °C on the addressed KPM20 module
k<n>.valve	value	shows the opening percentage value of the mixing valve calculated by the addressed KPM20 module
ext.temp	value	shows the measured external temperature in °C
t1.winter	value	shows the T1 temperature parameter’s value for winter climatic compensation in °C
t2.winter	value	shows the T2 temperature parameter’s value for winter climatic compensation in °C
lim.winter	value	shows the T-Lim temperature parameter’s value for winter climatic compensation in °C
setpoint.winter	value	shows the minimum set-point temperature for winter
setpoint.summer	value	shows the minimum set-point temperature for summer
connection.label.online	visible	true when the system is connected to HSYCO, false otherwise
connection.label.offline	visible	true when the system is not connected to HSYCO, false otherwise
season.label.winter	visible	true when the current season is set to winter, false otherwise
season.label.summer	visible	true when the current season is set to summer, false otherwise
k<n>.<addr>.mode.label.off	visible	true when the addressed thermostat is OFF, false otherwise
k<n>.<addr>.mode.label.com	visible	true when the working mode of the addressed thermostat is set to “comfort”, false otherwise
k<n>.<addr>.mode.label.stb	visible	true when the working mode of the addressed thermostat is set to “stand-by”, false otherwise
k<n>.<addr>.mode.label.ngt	visible	true when the working mode of the addressed thermostat is set to “night”, false otherwise
k<n>.<addr>.relay.label.0	visible	true when the relay of the addressed thermostat is not active, false otherwise
k<n>.<addr>.relay.label.1	visible	true when the relay of the addressed thermostat is active, false otherwise
k<n>.pump.label.0	visible	true when the pump of the addressed KPM20 module is not active, false otherwise
k<n>.pump.label.1	visible	true when the pump of the addressed KPM20 module is active, false otherwise

USER Commands

Name	Param	Action
k<n>.<addr>.setpoint.temp	<val>	sets the set-point temperature of the addressed thermostat to the specified value (expressed in °C/10)
	up	increases the set-point temperature of the addressed thermostat by 0.5°C
	down	decreases the set-point temperature of the addressed thermostat by 0.5°C
k<n>.<addr>.mode	off	sets the addressed thermostat on mode “OFF”
	com	sets the addressed thermostat on mode “Comfort”
	stb	sets the addressed thermostat on mode “Stand-by”
	ngt	sets the addressed thermostat on mode “Night”
season	summer	sets the working mode season to summer
	winter	sets the working mode season to winter
t1.winter	<val>	sets the T1 temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
t2.winter	<val>	sets the T2 temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
lim.winter	<val>	sets the T-Lim temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
setpoint.winter	<val>	sets the minimum set-point temperature for winter to the specified value (in °C/10)
setpoint.summer	<val>	sets the minimum set-point temperature for summer to the specified value (in °C/10)

Release Notes

3.4.0

• initial version release

---

Vaisala is a registered trademarks of Vaisala Oyj.