ltc2978.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504
  1. /*
  2. * Hardware monitoring driver for LTC2974, LTC2977, LTC2978, LTC3880,
  3. * and LTC3883
  4. *
  5. * Copyright (c) 2011 Ericsson AB.
  6. * Copyright (c) 2013 Guenter Roeck
  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., 675 Mass Ave, Cambridge, MA 02139, USA.
  21. */
  22. #include <linux/kernel.h>
  23. #include <linux/module.h>
  24. #include <linux/init.h>
  25. #include <linux/err.h>
  26. #include <linux/slab.h>
  27. #include <linux/i2c.h>
  28. #include "pmbus.h"
  29. enum chips { ltc2974, ltc2977, ltc2978, ltc3880, ltc3883 };
  30. /* Common for all chips */
  31. #define LTC2978_MFR_VOUT_PEAK 0xdd
  32. #define LTC2978_MFR_VIN_PEAK 0xde
  33. #define LTC2978_MFR_TEMPERATURE_PEAK 0xdf
  34. #define LTC2978_MFR_SPECIAL_ID 0xe7
  35. /* LTC2974, LCT2977, and LTC2978 */
  36. #define LTC2978_MFR_VOUT_MIN 0xfb
  37. #define LTC2978_MFR_VIN_MIN 0xfc
  38. #define LTC2978_MFR_TEMPERATURE_MIN 0xfd
  39. /* LTC2974 only */
  40. #define LTC2974_MFR_IOUT_PEAK 0xd7
  41. #define LTC2974_MFR_IOUT_MIN 0xd8
  42. /* LTC3880 and LTC3883 */
  43. #define LTC3880_MFR_IOUT_PEAK 0xd7
  44. #define LTC3880_MFR_CLEAR_PEAKS 0xe3
  45. #define LTC3880_MFR_TEMPERATURE2_PEAK 0xf4
  46. /* LTC3883 only */
  47. #define LTC3883_MFR_IIN_PEAK 0xe1
  48. #define LTC2974_ID 0x0212
  49. #define LTC2977_ID 0x0130
  50. #define LTC2978_ID_REV1 0x0121
  51. #define LTC2978_ID_REV2 0x0122
  52. #define LTC2978A_ID 0x0124
  53. #define LTC3880_ID 0x4000
  54. #define LTC3880_ID_MASK 0xff00
  55. #define LTC3883_ID 0x4300
  56. #define LTC3883_ID_MASK 0xff00
  57. #define LTC2974_NUM_PAGES 4
  58. #define LTC2978_NUM_PAGES 8
  59. #define LTC3880_NUM_PAGES 2
  60. #define LTC3883_NUM_PAGES 1
  61. /*
  62. * LTC2978 clears peak data whenever the CLEAR_FAULTS command is executed, which
  63. * happens pretty much each time chip data is updated. Raw peak data therefore
  64. * does not provide much value. To be able to provide useful peak data, keep an
  65. * internal cache of measured peak data, which is only cleared if an explicit
  66. * "clear peak" command is executed for the sensor in question.
  67. */
  68. struct ltc2978_data {
  69. enum chips id;
  70. u16 vin_min, vin_max;
  71. u16 temp_min[LTC2974_NUM_PAGES], temp_max[LTC2974_NUM_PAGES];
  72. u16 vout_min[LTC2978_NUM_PAGES], vout_max[LTC2978_NUM_PAGES];
  73. u16 iout_min[LTC2974_NUM_PAGES], iout_max[LTC2974_NUM_PAGES];
  74. u16 iin_max;
  75. u16 temp2_max;
  76. struct pmbus_driver_info info;
  77. };
  78. #define to_ltc2978_data(x) container_of(x, struct ltc2978_data, info)
  79. static inline int lin11_to_val(int data)
  80. {
  81. s16 e = ((s16)data) >> 11;
  82. s32 m = (((s16)(data << 5)) >> 5);
  83. /*
  84. * mantissa is 10 bit + sign, exponent adds up to 15 bit.
  85. * Add 6 bit to exponent for maximum accuracy (10 + 15 + 6 = 31).
  86. */
  87. e += 6;
  88. return (e < 0 ? m >> -e : m << e);
  89. }
  90. static int ltc2978_read_word_data_common(struct i2c_client *client, int page,
  91. int reg)
  92. {
  93. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  94. struct ltc2978_data *data = to_ltc2978_data(info);
  95. int ret;
  96. switch (reg) {
  97. case PMBUS_VIRT_READ_VIN_MAX:
  98. ret = pmbus_read_word_data(client, page, LTC2978_MFR_VIN_PEAK);
  99. if (ret >= 0) {
  100. if (lin11_to_val(ret) > lin11_to_val(data->vin_max))
  101. data->vin_max = ret;
  102. ret = data->vin_max;
  103. }
  104. break;
  105. case PMBUS_VIRT_READ_VOUT_MAX:
  106. ret = pmbus_read_word_data(client, page, LTC2978_MFR_VOUT_PEAK);
  107. if (ret >= 0) {
  108. /*
  109. * VOUT is 16 bit unsigned with fixed exponent,
  110. * so we can compare it directly
  111. */
  112. if (ret > data->vout_max[page])
  113. data->vout_max[page] = ret;
  114. ret = data->vout_max[page];
  115. }
  116. break;
  117. case PMBUS_VIRT_READ_TEMP_MAX:
  118. ret = pmbus_read_word_data(client, page,
  119. LTC2978_MFR_TEMPERATURE_PEAK);
  120. if (ret >= 0) {
  121. if (lin11_to_val(ret)
  122. > lin11_to_val(data->temp_max[page]))
  123. data->temp_max[page] = ret;
  124. ret = data->temp_max[page];
  125. }
  126. break;
  127. case PMBUS_VIRT_RESET_VOUT_HISTORY:
  128. case PMBUS_VIRT_RESET_VIN_HISTORY:
  129. case PMBUS_VIRT_RESET_TEMP_HISTORY:
  130. ret = 0;
  131. break;
  132. default:
  133. ret = -ENODATA;
  134. break;
  135. }
  136. return ret;
  137. }
  138. static int ltc2978_read_word_data(struct i2c_client *client, int page, int reg)
  139. {
  140. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  141. struct ltc2978_data *data = to_ltc2978_data(info);
  142. int ret;
  143. switch (reg) {
  144. case PMBUS_VIRT_READ_VIN_MIN:
  145. ret = pmbus_read_word_data(client, page, LTC2978_MFR_VIN_MIN);
  146. if (ret >= 0) {
  147. if (lin11_to_val(ret) < lin11_to_val(data->vin_min))
  148. data->vin_min = ret;
  149. ret = data->vin_min;
  150. }
  151. break;
  152. case PMBUS_VIRT_READ_VOUT_MIN:
  153. ret = pmbus_read_word_data(client, page, LTC2978_MFR_VOUT_MIN);
  154. if (ret >= 0) {
  155. /*
  156. * VOUT_MIN is known to not be supported on some lots
  157. * of LTC2978 revision 1, and will return the maximum
  158. * possible voltage if read. If VOUT_MAX is valid and
  159. * lower than the reading of VOUT_MIN, use it instead.
  160. */
  161. if (data->vout_max[page] && ret > data->vout_max[page])
  162. ret = data->vout_max[page];
  163. if (ret < data->vout_min[page])
  164. data->vout_min[page] = ret;
  165. ret = data->vout_min[page];
  166. }
  167. break;
  168. case PMBUS_VIRT_READ_TEMP_MIN:
  169. ret = pmbus_read_word_data(client, page,
  170. LTC2978_MFR_TEMPERATURE_MIN);
  171. if (ret >= 0) {
  172. if (lin11_to_val(ret)
  173. < lin11_to_val(data->temp_min[page]))
  174. data->temp_min[page] = ret;
  175. ret = data->temp_min[page];
  176. }
  177. break;
  178. case PMBUS_VIRT_READ_IOUT_MAX:
  179. case PMBUS_VIRT_RESET_IOUT_HISTORY:
  180. case PMBUS_VIRT_READ_TEMP2_MAX:
  181. case PMBUS_VIRT_RESET_TEMP2_HISTORY:
  182. ret = -ENXIO;
  183. break;
  184. default:
  185. ret = ltc2978_read_word_data_common(client, page, reg);
  186. break;
  187. }
  188. return ret;
  189. }
  190. static int ltc2974_read_word_data(struct i2c_client *client, int page, int reg)
  191. {
  192. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  193. struct ltc2978_data *data = to_ltc2978_data(info);
  194. int ret;
  195. switch (reg) {
  196. case PMBUS_VIRT_READ_IOUT_MAX:
  197. ret = pmbus_read_word_data(client, page, LTC2974_MFR_IOUT_PEAK);
  198. if (ret >= 0) {
  199. if (lin11_to_val(ret)
  200. > lin11_to_val(data->iout_max[page]))
  201. data->iout_max[page] = ret;
  202. ret = data->iout_max[page];
  203. }
  204. break;
  205. case PMBUS_VIRT_READ_IOUT_MIN:
  206. ret = pmbus_read_word_data(client, page, LTC2974_MFR_IOUT_MIN);
  207. if (ret >= 0) {
  208. if (lin11_to_val(ret)
  209. < lin11_to_val(data->iout_min[page]))
  210. data->iout_min[page] = ret;
  211. ret = data->iout_min[page];
  212. }
  213. break;
  214. case PMBUS_VIRT_RESET_IOUT_HISTORY:
  215. ret = 0;
  216. break;
  217. default:
  218. ret = ltc2978_read_word_data(client, page, reg);
  219. break;
  220. }
  221. return ret;
  222. }
  223. static int ltc3880_read_word_data(struct i2c_client *client, int page, int reg)
  224. {
  225. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  226. struct ltc2978_data *data = to_ltc2978_data(info);
  227. int ret;
  228. switch (reg) {
  229. case PMBUS_VIRT_READ_IOUT_MAX:
  230. ret = pmbus_read_word_data(client, page, LTC3880_MFR_IOUT_PEAK);
  231. if (ret >= 0) {
  232. if (lin11_to_val(ret)
  233. > lin11_to_val(data->iout_max[page]))
  234. data->iout_max[page] = ret;
  235. ret = data->iout_max[page];
  236. }
  237. break;
  238. case PMBUS_VIRT_READ_TEMP2_MAX:
  239. ret = pmbus_read_word_data(client, page,
  240. LTC3880_MFR_TEMPERATURE2_PEAK);
  241. if (ret >= 0) {
  242. if (lin11_to_val(ret) > lin11_to_val(data->temp2_max))
  243. data->temp2_max = ret;
  244. ret = data->temp2_max;
  245. }
  246. break;
  247. case PMBUS_VIRT_READ_VIN_MIN:
  248. case PMBUS_VIRT_READ_VOUT_MIN:
  249. case PMBUS_VIRT_READ_TEMP_MIN:
  250. ret = -ENXIO;
  251. break;
  252. case PMBUS_VIRT_RESET_IOUT_HISTORY:
  253. case PMBUS_VIRT_RESET_TEMP2_HISTORY:
  254. ret = 0;
  255. break;
  256. default:
  257. ret = ltc2978_read_word_data_common(client, page, reg);
  258. break;
  259. }
  260. return ret;
  261. }
  262. static int ltc3883_read_word_data(struct i2c_client *client, int page, int reg)
  263. {
  264. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  265. struct ltc2978_data *data = to_ltc2978_data(info);
  266. int ret;
  267. switch (reg) {
  268. case PMBUS_VIRT_READ_IIN_MAX:
  269. ret = pmbus_read_word_data(client, page, LTC3883_MFR_IIN_PEAK);
  270. if (ret >= 0) {
  271. if (lin11_to_val(ret)
  272. > lin11_to_val(data->iin_max))
  273. data->iin_max = ret;
  274. ret = data->iin_max;
  275. }
  276. break;
  277. case PMBUS_VIRT_RESET_IIN_HISTORY:
  278. ret = 0;
  279. break;
  280. default:
  281. ret = ltc3880_read_word_data(client, page, reg);
  282. break;
  283. }
  284. return ret;
  285. }
  286. static int ltc2978_clear_peaks(struct i2c_client *client, int page,
  287. enum chips id)
  288. {
  289. int ret;
  290. if (id == ltc3880 || id == ltc3883)
  291. ret = pmbus_write_byte(client, 0, LTC3880_MFR_CLEAR_PEAKS);
  292. else
  293. ret = pmbus_write_byte(client, page, PMBUS_CLEAR_FAULTS);
  294. return ret;
  295. }
  296. static int ltc2978_write_word_data(struct i2c_client *client, int page,
  297. int reg, u16 word)
  298. {
  299. const struct pmbus_driver_info *info = pmbus_get_driver_info(client);
  300. struct ltc2978_data *data = to_ltc2978_data(info);
  301. int ret;
  302. switch (reg) {
  303. case PMBUS_VIRT_RESET_IIN_HISTORY:
  304. data->iin_max = 0x7c00;
  305. ret = ltc2978_clear_peaks(client, page, data->id);
  306. break;
  307. case PMBUS_VIRT_RESET_IOUT_HISTORY:
  308. data->iout_max[page] = 0x7c00;
  309. data->iout_min[page] = 0xfbff;
  310. ret = ltc2978_clear_peaks(client, page, data->id);
  311. break;
  312. case PMBUS_VIRT_RESET_TEMP2_HISTORY:
  313. data->temp2_max = 0x7c00;
  314. ret = ltc2978_clear_peaks(client, page, data->id);
  315. break;
  316. case PMBUS_VIRT_RESET_VOUT_HISTORY:
  317. data->vout_min[page] = 0xffff;
  318. data->vout_max[page] = 0;
  319. ret = ltc2978_clear_peaks(client, page, data->id);
  320. break;
  321. case PMBUS_VIRT_RESET_VIN_HISTORY:
  322. data->vin_min = 0x7bff;
  323. data->vin_max = 0x7c00;
  324. ret = ltc2978_clear_peaks(client, page, data->id);
  325. break;
  326. case PMBUS_VIRT_RESET_TEMP_HISTORY:
  327. data->temp_min[page] = 0x7bff;
  328. data->temp_max[page] = 0x7c00;
  329. ret = ltc2978_clear_peaks(client, page, data->id);
  330. break;
  331. default:
  332. ret = -ENODATA;
  333. break;
  334. }
  335. return ret;
  336. }
  337. static const struct i2c_device_id ltc2978_id[] = {
  338. {"ltc2974", ltc2974},
  339. {"ltc2977", ltc2977},
  340. {"ltc2978", ltc2978},
  341. {"ltc3880", ltc3880},
  342. {"ltc3883", ltc3883},
  343. {}
  344. };
  345. MODULE_DEVICE_TABLE(i2c, ltc2978_id);
  346. static int ltc2978_probe(struct i2c_client *client,
  347. const struct i2c_device_id *id)
  348. {
  349. int chip_id, i;
  350. struct ltc2978_data *data;
  351. struct pmbus_driver_info *info;
  352. if (!i2c_check_functionality(client->adapter,
  353. I2C_FUNC_SMBUS_READ_WORD_DATA))
  354. return -ENODEV;
  355. data = devm_kzalloc(&client->dev, sizeof(struct ltc2978_data),
  356. GFP_KERNEL);
  357. if (!data)
  358. return -ENOMEM;
  359. chip_id = i2c_smbus_read_word_data(client, LTC2978_MFR_SPECIAL_ID);
  360. if (chip_id < 0)
  361. return chip_id;
  362. if (chip_id == LTC2974_ID) {
  363. data->id = ltc2974;
  364. } else if (chip_id == LTC2977_ID) {
  365. data->id = ltc2977;
  366. } else if (chip_id == LTC2978_ID_REV1 || chip_id == LTC2978_ID_REV2 ||
  367. chip_id == LTC2978A_ID) {
  368. data->id = ltc2978;
  369. } else if ((chip_id & LTC3880_ID_MASK) == LTC3880_ID) {
  370. data->id = ltc3880;
  371. } else if ((chip_id & LTC3883_ID_MASK) == LTC3883_ID) {
  372. data->id = ltc3883;
  373. } else {
  374. dev_err(&client->dev, "Unsupported chip ID 0x%x\n", chip_id);
  375. return -ENODEV;
  376. }
  377. if (data->id != id->driver_data)
  378. dev_warn(&client->dev,
  379. "Device mismatch: Configured %s, detected %s\n",
  380. id->name,
  381. ltc2978_id[data->id].name);
  382. info = &data->info;
  383. info->write_word_data = ltc2978_write_word_data;
  384. data->vin_min = 0x7bff;
  385. data->vin_max = 0x7c00;
  386. for (i = 0; i < ARRAY_SIZE(data->vout_min); i++)
  387. data->vout_min[i] = 0xffff;
  388. for (i = 0; i < ARRAY_SIZE(data->iout_min); i++)
  389. data->iout_min[i] = 0xfbff;
  390. for (i = 0; i < ARRAY_SIZE(data->iout_max); i++)
  391. data->iout_max[i] = 0x7c00;
  392. for (i = 0; i < ARRAY_SIZE(data->temp_min); i++)
  393. data->temp_min[i] = 0x7bff;
  394. for (i = 0; i < ARRAY_SIZE(data->temp_max); i++)
  395. data->temp_max[i] = 0x7c00;
  396. data->temp2_max = 0x7c00;
  397. switch (data->id) {
  398. case ltc2974:
  399. info->read_word_data = ltc2974_read_word_data;
  400. info->pages = LTC2974_NUM_PAGES;
  401. info->func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_STATUS_INPUT
  402. | PMBUS_HAVE_TEMP2;
  403. for (i = 0; i < info->pages; i++) {
  404. info->func[i] |= PMBUS_HAVE_VOUT
  405. | PMBUS_HAVE_STATUS_VOUT | PMBUS_HAVE_POUT
  406. | PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_TEMP
  407. | PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT;
  408. }
  409. break;
  410. case ltc2977:
  411. case ltc2978:
  412. info->read_word_data = ltc2978_read_word_data;
  413. info->pages = LTC2978_NUM_PAGES;
  414. info->func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_STATUS_INPUT
  415. | PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT
  416. | PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_TEMP;
  417. for (i = 1; i < LTC2978_NUM_PAGES; i++) {
  418. info->func[i] = PMBUS_HAVE_VOUT
  419. | PMBUS_HAVE_STATUS_VOUT;
  420. }
  421. break;
  422. case ltc3880:
  423. info->read_word_data = ltc3880_read_word_data;
  424. info->pages = LTC3880_NUM_PAGES;
  425. info->func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_IIN
  426. | PMBUS_HAVE_STATUS_INPUT
  427. | PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT
  428. | PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT
  429. | PMBUS_HAVE_POUT | PMBUS_HAVE_TEMP
  430. | PMBUS_HAVE_TEMP2 | PMBUS_HAVE_STATUS_TEMP;
  431. info->func[1] = PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT
  432. | PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT
  433. | PMBUS_HAVE_POUT
  434. | PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_TEMP;
  435. break;
  436. case ltc3883:
  437. info->read_word_data = ltc3883_read_word_data;
  438. info->pages = LTC3883_NUM_PAGES;
  439. info->func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_IIN
  440. | PMBUS_HAVE_STATUS_INPUT
  441. | PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT
  442. | PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT
  443. | PMBUS_HAVE_PIN | PMBUS_HAVE_POUT | PMBUS_HAVE_TEMP
  444. | PMBUS_HAVE_TEMP2 | PMBUS_HAVE_STATUS_TEMP;
  445. break;
  446. default:
  447. return -ENODEV;
  448. }
  449. return pmbus_do_probe(client, id, info);
  450. }
  451. /* This is the driver that will be inserted */
  452. static struct i2c_driver ltc2978_driver = {
  453. .driver = {
  454. .name = "ltc2978",
  455. },
  456. .probe = ltc2978_probe,
  457. .remove = pmbus_do_remove,
  458. .id_table = ltc2978_id,
  459. };
  460. module_i2c_driver(ltc2978_driver);
  461. MODULE_AUTHOR("Guenter Roeck");
  462. MODULE_DESCRIPTION("PMBus driver for LTC2974, LTC2978, LTC3880, and LTC3883");
  463. MODULE_LICENSE("GPL");