Lufft Lufft WS-UMB series Modbus RTU template

Lufft WS-UMB series

Compact weather sensor for temperature, humidity, air pressure, wind, precipitation and global radiation.

The Lufft WS-UMB series are compact smart weather sensors that measure, depending on the variant, air temperature, humidity, air pressure, wind, precipitation and global radiation on a mast, for example on a greenhouse roof. This Modbus RTU template reads all measured values with minimum, maximum and average and the sensor status, and lets you write altitude, averaging intervals and heating mode from ModbusCloud.

Protocol
Modbus RTU
Connection
RS485, 19200 baud
Registers
164, read and write
Brand
Lufft
Key readings
Air temperature · Relative humidity · Air pressure · Global radiation · Wind speed and direction · Precipitation amount and intensity · Precipitation type · Sensor status
Available commands
Station altitude · Compass deviation · Averaging intervals · Heating mode · Fan and heater switching · Rain total reset and device reset
Compatible models
WS100-UMB · WS200-UMB · WS300-UMB · WS301-UMB · WS302-UMB · WS303-UMB · WS304-UMB · WS310-UMB · WS400-UMB · WS401-UMB · WS500-UMB · WS501-UMB · WS502-UMB · WS503-UMB · WS504-UMB · WS510-UMB · WS600-UMB · WS601-UMB · WS700-UMB · WS800-UMB · WS200 · WS300 · WS301 · WS302 · WS310 · WS400 · WS401 · WS500 · WS501 · WS502 · WS510 · WS600 · WS601 · WS700 · WS800
Last updated

Registers (164)

162 read, 14 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
Air Temperature°CRead
Relative Humidity%Read
Relative Air PressurehPaRead
Global RadiationW/m²Read
Wind Speedm/sRead
Wind Direction°Read
Precipitation Intensitymm/hRead
Precipitation AbsolutemmRead
Precipitation DifferencemmRead
Precipitation TypeRead
Dew Point°CRead
Relative Humidity Min%Read
Relative Humidity Max%Read
Relative Humidity Avg%Read
Relative Air Pressure MinhPaRead
Relative Air Pressure MaxhPaRead
Relative Air Pressure AvghPaRead
Wind Direction Min°Read
Wind Direction Max°Read
Wind Direction Vector Avg°Read
Wind Direction Fast°Read
Wind Direction Compass Corrected°Read
Compass Heading°Read
Wind Measurement Quality%Read
Global Radiation MinW/m²Read
Global Radiation MaxW/m²Read
Global Radiation AvgW/m²Read
Air Temperature Min°CRead
Air Temperature Max°CRead
Air Temperature Avg°CRead
Dew Point Min°CRead
Dew Point Max°CRead
Dew Point Avg°CRead
Wind Chill Temperature°CRead
Heating Temperature Wind°CRead
Heating Temperature R2S°CRead
Wind Speed Minm/sRead
Wind Speed Maxm/sRead
Wind Speed Avgm/sRead
Wind Speed Vector Avgm/sRead
Wind Speed Fastm/sRead
Absolute Humidityg/m³Read
Absolute Humidity Ming/m³Read
Absolute Humidity Maxg/m³Read
Absolute Humidity Avgg/m³Read
Mixing Ratiog/kgRead
Mixing Ratio Ming/kgRead
Mixing Ratio Maxg/kgRead
Mixing Ratio Avgg/kgRead
Absolute Air PressurehPaRead
Absolute Air Pressure MinhPaRead
Absolute Air Pressure MaxhPaRead
Absolute Air Pressure AvghPaRead
Wind Speed km/hkm/hRead
Wind Speed km/h Minkm/hRead
Wind Speed km/h Maxkm/hRead
Wind Speed km/h Avgkm/hRead
Wind Speed km/h Vector Avgkm/hRead
Wind Speed Fast km/hkm/hRead
Wind Speed Std Devm/sRead
Wind Direction Std Dev°Read
Wet Bulb Temperature°CRead
Specific EnthalpyRead
Air DensityRead
External Temperature°CRead
Wind Value Quality Fast%Read
Lightning Events MinuteRead
Lightning Events IntervalRead
Air Temperature °F°FRead
Air Temperature °F Min°FRead
Air Temperature °F Max°FRead
Air Temperature °F Avg°FRead
Dew Point °F°FRead
Dew Point °F Min°FRead
Dew Point °F Max°FRead
Dew Point °F Avg°FRead
Wind Chill Temperature °F°FRead
Heating Temperature Wind °F°FRead
Heating Temperature R2S °F°FRead
Wind Speed mphRead
Wind Speed mph MinRead
Wind Speed mph MaxRead
Wind Speed mph AvgRead
Wind Speed mph Vector AvgRead
Wind Speed Fast mphRead
Precipitation Absolute inRead
Precipitation Difference inRead
Precipitation Intensity in/hRead
Wind Speed ktsRead
Wind Speed kts MinRead
Wind Speed kts MaxRead
Wind Speed kts AvgRead
Wind Speed kts Vector AvgRead
Wind Speed Fast ktsRead
Wind Speed Std Dev mphRead
Wet Bulb Temperature °F°FRead
External Temperature °F°FRead
Precipitation Intensity mm/minRead
Precipitation Intensity in/minRead
WMO Synop Code 4680 wawaRead
WMO Synop Code 4680 WaWa (Ch 781)Read
WMO Synop Code 4677 wwRead
WMO Synop Code 4677 WW (Ch 786)Read
Service Air Temperature°CRead
Service Air Temperature Min°CRead
Service Air Temperature Max°CRead
Service Air Temperature Avg°CRead
Service Air Temperature °F°FRead
Service Air Temperature °F Min°FRead
Service Air Temperature °F Max°FRead
Service Air Temperature °F Avg°FRead
Total ParticlesRead
Total DropsRead
Drizzle ParticlesRead
Snow ParticlesRead
Hail ParticlesRead
Drop Class 0Read
Drop Class 1Read
Drop Class 2Read
Drop Class 3Read
Drop Class 4Read
Drop Class 5Read
Drop Class 6Read
Drop Class 7Read
Drop Class 8Read
Drop Class 9Read
Drop Class 10Read
Drop Class 11Read
Copy Precipitation TypeRead
Copy Total PrecipitationmmRead
Copy Precipitation DifferencemmRead
Copy Precipitation Intensitymm/hRead
Copy Heating Temperature°CRead
Copy Total Precipitation inRead
Copy Precipitation Difference inRead
Copy Precipitation Intensity in/hRead
Copy Heating Temperature °F°FRead
Copy WMO Synop Code 4680 wawaRead
Copy WMO Synop Code 4680 WaWa (Ch 781)Read
Copy WMO Synop Code 4677 wwRead
Copy WMO Synop Code 4677 WW (Ch 786)Read
Device StatusRead
Sensor Status 1Read
Sensor Status 2Read
Sensor Status 3Read
Sensor Status 4Read
Sensor Status 5Read
Sensor Status 6Read
Local AltitudemRead and write
Compass Deviation°Read and write
Averaging Interval TFFminRead and write
Averaging Interval Air PressureminRead and write
Averaging Interval WindminRead and write
Averaging Interval Global RadiationminRead and write
Heating ModeRead and write
Reset Absolute RainWrite
Device ResetWrite
Fan On/OffRead and write
Fan On/AutomaticRead and write
Wind Heating OffRead and write
R2S Heating OffRead and write
Power Saving Mode 1Read and write
IdentificationRead
Run TimesRead

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Number of installations (optional)

Use cases

  • Show outside temperature, humidity, global radiation and wind from the greenhouse roof on one ModbusCloud dashboard.
  • Get an email alarm when the maximum wind speed exceeds your limit, so you can check that vents and screens have closed.
  • Set an alarm on precipitation type not equal to 0 to know as soon as rain or snow starts, for example to check the roof vents.
  • Compare global radiation and outside temperature over 365 days of history to review the growing season.
  • Set an alarm on Device Status not equal to 0 to hear about a system error right away.
  • Correct the station altitude or an averaging interval from the portal without climbing onto the roof.

Installation

  1. Mount the sensor on top of a mast at least 2 m above the ground with a free view, align the north marking for wind, and keep the radiation sensor free of shadow.

  2. Connect green (A) and yellow (B) to the RS485 port of the ModbusCloud Gateway and terminate the bus ends. Connect white and brown to the 24 V DC supply and blue and red to the heating supply.

  3. Switch the protocol from UMB to Modbus RTU in ConfigTool.NET and note the device ID, which is also the Modbus address (1 by default).

  4. In ModbusCloud, add a Modbus device with that address, 19200 baud, 8 data bits, even parity and 1 stop bit, and import this template.

  5. Wait about 10 seconds after power-up, then check that air temperature and device status arrive. Write the local altitude so the relative air pressure is correct.

Things to watch for

The weather sensor does not answer. What should I check?

The sensor ships with the UMB protocol at 19200 8N1, not with Modbus. Switch it to Modbus RTU in ConfigTool.NET first; 19200 baud with even parity is then preselected. The Modbus address equals the UMB device ID, 1 by default. Then swap A and B. In power saving mode 2 the sensor has no Modbus at all, so use normal operation or power saving mode 1.

Why do some values show 3276.7 or 655.35?

Each variant has its own sensors. The WS200-UMB measures only wind, global radiation is only on the WS301 to WS310, WS501 to WS510, WS700 and WS800, and lightning only on the WS800-UMB. A value the variant does not measure, or cannot measure right now, carries the error value 32767 or 65535, shown scaled. Right after power-up the sensor needs about 10 seconds.

Why does the precipitation difference stay low?

Every read of Precipitation Difference resets it to zero, so it only shows the rain since the previous read. For a running total use Precipitation Absolute, which stops at 655.34 mm. Write 12871 to Reset Absolute Rain to start again from zero; the sensor then restarts.

Why is the relative air pressure wrong?

Relative air pressure is calculated from the station altitude, 0 m from the factory, so both pressure values are equal until you set it. Write the altitude of the site in metres to Local Altitude. For the compass corrected wind direction, also write the local magnetic declination to Compass Deviation.

Why does a fan or heater change not stick?

The fan and heater coils you write only hold until the next reset; then the sensor returns to its configured mode. The power saving coil is stored but only works after a reset, so write 12871 to Device Reset. A heating mode the variant lacks is adjusted by the sensor. With the fan off, sunshine can push the temperature up and the humidity down.

Want to see how it works?

Electrician working in an open distribution board