max17042_battery.c 27 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025
  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. #include <linux/regmap.h>
  36. /* Status register bits */
  37. #define STATUS_POR_BIT (1 << 1)
  38. #define STATUS_BST_BIT (1 << 3)
  39. #define STATUS_VMN_BIT (1 << 8)
  40. #define STATUS_TMN_BIT (1 << 9)
  41. #define STATUS_SMN_BIT (1 << 10)
  42. #define STATUS_BI_BIT (1 << 11)
  43. #define STATUS_VMX_BIT (1 << 12)
  44. #define STATUS_TMX_BIT (1 << 13)
  45. #define STATUS_SMX_BIT (1 << 14)
  46. #define STATUS_BR_BIT (1 << 15)
  47. /* Interrupt mask bits */
  48. #define CONFIG_ALRT_BIT_ENBL (1 << 2)
  49. #define STATUS_INTR_SOCMIN_BIT (1 << 10)
  50. #define STATUS_INTR_SOCMAX_BIT (1 << 14)
  51. #define VFSOC0_LOCK 0x0000
  52. #define VFSOC0_UNLOCK 0x0080
  53. #define MODEL_UNLOCK1 0X0059
  54. #define MODEL_UNLOCK2 0X00C4
  55. #define MODEL_LOCK1 0X0000
  56. #define MODEL_LOCK2 0X0000
  57. #define dQ_ACC_DIV 0x4
  58. #define dP_ACC_100 0x1900
  59. #define dP_ACC_200 0x3200
  60. #define MAX17042_VMAX_TOLERANCE 50 /* 50 mV */
  61. struct max17042_chip {
  62. struct i2c_client *client;
  63. struct regmap *regmap;
  64. struct power_supply *battery;
  65. enum max170xx_chip_type chip_type;
  66. struct max17042_platform_data *pdata;
  67. struct work_struct work;
  68. int init_complete;
  69. };
  70. static enum power_supply_property max17042_battery_props[] = {
  71. POWER_SUPPLY_PROP_PRESENT,
  72. POWER_SUPPLY_PROP_CYCLE_COUNT,
  73. POWER_SUPPLY_PROP_VOLTAGE_MAX,
  74. POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
  75. POWER_SUPPLY_PROP_VOLTAGE_NOW,
  76. POWER_SUPPLY_PROP_VOLTAGE_AVG,
  77. POWER_SUPPLY_PROP_VOLTAGE_OCV,
  78. POWER_SUPPLY_PROP_CAPACITY,
  79. POWER_SUPPLY_PROP_CHARGE_FULL,
  80. POWER_SUPPLY_PROP_CHARGE_COUNTER,
  81. POWER_SUPPLY_PROP_TEMP,
  82. POWER_SUPPLY_PROP_TEMP_ALERT_MIN,
  83. POWER_SUPPLY_PROP_TEMP_ALERT_MAX,
  84. POWER_SUPPLY_PROP_TEMP_MIN,
  85. POWER_SUPPLY_PROP_TEMP_MAX,
  86. POWER_SUPPLY_PROP_HEALTH,
  87. POWER_SUPPLY_PROP_CURRENT_NOW,
  88. POWER_SUPPLY_PROP_CURRENT_AVG,
  89. };
  90. static int max17042_get_temperature(struct max17042_chip *chip, int *temp)
  91. {
  92. int ret;
  93. u32 data;
  94. struct regmap *map = chip->regmap;
  95. ret = regmap_read(map, MAX17042_TEMP, &data);
  96. if (ret < 0)
  97. return ret;
  98. *temp = data;
  99. /* The value is signed. */
  100. if (*temp & 0x8000) {
  101. *temp = (0x7fff & ~*temp) + 1;
  102. *temp *= -1;
  103. }
  104. /* The value is converted into deci-centigrade scale */
  105. /* Units of LSB = 1 / 256 degree Celsius */
  106. *temp = *temp * 10 / 256;
  107. return 0;
  108. }
  109. static int max17042_get_battery_health(struct max17042_chip *chip, int *health)
  110. {
  111. int temp, vavg, vbatt, ret;
  112. u32 val;
  113. ret = regmap_read(chip->regmap, MAX17042_AvgVCELL, &val);
  114. if (ret < 0)
  115. goto health_error;
  116. /* bits [0-3] unused */
  117. vavg = val * 625 / 8;
  118. /* Convert to millivolts */
  119. vavg /= 1000;
  120. ret = regmap_read(chip->regmap, MAX17042_VCELL, &val);
  121. if (ret < 0)
  122. goto health_error;
  123. /* bits [0-3] unused */
  124. vbatt = val * 625 / 8;
  125. /* Convert to millivolts */
  126. vbatt /= 1000;
  127. if (vavg < chip->pdata->vmin) {
  128. *health = POWER_SUPPLY_HEALTH_DEAD;
  129. goto out;
  130. }
  131. if (vbatt > chip->pdata->vmax + MAX17042_VMAX_TOLERANCE) {
  132. *health = POWER_SUPPLY_HEALTH_OVERVOLTAGE;
  133. goto out;
  134. }
  135. ret = max17042_get_temperature(chip, &temp);
  136. if (ret < 0)
  137. goto health_error;
  138. if (temp <= chip->pdata->temp_min) {
  139. *health = POWER_SUPPLY_HEALTH_COLD;
  140. goto out;
  141. }
  142. if (temp >= chip->pdata->temp_max) {
  143. *health = POWER_SUPPLY_HEALTH_OVERHEAT;
  144. goto out;
  145. }
  146. *health = POWER_SUPPLY_HEALTH_GOOD;
  147. out:
  148. return 0;
  149. health_error:
  150. return ret;
  151. }
  152. static int max17042_get_property(struct power_supply *psy,
  153. enum power_supply_property psp,
  154. union power_supply_propval *val)
  155. {
  156. struct max17042_chip *chip = power_supply_get_drvdata(psy);
  157. struct regmap *map = chip->regmap;
  158. int ret;
  159. u32 data;
  160. if (!chip->init_complete)
  161. return -EAGAIN;
  162. switch (psp) {
  163. case POWER_SUPPLY_PROP_PRESENT:
  164. ret = regmap_read(map, MAX17042_STATUS, &data);
  165. if (ret < 0)
  166. return ret;
  167. if (data & MAX17042_STATUS_BattAbsent)
  168. val->intval = 0;
  169. else
  170. val->intval = 1;
  171. break;
  172. case POWER_SUPPLY_PROP_CYCLE_COUNT:
  173. ret = regmap_read(map, MAX17042_Cycles, &data);
  174. if (ret < 0)
  175. return ret;
  176. val->intval = data;
  177. break;
  178. case POWER_SUPPLY_PROP_VOLTAGE_MAX:
  179. ret = regmap_read(map, MAX17042_MinMaxVolt, &data);
  180. if (ret < 0)
  181. return ret;
  182. val->intval = data >> 8;
  183. val->intval *= 20000; /* Units of LSB = 20mV */
  184. break;
  185. case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
  186. if (chip->chip_type == MAXIM_DEVICE_TYPE_MAX17042)
  187. ret = regmap_read(map, MAX17042_V_empty, &data);
  188. else
  189. ret = regmap_read(map, MAX17047_V_empty, &data);
  190. if (ret < 0)
  191. return ret;
  192. val->intval = data >> 7;
  193. val->intval *= 10000; /* Units of LSB = 10mV */
  194. break;
  195. case POWER_SUPPLY_PROP_VOLTAGE_NOW:
  196. ret = regmap_read(map, MAX17042_VCELL, &data);
  197. if (ret < 0)
  198. return ret;
  199. val->intval = data * 625 / 8;
  200. break;
  201. case POWER_SUPPLY_PROP_VOLTAGE_AVG:
  202. ret = regmap_read(map, MAX17042_AvgVCELL, &data);
  203. if (ret < 0)
  204. return ret;
  205. val->intval = data * 625 / 8;
  206. break;
  207. case POWER_SUPPLY_PROP_VOLTAGE_OCV:
  208. ret = regmap_read(map, MAX17042_OCVInternal, &data);
  209. if (ret < 0)
  210. return ret;
  211. val->intval = data * 625 / 8;
  212. break;
  213. case POWER_SUPPLY_PROP_CAPACITY:
  214. ret = regmap_read(map, MAX17042_RepSOC, &data);
  215. if (ret < 0)
  216. return ret;
  217. val->intval = data >> 8;
  218. break;
  219. case POWER_SUPPLY_PROP_CHARGE_FULL:
  220. ret = regmap_read(map, MAX17042_FullCAP, &data);
  221. if (ret < 0)
  222. return ret;
  223. val->intval = data * 1000 / 2;
  224. break;
  225. case POWER_SUPPLY_PROP_CHARGE_COUNTER:
  226. ret = regmap_read(map, MAX17042_QH, &data);
  227. if (ret < 0)
  228. return ret;
  229. val->intval = data * 1000 / 2;
  230. break;
  231. case POWER_SUPPLY_PROP_TEMP:
  232. ret = max17042_get_temperature(chip, &val->intval);
  233. if (ret < 0)
  234. return ret;
  235. break;
  236. case POWER_SUPPLY_PROP_TEMP_ALERT_MIN:
  237. ret = regmap_read(map, MAX17042_TALRT_Th, &data);
  238. if (ret < 0)
  239. return ret;
  240. /* LSB is Alert Minimum. In deci-centigrade */
  241. val->intval = (data & 0xff) * 10;
  242. break;
  243. case POWER_SUPPLY_PROP_TEMP_ALERT_MAX:
  244. ret = regmap_read(map, MAX17042_TALRT_Th, &data);
  245. if (ret < 0)
  246. return ret;
  247. /* MSB is Alert Maximum. In deci-centigrade */
  248. val->intval = (data >> 8) * 10;
  249. break;
  250. case POWER_SUPPLY_PROP_TEMP_MIN:
  251. val->intval = chip->pdata->temp_min;
  252. break;
  253. case POWER_SUPPLY_PROP_TEMP_MAX:
  254. val->intval = chip->pdata->temp_max;
  255. break;
  256. case POWER_SUPPLY_PROP_HEALTH:
  257. ret = max17042_get_battery_health(chip, &val->intval);
  258. if (ret < 0)
  259. return ret;
  260. break;
  261. case POWER_SUPPLY_PROP_CURRENT_NOW:
  262. if (chip->pdata->enable_current_sense) {
  263. ret = regmap_read(map, MAX17042_Current, &data);
  264. if (ret < 0)
  265. return ret;
  266. val->intval = data;
  267. if (val->intval & 0x8000) {
  268. /* Negative */
  269. val->intval = ~val->intval & 0x7fff;
  270. val->intval++;
  271. val->intval *= -1;
  272. }
  273. val->intval *= 1562500 / chip->pdata->r_sns;
  274. } else {
  275. return -EINVAL;
  276. }
  277. break;
  278. case POWER_SUPPLY_PROP_CURRENT_AVG:
  279. if (chip->pdata->enable_current_sense) {
  280. ret = regmap_read(map, MAX17042_AvgCurrent, &data);
  281. if (ret < 0)
  282. return ret;
  283. val->intval = data;
  284. if (val->intval & 0x8000) {
  285. /* Negative */
  286. val->intval = ~val->intval & 0x7fff;
  287. val->intval++;
  288. val->intval *= -1;
  289. }
  290. val->intval *= 1562500 / chip->pdata->r_sns;
  291. } else {
  292. return -EINVAL;
  293. }
  294. break;
  295. default:
  296. return -EINVAL;
  297. }
  298. return 0;
  299. }
  300. static int max17042_set_property(struct power_supply *psy,
  301. enum power_supply_property psp,
  302. const union power_supply_propval *val)
  303. {
  304. struct max17042_chip *chip = power_supply_get_drvdata(psy);
  305. struct regmap *map = chip->regmap;
  306. int ret = 0;
  307. u32 data;
  308. int8_t temp;
  309. switch (psp) {
  310. case POWER_SUPPLY_PROP_TEMP_ALERT_MIN:
  311. ret = regmap_read(map, MAX17042_TALRT_Th, &data);
  312. if (ret < 0)
  313. return ret;
  314. /* Input in deci-centigrade, convert to centigrade */
  315. temp = val->intval / 10;
  316. /* force min < max */
  317. if (temp >= (int8_t)(data >> 8))
  318. temp = (int8_t)(data >> 8) - 1;
  319. /* Write both MAX and MIN ALERT */
  320. data = (data & 0xff00) + temp;
  321. ret = regmap_write(map, MAX17042_TALRT_Th, data);
  322. break;
  323. case POWER_SUPPLY_PROP_TEMP_ALERT_MAX:
  324. ret = regmap_read(map, MAX17042_TALRT_Th, &data);
  325. if (ret < 0)
  326. return ret;
  327. /* Input in Deci-Centigrade, convert to centigrade */
  328. temp = val->intval / 10;
  329. /* force max > min */
  330. if (temp <= (int8_t)(data & 0xff))
  331. temp = (int8_t)(data & 0xff) + 1;
  332. /* Write both MAX and MIN ALERT */
  333. data = (data & 0xff) + (temp << 8);
  334. ret = regmap_write(map, MAX17042_TALRT_Th, data);
  335. break;
  336. default:
  337. ret = -EINVAL;
  338. }
  339. return ret;
  340. }
  341. static int max17042_property_is_writeable(struct power_supply *psy,
  342. enum power_supply_property psp)
  343. {
  344. int ret;
  345. switch (psp) {
  346. case POWER_SUPPLY_PROP_TEMP_ALERT_MIN:
  347. case POWER_SUPPLY_PROP_TEMP_ALERT_MAX:
  348. ret = 1;
  349. break;
  350. default:
  351. ret = 0;
  352. }
  353. return ret;
  354. }
  355. static int max17042_write_verify_reg(struct regmap *map, u8 reg, u32 value)
  356. {
  357. int retries = 8;
  358. int ret;
  359. u32 read_value;
  360. do {
  361. ret = regmap_write(map, reg, value);
  362. regmap_read(map, reg, &read_value);
  363. if (read_value != value) {
  364. ret = -EIO;
  365. retries--;
  366. }
  367. } while (retries && read_value != value);
  368. if (ret < 0)
  369. pr_err("%s: err %d\n", __func__, ret);
  370. return ret;
  371. }
  372. static inline void max17042_override_por(struct regmap *map,
  373. u8 reg, u16 value)
  374. {
  375. if (value)
  376. regmap_write(map, reg, value);
  377. }
  378. static inline void max10742_unlock_model(struct max17042_chip *chip)
  379. {
  380. struct regmap *map = chip->regmap;
  381. regmap_write(map, MAX17042_MLOCKReg1, MODEL_UNLOCK1);
  382. regmap_write(map, MAX17042_MLOCKReg2, MODEL_UNLOCK2);
  383. }
  384. static inline void max10742_lock_model(struct max17042_chip *chip)
  385. {
  386. struct regmap *map = chip->regmap;
  387. regmap_write(map, MAX17042_MLOCKReg1, MODEL_LOCK1);
  388. regmap_write(map, MAX17042_MLOCKReg2, MODEL_LOCK2);
  389. }
  390. static inline void max17042_write_model_data(struct max17042_chip *chip,
  391. u8 addr, int size)
  392. {
  393. struct regmap *map = chip->regmap;
  394. int i;
  395. for (i = 0; i < size; i++)
  396. regmap_write(map, addr + i,
  397. chip->pdata->config_data->cell_char_tbl[i]);
  398. }
  399. static inline void max17042_read_model_data(struct max17042_chip *chip,
  400. u8 addr, u32 *data, int size)
  401. {
  402. struct regmap *map = chip->regmap;
  403. int i;
  404. for (i = 0; i < size; i++)
  405. regmap_read(map, addr + i, &data[i]);
  406. }
  407. static inline int max17042_model_data_compare(struct max17042_chip *chip,
  408. u16 *data1, u16 *data2, int size)
  409. {
  410. int i;
  411. if (memcmp(data1, data2, size)) {
  412. dev_err(&chip->client->dev, "%s compare failed\n", __func__);
  413. for (i = 0; i < size; i++)
  414. dev_info(&chip->client->dev, "0x%x, 0x%x",
  415. data1[i], data2[i]);
  416. dev_info(&chip->client->dev, "\n");
  417. return -EINVAL;
  418. }
  419. return 0;
  420. }
  421. static int max17042_init_model(struct max17042_chip *chip)
  422. {
  423. int ret;
  424. int table_size = ARRAY_SIZE(chip->pdata->config_data->cell_char_tbl);
  425. u32 *temp_data;
  426. temp_data = kcalloc(table_size, sizeof(*temp_data), GFP_KERNEL);
  427. if (!temp_data)
  428. return -ENOMEM;
  429. max10742_unlock_model(chip);
  430. max17042_write_model_data(chip, MAX17042_MODELChrTbl,
  431. table_size);
  432. max17042_read_model_data(chip, MAX17042_MODELChrTbl, temp_data,
  433. table_size);
  434. ret = max17042_model_data_compare(
  435. chip,
  436. chip->pdata->config_data->cell_char_tbl,
  437. (u16 *)temp_data,
  438. table_size);
  439. max10742_lock_model(chip);
  440. kfree(temp_data);
  441. return ret;
  442. }
  443. static int max17042_verify_model_lock(struct max17042_chip *chip)
  444. {
  445. int i;
  446. int table_size = ARRAY_SIZE(chip->pdata->config_data->cell_char_tbl);
  447. u32 *temp_data;
  448. int ret = 0;
  449. temp_data = kcalloc(table_size, sizeof(*temp_data), GFP_KERNEL);
  450. if (!temp_data)
  451. return -ENOMEM;
  452. max17042_read_model_data(chip, MAX17042_MODELChrTbl, temp_data,
  453. table_size);
  454. for (i = 0; i < table_size; i++)
  455. if (temp_data[i])
  456. ret = -EINVAL;
  457. kfree(temp_data);
  458. return ret;
  459. }
  460. static void max17042_write_config_regs(struct max17042_chip *chip)
  461. {
  462. struct max17042_config_data *config = chip->pdata->config_data;
  463. struct regmap *map = chip->regmap;
  464. regmap_write(map, MAX17042_CONFIG, config->config);
  465. regmap_write(map, MAX17042_LearnCFG, config->learn_cfg);
  466. regmap_write(map, MAX17042_FilterCFG,
  467. config->filter_cfg);
  468. regmap_write(map, MAX17042_RelaxCFG, config->relax_cfg);
  469. if (chip->chip_type == MAXIM_DEVICE_TYPE_MAX17047 ||
  470. chip->chip_type == MAXIM_DEVICE_TYPE_MAX17050)
  471. regmap_write(map, MAX17047_FullSOCThr,
  472. config->full_soc_thresh);
  473. }
  474. static void max17042_write_custom_regs(struct max17042_chip *chip)
  475. {
  476. struct max17042_config_data *config = chip->pdata->config_data;
  477. struct regmap *map = chip->regmap;
  478. max17042_write_verify_reg(map, MAX17042_RCOMP0, config->rcomp0);
  479. max17042_write_verify_reg(map, MAX17042_TempCo, config->tcompc0);
  480. max17042_write_verify_reg(map, MAX17042_ICHGTerm, config->ichgt_term);
  481. if (chip->chip_type == MAXIM_DEVICE_TYPE_MAX17042) {
  482. regmap_write(map, MAX17042_EmptyTempCo, config->empty_tempco);
  483. max17042_write_verify_reg(map, MAX17042_K_empty0,
  484. config->kempty0);
  485. } else {
  486. max17042_write_verify_reg(map, MAX17047_QRTbl00,
  487. config->qrtbl00);
  488. max17042_write_verify_reg(map, MAX17047_QRTbl10,
  489. config->qrtbl10);
  490. max17042_write_verify_reg(map, MAX17047_QRTbl20,
  491. config->qrtbl20);
  492. max17042_write_verify_reg(map, MAX17047_QRTbl30,
  493. config->qrtbl30);
  494. }
  495. }
  496. static void max17042_update_capacity_regs(struct max17042_chip *chip)
  497. {
  498. struct max17042_config_data *config = chip->pdata->config_data;
  499. struct regmap *map = chip->regmap;
  500. max17042_write_verify_reg(map, MAX17042_FullCAP,
  501. config->fullcap);
  502. regmap_write(map, MAX17042_DesignCap, config->design_cap);
  503. max17042_write_verify_reg(map, MAX17042_FullCAPNom,
  504. config->fullcapnom);
  505. }
  506. static void max17042_reset_vfsoc0_reg(struct max17042_chip *chip)
  507. {
  508. unsigned int vfSoc;
  509. struct regmap *map = chip->regmap;
  510. regmap_read(map, MAX17042_VFSOC, &vfSoc);
  511. regmap_write(map, MAX17042_VFSOC0Enable, VFSOC0_UNLOCK);
  512. max17042_write_verify_reg(map, MAX17042_VFSOC0, vfSoc);
  513. regmap_write(map, MAX17042_VFSOC0Enable, VFSOC0_LOCK);
  514. }
  515. static void max17042_load_new_capacity_params(struct max17042_chip *chip)
  516. {
  517. u32 full_cap0, rep_cap, dq_acc, vfSoc;
  518. u32 rem_cap;
  519. struct max17042_config_data *config = chip->pdata->config_data;
  520. struct regmap *map = chip->regmap;
  521. regmap_read(map, MAX17042_FullCAP0, &full_cap0);
  522. regmap_read(map, MAX17042_VFSOC, &vfSoc);
  523. /* fg_vfSoc needs to shifted by 8 bits to get the
  524. * perc in 1% accuracy, to get the right rem_cap multiply
  525. * full_cap0, fg_vfSoc and devide by 100
  526. */
  527. rem_cap = ((vfSoc >> 8) * full_cap0) / 100;
  528. max17042_write_verify_reg(map, MAX17042_RemCap, rem_cap);
  529. rep_cap = rem_cap;
  530. max17042_write_verify_reg(map, MAX17042_RepCap, rep_cap);
  531. /* Write dQ_acc to 200% of Capacity and dP_acc to 200% */
  532. dq_acc = config->fullcap / dQ_ACC_DIV;
  533. max17042_write_verify_reg(map, MAX17042_dQacc, dq_acc);
  534. max17042_write_verify_reg(map, MAX17042_dPacc, dP_ACC_200);
  535. max17042_write_verify_reg(map, MAX17042_FullCAP,
  536. config->fullcap);
  537. regmap_write(map, MAX17042_DesignCap,
  538. config->design_cap);
  539. max17042_write_verify_reg(map, MAX17042_FullCAPNom,
  540. config->fullcapnom);
  541. /* Update SOC register with new SOC */
  542. regmap_write(map, MAX17042_RepSOC, vfSoc);
  543. }
  544. /*
  545. * Block write all the override values coming from platform data.
  546. * This function MUST be called before the POR initialization proceedure
  547. * specified by maxim.
  548. */
  549. static inline void max17042_override_por_values(struct max17042_chip *chip)
  550. {
  551. struct regmap *map = chip->regmap;
  552. struct max17042_config_data *config = chip->pdata->config_data;
  553. max17042_override_por(map, MAX17042_TGAIN, config->tgain);
  554. max17042_override_por(map, MAx17042_TOFF, config->toff);
  555. max17042_override_por(map, MAX17042_CGAIN, config->cgain);
  556. max17042_override_por(map, MAX17042_COFF, config->coff);
  557. max17042_override_por(map, MAX17042_VALRT_Th, config->valrt_thresh);
  558. max17042_override_por(map, MAX17042_TALRT_Th, config->talrt_thresh);
  559. max17042_override_por(map, MAX17042_SALRT_Th,
  560. config->soc_alrt_thresh);
  561. max17042_override_por(map, MAX17042_CONFIG, config->config);
  562. max17042_override_por(map, MAX17042_SHDNTIMER, config->shdntimer);
  563. max17042_override_por(map, MAX17042_DesignCap, config->design_cap);
  564. max17042_override_por(map, MAX17042_ICHGTerm, config->ichgt_term);
  565. max17042_override_por(map, MAX17042_AtRate, config->at_rate);
  566. max17042_override_por(map, MAX17042_LearnCFG, config->learn_cfg);
  567. max17042_override_por(map, MAX17042_FilterCFG, config->filter_cfg);
  568. max17042_override_por(map, MAX17042_RelaxCFG, config->relax_cfg);
  569. max17042_override_por(map, MAX17042_MiscCFG, config->misc_cfg);
  570. max17042_override_por(map, MAX17042_MaskSOC, config->masksoc);
  571. max17042_override_por(map, MAX17042_FullCAP, config->fullcap);
  572. max17042_override_por(map, MAX17042_FullCAPNom, config->fullcapnom);
  573. if (chip->chip_type == MAXIM_DEVICE_TYPE_MAX17042)
  574. max17042_override_por(map, MAX17042_SOC_empty,
  575. config->socempty);
  576. max17042_override_por(map, MAX17042_LAvg_empty, config->lavg_empty);
  577. max17042_override_por(map, MAX17042_dQacc, config->dqacc);
  578. max17042_override_por(map, MAX17042_dPacc, config->dpacc);
  579. if (chip->chip_type == MAXIM_DEVICE_TYPE_MAX17042)
  580. max17042_override_por(map, MAX17042_V_empty, config->vempty);
  581. else
  582. max17042_override_por(map, MAX17047_V_empty, config->vempty);
  583. max17042_override_por(map, MAX17042_TempNom, config->temp_nom);
  584. max17042_override_por(map, MAX17042_TempLim, config->temp_lim);
  585. max17042_override_por(map, MAX17042_FCTC, config->fctc);
  586. max17042_override_por(map, MAX17042_RCOMP0, config->rcomp0);
  587. max17042_override_por(map, MAX17042_TempCo, config->tcompc0);
  588. if (chip->chip_type) {
  589. max17042_override_por(map, MAX17042_EmptyTempCo,
  590. config->empty_tempco);
  591. max17042_override_por(map, MAX17042_K_empty0,
  592. config->kempty0);
  593. }
  594. }
  595. static int max17042_init_chip(struct max17042_chip *chip)
  596. {
  597. struct regmap *map = chip->regmap;
  598. int ret;
  599. max17042_override_por_values(chip);
  600. /* After Power up, the MAX17042 requires 500mS in order
  601. * to perform signal debouncing and initial SOC reporting
  602. */
  603. msleep(500);
  604. /* Initialize configaration */
  605. max17042_write_config_regs(chip);
  606. /* write cell characterization data */
  607. ret = max17042_init_model(chip);
  608. if (ret) {
  609. dev_err(&chip->client->dev, "%s init failed\n",
  610. __func__);
  611. return -EIO;
  612. }
  613. ret = max17042_verify_model_lock(chip);
  614. if (ret) {
  615. dev_err(&chip->client->dev, "%s lock verify failed\n",
  616. __func__);
  617. return -EIO;
  618. }
  619. /* write custom parameters */
  620. max17042_write_custom_regs(chip);
  621. /* update capacity params */
  622. max17042_update_capacity_regs(chip);
  623. /* delay must be atleast 350mS to allow VFSOC
  624. * to be calculated from the new configuration
  625. */
  626. msleep(350);
  627. /* reset vfsoc0 reg */
  628. max17042_reset_vfsoc0_reg(chip);
  629. /* load new capacity params */
  630. max17042_load_new_capacity_params(chip);
  631. /* Init complete, Clear the POR bit */
  632. regmap_update_bits(map, MAX17042_STATUS, STATUS_POR_BIT, 0x0);
  633. return 0;
  634. }
  635. static void max17042_set_soc_threshold(struct max17042_chip *chip, u16 off)
  636. {
  637. struct regmap *map = chip->regmap;
  638. u32 soc, soc_tr;
  639. /* program interrupt thesholds such that we should
  640. * get interrupt for every 'off' perc change in the soc
  641. */
  642. regmap_read(map, MAX17042_RepSOC, &soc);
  643. soc >>= 8;
  644. soc_tr = (soc + off) << 8;
  645. soc_tr |= (soc - off);
  646. regmap_write(map, MAX17042_SALRT_Th, soc_tr);
  647. }
  648. static irqreturn_t max17042_thread_handler(int id, void *dev)
  649. {
  650. struct max17042_chip *chip = dev;
  651. u32 val;
  652. regmap_read(chip->regmap, MAX17042_STATUS, &val);
  653. if ((val & STATUS_INTR_SOCMIN_BIT) ||
  654. (val & STATUS_INTR_SOCMAX_BIT)) {
  655. dev_info(&chip->client->dev, "SOC threshold INTR\n");
  656. max17042_set_soc_threshold(chip, 1);
  657. }
  658. power_supply_changed(chip->battery);
  659. return IRQ_HANDLED;
  660. }
  661. static void max17042_init_worker(struct work_struct *work)
  662. {
  663. struct max17042_chip *chip = container_of(work,
  664. struct max17042_chip, work);
  665. int ret;
  666. /* Initialize registers according to values from the platform data */
  667. if (chip->pdata->enable_por_init && chip->pdata->config_data) {
  668. ret = max17042_init_chip(chip);
  669. if (ret)
  670. return;
  671. }
  672. chip->init_complete = 1;
  673. }
  674. #ifdef CONFIG_OF
  675. static struct max17042_platform_data *
  676. max17042_get_pdata(struct device *dev)
  677. {
  678. struct device_node *np = dev->of_node;
  679. u32 prop;
  680. struct max17042_platform_data *pdata;
  681. if (!np)
  682. return dev->platform_data;
  683. pdata = devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL);
  684. if (!pdata)
  685. return NULL;
  686. /*
  687. * Require current sense resistor value to be specified for
  688. * current-sense functionality to be enabled at all.
  689. */
  690. if (of_property_read_u32(np, "maxim,rsns-microohm", &prop) == 0) {
  691. pdata->r_sns = prop;
  692. pdata->enable_current_sense = true;
  693. }
  694. if (of_property_read_s32(np, "maxim,cold-temp", &pdata->temp_min))
  695. pdata->temp_min = INT_MIN;
  696. if (of_property_read_s32(np, "maxim,over-heat-temp", &pdata->temp_max))
  697. pdata->temp_max = INT_MAX;
  698. if (of_property_read_s32(np, "maxim,dead-volt", &pdata->vmin))
  699. pdata->vmin = INT_MIN;
  700. if (of_property_read_s32(np, "maxim,over-volt", &pdata->vmax))
  701. pdata->vmax = INT_MAX;
  702. return pdata;
  703. }
  704. #else
  705. static struct max17042_platform_data *
  706. max17042_get_pdata(struct device *dev)
  707. {
  708. return dev->platform_data;
  709. }
  710. #endif
  711. static const struct regmap_config max17042_regmap_config = {
  712. .reg_bits = 8,
  713. .val_bits = 16,
  714. .val_format_endian = REGMAP_ENDIAN_NATIVE,
  715. };
  716. static const struct power_supply_desc max17042_psy_desc = {
  717. .name = "max170xx_battery",
  718. .type = POWER_SUPPLY_TYPE_BATTERY,
  719. .get_property = max17042_get_property,
  720. .set_property = max17042_set_property,
  721. .property_is_writeable = max17042_property_is_writeable,
  722. .properties = max17042_battery_props,
  723. .num_properties = ARRAY_SIZE(max17042_battery_props),
  724. };
  725. static const struct power_supply_desc max17042_no_current_sense_psy_desc = {
  726. .name = "max170xx_battery",
  727. .type = POWER_SUPPLY_TYPE_BATTERY,
  728. .get_property = max17042_get_property,
  729. .set_property = max17042_set_property,
  730. .property_is_writeable = max17042_property_is_writeable,
  731. .properties = max17042_battery_props,
  732. .num_properties = ARRAY_SIZE(max17042_battery_props) - 2,
  733. };
  734. static int max17042_probe(struct i2c_client *client,
  735. const struct i2c_device_id *id)
  736. {
  737. struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
  738. const struct power_supply_desc *max17042_desc = &max17042_psy_desc;
  739. struct power_supply_config psy_cfg = {};
  740. struct max17042_chip *chip;
  741. int ret;
  742. int i;
  743. u32 val;
  744. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA))
  745. return -EIO;
  746. chip = devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL);
  747. if (!chip)
  748. return -ENOMEM;
  749. chip->client = client;
  750. chip->regmap = devm_regmap_init_i2c(client, &max17042_regmap_config);
  751. if (IS_ERR(chip->regmap)) {
  752. dev_err(&client->dev, "Failed to initialize regmap\n");
  753. return -EINVAL;
  754. }
  755. chip->pdata = max17042_get_pdata(&client->dev);
  756. if (!chip->pdata) {
  757. dev_err(&client->dev, "no platform data provided\n");
  758. return -EINVAL;
  759. }
  760. i2c_set_clientdata(client, chip);
  761. chip->chip_type = id->driver_data;
  762. psy_cfg.drv_data = chip;
  763. /* When current is not measured,
  764. * CURRENT_NOW and CURRENT_AVG properties should be invisible. */
  765. if (!chip->pdata->enable_current_sense)
  766. max17042_desc = &max17042_no_current_sense_psy_desc;
  767. if (chip->pdata->r_sns == 0)
  768. chip->pdata->r_sns = MAX17042_DEFAULT_SNS_RESISTOR;
  769. if (chip->pdata->init_data)
  770. for (i = 0; i < chip->pdata->num_init_data; i++)
  771. regmap_write(chip->regmap,
  772. chip->pdata->init_data[i].addr,
  773. chip->pdata->init_data[i].data);
  774. if (!chip->pdata->enable_current_sense) {
  775. regmap_write(chip->regmap, MAX17042_CGAIN, 0x0000);
  776. regmap_write(chip->regmap, MAX17042_MiscCFG, 0x0003);
  777. regmap_write(chip->regmap, MAX17042_LearnCFG, 0x0007);
  778. }
  779. chip->battery = power_supply_register(&client->dev, max17042_desc,
  780. &psy_cfg);
  781. if (IS_ERR(chip->battery)) {
  782. dev_err(&client->dev, "failed: power supply register\n");
  783. return PTR_ERR(chip->battery);
  784. }
  785. if (client->irq) {
  786. ret = request_threaded_irq(client->irq, NULL,
  787. max17042_thread_handler,
  788. IRQF_TRIGGER_FALLING | IRQF_ONESHOT,
  789. chip->battery->desc->name, chip);
  790. if (!ret) {
  791. regmap_update_bits(chip->regmap, MAX17042_CONFIG,
  792. CONFIG_ALRT_BIT_ENBL,
  793. CONFIG_ALRT_BIT_ENBL);
  794. max17042_set_soc_threshold(chip, 1);
  795. } else {
  796. client->irq = 0;
  797. dev_err(&client->dev, "%s(): cannot get IRQ\n",
  798. __func__);
  799. }
  800. }
  801. regmap_read(chip->regmap, MAX17042_STATUS, &val);
  802. if (val & STATUS_POR_BIT) {
  803. INIT_WORK(&chip->work, max17042_init_worker);
  804. schedule_work(&chip->work);
  805. } else {
  806. chip->init_complete = 1;
  807. }
  808. return 0;
  809. }
  810. static int max17042_remove(struct i2c_client *client)
  811. {
  812. struct max17042_chip *chip = i2c_get_clientdata(client);
  813. if (client->irq)
  814. free_irq(client->irq, chip);
  815. power_supply_unregister(chip->battery);
  816. return 0;
  817. }
  818. #ifdef CONFIG_PM_SLEEP
  819. static int max17042_suspend(struct device *dev)
  820. {
  821. struct max17042_chip *chip = dev_get_drvdata(dev);
  822. /*
  823. * disable the irq and enable irq_wake
  824. * capability to the interrupt line.
  825. */
  826. if (chip->client->irq) {
  827. disable_irq(chip->client->irq);
  828. enable_irq_wake(chip->client->irq);
  829. }
  830. return 0;
  831. }
  832. static int max17042_resume(struct device *dev)
  833. {
  834. struct max17042_chip *chip = dev_get_drvdata(dev);
  835. if (chip->client->irq) {
  836. disable_irq_wake(chip->client->irq);
  837. enable_irq(chip->client->irq);
  838. /* re-program the SOC thresholds to 1% change */
  839. max17042_set_soc_threshold(chip, 1);
  840. }
  841. return 0;
  842. }
  843. #endif
  844. static SIMPLE_DEV_PM_OPS(max17042_pm_ops, max17042_suspend,
  845. max17042_resume);
  846. #ifdef CONFIG_OF
  847. static const struct of_device_id max17042_dt_match[] = {
  848. { .compatible = "maxim,max17042" },
  849. { .compatible = "maxim,max17047" },
  850. { .compatible = "maxim,max17050" },
  851. { },
  852. };
  853. MODULE_DEVICE_TABLE(of, max17042_dt_match);
  854. #endif
  855. static const struct i2c_device_id max17042_id[] = {
  856. { "max17042", MAXIM_DEVICE_TYPE_MAX17042 },
  857. { "max17047", MAXIM_DEVICE_TYPE_MAX17047 },
  858. { "max17050", MAXIM_DEVICE_TYPE_MAX17050 },
  859. { }
  860. };
  861. MODULE_DEVICE_TABLE(i2c, max17042_id);
  862. static struct i2c_driver max17042_i2c_driver = {
  863. .driver = {
  864. .name = "max17042",
  865. .of_match_table = of_match_ptr(max17042_dt_match),
  866. .pm = &max17042_pm_ops,
  867. },
  868. .probe = max17042_probe,
  869. .remove = max17042_remove,
  870. .id_table = max17042_id,
  871. };
  872. module_i2c_driver(max17042_i2c_driver);
  873. MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>");
  874. MODULE_DESCRIPTION("MAX17042 Fuel Gauge");
  875. MODULE_LICENSE("GPL");