Introduction: Intel Edison IoT Remote Environmental Parameters Monitor

This is a very basic project entirely made in javascript through the IDE "Intel XDK IoT edition". When you have finished, you will have a system to monitor environmental parameters (temperature, light and air quality), locally in the LCD and remotely through a web browser.

Me and my friends, Roberto and Luigi, realized this project as starting point for a future home automation system.

I want to thank Intel for this wonderful device and for the fantastic hackathon of Milan.

Step 1: Setup the Board

This is what I used to build my Intel IoT Edison environmental parameters monitor:

  1. Intel® Edison Arduino Board with latest Yocto Image
  2. Grove Starter Kit Plus V2.0
  3. Grove Air Quality Sensor 1.1 connected to the analogic port A3 of Grove shield.
  4. Intel XDK IoT edition IDE and the edison connected to WiFi.
  5. The Grove RGB LCD connected to one of the I2C ports of the Grove shield. I connected it near to D7 port of Grove shield.
  6. Grove Light sensor v1.0 connected to the analogic port A0 of Grove shield
  7. Grove Temperature sensor v1.1 connected to the analogic port A1 of Grove shield

  8. Grove button connected to the digital port D2.

Step 2: Setup the IDE

  1. Download and install latest Intel® XDK IoT Edition from here
  2. Start a new Project
  3. Connect to the board
  4. Start programming :)

Here you can find the whole procedure to get started with Intel® XDK IoT Edition.

Step 3: Programming in JavaScript With XDK

  • In your project, edit the main.js file:
    main.js (please download the attached file, code was probably broken after pasting here)

/*
main.js Part of "Intel Edison IoT remote parameters monitor" Copyright 2015 Biagio Sesta, Algol Team This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/license>.

Steps for installing MRAA & UPM Library on Intel IoT Platform with IoTDevKit Linux* image Using a ssh client: 1. echo "src maa-upm http://iotdk.intel.com/repos/1.1/intelgalactic" > /etc/opkg/intel-iotdk.conf 2. opkg update 3. opkg upgrade

USAGE: **************** go to http:/<address_of_your_edison>/:1377/sensors

*/ var fs = require('fs'); var http = require('http'); var dispatcher = require('httpdispatcher'); var bind = require('bind'); var PORT = 1377;

var mraa = require("mraa");

//Button connected to D2 connector var buttonDigitalPinD2 = new mraa.Gpio(2); buttonDigitalPinD2.dir(mraa.DIR_IN);

//Lcd library var LCD = require ('jsupm_i2clcd'); var myLCD = new LCD.Jhd1313m1(0, 0x3E, 0x62);

var colorRed = {R: 255, G: 0, B: 0}; var colorBlue = {R: 0,G: 0,B: 255}; var colorWhite = {R: 40,G: 40,B: 40};

//light sensors parameters //GROVE Kit A0 Connector --> Aio(0) var myAnalogLightPin = new mraa.Aio(0);

//air quality sensors parameters //GROVE Kit A3 Connector --> Aio(3) var myAnalogAirPin = new mraa.Aio(3);

//Temperature sensor parameters //GROVE Kit A1 Connector --> Aio(1) var myAnalogPin = new mraa.Aio(1); var B = 3975;

/* Function: getSensorsValues() Description: Read values from sensors and return them as an array */ function getSensorsValues() { 'use strict'; //setInterval(function () { var ambientValues = {}; ambientValues.temp = getTemperature(); ambientValues.light = getLight(); ambientValues.airQuality = getAirQuality(); return ambientValues; //}, 4000); }

console.log("Sample Reading Grove Kit Temperature Sensor");

/* Function: getTemperature() Description: Read values from temperature sensor and return it */ function getTemperature(){ var a = myAnalogPin.read(); console.log("Analog Pin (A1) Output: " + a); //console.log("Checking...."); var resistance = (1023 - a) * 10000 / a; //get the resistance of the sensor; //console.log("Resistance: "+resistance); var celsius_temperature = 1 / (Math.log(resistance / 10000) / B + 1 / 298.15) - 273.15;//convert to temperature via datasheet ;

console.log("Celsius Temperature: " + celsius_temperature); //return celsius temperature with 2 decimal digits return celsius_temperature.toFixed(2); }

/* Function: getLight() Description: Read values from light sensor and return it */ function getLight(){ var light = myAnalogLightPin.read(); return light; }

/* Function: getAirQuality() Description: Read values from air quality sensor and return it */ function getAirQuality(){ var airQuality = myAnalogAirPin.read(); return airQuality; }

/* Function: printToLcd() Parameters: ambientValues array of sensor values Description: write the values to LCD connected to the board */ function printToLcd(ambientValues){ myLCD.clear(); var outputColor = {}; //cold if (ambientValues.temp < 15) outputColor=colorBlue; //warm else if (ambientValues.temp >= 15 && ambientValues.temp <30) outputColor=colorWhite; //hot else outputColor=colorRed; myLCD.setColor(outputColor.R, outputColor.G, outputColor.B); //console.log("Temp: " + ambientValues.temp); myLCD.write("Temp:" + ambientValues.temp); myLCD.setCursor(1,0); myLCD.write("Air:" + ambientValues.airQuality); myLCD.write(" Lux:" + ambientValues.light); }

/* Function: handleRequest() Parameters: request, the http request. response, the http resposne Description: function that handles the request from a web browser */ function handleRequest(request, response){ try { //log the request on console console.log(request.url); //Disptach dispatcher.dispatch(request, response); } catch(err) { console.log(err); } }

/* Function: onGet() Parameters: path to dispatch, callback function that handles the response Description: function that handles the request from a web browser */ dispatcher.onGet("/sensors", function(req, res, chain) { var ambientValues = getSensorsValues(); printToLcd(ambientValues);

/*next step is a workaround to use node.js template feature with Intel XDK if I start main.js typing node main.js, the application binds the template correctly if I load main.js with built in feature of XDK, the application does not find sensors.tpl in relative path but it needs absolute path */ var tpl = "sensors.tpl"; //check if the application find the tamplate in relative path if(!fs.existsSync(tpl)) tpl='/home/root/.node_app_slot/sensors.tpl'; bind.toFile(tpl, { temperature: ambientValues.temp, light: ambientValues.light, airQuality: ambientValues.airQuality }, function(data) { res.writeHead(200, {'Content-Type': 'text/html'}); res.end(data); }); });

//GROVE Kit Shield D2 --> GPIO2 /* Function: startButtonWatch() Description: Check the value of button every 300ms */ function startButtonWatch() { 'use strict'; var buttonValue = 0, last_b_sensor_value;

setInterval(function () { buttonValue = buttonDigitalPinD2.read(); if (buttonValue === 1 && last_b_sensor_value === 0) { console.log("button pressed"); var ambientValues = getSensorsValues(); printToLcd(ambientValues); } else if (buttonValue === 0 && last_b_sensor_value === 1) { console.log("Button released"); } last_b_sensor_value = buttonValue; }, 300); }

//Create a server var server = http.createServer(handleRequest); //Lets start our server server.listen(PORT, function(){ //Callback triggered when server is successfully listening. Hurray! startButtonWatch(); console.log("Server listening on: http://localhost:%s", PORT); });

  • Edit package.json

{
"name": "IoTParametersMonitor", "description": "", "version": "1.0.0", "main": "main.js", "engines": { "node": ">=0.10.0" }, "dependencies": { "bind":"latest", "httpdispatcher":"latest" } }

  • Create a new file sensors.tpl in the root folder of your project, this file is a template used to bind values from sensors to an html page sent to your browser (download the file attached)

Step 4: Run the Application

Upload your project to the Edison board via the XDK IDE and run it!.

To monitor the parameters locally press the button and you will see the values on LCD.

To monitor the parameters remotely, open your browser and type "http://<address_of_your_edison>:1377/sensors".

That's it, now you can monitor your environment.

Comments

author
taifur (author)2015-10-30

Good project. Thanks for sharing

author
seamster (author)2015-03-21

Very nicely done!

author
jeckyll86 (author)seamster2015-03-21

Thank you seamster, I am glad that you appreciate my work.