From 2bffccf8393ca27095b9f0c7565a116b33073eb3 Mon Sep 17 00:00:00 2001 From: Zion Orent Date: Thu, 26 Feb 2015 09:14:41 -0500 Subject: [PATCH] groveemg: initial implementation The implements support for the Grove EMG detector. Signed-off-by: Zion Orent Signed-off-by: Jon Trulson Signed-off-by: John Van Drasek --- examples/c++/CMakeLists.txt | 3 ++ examples/c++/groveemg.cxx | 60 +++++++++++++++++++++++++++ examples/javascript/groveemg.js | 48 ++++++++++++++++++++++ src/groveemg/CMakeLists.txt | 5 +++ src/groveemg/groveemg.cxx | 64 +++++++++++++++++++++++++++++ src/groveemg/groveemg.h | 73 +++++++++++++++++++++++++++++++++ src/groveemg/jsupm_groveemg.i | 8 ++++ src/groveemg/pyupm_groveemg.i | 9 ++++ 8 files changed, 270 insertions(+) create mode 100644 examples/c++/groveemg.cxx create mode 100644 examples/javascript/groveemg.js create mode 100644 src/groveemg/CMakeLists.txt create mode 100644 src/groveemg/groveemg.cxx create mode 100644 src/groveemg/groveemg.h create mode 100644 src/groveemg/jsupm_groveemg.i create mode 100644 src/groveemg/pyupm_groveemg.i diff --git a/examples/c++/CMakeLists.txt b/examples/c++/CMakeLists.txt index 0bb94cc7..e8e82503 100644 --- a/examples/c++/CMakeLists.txt +++ b/examples/c++/CMakeLists.txt @@ -90,6 +90,7 @@ add_executable (nunchuck-example nunchuck.cxx) add_executable (otp538u-example otp538u.cxx) add_executable (grovecollision-example grovecollision.cxx) add_executable (groveelectromagnet-example groveelectromagnet.cxx) +add_executable (groveemg-example groveemg.cxx) include_directories (${PROJECT_SOURCE_DIR}/src/hmc5883l) include_directories (${PROJECT_SOURCE_DIR}/src/grove) @@ -162,6 +163,7 @@ include_directories (${PROJECT_SOURCE_DIR}/src/nunchuck) include_directories (${PROJECT_SOURCE_DIR}/src/otp538u) include_directories (${PROJECT_SOURCE_DIR}/src/grovecollision) include_directories (${PROJECT_SOURCE_DIR}/src/groveelectromagnet) +include_directories (${PROJECT_SOURCE_DIR}/src/groveemg) target_link_libraries (hmc5883l-example hmc5883l ${CMAKE_THREAD_LIBS_INIT}) target_link_libraries (groveled-example grove ${CMAKE_THREAD_LIBS_INIT}) @@ -253,3 +255,4 @@ target_link_libraries (nunchuck-example nunchuck ${CMAKE_THREAD_LIBS_INIT}) target_link_libraries (otp538u-example otp538u ${CMAKE_THREAD_LIBS_INIT}) target_link_libraries (grovecollision-example grovecollision ${CMAKE_THREAD_LIBS_INIT}) target_link_libraries (groveelectromagnet-example groveelectromagnet ${CMAKE_THREAD_LIBS_INIT}) +target_link_libraries (groveemg-example groveemg ${CMAKE_THREAD_LIBS_INIT}) diff --git a/examples/c++/groveemg.cxx b/examples/c++/groveemg.cxx new file mode 100644 index 00000000..d06295a9 --- /dev/null +++ b/examples/c++/groveemg.cxx @@ -0,0 +1,60 @@ +/* +* Author: Zion Orent +* 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 +#include +#include +#include "groveemg.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] + // The was tested with the GroveEMG Muscle Signal Reader Sensor Module + // Instantiate a GroveEMG on analog pin A0 + upm::GroveEMG *emg = new upm::GroveEMG(0); + cout << "Calibrating...." << endl; + emg->calibrate(); + + while (shouldRun) + { + cout << emg->value() << endl; + usleep(100000); + } + +//! [Interesting] + cout << "Exiting" << endl; + delete emg; + return 0; +} diff --git a/examples/javascript/groveemg.js b/examples/javascript/groveemg.js new file mode 100644 index 00000000..8eee4de9 --- /dev/null +++ b/examples/javascript/groveemg.js @@ -0,0 +1,48 @@ +/*jslint node:true, vars:true, bitwise:true, unparam:true */ +/*jshint unused:true */ +/* +* Author: Zion Orent +* 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 groveemg_lib = require("jsupm_groveemg"); + +// The was tested with the GroveEMG Muscle Signal Reader Sensor Module +// Instantiate a GroveEMG on analog pin A0 +var groveemg_obj = new groveemg_lib.GroveEMG(0); +console.log("Calibrating...."); +groveemg_obj.calibrate(); + +var myInterval = setInterval(function() +{ + console.log(groveemg_obj.value()); +}, 100); + +// When exiting: clear interval, and print message +process.on('SIGINT', function() +{ + clearInterval(myInterval); + groveemg_obj = null; + groveemg_lib.cleanUp(); + groveemg_lib = null; + console.log("Exiting..."); + process.exit(0); +}); diff --git a/src/groveemg/CMakeLists.txt b/src/groveemg/CMakeLists.txt new file mode 100644 index 00000000..7e2388db --- /dev/null +++ b/src/groveemg/CMakeLists.txt @@ -0,0 +1,5 @@ +set (libname "groveemg") +set (libdescription "upm groveemg muscle signal reader sensor module") +set (module_src ${libname}.cxx) +set (module_h ${libname}.h) +upm_module_init() diff --git a/src/groveemg/groveemg.cxx b/src/groveemg/groveemg.cxx new file mode 100644 index 00000000..7715efe0 --- /dev/null +++ b/src/groveemg/groveemg.cxx @@ -0,0 +1,64 @@ +/* + * Author: Zion Orent + * 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 + +#include "groveemg.h" + +using namespace upm; +using namespace std; + +GroveEMG::GroveEMG(int pin) +{ + if ( !(m_aio = mraa_aio_init(pin)) ) + { + cerr << __FUNCTION__ << ": mraa_aio_init() failed" << endl; + return; + } +} + +GroveEMG::~GroveEMG() +{ + mraa_aio_close(m_aio); +} + +void GroveEMG::calibrate() +{ + int val, sum = 0; + + for (int i=0; i<1100; i++) + { + val = mraa_aio_read(m_aio); + sum += val; + usleep(1000); + } + sum /= 1100; + cout << "Static analog data = " << sum << endl; +} + +int GroveEMG::value() +{ + int val = mraa_aio_read(m_aio); + return val; +} diff --git a/src/groveemg/groveemg.h b/src/groveemg/groveemg.h new file mode 100644 index 00000000..60da3432 --- /dev/null +++ b/src/groveemg/groveemg.h @@ -0,0 +1,73 @@ +/* + * Author: Zion Orent + * 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. + */ +#pragma once + +#include +#include + +namespace upm { + /** + * @brief UPM module for the GroveEMG Muscle Signal reader Sensor + * @defgroup groveemg libupm-groveemg + */ + /** + * @brief C++ API for the GroveEMG Muscle Signal reader Sensor + * + * GroveEMG Muscle Signal reader gathers small muscle signals, + * then processes and returns the result + * + * @ingroup analog groveemg + * @snippet groveemg.cxx Interesting + */ + class GroveEMG { + public: + /** + * GroveEMG sensor constructor + * + * @param pin analog pin to use + */ + GroveEMG(int pin); + /** + * GroveEMG Destructor + */ + ~GroveEMG(); + + /** + * Calibrate the GroveEMG Sensor + */ + void calibrate(); + + /** + * Measure the muscle signals from the sensor + * + * @return the muscle output as analog voltage + */ + int value(); + + private: + mraa_aio_context m_aio; + }; +} + + diff --git a/src/groveemg/jsupm_groveemg.i b/src/groveemg/jsupm_groveemg.i new file mode 100644 index 00000000..7cac0459 --- /dev/null +++ b/src/groveemg/jsupm_groveemg.i @@ -0,0 +1,8 @@ +%module jsupm_groveemg +%include "../upm.i" + +%{ + #include "groveemg.h" +%} + +%include "groveemg.h" diff --git a/src/groveemg/pyupm_groveemg.i b/src/groveemg/pyupm_groveemg.i new file mode 100644 index 00000000..12a07656 --- /dev/null +++ b/src/groveemg/pyupm_groveemg.i @@ -0,0 +1,9 @@ +%module pyupm_groveemg +%include "../upm.i" + +%feature("autodoc", "3"); + +%include "groveemg.h" +%{ + #include "groveemg.h" +%}