tp401: grove air quality sensor and examples

Signed-off-by: Mihai Tudor Panu <mihai.t.panu@intel.com>
Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>

examples/CMakeLists.txt

@@ -36,6 +36,7 @@ add_executable (mq2-example mq2.cxx)
 add_executable (mq3-example mq3.cxx)
 add_executable (mq5-example mq5.cxx)
 add_executable (mq9-example mq9.cxx)
+add_executable (tp401-example tp401.cxx)
 add_executable (tcs3414cs-example tcs3414cs.cxx)
 add_executable (th02-example th02.cxx)
 add_executable (lsm303-example lsm303.cxx)
@@ -121,6 +122,7 @@ target_link_libraries (mq2-example gas ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (mq3-example gas ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (mq5-example gas ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (mq9-example gas ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (tp401-example gas ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (tcs3414cs-example tcs3414cs ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (th02-example th02 ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (lsm303-example lsm303 ${CMAKE_THREAD_LIBS_INIT})

examples/javascript/tp401.js

@@ -0,0 +1,68 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.t.panu@intel.com>
+ * Copyright (c) 2014 Intel Corporation.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+var upmTP401 = require('jsupm_gas');
+//var time = require('sleep');
+
+//give a qualitative meaning to the value from the sensor
+function airQuality(value)
+{
+    if(value < 50) return "Fresh Air";
+    if(value < 200) return "Normal Indoor Air";
+    if(value < 400) return "Low Pollution";
+    if(value < 600) return "High Pollution - Action Recommended";
+    return "Very High Pollution - Take Action Immediately";
+}
+
+function loop()
+{
+    //read values (consecutive reads might vary slightly)
+    var value = airSensor.getSample();
+    var ppm = airSensor.getPPM();
+
+    //write the sensor values to the console
+    console.log("raw: " + value + " ppm: " + (" " + ppm.toFixed(2)).substring(-5, 5) + "   " + airQuality(value));
+
+    //wait 2.5 s then call function again
+    setTimeout(loop, 2500);
+}
+
+//setup sensor on Analog pin #0 (A0)
+var airSensor = new upmTP401.TP401(0);
+
+//warm up sensor
+console.log("Sensor is warming up for 3 minutes..");
+var i = 1;
+
+//print a message every passing minute
+var waiting = setInterval(function() {
+        console.log(i++ + " minute(s) passed.");
+        if(i == 3) clearInterval(waiting);
+    }, 60000);
+
+//start loop in 3 minutes
+setTimeout(function(){
+    console.log("Sensor is ready!");
+    loop();
+    }, 180000);

examples/python/tp401.py

@@ -0,0 +1,54 @@
+# Author: Mihai Tudor Panu <mihai.t.panu@intel.com>
+# Copyright (c) 2014 Intel Corporation.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+from time import sleep
+import pyupm_gas as TP401
+
+# Give a qualitative meaning to the value from the sensor
+def airQuality(value):
+    if(value < 50): return "Fresh Air"
+    if(value < 200): return "Normal Indoor Air"
+    if(value < 400): return "Low Pollution"
+    if(value < 600): return "High Pollution - Action Recommended"
+    return "Very High Pollution - Take Action Immediately"
+
+# New Grove Air Quality Sensor on AIO pin 0
+airSensor = TP401.TP401(0)
+
+# Wait for sensor to warm up
+print "Sensor is warming up for 3 minutes..."
+for i in range (1, 4):
+    sleep(60)
+    print i, "minute(s) passed."
+print "Sensor is ready!"
+
+# Loop indefinitely
+while True:
+
+    # Read values (consecutive reads might vary slightly)
+    value = airSensor.getSample()
+    ppm = airSensor.getPPM()
+
+    print "raw: %4d" % value , " ppm: %5.2f   " % ppm , airQuality(value)
+
+    # Sleep for 2.5 s
+    sleep(2.5)

examples/tp401.cxx

@@ -0,0 +1,70 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.t.panu@intel.com>
+ * Copyright (c) 2014 Intel Corporation.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+
+#include <unistd.h>
+#include <iostream>
+#include "tp401.h"
+
+using namespace std;
+
+//! [Interesting]
+// Give a qualitative meaning to the value from the sensor
+std::string
+airQuality(uint16_t value)
+{
+    if(value < 50) return "Fresh Air";
+    if(value < 200) return "Normal Indoor Air";
+    if(value < 400) return "Low Pollution";
+    if(value < 600) return "High Pollution - Action Recommended";
+    return "Very High Pollution - Take Action Immediately";
+}
+
+int main ()
+{
+    upm::TP401* airSensor = new upm::TP401(0); // Instantiate new grove air quality sensor on analog pin A0
+
+    cout << airSensor->name() << endl;
+
+    fprintf(stdout, "Heating sensor for 3 minutes...\n");
+    // wait 3 minutes for sensor to warm up
+    for(int i = 0; i < 3; i++) {
+        if(i) {
+            fprintf(stdout, "Please wait, %d minute(s) passed..\n", i);
+        }
+        sleep(60);
+    }
+    fprintf(stdout, "Sensor ready!\n");
+
+    while(true) {
+        uint16_t value = airSensor->getSample(); // Read raw value
+        float ppm = airSensor->getPPM();    // Read CO ppm (can vary slightly from previous read)
+        fprintf(stdout, "raw: %4d ppm: %5.2f   %s\n", value, ppm, airQuality(value).c_str());
+        usleep(2500000);    // Sleep for 2.5s
+    }
+
+    delete airSensor;
+    return 0;
+}
+//! [Interesting]