/*
* 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.
*/
#pragma once
#include <string>
#include <math.h>
#include <mraa/aio.h>
#include <mraa/gpio.h>
namespace upm {
#define NUMBER_OF_SAMPLES 500
#define ADC_RESOLUTION 1024
#define SUPPLYVOLTAGE 5100
#define CURRENT_RATIO 2000.0
#define HIGH 1
#define LOW 0
#define TRUE HIGH
#define FALSE LOW
/**
* @brief ECS1030 Electricity Sensor library
* @defgroup ecs1030 libupm-ecs1030
* @ingroup sparkfun analog electric
*/
/**
* @library ecs1030
* @sensor ecs1030
* @comname ECS1030 Non-Invasive Current Sensor
* @type electric
* @man sparkfun
* @web https://www.sparkfun.com/products/11005
* @con analog
*
* @brief API for the ECS1030 Non-Invasive Current/Electricity Sensor
*
* This non-invasive current sensor can be clamped around the supply line of
* an electrical load to tell you how much current is passing through it. It
* does this by acting as an inductor and responding to the magnetic field
* around a current-carrying conductor. This particular current sensor
* measures a load up to 30 A, which makes it great for building your own
* energy monitors.
*
* @image html ecs1030.jpg
* <br><em>ECS1030 Sensor image provided by SparkFun* under
* <a href=https://creativecommons.org/licenses/by-nc-sa/3.0/>
* CC BY-NC-SA-3.0</a>.</em>
*
* @snippet ecs1030.cxx Interesting
*/
class ECS1030 {
public:
static const uint8_t DELAY_MS = 20000 / NUMBER_OF_SAMPLES; /* 1/50Hz is 20ms period */
static const uint8_t VOLT_M = 5.1 / 1023;
static const uint8_t R_LOAD = 2000.0 / CURRENT_RATIO;
/**
* Instantiates an ECS1030 object
*
* @param pinNumber Number of the data pin
*/
ECS1030 (uint8_t pinNumber);
/**
* ECS1030 object destructor; basically, it closes the GPIO.
*/
~ECS1030 ();
/**
* Returns electric current data for a sampled period
*/
double getCurrency_A ();
/**
* Returns power data for a sampled period
*/
double getPower_A ();
/**
* Returns electric current data for a sampled period
*/
double getCurrency_B ();
/**
* Returns power data for a sampled period
*/
double getPower_B ();
/**
* Returns the name of the component
*/
std::string name() {
return m_name;
}
private:
std::string m_name;
mraa_aio_context m_dataPinCtx;
double m_calibration;
int m_lastSample;
double m_lastFilter;
int m_sample;
double m_filteredSample;
};
}