Atmospheric monitoring app for logging and graphing temperatures and humidities over time using a Raspberry Pi and DS18B20, DHT11, DHT22, and AM2302 sensor(s).

This project has two main pieces:

1. some simple Python scripts that run on cron to gather data from attached sensors, and
2. a Flask web application for viewing the data in graph form via a web browser.

A Puppet script is provided for automating the setup process. All you need to do is hook up your sensors, install Raspbian, and run the commands below. Alternatively, there are manual setup instructions further below. (Note: currently only DS18B20 sensors are set up by the Puppet script. DHTxx sensors are not.)

Currently this documentation assumes you are running Raspian on a Raspberry Pi.

ssh pi@[hostname]
git clone https://github.com/mstenta/atmospi.git
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install puppet
./atmospi/puppet/puppet-apply.sh

You also need to follow step 6 (Create a SQLite database called log.db in the atmospi directory) in Manual Setup below, to create your log.db file.

1. SSH into Raspberry Pi

   ssh pi@[hostname]

2. Upgrade all packages.

   sudo apt-get update sudo apt-get upgrade

3. Install SQLite3 and Apache2 with the WSGI module.

   sudo apt-get install sqlite3 apache2 libapache2-mod-wsgi

4. Install Flask via PIP.

   sudo apt-get install python-pip sudo pip install Flask

5. Clone the repository into pi's home directory.

   git clone https://github.com/mstenta/atmospi.git

6. Create a SQLite database called log.db in the atmospi directory.

   $ sqlite3 log.db << EOF CREATE TABLE Devices(DeviceID INTEGER PRIMARY KEY, Type TEXT, SerialID TEXT, Label TEXT); CREATE TABLE Temperature(DeviceID INT, Timestamp INT, C REAL, F REAL); CREATE TABLE Humidity(DeviceID INT, Timestamp INT, H REAL); CREATE TABLE Flag(DeviceID INT, Timestamp INT, Value TEXT); CREATE INDEX temperature_dt ON Temperature(DeviceID, Timestamp); CREATE INDEX humidity_dt ON Humidity(DeviceID, Timestamp); CREATE INDEX flag_dt ON Flag(DeviceID, Timestamp); EOF

7. Add the Apache virtual host (provided) and restart Apache.

   $ source init-vhost.sh $ sudo ln -sf $PWD/000-atmospi.conf /etc/apache2/sites-enabled/ $ sudo apache2ctl restart

Refer to Adafruit's tutorial for connecting the DS18B20 sensors: http://learn.adafruit.com/adafruits-raspberry-pi-lesson-11-ds18b20-temperature-sensing/hardware

Note that you can connect as many DS18B20 sensors to your Pi as you'd like. Atmospi will automatically detect them and log their measurements.

If you use the Puppet script to install, a cron job is already set up to take measurements. If you are setting up manually, do the following:

0. To use OWFS-based temperature reading:

   $ sudo apt-get install owfs owfs-fuse $ modprobe -r ds9490r $ modprobe -r ds2490 4 modprobe -r wire

1. Set up measure-ds18b20.py to run on a cron job as root.

   sudo crontab -e */5 * * * * /home/pi/atmospi/Atmospi/measure-ds18b20.py >/dev/null 2>&1

2. Alternatively (using OWFS):

   sudo crontab -e */5 * * * * /home/pi/atmospi/Atmospi/measure-ds18b20-from-owfs.py

OPTIONAL) Sensors will be automatically labeled with their serial ID. If you would like to change this label, run the following query for each sensor:

UPDATE Devices SET Label = "New label" WHERE Type = 'ds18b20' AND SerialID = '28-000000000001';

Refer to Adafruit's tutorial for connecting the sensors: http://learn.adafruit.com/dht-humidity-sensing-on-raspberry-pi-with-gdocs-logging/wiring

While Raspbian comes with libraries for reading temperature from DS18B20 sensors, reading from a DHTxx humidity and temperature sensor is a little more involved. The Puppet script (automatic install) DOES NOT set up automated DHT reading, so you need to do that manually, by following the instructions below.

Also note that you can connect as many DHT sensors to your Pi as you'd like, but each requires its own data pin. Unlike the DS18B20 sensors, Atmospi cannot automatically detect DHT sensors, so you need to specify which ones are connected in your config.py file (see below).

1. Install python-dev.

   sudo apt-get install python-dev

2. Build the dhtreader.so library using the setup.py and dhtreader.c files in Adafruit's DHT Python Driver example: https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code/tree/master/Adafruit_DHT_Driver_Python

   cd ~ git clone https://github.com/adafruit/Adafruit_Python_DHT.git cd Adafruit_Python_DHT sudo python setup.py install

3. Insert rows into the Devices database to describe each of your sensors. For example:

   INSERT INTO Devices (DeviceID, Type, SerialID, Label) VALUES (NULL, 'dht22', '22', 'Upstairs DHT22');

4. Set up measure-dht.py to run on a cron job as root.

   sudo crontab -e */5 * * * * /home/pi/atmospi/Atmospi/measure-dht.py >/dev/null 2>&1