515 lines
13 KiB
C
515 lines
13 KiB
C
/*
|
|
* I2C client/driver for the Linear Technology LTC2941 and LTC2943
|
|
* Battery Gas Gauge IC
|
|
*
|
|
* Copyright (C) 2014 Topic Embedded Systems
|
|
*
|
|
* Author: Auryn Verwegen
|
|
* Author: Mike Looijmans
|
|
*/
|
|
#include <linux/kernel.h>
|
|
#include <linux/module.h>
|
|
#include <linux/types.h>
|
|
#include <linux/errno.h>
|
|
#include <linux/swab.h>
|
|
#include <linux/i2c.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/power_supply.h>
|
|
#include <linux/slab.h>
|
|
|
|
#define I16_MSB(x) ((x >> 8) & 0xFF)
|
|
#define I16_LSB(x) (x & 0xFF)
|
|
|
|
#define LTC294X_WORK_DELAY 10 /* Update delay in seconds */
|
|
|
|
#define LTC294X_MAX_VALUE 0xFFFF
|
|
#define LTC294X_MID_SUPPLY 0x7FFF
|
|
|
|
#define LTC2941_MAX_PRESCALER_EXP 7
|
|
#define LTC2943_MAX_PRESCALER_EXP 6
|
|
|
|
enum ltc294x_reg {
|
|
LTC294X_REG_STATUS = 0x00,
|
|
LTC294X_REG_CONTROL = 0x01,
|
|
LTC294X_REG_ACC_CHARGE_MSB = 0x02,
|
|
LTC294X_REG_ACC_CHARGE_LSB = 0x03,
|
|
LTC294X_REG_THRESH_HIGH_MSB = 0x04,
|
|
LTC294X_REG_THRESH_HIGH_LSB = 0x05,
|
|
LTC294X_REG_THRESH_LOW_MSB = 0x06,
|
|
LTC294X_REG_THRESH_LOW_LSB = 0x07,
|
|
LTC294X_REG_VOLTAGE_MSB = 0x08,
|
|
LTC294X_REG_VOLTAGE_LSB = 0x09,
|
|
LTC294X_REG_CURRENT_MSB = 0x0E,
|
|
LTC294X_REG_CURRENT_LSB = 0x0F,
|
|
LTC294X_REG_TEMPERATURE_MSB = 0x14,
|
|
LTC294X_REG_TEMPERATURE_LSB = 0x15,
|
|
};
|
|
|
|
#define LTC2943_REG_CONTROL_MODE_MASK (BIT(7) | BIT(6))
|
|
#define LTC2943_REG_CONTROL_MODE_SCAN BIT(7)
|
|
#define LTC294X_REG_CONTROL_PRESCALER_MASK (BIT(5) | BIT(4) | BIT(3))
|
|
#define LTC294X_REG_CONTROL_SHUTDOWN_MASK (BIT(0))
|
|
#define LTC294X_REG_CONTROL_PRESCALER_SET(x) \
|
|
((x << 3) & LTC294X_REG_CONTROL_PRESCALER_MASK)
|
|
#define LTC294X_REG_CONTROL_ALCC_CONFIG_DISABLED 0
|
|
|
|
#define LTC2941_NUM_REGS 0x08
|
|
#define LTC2943_NUM_REGS 0x18
|
|
|
|
struct ltc294x_info {
|
|
struct i2c_client *client; /* I2C Client pointer */
|
|
struct power_supply *supply; /* Supply pointer */
|
|
struct power_supply_desc supply_desc; /* Supply description */
|
|
struct delayed_work work; /* Work scheduler */
|
|
int num_regs; /* Number of registers (chip type) */
|
|
int charge; /* Last charge register content */
|
|
int r_sense; /* mOhm */
|
|
int Qlsb; /* nAh */
|
|
};
|
|
|
|
static inline int convert_bin_to_uAh(
|
|
const struct ltc294x_info *info, int Q)
|
|
{
|
|
return ((Q * (info->Qlsb / 10))) / 100;
|
|
}
|
|
|
|
static inline int convert_uAh_to_bin(
|
|
const struct ltc294x_info *info, int uAh)
|
|
{
|
|
int Q;
|
|
|
|
Q = (uAh * 100) / (info->Qlsb/10);
|
|
return (Q < LTC294X_MAX_VALUE) ? Q : LTC294X_MAX_VALUE;
|
|
}
|
|
|
|
static int ltc294x_read_regs(struct i2c_client *client,
|
|
enum ltc294x_reg reg, u8 *buf, int num_regs)
|
|
{
|
|
int ret;
|
|
struct i2c_msg msgs[2] = { };
|
|
u8 reg_start = reg;
|
|
|
|
msgs[0].addr = client->addr;
|
|
msgs[0].len = 1;
|
|
msgs[0].buf = ®_start;
|
|
|
|
msgs[1].addr = client->addr;
|
|
msgs[1].len = num_regs;
|
|
msgs[1].buf = buf;
|
|
msgs[1].flags = I2C_M_RD;
|
|
|
|
ret = i2c_transfer(client->adapter, &msgs[0], 2);
|
|
if (ret < 0) {
|
|
dev_err(&client->dev, "ltc2941 read_reg failed!\n");
|
|
return ret;
|
|
}
|
|
|
|
dev_dbg(&client->dev, "%s (%#x, %d) -> %#x\n",
|
|
__func__, reg, num_regs, *buf);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_write_regs(struct i2c_client *client,
|
|
enum ltc294x_reg reg, const u8 *buf, int num_regs)
|
|
{
|
|
int ret;
|
|
u8 reg_start = reg;
|
|
|
|
ret = i2c_smbus_write_i2c_block_data(client, reg_start, num_regs, buf);
|
|
if (ret < 0) {
|
|
dev_err(&client->dev, "ltc2941 write_reg failed!\n");
|
|
return ret;
|
|
}
|
|
|
|
dev_dbg(&client->dev, "%s (%#x, %d) -> %#x\n",
|
|
__func__, reg, num_regs, *buf);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_reset(const struct ltc294x_info *info, int prescaler_exp)
|
|
{
|
|
int ret;
|
|
u8 value;
|
|
u8 control;
|
|
|
|
/* Read status and control registers */
|
|
ret = ltc294x_read_regs(info->client, LTC294X_REG_CONTROL, &value, 1);
|
|
if (ret < 0) {
|
|
dev_err(&info->client->dev,
|
|
"Could not read registers from device\n");
|
|
goto error_exit;
|
|
}
|
|
|
|
control = LTC294X_REG_CONTROL_PRESCALER_SET(prescaler_exp) |
|
|
LTC294X_REG_CONTROL_ALCC_CONFIG_DISABLED;
|
|
/* Put the 2943 into "monitor" mode, so it measures every 10 sec */
|
|
if (info->num_regs == LTC2943_NUM_REGS)
|
|
control |= LTC2943_REG_CONTROL_MODE_SCAN;
|
|
|
|
if (value != control) {
|
|
ret = ltc294x_write_regs(info->client,
|
|
LTC294X_REG_CONTROL, &control, 1);
|
|
if (ret < 0) {
|
|
dev_err(&info->client->dev,
|
|
"Could not write register\n");
|
|
goto error_exit;
|
|
}
|
|
}
|
|
|
|
return 0;
|
|
|
|
error_exit:
|
|
return ret;
|
|
}
|
|
|
|
static int ltc294x_read_charge_register(const struct ltc294x_info *info)
|
|
{
|
|
int ret;
|
|
u8 datar[2];
|
|
|
|
ret = ltc294x_read_regs(info->client,
|
|
LTC294X_REG_ACC_CHARGE_MSB, &datar[0], 2);
|
|
if (ret < 0)
|
|
return ret;
|
|
return (datar[0] << 8) + datar[1];
|
|
}
|
|
|
|
static int ltc294x_get_charge_now(const struct ltc294x_info *info, int *val)
|
|
{
|
|
int value = ltc294x_read_charge_register(info);
|
|
|
|
if (value < 0)
|
|
return value;
|
|
/* When r_sense < 0, this counts up when the battery discharges */
|
|
if (info->Qlsb < 0)
|
|
value -= 0xFFFF;
|
|
*val = convert_bin_to_uAh(info, value);
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_set_charge_now(const struct ltc294x_info *info, int val)
|
|
{
|
|
int ret;
|
|
u8 dataw[2];
|
|
u8 ctrl_reg;
|
|
s32 value;
|
|
|
|
value = convert_uAh_to_bin(info, val);
|
|
/* Direction depends on how sense+/- were connected */
|
|
if (info->Qlsb < 0)
|
|
value += 0xFFFF;
|
|
if ((value < 0) || (value > 0xFFFF)) /* input validation */
|
|
return -EINVAL;
|
|
|
|
/* Read control register */
|
|
ret = ltc294x_read_regs(info->client,
|
|
LTC294X_REG_CONTROL, &ctrl_reg, 1);
|
|
if (ret < 0)
|
|
return ret;
|
|
/* Disable analog section */
|
|
ctrl_reg |= LTC294X_REG_CONTROL_SHUTDOWN_MASK;
|
|
ret = ltc294x_write_regs(info->client,
|
|
LTC294X_REG_CONTROL, &ctrl_reg, 1);
|
|
if (ret < 0)
|
|
return ret;
|
|
/* Set new charge value */
|
|
dataw[0] = I16_MSB(value);
|
|
dataw[1] = I16_LSB(value);
|
|
ret = ltc294x_write_regs(info->client,
|
|
LTC294X_REG_ACC_CHARGE_MSB, &dataw[0], 2);
|
|
if (ret < 0)
|
|
goto error_exit;
|
|
/* Enable analog section */
|
|
error_exit:
|
|
ctrl_reg &= ~LTC294X_REG_CONTROL_SHUTDOWN_MASK;
|
|
ret = ltc294x_write_regs(info->client,
|
|
LTC294X_REG_CONTROL, &ctrl_reg, 1);
|
|
|
|
return ret < 0 ? ret : 0;
|
|
}
|
|
|
|
static int ltc294x_get_charge_counter(
|
|
const struct ltc294x_info *info, int *val)
|
|
{
|
|
int value = ltc294x_read_charge_register(info);
|
|
|
|
if (value < 0)
|
|
return value;
|
|
value -= LTC294X_MID_SUPPLY;
|
|
*val = convert_bin_to_uAh(info, value);
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_get_voltage(const struct ltc294x_info *info, int *val)
|
|
{
|
|
int ret;
|
|
u8 datar[2];
|
|
u32 value;
|
|
|
|
ret = ltc294x_read_regs(info->client,
|
|
LTC294X_REG_VOLTAGE_MSB, &datar[0], 2);
|
|
value = (datar[0] << 8) | datar[1];
|
|
*val = ((value * 23600) / 0xFFFF) * 1000; /* in uV */
|
|
return ret;
|
|
}
|
|
|
|
static int ltc294x_get_current(const struct ltc294x_info *info, int *val)
|
|
{
|
|
int ret;
|
|
u8 datar[2];
|
|
s32 value;
|
|
|
|
ret = ltc294x_read_regs(info->client,
|
|
LTC294X_REG_CURRENT_MSB, &datar[0], 2);
|
|
value = (datar[0] << 8) | datar[1];
|
|
value -= 0x7FFF;
|
|
/* Value is in range -32k..+32k, r_sense is usually 10..50 mOhm,
|
|
* the formula below keeps everything in s32 range while preserving
|
|
* enough digits */
|
|
*val = 1000 * ((60000 * value) / (info->r_sense * 0x7FFF)); /* in uA */
|
|
return ret;
|
|
}
|
|
|
|
static int ltc294x_get_temperature(const struct ltc294x_info *info, int *val)
|
|
{
|
|
int ret;
|
|
u8 datar[2];
|
|
u32 value;
|
|
|
|
ret = ltc294x_read_regs(info->client,
|
|
LTC294X_REG_TEMPERATURE_MSB, &datar[0], 2);
|
|
value = (datar[0] << 8) | datar[1];
|
|
/* Full-scale is 510 Kelvin, convert to centidegrees */
|
|
*val = (((51000 * value) / 0xFFFF) - 27215);
|
|
return ret;
|
|
}
|
|
|
|
static int ltc294x_get_property(struct power_supply *psy,
|
|
enum power_supply_property prop,
|
|
union power_supply_propval *val)
|
|
{
|
|
struct ltc294x_info *info = power_supply_get_drvdata(psy);
|
|
|
|
switch (prop) {
|
|
case POWER_SUPPLY_PROP_CHARGE_NOW:
|
|
return ltc294x_get_charge_now(info, &val->intval);
|
|
case POWER_SUPPLY_PROP_CHARGE_COUNTER:
|
|
return ltc294x_get_charge_counter(info, &val->intval);
|
|
case POWER_SUPPLY_PROP_VOLTAGE_NOW:
|
|
return ltc294x_get_voltage(info, &val->intval);
|
|
case POWER_SUPPLY_PROP_CURRENT_NOW:
|
|
return ltc294x_get_current(info, &val->intval);
|
|
case POWER_SUPPLY_PROP_TEMP:
|
|
return ltc294x_get_temperature(info, &val->intval);
|
|
default:
|
|
return -EINVAL;
|
|
}
|
|
}
|
|
|
|
static int ltc294x_set_property(struct power_supply *psy,
|
|
enum power_supply_property psp,
|
|
const union power_supply_propval *val)
|
|
{
|
|
struct ltc294x_info *info = power_supply_get_drvdata(psy);
|
|
|
|
switch (psp) {
|
|
case POWER_SUPPLY_PROP_CHARGE_NOW:
|
|
return ltc294x_set_charge_now(info, val->intval);
|
|
default:
|
|
return -EPERM;
|
|
}
|
|
}
|
|
|
|
static int ltc294x_property_is_writeable(
|
|
struct power_supply *psy, enum power_supply_property psp)
|
|
{
|
|
switch (psp) {
|
|
case POWER_SUPPLY_PROP_CHARGE_NOW:
|
|
return 1;
|
|
default:
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
static void ltc294x_update(struct ltc294x_info *info)
|
|
{
|
|
int charge = ltc294x_read_charge_register(info);
|
|
|
|
if (charge != info->charge) {
|
|
info->charge = charge;
|
|
power_supply_changed(info->supply);
|
|
}
|
|
}
|
|
|
|
static void ltc294x_work(struct work_struct *work)
|
|
{
|
|
struct ltc294x_info *info;
|
|
|
|
info = container_of(work, struct ltc294x_info, work.work);
|
|
ltc294x_update(info);
|
|
schedule_delayed_work(&info->work, LTC294X_WORK_DELAY * HZ);
|
|
}
|
|
|
|
static enum power_supply_property ltc294x_properties[] = {
|
|
POWER_SUPPLY_PROP_CHARGE_COUNTER,
|
|
POWER_SUPPLY_PROP_CHARGE_NOW,
|
|
POWER_SUPPLY_PROP_VOLTAGE_NOW,
|
|
POWER_SUPPLY_PROP_CURRENT_NOW,
|
|
POWER_SUPPLY_PROP_TEMP,
|
|
};
|
|
|
|
static int ltc294x_i2c_remove(struct i2c_client *client)
|
|
{
|
|
struct ltc294x_info *info = i2c_get_clientdata(client);
|
|
|
|
cancel_delayed_work(&info->work);
|
|
power_supply_unregister(info->supply);
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_i2c_probe(struct i2c_client *client,
|
|
const struct i2c_device_id *id)
|
|
{
|
|
struct power_supply_config psy_cfg = {};
|
|
struct ltc294x_info *info;
|
|
int ret;
|
|
u32 prescaler_exp;
|
|
s32 r_sense;
|
|
struct device_node *np;
|
|
|
|
info = devm_kzalloc(&client->dev, sizeof(*info), GFP_KERNEL);
|
|
if (info == NULL)
|
|
return -ENOMEM;
|
|
|
|
i2c_set_clientdata(client, info);
|
|
|
|
np = of_node_get(client->dev.of_node);
|
|
|
|
info->num_regs = id->driver_data;
|
|
info->supply_desc.name = np->name;
|
|
|
|
/* r_sense can be negative, when sense+ is connected to the battery
|
|
* instead of the sense-. This results in reversed measurements. */
|
|
ret = of_property_read_u32(np, "lltc,resistor-sense", &r_sense);
|
|
if (ret < 0) {
|
|
dev_err(&client->dev,
|
|
"Could not find lltc,resistor-sense in devicetree\n");
|
|
return ret;
|
|
}
|
|
info->r_sense = r_sense;
|
|
|
|
ret = of_property_read_u32(np, "lltc,prescaler-exponent",
|
|
&prescaler_exp);
|
|
if (ret < 0) {
|
|
dev_warn(&client->dev,
|
|
"lltc,prescaler-exponent not in devicetree\n");
|
|
prescaler_exp = LTC2941_MAX_PRESCALER_EXP;
|
|
}
|
|
|
|
if (info->num_regs == LTC2943_NUM_REGS) {
|
|
if (prescaler_exp > LTC2943_MAX_PRESCALER_EXP)
|
|
prescaler_exp = LTC2943_MAX_PRESCALER_EXP;
|
|
info->Qlsb = ((340 * 50000) / r_sense) /
|
|
(4096 / (1 << (2*prescaler_exp)));
|
|
} else {
|
|
if (prescaler_exp > LTC2941_MAX_PRESCALER_EXP)
|
|
prescaler_exp = LTC2941_MAX_PRESCALER_EXP;
|
|
info->Qlsb = ((85 * 50000) / r_sense) /
|
|
(128 / (1 << prescaler_exp));
|
|
}
|
|
|
|
info->client = client;
|
|
info->supply_desc.type = POWER_SUPPLY_TYPE_BATTERY;
|
|
info->supply_desc.properties = ltc294x_properties;
|
|
if (info->num_regs >= LTC294X_REG_TEMPERATURE_LSB)
|
|
info->supply_desc.num_properties =
|
|
ARRAY_SIZE(ltc294x_properties);
|
|
else if (info->num_regs >= LTC294X_REG_CURRENT_LSB)
|
|
info->supply_desc.num_properties =
|
|
ARRAY_SIZE(ltc294x_properties) - 1;
|
|
else if (info->num_regs >= LTC294X_REG_VOLTAGE_LSB)
|
|
info->supply_desc.num_properties =
|
|
ARRAY_SIZE(ltc294x_properties) - 2;
|
|
else
|
|
info->supply_desc.num_properties =
|
|
ARRAY_SIZE(ltc294x_properties) - 3;
|
|
info->supply_desc.get_property = ltc294x_get_property;
|
|
info->supply_desc.set_property = ltc294x_set_property;
|
|
info->supply_desc.property_is_writeable = ltc294x_property_is_writeable;
|
|
info->supply_desc.external_power_changed = NULL;
|
|
|
|
psy_cfg.drv_data = info;
|
|
|
|
INIT_DELAYED_WORK(&info->work, ltc294x_work);
|
|
|
|
ret = ltc294x_reset(info, prescaler_exp);
|
|
if (ret < 0) {
|
|
dev_err(&client->dev, "Communication with chip failed\n");
|
|
return ret;
|
|
}
|
|
|
|
info->supply = power_supply_register(&client->dev, &info->supply_desc,
|
|
&psy_cfg);
|
|
if (IS_ERR(info->supply)) {
|
|
dev_err(&client->dev, "failed to register ltc2941\n");
|
|
return PTR_ERR(info->supply);
|
|
} else {
|
|
schedule_delayed_work(&info->work, LTC294X_WORK_DELAY * HZ);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
#ifdef CONFIG_PM_SLEEP
|
|
|
|
static int ltc294x_suspend(struct device *dev)
|
|
{
|
|
struct i2c_client *client = to_i2c_client(dev);
|
|
struct ltc294x_info *info = i2c_get_clientdata(client);
|
|
|
|
cancel_delayed_work(&info->work);
|
|
return 0;
|
|
}
|
|
|
|
static int ltc294x_resume(struct device *dev)
|
|
{
|
|
struct i2c_client *client = to_i2c_client(dev);
|
|
struct ltc294x_info *info = i2c_get_clientdata(client);
|
|
|
|
schedule_delayed_work(&info->work, LTC294X_WORK_DELAY * HZ);
|
|
return 0;
|
|
}
|
|
|
|
static SIMPLE_DEV_PM_OPS(ltc294x_pm_ops, ltc294x_suspend, ltc294x_resume);
|
|
#define LTC294X_PM_OPS (<c294x_pm_ops)
|
|
|
|
#else
|
|
#define LTC294X_PM_OPS NULL
|
|
#endif /* CONFIG_PM_SLEEP */
|
|
|
|
|
|
static const struct i2c_device_id ltc294x_i2c_id[] = {
|
|
{"ltc2941", LTC2941_NUM_REGS},
|
|
{"ltc2943", LTC2943_NUM_REGS},
|
|
{ },
|
|
};
|
|
MODULE_DEVICE_TABLE(i2c, ltc294x_i2c_id);
|
|
|
|
static struct i2c_driver ltc294x_driver = {
|
|
.driver = {
|
|
.name = "LTC2941",
|
|
.pm = LTC294X_PM_OPS,
|
|
},
|
|
.probe = ltc294x_i2c_probe,
|
|
.remove = ltc294x_i2c_remove,
|
|
.id_table = ltc294x_i2c_id,
|
|
};
|
|
module_i2c_driver(ltc294x_driver);
|
|
|
|
MODULE_AUTHOR("Auryn Verwegen, Topic Embedded Systems");
|
|
MODULE_AUTHOR("Mike Looijmans, Topic Embedded Products");
|
|
MODULE_DESCRIPTION("LTC2941/LTC2943 Battery Gas Gauge IC driver");
|
|
MODULE_LICENSE("GPL");
|