ltc2978.c 14 KB

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