A Python application for reading weather data from Davis Instruments weather stations via a Meteostick USB receiver. The application can display real-time weather data and optionally send it to InfluxDB for storage and visualization.

Features

Real-time weather data collection from Davis weather stations
Support for multiple sensor types (ISS, anemometer, temperature/humidity sensors)
InfluxDB integration for data storage
Docker support for easy deployment
Configurable via environment variables
Token-based authentication for InfluxDB

Supported Sensors

ISS (Integrated Sensor Suite): Temperature, humidity, wind speed/direction, rain
Anemometer Kit: Additional wind measurements
Temperature/Humidity Sensors: Up to 2 additional T/H sensors
Leaf/Soil Station: Soil moisture and temperature sensors

Requirements

Python 3.7+
Meteostick USB device
Davis Instruments weather station transmitters
InfluxDB (optional, for data storage)

Installation

Python Dependencies

pip install pyserial influxdb

Docker (Recommended)

Clone this repository
Create a .env file (see configuration below)
Build and run with Docker Compose:

docker-compose up --build

Configuration

Environment Variables

The application is configured using environment variables. Create a .env file in the project root:

# Meteostick Hardware Configuration
METEOSTICK_PORT=/dev/ttyACM0
METEOSTICK_BAUDRATE=115200
METEOSTICK_FREQUENCY=EU
METEOSTICK_RF_SENSITIVITY=90

# Weather Station Channels (1-8, or 0 to disable)
METEOSTICK_ISS_CHANNEL=1
METEOSTICK_ANEMOMETER_CHANNEL=0
METEOSTICK_LEAF_SOIL_CHANNEL=0
METEOSTICK_TH1_CHANNEL=0
METEOSTICK_TH2_CHANNEL=0

# Rain Bucket Type (0=0.01in, 1=0.2mm)
METEOSTICK_RAIN_BUCKET=1

# InfluxDB Configuration
METEOSTICK_ENABLE_INFLUXDB=true
METEOSTICK_INFLUXDB_HOST=localhost
METEOSTICK_INFLUXDB_PORT=8086
METEOSTICK_INFLUXDB_DB=weather
METEOSTICK_INFLUXDB_MEASUREMENT=meteostick
METEOSTICK_INFLUXDB_TOKEN=your_influxdb_token_here

Configuration Options

Variable	Default	Description
`METEOSTICK_PORT`	`/dev/ttyUSB0`	Serial port for Meteostick device
`METEOSTICK_BAUDRATE`	`115200`	Serial communication baud rate
`METEOSTICK_FREQUENCY`	`EU`	RF frequency: `US`, `EU`, or `AU`
`METEOSTICK_RF_SENSITIVITY`	`90`	RF sensitivity (0-125)
`METEOSTICK_ISS_CHANNEL`	`1`	ISS transmitter channel (1-8)
`METEOSTICK_ANEMOMETER_CHANNEL`	`0`	Anemometer channel (0=disabled, 1-8)
`METEOSTICK_LEAF_SOIL_CHANNEL`	`0`	Leaf/soil station channel (0=disabled, 1-8)
`METEOSTICK_TH1_CHANNEL`	`0`	T/H sensor 1 channel (0=disabled, 1-8)
`METEOSTICK_TH2_CHANNEL`	`0`	T/H sensor 2 channel (0=disabled, 1-8)
`METEOSTICK_RAIN_BUCKET`	`1`	Rain bucket type: 0=0.01in, 1=0.2mm
`METEOSTICK_ENABLE_INFLUXDB`	`false`	Enable InfluxDB data logging
`METEOSTICK_INFLUXDB_HOST`	`localhost`	InfluxDB server hostname
`METEOSTICK_INFLUXDB_PORT`	`8086`	InfluxDB server port
`METEOSTICK_INFLUXDB_DB`	`weather`	InfluxDB database name
`METEOSTICK_INFLUXDB_MEASUREMENT`	`meteostick`	InfluxDB measurement name
`METEOSTICK_INFLUXDB_TOKEN`	-	InfluxDB authentication token

Usage

Direct Python Execution

# Basic usage with console output only
python meteostick_reader.py --port /dev/ttyACM0

# With InfluxDB logging
python meteostick_reader.py --port /dev/ttyACM0 --enable-influxdb --influxdb-token "your_token"

# All options via command line
python meteostick_reader.py \
  --port /dev/ttyACM0 \
  --freq EU \
  --iss-channel 1 \
  --enable-influxdb \
  --influxdb-host influxdb.example.com \
  --influxdb-token "your_token"

Docker Compose

# Start the service
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the service
docker-compose down

Output Format

Console Output

The application displays real-time weather data:

[2023-12-07 14:30:15] Message #123: I 1 0 48 89 8A 12 34 56 78 9A BC DE 95 1234567 0
  Parsed data: {'channel': 1, 'temperature': 18.5, 'humidity': 65.0, 'wind_speed': 2.3, 'wind_dir': 225.0, 'rf_signal': 95}

InfluxDB Data

Data is stored in InfluxDB with the following structure:

Measurement: Configurable (default: meteostick)
Tags: channel (transmitter channel)
Fields: Weather data (temperature, humidity, wind_speed, wind_dir, pressure, etc.)
Timestamp: UTC timestamp when data was received

Troubleshooting

Serial Port Issues

Ensure the Meteostick device is connected and recognized by the system
Check permissions: sudo usermod -a -G dialout $USER
Verify the correct port with ls /dev/tty*

InfluxDB Connection Issues

Verify InfluxDB is running and accessible
Check authentication token validity
Ensure the database exists or the token has creation permissions

No Weather Data

Verify weather station transmitters are within range
Check RF sensitivity settings
Ensure correct channel configuration
Verify transmitter battery levels

License

This project is based on the WeewX meteostick driver and is released under the same license terms.

Contributing

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

Support

For issues and questions:

Check the troubleshooting section
Review Davis Instruments documentation
Open an issue on the project repository