# 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: ```Json { "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 ![A Git Cheatsheet](images/gitHelp.png "Git Cheatsheet") ### MarkDown Help ![A MarkDown Cheatsheet](images/mdHelp.png "MarkDown Cheatsheet") ### Html Help ![A Html Cheatsheet](images/htmlHelp.png "Html Cheatsheet") ### Css Help ![A Css Cheatsheet](images/cssHelp.png "Css Cheatsheet") ### JavaScript Help ![A JavaScript Cheatsheet](images/javascriptHelp.png "JavaScript Cheatsheet") ### Jinja Help ![A Jinja Cheatsheet](images/jinjaHelp.png "Jinja Cheatsheet") ## 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](https://git.miaig.dev/chiara) [Kieler](https://git.miaig.dev/mia) ### 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 .