{"id":3660,"date":"2014-07-21T20:28:22","date_gmt":"2014-07-21T19:28:22","guid":{"rendered":"http:\/\/www.haydnwilliams.com\/blog\/?p=3660"},"modified":"2022-04-11T21:33:00","modified_gmt":"2022-04-11T20:33:00","slug":"rpi-airpi-air-quality-station-setup","status":"publish","type":"post","link":"https:\/\/www.haydnwilliams.com\/blog\/rpi-airpi-air-quality-station-setup\/","title":{"rendered":"RPi \/ AirPi air quality station – Setup"},"content":{"rendered":"

I’ve recently been working with the Atmospheric Chemistry group<\/a> at the University of Leicester, setting up some AirPis. The AirPi is a small board<\/a> which pairs with a Raspberry Pi<\/a>, and reads a number of air quality measures. There will doubtless be future posts about the software, sensor accuracy and reliability, etc<\/em>., but this one is about just setting the thing up in the first place.<\/p>\n

\"AirPi

AirPi on top of a Raspberry Pi. \u00a9\u00a0Haydn Williams 2014<\/p><\/div>\n

Step one is to get the Raspberry Pi up and running. I downloaded Raspian Wheezy from the official Raspberry Pi downloads website<\/a>, and installed it using the SD card slot on my Macbook Pro, although there are instructions for other OSes too<\/a>.<\/p>\n

Once it’s installed and the Pi is running, we need to change the password for the default account to something else. You can do this through the “advanced” menu of the initial config screen when the machine first boots. Alternatively boot the machine yourself manually, log in as the default account (username: pi<\/em>, password: raspberry<\/em>) and run the following:<\/p>\n

passwd<\/pre>\n
You can also use that initial config screen\u00a0to set the hostname for the machine (in the “advanced” section) and to disable SSH if you’re not going to be using it.<\/p>\n
Now, set the time zone:<\/p>\n
sudo\u00a0dpkg-reconfigure tzdata<\/pre>\n
Set up Networking<\/strong>
\nNext we’ll want some kind of internet connectivity. If you’ve got a Model B board then you’ve got an ethernet port and everything is very easy. If you’re on a Model A board then it gets a bit more difficult – the easiest option is a USB-to-ethernet adapter and SSH. A\u00a0plus is that when the AirPi is running in the field and recording data locally you don’t have to worry about security issues because you can just unplug the adapter. Alternatively you can go with wifi – I used the Edimax EW-7811Un<\/a> because it’s (allegedly) supported by Raspian Wheezy, so there was no messing\u00a0around with extra drivers. There are lots of instructions out there about how to get wifi working once your dongle is running; I’m sure some are better than others, but these<\/a> worked for me. They only worked for a short time however; the USB-to-ethernet option proved the easiest and most reliable in the long-run.<\/p>\n
You can edit ‘\/etc\/network\/interfaces’ to set up your network options. There are plenty of instructions<\/a> out there, but for wired access it might look like this (although I’ve fudged the IPs in the example below):<\/p>\n
\r\nauto lo\r\n\r\niface lo inet loopback\r\n\r\n# Haydn's House\r\n#==============\r\niface eth0 inet static\r\naddress 192.168.0.123\r\nnetmask 255.255.255.0\r\nnetwork 192.168.0.1\r\nbroadcast 192.168.0.255\r\ngateway 192.168.0.254\r\nnameserver 192.168.0.1\r\n<\/pre>\n
Note that you may sometimes need to also put DNS details in \/etc\/resolv.conf<\/a><\/p>\n
Upgrade Software<\/strong>
\nOnce you’ve got internet, it’s time to update everything which has been updated since your version of the OS was released:<\/p>\n
\r\nsudo apt-get update\r\nsudo apt-get upgrade\r\n<\/pre>\n
It’ll take some time, depending on your internet connection speed.<\/p>\n
Disable hardware<\/strong>
\nIf appropriate, you can disable the onboard sound<\/a> card:<\/p>\n
\r\nsudo vi \/etc\/modules\r\n# Then make sure there is a hash sign (#) in front of the snd-bcm385 line - it should look like this:\r\n\r\n# \/etc\/modules: kernel modules to load at boot time.\r\n#\r\n# This file contains the names of kernel modules that should be loaded\r\n# at boot time, one per line. Lines beginning with "#" are ignored.\r\n# Parameters can be specified after the module name.\r\n\r\n#snd-bcm2835\r\n<\/pre>\n
and one more thing<\/a>…<\/p>\n
\r\nsudo vi \/etc\/modprobe.d\/raspi-blacklist.conf\r\n\r\n# Then add the line below at the end:\r\nblacklist snd_soc_pcm512x\r\n<\/pre>\n
Another thing you might want to consider\u00a0is to force output over HDMI<\/a> (i.e.<\/em> never\u00a0revert to\u00a0component out). Just add the following line to \/boot\/config.txt:<\/p>\n
hdmi_force_hotplug=1<\/pre>\n
This is useful because in the absence of an HDMI connection at startup (e.g.<\/em> if the Pi is started headless in the field), it defaults to component-out being active. Setting the above option means that HDMI is always activated, so you can bring the Pi back to the office running on batteries and plug it straight into a monitor without having to reboot. This means you can also use the monitor to stop processes gracefully etc<\/em>., which you might not have been able to do in the field without a monitor. Nice.<\/p>\n
At this point, you might want to give some though as to whether you’ll be accessing the data by SSH or SFTP on the Pi, or inserting the SD card into another computer. If it’s the latter, it’s probably best to read the section about creating a FAT partition in my post on advanced usage. It’s not pretty, but don’t say I didn’t warn you! \u00a0:)<\/p>\n
 <\/p>\n
Now we can prepare for the AirPi.<\/h2>\n
The AirPi.es website<\/a> is not being maintained at the moment (July 2014), and there are several sets of instructions floating around about how to set the board recording data. I’ve outlined below the method I used, which seemed to work fine.<\/p>\n
Install git and some python tools<\/strong>
\nGit<\/a> is to help us download various bits of code, a number of different Python<\/a> tools because that’s what the AirPi code is written in, i2c tools because that’s how one of the sensors communicates.<\/p>\n
If you’re running an old version of Raspbian then you’ll need to install quite a lot of stuff:<\/p>\n
sudo apt-get install git-core python-dev python-smbus python-setuptools python-requests python3 python3-dev python3-requests libxml2-dev libxslt1-dev python-lxml gpsd gpsd-clients python-gps i2c-tools<\/pre>\n
I have most recently done this with the 20th June 2014 release, in which git-core, RPi.GPIO and python3 already installed. This means you have marginally less to do:<\/p>\n
sudo apt-get install python-dev python-smbus python-setuptools python-requests python3-dev python3-requests libxml2-dev libxslt1-dev python-lxml i2c-tools<\/pre>\n
 <\/p>\n
What You Don’t Need<\/strong>
\nContrary to other installation instructions floating around, you do not<\/strong> need to install Python EEML (it’s no longer used in the AirPi code), nor do you need to use PIP to install requests or rpi.gpio (they’re both installed using apt-get along with everything else above).<\/p>\n
 <\/p>\n
Install Twitter support for Python<\/strong>
\nThis is used to Tweet when there is an error, via the new ‘notifications’ module.<\/p>\n
\r\neasy_install twitter\r\n<\/pre>\n
 <\/p>\n
Set up i2c<\/abbr><\/strong>
\ni2c<\/a> is the bus over which the BMP085 pressure sensor communicates with the main Raspberry Pi. There are some good instructions here<\/a>, summarised below.<\/p>\n
\r\nsudo vi \/etc\/modprobe.d\/raspi-blacklist.conf\r\n\r\n# Comment out the third line in raspi-blacklist.conf (blacklist i2c-bcm2708)\r\n\r\nsudo vi \/etc\/modules\r\n\r\n# Add "i2c-dev" (no quotes) onto a new line\r\n\r\nsudo adduser pi i2c\r\nsudo reboot\r\n\r\nsudo i2cdetect -y 1\r\n# If the AirPi is accurately detected over i2c, you should see the following:\r\n# 0 1 2 3 4 5 6 7 8 9 a b c d e f\r\n# 00: -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --\r\n# 70: -- -- -- -- -- -- -- 77\r\n<\/pre>\n
 <\/p>\n
Test the GPS<\/strong>
\nIf you’re using an Adafruit Ultimate GPS on your AirPi board, you can enable support<\/a> by running the following:<\/p>\n
\r\nsudo gpsd \/dev\/ttyAMA0 -F \/var\/run\/gpsd.sock\r\n<\/pre>\n
and then check it’s correctly reporting your location:<\/p>\n
\r\ncgps -s\r\n<\/pre>\n
Note that you’ll need to run the gpsd command after each reboot to start the daemon again (or make it run on startup<\/a>).<\/p>\n
 <\/p>\n
Get the AirPi code<\/strong>
\nThis is the code which will take data from the sensors and either print to screen, save, or upload to an online service. There are a few different packages available – the rest of this post will assume you use one of the first three (all variations of the original code):<\/p>\n
    \n
  1. The original Python-based AirPi.es code: https:\/\/github.com\/tomhartley\/AirPi<\/a><\/li>\n
  2. A revised version which includes CSV output:\u00a0https:\/\/github.com\/guruthree\/AirPi<\/a><\/li>\n
  3. My further-revised version which has a couple of tweaks for running headless:\u00a0https:\/\/github.com\/haydnw\/AirPi<\/a><\/li>\n
  4. oswabox<\/a> – Written in C and therefore needs compiling. Didn’t work for me, but the developers are promising great things:\u00a0https:\/\/github.com\/mgrennan\/oswabox<\/a><\/li>\n
  5. For node.js users, there is support for the BMP085<\/a>, but seemingly not much else.<\/li>\n
  6. There is also a nitrogenjs<\/a> package which supports the BMP085<\/a> (and it’s replacement, the BMP100).<\/li>\n
  7. There has been work to support<\/a> the emoncms<\/a>\u00a0package in the original software; emoncms is described as providing “open-source energy visualisation<\/em>“.<\/li>\n<\/ol>\n
    To download and use my version of the code, do the following:<\/p>\n
    \r\ncd ~\r\ngit clone https:\/\/github.com\/haydnw\/AirPi\r\n<\/pre>\n
     <\/p>\n
    Add the AirPi folder to $PATH<\/strong>
    \nThis means that you can refer to the main airpictl.sh script without having to type the full path or ‘.\/’ each time you want to run it. I’ve assumed that the software is installed at ‘~\/AirPi’.<\/p>\n
    \r\nsudo vi ~\/.profile\r\n\r\n# Then add the following to the end of the file:\r\nexport PATH=$PATH:\/home\/pi\/AirPi\r\n<\/pre>\n
     <\/p>\n
    Add a Login Message<\/strong>
    \nThis step is entirely optional, but adds a nice     message when a user logs in<\/a> and displays the current status of the AirPi, like so:<\/p>\n
    \r\n=======================================================================\r\n        _               _  _\r\n  __ _ (_) _ __  _ __  (_)\/ |\r\n \/ _` || || '__|| '_ \\ | || |\r\n| (_| || || |   | |_) || || |\r\n \\__,_||_||_|   | .__\/ |_||_|\r\n                |_|\r\nIP: 123.321.12.33\r\n[AirPi] Status: SAMPLING\r\n=======================================================================\r\nairpi1:~ $\r\n<\/pre>\n
    First we’ll install figlet so that we can produce the banner.<\/p>\n
    \r\nsudo apt-get install figlet\r\n<\/pre>\n
    Then create the new dynamic “message of the day” file ‘\/usr\/local\/bin\/motddynamic’ as below:<\/p>\n
    \r\n#!\/bin\/sh\r\n\r\n# =========================================\r\n# File:    motddynamic\r\n# Purpose: Show hostname and IP on login.\r\n#\u00a0Author:  Haydn Williams <pi@hwmail.co.uk>\r\n# Date:    August 2014\r\n# =========================================\r\n\r\nclear\r\n\r\nhostname=`hostname`\r\nip=`hostname -I`\r\n\r\necho "======================================================================="\r\nfiglet -o $hostname\r\necho "IP: $ip"\r\necho `\/home\/pi\/AirPi\/airpictl.sh status`\r\necho "======================================================================="\r\n<\/pre>\n
    Once you’ve created the file, we need to load it on login by adding the following lines to ‘\/etc\/profile’:<\/p>\n
    \r\n# Dynamic motd\r\n\/usr\/local\/bin\/motddynamic\r\n<\/pre>\n
     <\/p>\n
    Make a Backup<\/strong>
    \nIf you use a Mac, now is the time to make a backup of the SD card. This is done in the form of an ‘image’ which takes a snapshot of the entire card. This makes it very easy to get the card back to this point again in the future, without having to install everything again manually. There is a     very good set of instructions<\/a> on tutsplus.com so I don’t intend to reinvent the wheel here.<\/p>\n

    \nStart recording data!<\/strong>
    \nI’ll add a new post soon which covers how to use my modified version of the software, as it has quite a few extra features not included in the original release from the makers of the AirPi. These include:<\/p>\n