https://github.com/chsc/dativ
DATIV-Dynamic Aerosol Transport for Indoor Ventilation with Smart Array of Particulate MAtter Sensors (SAPMAS)
https://github.com/chsc/dativ
aerosol camera covid-19 particles particulate-matter pm sensors ventilation wi-fi
Last synced: 3 months ago
JSON representation
DATIV-Dynamic Aerosol Transport for Indoor Ventilation with Smart Array of Particulate MAtter Sensors (SAPMAS)
- Host: GitHub
- URL: https://github.com/chsc/dativ
- Owner: chsc
- License: apache-2.0
- Created: 2023-12-05T10:00:35.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-11T09:45:41.000Z (over 2 years ago)
- Last Synced: 2024-01-29T10:49:58.308Z (over 2 years ago)
- Topics: aerosol, camera, covid-19, particles, particulate-matter, pm, sensors, ventilation, wi-fi
- Language: Python
- Homepage:
- Size: 13.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# DATIV-Dynamic Aerosol Transport for Indoor Ventilation with Smart Array of Particulate MAtter Sensors (SAPMAS)
## Web Interface
### Camera Web Interface
### PM Sensor Web Interface
## License
Licensed under the **Apache License, Version 2.0**.
Please have a look at [Apache-2.0 License](LICENSE) for more information.
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
## Authors and how to contribute
* [Authors](AUTHORS.md)
* [How to contribute](CONTRIBUTING.md)
## User Manual
The user manual can be found here: [User Manual](doc/UserManual.pdf)
## Quick Install
Clone the repository to `/home/pi`:
git clone https://gitlab.hzdr.de/hzdri/ext/rpimicro.git
Change to the `rpimicro` directory and run `setup.sh`!
**Before you run the script, make shure you have enabled the camera.
You can use the `raspi-config` tool to do this (*see Interface Options*).**
## Standard Install
Before you begin, please make shure your system is up-to-date.
Run
sudo apt update
sudo apt full-upgrade
to do this.
You also need to install the following additional software packages:
* **Python** 3.x
* **Flask** Web Framework
* **OpenCV** for Python
* **Pi Camera** Python Modules
* **PySerial** package for UART connections
Open the command line to install the required software packages:
sudo apt-get install python3
sudo apt-get install python3-pip
sudo apt-get install python3-flask
sudo apt-get install python3-opencv
sudo apt-get install python3-picamera
pip3 install -U flask-cors
pip3 install -U netifaces
pip3 install -U pyserial
Now, start and install the service using systemd (works only if repsitory is cloned to /home/pi/rpimicro):
sudo install rpimicro/systemd/rpimicro.service /etc/systemd/system
sudo systemctl enable rpimicro
sudo systemctl start rpimicro
**Make shure to enable the camera interface before runnig the service!**
## Web Interface
Open your browser and enter the following URL:
http://:5000
or
http://localhost:5000
if you are running it on the Pi itself.
## Network Setup
A detailed description on how to setup a camera network can be found [here](doc/NETWORK.md).
## Notes
Additional notes are [here](doc/NOTES.md).
## API
The camera can be remote controlled with a set of [HTTP requests](doc/API.md).
## TODO
* Build-in particle/object detection