WS23xx

The hardware interface is a serial port, but USB-serial converters can be used with computers that have no serial port. Beware that not every type of USB-serial converter will work. Converters based on ATEN UC-232A chipset are known to work.

The station does not record wind gust or wind gust direction.

The hardware calculates windchill and dewpoint.

Sensors can be connected to the console with a wire. If not wired, the sensors will communicate via a wireless interface. When connected by wire, some sensor data are transmitted every 8 seconds. With wireless, data are transmitted every 16 to 128 seconds, depending on wind speed and rain activity.

WS23xx transmission periods

sensor	period
Wind	32 seconds when wind > 22.36 mph (wireless) 128 seconds when wind > 22.36 mph (wireless) 10 minutes (wireless after 5 failed attempts) 8 seconds (wired)
Temperature	15 seconds
Humidity	20 seconds
Pressure	15 seconds

The station has 175 history records. That is just over 7 days of data with the factory default history recording interval of 60 minutes, or about 14 hours with a recording interval of 5 minutes.

When WeeWX starts up it will attempt to download all records from the console since the last record in the archive database.

Configuring with weectl device

The WS23xx stations can be configured with the utility weectl device.

Note

Make sure you stop weewxd before running weectl device.

--help

Invoking weectl device with the --help option

weectl device --help

will produce something like this:

  WS23xx driver version 0.21
  Usage: weectl device [config_file] [options] [--debug] [--help]

  Configuration utility for weewx devices.

  Options:
  -h, --help         show this help message and exit
  --debug            display diagnostic information while running
  -y                 answer yes to every prompt
  --info             display weather station configuration
  --current          get the current weather conditions
  --history=N        display N history records
  --history-since=N  display history records since N minutes ago
  --clear-memory     clear station memory
  --set-time         set the station clock to the current time
  --set-interval=N   set the station archive interval to N minutes

  Mutating actions will request confirmation before proceeding.

--info

Display the station settings with the --info option.

weectl device --info

This will result in something like:

  buzzer: 0
  connection time till connect: 1.5
  connection type: 15
  dew point: 8.88
  dew point max: 18.26
  dew point max alarm: 20.0
  dew point max alarm active: 0
  dew point max alarm set: 0
  dew point max when: 978565200.0
  dew point min: -2.88
  dew point min alarm: 0.0
  dew point min alarm active: 0
  dew point min alarm set: 0
  dew point min when: 978757260.0
  forecast: 0
  history interval: 5.0
  history last record pointer: 8.0
  history last sample when: 1385564760.0
  history number of records: 175.0
  history time till sample: 5.0
  icon alarm active: 0
  in humidity: 48.0

The line history number of records indicates how many records are in memory. The line history interval indicates the number of minutes between records.

--set-interval

WS23xx stations ship from the factory with an archive interval of 60 minutes (3600 seconds). To change the interval to 5 minutes, do the following:

weectl device --set-interval=5

Warning

Changing the interval will clear the station memory.

--history

WS23xx stations store records in a circular buffer — once the buffer fills, the oldest records are replaced by newer records. The console stores up to 175 records.

For example, to display the latest 30 records from the console memory:

weectl device --history=30

--clear-memory

To clear the console memory:

weectl device --clear-memory

Station data

The following table shows which data are provided by the station hardware and which are calculated by WeeWX.

WS23xx station data

Database Field	Observation	Loop	Archive
barometer		S	S
pressure	pressure	H	H
altimeter		S	S
inTemp	temperature_in	H	H
outTemp	temperature_out	H	H
inHumidity	humidity_in	H	H
outHumidity	humidity_out	H	H
windSpeed	wind_speed	H	H
windDir	wind_dir	H	H
rain	rain	D	D
	rain_total	H	H
rainRate	rain_rate	H	H
dewpoint	dewpoint	H	H
windchill	windchill	H	H
heatindex		S	S

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service