Difference between revisions of "WXT520"

From HSYCO
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
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 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.
 
The HSYCO WXT520 driver supports the RS-232 and RS-485 serial interface version, with the ASCII automatic protocol on the WXT520.
 +
 +
[[File:IO Server WXT520.png|center]]
  
 
[[Category:I/O Server]]
 
[[Category:I/O Server]]
  
 
== Communication ==
 
== Communication ==
Connectthe WXT520 to HSYCO through a direct serial connection or a supporter TCP/IP to serial gateway.
+
Connect the WXT520 to HSYCO through a direct serial connection or a supporter TCP/IP to serial gateway.
  
 
The default RS-232 parameters are:
 
The default RS-232 parameters are:
Line 29: Line 31:
 
The WXT520 must be configured to automatically send all relevant measured data to the serial port using its proprietary ASCII protocol.
 
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.
  
[[File:IO Server Giacomini Architecture.png|center]]
+
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.
  
 +
 +
[[File:IO Server WXT520 configuration.png|center]]
  
 
== HSYCO Configuration ==
 
== HSYCO Configuration ==
Line 52: Line 57:
  
 
|rowspan="2"|gui
 
|rowspan="2"|gui
|rowspan="2"|true
+
|rowspan="2"|false
 
|true
 
|true
|enable support for the UI object, UISET actions and USER commands
+
|enable support for the UISET actions
 
|-
 
|-
 
|false
 
|false
Line 61: Line 66:
 
|-
 
|-
  
|rowspan="2"|startupevents
+
|altitude
|rowspan="2"|false
+
|0
|true
+
|integer number
|generate IO events also during the driver’s start-up phase
+
|the station's installation altitude above mean sea level.
|-
+
 
|false
+
This optional parameter is used to convert the measured local atmospheric pressure to mean sea level pressure (MSLP).
|start generating events only after HSYCO is aligned with the current status of the system
 
  
|-
+
The conversion function takes into account the altitude and local temperature.
  
|pollinterval
+
If this paramter is not set or set to 0, the measured pressure value will be returned unmodified.
|1
 
|n > 0
 
|the data acquisition interval, in seconds
 
  
 
|-
 
|-
 
|}
 
|}
  
 +
== Datapoints ==
 +
 +
All measured values returned as datapoints use the units as set in the WXT520. The unit is not returned in the datapoint value.
  
== Datapoints ==
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 89: Line 92:
 
|-
 
|-
  
 
+
|rowspan="2"|status
|rowspan="2"|connection
 
 
|online
 
|online
 
|R
 
|R
Line 97: Line 99:
 
|offline
 
|offline
 
|R
 
|R
|HSYCO can’t connect to the panel
+
|HSYCO can’t connect to the WXT520
 
|-
 
|-
  
|k<n>.<addr>.name
+
|sn
|<name>
+
|<value>
 
|R
 
|R
|the name of the addressed thermostat is set to the reported string
+
|wind speed minimum (m/s, km/h, mph, knots)
 
|-
 
|-
  
|k<n>.<addr>.temp
+
|sm
|<val>
+
|<value>
 
|R
 
|R
|the room temperature measured by the addressed thermostat is equal to <val> in °C/10
+
|wind speed average (m/s, km/h, mph, knots)
 
|-
 
|-
  
|rowspan="2"|k<n>.<addr>.setpoint.temp
+
|sx
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the set-point temperature measured by the addressed thermostat is equal to <val> in °C/10
+
|wind speed maximum (m/s, km/h, mph, knots)
|-
 
|W
 
|set the set-point temperature of the addressed thermostat to <val> in °C/10
 
 
|-
 
|-
  
|k<n>.<addr>.humidity
+
|dn
|<val>
+
|<value>
 
|R
 
|R
|the relative humidity measured by the addressed thermostat is equal to <val>
+
|wind direction minimum (deg)
 
|-
 
|-
  
|rowspan="4"|season
+
|dm
|rowspan="2"|summer
+
|<value>
 
|R
 
|R
|the current season is set to summer
+
|wind direction average (deg)
 
|-
 
|-
|W
+
 
|set the current season to summer
+
|dx
|-
+
|<value>
|rowspan="2"|winter
 
 
|R
 
|R
|the current season is set to winter
+
|wind direction maximum (deg)
|-
 
|W
 
|set the current season to winter
 
 
|-
 
|-
  
|rowspan="8"|k<n>.<addr>.mode
+
|pa
|rowspan="2"|off
+
|<value>
 
|R
 
|R
|the addressed thermostat is set to mode “OFF”
+
|air pressure (hPa, Pa, bar, mmHg, inHg), converted to mean sea level pressure if the altitude option is set
 
|-
 
|-
|W
+
 
|set the addressed thermostat to mode “OFF”
+
|ta
|-
+
|<value>
|rowspan="2"|com
 
 
|R
 
|R
|the addressed thermostat is set to mode “Comfort”
+
|air temperature (C, F)
 
|-
 
|-
|W
+
 
|set the addressed thermostat to mode “Comfort”
+
|tp
|-
+
|<value>
|rowspan="2"|stb
 
 
|R
 
|R
|the addressed thermostat is set to mode “Stand-by”
+
|internal temperature (C, F)
 
|-
 
|-
|W
+
 
|set the addressed thermostat to mode “Stand-by”
+
|ua
|-
+
|<value>
|rowspan="2"|ngt
 
 
|R
 
|R
|the addressed thermostat is set to mode “Night"
+
|relative humidity (%RH)
|-
 
|W
 
|set the addressed thermostat to mode “Night”
 
 
|-
 
|-
  
|rowspan="4"|mode
+
|rc
|off
+
|<value>
|W
+
|R
|set all the thermostats to mode “OFF”
+
|rain accumulation (mm, in)
|-
 
|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”
 
 
|-
 
|-
  
|rowspan="2"|k<n>.pump
+
|rd
|0
+
|<value>
 
|R
 
|R
|the pump of the addressed KPM20 module is not active
+
|rain duration (s)
 
|-
 
|-
|1
+
 
 +
|ri
 +
|<value>
 
|R
 
|R
|the pump of the addressed KPM20 module is active
+
|rain intensity (mm/h, in/h)
 
|-
 
|-
  
|k<n>.in.temp
+
|rp
|<val>
+
|<value>
 
|R
 
|R
|the inlet temperature of the addressed KPM20 module is equal to <val>
+
|rain peak intensity (mm/h, in/h)
 
|-
 
|-
  
|k<n>.out.temp
+
|hc
|<val>
+
|<value>
 
|R
 
|R
|the return temperature of the addressed KPM20 module is equal to <val> in °C/10
+
|hail accumulation (hits/cm2, hits/in2, hits)
 
|-
 
|-
  
|k<n>.setpoint.temp
+
|hd
|<val>
+
|<value>
 
|R
 
|R
|the working set-point temperature of the addressed KPM20 module is equal to <val> in °C/10
+
|hail duration (s)
 
|-
 
|-
  
|k<n>.valve
+
|hi
|<val>
+
|<value>
 
|R
 
|R
|the opening percentage value of the mixing valve calculated by the addressed KPM20 module is equal to val
+
|hail intensity (hits/cm2h, hits/in2h, hits/ h)
 
|-
 
|-
  
|ext.temp
+
|hp
|<val>
+
|<value>
 
|R
 
|R
|the measured external temperature is equal to <val> in °C/10
+
|hail peak intensity (hits/cm2h, hits/in2h, hits/ h)
 
|-
 
|-
  
|rowspan="2"|t1.winter
+
|th
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the T1 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
+
|heating temperature (C, F)
|-
 
|W
 
|set the T1 temperature parameter’s value for winter climatic compensation to <val> in °C/10
 
 
|-
 
|-
  
|rowspan="2"|t2.winter
+
|vh
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the T2 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
+
|heating voltage (V)
|-
 
|W
 
|set the T2 temperature parameter’s value for winter climatic compensation to <val> in °C/10
 
 
|-
 
|-
  
|rowspan="2"|lim.winter
+
|vs
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the T-Lim temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
+
|supply voltage (V)
|-
 
|W
 
|set the T-Lim temperature parameter’s value for winter climatic compensation to <val> in °C/10
 
 
|-
 
|-
  
|rowspan="2"|setpoint.winter
+
|vr
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the minimum set-point temperature for winter is equal to <val> in °C/10
+
|3.5 V ref. voltage (V)
|-
 
|W
 
|set the minimum set-point temperature for winter to <val> in °C/10
 
 
|-
 
|-
  
|rowspan="2"|setpoint.summer
+
|id
|rowspan="2"|<val>
+
|<value>
 
|R
 
|R
|the minimum set-point temperature for summer is equal to <val> in °C/10
+
|information field
|-
 
|W
 
|set the minimum set-point temperature for summer to <val> in °C/10
 
 
|-
 
|-
  
 
|}
 
|}
  
=== UISET Actions ===
+
== UISET Actions ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!ID
 
!ID
 
!Attribute
 
!Attribute
!colspan="2"|Set to
+
!Set to
 +
!Description
 
|-
 
|-
  
|k<n>.<addr>.name
+
|sn
 
|value
 
|value
|shows the name assigned to the addressed thermostat
+
|<value> <unit>
 +
|wind speed minimum (m/s, km/h, mph, knots)
 
|-
 
|-
|k<n>.<addr>.temp
+
 
|value
+
|sm
|shows the measured room temperature in °C by the addressed thermostat
+
|value
 +
|<value> <unit>
 +
|wind speed average (m/s, km/h, mph, knots)
 
|-
 
|-
|k<n>.<addr>.setpoint.temp
+
 
|value
+
|sx
|shows the set-point temperature in °C on the addressed thermostat
+
|value
 +
|<value> <unit>
 +
|wind speed maximum (m/s, km/h, mph, knots)
 
|-
 
|-
|k<n>.<addr>.humidity
+
 
|value
+
|dn
|shows the measured relative humidity by the addressed thermostat
+
|value
 +
|<value> <unit>
 +
|wind direction minimum (deg)
 
|-
 
|-
|k<n>.in.temp
+
 
|value
+
|dm
|shows the inlet temperature of the addressed KPM20 module
+
|value
 +
|<value> <unit>
 +
|wind direction average (deg)
 
|-
 
|-
|k<n>.out.temp
+
 
 +
|dn
 
|value
 
|value
|shows the return temperature of the addressed KPM20 module
+
|<value> <unit>
 +
|wind direction minimum (deg)
 
|-
 
|-
|k<n>.setpoint.temp
+
 
 +
|dx
 
|value
 
|value
|shows the working set-point temperature in °C on the addressed KPM20 module
+
|<value> <unit>
 +
|wind direction maximum (deg)
 
|-
 
|-
|k<n>.valve
+
 
 +
|pa
 
|value
 
|value
|shows the opening percentage value of the mixing valve calculated by the addressed KPM20 module
+
|<value> <unit>
 +
|air pressure (hPa, Pa, bar, mmHg, inHg), converted to mean sea level pressure if the altitude option is set
 
|-
 
|-
|ext.temp
+
 
 +
|ta
 
|value
 
|value
|shows the measured external temperature in °C
+
|<value> <unit>
 +
|air temperature (C, F)
 
|-
 
|-
|t1.winter
+
 
 +
|tp
 
|value
 
|value
|shows the T1 temperature parameter’s value for winter climatic compensation in °C
+
|<value> <unit>
 +
|internal temperature (C, F)
 
|-
 
|-
|t2.winter
+
 
 +
|ua
 
|value
 
|value
|shows the T2 temperature parameter’s value for winter climatic compensation in °C
+
|<value> <unit>
 +
|relative humidity (%RH)
 
|-
 
|-
|lim.winter
+
 
 +
|rc
 
|value
 
|value
|shows the T-Lim temperature parameter’s value for winter climatic compensation in °C
+
|<value> <unit>
 +
|rain accumulation (mm, in)
 
|-
 
|-
|setpoint.winter
+
 
 +
|rd
 
|value
 
|value
|shows the minimum set-point temperature for winter
+
|<value> <unit>
 +
|rain duration (s)
 
|-
 
|-
|setpoint.summer
+
 
 +
|ri
 
|value
 
|value
|shows the minimum set-point temperature for summer
+
|<value> <unit>
 +
|rain intensity (mm/h, in/h)
 
|-
 
|-
|connection.label.online
+
 
|visible
+
|rp
|true when the system is connected to HSYCO, false otherwise
+
|value
 +
|<value> <unit>
 +
|rain peak intensity (mm/h, in/h)
 
|-
 
|-
|connection.label.offline
+
 
|visible
+
|hc
|true when the system is not connected to HSYCO, false otherwise
+
|value
 +
|<value> <unit>
 +
|hail accumulation (hits/cm2, hits/in2, hits)
 
|-
 
|-
|season.label.winter
+
 
|visible
+
|hd
|true when the current season is set to winter, false otherwise
+
|value
 +
|<value> <unit>
 +
|hail duration (s)
 
|-
 
|-
|season.label.summer
+
 
|visible
+
|hi
|true when the current season is set to summer, false otherwise
+
|value
 +
|<value> <unit>
 +
|hail intensity (hits/cm2h, hits/in2h, hits/ h)
 
|-
 
|-
|k<n>.<addr>.mode.label.off
+
 
|visible
+
|hp
|true when the addressed thermostat is OFF, false otherwise
+
|value
 +
|<value> <unit>
 +
|hail peak intensity (hits/cm2h, hits/in2h, hits/ h)
 
|-
 
|-
|k<n>.<addr>.mode.label.com
+
 
|visible
+
|th
|true when the working mode of the addressed thermostat is set to “comfort”, false otherwise
+
|value
|-
+
|<value> <unit>
|k<n>.<addr>.mode.label.stb
+
|heating temperature (C, F)
|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
 
 
|-
 
|-
  
|}
+
|vh
 
+
|value
=== USER Commands ===
+
|<value> <unit>
{| class="wikitable"
+
|heating voltage (V)
!Name
 
!Param
 
!Action
 
 
|-
 
|-
  
|rowspan="3"|k<n>.<addr>.setpoint.temp
+
|vs
|<val>
+
|value
|sets the set-point temperature of the addressed thermostat to the specified value (expressed in °C/10)
+
|<value> <unit>
|-
+
|supply voltage (V)
|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
 
 
|-
 
|-
  
|rowspan="4"|k<n>.<addr>.mode
+
|vr
|off
+
|value
|sets the addressed thermostat on mode “OFF”
+
|<value> <unit>
|-
+
|3.5 V ref. voltage (V)
|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”
 
 
|-
 
|-
  
|rowspan="2"|season
+
|id
|summer
+
|value
|sets the working mode season to summer
+
|<value> <unit>
|-
+
|information field
|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)
 
 
|-
 
|-
  
Line 463: Line 405:
  
 
''Vaisala is a registered trademarks of Vaisala Oyj.''
 
''Vaisala is a registered trademarks of Vaisala Oyj.''
 
== Release Notes ==
 

Latest revision as of 13:28, 10 November 2014

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.

IO Server WXT520.png

Communication

Connect the 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.


IO Server WXT520 configuration.png

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 UISET actions
false disable UI support
altitude 0 integer number 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

All measured values returned as datapoints use the units as set in the WXT520. The unit is not returned in the datapoint value.


ID Value R/W Description
status online R connection established
offline R HSYCO can’t connect to the WXT520
sn <value> R wind speed minimum (m/s, km/h, mph, knots)
sm <value> R wind speed average (m/s, km/h, mph, knots)
sx <value> R wind speed maximum (m/s, km/h, mph, knots)
dn <value> R wind direction minimum (deg)
dm <value> R wind direction average (deg)
dx <value> R wind direction maximum (deg)
pa <value> R air pressure (hPa, Pa, bar, mmHg, inHg), converted to mean sea level pressure if the altitude option is set
ta <value> R air temperature (C, F)
tp <value> R internal temperature (C, F)
ua <value> R relative humidity (%RH)
rc <value> R rain accumulation (mm, in)
rd <value> R rain duration (s)
ri <value> R rain intensity (mm/h, in/h)
rp <value> R rain peak intensity (mm/h, in/h)
hc <value> R hail accumulation (hits/cm2, hits/in2, hits)
hd <value> R hail duration (s)
hi <value> R hail intensity (hits/cm2h, hits/in2h, hits/ h)
hp <value> R hail peak intensity (hits/cm2h, hits/in2h, hits/ h)
th <value> R heating temperature (C, F)
vh <value> R heating voltage (V)
vs <value> R supply voltage (V)
vr <value> R 3.5 V ref. voltage (V)
id <value> R information field

UISET Actions

ID Attribute Set to Description
sn value <value> <unit> wind speed minimum (m/s, km/h, mph, knots)
sm value <value> <unit> wind speed average (m/s, km/h, mph, knots)
sx value <value> <unit> wind speed maximum (m/s, km/h, mph, knots)
dn value <value> <unit> wind direction minimum (deg)
dm value <value> <unit> wind direction average (deg)
dn value <value> <unit> wind direction minimum (deg)
dx value <value> <unit> wind direction maximum (deg)
pa value <value> <unit> air pressure (hPa, Pa, bar, mmHg, inHg), converted to mean sea level pressure if the altitude option is set
ta value <value> <unit> air temperature (C, F)
tp value <value> <unit> internal temperature (C, F)
ua value <value> <unit> relative humidity (%RH)
rc value <value> <unit> rain accumulation (mm, in)
rd value <value> <unit> rain duration (s)
ri value <value> <unit> rain intensity (mm/h, in/h)
rp value <value> <unit> rain peak intensity (mm/h, in/h)
hc value <value> <unit> hail accumulation (hits/cm2, hits/in2, hits)
hd value <value> <unit> hail duration (s)
hi value <value> <unit> hail intensity (hits/cm2h, hits/in2h, hits/ h)
hp value <value> <unit> hail peak intensity (hits/cm2h, hits/in2h, hits/ h)
th value <value> <unit> heating temperature (C, F)
vh value <value> <unit> heating voltage (V)
vs value <value> <unit> supply voltage (V)
vr value <value> <unit> 3.5 V ref. voltage (V)
id value <value> <unit> information field

Release Notes

3.4.0

  • initial version release


Vaisala is a registered trademarks of Vaisala Oyj.