Initial commit

Author: PaulZC

ISSUE_TEMPLATE.md

@@ -0,0 +1,18 @@
+### Subject of the issue
+Describe your issue here.
+
+### Your workbench
+* What platform are you using?
+* What version of the device are you using? Is there a firmware version?
+* How is the device wired to your platform?
+* How is everything being powered?
+* Are there any additional details that may help us help you?
+
+### Steps to reproduce
+Tell us how to reproduce this issue. Please post stripped down example code demonstrating your issue to a gist.
+
+### Expected behaviour
+Tell us what should happen
+
+### Actual behaviour
+Tell us what happens instead

LICENSE.md

@@ -0,0 +1,55 @@
+SparkFun License Information
+============================
+
+SparkFun uses two different licenses for our files — one for hardware and one for code.
+
+Hardware
+---------
+
+**SparkFun hardware is released under [Creative Commons Share-alike 4.0 International](http://creativecommons.org/licenses/by-sa/4.0/).**
+
+Note: This is a human-readable summary of (and not a substitute for) the [license](http://creativecommons.org/licenses/by-sa/4.0/legalcode).
+
+You are free to:
+
+Share — copy and redistribute the material in any medium or format
+Adapt — remix, transform, and build upon the material
+for any purpose, even commercially.
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+Under the following terms:
+
+Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+Notices:
+
+You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.
+No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.
+
+
+Code
+--------
+
+**SparkFun code, firmware, and software is released under the MIT License(http://opensource.org/licenses/MIT).**
+
+The MIT License (MIT)
+
+Copyright (c) 2020 SparkFun Electronics
+
+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.

README.md

@@ -0,0 +1,49 @@
+SparkFun ACS37800 Power Monitor Arduino Library
+===========================================================
+ [![SparkX ACS37800 Power Meter (Qwiic) (SPX-nnnnn)]()](https://www.sparkfun.com/products/nnnnn)
+
+[*SparkX ACS37800 Power Meter (Qwiic) (SPX-nnnnn)*](https://www.sparkfun.com/products/nnnnn)
+
+The Allegro MicroSystems ACS37800 power monitoring IC greatly simplifies the addition of power monitoring to many powered systems.
+
+Allegro’s Hall-effect-based, galvanically isolated current sensing technology achieves reinforced isolation ratings in a small PCB footprint.
+These features enable isolated current sensing without expensive Rogowski coils, oversized current transformers, isolated operational amplifiers,
+or the power loss of shunt resistors.
+
+The ACS37800 power monitoring IC offers key power measurement parameters that can easily be accessed through its digital interface. Dedicated and
+configurable I/O pins for voltage/current zero crossing, undervoltage and overvoltage reporting, and fast overcurrent fault detection are available.
+User configuration of the IC is available through on-chip EEPROM.
+
+Although the ACS37800 is available with both I<sup>2</sup>C and SPI interfaces, this library currently only supports communication over I2C.
+
+SparkFun labored with love to create this code. Feel like supporting open source hardware?
+Buy a [board](https://www.sparkfun.com/products/nnnnn) from SparkFun!
+
+Repository Contents
+-------------------
+
+* **/examples** - Example sketches for the library (.ino). Run these from the Arduino IDE.
+* **/src** - Source files for the library (.cpp, .h).
+* **keywords.txt** - Keywords from this library that will be highlighted in the Arduino IDE.
+* **library.properties** - General library properties for the Arduino package manager.
+
+Documentation
+--------------
+
+* **[Installing an Arduino Library Guide](https://learn.sparkfun.com/tutorials/installing-an-arduino-library)** - Basic information on how to install an Arduino library.
+* **[Product Repository](https://github.com/sparkfunX/Qwiic_Power_Meter-ACS37800)** - Main repository (including hardware files)
+
+Products that use this library
+--------------
+* [SPX-nnnnn](https://www.sparkfun.com/products/nnnnn)- SparkX Version
+
+License Information
+-------------------
+
+This product is _**open source**_!
+
+Please use, reuse, and modify these files as you see fit. Please maintain attribution to SparkFun Electronics and release anything derivative under the same license.
+
+Distributed as-is; no warranty is given.
+
+- Your friends at SparkFun.

examples/Example1_SetI2CAddress/Example1_SetI2CAddress.ino

@@ -0,0 +1,56 @@
+/*
+  Library for the Allegro MicroSystems ACS37800 power monitor IC
+  By: Paul Clark
+  SparkFun Electronics
+  Date: January 21st, 2021
+  License: please see LICENSE.md for details
+
+  Feel like supporting our work? Buy a board from SparkFun!
+  https://www.sparkfun.com/products/nnnnn
+*/
+
+#include "SparkFun_ACS37800_Arduino_Library.h" // Click here to get the library: http://librarymanager/All#SparkFun_ACS37800
+#include <Wire.h>
+
+#define OLD_ADDRESS 0x61 //This is the address the ACS37800 is currently using
+#define NEW_ADDRESS 0x62 //This is the address we are changing to
+
+ACS37800 mySensor; //Create an object of the ACS37800 class
+
+void setup()
+{
+  Serial.begin(115200);
+  Serial.println(F("ACS37800 Example"));
+
+  Wire.begin();
+
+  //mySensor.enableDebugging(); // Uncomment this line to print useful debug messages to Serial
+
+  //Initialize sensor
+  if (mySensor.begin(OLD_ADDRESS) == false)
+  {
+    Serial.print(F("ACS37800 not detected at 0x"));
+    Serial.print(OLD_ADDRESS);
+    Serial.println(F(". Check connections. Freezing..."));
+    while (1)
+      ; // Do nothing more
+  }
+
+  Serial.print(F("Changing the address to 0x"));
+  Serial.println(NEW_ADDRESS);
+
+  //Initialize sensor
+  if (mySensor.setI2Caddress(NEW_ADDRESS) == ACS37800_SUCCESS)
+  {
+    Serial.println(F("Address changed! Please power cycle the sensor to use the new address. Freezing..."));
+  }
+  else
+  {
+    Serial.println(F("Changing the address failed! Please try again. Freezing..."));    
+  }
+}
+
+void loop()
+{
+  //Nothing to do here
+}

keywords.txt

@@ -0,0 +1,75 @@
+#######################################
+# Syntax Coloring Map
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+ACS37800	KEYWORD1
+ACS37800ERR	KEYWORD1
+ACS37800_REGISTER_0B_t	KEYWORD1
+ACS37800_REGISTER_0C_t	KEYWORD1
+ACS37800_REGISTER_0D_t	KEYWORD1
+ACS37800_REGISTER_0E_t	KEYWORD1
+ACS37800_REGISTER_0F_t	KEYWORD1
+ACS37800_REGISTER_20_t	KEYWORD1
+ACS37800_REGISTER_21_t	KEYWORD1
+ACS37800_REGISTER_22_t	KEYWORD1
+ACS37800_REGISTER_25_t	KEYWORD1
+ACS37800_REGISTER_26_t	KEYWORD1
+ACS37800_REGISTER_27_t	KEYWORD1
+ACS37800_REGISTER_28_t	KEYWORD1
+ACS37800_REGISTER_29_t	KEYWORD1
+ACS37800_REGISTER_2A_t	KEYWORD1
+ACS37800_REGISTER_2C_t	KEYWORD1
+ACS37800_REGISTER_2D_t	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+begin	KEYWORD2
+enableDebugging	KEYWORD2
+readRegister	KEYWORD2
+writeRegister	KEYWORD2
+setI2Caddress	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+
+ACS37800_SUCCESS	LITERAL1
+ACS37800_ERR_I2C_ERROR	LITERAL1
+
+ACS37800_CRS_SNS_1X	LITERAL1
+ACS37800_CRS_SNS_2X	LITERAL1
+ACS37800_CRS_SNS_3X	LITERAL1
+ACS37800_CRS_SNS_3POINT5X	LITERAL1
+ACS37800_CRS_SNS_4X	LITERAL1
+ACS37800_CRS_SNS_4POINT5X	LITERAL1
+ACS37800_CRS_SNS_5POINT5X	LITERAL1
+ACS37800_CRS_SNS_8X	LITERAL1
+
+ACS37800_FLTDLY_0000	LITERAL1
+ACS37800_FLTDLY_0475	LITERAL1
+ACS37800_FLTDLY_0925	LITERAL1
+ACS37800_FLTDLY_1375	LITERAL1
+ACS37800_FLTDLY_1850	LITERAL1
+ACS37800_FLTDLY_2325	LITERAL1
+ACS37800_FLTDLY_2775	LITERAL1
+
+ACS37800_DIO0_FUNC_ZERO_CROSSING	LITERAL1
+ACS37800_DIO0_FUNC_OVERVOLTAGE	LITERAL1
+ACS37800_DIO0_FUNC_UNDERVOLTAGE	LITERAL1
+ACS37800_DIO0_FUNC_OV_OR_UV	LITERAL1
+
+ACS37800_DIO1_FUNC_OVERCURRENT	LITERAL1
+ACS37800_DIO1_FUNC_UNDERVOLTAGE	LITERAL1
+ACS37800_DIO1_FUNC_OVERVOLTAGE	LITERAL1
+ACS37800_DIO1_FUNC_OV_OR_UV_OR_OCF_LAT	LITERAL1
+
+ACS37800_EEPROM_ECC_NO_ERROR	LITERAL1
+ACS37800_EEPROM_ECC_ERROR_CORRECTED	LITERAL1
+ACS37800_EEPROM_ECC_ERROR_UNCORRECTABLE	LITERAL1
+ACS37800_EEPROM_ECC_NO_MEANING	LITERAL1

library.properties

@@ -0,0 +1,9 @@
+name=SparkFun ACS37800 Power Monitor Arduino Library
+version=1.0.0
+author=SparkFun Electronics
+maintainer=SparkFun Electronics
+sentence=Library for the Allegro MicroSystems ACS37800 power monitor IC
+paragraph=The Allegro MicroSystems ACS37800 power monitoring IC greatly simplifies the addition of power monitoring to many powered systems. This library supports the I2C versions like the ACS37800KMABTR-030B3-I2C found on the SparkX Qwiic Power Meter.
+category=Sensors
+url=https://github.com/sparkfun/SparkFun_ACS37800_Power_Monitor_Arduino_Library
+architectures=*

src/SparkFun_ACS37800_Arduino_Library.cpp

@@ -0,0 +1,167 @@
+/*
+  This is a library written for the I2C versions of the Allegro MicroSystems ACS37800 power monitor IC
+  By Paul Clark @ SparkFun Electronics, January 21st, 2021
+
+
+  https://github.com/sparkfun/SparkFun_ACS37800_Power_Monitor_Arduino_Library
+
+  Development environment specifics:
+  Arduino IDE 1.8.13
+
+  SparkFun labored with love to create this code. Feel like supporting open
+  source hardware? Buy a board from SparkFun!
+  https://www.sparkfun.com/products/nnnnn
+
+*/
+
+#include "SparkFun_ACS37800_Arduino_Library.h"
+
+//Constructor
+ACS37800::ACS37800()
+{
+}
+
+//Start I2C communication using specified port
+//Returns true if successful or false if no sensor detected
+bool ACS37800::begin(uint8_t address, TwoWire &wirePort)
+{
+  _ACS37800Address = address; //Grab which i2c address the user wants us to use
+  _i2cPort = &wirePort; //Grab which port the user wants us to use
+
+  uint32_t accessCode; //Read and validate the access code
+  ACS37800ERR error = readRegister(&accessCode, ACS37800_REGISTER_VOLATILE_2F);
+
+  if (_printDebug == true)
+  {
+    _debugPort->print(F("begin: readRegister error: "));
+    _debugPort->println(error);
+    _debugPort->print(F("begin: accessCode: 0x"));
+    _debugPort->println(accessCode, HEX);
+  }
+
+  return ((error == ACS37800_SUCCESS) && (accessCode == ACS37800_CUSTOMER_ACCESS_CODE));
+}
+
+//Calling this function with nothing sets the debug port to Serial
+//You can also call it with other streams like Serial1, SerialUSB, etc.
+void ACS37800::enableDebugging(Stream &debugPort)
+{
+	_debugPort = &debugPort;
+	_printDebug = true;
+}
+
+//Read a register's contents. Data is returned in data.
+ACS37800ERR ACS37800::readRegister(uint32_t *data, uint8_t address)
+{
+  _i2cPort->beginTransmission(_ACS37800Address);
+  _i2cPort->write(address); //Write the register address
+  uint8_t i2cResult = _i2cPort->endTransmission(false); //Send restart. Don't release the bus.
+
+  if (i2cResult != 0)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("readRegister: endTransmission returned: "));
+      _debugPort->println(i2cResult);
+    }
+    return (ACS37800_ERR_I2C_ERROR); // Bail
+  }
+
+  //Read 4 bytes (32 bits)
+  uint8_t toRead = _i2cPort->requestFrom(_ACS37800Address, (uint8_t)4);
+  if (toRead != 4)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("readRegister: requestFrom returned: "));
+      _debugPort->println(toRead);
+    }
+    return (ACS37800_ERR_I2C_ERROR); //Error out
+  }
+
+  //Data is returned LSB first (little endian)
+  uint32_t readData = _i2cPort->read(); //store LSB
+  readData |= ((uint32_t)_i2cPort->read()) << 8;
+  readData |= ((uint32_t)_i2cPort->read()) << 16;
+  readData |= ((uint32_t)_i2cPort->read()) << 24; //store MSB
+
+  *data = readData; //Return the data
+  return (ACS37800_SUCCESS);
+}
+
+//Write data to the selected register
+ACS37800ERR ACS37800::writeRegister(uint32_t data, uint8_t address)
+{
+  _i2cPort->beginTransmission(_ACS37800Address);
+  _i2cPort->write(address); //Write the register address
+  _i2cPort->write(data & 0xFF); //Write the data LSB first (little endian)
+  _i2cPort->write((data >> 8) & 0xFF);
+  _i2cPort->write((data >> 16) & 0xFF);
+  _i2cPort->write((data >> 24) & 0xFF);
+  uint8_t i2cResult = _i2cPort->endTransmission(); //Release the bus.
+
+  if (i2cResult != 0)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("writeRegister: endTransmission returned: "));
+      _debugPort->println(i2cResult);
+    }
+    return (ACS37800_ERR_I2C_ERROR); // Bail
+  }
+
+  return (ACS37800_SUCCESS);
+}
+
+//Change the I2C address
+ACS37800ERR ACS37800::setI2Caddress(uint8_t newAddress)
+{
+  ACS37800_REGISTER_0F_t store;
+  ACS37800ERR error = readRegister(&store.data.all, ACS37800_REGISTER_EEPROM_0F); // Read register 0F
+
+  if (error != ACS37800_SUCCESS)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("setI2Caddress: readRegister (1) returned: "));
+      _debugPort->println(error);
+    }
+    return (error); // Bail
+  }
+
+  store.data.bits.i2c_slv_addr = newAddress; //Update the address
+  store.data.bits.i2c_dis_slv_addr = 1; //Disable setting the address via the DIO pins
+
+  error = writeRegister(store.data.all, ACS37800_REGISTER_EEPROM_0F); // Write register 0F
+
+  if (error != ACS37800_SUCCESS)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("setI2Caddress: writeRegister returned: "));
+      _debugPort->println(error);
+    }
+    return (error); // Bail
+  }
+
+  error = readRegister(&store.data.all, ACS37800_REGISTER_EEPROM_0F); // Read register 0F
+
+  if (error != ACS37800_SUCCESS)
+  {
+    if (_printDebug == true)
+    {
+      _debugPort->print(F("setI2Caddress: readRegister (2) returned: "));
+      _debugPort->println(error);
+    }
+    return (error); // Bail
+  }
+
+  if (store.data.bits.i2c_slv_addr == newAddress) //Check the address was updated correctly
+  {
+    return (ACS37800_SUCCESS);
+  }
+  else
+  {
+    return (ACS37800_ERR_REGISTER_READ_MODIFY_WRITE_FAILURE);
+  }
+}

src/SparkFun_ACS37800_Arduino_Library.h

@@ -0,0 +1,381 @@
+/*
+  This is a library written for the I2C versions of the Allegro MicroSystems ACS37800 power monitor IC
+  By Paul Clark @ SparkFun Electronics, January 21st, 2021
+
+
+  https://github.com/sparkfun/SparkFun_ACS37800_Power_Monitor_Arduino_Library
+
+  Development environment specifics:
+  Arduino IDE 1.8.13
+
+  SparkFun labored with love to create this code. Feel like supporting open
+  source hardware? Buy a board from SparkFun!
+  https://www.sparkfun.com/products/nnnnn
+
+*/
+
+#ifndef SparkFun_ACS37800_Arduino_Library_h
+#define SparkFun_ACS37800_Arduino_Library_h
+
+#include "Arduino.h"
+#include <Wire.h>
+
+//Default I2C Address
+//This is the address when DIO_0 and DIO_1 are 0V on start-up
+//The address can be configured in EEPROM too
+const uint8_t ACS37800_DEFAULT_I2C_ADDRESS = 0x61;
+
+//Customer Access Code - stored in volatile register 0x2F
+const uint32_t ACS37800_CUSTOMER_ACCESS_CODE = 0x4F70656E;
+
+//Default sense resistance for voltage measurement (kOhms)
+const float ACS37800_DEFAULT_SENSE_RES = 8.2;
+
+//Error result
+typedef enum {
+  ACS37800_SUCCESS = 0,
+  ACS37800_ERR_I2C_ERROR,
+  ACS37800_ERR_REGISTER_READ_MODIFY_WRITE_FAILURE
+} ACS37800ERR;
+
+//EEPROM Registers
+const uint8_t ACS37800_REGISTER_EEPROM_0B = 0x0B;
+const uint8_t ACS37800_REGISTER_EEPROM_0C = 0x0C;
+const uint8_t ACS37800_REGISTER_EEPROM_0D = 0x0D;
+const uint8_t ACS37800_REGISTER_EEPROM_0E = 0x0E;
+const uint8_t ACS37800_REGISTER_EEPROM_0F = 0x0F;
+
+//Shadow Registers
+//At power up, all shadow registers are loaded from EEPROM, including all configuration parameters.
+//The shadow registers can be written to in order to change the device behavior without having to
+//perform an EEPROM write. Any changes made in shadow memory are volatile and do not persist through a reset event.
+const uint8_t ACS37800_REGISTER_SHADOW_1B = 0x1B;
+const uint8_t ACS37800_REGISTER_SHADOW_1C = 0x1C;
+const uint8_t ACS37800_REGISTER_SHADOW_1D = 0x1D;
+const uint8_t ACS37800_REGISTER_SHADOW_1E = 0x1E;
+const uint8_t ACS37800_REGISTER_SHADOW_1F = 0x1F;
+
+//Volatile Registers
+const uint8_t ACS37800_REGISTER_VOLATILE_20 = 0x20;
+const uint8_t ACS37800_REGISTER_VOLATILE_21 = 0x21;
+const uint8_t ACS37800_REGISTER_VOLATILE_22 = 0x22;
+const uint8_t ACS37800_REGISTER_VOLATILE_25 = 0x25;
+const uint8_t ACS37800_REGISTER_VOLATILE_26 = 0x26;
+const uint8_t ACS37800_REGISTER_VOLATILE_27 = 0x27;
+const uint8_t ACS37800_REGISTER_VOLATILE_28 = 0x28;
+const uint8_t ACS37800_REGISTER_VOLATILE_29 = 0x29;
+const uint8_t ACS37800_REGISTER_VOLATILE_2A = 0x2A;
+const uint8_t ACS37800_REGISTER_VOLATILE_2C = 0x2C;
+const uint8_t ACS37800_REGISTER_VOLATILE_2D = 0x2D;
+const uint8_t ACS37800_REGISTER_VOLATILE_2F = 0x2F;
+const uint8_t ACS37800_REGISTER_VOLATILE_30 = 0x30;
+
+//EEPROM Registers : Bit Fields
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t qvo_fine : 9;
+      uint32_t sns_fine : 10;
+      uint32_t crs_sns : 3;
+      uint32_t iavgselen : 1;
+      uint32_t pavgselen : 1;
+      uint32_t reserved : 2;
+      uint32_t ECC : 6;
+    } bits;
+  } data;
+} ACS37800_REGISTER_0B_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t rms_avg_1 : 7;
+      uint32_t rms_avg_2 : 10;
+      uint32_t vchan_offset_code : 8;
+      uint32_t reserved : 1;
+      uint32_t ECC : 6;
+    } bits;
+  } data;
+} ACS37800_REGISTER_0C_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t reserved1 : 7;
+      uint32_t ichan_del_en : 1;
+      uint32_t reserved2 : 1;
+      uint32_t chan_del_sel : 3;
+      uint32_t reserved3 : 1;
+      uint32_t fault : 8;
+      uint32_t fltdly : 3;
+      uint32_t reserved4 : 2;
+      uint32_t ECC : 6;
+    } bits;
+  } data;
+} ACS37800_REGISTER_0D_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vevent_cycs : 6;
+      uint32_t reserved1 : 2;
+      uint32_t overvreg : 6;
+      uint32_t undervreg : 6;
+      uint32_t delaycnt_sel : 1;
+      uint32_t halfcycle_en : 1;
+      uint32_t squarewave_en : 1;
+      uint32_t zerocrosschansel : 1;
+      uint32_t zerocrossedgesel : 1;
+      uint32_t reserved2 : 1;
+      uint32_t ECC : 6;
+    } bits;
+  } data;
+} ACS37800_REGISTER_0E_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t reserved1 : 2;
+      uint32_t i2c_slv_addr : 7;
+      uint32_t i2c_dis_slv_addr : 1;
+      uint32_t dio_0_sel : 2;
+      uint32_t dio_1_sel : 2;
+      uint32_t n : 10;
+      uint32_t bypass_n_en : 1;
+      uint32_t reserved2 : 1;
+      uint32_t ECC : 6;
+    } bits;
+  } data;
+} ACS37800_REGISTER_0F_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vrms : 16;
+      uint32_t irms : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_20_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t pactive : 16;
+      uint32_t pimag : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_21_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t papparent : 16;
+      uint32_t pfactor : 11;
+      uint32_t posangle : 1;
+      uint32_t pospf : 1;
+    } bits;
+  } data;
+} ACS37800_REGISTER_22_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t numptsout : 10;
+    } bits;
+  } data;
+} ACS37800_REGISTER_25_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vrmsavgonesec : 16;
+      uint32_t irmsavgonesec : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_26_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vrmsavgonemin : 16;
+      uint32_t irmsavgonemin : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_27_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t pactavgonesec : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_28_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t pactavgonemin : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_29_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vcodes : 16;
+      uint32_t icodes : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_2A_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t pinstant : 16;
+    } bits;
+  } data;
+} ACS37800_REGISTER_2C_t;
+typedef struct
+{
+  union
+  {
+    uint32_t all;
+    struct
+    {
+      uint32_t vzerocrossout : 1;
+      uint32_t faultout : 1;
+      uint32_t faultlatched : 1;
+      uint32_t overvoltage : 1;
+      uint32_t undervoltage : 1;
+    } bits;
+  } data;
+} ACS37800_REGISTER_2D_t;
+
+//Register Field Enums
+typedef enum
+{
+  ACS37800_CRS_SNS_1X = 0,
+  ACS37800_CRS_SNS_2X,
+  ACS37800_CRS_SNS_3X,
+  ACS37800_CRS_SNS_3POINT5X,
+  ACS37800_CRS_SNS_4X,
+  ACS37800_CRS_SNS_4POINT5X,
+  ACS37800_CRS_SNS_5POINT5X,
+  ACS37800_CRS_SNS_8X
+} ACS37800_CRS_SNS_e; //Coarse gain for the current channel
+typedef enum
+{
+  ACS37800_FLTDLY_0000 = 0,
+  ACS37800_FLTDLY_0475 = 2, //4.75 microseconds
+  ACS37800_FLTDLY_0925, //9.25 microseconds
+  ACS37800_FLTDLY_1375,
+  ACS37800_FLTDLY_1850,
+  ACS37800_FLTDLY_2325,
+  ACS37800_FLTDLY_2775 //27.75 microseconds
+} ACS37800_FLTDLY_e; //Fault Delay
+typedef enum
+{
+  ACS37800_DIO0_FUNC_ZERO_CROSSING = 0,
+  ACS37800_DIO0_FUNC_OVERVOLTAGE,
+  ACS37800_DIO0_FUNC_UNDERVOLTAGE,
+  ACS37800_DIO0_FUNC_OV_OR_UV
+} ACS37800_DIO0_FUNC_e; //DIO_0 Function
+typedef enum
+{
+  ACS37800_DIO1_FUNC_OVERCURRENT = 0,
+  ACS37800_DIO1_FUNC_UNDERVOLTAGE,
+  ACS37800_DIO1_FUNC_OVERVOLTAGE,
+  ACS37800_DIO1_FUNC_OV_OR_UV_OR_OCF_LAT
+} ACS37800_DIO1_FUNC_e; //DIO_1 Function
+typedef enum
+{
+  ACS37800_EEPROM_ECC_NO_ERROR = 0,
+  ACS37800_EEPROM_ECC_ERROR_CORRECTED,
+  ACS37800_EEPROM_ECC_ERROR_UNCORRECTABLE,
+  ACS37800_EEPROM_ECC_NO_MEANING
+} ACS37800_EEPROM_ECC_e; //EEPROM ECC Errors
+
+class ACS37800
+{
+    // user-accessible "public" interface
+  public:
+
+    //Default constructor
+    ACS37800();
+
+    //Start I2C communication using specified address and port
+    boolean begin(uint8_t address = ACS37800_DEFAULT_I2C_ADDRESS, TwoWire &wirePort = Wire); //If user doesn't specify then Wire will be used
+
+    //Debugging
+    void enableDebugging(Stream &debugPort = Serial); //Turn on debug printing. If user doesn't specify then Serial will be used.
+
+    //Basic methods for accessing registers
+    ACS37800ERR readRegister(uint32_t *data, uint8_t address);
+    ACS37800ERR writeRegister(uint32_t data, uint8_t address);
+
+    //Configurable Settings
+
+    ACS37800ERR setI2Caddress(uint8_t newAddress);
+
+  private:
+    //This stores the requested i2c port
+    TwoWire * _i2cPort;
+
+    //Debug
+    Stream *_debugPort; //The stream to send debug messages to if enabled. Usually Serial.
+  	boolean _printDebug = false; //Flag to print debugging variables
+
+    //ACS37800's I2C address
+    uint8_t _ACS37800Address = ACS37800_DEFAULT_I2C_ADDRESS;
+
+    //The value of the sense resistor for voltage measurement in kOhms
+    float _senseResistance = ACS37800_DEFAULT_SENSE_RES;
+
+};
+
+#endif