From df302ff5db962d8be94acbc6371b3999f331b053 Mon Sep 17 00:00:00 2001
From: Rafael Neri <rafael.neri@gmail.com>
Date: Sat, 21 Mar 2015 15:52:03 -0300
Subject: [PATCH] hx711: Initial implementation HX711 24bit ADC module

Signed-off-by: Rafael Neri <rafael.neri@gmail.com>
Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
---
 docs/images/hx711.jpeg       | Bin 0 -> 42639 bytes
 examples/c++/CMakeLists.txt  |   4 +-
 examples/c++/hx711.cxx       |  43 ++++++++++
 examples/javascript/hx711.js |  36 +++++++++
 src/hx711/CMakeLists.txt     |   5 ++
 src/hx711/hx711.cxx          | 148 +++++++++++++++++++++++++++++++++++
 src/hx711/hx711.h            | 135 ++++++++++++++++++++++++++++++++
 src/hx711/jsupm_hx711.i      |  10 +++
 src/hx711/pyupm_hx711.i      |  10 +++
 9 files changed, 390 insertions(+), 1 deletion(-)
 create mode 100644 docs/images/hx711.jpeg
 create mode 100644 examples/c++/hx711.cxx
 create mode 100644 examples/javascript/hx711.js
 create mode 100644 src/hx711/CMakeLists.txt
 create mode 100644 src/hx711/hx711.cxx
 create mode 100644 src/hx711/hx711.h
 create mode 100644 src/hx711/jsupm_hx711.i
 create mode 100644 src/hx711/pyupm_hx711.i

diff --git a/docs/images/hx711.jpeg b/docs/images/hx711.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..feff7840b9e34011ba70152dbd21c8e796781e81
GIT binary patch
literal 42639
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

literal 0
HcmV?d00001

diff --git a/examples/c++/CMakeLists.txt b/examples/c++/CMakeLists.txt
index 53fc1291..0f18545d 100644
--- a/examples/c++/CMakeLists.txt
+++ b/examples/c++/CMakeLists.txt
@@ -103,6 +103,7 @@ add_executable (groveeldriver-example groveeldriver.cxx)
 add_executable (adafruitss-example adafruitss.cxx)
 add_executable (adafruitms1438-example adafruitms1438.cxx)
 add_executable (adafruitms1438-stepper-example adafruitms1438-stepper.cxx)
+add_executable (hx711-example hx711.cxx)
 
 include_directories (${PROJECT_SOURCE_DIR}/src/hmc5883l)
 include_directories (${PROJECT_SOURCE_DIR}/src/grove)
@@ -186,6 +187,7 @@ include_directories (${PROJECT_SOURCE_DIR}/src/pca9685)
 include_directories (${PROJECT_SOURCE_DIR}/src/groveeldriver)
 include_directories (${PROJECT_SOURCE_DIR}/src/adafruitss)
 include_directories (${PROJECT_SOURCE_DIR}/src/adafruitms1438)
+include_directories (${PROJECT_SOURCE_DIR}/src/hx711)
 
 target_link_libraries (hmc5883l-example hmc5883l ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (groveled-example grove ${CMAKE_THREAD_LIBS_INIT})
@@ -290,4 +292,4 @@ target_link_libraries (groveeldriver-example groveeldriver ${CMAKE_THREAD_LIBS_I
 target_link_libraries (adafruitss-example adafruitss ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (adafruitms1438-example adafruitms1438 ${CMAKE_THREAD_LIBS_INIT})
 target_link_libraries (adafruitms1438-stepper-example adafruitms1438 ${CMAKE_THREAD_LIBS_INIT})
-
+target_link_libraries (hx711-example hx711 ${CMAKE_THREAD_LIBS_INIT})
diff --git a/examples/c++/hx711.cxx b/examples/c++/hx711.cxx
new file mode 100644
index 00000000..531734b2
--- /dev/null
+++ b/examples/c++/hx711.cxx
@@ -0,0 +1,43 @@
+/*
+*
+* Author: Rafael da Mata Neri <rafael.neri@gmail.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 <signal.h>
+
+//! [Interesting]
+#include "hx711.h"
+
+int
+main(int argc, char **argv)
+{
+    upm::HX711 *scale = new upm::HX711(3, 2);
+
+    // 2837: value obtained via calibration
+    scale->setScale(2837);
+    scale->tare();
+    std::cout << scale->getUnits() << std::endl;
+
+    return 0;
+}
+//! [Interesting]
diff --git a/examples/javascript/hx711.js b/examples/javascript/hx711.js
new file mode 100644
index 00000000..8393734c
--- /dev/null
+++ b/examples/javascript/hx711.js
@@ -0,0 +1,36 @@
+/*
+*
+* Author: Rafael da Mata Neri <rafael.neri@gmail.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 hx711 = require('jsupm_hx711');
+// Instantiate a HX711 data on digital pin D3 and clock on digital pin D2
+var scale = new hx711.HX711(3, 2);
+
+setTimeout(function(){
+	// 2837: value obtained via calibration
+	scale.setScale(2837);
+	scale.tare(2);
+	setInterval(function(){
+		console.log(scale.getUnits());
+	}, 1000);
+}, 1000);
diff --git a/src/hx711/CMakeLists.txt b/src/hx711/CMakeLists.txt
new file mode 100644
index 00000000..8cdf95e7
--- /dev/null
+++ b/src/hx711/CMakeLists.txt
@@ -0,0 +1,5 @@
+set (libname "hx711")
+set (libdescription "HX711 24bit ADC")
+set (module_src ${libname}.cxx)
+set (module_h ${libname}.h)
+upm_module_init()
diff --git a/src/hx711/hx711.cxx b/src/hx711/hx711.cxx
new file mode 100644
index 00000000..01fb7893
--- /dev/null
+++ b/src/hx711/hx711.cxx
@@ -0,0 +1,148 @@
+/*
+*
+* Author: Rafael da Mata Neri <rafael.neri@gmail.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 <iostream>
+#include <fstream>
+#include <unistd.h>
+#include <stdlib.h>
+#include <string.h>
+#include "hx711.h"
+
+using namespace upm;
+using namespace std;
+
+struct HX711Exception : public std::exception {
+    std::string message;
+    HX711Exception (std::string msg) : message (msg) { }
+    ~HX711Exception () throw () { }
+    const char* what() const throw () { return message.c_str(); }
+};
+
+HX711::HX711(uint8_t data, uint8_t sck, uint8_t gain) {
+    mraa_result_t error = MRAA_SUCCESS;
+    
+    this->m_dataPinCtx = mraa_gpio_init(data);
+    if (this->m_dataPinCtx == NULL) {
+        throw HX711Exception ("Couldn't initilize DATA pin.");
+    }
+    
+    this->m_sckPinCtx = mraa_gpio_init(sck);
+    if (this->m_sckPinCtx == NULL) {
+        throw HX711Exception ("Couldn't initilize CLOCK pin.");
+    }
+    
+    error = mraa_gpio_dir (this->m_dataPinCtx, MRAA_GPIO_IN);
+    if (error != MRAA_SUCCESS) {
+        throw HX711Exception ("Couldn't set direction for DATA pin.");
+    }
+    
+    error = mraa_gpio_dir (this->m_sckPinCtx, MRAA_GPIO_OUT);
+    if (error != MRAA_SUCCESS) {
+        throw HX711Exception ("Couldn't set direction for CLOCK pin.");
+    }
+
+    this->setGain(gain);
+}
+
+HX711::~HX711() {
+    mraa_result_t error = MRAA_SUCCESS;
+    
+    error = mraa_gpio_close (this->m_dataPinCtx);
+    if (error != MRAA_SUCCESS) {
+        mraa_result_print(error);
+    }
+    
+    error = mraa_gpio_close (this->m_sckPinCtx);
+    if (error != MRAA_SUCCESS) {
+        mraa_result_print(error);
+    }
+}
+
+unsigned long HX711::read() {
+    unsigned long Count = 0;
+    
+    while (mraa_gpio_read(this->m_dataPinCtx));
+                                  
+    for (int i=0; i<GAIN; i++)
+    {
+        mraa_gpio_write(this->m_sckPinCtx, 1);
+        Count = Count << 1;
+        mraa_gpio_write(this->m_sckPinCtx, 0);
+        if(mraa_gpio_read(this->m_dataPinCtx))
+        {
+            Count++;
+        }
+    }
+
+    mraa_gpio_write(this->m_sckPinCtx, 1);
+    Count = Count ^ 0x800000;
+    mraa_gpio_write(this->m_sckPinCtx, 0);
+
+    return (Count);
+}
+
+void HX711::setGain(uint8_t gain){
+    switch (gain) {
+        case 128:       // channel A, gain factor 128
+            GAIN = 24;
+            break;
+        case 64:        // channel A, gain factor 64
+            GAIN = 26;
+            break;
+        case 32:        // channel B, gain factor 32
+            GAIN = 25;
+            break;
+    }
+
+    mraa_gpio_write(this->m_sckPinCtx, 0);
+    read();
+}
+
+unsigned long HX711::readAverage(uint8_t times){
+    unsigned long sum = 0;
+    for (uint8_t i = 0; i < times; i++) {
+        sum += read();
+    }
+    return sum / times;
+}
+
+double HX711::getValue(uint8_t times){
+    return readAverage(times) - OFFSET;
+}
+
+float HX711::getUnits(uint8_t times){
+    return getValue(times) / SCALE;
+}
+
+void HX711::tare(uint8_t times){
+    double sum = readAverage(times);
+    setOffset(sum);
+}
+
+void HX711::setScale(float scale){
+    SCALE = scale;
+}
+
+void HX711::setOffset(long offset){
+    OFFSET = offset;
+}
diff --git a/src/hx711/hx711.h b/src/hx711/hx711.h
new file mode 100644
index 00000000..e061b073
--- /dev/null
+++ b/src/hx711/hx711.h
@@ -0,0 +1,135 @@
+/*
+*
+* Author: Rafael da Mata Neri <rafael.neri@gmail.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.
+*/
+#pragma once
+
+
+#include <unistd.h>
+#include <stdlib.h>
+#include <stdint.h>
+#include <string.h>
+#include <mraa/gpio.h>
+
+namespace upm {
+
+     /**
+      * @brief HX711 24bit ADC library
+      * @defgroup hx711 libupm-hx711
+      */
+
+     /**
+      * @brief C++ API for HX711
+      *
+      * [HX711](http://www.dfrobot.com/image/data/SEN0160/hx711_english.pdf) is 
+      * a precision 24-bit analog- to-digital converter (ADC) designed for weigh
+      * scales and industrial control applications to interface directly with a 
+      * bridge sensor. This module was tested on the Intel Galileo Gen2.
+      *
+      * @ingroup hx711 hx711
+      * @snippet hx711.cxx Interesting
+      * @image html hx711.jpeg
+      */
+      class HX711 {
+      public:
+            /**
+            * HX711 module constructor
+            *
+            * @param data define the data pin
+            * @param sck define the clock pin
+            * @param gain define the gain factor
+            * Valid values are 128 or 64 for channel A; channel B works with 32 gain factor only
+            */
+            HX711(uint8_t data, uint8_t sck, uint8_t gain = 128);
+
+            /**
+            * HX711 module Destructor
+            */
+            ~HX711();
+
+
+            /**
+            * Waits for the chip to be ready and returns a reading
+            *
+            * @return raw adc read
+            */
+            unsigned long read();
+
+            /**
+            * Set the gain factor; takes effect only after a call to read()
+            * channel A can be set for a 128 or 64 gain; channel B has a fixed 32 gain
+            * depending on the parameter, the channel is also set to either A or B
+            * @param gain define the gain factor
+            */
+            void setGain(uint8_t gain = 128);
+
+            /**
+            * Returns an average reading
+            * @param times define how many times to read
+            * @return the avarage reading
+            */
+            unsigned long readAverage(uint8_t times = 10);
+
+            /**
+            * Returns (readAverage() - OFFSET)
+            * @param times define how many readings to do
+            * @return the current value without the tare weight
+            */
+            double getValue(uint8_t times = 10);
+
+            /**
+            * Returns getValue() divided by SCALE
+            * @param times define how many readings to do
+            * @return the raw value divided by a value obtained via calibration
+            */
+            float getUnits(uint8_t times = 1);
+
+            /**
+            * Set the OFFSET value for tare weight
+            * @param times define how many times to read the tare value
+            */
+            void tare(uint8_t times = 10);
+
+            /**
+            * Set the SCALE value 
+            * This value is used to convert the raw data to "human readable" data (measure units)
+            * @param scale value obtained via calibration
+            */
+            void setScale(float scale = 1.f);
+       private:
+            mraa_gpio_context m_sckPinCtx; // Power Down and Serial Clock Input Pin
+            mraa_gpio_context m_dataPinCtx; // Serial Data Output Pin
+            
+            uint8_t GAIN; // amplification factor
+            unsigned long OFFSET; // used for tare weight
+            float SCALE; // used to return weight in grams, kg, ounces, whatever
+
+            
+            /**
+            * Set the OFFSET value 
+            * The value that's subtracted from the actual reading (tare weight)
+            * @param scale value obtained via calibration
+            */
+            void setOffset(long offset = 0);
+     };
+
+}
diff --git a/src/hx711/jsupm_hx711.i b/src/hx711/jsupm_hx711.i
new file mode 100644
index 00000000..ff8ec950
--- /dev/null
+++ b/src/hx711/jsupm_hx711.i
@@ -0,0 +1,10 @@
+//! [Interesting]
+%module jsupm_hx711
+%include "../upm.i"
+
+%{
+    #include "hx711.h"
+%}
+
+%include "hx711.h"
+//! [Interesting]
diff --git a/src/hx711/pyupm_hx711.i b/src/hx711/pyupm_hx711.i
new file mode 100644
index 00000000..7d8c7d7e
--- /dev/null
+++ b/src/hx711/pyupm_hx711.i
@@ -0,0 +1,10 @@
+%module pyupm_hx711
+%include "../upm.i"
+%include "stdint.i"
+
+%feature("autodoc", "3");
+
+%include "hx711.h"
+%{
+    #include "hx711.h"
+%}