ltc2978.c 10 KB

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