/* USRP E310 Firmware Linear Technology LTC294X driver * Copyright (C) 2014 Ettus Research * This file is part of the USRP E310 Firmware * The USRP E310 Firmware is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 2 of the License, or * (at your option) any later version. * The USRP E310 Firmware is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * You should have received a copy of the GNU General Public License * along with the USRP E310 Firmware. If not, see . */ #include #include #include #include #include "i2c_twi.h" #include "io.h" #include "ltc294x.h" #include "utils.h" #include "pmu.h" static const uint8_t LTC294X_I2C_ADDR = 0x64; #define ltc294x_read(reg, val) \ (i2c_twi_read(LTC294X_I2C_ADDR, reg, val)) #define ltc294x_read16(reg, val) \ (i2c_twi_read16(LTC294X_I2C_ADDR, reg, val)) #define ltc294x_write(reg, val) \ (i2c_twi_write(LTC294X_I2C_ADDR, reg, val)) #define ltc294x_write16(reg, val) \ (i2c_twi_write16(LTC294X_I2C_ADDR, reg, val)) static const uint8_t LTC294X_REG_STATUS = 0x00; static const uint8_t LTC294X_REG_CONTROL = 0x01; static const uint8_t LTC294X_REG_CHARGE_MSB = 0x2; static const uint8_t LTC294X_REG_CHARGE_LSB = 0x3; static const uint8_t LTC294X_REG_HIGH_TRESH_MSB = 0x4; static const uint8_t LTC294X_REG_HIGH_THRESH_LSB = 0x5; static const uint8_t LTC294X_REG_LOW_THRESH_MSB = 0x6; static const uint8_t LTC294X_REG_LOW_THRESH_LSB = 0x7; static const uint8_t LTC294X_REG_VOLTAGE_MSB = 0x8; static const uint8_t LTC294X_REG_VOLTAGE_LSB = 0x9; static const uint8_t LTC294X_REG_VOLTAGE_THRESH_HI = 0xa; static const uint8_t LTC294X_REG_VOLTAGE_THRESH_LO = 0xb; static const uint8_t LTC294X_REG_TEMP_MSB = 0xc; static const uint8_t LTC294X_REG_TEMP_LSB = 0xd; static const uint8_t LTC294X_REG_TEMP_THRESH_HI = 0xe; static const uint8_t LTC294X_REG_TEMP_THRESH_LO = 0xf; /* status register */ static const uint8_t LTC294X_CHIP_ID_MASK = BIT(7); static const uint8_t LTC294X_CHIP_ID_SHIFT = 7; static const uint8_t LTC294X_ACR_OVF_MASK = BIT(5); static const uint8_t LTC294X_ACR_OVF_SHIFT = 5; static const uint8_t LTC294X_TEMP_ALERT_MASK = BIT(4); static const uint8_t LTC294X_TEMP_ALERT_SHIFT = 4; static const uint8_t LTC294X_CH_ALERT_HIGH_MASK = BIT(3); static const uint8_t LTC294X_CH_ALERT_HIGH_SHIFT = 3; static const uint8_t LTC294X_CH_ALERT_LOW_MASK = BIT(2); static const uint8_t LTC294X_CH_ALERT_LOW_SHIFT = 2; static const uint8_t LTC294X_VOLT_ALERT_MASK = BIT(1); static const uint8_t LTC294X_CH_VOLT_ALERT_SHIFT = 1; static const uint8_t LTC294X_CH_UVOLT_MASK = BIT(0); static const uint8_t LTC294X_CH_UVOLT_SHIFT = 0; /* control register */ static const uint8_t LTC294X_ADC_MODE_MASK = BIT(7) | BIT(6); static const uint8_t LTC294X_ADC_MODE_SHIFT = 6; static const uint8_t LTC294X_PRESCALER_MASK = BIT(5) | BIT(4) | BIT(3); static const uint8_t LTC294X_PRESCALER_SHIFT = 3; static const uint8_t LTC294X_ALCC_CFG_MASK = BIT(2) | BIT(1); static const uint8_t LTC294X_ALCC_CFG_SHIFT = 1; static const uint8_t LTC294X_SHUTDOWN_MASK = BIT(0); static const uint8_t LTC294X_SHUTDOWN_SHIFT = 0; /* acrh register */ /* acrl register */ struct ltc294x_gauge { pmu_gauge_t pmu_gauge; volatile uint8_t status; uint16_t temp_thresh_high; uint16_t temp_thresh_low; uint16_t charge_lo_thesh; bool first_time; }; static struct ltc294x_gauge gauge; static io_pin_t FG_ALn_CC = IO_PA(0); static uint16_t ltc294x_get_charge(void) { uint16_t val; (void) ltc294x_read16(LTC294X_REG_CHARGE_MSB, &val); return val; } static void ltc294x_set_charge(uint16_t val) { uint8_t ctrl_val; /* datasheet says to shutdown the analog part * when writing the ACR */ (void) ltc294x_read(LTC294X_REG_CONTROL, &ctrl_val); ctrl_val |= LTC294X_SHUTDOWN_MASK; (void) ltc294x_write(LTC294X_REG_CONTROL, ctrl_val); /* write the value ... */ (void) ltc294x_write16(LTC294X_REG_CHARGE_MSB, val); ctrl_val &= ~LTC294X_SHUTDOWN_MASK; /* turn it on again ...*/ (void) ltc294x_write(LTC294X_REG_CONTROL, ctrl_val); } static uint16_t ltc294x_get_temp(void) { uint16_t val; (void) ltc294x_read16(LTC294X_REG_TEMP_MSB, &val); return val; } static uint16_t ltc294x_get_voltage(void) { uint16_t val; (void) ltc294x_read16(LTC294X_REG_VOLTAGE_MSB, &val); return val; } static int8_t ltc294x_set_charge_thresh(bool high, uint16_t val) { int8_t ret; ret = ltc294x_write16( high ? LTC294X_REG_HIGH_TRESH_MSB : LTC294X_REG_LOW_THRESH_MSB, val); if (ret) return ret; return 0; } static inline void ltc294x_pmu_set_charge_hi_thesh(uint16_t val) { ltc294x_set_charge_thresh(true, val); } static inline void ltc294x_pmu_set_charge_lo_thesh(uint16_t val) { ltc294x_set_charge_thresh(false, val); } uint8_t ltc294x_check_events(void) { uint8_t status; uint8_t flags = 0; uint16_t value; ltc294x_read(LTC294X_REG_STATUS, &status); if (status && (status != gauge.status)) { if (status & LTC294X_CH_ALERT_HIGH_MASK) flags |= PMU_GAUGE_CHARGE_HI; else if (status & LTC294X_CH_ALERT_LOW_MASK) flags |= PMU_GAUGE_CHARGE_LO; if (status & LTC294X_VOLT_ALERT_MASK) { /*flags |= PMU_GAUGE_VOLT_HI; flags |= PMU_GAUGE_VOLT_LO; */ /* TODO: Figure out which one */ } if (status & LTC294X_ACR_OVF_MASK) { value = ltc294x_get_charge(); if (value <= gauge.charge_lo_thesh) flags |= PMU_GAUGE_CHARGE_LO; } if (status & LTC294X_TEMP_ALERT_MASK) { value = ltc294x_get_temp(); if (value > gauge.temp_thresh_high) flags |= PMU_GAUGE_TEMP_HI; else if (value <= gauge.temp_thresh_low) flags |= PMU_GAUGE_TEMP_LO; } gauge.status = status; } return flags; } static const pmu_gauge_ops_t ltc294x_pmu_gauge_ops = { .check_events = ltc294x_check_events, .get_temperature = ltc294x_get_temp, .get_charge = ltc294x_get_charge, .set_charge = ltc294x_set_charge, .set_low_threshold = ltc294x_pmu_set_charge_lo_thesh, .get_voltage = ltc294x_get_voltage, }; int8_t ltc294x_init(ltc294x_model_t model) { uint8_t val; int8_t ret; /* make input, set pullup */ io_input_pin(FG_ALn_CC); io_set_pin(FG_ALn_CC); gauge.pmu_gauge.ops = <c294x_pmu_gauge_ops; ret = ltc294x_read(LTC294X_REG_STATUS, &val); if (ret) goto fail_i2c_read; val &= LTC294X_CHIP_ID_MASK; val >>= LTC294X_CHIP_ID_SHIFT; if (val != model) goto fail_id; /* set ACR to 0, this allows for calibrating by * completely discharging the battery once */ ltc294x_set_charge(0x0010); /* set low threshold to 10% assuming full is 0xeae4... */ ltc294x_write16(LTC294X_REG_LOW_THRESH_MSB, 0x1794); gauge.charge_lo_thesh = 0x1794; /* set high threshold for temperature to 85 C */ ltc294x_write16(LTC294X_REG_TEMP_THRESH_HI, 0x98); gauge.temp_thresh_high = 0x9800; /* set low threshold for temperature to -2 C */ ltc294x_write16(LTC294X_REG_TEMP_THRESH_LO, 0x74); gauge.temp_thresh_low = 0x7400; ret = ltc294x_read(LTC294X_REG_CONTROL, &val); if (ret) goto fail_i2c_read; /* enable automatic temp conversion */ val &= ~LTC294X_ADC_MODE_MASK; val |= 0x3 << LTC294X_ADC_MODE_SHIFT; /* set prescaler to 16 */ val &= ~LTC294X_PRESCALER_MASK; val |= 0x4 << LTC294X_PRESCALER_SHIFT; /* disable IRQ mode */ val &= ~LTC294X_ALCC_CFG_MASK; val |= 0x0 << LTC294X_ALCC_CFG_SHIFT; ret = ltc294x_write(LTC294X_REG_CONTROL, val); pmu_register_gauge(&gauge.pmu_gauge); return 0; fail_id: fail_i2c_read: return ret; }