/DATIV

DATIV-Dynamic Aerosol Transport for Indoor Ventilation with Smart Array of Particulate MAtter Sensors (SAPMAS)

Primary LanguagePythonApache License 2.0Apache-2.0

DATIV-Dynamic Aerosol Transport for Indoor Ventilation with Smart Array of Particulate MAtter Sensors (SAPMAS)

Web Interface

Camera Web Interface

WebInterface PM Sensor

PM Sensor Web Interface

WebInterface Camera

License

Licensed under the Apache License, Version 2.0.

Please have a look at Apache-2.0 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

User Manual

The user manual can be found here: User Manual

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://<rpi-ip-address>: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.

Notes

Additional notes are here.

API

The camera can be remote controlled with a set of HTTP requests.

TODO

  • Build-in particle/object detection