luftdaten-influxdb

A tool for collecting and storing data from Luftdaten sensors into an InfluxDB database.

Features

• Fetches air quality data from Luftdaten sensors
• Stores sensor data in InfluxDB for easy querying and visualization
• Runs a configurable HTTP server to receive data from airRohr sensors (set as a custom API endpoint in the sensor firmware)

Configuration

Create a config.json file in the project directory with the following structure:

{
    "influxdb": {
        "url": "your-influx-url",
        "token": "your-token",
        "org": "your-org",
        "bucket": "your-bucket"
    },
    "server": {
        "port": 4444
    }
}

• influxdb.url: URL of your InfluxDB instance.
• influxdb.token: InfluxDB API token.
• influxdb.org: Your InfluxDB organization.
• influxdb.bucket: The bucket where data will be stored.
• server.port: Port for the HTTP server.

Usage

1. Install dependencies:

   pip install -r requirements.txt

2. Start the server:

   python main.py

3. Configure your airRohr sensor to send data to http://<your-server>:4444/.

How it works

• The tool starts an HTTP server on the configured port.
• airRohr sensors send their measurements as HTTP POST requests.
• The server receives the data and writes it to the specified InfluxDB bucket.

Visualization

You can use Grafana or InfluxDB UI to visualize and analyze your air quality data.

Acknowledgements

• Luftdaten.info for providing open sensor data and documentation.
• InfluxDB for the time-series database.
• Grafana for visualization tools.
• Contributors to the open-source libraries used in this project.

License

MIT License