WS2001 (H2) configurator

WS2001 (H2) firmware changelog

When a station with an older version connects, the configurator installs the default release (if automatic updates are on). Newer preview releases are opt-in: connect to the station and pick them under Other versions in the firmware panel. Every update keeps the station's settings, both network profiles and the rain total.

V4.10 and V5.1 at a glance

V4.10 V5.1
Status Default release Preview · opt-in
Open Edition uplink (FPort 99) 16 bytes 20 bytes
Wind direction Mean direction Mean direction, spread (σθ), range, gust direction
Payload decoder Any WS2001 decoder from V4.9 on The latest decoder (reads both frames)
Airtime at SF7 67 ms, about 19 s a day at 5 min 72 ms, about 21 s a day at 5 min
WeatherXM network frame 24 bytes 24 bytes, unchanged

Upload interval. Both frames stay within the EU868 legal duty cycle (1 % per sub-band) at a 3-minute interval at every spreading factor, and the station enforces it. On The Things Network the fair-use limit of 30 s of airtime a day is stricter: keep 5 minutes or more at SF7, and longer at slower spreading factors (about 6 min at SF8, 11–12 min at SF9, 20–22 min at SF10). Private servers such as ChirpStack only have the duty cycle limit.

V5.1

Preview · opt-in 22 October 2026

Adds how steady the wind direction was to the Open Edition uplink.

Before you install: On your own network, install the latest payload decoder before updating: it reads both the 16-byte (V4.10) and the 20-byte (V5.1) frame, while decoders from before V5.1 reject the longer frame. Download the decoder.

  • Wind direction variability. The Open Edition weather frame grows from 16 to 20 bytes. Next to the mean direction it now carries the spread of the direction (σθ, in degrees), the range the wind actually blew from (the narrowest arc holding 90 % of the 12-second readings) and the direction of the strongest gust. A mean alone can hide wind that switches between two directions; these values show it.
  • Mean direction unchanged. The mean wind direction is computed as in V4.10: the vector mean of the 12-second readings at 0.5 m/s or more. The WeatherXM network frame is unchanged.
  • Not available in calm air. The spread and range need at least 5 readings at 0.5 m/s or more in the interval; otherwise they decode as null. The gust direction needs a gust of at least 0.5 m/s.
  • Airtime. A 20-byte uplink takes about 72 ms at SF7, against 67 ms for the 16-byte frame: about 21 s a day at a 5-minute interval, within The Things Network's 30 s fair-use limit. Both stay within the EU868 1 % duty cycle at a 3-minute interval.
  • Version number. V5.0 is skipped: V4.10 already uses update number 50, so the release after it is V5.1 (51).

V4.10

Default release 22 October 2026

Fixes pressure readings after a sensor restart and keeps the rain total across restarts.

  • Pressure. For about 30 seconds after the sensor head restarts, its barometer reports 0 hPa. Those readings are now left out of the interval average; before, they pulled the reported pressure down, in the worst case to about half of the real value.
  • Rain total kept across restarts. The rain total is saved before every planned restart (the end of a Bluetooth session, a short button press, a restart command or downlink), not only every 3 minutes, so rain counted just before a restart is no longer lost.
  • Rain total recovery. After a sensor read error the rain total recovers instead of staying invalid, and a factory reset now clears it completely.
  • Payload. Same 16-byte Open Edition frame as V4.9 on your own network; the payload decoder reports a pressure of 0 as null.