upm: update to version 0.1.9

Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>

CMakeLists.txt

@@ -1,6 +1,10 @@
 cmake_minimum_required (VERSION 2.8.11)
 project (upm)
 
+if ("${CMAKE_SOURCE_DIR}" STREQUAL "${CMAKE_BINARY_DIR}")
+message("WARNING: building into sources dir can be risky, prefer other directory")
+endif ()
+
 find_package (SWIG)
 if (SWIG_FOUND)
   include (${SWIG_USE_FILE})
@@ -8,19 +12,23 @@ endif ()
 
 find_package (Threads REQUIRED)
 find_package (PkgConfig REQUIRED)
-# force the libmaa version to be the required version
-pkg_check_modules (MAA REQUIRED maa>=0.2.6)
-message (INFO " found libmaa version: ${MAA_VERSION}")
+# force the libmraa version to be the required version
+pkg_check_modules (MRAA REQUIRED mraa>=0.5.4)
+message (INFO " found libmraa version: ${MRAA_VERSION}")
 
 # Appends the cmake/modules path to MAKE_MODULE_PATH variable.
 set (CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake/modules ${CMAKE_MODULE_PATH})
+set (LIB_INSTALL_DIR "lib${LIB_SUFFIX}" CACHE PATH "Installation path for libraries")
+
+# Set CMAKE_LIB_INSTALL_DIR if not defined
+include(GNUInstallDirs)
 
 # Make a version file containing the current version from git.
 include (GetGitRevisionDescription)
 git_describe (VERSION "--tags")
 if ("x_${VERSION}" STREQUAL "x_GIT-NOTFOUND")
-  message (WARNING " - Install git to compile a production libmaa!")
-  set (VERSION "v0.1.2-dirty")
+  message (WARNING " - Install git to compile a production libmraa!")
+  set (VERSION "v0.1.9-dirty")
 endif ()
 
 message (INFO " - UPM Version ${VERSION}")
@@ -67,7 +75,7 @@ if (IPK)
   target_architecture (DETECTED_ARCH)
   message( INFO " - Target arch is ${DETECTED_ARCH}")
 
-  set(CPACK_GENERATOR "DEB")
+  set(CPACK_GENERATOR "DEB" "TGZ")
   set(OPKG_ARCH ${DETECTED_ARCH})
   set(CPACK_BINARY_DIR ${CMAKE_BINARY_DIR})
   set(CPACK_DEBIAN_PACKAGE_MAINTAINER "Intel IoT-Devkit") #required
@@ -81,7 +89,7 @@ if (IPK)
   set(CPACK_DEBIAN_PACKAGE_SECTION "libs")
   set(CPACK_DEBIAN_PACKAGE_ARCHITECTURE ${DETECTED_ARCH})
   set(CPACK_SYSTEM_NAME ${DETECTED_ARCH})
-  set(CPACK_DEBIAN_PACKAGE_DEPENDS "libmaa0 (>= ${MAA_VERSION})")
+  set(CPACK_DEBIAN_PACKAGE_DEPENDS "libmraa0 (>= ${MRAA_VERSION})")
   set(CPACK_DEBIAN_PACKAGE_PROVIDES "upm-dev, upm-dbg, upm-doc")
   set(CPACK_DEBIAN_PACKAGE_REPLACES ${CPACK_DEBIAN_PACKAGE_PROVIDES})
   set(CPACK_DEBIAN_PACKAGE_CONFLICTS ${CPACK_DEBIAN_PACKAGE_PROVIDES})

Doxyfile.in

@@ -44,7 +44,7 @@ PROJECT_NUMBER         = @upm_VERSION_STRING@
 # for a project that appears at the top of each page and should give viewer a
 # quick idea about the purpose of the project. Keep the description short.
 
-PROJECT_BRIEF          = "Sensor/Actuator repository for libmaa (v@MAA_VERSION@)"
+PROJECT_BRIEF          = "Sensor/Actuator repository for libmraa (v@MRAA_VERSION@)"
 
 # With the PROJECT_LOGO tag one can specify an logo or icon that is included in
 # the documentation. The maximum height of the logo should not exceed 55 pixels
@@ -99,7 +99,7 @@ BRIEF_MEMBER_DESC      = YES
 # brief descriptions will be completely suppressed.
 # The default value is: YES.
 
-REPEAT_BRIEF           = YES
+REPEAT_BRIEF           = NO
 
 # This tag implements a quasi-intelligent brief description abbreviator that is
 # used to form the text in various listings. Each string in this list, if found
@@ -129,6 +129,8 @@ ABBREVIATE_BRIEF       = "The $name class" \
 
 ALWAYS_DETAILED_SEC    = NO
 
+DETAILS_AT_TOP         = YES
+
 # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
 # inherited members of a class in the documentation of that class as if those
 # members were ordinary class members. Constructors, destructors and assignment
@@ -510,7 +512,7 @@ HIDE_SCOPE_NAMES       = YES
 # the files that are included by a file in the documentation of that file.
 # The default value is: YES.
 
-SHOW_INCLUDE_FILES     = YES
+SHOW_INCLUDE_FILES     = NO
 
 # If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
 # grouped member an include statement to the documentation, telling the reader
@@ -536,7 +538,7 @@ INLINE_INFO            = YES
 # name. If set to NO the members will appear in declaration order.
 # The default value is: YES.
 
-SORT_MEMBER_DOCS       = YES
+SORT_MEMBER_DOCS       = NO
 
 # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
 # descriptions of file, namespace and class members alphabetically by member
@@ -671,7 +673,7 @@ FILE_VERSION_FILTER    =
 # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
 # tag is left empty.
 
-LAYOUT_FILE            = 
+LAYOUT_FILE            = @CMAKE_CURRENT_SOURCE_DIR@/DoxygenLayout.xml
 
 # The CITE_BIB_FILES tag can be used to specify one or more bib files containing
 # the reference definitions. This must be a list of .bib files. The .bib
@@ -754,6 +756,7 @@ WARN_LOGFILE           =
 # Note: If this tag is empty the current directory is searched.
 
 INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@/src \
+                         @CMAKE_CURRENT_SOURCE_DIR@/docs \
                          @CMAKE_CURRENT_SOURCE_DIR@/README.md
 
 # This tag can be used to specify the character encoding of the source files
@@ -846,7 +849,9 @@ EXCLUDE_SYMLINKS       = NO
 # Note that the wildcards are matched against the file with absolute path, so to
 # exclude all test directories for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       = 
+EXCLUDE_PATTERNS       = @PROJECT_SOURCE_DIR@/src/nrf8001/aci* \
+                         @PROJECT_SOURCE_DIR@/src/nrf8001/lib* \
+                         @PROJECT_SOURCE_DIR@/src/nrf8001/hal* 
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the
@@ -863,7 +868,9 @@ EXCLUDE_SYMBOLS        =
 # that contain example code fragments that are included (see the \include
 # command).
 
-EXAMPLE_PATH           = @CMAKE_CURRENT_SOURCE_DIR@/examples/
+EXAMPLE_PATH           = @CMAKE_CURRENT_SOURCE_DIR@/examples/ \
+                         @CMAKE_CURRENT_SOURCE_DIR@/docs/ \
+			 @CMAKE_CURRENT_SOURCE_DIR@/src/max31855/
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
@@ -883,7 +890,7 @@ EXAMPLE_RECURSIVE      = NO
 # that contain images that are to be included in the documentation (see the
 # \image command).
 
-IMAGE_PATH             = 
+IMAGE_PATH             = @CMAKE_CURRENT_SOURCE_DIR@/docs/images/
 
 # The INPUT_FILTER tag can be used to specify a program that doxygen should
 # invoke to filter for each input file. Doxygen will invoke the filter program
@@ -2206,7 +2213,7 @@ INCLUDE_GRAPH          = YES
 # The default value is: YES.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
-INCLUDED_BY_GRAPH      = YES
+INCLUDED_BY_GRAPH      = NO
 
 # If the CALL_GRAPH tag is set to YES then doxygen will generate a call
 # dependency graph for every global function or class method.

DoxygenLayout.xml

@@ -0,0 +1,197 @@
+<doxygenlayout version="1.0">
+  <!-- Generated by doxygen 1.8.7 -->
+  <!-- Navigation index tabs for HTML output -->
+  <navindex>
+    <tab type="mainpage" visible="yes" title=""/>
+    <tab type="pages" visible="yes" title="" intro=""/>
+    <tab type="modules" visible="yes" title="UPM libraries" intro="Here is a
+    list of UPM libraries that can be used. Note that each of the classes
+    listed in these libraries are completely seperate so you will need to link
+    against all those that you have used in your program"/> <tab
+    type="namespaces" visible="yes" title="">
+    <tab type="namespacelist" visible="yes" title="" intro=""/>
+    <tab type="namespacemembers" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="classes" visible="yes" title="">
+    <tab type="classlist" visible="yes" title="" intro=""/>
+    <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/> 
+    <tab type="hierarchy" visible="yes" title="" intro=""/>
+    <tab type="classmembers" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="files" visible="yes" title="">
+    <tab type="filelist" visible="yes" title="" intro=""/>
+    <tab type="globals" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="examples" visible="yes" title="" intro=""/>  
+  </navindex>
+
+  <!-- Layout definition for a class page -->
+  <class>
+    <briefdescription visible="yes"/>
+    <detaileddescription title=""/>
+    <includes visible="$SHOW_INCLUDE_FILES"/>
+    <memberdecl>
+      <nestedclasses visible="yes" title=""/>
+      <publictypes title=""/>
+      <services title=""/>
+      <interfaces title=""/>
+      <publicslots title=""/>
+      <signals title=""/>
+      <publicmethods title=""/>
+      <publicstaticmethods title=""/>
+      <publicattributes title=""/>
+      <publicstaticattributes title=""/>
+      <protectedtypes title=""/>
+      <protectedslots title=""/>
+      <protectedmethods title=""/>
+      <protectedstaticmethods title=""/>
+      <protectedattributes title=""/>
+      <protectedstaticattributes title=""/>
+      <packagetypes title=""/>
+      <packagemethods title=""/>
+      <packagestaticmethods title=""/>
+      <packageattributes title=""/>
+      <packagestaticattributes title=""/>
+      <properties title=""/>
+      <events title=""/>
+      <privatetypes title=""/>
+      <privateslots title=""/>
+      <privatemethods title=""/>
+      <privatestaticmethods title=""/>
+      <privateattributes title=""/>
+      <privatestaticattributes title=""/>
+      <friends title=""/>
+      <related title="" subtitle=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <memberdef>
+      <inlineclasses title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <services title=""/>
+      <interfaces title=""/>
+      <constructors title=""/>
+      <functions title=""/>
+      <related title=""/>
+      <variables title=""/>
+      <properties title=""/>
+      <events title=""/>
+    </memberdef>
+    <allmemberslink visible="yes"/>
+    <inheritancegraph visible="$CLASS_GRAPH"/>
+    <collaborationgraph visible="$COLLABORATION_GRAPH"/>
+    <usedfiles visible="$SHOW_USED_FILES"/>
+    <authorsection visible="yes"/>
+  </class>
+
+  <!-- Layout definition for a namespace page -->
+  <namespace>
+    <briefdescription visible="yes"/>
+    <memberdecl>
+      <nestednamespaces visible="yes" title=""/>
+      <constantgroups visible="yes" title=""/>
+      <classes visible="yes" title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <inlineclasses title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+    </memberdef>
+    <authorsection visible="yes"/>
+  </namespace>
+
+  <!-- Layout definition for a file page -->
+  <file>
+    <briefdescription visible="no"/>
+    <includegraph visible="$INCLUDE_GRAPH"/>
+    <includes visible="$SHOW_INCLUDE_FILES"/>
+    <detaileddescription title="API Description"/>
+    <sourcelink visible="yes"/>
+    <memberdecl>
+      <classes visible="yes" title=""/>
+      <namespaces visible="yes" title=""/>
+      <functions title=""/>
+      <constantgroups visible="yes" title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <variables title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <memberdef>
+      <inlineclasses title=""/>
+      <functions title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <variables title=""/>
+    </memberdef>
+    <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
+    <authorsection/>
+  </file>
+
+  <!-- Layout definition for a group page -->
+  <group>
+    <briefdescription visible="yes"/>
+    <groupgraph visible="$GROUP_GRAPHS"/>
+    <memberdecl>
+      <nestedgroups visible="yes" title=""/>
+      <dirs visible="yes" title=""/>
+      <files visible="yes" title=""/>
+      <namespaces visible="yes" title=""/>
+      <classes visible="yes" title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <enumvalues title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <signals title=""/>
+      <publicslots title=""/>
+      <protectedslots title=""/>
+      <privateslots title=""/>
+      <events title=""/>
+      <properties title=""/>
+      <friends title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <pagedocs/>
+      <inlineclasses title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <enumvalues title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <signals title=""/>
+      <publicslots title=""/>
+      <protectedslots title=""/>
+      <privateslots title=""/>
+      <events title=""/>
+      <properties title=""/>
+      <friends title=""/>
+    </memberdef>
+    <authorsection visible="yes"/>
+  </group>
+
+  <!-- Layout definition for a directory page -->
+  <directory>
+    <briefdescription visible="yes"/>
+    <directorygraph visible="yes"/>
+    <memberdecl>
+      <dirs visible="yes"/>
+      <files visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+  </directory>
+</doxygenlayout>

README.md

@@ -1,8 +1,8 @@
-UPM - Sensor/Actuator repository for Maa
+UPM - Sensor/Actuator repository for Mraa
 ==============
 
-UPM is a high level repository for sensors that use maa. Each sensor links to
-libmaa and are not meant to be interlinked although some groups of sensors may
+UPM is a high level repository for sensors that use mraa. Each sensor links to
+libmraa and are not meant to be interlinked although some groups of sensors may
 be. Each sensor contains a header which allows to interface with it. Typically
 a sensor is represented as a class and instanciated.
 
@@ -12,15 +12,79 @@ to provide identification/pin location on the board.
 Typically an update() function will be called in order to get new data from the
 sensor in order to reduce load when doing multiple reads to sensor data.
 
-A basic sensor is expected to work as such:
-s = new sensor();
-print(sensor->read());
-sleep(1);
-s->update();
-print(sensor->read();
+### Example
+
+A sensor/acturo is expected to work as such (here is the servo ES08A api):
+@snippet es08a.cxx Interesting
 
 However implementation and API design is compeltely up to the developer, some
 enumerable sensors for example may provide much clever instanciation. Displays
 may also create more complex structures in order to interface with them.
 
-For more information on maa, see the maa documentation
+### Supported Sensors
+
+Temperature Sensors:
+  * upm::MAX31723
+  * upm::MAX31855
+  * upm::TH02
+  * upm::GroveTemp
+
+Compass/Gyro/Magnometer Sensors:
+  * upm::Hmc5883l
+  * upm::MPU9150
+  * upm::LSM303
+
+Atmospheric Pressure Sensors:
+  * upm::GY65
+
+Light/Proximity Sensors:
+  * upm::MAXDS3231M
+  * upm::MAX44000
+  * upm::HCSR04
+  * upm::GroveLight
+
+Gas Sensors:
+  * upm::MQ2
+  * upm::MQ3
+  * upm::MQ5
+  * upm::MQ9
+
+Displays:
+  * upm::Jhd1313m1
+  * upm::Lcm1602
+  * upm::ST7735
+  * upm::SSD1308
+  * upm::SSD1327
+
+LED controllers/segment displays:
+  * upm::TM1637
+  * upm::MY9221
+
+RFID:
+  * upm::SM130
+
+Wireless Communication:
+  * upm::NRF24l01
+
+Servo/motors:
+  * upm::ES08A
+  * upm::StepMotor
+
+Digital potentiometer
+  * upm::MAX5487
+
+Electricity sensor
+  * upm::ECS1030
+
+### Building UPM
+
+See @ref building
+
+### Making your own UPM module
+
+@ref porting has more information on making new UPM modules
+
+C/C++ API Documentation
+===========
+
+The C/C++ documentation is available [here](http://iotdk.intel.com/docs/master/upm/)

TODO

@@ -0,0 +1,34 @@
+** FIXES **
+- LPD8806 & MAX5487 SPI constructor needs bus number etc...
+- MAX44000 i2c bus number required...
+- TCS3414CS & TH-2 i2c params required
+
+** SENSORS **
+
+Easy:
+MAX7221 - SPI 8 digit LED
+- https://mbed.org/components/MAX7221/
+- 
+SCA61T - inclinometer SPI
+- https://mbed.org/components/SCA61T-Inclinometer/
+DS1721 - i2c temperature/thermostat
+- https://mbed.org/components/DS1721/
+MPL3115A2 - i2c altimeter
+- https://mbed.org/components/MPL3115A2/
+- http://www.ebay.co.uk/itm/Barometric-Pressure-Altitude-Temperature-Sensor-I2C-MPL3115A2-/221499210102?pt=UK_BOI_Electrical_Test_Measurement_Equipment_ET&hash=item339261b976
+TEMT6200 - Ambient light sensor
+- https://mbed.org/components/TEMT6200/
+CMPS03 - i2c digital compass
+- https://mbed.org/components/CMPS03-Digital-Compass/
+- http://www.ebay.co.uk/itm/Magnetic-Compass-CMPS03-/221437925374?pt=UK_BOI_Electrical_Test_Measurement_Equipment_ET&hash=item338eba97fe
+- http://www.robot-italy.com/it/cmps03-robot-compass-module.html
+
+Medium
+E-ink sharp 1.3" LCD
+- https://mbed.org/components/13-SHARP-Memory-LCD/
+LCD-S401
+- https://mbed.org/components/Lumex-LCD-S401/
+
+Hard:
+RA8875 - 480x272 SPI 4 wire
+- https://mbed.org/components/RA8875-Based-Display/

docs/building.md

@@ -0,0 +1,66 @@
+Building UPM                         {#building}
+============
+
+UPM uses cmake in order to make compilation relatively painless. Cmake runs
+build out of tree so the recommended way is to clone from git and make a build/
+directory.
+
+UPM will attempt to build all directories inside src/ and they must contain
+individual CMakeLists.txt files.
+
+~~~~~~~~~~~~~{.sh}
+mkdir build
+cd build
+cmake ..
+make
+~~~~~~~~~~~~~
+
+Our cmake configure has a number of options, cmake-gui or ccmake can show you
+all the options. The interesting ones are detailed below:
+
+Changing install path from /usr/local to /usr
+ -DCMAKE_INSTALL_PREFIX:PATH=/usr
+
+Building debug build:
+ -DCMAKE_BUILD_TYPE=DEBUG
+
+Using clang instead of gcc:
+ -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++
+
+Building with an older version of swig (swig 2.0+) requires the disabling of javascript:
+ -DBUILDSWIGNODE=OFF
+
+Disabling python module building
+ -DBUILDSWIGPYTHON=OFF
+
+Building doxygen doc
+ -BUILDDOC=ON
+
+Often developers are only interested in building one module or even just the
+python/node module to do some quick testing using scripting. In order to do
+this you need to use the target name for the python or node module you want to
+rebuild. For example the lcd module target name is i2clcd. Therfore the python
+module target name will be prefixed by _pyupm_. Just do the following to build
+only that module. Modules not using the UPM cmake macros may have different
+naming.
+
+~~~~~~~~~~~~~
+make _pyupm_i2clcd
+~~~~~~~~~~~~~
+
+Sometimes you want to build a small C++ example against an installed library.
+This is fairly easy if installed systemwide. Just link against the correct
+librar (in this case libupm-tm1637) and then add /usr/include/upm to the loader
+path:
+
+~~~~~~~~~~~~
+g++ test.cxx -lupm_tm1637 -I/usr/include/upm
+~~~~~~~~~~~~
+
+You can also use pkg-config to return the information to you, which is
+considered the correct way if including UPM in a build system like cmake or
+autotools on linux.
+
+~~~~~~~~~~~
+pkg-config --cflags --libs upm-tm1637
+~~~~~~~~~~~

docs/contributions.md

@@ -0,0 +1,74 @@
+Contributing a module                         {#contributions}
+=====================
+
+Here are the rules of contribution:
+- Your module must have an example that builds against your UPM library
+- Commits must have a sign-off line by everyone who reviewed them
+- Commits must be named <file/module>: Some decent description
+- You must license your module under a FOSS license. The recommended license
+  is MIT but any permissive license is fine. Please consider that people using
+  UPM may want to write proprietary programs with your sensors so we like to
+  avoid GPL. (LGPL is fine). If your license is not MIT please include a
+  LICENSE file in src/mymodule/
+- Please test your module builds before contributing and make sure it works on
+  the latest version of mraa. If you tested on a specific board/platform please
+  tell us what this was in your PR.
+- Try not to break master. In any commit.
+- Attempt to have some decent API documentation below are the explicit rules on documentation:
+
+Documentation
+=============
+
+- Try to have no warnings in doxygen, this is generally fairly easy
+- Have the specific sensor manufacturer/model & version that you used, if you
+  support multiple versions please list
+- Comments do not need full stops
+- Stick to <80 chars per line even in comments
+- No text is allowed on the same line as the start or end of a comment /** */
+- All classes should have a "@brief" and a "@snippet"
+
+The example should have an 'Interesting' section which will be highlighted as a
+code sample in doxygen.  Everything in between such tags will show up in the
+class documentation when the following is put at the end of a class docstring
+as show above.
+
+Code signing
+============
+
+The sign-off is a simple line at the end of the explanation for the
+patch, which certifies that you wrote it or otherwise have the right to pass it
+on as an open-source patch.  The rules are pretty simple: if you can certify
+the below:
+
+        Developer's Certificate of Origin 1.1
+
+        By making a contribution to this project, I certify that:
+
+        (a) The contribution was created in whole or in part by me and I
+            have the right to submit it under the open source license
+            indicated in the file; or
+
+        (b) The contribution is based upon previous work that, to the best
+            of my knowledge, is covered under an appropriate open source
+            license and I have the right under that license to submit that
+            work with modifications, whether created in whole or in part
+            by me, under the same open source license (unless I am
+            permitted to submit under a different license), as indicated
+            in the file; or
+
+        (c) The contribution was provided directly to me by some other
+            person who certified (a), (b) or (c) and I have not modified
+            it.
+
+        (d) I understand and agree that this project and the contribution
+            are public and that a record of the contribution (including all
+            personal information I submit with it, including my sign-off) is
+            maintained indefinitely and may be redistributed consistent with
+            this project or the open source license(s) involved.
+
+then you just add a line saying
+
+        Signed-off-by: Random J Developer <random@developer.example.org>
+
+using your real name (sorry, no pseudonyms or anonymous contributions.)
+Unsigned commits will not be accepted.

docs/max31855.md

@@ -0,0 +1,97 @@
+Making a UPM module for MAX31855                         {#max31855}
+================================
+
+The Maxim Integrated MAX31855 is a thermocouple amplifier allowing you to read
+from a K type themocouple. My board comes from the Pmod kit form Maxim
+(MAX31855PMB1) but you can get this from many different sources. The adafruit
+people made arduino code already so we'll use that as a
+[reference](https://github.com/adafruit/Adafruit-MAX31855-library/blob/master/Adafruit_MAX31855.cpp).
+
+### Basics
+
+This is a spi module so we will use the mraa spi functions to build our module.
+First thing to do is to create a tree structure like this in upm/src/max31855:
+
+* max31855.cxx
+* max31855.h
+* jsupm_max31855.i
+* pyupm_max31855.i
+* CMakeLists.txt
+
+And then an example file to use & test our lib with in upm/examples/max31855.cxx.
+
+### Swig
+
+The .i files are used by swig, there is one for each python & javascript. They
+contain essentially the same thing and are very simple. The only thing to
+change between the javascript & node.js one is the argument to %module.
+
+@snippet jsupm_max31855.i Interesting
+
+The %include parameter defines which functions will be available to the
+node/python module created, Whilst the headers inside %{} will be explicitly
+required during compilation. Typically only the top level header is required in
+either of those args. The upm.i is just a shortcut to include some commonly
+used swig wrappers for UPM sensors, it's not obligatory but recommended.
+
+### API
+
+Then we create the header (max31855.h) , a very simple header in our case we
+will have only a very basic api. We provide a getTemp() function which will
+return the same type as in the arduino library, a double.
+
+@snippet max31855.h Interesting
+
+Note that the header contains both the io that we will use, the gpio is in this
+case used as the chip select pin.
+
+### Implementing our API
+
+In the adafruit library the read function (our chip is a 3pin SPI so only read
+is possible), the spiread32() does all the work. It starts by setting up the io
+so we will do the same in our constructor.
+
+Note unlike on Arduino, we'll just set a 2Mhz clock and let the chip do the
+work.
+
+@snippet src/max31855/max31855.cxx Constructor
+
+Then we also need to implement a nice cleanup in our destructor.
+
+@snippet src/max31855/max31855.cxx Destructor
+
+Then to read data, we will use spi_write_buf which will allow us to write a
+whole uint32_t in order to get one back, which is what the arduino code does in
+spiread32. Obviously we set our chip select to low first. Here is the start of
+the implementation of MAX31855::getTemp()
+
+@snippet src/max31855/max31855.cxx spi
+
+Then using the arduino code as reference we simply reconstruct form the 4
+uint8_t values a 32bit int value and select only the valuable parts of
+information from that. The MAX31855 datahseet explains exactly which bits are
+useful, we will just do the same as the adafruit code, first checking the error
+bit and then scrapping everything but the 14bit of thermocouple data that are
+useful to us and converting it to a double.
+
+@snippet src/max31855/max31855.cxx conversion
+
+### Finalizing
+
+Our final example, very easy to use api!
+
+@snippet examples/max31855.cxx Interesting
+
+### Building
+
+The we need to add it to the examples/CMakeLists.txt. Only three lines are required
+
+~~~~~~~~~~~
+add_executable (max31855-example max31855.cxx)
+include_directories (${PROJECT_SOURCE_DIR}/src/max31855)
+target_link_libraries (max31855-example max31855 ${CMAKE_THREAD_LIBS_INIT})
+~~~~~~~~~~~
+
+Note you dont have to rebuild everything, cmake keeps target lists so if you
+named your example target modulename-example you can simply do make
+max31855-example and both the library & example will build.

docs/naming.md

@@ -0,0 +1,29 @@
+Naming a module                         {#naming}
+===============
+
+UPM attemps to follow a clear naming pattern. Modules should be sensibly named
+and then placed in ${libdir}/upm and headers in ${includedir}/upm, all modules
+should be prefixed with libupm-<modulename>. The upm_module_init will
+automatically name python UPM modules as pyupm_<modulename> and javascript
+modules as jsupm_<modulename>. For example for src/grove/ the library built
+will be libupm-grove.so, the python module pyupm_grove and the js module
+jsupm_grove.
+
+### Choosing a name for a new module
+
+1. Pick a name, typically the chip name is the most sensible
+2. Use it & stick to it
+
+### Rules for name picking
+
+1. Your lib must belong to the UPM namespace
+2. Usually picking the name of the chip of your sensor/actuator makes sense.
+Other times this does not. Try to pick a generic name so people with a similar
+sensor can inherit your class if they only have minor changes.
+3. Avoid brand names, often your module can be very generic with little effort
+
+### Doubt
+
+If ever, give me a ping via email: brendan.le.foll@intel.com and I'll try
+suggest decent names for your module.
+

docs/porting.md

@@ -0,0 +1,65 @@
+Porting a module from Arduino                         {#porting}
+=============================
+
+Porting arduino libraries to libmraa as UPM libraries is usually fairly easy.
+The issues typically come from misunderstanding of how a non real time OS deals
+with interupts and timers. It also highly depends on the sensor. A concrete
+example is explained in detail on @ref max31855
+
+### Adding a new module to UPM
+
+1. Choose a name for your module (see @ref naming)
+2. Make a new folder in src/modulename
+3. Create a CMakeLists.txt file inside src/modulename
+
+### CmakeLists.txt
+
+By default you need a header called modulename.h and a C++ file called
+modulename.cxx. You can have multiple headers and source files. Only public
+headers need to be added to module_h and all source files need to be in
+module_src.
+
+~~~~~~~~~~~
+set (libname "modulename")
+set (libdescription "Module Description")
+set (module_src ${libname}.cxx)
+set (module_h ${libname}.h)
+upm_module_init()
+~~~~~~~~~~~
+
+### Making your API
+
+The easiest way to do this is to have a look at a similar sensor to yours.
+Typically create a class for your sensor with a constructor that defines the
+pins it is on. This constructor will create the mraa_*_context structs that are
+required to talk to the board's IO. An I2c sensor will create a
+mraa_i2c_context, keep it as a private member and require a bus number and slave
+address in it's constructor.
+
+Typically in sensors a simple object->read() function is prefered, depending on
+your sensor/actuaotr this may or may not be easy or not even make sense. Most
+UPM apis have a simple set of functions.
+
+### Mapping arduino API to libmraa
+
+Your constructor is similar to the setup() function in arduino, you should
+initialise your IO the way you want it. This means initialising contexts
+(private members) and setting the correct modes for them.
+
+See the mraa API documentation for exact API.
+
+### Building
+
+To build your module just follow @ref building. By creating a folder and the
+CMakelists.txt file you have done all that is required to add your sensor to
+the UPM build system.
+
+### Sending your module to us for inclusion in UPM
+
+The last step is when you're happy with your module and it works send us a pull
+request! We'd love to include your sensor in our repository.
+
+If you don't like github you can also send brendan.le.foll@intel.com a git
+formatted patch if your sensor. More details are on @ref contributions and on
+https://help.github.com/articles/creating-a-pull-request
+

examples/CMakeLists.txt

@@ -1,19 +1,85 @@
-add_executable (compass compass.cxx)
-add_executable (groveled groveled.cxx)
-add_executable (grovetemp grovetemp.cxx)
-add_executable (lcm-lcd lcm-lcd.cxx)
-add_executable (rgb-lcd rgb-lcd.cxx)
-add_executable (buzzer-sound buzzer-sound.cxx)
-add_executable (led-bar led-bar.cxx)
-add_executable (seg-lcd 4digitdisplay.cxx)
-add_executable (nrf_transmitter nrf_transmitter.cxx)
-add_executable (nrf_receiver nrf_receiver.cxx)
-add_executable (es08a es08a.cxx)
-add_executable (son-hcsr04 hcsr04.cxx)
-add_executable (oled-1308 oled-1308.cxx)
-add_executable (oled-1327 oled-1327.cxx)
-add_executable (proximity max44000.cxx)
-add_executable (accelerometer mma7455.cxx)
+add_executable (hmc5883l-example hmc5883l.cxx)
+add_executable (groveled-example groveled.cxx)
+add_executable (groverelay-example groverelay.cxx)
+add_executable (grovelight-example grovelight.cxx)
+add_executable (grovetemp-example grovetemp.cxx)
+add_executable (grovebutton-example grovebutton.cxx)
+add_executable (groverotary-example groverotary.cxx)
+add_executable (groveslide-example groveslide.cxx)
+add_executable (lcm-lcd-example lcm-lcd.cxx)
+add_executable (rgb-lcd-example rgb-lcd.cxx)
+add_executable (buzzer-sound-example buzzer-sound.cxx)
+add_executable (led-bar-example led-bar.cxx)
+add_executable (seg-lcd-example 4digitdisplay.cxx)
+add_executable (nrf_transmitter-example nrf_transmitter.cxx)
+add_executable (nrf_receiver-example nrf_receiver.cxx)
+add_executable (es08a-example es08a.cxx)
+add_executable (son-hcsr04-example hcsr04.cxx)
+add_executable (oled-1308-example oled-1308.cxx)
+add_executable (oled-1327-example oled-1327.cxx)
+add_executable (max44000-example max44000.cxx)
+add_executable (mma7455-example mma7455.cxx)
+add_executable (st7735-example st7735.cxx)
+add_executable (max31855-example max31855.cxx)
+add_executable (gy65-example gy65.cxx)
+add_executable (stepmotor-example stepmotor.cxx)
+add_executable (pulsensor-example pulsensor.cxx)
+add_executable (mic-example mic.cxx)
+add_executable (mpu9150-example mpu9150.cxx)
+add_executable (maxds3231m-example maxds3231m.cxx)
+add_executable (max31723-example max31723.cxx)
+add_executable (max5487-example max5487.cxx)
+add_executable (nrf8001-broadcast-example nrf8001_broadcast.cxx)
+add_executable (nrf8001-helloworld-example nrf8001_helloworld.cxx)
+add_executable (lpd8806-example lpd8806.cxx)
+add_executable (mlx90614-example mlx90614.cxx)
+add_executable (ecs1030-example ecs1030.cxx)
+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 (ttp223-example ttp223.cxx)
+add_executable (lsm303-example lsm303.cxx)
+add_executable (joystick12-example joystick12-example.cxx)
+add_executable (lol-example lol-example.cxx)
+add_executable (nrf_ble_broadcast-example ble_broadcast.cxx)
+add_executable (tsl2561-example tsl2561.cxx)
+add_executable (htu21d-example htu21d.cxx)
+add_executable (mpl3115a2-example mpl3115a2.cxx)
+add_executable (ldt0028-example ldt0028.cxx)
+add_executable (am2315-example am2315.cxx)
+add_executable (itg3200-example itg3200.cxx)
+add_executable (enc03r-example enc03r.cxx)
+add_executable (adc121c021-example adc121c021.cxx)
+add_executable (ds1307-example ds1307.cxx)
+add_executable (a110x-example a110x.cxx)
+add_executable (gp2y0a21yk-example gp2y0a21yk.cxx)
+add_executable (grovemoisture-example grovemoisture.cxx)
+add_executable (groveehr-example groveehr.cxx)
+add_executable (ta12200-example ta12200.cxx)
+add_executable (grovelinefinder-example grovelinefinder.cxx)
+add_executable (grovevdiv-example grovevdiv.cxx)
+add_executable (grovewater-example grovewater.cxx)
+add_executable (guvas12d-example guvas12d.cxx)
+add_executable (groveloudness-example groveloudness.cxx)
+add_executable (mpr121-example mpr121.cxx)
+add_executable (ublox6-example ublox6.cxx)
+add_executable (yg1006-example yg1006.cxx)
+add_executable (wt5001-example wt5001.cxx)
+add_executable (ppd42ns-example ppd42ns.cxx)
+add_executable (mq303a-example mq303a.cxx)
+add_executable (grovespeaker-example grovespeaker.cxx)
+add_executable (rfr359f-example rfr359f.cxx)
+add_executable (biss0001-example biss0001.cxx)
+add_executable (my9221-example my9221.cxx)
+add_executable (grove_mcfled-example grove_mcfled.cxx)
+add_executable (rotaryencoder-example rotaryencoder.cxx)
+add_executable (adxl345-example adxl345.cxx)
+add_executable (rpr220-example rpr220.cxx)
+add_executable (rpr220-intr-example rpr220-intr.cxx)
 
 include_directories (${PROJECT_SOURCE_DIR}/src/hmc5883l)
 include_directories (${PROJECT_SOURCE_DIR}/src/grove)
@@ -26,20 +92,139 @@ include_directories (${PROJECT_SOURCE_DIR}/src/servo)
 include_directories (${PROJECT_SOURCE_DIR}/src/hcsr04)
 include_directories (${PROJECT_SOURCE_DIR}/src/max44000)
 include_directories (${PROJECT_SOURCE_DIR}/src/mma7455)
+include_directories (${PROJECT_SOURCE_DIR}/src/st7735)
+include_directories (${PROJECT_SOURCE_DIR}/src/max31855)
+include_directories (${PROJECT_SOURCE_DIR}/src/gy65)
+include_directories (${PROJECT_SOURCE_DIR}/src/stepmotor)
+include_directories (${PROJECT_SOURCE_DIR}/src/pulsensor)
+include_directories (${PROJECT_SOURCE_DIR}/src/mic)
+include_directories (${PROJECT_SOURCE_DIR}/src/mpu9150)
+include_directories (${PROJECT_SOURCE_DIR}/src/maxds3231m)
+include_directories (${PROJECT_SOURCE_DIR}/src/max31723)
+include_directories (${PROJECT_SOURCE_DIR}/src/max5487)
+include_directories (${PROJECT_SOURCE_DIR}/src/nrf8001)
+include_directories (${PROJECT_SOURCE_DIR}/src/lpd8806)
+include_directories (${PROJECT_SOURCE_DIR}/src/mlx90614)
+include_directories (${PROJECT_SOURCE_DIR}/src/ecs1030)
+include_directories (${PROJECT_SOURCE_DIR}/src/gas)
+include_directories (${PROJECT_SOURCE_DIR}/src/tcs3414cs)
+include_directories (${PROJECT_SOURCE_DIR}/src/th02)
+include_directories (${PROJECT_SOURCE_DIR}/src/ttp223)
+include_directories (${PROJECT_SOURCE_DIR}/src/lsm303)
+include_directories (${PROJECT_SOURCE_DIR}/src/joystick12)
+include_directories (${PROJECT_SOURCE_DIR}/src/lol)
+include_directories (${PROJECT_SOURCE_DIR}/src/tsl2561)
+include_directories (${PROJECT_SOURCE_DIR}/src/htu21d)
+include_directories (${PROJECT_SOURCE_DIR}/src/mpl3115a2)
+include_directories (${PROJECT_SOURCE_DIR}/src/ldt0028)
+include_directories (${PROJECT_SOURCE_DIR}/src/am2315)
+include_directories (${PROJECT_SOURCE_DIR}/src/itg3200)
+include_directories (${PROJECT_SOURCE_DIR}/src/enc03r)
+include_directories (${PROJECT_SOURCE_DIR}/src/adc121c021)
+include_directories (${PROJECT_SOURCE_DIR}/src/ds1307)
+include_directories (${PROJECT_SOURCE_DIR}/src/a110x)
+include_directories (${PROJECT_SOURCE_DIR}/src/gp2y0a21yk)
+include_directories (${PROJECT_SOURCE_DIR}/src/grovemoisture)
+include_directories (${PROJECT_SOURCE_DIR}/src/groveehr)
+include_directories (${PROJECT_SOURCE_DIR}/src/ta12200)
+include_directories (${PROJECT_SOURCE_DIR}/src/grovelinefinder)
+include_directories (${PROJECT_SOURCE_DIR}/src/grovevdiv)
+include_directories (${PROJECT_SOURCE_DIR}/src/grovewater)
+include_directories (${PROJECT_SOURCE_DIR}/src/guvas12d)
+include_directories (${PROJECT_SOURCE_DIR}/src/groveloudness)
+include_directories (${PROJECT_SOURCE_DIR}/src/mpr121)
+include_directories (${PROJECT_SOURCE_DIR}/src/ublox6)
+include_directories (${PROJECT_SOURCE_DIR}/src/yg1006)
+include_directories (${PROJECT_SOURCE_DIR}/src/wt5001)
+include_directories (${PROJECT_SOURCE_DIR}/src/ppd42ns)
+include_directories (${PROJECT_SOURCE_DIR}/src/mq303a)
+include_directories (${PROJECT_SOURCE_DIR}/src/grovespeaker)
+include_directories (${PROJECT_SOURCE_DIR}/src/rfr359f)
+include_directories (${PROJECT_SOURCE_DIR}/src/biss0001)
+include_directories (${PROJECT_SOURCE_DIR}/src/my9221)
+include_directories (${PROJECT_SOURCE_DIR}/src/rotaryencoder)
+include_directories (${PROJECT_SOURCE_DIR}/src/adxl345)
+include_directories (${PROJECT_SOURCE_DIR}/src/rpr220)
 
-target_link_libraries (compass hmc5883l ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (groveled grove ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (grovetemp grove ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (lcm-lcd i2clcd ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (rgb-lcd i2clcd ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (buzzer-sound buzzer ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (led-bar my9221 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (seg-lcd tm1637 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (nrf_transmitter nrf24l01 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (nrf_receiver nrf24l01 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (es08a servo ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (son-hcsr04 hcsr04 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (oled-1308 i2clcd ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (oled-1327 i2clcd ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (proximity max44000 ${CMAKE_THREAD_LIBS_INIT})
-target_link_libraries (accelerometer mma7455 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (hmc5883l-example hmc5883l ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groveled-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groverelay-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovelight-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovetemp-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovebutton-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groverotary-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groveslide-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (lcm-lcd-example i2clcd ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (rgb-lcd-example i2clcd ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (buzzer-sound-example buzzer ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (led-bar-example my9221 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (seg-lcd-example tm1637 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (nrf_transmitter-example nrf24l01 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (nrf_receiver-example nrf24l01 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (es08a-example servo ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (son-hcsr04-example hcsr04 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (oled-1308-example i2clcd ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (oled-1327-example i2clcd ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (max44000-example max44000 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mma7455-example mma7455 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (st7735-example st7735 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (max31855-example max31855 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (gy65-example gy65 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (stepmotor-example stepmotor ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (pulsensor-example pulsensor ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mic-example mic ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mpu9150-example mpu9150 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (maxds3231m-example maxds3231m ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (max31723-example max31723 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (max5487-example max5487 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (nrf8001-broadcast-example nrf8001 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (nrf8001-helloworld-example nrf8001 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (lpd8806-example lpd8806 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mlx90614-example mlx90614 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ecs1030-example ecs1030 ${CMAKE_THREAD_LIBS_INIT})
+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 (ttp223-example ttp223 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (lsm303-example lsm303 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (joystick12-example joystick12 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (lol-example lol ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (nrf_ble_broadcast-example nrf24l01 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (tsl2561-example tsl2561 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (htu21d-example htu21d ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mpl3115a2-example mpl3115a2 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ldt0028-example ldt0028 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (am2315-example am2315 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (itg3200-example itg3200 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (enc03r-example enc03r ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (adc121c021-example adc121c021 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ds1307-example ds1307 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (a110x-example a110x ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (gp2y0a21yk-example gp2y0a21yk ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovemoisture-example grovemoisture ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groveehr-example groveehr ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ta12200-example ta12200 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovelinefinder-example grovelinefinder ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovevdiv-example grovevdiv ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovewater-example grovewater ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (guvas12d-example guvas12d ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (groveloudness-example groveloudness ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mpr121-example mpr121 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ublox6-example ublox6 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (yg1006-example yg1006 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (wt5001-example wt5001 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (ppd42ns-example ppd42ns ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (mq303a-example mq303a ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grovespeaker-example grovespeaker ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (rfr359f-example rfr359f ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (biss0001-example biss0001 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (my9221-example my9221 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (grove_mcfled-example grove ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (rotaryencoder-example rotaryencoder ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (adxl345-example adxl345 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (rpr220-example rpr220 ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries (rpr220-intr-example rpr220 ${CMAKE_THREAD_LIBS_INIT})

examples/a110x.cxx

@@ -0,0 +1,67 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "a110x.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate an A110X sensor on digital pin D2
+  upm::A110X* hall = new upm::A110X(2);
+  
+  // check every second for the presence of a magnetic field (south
+  // polarity)
+  while (shouldRun)
+    {
+      bool val = hall->magnetDetected();
+      if (val)
+        cout << "Magnet (south polarity) detected." << endl;
+      else
+        cout << "No magnet detected." << endl;
+
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete hall;
+  return 0;
+}

examples/adc121c021.cxx

@@ -0,0 +1,66 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include <iostream>
+#include "adc121c021.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+int main(int argc, char **argv)
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate an ADC121C021 on I2C bus 0
+
+  upm::ADC121C021 *adc = new upm::ADC121C021(ADC121C021_I2C_BUS, 
+                                             ADC121C021_DEFAULT_I2C_ADDR);
+
+  // An analog sensor, such as a Grove light sensor,
+  // must be attached to the adc 
+  // Prints the value and corresponding voltage every 50 milliseconds
+  while (shouldRun)
+    {
+      uint16_t val = adc->value();
+      cout << "ADC value: " << val << " Volts = " 
+           << adc->valueToVolts(val) << endl;
+      usleep(50000);
+    }
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete adc;
+  return 0;
+}

examples/adxl345.cxx

@@ -0,0 +1,51 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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 "adxl345.h"
+
+int
+main(int argc, char **argv)
+{
+//! [Interesting]
+    int16_t *raw;
+    float *acc;
+
+    // Note: Sensor only works at 3.3V on the Intel Edison with Arduino breakout
+    upm::Adxl345* accel = new upm::Adxl345(0);
+
+    while(true){
+        accel->update(); // Update the data
+        raw = accel->getRawValues(); // Read raw sensor data
+        acc = accel->getAcceleration(); // Read acceleration (g)
+        fprintf(stdout, "Current scale: 0x%2xg\n", accel->getScale());
+        fprintf(stdout, "Raw: %6d %6d %6d\n", raw[0], raw[1], raw[2]);
+        fprintf(stdout, "AccX: %5.2f g\n", acc[0]);
+        fprintf(stdout, "AccY: %5.2f g\n", acc[1]);
+        fprintf(stdout, "AccZ: %5.2f g\n", acc[2]);
+        sleep(1);
+    }
+//! [Interesting]
+    return 0;
+}

examples/am2315.cxx

@@ -0,0 +1,75 @@
+/*
+ * Author: William Penner <william.penner@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 <signal.h>
+
+#include "am2315.h"
+
+volatile int doWork = 0;
+
+upm::AM2315 *sensor = NULL;
+
+void
+sig_handler(int signo)
+{
+    if (signo == SIGINT) {
+        printf("\nCtrl-C received.\n");
+        doWork = 1;
+    }
+}
+
+int
+main(int argc, char **argv)
+{
+    // Register signal handler
+    signal(SIGINT, sig_handler);
+
+    //! [Interesting]
+    float humidity    = 0.0;
+    float temperature = 0.0;
+
+    sensor = new upm::AM2315(0, AM2315_I2C_ADDRESS);
+
+    sensor->testSensor();
+
+    while (!doWork) {
+        humidity    = sensor->getHumidity();
+        temperature = sensor->getTemperature();
+
+        std::cout << "humidity value = " <<
+                    humidity <<
+                    ", temperature value = " <<
+                    temperature << std::endl;
+        usleep (500000);
+    }
+    //! [Interesting]
+
+    std::cout << "exiting application" << std::endl;
+
+    delete sensor;
+
+    return 0;
+}

examples/biss0001.cxx

@@ -0,0 +1,68 @@
+/*
+ * Author: Zion Orent <zorent@ics.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 <signal.h>
+#include "biss0001.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Motion sensor on GPIO pin D2
+  upm::BISS0001* motion = new upm::BISS0001(2);
+  
+  while (shouldRun)
+  {
+      bool val = motion->value();
+
+      if (val)
+        cout << "Detecting moving object";
+      else
+        cout << "No moving objects detected";
+
+      cout << endl;
+
+      sleep(1);
+  }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete motion;
+  return 0;
+}

examples/ble_broadcast.cxx

@@ -0,0 +1,81 @@
+/*
+ * Author: Yevgeniy Kiveisha <yevgeniy.kiveisha@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 <string.h>
+#include <unistd.h>
+#include <iostream>
+#include "nrf24l01.h"
+#include <signal.h>
+#include <stdio.h>
+#include <vector>
+
+int running = 0;
+upm::NRF24L01 *sensor = NULL;
+
+void
+sig_handler(int signo)
+{
+    printf("got signal\n");
+    if (signo == SIGINT) {
+        printf("exiting application\n");
+        running = 1;
+    }
+}
+
+void nrf_handler () {
+}
+
+int
+main(int argc, char **argv)
+{
+    sensor = new upm::NRF24L01(7, 8);
+    sensor->setBeaconingMode ();
+
+    std::vector<std::string> msgs;
+
+    msgs.push_back ("Hello World 1!!!");
+    msgs.push_back ("Hello World 2!!!");
+    msgs.push_back ("Hello World 3!!!");
+    msgs.push_back ("Hello World 4!!!");
+    msgs.push_back ("Hello World 5!!!");
+
+    signal(SIGINT, sig_handler);
+
+    while (!running) {
+        for (std::vector<std::string>::iterator item = msgs.begin(); item != msgs.end(); ++item) {
+            std::cout << "BROADCASTING " << (*item).c_str() << std::endl;
+
+            for (int i = 0; i < 3; i++) {
+                sensor->sendBeaconingMsg ((uint8_t*) (*item).c_str());
+                usleep (1000000);
+            }
+        }
+    }
+
+    std::cout << "exiting application" << std::endl;
+
+    msgs.clear();
+    delete sensor;
+    return 0;
+}

examples/buzzer-sound.cxx

@@ -25,39 +25,24 @@
 #include <unistd.h>
 #include <iostream>
 #include <signal.h>
-
 #include "buzzer.h"
 
-int running = 0;
-
-void
-sig_handler(int signo)
-{
-    printf("got signal\n");
-    if (signo == SIGINT) {
-        printf("exiting application\n");
-        running = 1;
-    }
-}
 
 int
 main(int argc, char **argv) {
+    //! [Interesting]
     int chord[] = { DO, RE, MI, FA, SOL, LA, SI, DO, SI };
 
-    //! [Interesting]
     // create Buzzer instance
     upm::Buzzer* sound = new upm::Buzzer(5);
     // print sensor name
     std::cout << sound->name() << std::endl;
-    // play sound (DO, RE, ME, etc...)
 
-    signal(SIGINT, sig_handler);
-
-    while (!running) {
-        for (int chord_ind = 0; chord_ind < 9; chord_ind++) {
-            std::cout << sound->playSound(chord[chord_ind]) << std::endl;
-            usleep(1000);
-        }
+    // play sound (DO, RE, MI, etc...), pausing for 0.1 seconds between notes
+    for (int chord_ind = 0; chord_ind < 7; chord_ind++) {
+        // play each note for one second
+        std::cout << sound->playSound(chord[chord_ind], 1000000) << std::endl;
+        usleep(100000);
     }
     //! [Interesting]
 

examples/ds1307.cxx

@@ -0,0 +1,77 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 "ds1307.h"
+
+using namespace std;
+
+void printTime(upm::DS1307 *rtc)
+{
+  cout << "The time is: " << 
+    rtc->month << "/" << rtc->dayOfMonth << "/" << rtc->year << " " 
+       << rtc->hours << ":" << rtc->minutes << ":" << rtc->seconds;
+
+  if (rtc->amPmMode)
+    cout << (rtc->pm) ? " PM " : " AM ";
+
+  cout << endl;
+
+  cout << "Clock is in " << ((rtc->amPmMode) ? "AM/PM mode" : "24hr mode")
+       << endl;
+}
+
+int
+main(int argc, char **argv)
+{
+//! [Interesting]
+  // Instantiate a DS1037 on I2C bus 0
+  upm::DS1307 *rtc = new upm::DS1307(0);
+  
+  // always do this first
+  cout << "Loading the current time... " << endl;
+  if (!rtc->loadTime())
+    {
+      cerr << "rtc->loadTime() failed." << endl;
+      return 0;
+    }
+  
+  printTime(rtc);
+
+  // set the year as an example
+  cout << "setting the year to 50" << endl;
+  rtc->year = 50;
+
+  rtc->setTime();
+
+  // reload the time and print it
+  rtc->loadTime();
+  printTime(rtc);
+
+  //! [Interesting]
+  
+  delete rtc;
+  return 0;
+}

examples/ecs1030.cxx

@@ -0,0 +1,61 @@
+/*
+ * Author: Yevgeniy Kiveisha <yevgeniy.kiveisha@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 <signal.h>
+#include <stdlib.h>
+#include "ecs1030.h"
+
+int is_running = 0;
+upm::ECS1030 *sensor = NULL;
+
+void
+sig_handler(int signo)
+{
+    printf("got signal\n");
+    if (signo == SIGINT) {
+        is_running = 1;
+    }
+}
+
+//! [Interesting]
+int
+main(int argc, char **argv)
+{
+    sensor = new upm::ECS1030(0);
+    signal(SIGINT, sig_handler);
+
+    while (!is_running) {
+        std::cout << "I = " << sensor->getCurrency_A () << ", Power = " << sensor->getPower_A () << std::endl;
+        std::cout << "I = " << sensor->getCurrency_B () << ", Power = " << sensor->getPower_B () << std::endl;
+    }
+
+    std::cout << "exiting application" << std::endl;
+
+    delete sensor;
+
+    return 0;
+}
+//! [Interesting]

examples/enc03r.cxx

@@ -0,0 +1,79 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "enc03r.h"
+
+using namespace std;
+
+bool shouldRun = true;
+
+// analog voltage, usually 3.3 or 5.0
+#define CALIBRATION_SAMPLES 1000
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+int main()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+
+  // Instantiate a ENC03R on analog pin A0
+  upm::ENC03R *gyro = new upm::ENC03R(0);
+  
+  // The first thing we need to do is calibrate the sensor.
+  cout << "Please place the sensor in a stable location, and do not" << endl;
+  cout << "move it while calibration takes place." << endl;
+  cout << "This may take a couple of minutes." << endl;
+
+  gyro->calibrate(CALIBRATION_SAMPLES);
+  cout << "Calibration complete.  Reference value: " 
+       << gyro->calibrationValue() << endl;
+
+  // Read the input and print both the raw value and the angular velocity,
+  // waiting 0.1 seconds between readings
+  while (shouldRun)
+    {
+      unsigned int val = gyro->value();
+      double av = gyro->angularVelocity(val);
+
+      cout << "Raw value: " << val << ", "  
+           << "angular velocity: " << av << " deg/s" << endl;
+      
+      usleep(100000);
+    }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete gyro;
+  return 0;
+}

examples/es08a.cxx

@@ -28,38 +28,29 @@
 #include <signal.h>
 #include <stdlib.h>
 
-int running = 0;
-
-void
-sig_handler(int signo)
-{
-    printf("got signal\n");
-    if (signo == SIGINT) {
-        printf("exiting application\n");
-        running = 1;
-    }
-}
-
 int
 main(int argc, char **argv)
 {
     //! [Interesting]
-    upm::ES08A *servo = new upm::ES08A(5);
+    upm::ES08A *servo = new upm::ES08A(5);    
 
-    signal(SIGINT, sig_handler);
-
-    int clock = 0;
-    while (!running) {
-        for (int i = 0; i < 18; i++) {
-            servo->setAngle (clock);
-            clock += 10;
-        }
-
-        for (int i = 0; i < 18; i++) {
-            servo->setAngle (clock);
-            clock -= 10;
-        }
-    }
+    // Sets the shaft to 180, then to 90, then to 0,
+    // then back to 90, and finally back to 180,
+    // pausing for a second in between each angle
+    servo->setAngle (180);
+    std::cout << "Set angle to 180" << std::endl;
+    sleep(1);
+    servo->setAngle (90);
+    std::cout << "Set angle to 90" << std::endl;
+    sleep(1);
+    servo->setAngle (0);
+    std::cout << "Set angle to 0" << std::endl;
+    sleep(1);
+    servo->setAngle (90);
+    std::cout << "Set angle to 90" << std::endl;
+    sleep(1);
+    servo->setAngle (180);
+    std::cout << "Set angle to 180" << std::endl;
     //! [Interesting]
 
     std::cout << "exiting application" << std::endl;

examples/gp2y0a21yk.cxx

@@ -0,0 +1,73 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "gp2y0a21yk.h"
+
+using namespace std;
+
+bool shouldRun = true;
+
+// analog voltage, usually 3.3 or 5.0
+#define GP2Y0A21YK_AREF   5.0
+#define SAMPLES_PER_QUERY 20
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+int main()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Note, for the Grove version of this sensor, due to the way it is wired,
+  // you need to plug this into the A0 port, where it will use the available
+  // A1 pin for data.
+
+  // Instantiate a GP2Y0A21YK on analog pin A1
+  upm::GP2Y0A21YK *volts = new upm::GP2Y0A21YK(1);
+  
+  // The higher the voltage (closer to AREF) the closer the object is.  NOTE:
+  // the measured voltage will probably not exceed 3.3 volts.
+  // Every second, print the averaged voltage value (averaged over 20 samples).
+  while (shouldRun)
+    {
+      cout << "AREF: " << GP2Y0A21YK_AREF 
+           << ", Voltage value (higher means closer): " 
+           << volts->value(GP2Y0A21YK_AREF, SAMPLES_PER_QUERY) << endl;
+      
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete volts;
+  return 0;
+}

examples/grove_mcfled.cxx

@@ -0,0 +1,68 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.com>
+ * Copyright (c) 2014-2015 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 <signal.h>
+#include "grove.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+
+  // Instantiate a grove LED on D2.  Here we are controlling a Grove
+  // Multi-color flash LED.  We just just need to turn it on - it will
+  // then cycle through various colors (red, green, blue, purple) on it's
+  // own until turned off.
+  upm::GroveLed* led = new upm::GroveLed(2);
+
+  // start the light show
+  led->on();
+
+  // just sleep until interrupted
+  while (shouldRun)
+    sleep(1);
+  
+//! [Interesting]
+
+  led->off();
+  cout << "Exiting..." << endl;
+
+  delete led;
+  
+  return 0;
+}

examples/grovebutton.cxx

@@ -0,0 +1,49 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@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 "grove.h"
+
+int
+main(int argc, char **argv)
+{
+    // This example uses GPIO 0
+//! [Interesting]
+
+    // Create the button object using GPIO pin 0
+    upm::GroveButton* button = new upm::GroveButton(0);
+
+    // Read the input and print, waiting one second between readings
+    while( 1 ) {
+        std::cout << button->name() << " value is " << button->value() << std::endl;
+        sleep(1);
+    }
+
+    // Delete the button object
+    delete button;
+//! [Interesting]
+
+    return 0;
+}

examples/groveehr.cxx

@@ -0,0 +1,78 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "groveehr.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Ear-clip Heart Rate sensor on digital pin D2
+  upm::GroveEHR* heart = new upm::GroveEHR(2);
+  
+  // set the beat counter to 0, init the clock and start counting beats
+  heart->clearBeatCounter();
+  heart->initClock();
+  heart->startBeatCounter();
+
+  while (shouldRun)
+    {
+      // we grab these just for display purposes in this example
+      uint32_t millis = heart->getMillis();
+      uint32_t beats = heart->beatCounter();
+
+      // heartRate() requires that at least 5 seconds pass before
+      // returning anything other than 0
+      int hr = heart->heartRate();
+
+      // output milliseconds passed, beat count, and computed heart rate
+      cout << "Millis: " << millis << " Beats: " << beats;
+      cout << " Heart Rate: " << hr << endl;
+
+      sleep(1);
+    }
+
+  heart->stopBeatCounter();
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete heart;
+  return 0;
+}

examples/groveled.cxx

@@ -1,5 +1,6 @@
 /*
  * Author: Brendan Le Foll <brendan.le.foll@intel.com>
+ * Contributions: Sarah Knepper <sarah.knepper@intel.com>
  * Copyright (c) 2014 Intel Corporation.
  *
  * Permission is hereby granted, free of charge, to any person obtaining
@@ -29,9 +30,16 @@
 int
 main(int argc, char **argv)
 {
-    // Use i2c device 0 all the time
+//! [Interesting]
+
+    // Create the Grove LED object using GPIO pin 2
     upm::GroveLed* led = new upm::GroveLed(2);
+
+    // Print the name
     std::cout << led->name() << std::endl;
+
+    // Turn the LED on and off 10 times, pausing one second
+    // between transitions
     for (int i=0; i < 10; i++) {
         led->on();
         sleep(1);
@@ -39,5 +47,9 @@ main(int argc, char **argv)
         sleep(1);
     }
 
+    // Delete the Grove LED object
+    delete led;
+//! [Interesting]
+
     return 0;
 }

examples/grovelight.cxx

@@ -0,0 +1,49 @@
+/*
+ * Author: Brendan Le Foll <brendan.le.foll@intel.com>
+ * Contributions: Sarah Knepper <sarah.knepper@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 "grove.h"
+
+int
+main(int argc, char **argv)
+{
+//! [Interesting]
+    // Create the light sensor object using AIO pin 0
+    upm::GroveLight* light = new upm::GroveLight(0);
+
+    // Read the input and print both the raw value and a rough lux value,
+    // waiting one second between readings
+    while( 1 ) {
+        std::cout << light->name() << " raw value is " << light->raw_value() <<
+            ", which is roughly " << light->value() << " lux" << std::endl;
+        sleep(1);
+    }
+
+    // Delete the light sensor object
+    delete light;
+//! [Interesting]
+    return 0;
+}

examples/grovelinefinder.cxx

@@ -0,0 +1,66 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "grovelinefinder.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Line Finder sensor on digital pin D2
+  upm::GroveLineFinder* finder = new upm::GroveLineFinder(2);
+  
+  // check every second for the presence of white detection
+  while (shouldRun)
+    {
+      bool val = finder->whiteDetected();
+      if (val)
+        cout << "White detected." << endl;
+      else
+        cout << "Black detected." << endl;
+
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete finder;
+  return 0;
+}

examples/groveloudness.cxx

@@ -0,0 +1,63 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "groveloudness.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Loudness sensor on analog pin A0
+  upm::GroveLoudness* loudness = new upm::GroveLoudness(0);
+
+  // Print the loudness value every 0.1 seconds
+  while (shouldRun)
+    {
+      int val = loudness->value();
+      cout << "Loudness value (higher is louder): " << val << endl;
+
+      usleep(100000);
+    }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete loudness;
+  return 0;
+}

examples/grovemoisture.cxx

@@ -0,0 +1,75 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "grovemoisture.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Moisture sensor on analog pin A0
+  upm::GroveMoisture* moisture = new upm::GroveMoisture(0);
+  
+  // Values (approximate): 
+  // 0-300, sensor in air or dry soil
+  // 300-600, sensor in humid soil
+  // 600+, sensor in wet soil or submerged in water.
+  // Read the value every second and print the corresponding moisture level
+  while (shouldRun)
+    {
+      int val = moisture->value();
+      cout << "Moisture value: " << val << ", ";
+      if (val >= 0 && val < 300)
+        cout << "dry";
+      else if (val >= 300 && val < 600)
+        cout << "moist";
+      else
+        cout << "wet";
+
+      cout << endl;
+
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete moisture;
+  return 0;
+}

examples/groverelay.cxx

@@ -0,0 +1,58 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@intel.com>
+ * Copyright (c) 2015 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 "grove.h"
+
+int
+main(int argc, char **argv)
+{
+    // This example uses GPIO 0
+//! [Interesting]
+
+    // Create the relay switch object using GPIO pin 0
+    upm::GroveRelay* relay = new upm::GroveRelay(0);
+
+    // Close and then open the relay switch 3 times,
+    // waiting one second each time.  The LED on the relay switch
+    // will light up when the switch is on (closed).
+    // The switch will also make a noise between transitions.
+    for ( int i = 0; i < 3; i++ ) {
+        relay->on();
+        if ( relay->isOn() ) 
+            std::cout << relay->name() << " is on" << std::endl;
+        sleep(1);
+        relay->off();
+        if ( relay->isOff() ) 
+            std::cout << relay->name() << " is off" << std::endl;
+        sleep(1);
+    }
+
+    // Delete the relay switch object
+    delete relay;
+//! [Interesting]
+
+    return 0;
+}

examples/groverotary.cxx

@@ -0,0 +1,57 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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 <iomanip>
+#include "grove.h"
+
+using namespace std;
+
+int main ()
+{
+//! [Interesting]
+    // Instantiate a rotary sensor on analog pin A0
+    upm::GroveRotary* knob = new upm::GroveRotary(0);
+
+    // Print sensor name to confirm it initialized properly
+    cout << knob->name() << endl;
+
+    while(true) {
+        float abs_value = knob->abs_value(); // Absolute raw value
+        float abs_deg = knob->abs_deg();     // Absolute degrees
+        float abs_rad = knob->abs_rad();     // Absolute radians
+        float rel_value = knob->rel_value(); // Relative raw value
+        float rel_deg = knob->rel_deg();     // Relative degrees
+        float rel_rad = knob->rel_rad();     // Relative radians
+
+        fprintf(stdout, "Absolute: %4d raw %5.2f deg = %3.2f rad Relative: %4d raw %5.2f deg %3.2f rad\n",
+                (int16_t)abs_value, abs_deg, abs_rad, (int16_t)rel_value, rel_deg, rel_rad);
+
+        usleep(2500000); // Sleep for 2.5s
+    }
+//! [Interesting]
+    delete knob;
+    return 0;
+}

examples/groveslide.cxx

@@ -0,0 +1,50 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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 <iomanip>
+#include "grove.h"
+
+using namespace std;
+
+int main ()
+{
+//! [Interesting]
+    upm::GroveSlide* slide = new upm::GroveSlide(0);    // Instantiate new grove slide potentiometer on analog pin A0
+
+    cout << slide->name() << endl;
+
+    while(true) {
+        float adc_value = slide->raw_value();       // Read raw value
+        float volts = slide->voltage_value();    // Read voltage, board reference set at 5.0V
+        fprintf(stdout, "%4d = %.2f V\n", (uint16_t)adc_value, volts);
+
+        usleep(2500000);    // Sleep for 2.5s
+    }
+//! [Interesting]
+    delete slide;
+    return 0;
+}

examples/grovespeaker.cxx

@@ -0,0 +1,49 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "grovespeaker.h"
+
+using namespace std;
+
+int main ()
+{
+//! [Interesting]
+  // Instantiate a Grove Speaker on digital pin D2
+  upm::GroveSpeaker* speaker = new upm::GroveSpeaker(2);
+
+  // Play all 7 of the lowest notes
+  speaker->playAll();
+
+  // Play a medium C-sharp
+  speaker->playSound('c', true, "med");
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete speaker;
+  return 0;
+}

examples/grovetemp.cxx

@@ -1,5 +1,6 @@
 /*
  * Author: Brendan Le Foll <brendan.le.foll@intel.com>
+ * Contributions: Sarah Knepper <sarah.knepper@intel.com>
  * Copyright (c) 2014 Intel Corporation.
  *
  * Permission is hereby granted, free of charge, to any person obtaining
@@ -24,18 +25,31 @@
 
 #include <unistd.h>
 #include <iostream>
+#include <iomanip>
 #include "grove.h"
 
 int
 main(int argc, char **argv)
 {
-    // Use i2c device 0 all the time
-    upm::GroveTemp* s = new upm::GroveTemp(0);
-    std::cout << s->name() << std::endl;
+//! [Interesting]
+
+    // Create the temperature sensor object using AIO pin 0
+    upm::GroveTemp* temp = new upm::GroveTemp(0);
+    std::cout << temp->name() << std::endl;
+
+    // Read the temperature ten times, printing both the Celsius and
+    // equivalent Fahrenheit temperature, waiting one second between readings
     for (int i=0; i < 10; i++) {
-        std::cout << s->value() << std::endl;
+        int celsius = temp->value();
+        int fahrenheit = (int) (celsius * 9.0/5.0 + 32.0);
+        printf("%d degrees Celsius, or %d degrees Fahrenheit\n",
+                celsius, fahrenheit);
         sleep(1);
     }
 
+    // Delete the temperature sensor object
+    delete temp;
+//! [Interesting]
+
     return 0;
 }

examples/grovevdiv.cxx

@@ -0,0 +1,67 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "grovevdiv.h"
+
+using namespace std;
+
+bool shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Voltage Divider sensor on analog pin A0
+  upm::GroveVDiv* vDiv = new upm::GroveVDiv(0);
+
+  // collect data and output measured voltage according to the setting
+  // of the scaling switch (3 or 10)
+  while (shouldRun)
+    {
+      unsigned int val = vDiv->value(100);
+      float gain3val = vDiv->computedValue(3, val);
+      float gain10val = vDiv->computedValue(10, val);
+      cout << "ADC value: " << val << " Gain 3: " << gain3val 
+           << "v Gain 10: " << gain10val << "v" << endl;
+
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete vDiv;
+  return 0;
+}

examples/grovewater.cxx

@@ -0,0 +1,65 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "grovewater.h"
+
+using namespace std;
+
+int shouldRun = true;
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+
+int main ()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // Instantiate a Grove Water sensor on digital pin D2
+  upm::GroveWater* water = new upm::GroveWater(2);
+  
+  while (shouldRun)
+    {
+      bool val = water->isWet();
+      if (val)
+        cout << "Sensor is wet." << endl;
+      else
+        cout << "Sensor is dry." << endl;
+
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting..." << endl;
+
+  delete water;
+  return 0;
+}

examples/guvas12d.cxx

@@ -0,0 +1,72 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.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 <signal.h>
+#include "guvas12d.h"
+
+using namespace std;
+
+bool shouldRun = true;
+
+// analog voltage, usually 3.3 or 5.0
+#define GUVAS12D_AREF   5.0
+#define SAMPLES_PER_QUERY 1024
+
+void sig_handler(int signo)
+{
+  if (signo == SIGINT)
+    shouldRun = false;
+}
+
+int main()
+{
+  signal(SIGINT, sig_handler);
+
+//! [Interesting]
+  // The was tested with the Grove UV Sensor module.
+  // It has a sensing range from between 200-400nm.  It's strongest
+  // response is around 320-360nm.
+
+  // Instantiate a GUVAS12D on analog pin A0
+  upm::GUVAS12D *volts = new upm::GUVAS12D(0);
+  
+  // The higher the voltage the more intense the UV radiation.
+
+  while (shouldRun)
+    {
+      cout << "AREF: " << GUVAS12D_AREF 
+           << ", Voltage value (higher means more UV): " 
+           << volts->value(GUVAS12D_AREF, SAMPLES_PER_QUERY) << endl;
+      
+      sleep(1);
+    }
+//! [Interesting]
+
+  cout << "Exiting" << endl;
+
+  delete volts;
+  return 0;
+}

examples/gy65.cxx

@@ -0,0 +1,80 @@
+/*
+ * Author: Yevgeniy Kiveisha <yevgeniy.kiveisha@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 "gy65.h"
+#include <signal.h>
+
+int doWork = 0;
+upm::GY65 *sensor = NULL;
+
+void
+sig_handler(int signo)
+{
+    printf("got signal\n");
+    if (signo == SIGINT) {
+        printf("exiting application\n");
+        doWork = 1;
+    }
+}
+
+int
+main(int argc, char **argv)
+{
+    //! [Interesting]
+    uint32_t presure = 0;
+    float temperature = 0;
+    float altitude = 0;
+    uint32_t sealevel = 0;
+
+    // Instantiate a GY65 sensor on I2C
+    sensor = new upm::GY65(0, ADDR);
+
+    // Print the pressure, altitude, sea level, and
+    // temperature values every 0.1 seconds
+    while (!doWork) {
+        presure = sensor->getPressure ();
+        temperature = sensor->getTemperature ();
+        altitude = sensor->getAltitude ();
+        sealevel = sensor->getSealevelPressure ();
+
+        std::cout << "pressure value = " <<
+                    presure <<
+                    ", altitude value = " <<
+                    altitude <<
+                    ", sealevel value = " <<
+                    sealevel <<
+                    ", temperature = " <<
+                    temperature << std::endl;
+        usleep (100000);
+    }
+    //! [Interesting]
+
+    std::cout << "exiting application" << std::endl;
+
+    delete sensor;
+
+    return 0;
+}

examples/hcsr04.cxx

@@ -43,7 +43,7 @@ sig_handler(int signo)
 
 //! [Interesting]
 void
-interrupt (void) {
+interrupt (void * args) {
     sonar->ackEdgeDetected ();
 }
 

examples/hmc5883l.cxx

@@ -0,0 +1,50 @@
+/*
+ * Author: Brendan Le Foll <brendan.le.foll@intel.com>
+ * Contributions: Mihai Tudor Panu <mihai.tudor.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 "hmc5883l.h"
+
+int
+main(int argc, char **argv)
+{
+//! [Interesting]
+    // Instantiate on I2C
+    upm::Hmc5883l* compass = new upm::Hmc5883l(0);
+    int16_t *pos;
+
+    compass->set_declination(0.2749); // Set your declination from true north in radians
+
+    // Print out the coordinates, heading, and direction every second
+    while(true){
+        compass->update(); // Update the coordinates
+        pos = compass->coordinates();
+        fprintf(stdout, "coor: %5d %5d %5d ", pos[0], pos[1], pos[2]);
+        fprintf(stdout, "heading: %5.2f direction: %3.2f\n", compass->heading(), compass->direction());
+        sleep(1);
+    }
+//! [Interesting]
+
+    return 0;
+}

examples/htu21d.cxx

@@ -0,0 +1,79 @@
+/*
+ * Author: William Penner <william.penner@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 <signal.h>
+
+#include "htu21d.h"
+
+volatile int doWork = 0;
+
+upm::HTU21D *sensor = NULL;
+
+void
+sig_handler(int signo)
+{
+    if (signo == SIGINT) {
+        printf("\nCtrl-C received.\n");
+        doWork = 1;
+    }
+}
+
+int
+main(int argc, char **argv)
+{
+    // Register signal handler
+    signal(SIGINT, sig_handler);
+
+    //! [Interesting]
+    float humidity    = 0.0;
+    float temperature = 0.0;
+    float compRH      = 0.0;
+
+    sensor = new upm::HTU21D(0, HTU21D_I2C_ADDRESS);
+
+    sensor->testSensor();
+
+    while (!doWork) {
+        compRH      = sensor->getCompRH(true);
+        humidity    = sensor->getHumidity(false);
+        temperature = sensor->getTemperature(false);
+
+        std::cout << "humidity value = " <<
+                    humidity <<
+                    ", temperature value = " <<
+                    temperature <<
+                    ", compensated RH value = " <<
+                    compRH << std::endl;
+        usleep (500000);
+    }
+    //! [Interesting]
+
+    std::cout << "exiting application" << std::endl;
+
+    delete sensor;
+
+    return 0;
+}

examples/itg3200.cxx

@@ -0,0 +1,51 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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 "itg3200.h"
+
+int
+main(int argc, char **argv)
+{
+//! [Interesting]
+    int16_t *rot;
+    float *ang;
+
+    // Note: Sensor not supported on Intel Edison with Arduino breakout
+    upm::Itg3200* gyro = new upm::Itg3200(0);
+
+    while(true){
+        gyro->update(); // Update the data
+        rot = gyro->getRawValues(); // Read raw sensor data
+        ang = gyro->getRotation(); // Read rotational speed (deg/sec)
+        fprintf(stdout, "Raw: %6d %6d %6d\n", rot[0], rot[1], rot[2]);
+        fprintf(stdout, "AngX: %5.2f\n", ang[0]);
+        fprintf(stdout, "AngY: %5.2f\n", ang[1]);
+        fprintf(stdout, "AngZ: %5.2f\n", ang[2]);
+        fprintf(stdout, "Temp: %5.2f Raw: %6d\n", gyro->getTemperature(), gyro->getRawTemp());
+        sleep(1);
+    }
+//! [Interesting]
+    return 0;
+}

examples/javascript/a110x.js

@@ -0,0 +1,47 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 hallEffectSensor = require('jsupm_a110x');
+
+// Instantiate a Hall Effect magnet sensor on digital pin D2
+var myHallEffectSensor = new hallEffectSensor.A110X(2);
+
+// Check every second for the presence of a magnetic field (south polarity)
+setInterval(function()
+{
+	if (myHallEffectSensor.magnetDetected())
+		console.log("Magnet (south polarity) detected.");
+	else
+		console.log("No magnet detected.");
+}, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/adc121c021.js

@@ -0,0 +1,49 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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.
+*/
+
+// Load ADC121C021 module
+var I2C_ADC = require('jsupm_adc121c021');
+// Instantiate an ADC121C021 on I2C bus 0
+var busID = I2C_ADC.ADC121C021_I2C_BUS;
+var I2CAddr = I2C_ADC.ADC121C021_DEFAULT_I2C_ADDR;
+var myI2C_ADC = new I2C_ADC.ADC121C021(busID, I2CAddr);
+
+// get the data every 50 milliseconds
+setInterval(function()
+{
+	var val = myI2C_ADC.value();
+	var voltsVal = myI2C_ADC.valueToVolts(val);
+	console.log("ADC value: " + val + " Volts = " + voltsVal);
+}, 50);
+
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/adxl345.js

@@ -0,0 +1,41 @@
+/*
+* Author: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
+* Copyright (c) 2015 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.
+*/
+
+// Load accelerometer
+var adxl345 = require('jsupm_adxl345');
+
+// Instantiate on I2C bus
+var adxl = new adxl345.Adxl345(0);
+
+setInterval(function()
+{
+    adxl.update(); // Update the data
+    var raw = adxl.getRawValues(); // Read raw sensor data
+    var force = adxl.getAcceleration(); // Read acceleration force (g)
+    var rawvalues = raw.getitem(0) + " " + raw.getitem(1) + " " + raw.getitem(2);
+    console.log("Raw Values: " + rawvalues);
+    console.log("ForceX: " + force.getitem(0).toFixed(2) + " g");
+    console.log("ForceY: " + force.getitem(1).toFixed(2) + " g");
+    console.log("ForceZ: " + force.getitem(2).toFixed(2) + " g");
+}, 1000);

examples/javascript/biss0001.js

@@ -0,0 +1,45 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+//Load Grove Motion module
+var grove_motion = require('jsupm_biss0001');
+// Instantiate a Grove Motion sensor on GPIO pin D2
+var myMotionObj = new grove_motion.BISS0001(2);
+setInterval(function()
+{
+	if (myMotionObj.value())
+		console.log("Detecting moving object");
+	else
+		console.log("No moving objects detected");
+}, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/buzzer.js

@@ -0,0 +1,65 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+ * Author: Zion Orent <zorent@ics.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 upmBuzzer = require("jsupm_buzzer");
+// Initialize on GPIO 5
+var myBuzzer = new upmBuzzer.Buzzer(5);
+var chords = [];
+chords.push(upmBuzzer.DO);
+chords.push(upmBuzzer.RE);
+chords.push(upmBuzzer.MI);
+chords.push(upmBuzzer.FA);
+chords.push(upmBuzzer.SOL);
+chords.push(upmBuzzer.LA);
+chords.push(upmBuzzer.SI);
+chords.push(upmBuzzer.DO);
+chords.push(upmBuzzer.SI);
+var chordIndex = 0;
+
+// Print sensor name
+console.log(myBuzzer.name());
+
+function melody()
+{
+    if (chords.length != 0)
+    {
+        //Play sound for one second
+        console.log( myBuzzer.playSound(chords[chordIndex], 1000000) );
+        chordIndex++;
+        //Reset the sound to start from the beginning. 
+        if (chordIndex > chords.length - 1)
+			chordIndex = 0;
+    }
+}
+setInterval(melody, 100);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/ds1307.js

@@ -0,0 +1,68 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+// Load RTC Clock module for Grove - RTC clock
+var ds1307 = require('jsupm_ds1307');
+// load this on i2c bus 0
+var myRTCClockObj = new ds1307.DS1307(0);
+
+// always do this first
+console.log("Loading the current time... ");
+
+var result = myRTCClockObj.loadTime();
+if (!result)
+{
+	console.log("myRTCClockObj.loadTime() failed.");
+	process.exit(1);
+}
+
+printTime(myRTCClockObj);
+
+// set the year as an example
+console.log("setting the year to 50");
+myRTCClockObj.year = 50;
+myRTCClockObj.setTime();
+
+// reload the time and print it
+myRTCClockObj.loadTime();
+printTime(myRTCClockObj);
+
+function printTime(RTCObj)
+{
+	var timeStr = "The time is: " + 
+        RTCObj.month + "/" + RTCObj.dayOfMonth + "/" + RTCObj.year + " " +
+        RTCObj.hours + ":" + RTCObj.minutes + ":" + RTCObj.seconds;
+
+	if (RTCObj.amPmMode)
+		timeStr += (RTCObj.pm ? " PM " : " AM ");
+
+	console.log(timeStr);
+
+	console.log("Clock is in " + 
+                (RTCObj.amPmMode ? "AM/PM mode" : "24hr mode"));
+}
+

examples/javascript/enc03r.js

@@ -0,0 +1,66 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+// Load analog gyro module
+var analogGyro = require('jsupm_enc03r');
+// Instantiate a ENC03R on analog pin A0
+var myGyro = new analogGyro.ENC03R(0);
+
+var CALIBRATION_SAMPLES = 1000;
+
+console.log("Please place the sensor in a stable location,\n" +
+			"and do not move it while calibration takes place.\n" +
+			"This may take a couple of minutes.");
+
+myGyro.calibrate(CALIBRATION_SAMPLES);
+console.log("Calibration complete.  Reference value: " +
+            myGyro.calibrationValue());
+
+// Read the input and print both the raw value and the angular velocity,
+// waiting 0.1 seconds between readings
+setInterval(function()
+{
+	var gyroVal = myGyro.value();
+	var outputStr = "Raw value: " + gyroVal + ", "  +
+					"angular velocity: " +
+					roundNum(myGyro.angularVelocity(gyroVal), 5) + " deg/s";
+	console.log(outputStr);
+}, 100);
+
+function roundNum(num, decimalPlaces)
+{
+	var extraNum = (1 / (Math.pow(10, decimalPlaces) * 1000));
+	return (Math.round((num + extraNum) * (Math.pow(10, decimalPlaces))) / 
+            Math.pow(10, decimalPlaces));
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/es08a.js

@@ -0,0 +1,69 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+ * Author: Zion Orent <zorent@ics.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.
+ */
+
+//Load servo module.
+var servoModule = require("jsupm_servo");
+
+//Instantiate ES08A Servo module on GPIO 5
+var servo = new servoModule.ES08A(5);
+
+// function to initialize servo
+    // timeOffset: how long after hitting "run"
+    //		should we start this servo instance
+    // timeInterval: how frequently should this instance run after timeOffset
+    // angle: the angle for this instance
+function startServo(timeOffset, timeInterval, angle)
+{
+    // Start running this instance after timeOffset milliseconds
+    setTimeout(function()
+    {
+        // run this instance every timeInterval milliseconds
+        setInterval(function()
+        {
+            servo.setAngle(angle);
+            console.log("Set angle to " + angle);
+        }, timeInterval);
+    }, timeOffset);
+    // timeOffset tells setTimeout when
+    //		to execute the function specified in the first param
+    // angle is passed as a param to the specified function
+}
+// start immediately, run every 3 seconds, go 0 degrees
+startServo(0, 3000, 0);
+
+// start in 1 second, run every 3 seconds, go 90 degrees
+startServo(1000, 3000, 90);
+
+// start in 2 seconds, run every 3 seconds, go 180 degrees
+startServo(2000, 3000, 180);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gas/mq2.js

@@ -0,0 +1,59 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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 upmMQ2 = require("jsupm_gas");
+
+// Attach gas sensor to AIO0
+var myMQ2 = new upmMQ2.MQ2(0);
+
+var threshContext = new upmMQ2.thresholdContext;
+threshContext.averageReading = 0;
+threshContext.runningAverage = 0;
+threshContext.averagedOver = 2;
+
+// Infinite loop, ends when script is cancelled
+// Repeatedly, take a sample every 2 milliseconds;
+// find the average of 128 samples; and
+// print a running graph of the averages using a resolution of 5
+while(1)
+{
+    var buffer = new upmMQ2.uint16Array(128);
+    var len = myMQ2.getSampledWindow(2, 128, buffer);
+    if (len)
+    {
+        var thresh = myMQ2.findThreshold(threshContext, 30, buffer, len);
+        myMQ2.printGraph(threshContext, 5);
+        //if (thresh)
+        //    console.log("Threshold is " + thresh);
+    }
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gas/mq3.js

@@ -0,0 +1,60 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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 upmMQ3 = require("jsupm_gas");
+
+// Attach gas sensor to AIO0
+var myMQ3 = new upmMQ3.MQ3(0);
+
+var threshContext = new upmMQ3.thresholdContext;
+threshContext.averageReading = 0;
+threshContext.runningAverage = 0;
+threshContext.averagedOver = 2;
+
+// Infinite loop, ends when script is cancelled
+// Repeatedly, take a sample every 2 milliseconds;
+// find the average of 128 samples; and
+// print a running graph of the averages using a resolution of 5
+while(1)
+{
+    var buffer = new upmMQ3.uint16Array(128);
+    var len = myMQ3.getSampledWindow(2, 128, buffer);
+    if (len)
+    {
+        var thresh = myMQ3.findThreshold(threshContext, 30, buffer, len);
+        myMQ3.printGraph(threshContext, 5);
+        //if (thresh)
+        //    console.log("Threshold is " + thresh);
+    }
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gas/mq5.js

@@ -0,0 +1,57 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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 upmMQ5 = require("jsupm_gas");
+
+// Attach gas sensor to AIO0
+var myMQ5 = new upmMQ5.MQ5(0);
+
+var threshContext = new upmMQ5.thresholdContext;
+threshContext.averageReading = 0;
+threshContext.runningAverage = 0;
+threshContext.averagedOver = 2;
+
+// Infinite loop, ends when script is cancelled
+while(1)
+{
+    var buffer = new upmMQ5.uint16Array(128);
+    var len = myMQ5.getSampledWindow(2, 128, buffer);
+    if (len)
+    {
+        var thresh = myMQ5.findThreshold(threshContext, 30, buffer, len);
+        myMQ5.printGraph(threshContext, 5);
+        //if (thresh)
+        //    console.log("Threshold is " + thresh);
+    }
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gas/mq9.js

@@ -0,0 +1,56 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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 upmMQ9 = require("jsupm_gas");
+
+// Attach gas sensor to AIO0
+var myMQ9 = new upmMQ9.MQ9(0);
+
+var threshContext = new upmMQ9.thresholdContext;
+threshContext.averageReading = 0;
+threshContext.runningAverage = 0;
+threshContext.averagedOver = 2;
+
+// Infinite loop, ends when script is cancelled
+while(1)
+{
+    var buffer = new upmMQ9.uint16Array(128);
+    var len = myMQ9.getSampledWindow(2, 128, buffer);
+    if (len)
+    {
+        var thresh = myMQ9.findThreshold(threshContext, 30, buffer, len);
+        myMQ9.printGraph(threshContext, 5);
+        //if (thresh)
+        //    console.log("Threshold is " + thresh);
+    }
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gp2y0a21yk.js

@@ -0,0 +1,56 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+// JavaScript file for GP2Y0A21YK 80cm IR Proximity Sensor
+
+// analog voltage, usually 3.3 or 5.0
+var GP2Y0A21YK_AREF = 5.0;
+var SAMPLES_PER_QUERY = 20;
+
+var IRProximity = require('jsupm_gp2y0a21yk');
+
+// Note, for the Grove version of this sensor, due to the way it is wired,
+// you need to plug this into the A0 port, where it will use the available
+// A1 pin for data.
+// Instantiate a GP2Y0A21YK on analog pin A1
+var myVolts = new IRProximity.GP2Y0A21YK(1);
+
+// The higher the voltage (closer to AREF) the closer the object is.
+// NOTE: The measured voltage will probably not exceed 3.3 volts.
+// Every second, print the averaged voltage value (averaged over 20 samples).
+setInterval(function()
+{
+	console.log("AREF: " + GP2Y0A21YK_AREF + 
+                ", Voltage value (higher means closer): " + 
+                myVolts.value(GP2Y0A21YK_AREF, SAMPLES_PER_QUERY));
+}, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/grove_mcfled.js

@@ -0,0 +1,46 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*
+* Author: Zion Orent <zorent@ics.com>
+* Copyright (c) 2015 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 upmled = require("jsupm_grove");
+// Initialize on GPIO 2
+var myled = new upmled.GroveLed(2);
+myled.on();
+
+// Dummy setInterval, just to keep program from quitting
+// This way, the LED turns off when you quit the program
+var myInterval = setInterval(function()
+{
+	;
+}, 1000);
+
+// When exiting: turn off LED, clear interval, and print message
+process.on('SIGINT', function()
+{
+	clearInterval(myInterval);
+	myled.off();
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/grovebutton.js

@@ -0,0 +1,35 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@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.
+ */
+
+// Load Grove module
+var groveSensor = require('jsupm_grove');
+
+// Create the button object using GPIO pin 0
+var button = new groveSensor.GroveButton(0);
+
+// Read the input and print, waiting one second between readings
+function readButtonValue() {
+    console.log(button.name() + " value is " + button.value());
+}
+setInterval(readButtonValue, 1000);

examples/javascript/groveehr.js

@@ -0,0 +1,60 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+// Load heart rate sensor module
+var heartRateSensor = require('jsupm_groveehr');
+// Instantiate a Grove Ear-clip Heart Rate sensor on digital pin D2
+var myHeartRateSensor = new heartRateSensor.GroveEHR(2);
+
+// set the beat counter to 0, init the clock and start counting beats
+myHeartRateSensor.clearBeatCounter();
+myHeartRateSensor.initClock();
+myHeartRateSensor.startBeatCounter();
+
+setInterval(readHeartRate, 1000);
+
+function readHeartRate()
+{
+	// we grab these just for display purposes in this example
+	var millis = myHeartRateSensor.getMillis();
+	var beats = myHeartRateSensor.beatCounter();
+
+	// heartRate() requires that at least 5 seconds pass before
+	// returning anything other than 0
+	var hr = myHeartRateSensor.heartRate();
+
+	// output milliseconds passed, beat count, and computed heart rate
+	console.log("Millis: " + millis + " Beats: " + beats +
+	            " Heart Rate: " + hr);
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/groveled.js

@@ -0,0 +1,46 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@intel.com>
+ * Copyright (c) 2015 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.
+ */
+
+// Load Grove module
+var groveSensor = require('jsupm_grove');
+
+// Create the Grove LED object using GPIO pin 2
+var led = new groveSensor.GroveLed(2);
+
+// Print the name
+console.log(led.name());
+
+// Turn the LED on and off 10 times, pausing one second
+// between transitions
+var i = 0;
+var waiting = setInterval(function() {
+        if ( i % 2 == 0 ) {
+            led.on();
+        } else {
+            led.off();
+        }
+        i++;
+        if ( i == 20 ) clearInterval(waiting);
+        }, 1000);
+            

examples/javascript/grovelight.js

@@ -0,0 +1,37 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@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.
+ */
+
+// Load Grove module
+var groveSensor = require('jsupm_grove');
+
+// Create the light sensor object using AIO pin 0
+var light = new groveSensor.GroveLight(0);
+
+// Read the input and print both the raw value and a rough lux value,
+// waiting one second between readings
+function readLightSensorValue() {
+    console.log(light.name() + " raw value is " + light.raw_value() +
+            ", which is roughly " + light.value() + " lux");
+}
+setInterval(readLightSensorValue, 1000);

examples/javascript/grovelinefinder.js

@@ -0,0 +1,47 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 lineFinderSensor = require('jsupm_grovelinefinder');
+
+// Instantiate a Grove line finder sensor on digital pin D2
+var myLineFinderSensor = new lineFinderSensor.GroveLineFinder(2);
+
+// Check every second for the presence of white detection
+setInterval(function()
+{
+	if (myLineFinderSensor.whiteDetected())
+		console.log("White detected.");
+	else
+		console.log("Black detected.");
+}, 1000);
+
+// Turn relay off when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/groveloudness.js

@@ -0,0 +1,43 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 loudnessSensor = require('jsupm_groveloudness');
+// Instantiate a Grove Loudness sensor on analog pin A0
+var myLoudnessSensor = new loudnessSensor.GroveLoudness(0);
+
+// Print the loudness value every 0.1 seconds
+setInterval(function()
+{
+	console.log("Loudness value (higher is louder): " + myLoudnessSensor.value());
+}, 100);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/grovemoisture.js

@@ -0,0 +1,57 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+//Load Grove Moisture module
+var grove_moisture = require('jsupm_grovemoisture');
+
+// Instantiate a Grove Moisture sensor on analog pin A0
+var myMoistureObj = new grove_moisture.GroveMoisture(0);
+
+// Values (approximate):
+// 0-300,   sensor in air or dry soil
+// 300-600, sensor in humid soil
+// 600+,    sensor in wet soil or submerged in water
+// Read the value every second and print the corresponding moisture level
+setInterval(function()
+{
+	var result;
+	var moisture_val = parseInt(myMoistureObj.value());
+	if (moisture_val >= 0 && moisture_val < 300)
+		result = "Dry";
+	else if (moisture_val >= 300 && moisture_val < 600)
+		result = "Moist";
+	else
+		result = "Wet";
+	console.log("Moisture value: " + moisture_val + ", " + result);
+}, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/groverelay.js

@@ -0,0 +1,49 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@intel.com>
+ * Copyright (c) 2015 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.
+ */
+
+// Load Grove module
+var groveSensor = require('jsupm_grove');
+
+// Create the relay switch object using GPIO pin 0
+var relay = new groveSensor.GroveRelay(0);
+
+// Close and then open the relay switch 3 times,
+// waiting one second each time.  The LED on the relay switch
+// will light up when the switch is on (closed).
+// The switch will also make a noise between transitions.
+var i = 0;
+var waiting = setInterval(function() {
+        if ( i % 2 == 0 ) {
+            relay.on();
+            if ( relay.isOn() )
+                console.log(relay.name() + " is on");
+        } else {
+            relay.off();
+            if ( relay.isOff() )
+                console.log(relay.name() + " is off");
+        }
+        i++;
+        if ( i == 6) clearInterval(waiting);
+        }, 1000);
+

examples/javascript/groverotary.js

@@ -0,0 +1,49 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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.
+ */
+
+//setup/Initialization
+var upm_grove = require('jsupm_grove');
+
+//setup access analog input Analog pin #0 (A0)
+var groveRotary = new upm_grove.GroveRotary(0);
+
+loop();
+
+function loop()
+{
+    var abs = groveRotary.abs_value();
+    var absdeg = groveRotary.abs_deg();
+    var absrad = groveRotary.abs_rad();
+
+    var rel = groveRotary.rel_value();
+    var reldeg = groveRotary.rel_deg();
+    var relrad = groveRotary.rel_rad();
+
+    //write the knob value to the console in different formats
+    console.log("Abs: " + abs + " " + Math.round(parseInt(absdeg)) + " " + absrad.toFixed(3));
+    console.log("Rel: " + rel + " " + Math.round(parseInt(reldeg)) + " " + relrad.toFixed(3));
+
+    //wait 2 s and call function again
+    setTimeout(loop, 2000);
+}

examples/javascript/groveslide.js

@@ -0,0 +1,42 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.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 upm_grove = require('jsupm_grove');
+
+//setup access analog input Analog pin #0 (A0)
+var groveSlide = new upm_grove.GroveSlide(0);
+
+loop();
+
+function loop()
+{
+    var raw = groveSlide.raw_value();
+    var volts = groveSlide.voltage_value();
+
+    //write the slider values to the console
+    console.log("Slider Value: " + raw + " = " + volts.toFixed(2) + " V");
+
+    //wait 2 s then call function again
+    setTimeout(loop, 2000);
+}

examples/javascript/grovespeaker.js

@@ -0,0 +1,44 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+//Load Grove Speaker module
+var groveSpeaker = require('jsupm_grovespeaker');
+// Instantiate a Grove Speaker on digital pin D2
+var mySpeaker = new groveSpeaker.GroveSpeaker(2);
+
+// Play all 7 of the lowest notes
+mySpeaker.playAll();
+
+// Play a medium C-sharp
+mySpeaker.playSound('c', true, "med");
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/grovetemp.js

@@ -0,0 +1,42 @@
+/*
+ * Author: Sarah Knepper <sarah.knepper@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.
+ */
+
+// Load Grove module
+var groveSensor = require('jsupm_grove');
+
+// Create the temperature sensor object using AIO pin 0
+var temp = new groveSensor.GroveTemp(0);
+console.log(temp.name());
+
+// Read the temperature ten times, printing both the Celsius and
+// equivalent Fahrenheit temperature, waiting one second between readings
+var i = 0;
+var waiting = setInterval(function() {
+        var celsius = temp.value();
+        var fahrenheit = celsius * 9.0/5.0 + 32.0;
+        console.log(celsius + " degrees Celsius, or " +
+            Math.round(fahrenheit) + " degrees Fahrenheit");
+        i++;
+        if (i == 10) clearInterval(waiting);
+        }, 1000);

examples/javascript/grovevdiv.js

@@ -0,0 +1,50 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 voltageDivider = require('jsupm_grovevdiv');
+// Instantiate a Grove Voltage Divider sensor on analog pin A0
+var myVoltageDivider = new voltageDivider.GroveVDiv(0);
+
+// collect data and output measured voltage according to the setting
+// of the scaling switch (3 or 10)
+function getVoltageInfo()
+{
+	var val = myVoltageDivider.value(100);
+	var gain3val = myVoltageDivider.computedValue(3, val);
+	var gain10val = myVoltageDivider.computedValue(10, val);
+	console.log("ADC value: " + val + " Gain 3: " + gain3val 
+				+ "v Gain 10: " + gain10val + "v");
+}
+
+setInterval(getVoltageInfo, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/grovewater.js

@@ -0,0 +1,49 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+ * Author: Zion Orent <zorent@ics.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.
+ */
+
+// Load Grove module
+var waterSensor = require('jsupm_grovewater');
+
+// Instantiate a Grove Water sensor on digital pin D2
+var water = new waterSensor.GroveWater(2);
+
+// Read whether the sensor is wet/dry, waiting one second between readings
+function readWaterState()
+{
+	if (water.isWet())
+		console.log("Sensor is wet");
+	else
+		console.log("Sensor is dry");
+}
+setInterval(readWaterState, 1000);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/guvas12d.js

@@ -0,0 +1,56 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 UVSensor = require('jsupm_guvas12d');
+
+// Instantiate a UV sensor on analog pin A0
+var myUVSensor = new UVSensor.GUVAS12D(0);
+
+// analog voltage, usually 3.3 or 5.0
+var g_GUVAS12D_AREF = 5.0;
+var g_SAMPLES_PER_QUERY = 1024;
+
+setInterval(function()
+{
+	var outputStr = "AREF: " + g_GUVAS12D_AREF 
+					+ ", Voltage value (higher means more UV): "
+					+ roundNum(myUVSensor.value(g_GUVAS12D_AREF, g_SAMPLES_PER_QUERY), 6);
+	console.log(outputStr);
+}, 1000);
+
+function roundNum(num, decimalPlaces)
+{
+	var extraNum = (1 / (Math.pow(10, decimalPlaces) * 1000));
+	return (Math.round((num + extraNum) * (Math.pow(10, decimalPlaces))) / Math.pow(10, decimalPlaces));
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/gy65.js

@@ -0,0 +1,55 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+//Load Barometer module
+var gy65 = require('jsupm_gy65');
+// load this on i2c
+var myBarometerObj = new gy65.GY65(0, gy65.ADDR);
+var pressure, temperature, altitude, sealevel;
+
+// Print the pressure, altitude, sea level, and
+// temperature values every 0.1 seconds
+setInterval(function()
+{
+	var pressure = myBarometerObj.getPressure();
+	var temperature = myBarometerObj.getTemperature();
+	var altitude = myBarometerObj.getAltitude();
+	var sealevel = myBarometerObj.getSealevelPressure();
+
+	var GY65results = "pressure value = " + pressure;
+	GY65results += ", altitude value = " + altitude;
+	GY65results += ", sealevel value = " + sealevel;
+	GY65results += ", temperature = " + temperature;
+	console.log(GY65results);
+}, 100);
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/hmc5883l.js

@@ -0,0 +1,61 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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.
+*/
+
+// Load Compass module
+var hmc5883l = require('jsupm_hmc5883l');
+// load this on i2c
+var myCompass = new hmc5883l.Hmc5883l(0);
+// Set your declination from true north in radians
+myCompass.set_declination(0.2749);
+
+var coordsObj;
+// Print out the coordinates, heading, and direction every second
+setInterval(function()
+{
+	myCompass.update(); // Update the coordinates
+	coordsObj = myCompass.coordinates();
+	var coords = (coordsObj.getitem(0) + " ");
+	coords += (coordsObj.getitem(1) + " ");
+	coords += coordsObj.getitem(2);
+	var heading = round2Digits(myCompass.heading());
+	var direction = round2Digits(myCompass.direction());
+	var compassResults = "coords: " + coords + 
+		"    heading: " + heading + " direction " + direction;
+	console.log(compassResults);
+}, 1000);
+
+function round2Digits(num)
+{
+	return Math.round((num  + 0.00001) * 100) / 100;
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});

examples/javascript/itg3200.js

@@ -0,0 +1,64 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Sarah Knepper <sarah.knepper@intel.com>
+* Copyright (c) 2015 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.
+*/
+
+// Load gyroscope module
+var itg3200 = require('jsupm_itg3200');
+// load this on i2c
+var gyro = new itg3200.Itg3200(0);
+
+var rot;
+var ang;
+
+// Note: Sensor not supported on Intel Edison with Arduino breakout
+setInterval(function()
+{
+    gyro.update(); // Update the data
+    rot = gyro.getRawValues(); // Read raw sensor data
+    ang = gyro.getRotation(); // Read rotational speed (deg/sec)
+    var rots = (rot.getitem(0) + " ");
+    rots += (rot.getitem(1) + " ");
+    rots += rot.getitem(2);
+    var temp = round2Digits(gyro.getTemperature());
+    var raw = round2Digits(gyro.getRawTemp());
+    console.log("Raw: " + rots);
+    console.log("AngX: " + round2Digits(ang.getitem(0)));
+    console.log("AngY: " + round2Digits(ang.getitem(1)));
+    console.log("AngZ: " + round2Digits(ang.getitem(2)));
+    console.log("Temp: " + temp + " Raw: " + raw);
+}, 1000);
+
+function round2Digits(num)
+{
+    return Math.round((num + 0.00001) * 100) / 100;
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+    console.log("Exiting...");
+    process.exit(0);
+});

examples/javascript/joystick12.js

@@ -0,0 +1,54 @@
+/*jslint node:true, vars:true, bitwise:true, unparam:true */
+/*jshint unused:true */
+/*global */
+/*
+* Author: Zion Orent <zorent@ics.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 joystick = require('jsupm_joystick12');
+
+// Instantiate a joystick on analog pins A0 and A1
+var myJoystick = new joystick.Joystick12(0, 1);
+
+// Print the X and Y input values every second
+setInterval(function()
+{
+	var XString = "Driving X:" + roundNum(myJoystick.getXInput(), 6);
+	var YString = ": and Y:" + roundNum(myJoystick.getYInput(), 6);
+	console.log(XString + YString);
+}, 1000);
+
+function roundNum(num, decimalPlaces)
+{
+	var extraNum = (1 / (Math.pow(10, decimalPlaces) * 1000));
+	var numerator = Math.round((num + extraNum) * (Math.pow(10, decimalPlaces)));
+	var denominator = Math.pow(10, decimalPlaces);
+	return (numerator / denominator);
+}
+
+// Print message when exiting
+process.on('SIGINT', function()
+{
+	console.log("Exiting...");
+	process.exit(0);
+});