Rationale

The WS2300 is a weather station, which can monitor temperature, humidity, wind speed, wind direction, and rainfall (amongst others). The device has also a RS 232 interface. I want to connect this device to my XPL network. There, I developed a gateway.

Functionality

The gateway has the following functionality:

• Support for XPL trigger messages for many of the WS2300 sensors, using the sensor.basic scheme.
• Support for XPL commands to retrieve the status of the WS2300 sensors.
• The gateway keeps track of the minimum and maximum values of the sensors.
• These min/max values can be reset hourly, daily, weekly, monthly, or yearly by the gateway (the min / max values do not survive a power failure).
• The following sensors are supported by the gateway:

• Measure	Sensor name
  Internal temperature	WS2300_InternalTemperature_0
  Internal humidity	WS2300_InternalHumidity_0
  External temperature	WS2300_ExternalTemperature_0
  External humidity	WS2300_ExternalHumidity_0
  Relative air pressure	WS2300_RelativePressure_0
  Absolute air pressure	WS2300_AbsolutePressure_0
  Wind speed	WS2300_WindSpeed_0
  Wind direction	WS2300_WindDirection_0
  Rain of the last hour	WS2300_Rain1Hour_0
  Rain of the last 24 hours	WS2300_Rain24Hour_0
  Total rainfall	WS2300_RainTotal_0
  DewPoint	WS2300_DewPoint_0
  Windchill	WS2300_Windchill_0
  Weather tendency	WS2300_Tendency_0
  Weather forecast	WS2300_Forecast_0

Installation

The distribution below is a jar with the gateway. Additionally you need (in your classpath):

• log4j (I used version 1.2.13).
• RXTX (serial API for Java). You have to install the runtime files of RXTX (in short putting rxtxParallel.dll and rxtxSerial.dll in the bin directory of your Java distribution, see the RXTX documentation for more information), and have the jar in your classpath.
• XPL4Java the jar with a programming framework for XPL
• jdring

Furthermore, you need xpl-ws2300-gateway.jar, and xpl-sensor-actuator-gateway.jar which you need to start (see xpl-ws2300-gateway.cmd for an example).

The gateway can also be used in combination with Gerry Duprey's xpl4java server. Then you need to drop the jars in the jar folder of the xpl java server

There are a number parameters to beconfigured:

• the serial port your WS2300 is connected to (COM1,...)
• the frequency of resetting the min/max values of the measures (hourly, daily, weekly, monthly, yearly)
• a configuration file. The configuration file can be used to set user fiendly names for sensors, and in case sensors need to be polled, the polling frequency (lowest, low, average, high, highest)
• the scaninterval, which is the time period after which the gateway re-reads the configuration file
• lowest, low, average, high, highest: the time (in seconds) after which the gateway polls sensors for new values

At www.gordijn.org/gordijn.xml you find a plug-in for use with XPLHal tools.

Limitations

• This is version 0.2. Meaning: experimental, not stable, using at your own risk, and so on. But you may give it a try

Files

• xPL gateway, source gateway, source API
• This software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.