raspi_air

Project Description

This project is designed to read data from a SDS011 sensor and a Homematic device connected to a Raspberry Pi and log the data to an adafruit dashboard.

Experimental App

This is an experimental app to read data via pypms from an SDS011 sensor and send it to an Adafruit dashboard. The app leverages advanced sensor reading techniques and cloud integration to provide real-time data visualization and monitoring. By utilizing the pypms library, the app ensures accurate and efficient data collection from the SDS011 sensor. The integration with the Adafruit dashboard allows for seamless data transmission and visualization, enabling users to monitor air quality metrics in real-time.

Dependencies

• pms
• python-dotenv
• pyhomematic

Installation

1. Clone the repository:

   git clone https://github.com/DerSchimi/raspi_air.git
   cd raspi_air

2. Install the required dependencies:

   pip install flask pms python-dotenv pyhomematic

3. Create a .env file in the project directory and add your Adafruit IO credentials:

   ADAFRUIT_IO_USERNAME=your_username
   ADAFRUIT_IO_KEY=your_key
   

4. Set up your Homematic device:

   • Ensure your Homematic device is connected and configured correctly.
   • Replace the placeholder device_address in the logTemp.py script with your actual Homematic device address.

Usage

1. To read data from the SDS011 sensor and send it to the Adafruit dashboard every 5 seconds, run:

   python logLive.py

2. To read data from the SDS011 sensor and log it to a CSV file every 5 minutes, run:

   python logNormal.py

3. To read temperature data from the Homematic device and send it to the Adafruit dashboard every 5 minutes, run:

   python logTemp.py

4. Create a config.ini file in the project directory with the following content:

   [AUTH]
   authtoken=your_auth_token
   accesspoint=your_access_point

Device Map Configuration

Create a devices.json file in the root directory of your project with the following content:

{
    "3014F711A0000314C98CC0B3": "tempwohnzimmer",
    "3014F711A0000A9AE991DED0": "tempgaestewc",
    "3014F711A0020313C98CC097": "tempkinderzimmer",
    "3014F711B0000A9A499947EC": "tempbadezimmer"
}

Contributing

Contributions are welcome! Please follow these guidelines when contributing to the project:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Make your changes.
4. Submit a pull request with a clear description of your changes.