/** * INA3221 driver for esp-open-rtos. * * Copyright (c) 2016 Zaltora (https://github.com/Zaltora) * * MIT Licensed as described in the file LICENSE * * @todo Interupt system for critical and warning alert pin */ #include "ina3221.h" //#define INA3221_DEBUG true #ifdef INA3221_DEBUG #define debug(fmt, ...) printf("%s: " fmt "\n", "INA3221", ## __VA_ARGS__) #else #define debug(fmt, ...) #endif static int _wireWriteRegister (uint8_t addr, uint8_t reg, uint16_t value) { uint8_t d[2] = { 0 , 0 }; d[1] = value & 0x00FF; d[0] = (value >> 8) & 0x00FF; debug("Data write to %02X : %02X+%04X\n",addr,reg,value); return i2c_slave_write(addr, ®, d, sizeof(d)); } static int _wireReadRegister(uint8_t addr, uint8_t reg, uint16_t *value) { uint8_t d[] = {0, 0}; int error = i2c_slave_read(addr, ®, d, sizeof(d)) debug("Data read from %02X: %02X+%04X\n",addr,reg,*value); *value = d[1] | (d[0] << 8); return error; } int ina3221_trigger(ina3221_t *dev) { return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_getStatus(ina3221_t *dev) { return _wireReadRegister(dev->addr, INA3221_REG_MASK, &dev->mask.mask_register); } int ina3221_sync(ina3221_t *dev) { uint16_t ptr_data; int err = 0; //////////////////////// Sync config register if ((err = _wireReadRegister(dev->addr, INA3221_REG_CONFIG, &ptr_data))) // Read config return err; if( ptr_data != dev->config.config_register) { if ((err = _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register))) // Update config return err; } //////////////////////// Sync mask register config if ((err = _wireReadRegister(dev->addr, INA3221_REG_MASK, &ptr_data))) // Read mask return err; if( (ptr_data & INA3221_MASK_CONFIG) != (dev->mask.mask_register & INA3221_MASK_CONFIG)) { if ((err = _wireWriteRegister(dev->addr, INA3221_REG_MASK, dev->mask.mask_register & INA3221_MASK_CONFIG))) // Update config return err; } return 0; } int ina3221_setting(ina3221_t *dev ,bool mode, bool bus, bool shunt) { dev->config.mode = mode; dev->config.ebus = bus; dev->config.esht = shunt; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_enableChannel(ina3221_t *dev ,bool ch1, bool ch2, bool ch3) { dev->config.ch1 = ch1; dev->config.ch2 = ch2; dev->config.ch3 = ch3; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_enableChannelSum(ina3221_t *dev ,bool ch1, bool ch2, bool ch3) { dev->mask.scc1 = ch1; dev->mask.scc2 = ch2; dev->mask.scc3 = ch3; return _wireWriteRegister(dev->addr, INA3221_REG_MASK, dev->mask.mask_register & INA3221_MASK_CONFIG); } int ina3221_enableLatchPin(ina3221_t *dev ,bool warning, bool critical) { dev->mask.wen = warning; dev->mask.cen = critical; return _wireWriteRegister(dev->addr, INA3221_REG_MASK, dev->mask.mask_register & INA3221_MASK_CONFIG); } int ina3221_setAverage(ina3221_t *dev, ina3221_avg_t avg) { dev->config.avg = avg; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_setBusConversionTime(ina3221_t *dev,ina3221_ct_t ct) { dev->config.vbus = ct; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_setShuntConversionTime(ina3221_t *dev,ina3221_ct_t ct) { dev->config.vsht = ct; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); } int ina3221_reset(ina3221_t *dev) { dev->config.config_register = INA3221_DEFAULT_CONFIG ; //dev reset dev->mask.mask_register = INA3221_DEFAULT_CONFIG ; //dev reset dev->config.rst = 1 ; return _wireWriteRegister(dev->addr, INA3221_REG_CONFIG, dev->config.config_register); // send reset to device } int ina3221_getBusVoltage(ina3221_t *dev, ina3221_channel_t channel, float *voltage) { int16_t raw_value; int err = 0; if ((err = _wireReadRegister(dev->addr,INA3221_REG_BUSVOLTAGE_1+channel*2, (uint16_t*)&raw_value))) return err; *voltage = raw_value*0.001 ; //V 8mV step return 0; } int ina3221_getShuntValue(ina3221_t *dev, ina3221_channel_t channel, float *voltage, float *current) { int16_t raw_value; int err = 0; if ((err = _wireReadRegister(dev->addr,INA3221_REG_SHUNTVOLTAGE_1+channel*2, (uint16_t*)&raw_value))) return err; *voltage = raw_value*0.005; //mV 40uV step if(!dev->shunt[channel]) { debug("No shunt configured for channel %u. Dev:%X\n",channel+1, dev->addr); return -EINVAL; } *current = (*voltage*1000.0)/dev->shunt[channel] ; //mA return 0; } int ina3221_getSumShuntValue(ina3221_t *dev, float *voltage) { int16_t raw_value; int err = 0; if ((err = _wireReadRegister(dev->addr,INA3221_REG_SHUNT_VOLTAGE_SUM, (uint16_t*)&raw_value))) return err; *voltage = raw_value*0.02; //uV 40uV step return 0; } int ina3221_setCriticalAlert(ina3221_t *dev, ina3221_channel_t channel, float current) { int16_t raw_value = current*dev->shunt[channel]*0.2; // format return _wireWriteRegister(dev->addr,INA3221_REG_CRITICAL_ALERT_1+channel*2, *(uint16_t*)&raw_value); } int ina3221_setWarningAlert(ina3221_t *dev, ina3221_channel_t channel, float current) { int16_t raw_value = current*dev->shunt[channel]*0.2 ; // format return _wireWriteRegister(dev->addr,INA3221_REG_WARNING_ALERT_1+channel*2, *(uint16_t*)&raw_value); } int ina3221_setSumWarningAlert(ina3221_t *dev, float voltage) { int16_t raw_value = voltage*50.0 ; // format return _wireWriteRegister(dev->addr,INA3221_REG_SHUNT_VOLTAGE_SUM_LIMIT, *(uint16_t*)&raw_value); } int ina3221_setPowerValidUpperLimit(ina3221_t *dev, float voltage) { if(!dev->config.ebus) { debug("Bus not enable. Dev:%X\n", dev->addr); return -ENOTSUP; } int16_t raw_value = voltage*1000.0; //format return _wireWriteRegister(dev->addr,INA3221_REG_VALID_POWER_UPPER_LIMIT, *(uint16_t*)&raw_value); } int ina3221_setPowerValidLowerLimit(ina3221_t *dev, float voltage) { if(!dev->config.ebus) { debug("Bus not enable. Dev:%X\n", dev->addr); return -ENOTSUP; } int16_t raw_value = voltage*1000.0; // round and format return _wireWriteRegister(dev->addr,INA3221_REG_VALID_POWER_LOWER_LIMIT, *(uint16_t*)&raw_value); }