max17042_battery.c 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862
  1. /*
  2. * Fuel gauge driver for Maxim 17042 / 8966 / 8997
  3. * Note that Maxim 8966 and 8997 are mfd and this is its subdevice.
  4. *
  5. * Copyright (C) 2011 Samsung Electronics
  6. * MyungJoo Ham <myungjoo.ham@samsung.com>
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation; either version 2 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  21. *
  22. * This driver is based on max17040_battery.c
  23. */
  24. #include <linux/init.h>
  25. #include <linux/module.h>
  26. #include <linux/slab.h>
  27. #include <linux/i2c.h>
  28. #include <linux/delay.h>
  29. #include <linux/interrupt.h>
  30. #include <linux/pm.h>
  31. #include <linux/mod_devicetable.h>
  32. #include <linux/power_supply.h>
  33. #include <linux/power/max17042_battery.h>
  34. #include <linux/of.h>
  35. /* Status register bits */
  36. #define STATUS_POR_BIT (1 << 1)
  37. #define STATUS_BST_BIT (1 << 3)
  38. #define STATUS_VMN_BIT (1 << 8)
  39. #define STATUS_TMN_BIT (1 << 9)
  40. #define STATUS_SMN_BIT (1 << 10)
  41. #define STATUS_BI_BIT (1 << 11)
  42. #define STATUS_VMX_BIT (1 << 12)
  43. #define STATUS_TMX_BIT (1 << 13)
  44. #define STATUS_SMX_BIT (1 << 14)
  45. #define STATUS_BR_BIT (1 << 15)
  46. /* Interrupt mask bits */
  47. #define CONFIG_ALRT_BIT_ENBL (1 << 2)
  48. #define STATUS_INTR_SOCMIN_BIT (1 << 10)
  49. #define STATUS_INTR_SOCMAX_BIT (1 << 14)
  50. #define VFSOC0_LOCK 0x0000
  51. #define VFSOC0_UNLOCK 0x0080
  52. #define MODEL_UNLOCK1 0X0059
  53. #define MODEL_UNLOCK2 0X00C4
  54. #define MODEL_LOCK1 0X0000
  55. #define MODEL_LOCK2 0X0000
  56. #define dQ_ACC_DIV 0x4
  57. #define dP_ACC_100 0x1900
  58. #define dP_ACC_200 0x3200
  59. #define MAX17042_IC_VERSION 0x0092
  60. #define MAX17047_IC_VERSION 0x00AC /* same for max17050 */
  61. struct max17042_chip {
  62. struct i2c_client *client;
  63. struct power_supply battery;
  64. enum max170xx_chip_type chip_type;
  65. struct max17042_platform_data *pdata;
  66. struct work_struct work;
  67. int init_complete;
  68. };
  69. static int max17042_write_reg(struct i2c_client *client, u8 reg, u16 value)
  70. {
  71. int ret = i2c_smbus_write_word_data(client, reg, value);
  72. if (ret < 0)
  73. dev_err(&client->dev, "%s: err %d\n", __func__, ret);
  74. return ret;
  75. }
  76. static int max17042_read_reg(struct i2c_client *client, u8 reg)
  77. {
  78. int ret = i2c_smbus_read_word_data(client, reg);
  79. if (ret < 0)
  80. dev_err(&client->dev, "%s: err %d\n", __func__, ret);
  81. return ret;
  82. }
  83. static void max17042_set_reg(struct i2c_client *client,
  84. struct max17042_reg_data *data, int size)
  85. {
  86. int i;
  87. for (i = 0; i < size; i++)
  88. max17042_write_reg(client, data[i].addr, data[i].data);
  89. }
  90. static enum power_supply_property max17042_battery_props[] = {
  91. POWER_SUPPLY_PROP_PRESENT,
  92. POWER_SUPPLY_PROP_CYCLE_COUNT,
  93. POWER_SUPPLY_PROP_VOLTAGE_MAX,
  94. POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
  95. POWER_SUPPLY_PROP_VOLTAGE_NOW,
  96. POWER_SUPPLY_PROP_VOLTAGE_AVG,
  97. POWER_SUPPLY_PROP_VOLTAGE_OCV,
  98. POWER_SUPPLY_PROP_CAPACITY,
  99. POWER_SUPPLY_PROP_CHARGE_FULL,
  100. POWER_SUPPLY_PROP_CHARGE_COUNTER,
  101. POWER_SUPPLY_PROP_TEMP,
  102. POWER_SUPPLY_PROP_CURRENT_NOW,
  103. POWER_SUPPLY_PROP_CURRENT_AVG,
  104. };
  105. static int max17042_get_property(struct power_supply *psy,
  106. enum power_supply_property psp,
  107. union power_supply_propval *val)
  108. {
  109. struct max17042_chip *chip = container_of(psy,
  110. struct max17042_chip, battery);
  111. int ret;
  112. if (!chip->init_complete)
  113. return -EAGAIN;
  114. switch (psp) {
  115. case POWER_SUPPLY_PROP_PRESENT:
  116. ret = max17042_read_reg(chip->client, MAX17042_STATUS);
  117. if (ret < 0)
  118. return ret;
  119. if (ret & MAX17042_STATUS_BattAbsent)
  120. val->intval = 0;
  121. else
  122. val->intval = 1;
  123. break;
  124. case POWER_SUPPLY_PROP_CYCLE_COUNT:
  125. ret = max17042_read_reg(chip->client, MAX17042_Cycles);
  126. if (ret < 0)
  127. return ret;
  128. val->intval = ret;
  129. break;
  130. case POWER_SUPPLY_PROP_VOLTAGE_MAX:
  131. ret = max17042_read_reg(chip->client, MAX17042_MinMaxVolt);
  132. if (ret < 0)
  133. return ret;
  134. val->intval = ret >> 8;
  135. val->intval *= 20000; /* Units of LSB = 20mV */
  136. break;
  137. case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
  138. if (chip->chip_type == MAX17042)
  139. ret = max17042_read_reg(chip->client, MAX17042_V_empty);
  140. else
  141. ret = max17042_read_reg(chip->client, MAX17047_V_empty);
  142. if (ret < 0)
  143. return ret;
  144. val->intval = ret >> 7;
  145. val->intval *= 10000; /* Units of LSB = 10mV */
  146. break;
  147. case POWER_SUPPLY_PROP_VOLTAGE_NOW:
  148. ret = max17042_read_reg(chip->client, MAX17042_VCELL);
  149. if (ret < 0)
  150. return ret;
  151. val->intval = ret * 625 / 8;
  152. break;
  153. case POWER_SUPPLY_PROP_VOLTAGE_AVG:
  154. ret = max17042_read_reg(chip->client, MAX17042_AvgVCELL);
  155. if (ret < 0)
  156. return ret;
  157. val->intval = ret * 625 / 8;
  158. break;
  159. case POWER_SUPPLY_PROP_VOLTAGE_OCV:
  160. ret = max17042_read_reg(chip->client, MAX17042_OCVInternal);
  161. if (ret < 0)
  162. return ret;
  163. val->intval = ret * 625 / 8;
  164. break;
  165. case POWER_SUPPLY_PROP_CAPACITY:
  166. ret = max17042_read_reg(chip->client, MAX17042_RepSOC);
  167. if (ret < 0)
  168. return ret;
  169. val->intval = ret >> 8;
  170. break;
  171. case POWER_SUPPLY_PROP_CHARGE_FULL:
  172. ret = max17042_read_reg(chip->client, MAX17042_FullCAP);
  173. if (ret < 0)
  174. return ret;
  175. val->intval = ret * 1000 / 2;
  176. break;
  177. case POWER_SUPPLY_PROP_CHARGE_COUNTER:
  178. ret = max17042_read_reg(chip->client, MAX17042_QH);
  179. if (ret < 0)
  180. return ret;
  181. val->intval = ret * 1000 / 2;
  182. break;
  183. case POWER_SUPPLY_PROP_TEMP:
  184. ret = max17042_read_reg(chip->client, MAX17042_TEMP);
  185. if (ret < 0)
  186. return ret;
  187. val->intval = ret;
  188. /* The value is signed. */
  189. if (val->intval & 0x8000) {
  190. val->intval = (0x7fff & ~val->intval) + 1;
  191. val->intval *= -1;
  192. }
  193. /* The value is converted into deci-centigrade scale */
  194. /* Units of LSB = 1 / 256 degree Celsius */
  195. val->intval = val->intval * 10 / 256;
  196. break;
  197. case POWER_SUPPLY_PROP_CURRENT_NOW:
  198. if (chip->pdata->enable_current_sense) {
  199. ret = max17042_read_reg(chip->client, MAX17042_Current);
  200. if (ret < 0)
  201. return ret;
  202. val->intval = ret;
  203. if (val->intval & 0x8000) {
  204. /* Negative */
  205. val->intval = ~val->intval & 0x7fff;
  206. val->intval++;
  207. val->intval *= -1;
  208. }
  209. val->intval *= 1562500 / chip->pdata->r_sns;
  210. } else {
  211. return -EINVAL;
  212. }
  213. break;
  214. case POWER_SUPPLY_PROP_CURRENT_AVG:
  215. if (chip->pdata->enable_current_sense) {
  216. ret = max17042_read_reg(chip->client,
  217. MAX17042_AvgCurrent);
  218. if (ret < 0)
  219. return ret;
  220. val->intval = ret;
  221. if (val->intval & 0x8000) {
  222. /* Negative */
  223. val->intval = ~val->intval & 0x7fff;
  224. val->intval++;
  225. val->intval *= -1;
  226. }
  227. val->intval *= 1562500 / chip->pdata->r_sns;
  228. } else {
  229. return -EINVAL;
  230. }
  231. break;
  232. default:
  233. return -EINVAL;
  234. }
  235. return 0;
  236. }
  237. static int max17042_write_verify_reg(struct i2c_client *client,
  238. u8 reg, u16 value)
  239. {
  240. int retries = 8;
  241. int ret;
  242. u16 read_value;
  243. do {
  244. ret = i2c_smbus_write_word_data(client, reg, value);
  245. read_value = max17042_read_reg(client, reg);
  246. if (read_value != value) {
  247. ret = -EIO;
  248. retries--;
  249. }
  250. } while (retries && read_value != value);
  251. if (ret < 0)
  252. dev_err(&client->dev, "%s: err %d\n", __func__, ret);
  253. return ret;
  254. }
  255. static inline void max17042_override_por(
  256. struct i2c_client *client, u8 reg, u16 value)
  257. {
  258. if (value)
  259. max17042_write_reg(client, reg, value);
  260. }
  261. static inline void max10742_unlock_model(struct max17042_chip *chip)
  262. {
  263. struct i2c_client *client = chip->client;
  264. max17042_write_reg(client, MAX17042_MLOCKReg1, MODEL_UNLOCK1);
  265. max17042_write_reg(client, MAX17042_MLOCKReg2, MODEL_UNLOCK2);
  266. }
  267. static inline void max10742_lock_model(struct max17042_chip *chip)
  268. {
  269. struct i2c_client *client = chip->client;
  270. max17042_write_reg(client, MAX17042_MLOCKReg1, MODEL_LOCK1);
  271. max17042_write_reg(client, MAX17042_MLOCKReg2, MODEL_LOCK2);
  272. }
  273. static inline void max17042_write_model_data(struct max17042_chip *chip,
  274. u8 addr, int size)
  275. {
  276. struct i2c_client *client = chip->client;
  277. int i;
  278. for (i = 0; i < size; i++)
  279. max17042_write_reg(client, addr + i,
  280. chip->pdata->config_data->cell_char_tbl[i]);
  281. }
  282. static inline void max17042_read_model_data(struct max17042_chip *chip,
  283. u8 addr, u16 *data, int size)
  284. {
  285. struct i2c_client *client = chip->client;
  286. int i;
  287. for (i = 0; i < size; i++)
  288. data[i] = max17042_read_reg(client, addr + i);
  289. }
  290. static inline int max17042_model_data_compare(struct max17042_chip *chip,
  291. u16 *data1, u16 *data2, int size)
  292. {
  293. int i;
  294. if (memcmp(data1, data2, size)) {
  295. dev_err(&chip->client->dev, "%s compare failed\n", __func__);
  296. for (i = 0; i < size; i++)
  297. dev_info(&chip->client->dev, "0x%x, 0x%x",
  298. data1[i], data2[i]);
  299. dev_info(&chip->client->dev, "\n");
  300. return -EINVAL;
  301. }
  302. return 0;
  303. }
  304. static int max17042_init_model(struct max17042_chip *chip)
  305. {
  306. int ret;
  307. int table_size = ARRAY_SIZE(chip->pdata->config_data->cell_char_tbl);
  308. u16 *temp_data;
  309. temp_data = kcalloc(table_size, sizeof(*temp_data), GFP_KERNEL);
  310. if (!temp_data)
  311. return -ENOMEM;
  312. max10742_unlock_model(chip);
  313. max17042_write_model_data(chip, MAX17042_MODELChrTbl,
  314. table_size);
  315. max17042_read_model_data(chip, MAX17042_MODELChrTbl, temp_data,
  316. table_size);
  317. ret = max17042_model_data_compare(
  318. chip,
  319. chip->pdata->config_data->cell_char_tbl,
  320. temp_data,
  321. table_size);
  322. max10742_lock_model(chip);
  323. kfree(temp_data);
  324. return ret;
  325. }
  326. static int max17042_verify_model_lock(struct max17042_chip *chip)
  327. {
  328. int i;
  329. int table_size = ARRAY_SIZE(chip->pdata->config_data->cell_char_tbl);
  330. u16 *temp_data;
  331. int ret = 0;
  332. temp_data = kcalloc(table_size, sizeof(*temp_data), GFP_KERNEL);
  333. if (!temp_data)
  334. return -ENOMEM;
  335. max17042_read_model_data(chip, MAX17042_MODELChrTbl, temp_data,
  336. table_size);
  337. for (i = 0; i < table_size; i++)
  338. if (temp_data[i])
  339. ret = -EINVAL;
  340. kfree(temp_data);
  341. return ret;
  342. }
  343. static void max17042_write_config_regs(struct max17042_chip *chip)
  344. {
  345. struct max17042_config_data *config = chip->pdata->config_data;
  346. max17042_write_reg(chip->client, MAX17042_CONFIG, config->config);
  347. max17042_write_reg(chip->client, MAX17042_LearnCFG, config->learn_cfg);
  348. max17042_write_reg(chip->client, MAX17042_FilterCFG,
  349. config->filter_cfg);
  350. max17042_write_reg(chip->client, MAX17042_RelaxCFG, config->relax_cfg);
  351. if (chip->chip_type == MAX17047)
  352. max17042_write_reg(chip->client, MAX17047_FullSOCThr,
  353. config->full_soc_thresh);
  354. }
  355. static void max17042_write_custom_regs(struct max17042_chip *chip)
  356. {
  357. struct max17042_config_data *config = chip->pdata->config_data;
  358. max17042_write_verify_reg(chip->client, MAX17042_RCOMP0,
  359. config->rcomp0);
  360. max17042_write_verify_reg(chip->client, MAX17042_TempCo,
  361. config->tcompc0);
  362. max17042_write_verify_reg(chip->client, MAX17042_ICHGTerm,
  363. config->ichgt_term);
  364. if (chip->chip_type == MAX17042) {
  365. max17042_write_reg(chip->client, MAX17042_EmptyTempCo,
  366. config->empty_tempco);
  367. max17042_write_verify_reg(chip->client, MAX17042_K_empty0,
  368. config->kempty0);
  369. } else {
  370. max17042_write_verify_reg(chip->client, MAX17047_QRTbl00,
  371. config->qrtbl00);
  372. max17042_write_verify_reg(chip->client, MAX17047_QRTbl10,
  373. config->qrtbl10);
  374. max17042_write_verify_reg(chip->client, MAX17047_QRTbl20,
  375. config->qrtbl20);
  376. max17042_write_verify_reg(chip->client, MAX17047_QRTbl30,
  377. config->qrtbl30);
  378. }
  379. }
  380. static void max17042_update_capacity_regs(struct max17042_chip *chip)
  381. {
  382. struct max17042_config_data *config = chip->pdata->config_data;
  383. max17042_write_verify_reg(chip->client, MAX17042_FullCAP,
  384. config->fullcap);
  385. max17042_write_reg(chip->client, MAX17042_DesignCap,
  386. config->design_cap);
  387. max17042_write_verify_reg(chip->client, MAX17042_FullCAPNom,
  388. config->fullcapnom);
  389. }
  390. static void max17042_reset_vfsoc0_reg(struct max17042_chip *chip)
  391. {
  392. u16 vfSoc;
  393. vfSoc = max17042_read_reg(chip->client, MAX17042_VFSOC);
  394. max17042_write_reg(chip->client, MAX17042_VFSOC0Enable, VFSOC0_UNLOCK);
  395. max17042_write_verify_reg(chip->client, MAX17042_VFSOC0, vfSoc);
  396. max17042_write_reg(chip->client, MAX17042_VFSOC0Enable, VFSOC0_LOCK);
  397. }
  398. static void max17042_load_new_capacity_params(struct max17042_chip *chip)
  399. {
  400. u16 full_cap0, rep_cap, dq_acc, vfSoc;
  401. u32 rem_cap;
  402. struct max17042_config_data *config = chip->pdata->config_data;
  403. full_cap0 = max17042_read_reg(chip->client, MAX17042_FullCAP0);
  404. vfSoc = max17042_read_reg(chip->client, MAX17042_VFSOC);
  405. /* fg_vfSoc needs to shifted by 8 bits to get the
  406. * perc in 1% accuracy, to get the right rem_cap multiply
  407. * full_cap0, fg_vfSoc and devide by 100
  408. */
  409. rem_cap = ((vfSoc >> 8) * full_cap0) / 100;
  410. max17042_write_verify_reg(chip->client, MAX17042_RemCap, (u16)rem_cap);
  411. rep_cap = (u16)rem_cap;
  412. max17042_write_verify_reg(chip->client, MAX17042_RepCap, rep_cap);
  413. /* Write dQ_acc to 200% of Capacity and dP_acc to 200% */
  414. dq_acc = config->fullcap / dQ_ACC_DIV;
  415. max17042_write_verify_reg(chip->client, MAX17042_dQacc, dq_acc);
  416. max17042_write_verify_reg(chip->client, MAX17042_dPacc, dP_ACC_200);
  417. max17042_write_verify_reg(chip->client, MAX17042_FullCAP,
  418. config->fullcap);
  419. max17042_write_reg(chip->client, MAX17042_DesignCap,
  420. config->design_cap);
  421. max17042_write_verify_reg(chip->client, MAX17042_FullCAPNom,
  422. config->fullcapnom);
  423. /* Update SOC register with new SOC */
  424. max17042_write_reg(chip->client, MAX17042_RepSOC, vfSoc);
  425. }
  426. /*
  427. * Block write all the override values coming from platform data.
  428. * This function MUST be called before the POR initialization proceedure
  429. * specified by maxim.
  430. */
  431. static inline void max17042_override_por_values(struct max17042_chip *chip)
  432. {
  433. struct i2c_client *client = chip->client;
  434. struct max17042_config_data *config = chip->pdata->config_data;
  435. max17042_override_por(client, MAX17042_TGAIN, config->tgain);
  436. max17042_override_por(client, MAx17042_TOFF, config->toff);
  437. max17042_override_por(client, MAX17042_CGAIN, config->cgain);
  438. max17042_override_por(client, MAX17042_COFF, config->coff);
  439. max17042_override_por(client, MAX17042_VALRT_Th, config->valrt_thresh);
  440. max17042_override_por(client, MAX17042_TALRT_Th, config->talrt_thresh);
  441. max17042_override_por(client, MAX17042_SALRT_Th,
  442. config->soc_alrt_thresh);
  443. max17042_override_por(client, MAX17042_CONFIG, config->config);
  444. max17042_override_por(client, MAX17042_SHDNTIMER, config->shdntimer);
  445. max17042_override_por(client, MAX17042_DesignCap, config->design_cap);
  446. max17042_override_por(client, MAX17042_ICHGTerm, config->ichgt_term);
  447. max17042_override_por(client, MAX17042_AtRate, config->at_rate);
  448. max17042_override_por(client, MAX17042_LearnCFG, config->learn_cfg);
  449. max17042_override_por(client, MAX17042_FilterCFG, config->filter_cfg);
  450. max17042_override_por(client, MAX17042_RelaxCFG, config->relax_cfg);
  451. max17042_override_por(client, MAX17042_MiscCFG, config->misc_cfg);
  452. max17042_override_por(client, MAX17042_MaskSOC, config->masksoc);
  453. max17042_override_por(client, MAX17042_FullCAP, config->fullcap);
  454. max17042_override_por(client, MAX17042_FullCAPNom, config->fullcapnom);
  455. if (chip->chip_type == MAX17042)
  456. max17042_override_por(client, MAX17042_SOC_empty,
  457. config->socempty);
  458. max17042_override_por(client, MAX17042_LAvg_empty, config->lavg_empty);
  459. max17042_override_por(client, MAX17042_dQacc, config->dqacc);
  460. max17042_override_por(client, MAX17042_dPacc, config->dpacc);
  461. if (chip->chip_type == MAX17042)
  462. max17042_override_por(client, MAX17042_V_empty, config->vempty);
  463. else
  464. max17042_override_por(client, MAX17047_V_empty, config->vempty);
  465. max17042_override_por(client, MAX17042_TempNom, config->temp_nom);
  466. max17042_override_por(client, MAX17042_TempLim, config->temp_lim);
  467. max17042_override_por(client, MAX17042_FCTC, config->fctc);
  468. max17042_override_por(client, MAX17042_RCOMP0, config->rcomp0);
  469. max17042_override_por(client, MAX17042_TempCo, config->tcompc0);
  470. if (chip->chip_type) {
  471. max17042_override_por(client, MAX17042_EmptyTempCo,
  472. config->empty_tempco);
  473. max17042_override_por(client, MAX17042_K_empty0,
  474. config->kempty0);
  475. }
  476. }
  477. static int max17042_init_chip(struct max17042_chip *chip)
  478. {
  479. int ret;
  480. int val;
  481. max17042_override_por_values(chip);
  482. /* After Power up, the MAX17042 requires 500mS in order
  483. * to perform signal debouncing and initial SOC reporting
  484. */
  485. msleep(500);
  486. /* Initialize configaration */
  487. max17042_write_config_regs(chip);
  488. /* write cell characterization data */
  489. ret = max17042_init_model(chip);
  490. if (ret) {
  491. dev_err(&chip->client->dev, "%s init failed\n",
  492. __func__);
  493. return -EIO;
  494. }
  495. ret = max17042_verify_model_lock(chip);
  496. if (ret) {
  497. dev_err(&chip->client->dev, "%s lock verify failed\n",
  498. __func__);
  499. return -EIO;
  500. }
  501. /* write custom parameters */
  502. max17042_write_custom_regs(chip);
  503. /* update capacity params */
  504. max17042_update_capacity_regs(chip);
  505. /* delay must be atleast 350mS to allow VFSOC
  506. * to be calculated from the new configuration
  507. */
  508. msleep(350);
  509. /* reset vfsoc0 reg */
  510. max17042_reset_vfsoc0_reg(chip);
  511. /* load new capacity params */
  512. max17042_load_new_capacity_params(chip);
  513. /* Init complete, Clear the POR bit */
  514. val = max17042_read_reg(chip->client, MAX17042_STATUS);
  515. max17042_write_reg(chip->client, MAX17042_STATUS,
  516. val & (~STATUS_POR_BIT));
  517. return 0;
  518. }
  519. static void max17042_set_soc_threshold(struct max17042_chip *chip, u16 off)
  520. {
  521. u16 soc, soc_tr;
  522. /* program interrupt thesholds such that we should
  523. * get interrupt for every 'off' perc change in the soc
  524. */
  525. soc = max17042_read_reg(chip->client, MAX17042_RepSOC) >> 8;
  526. soc_tr = (soc + off) << 8;
  527. soc_tr |= (soc - off);
  528. max17042_write_reg(chip->client, MAX17042_SALRT_Th, soc_tr);
  529. }
  530. static irqreturn_t max17042_thread_handler(int id, void *dev)
  531. {
  532. struct max17042_chip *chip = dev;
  533. u16 val;
  534. val = max17042_read_reg(chip->client, MAX17042_STATUS);
  535. if ((val & STATUS_INTR_SOCMIN_BIT) ||
  536. (val & STATUS_INTR_SOCMAX_BIT)) {
  537. dev_info(&chip->client->dev, "SOC threshold INTR\n");
  538. max17042_set_soc_threshold(chip, 1);
  539. }
  540. power_supply_changed(&chip->battery);
  541. return IRQ_HANDLED;
  542. }
  543. static void max17042_init_worker(struct work_struct *work)
  544. {
  545. struct max17042_chip *chip = container_of(work,
  546. struct max17042_chip, work);
  547. int ret;
  548. /* Initialize registers according to values from the platform data */
  549. if (chip->pdata->enable_por_init && chip->pdata->config_data) {
  550. ret = max17042_init_chip(chip);
  551. if (ret)
  552. return;
  553. }
  554. chip->init_complete = 1;
  555. }
  556. #ifdef CONFIG_OF
  557. static struct max17042_platform_data *
  558. max17042_get_pdata(struct device *dev)
  559. {
  560. struct device_node *np = dev->of_node;
  561. u32 prop;
  562. struct max17042_platform_data *pdata;
  563. if (!np)
  564. return dev->platform_data;
  565. pdata = devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL);
  566. if (!pdata)
  567. return NULL;
  568. /*
  569. * Require current sense resistor value to be specified for
  570. * current-sense functionality to be enabled at all.
  571. */
  572. if (of_property_read_u32(np, "maxim,rsns-microohm", &prop) == 0) {
  573. pdata->r_sns = prop;
  574. pdata->enable_current_sense = true;
  575. }
  576. return pdata;
  577. }
  578. #else
  579. static struct max17042_platform_data *
  580. max17042_get_pdata(struct device *dev)
  581. {
  582. return dev->platform_data;
  583. }
  584. #endif
  585. static int max17042_probe(struct i2c_client *client,
  586. const struct i2c_device_id *id)
  587. {
  588. struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
  589. struct max17042_chip *chip;
  590. int ret;
  591. int reg;
  592. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA))
  593. return -EIO;
  594. chip = devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL);
  595. if (!chip)
  596. return -ENOMEM;
  597. chip->client = client;
  598. chip->pdata = max17042_get_pdata(&client->dev);
  599. if (!chip->pdata) {
  600. dev_err(&client->dev, "no platform data provided\n");
  601. return -EINVAL;
  602. }
  603. i2c_set_clientdata(client, chip);
  604. ret = max17042_read_reg(chip->client, MAX17042_DevName);
  605. if (ret == MAX17042_IC_VERSION) {
  606. dev_dbg(&client->dev, "chip type max17042 detected\n");
  607. chip->chip_type = MAX17042;
  608. } else if (ret == MAX17047_IC_VERSION) {
  609. dev_dbg(&client->dev, "chip type max17047/50 detected\n");
  610. chip->chip_type = MAX17047;
  611. } else {
  612. dev_err(&client->dev, "device version mismatch: %x\n", ret);
  613. return -EIO;
  614. }
  615. chip->battery.name = "max170xx_battery";
  616. chip->battery.type = POWER_SUPPLY_TYPE_BATTERY;
  617. chip->battery.get_property = max17042_get_property;
  618. chip->battery.properties = max17042_battery_props;
  619. chip->battery.num_properties = ARRAY_SIZE(max17042_battery_props);
  620. /* When current is not measured,
  621. * CURRENT_NOW and CURRENT_AVG properties should be invisible. */
  622. if (!chip->pdata->enable_current_sense)
  623. chip->battery.num_properties -= 2;
  624. if (chip->pdata->r_sns == 0)
  625. chip->pdata->r_sns = MAX17042_DEFAULT_SNS_RESISTOR;
  626. if (chip->pdata->init_data)
  627. max17042_set_reg(client, chip->pdata->init_data,
  628. chip->pdata->num_init_data);
  629. if (!chip->pdata->enable_current_sense) {
  630. max17042_write_reg(client, MAX17042_CGAIN, 0x0000);
  631. max17042_write_reg(client, MAX17042_MiscCFG, 0x0003);
  632. max17042_write_reg(client, MAX17042_LearnCFG, 0x0007);
  633. }
  634. ret = power_supply_register(&client->dev, &chip->battery);
  635. if (ret) {
  636. dev_err(&client->dev, "failed: power supply register\n");
  637. return ret;
  638. }
  639. if (client->irq) {
  640. ret = request_threaded_irq(client->irq, NULL,
  641. max17042_thread_handler,
  642. IRQF_TRIGGER_FALLING,
  643. chip->battery.name, chip);
  644. if (!ret) {
  645. reg = max17042_read_reg(client, MAX17042_CONFIG);
  646. reg |= CONFIG_ALRT_BIT_ENBL;
  647. max17042_write_reg(client, MAX17042_CONFIG, reg);
  648. max17042_set_soc_threshold(chip, 1);
  649. } else {
  650. client->irq = 0;
  651. dev_err(&client->dev, "%s(): cannot get IRQ\n",
  652. __func__);
  653. }
  654. }
  655. reg = max17042_read_reg(chip->client, MAX17042_STATUS);
  656. if (reg & STATUS_POR_BIT) {
  657. INIT_WORK(&chip->work, max17042_init_worker);
  658. schedule_work(&chip->work);
  659. } else {
  660. chip->init_complete = 1;
  661. }
  662. return 0;
  663. }
  664. static int max17042_remove(struct i2c_client *client)
  665. {
  666. struct max17042_chip *chip = i2c_get_clientdata(client);
  667. if (client->irq)
  668. free_irq(client->irq, chip);
  669. power_supply_unregister(&chip->battery);
  670. return 0;
  671. }
  672. #ifdef CONFIG_PM
  673. static int max17042_suspend(struct device *dev)
  674. {
  675. struct max17042_chip *chip = dev_get_drvdata(dev);
  676. /*
  677. * disable the irq and enable irq_wake
  678. * capability to the interrupt line.
  679. */
  680. if (chip->client->irq) {
  681. disable_irq(chip->client->irq);
  682. enable_irq_wake(chip->client->irq);
  683. }
  684. return 0;
  685. }
  686. static int max17042_resume(struct device *dev)
  687. {
  688. struct max17042_chip *chip = dev_get_drvdata(dev);
  689. if (chip->client->irq) {
  690. disable_irq_wake(chip->client->irq);
  691. enable_irq(chip->client->irq);
  692. /* re-program the SOC thresholds to 1% change */
  693. max17042_set_soc_threshold(chip, 1);
  694. }
  695. return 0;
  696. }
  697. static const struct dev_pm_ops max17042_pm_ops = {
  698. .suspend = max17042_suspend,
  699. .resume = max17042_resume,
  700. };
  701. #define MAX17042_PM_OPS (&max17042_pm_ops)
  702. #else
  703. #define MAX17042_PM_OPS NULL
  704. #endif
  705. #ifdef CONFIG_OF
  706. static const struct of_device_id max17042_dt_match[] = {
  707. { .compatible = "maxim,max17042" },
  708. { .compatible = "maxim,max17047" },
  709. { .compatible = "maxim,max17050" },
  710. { },
  711. };
  712. MODULE_DEVICE_TABLE(of, max17042_dt_match);
  713. #endif
  714. static const struct i2c_device_id max17042_id[] = {
  715. { "max17042", 0 },
  716. { "max17047", 1 },
  717. { "max17050", 2 },
  718. { }
  719. };
  720. MODULE_DEVICE_TABLE(i2c, max17042_id);
  721. static struct i2c_driver max17042_i2c_driver = {
  722. .driver = {
  723. .name = "max17042",
  724. .of_match_table = of_match_ptr(max17042_dt_match),
  725. .pm = MAX17042_PM_OPS,
  726. },
  727. .probe = max17042_probe,
  728. .remove = max17042_remove,
  729. .id_table = max17042_id,
  730. };
  731. module_i2c_driver(max17042_i2c_driver);
  732. MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>");
  733. MODULE_DESCRIPTION("MAX17042 Fuel Gauge");
  734. MODULE_LICENSE("GPL");