mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-09-19 16:46:11 -04:00
69 lines
1.8 KiB
C++
69 lines
1.8 KiB
C++
#pragma once
|
|
//
|
|
// FILE: ACS712.h
|
|
// AUTHOR: Rob Tillaart
|
|
// VERSION: 0.2.1
|
|
// DATE: 2020-08-02
|
|
// PURPOSE: ACS712 library - current measurement
|
|
//
|
|
// Tested with a RobotDyn ACS712 20A breakout + UNO.
|
|
//
|
|
|
|
#include "Arduino.h"
|
|
|
|
#define ACS712_LIB_VERSION "0.2.1"
|
|
|
|
|
|
class ACS712
|
|
{
|
|
public:
|
|
// NOTE:
|
|
// One can quite precisely tune the value of the sensor
|
|
// (1) the milliVolt per Ampere and
|
|
// (2) the volts parameter.
|
|
//
|
|
// TYPE mV per Ampere
|
|
// 5A 185
|
|
// 20A 100
|
|
// 30A 66
|
|
ACS712(uint8_t analogPin, float volts = 5.0, uint16_t maxADC = 1023, uint8_t mVperA = 100);
|
|
|
|
// returns mA
|
|
// blocks 20-21 ms to sample a whole 50 or 60 Hz period.
|
|
int mA_AC(uint8_t freq = 50);
|
|
|
|
// returns mA
|
|
// blocks < 1 ms
|
|
int mA_DC();
|
|
|
|
// midpoint ADC for DC only
|
|
inline void setMidPoint(uint16_t mp) { _midPoint = mp; };
|
|
inline uint16_t getMidPoint() { return _midPoint; };
|
|
inline void incMidPoint() { _midPoint++; };
|
|
inline void decMidPoint() { _midPoint--; };
|
|
// Auto midPoint, assuming zero DC current or any AC current
|
|
void autoMidPoint(uint8_t freq = 50);
|
|
|
|
// also known as crest factor; affects AC only
|
|
inline void setFormFactor(float ff) { _formFactor = ff; };
|
|
inline float getFormFactor() { return _formFactor; };
|
|
|
|
// noise
|
|
inline void setNoisemV(uint8_t noisemV) { _noisemV = noisemV; };
|
|
inline uint8_t getNoisemV() { return _noisemV; };
|
|
|
|
// AC and DC
|
|
inline void setmVperAmp(uint8_t mva) { _mVperAmpere = mva; };
|
|
inline uint8_t getmVperAmp() { return _mVperAmpere; };
|
|
|
|
private:
|
|
uint8_t _pin;
|
|
float _mVpstep; // millivolt per step
|
|
float _formFactor; // point2point -> RMS
|
|
uint8_t _mVperAmpere;
|
|
uint16_t _midPoint;
|
|
uint8_t _noisemV;
|
|
};
|
|
|
|
// END OF FILE
|