drivers.lufft_weather_station

This is a ROS 2 driver for communicating with Lufft UMB weather sensors via serial port.

https://github.com/molisens-mosep/drivers.lufft_weather_station

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.8%) to scientific vocabulary

Keywords

driver lufft ros2 weather-station
Last synced: 6 months ago · JSON representation ·

Repository

This is a ROS 2 driver for communicating with Lufft UMB weather sensors via serial port.

Basic Info
  • Host: GitHub
  • Owner: MOLISENS-MOSEP
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 34.2 KB
Statistics
  • Stars: 1
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
driver lufft ros2 weather-station
Created over 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme Citation

README.md

Luff-UMB Weather Sensor ROS 2 driver

Description

This is a ROS 2 driver for communicating with Lufft UMB weather sensors via serial port.

Requirements

The tested ROS distribution is Humble, but it should work with other ROS 2 distributions as well. Any Lufft sensor that supports UMB should work. For connection a RS482 to USB adapter was used. If a weather parameter is missing it can be added in LufftWSXXX.msg.

The driver was successfully tested with the following devices:

  • WS501-UMB
  • WS600-UMB
  • WS100 Radar Precipitation Sensor

Additional resources:

Installation

Install like any other ROS 2 package. Clone the repository into the src folder in your workspace and build it with colcon build.

Usage

Adapt the config file at lufft_wsx_launch/param/lufft_wsx.yaml to your needs and run:

bash ros2 launch lufft_wsx_launch lufft_wsx.launch.py

For a multi-sensor setup check out lufft_wsx_launch/launch/lufft_wsx_multi.launch.py.

Configuration

The driver is configured via a YAML file. The default configuration file is config/lufft_umb_ws501.yaml. The following parameters can be set:

  • query_interval (float): Defines the interval between two queries to the sensor in seconds. Messages will be published at the same interval (i.e.: 10.0).
  • umb_channels (list): List of the UMB channels to querry separated by a comma (i.e.: [113, 620]). For all available channels of your sensor see weather sensors manual above.
  • device (str): The port where the sensor is connected (i.e.: "/dev/rs485adapter0").
  • baudrate (int): # Baudrate of that port (i.e.: 19200).
  • device_id (int): # The device ID of the sensor as configured in the Lufft software (i.e.: 1).

Contributing

Always open for PRs :)

Authors and acknowledgment

This project is based on the work of Pascal Deneaux who did the heavy lifting regarding the binary protocol translation and Aleksi Narkilahti who added multichannel queries and an English translation.

Owner

  • Name: MOLISENS-MOSEP
  • Login: MOLISENS-MOSEP
  • Kind: organization
  • Email: christoph.gaisberger@uni-graz.at

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: Gaisberger
    given-names: Christoph
    orcid: https://orcid.org/0000-0001-5295-3338
title: "ROS 2 driver for Luff-UMB Weather Sensor"
version: 1.0
date-released: 2025-02-14

GitHub Events

Total
  • Watch event: 1
  • Public event: 1
Last Year
  • Watch event: 1
  • Public event: 1

Dependencies

lufft_wsx/setup.py pypi
  • setuptools *