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
Repository
This is a ROS 2 driver for communicating with Lufft UMB weather sensors via serial port.
Basic Info
Statistics
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
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:
- Lufft UMB protocol
- WS series weather sensors manual - from February 2024
- WS series weather sensors manual - before February 2024
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
- Repositories: 1
- Profile: https://github.com/MOLISENS-MOSEP
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
- setuptools *