/* * DS2438.h * * by Joe Bechter * * (C) 2012, bechter.com * * All files, software, schematics and designs are provided as-is with no warranty. * All files, software, schematics and designs are for experimental/hobby use. * Under no circumstances should any part be used for critical systems where safety, * life or property depends upon it. You are responsible for all use. * You are free to use, modify, derive or otherwise extend for your own non-commercial purposes provided * 1. No part of this software or design may be used to cause injury or death to humans or animals. * 2. Use is non-commercial. * 3. Credit is given to the author (i.e. portions © bechter.com), and provide a link to the original source. * */ #ifndef DS2438_h #define DS2438_h #include #include #define DS2438_TEMPERATURE_CONVERSION_COMMAND 0x44 #define DS2438_VOLTAGE_CONVERSION_COMMAND 0xb4 #define DS2438_WRITE_SCRATCHPAD_COMMAND 0x4e #define DS2438_COPY_SCRATCHPAD_COMMAND 0x48 #define DS2438_READ_SCRATCHPAD_COMMAND 0xbe #define DS2438_RECALL_MEMORY_COMMAND 0xb8 #define PAGE_MIN 0 #define PAGE_MAX 7 #define DS2438_CHA 0 #define DS2438_CHB 1 #define DS2438_MODE_CHA 0x01 #define DS2438_MODE_CHB 0x02 #define DS2438_MODE_TEMPERATURE 0x04 #define DS2438_TEMPERATURE_DELAY 10 #define DS2438_VOLTAGE_CONVERSION_DELAY 8 #define DEFAULT_PAGE0(var) uint8_t var[8] { \ 0b00001011 /* X, ADB=0, NVB=0, TB=0, AD=1, EE=0, CA=1, IAD=1 */, \ 0, /* Temperatur */ \ 0, /* Temperatur */ \ 0, /* Voltage */ \ 0, /* Voltage */ \ 0, /* Current */ \ 0, /* Current */ \ 0 /* Threashold */ \ } typedef struct PageOne { uint8_t eleapsedTimerByte0; /**< LSB of timestamp */ uint8_t eleapsedTimerByte1; uint8_t eleapsedTimerByte2; uint8_t eleapsedTimerByte3; /**< MSB of timestamp */ uint8_t ICA; /**< Integrated Current Accumulator (current flowing into and out of the battery) */ uint8_t offsetRegisterByte0; /**< Offset for ADC calibdation */ uint8_t offsetRegisterByte1; /**< Offset for ADC calibdation */ uint8_t reserved; } PageOne_t; typedef struct PageSeven { uint8_t userByte0; uint8_t userByte1; uint8_t userByte2; uint8_t userByte3; uint8_t CCA0; /**< Charging Current Accumulator (CCA) */ uint8_t CCA1; /**< Charging Current Accumulator (CCA) */ uint8_t DCA0; /**< Discharge Current Accumulator (DCA) */ uint8_t DCA1; /**< Discharge Current Accumulator (DCA) */ } PageSeven_t; typedef uint8_t DeviceAddress[8]; class DS2438 { public: DS2438(OneWire *ow, float currentShunt); DS2438(OneWire *ow, uint8_t *address); void begin(); void update(); double getTemperature(); float getVoltage(int channel=DS2438_CHA); float getCurrent(); long getICA(); long getCCA(); long getDCA(); float getAh(); boolean isError(); boolean isFound(); private: bool validAddress(const uint8_t*); bool validFamily(const uint8_t* deviceAddress); bool deviceFound = false; OneWire *_ow; DeviceAddress _address; uint8_t _mode; double _temperature; float _voltageA; float _voltageB; float _current; float _currentShunt; long _CCA; long _DCA; long _ICA; boolean _error; boolean startConversion(int channel, boolean doTemperature); boolean selectChannel(int channel); void writePage(int page, uint8_t *data); boolean readPage(int page, uint8_t *data); }; #endif