PiWebSense

Milestones

Milestone 1

The Goal is to display and visualize data received/measured from a Raspberry Pi on a webinterface.

Milestone 2

The Raspberry Pi should be integratable to a Home Assistant Server and be used as as sensor input and opitionally logic level output.

Milestone 3

Data should be sent and received via MQTT to an ESP32. The Pi acts as a sensor gateway.

Tech Stack / Hardware Requirements

• Raspberry Pi: Model 4
• Programming languages: Python, jinja2
• Frameworks/tools/Libraries:
  • Webserver:
    • Flask
    • Json
  • Sensors: Temperature,
• Sensors:
  • LDR (Lightsensor)
  • Sound Detector
  • Temperature
  • Temperature and humidity
  • ...

Docs

• The data needs to be providet in the following format:

      {
      "location": "Building A - Lab 3",
      "sensors": [
        {
          "id": "sensor_001",
          "type": "temperature",
          "unit": "°C",
          "readings": [
            { "ts": 1747814400, "value": 22.5 },
            { "ts": 1747818000, "value": 23.0 },
            { "ts": 1747821600, "value": 23.7 }
          ]
        },
        {
          "id": "sensor_002",
          "type": "humidity",
          "unit": "%",
          "readings": [
            { "ts": 1747814400, "value": 45.2 },
            { "ts": 1747818000, "value": 47.1 },
            { "ts": 1747821600, "value": 46.8 }
          ]
        },
        {
          "id": "sensor_003",
          "type": "pressure",
          "unit": "hPa",
          "readings": [
            { "ts": 1747814400, "value": 1012.4 },
            { "ts": 1747818000, "value": 1012.8 },
            { "ts": 1747821600, "value": 1013.0 }
          ]
        }
      ]
    }
  

• requirements.txt This file holds the requirements for pip

• shell.nix This file is only used on nixos and for the nix packagemananger

• .envrc This is also a bit of linuz nixos magic to automatically set up the development environment using direnv

• main.py The main file for the project

• The Graphs https://ron.sh/creating-real-time-charts-with-fastapi/

Git Help

MarkDown Help

Html Help

Arbeitsaufträge / Aufgabeneinteilung

Zu Vergeben

• Präsentation

Kieler	Chiara
Git	Daten von RPI erfassen und sauber abspeichern
Readme
Daten an einem Webserver anzeigen

Acknowledgments

Chiara Kieler

License

PiWebSense Copyright (C) 2025 Kieler, Chiara

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License Version 3.0 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.