ltc2945.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490
  1. // SPDX-License-Identifier: GPL-2.0-or-later
  2. /*
  3. * Driver for Linear Technology LTC2945 I2C Power Monitor
  4. *
  5. * Copyright (c) 2014 Guenter Roeck
  6. */
  7. #include <linux/kernel.h>
  8. #include <linux/module.h>
  9. #include <linux/err.h>
  10. #include <linux/slab.h>
  11. #include <linux/i2c.h>
  12. #include <linux/hwmon.h>
  13. #include <linux/hwmon-sysfs.h>
  14. #include <linux/jiffies.h>
  15. #include <linux/regmap.h>
  16. /* chip registers */
  17. #define LTC2945_CONTROL 0x00
  18. #define LTC2945_ALERT 0x01
  19. #define LTC2945_STATUS 0x02
  20. #define LTC2945_FAULT 0x03
  21. #define LTC2945_POWER_H 0x05
  22. #define LTC2945_MAX_POWER_H 0x08
  23. #define LTC2945_MIN_POWER_H 0x0b
  24. #define LTC2945_MAX_POWER_THRES_H 0x0e
  25. #define LTC2945_MIN_POWER_THRES_H 0x11
  26. #define LTC2945_SENSE_H 0x14
  27. #define LTC2945_MAX_SENSE_H 0x16
  28. #define LTC2945_MIN_SENSE_H 0x18
  29. #define LTC2945_MAX_SENSE_THRES_H 0x1a
  30. #define LTC2945_MIN_SENSE_THRES_H 0x1c
  31. #define LTC2945_VIN_H 0x1e
  32. #define LTC2945_MAX_VIN_H 0x20
  33. #define LTC2945_MIN_VIN_H 0x22
  34. #define LTC2945_MAX_VIN_THRES_H 0x24
  35. #define LTC2945_MIN_VIN_THRES_H 0x26
  36. #define LTC2945_ADIN_H 0x28
  37. #define LTC2945_MAX_ADIN_H 0x2a
  38. #define LTC2945_MIN_ADIN_H 0x2c
  39. #define LTC2945_MAX_ADIN_THRES_H 0x2e
  40. #define LTC2945_MIN_ADIN_THRES_H 0x30
  41. #define LTC2945_MIN_ADIN_THRES_L 0x31
  42. /* Fault register bits */
  43. #define FAULT_ADIN_UV (1 << 0)
  44. #define FAULT_ADIN_OV (1 << 1)
  45. #define FAULT_VIN_UV (1 << 2)
  46. #define FAULT_VIN_OV (1 << 3)
  47. #define FAULT_SENSE_UV (1 << 4)
  48. #define FAULT_SENSE_OV (1 << 5)
  49. #define FAULT_POWER_UV (1 << 6)
  50. #define FAULT_POWER_OV (1 << 7)
  51. /* Control register bits */
  52. #define CONTROL_MULT_SELECT (1 << 0)
  53. #define CONTROL_TEST_MODE (1 << 4)
  54. static inline bool is_power_reg(u8 reg)
  55. {
  56. return reg < LTC2945_SENSE_H;
  57. }
  58. /* Return the value from the given register in uW, mV, or mA */
  59. static long long ltc2945_reg_to_val(struct device *dev, u8 reg)
  60. {
  61. struct regmap *regmap = dev_get_drvdata(dev);
  62. unsigned int control;
  63. u8 buf[3];
  64. long long val;
  65. int ret;
  66. ret = regmap_bulk_read(regmap, reg, buf,
  67. is_power_reg(reg) ? 3 : 2);
  68. if (ret < 0)
  69. return ret;
  70. if (is_power_reg(reg)) {
  71. /* power */
  72. val = (buf[0] << 16) + (buf[1] << 8) + buf[2];
  73. } else {
  74. /* current, voltage */
  75. val = (buf[0] << 4) + (buf[1] >> 4);
  76. }
  77. switch (reg) {
  78. case LTC2945_POWER_H:
  79. case LTC2945_MAX_POWER_H:
  80. case LTC2945_MIN_POWER_H:
  81. case LTC2945_MAX_POWER_THRES_H:
  82. case LTC2945_MIN_POWER_THRES_H:
  83. /*
  84. * Convert to uW by assuming current is measured with
  85. * an 1mOhm sense resistor, similar to current
  86. * measurements.
  87. * Control register bit 0 selects if voltage at SENSE+/VDD
  88. * or voltage at ADIN is used to measure power.
  89. */
  90. ret = regmap_read(regmap, LTC2945_CONTROL, &control);
  91. if (ret < 0)
  92. return ret;
  93. if (control & CONTROL_MULT_SELECT) {
  94. /* 25 mV * 25 uV = 0.625 uV resolution. */
  95. val *= 625LL;
  96. } else {
  97. /* 0.5 mV * 25 uV = 0.0125 uV resolution. */
  98. val = (val * 25LL) >> 1;
  99. }
  100. break;
  101. case LTC2945_VIN_H:
  102. case LTC2945_MAX_VIN_H:
  103. case LTC2945_MIN_VIN_H:
  104. case LTC2945_MAX_VIN_THRES_H:
  105. case LTC2945_MIN_VIN_THRES_H:
  106. /* 25 mV resolution. Convert to mV. */
  107. val *= 25;
  108. break;
  109. case LTC2945_ADIN_H:
  110. case LTC2945_MAX_ADIN_H:
  111. case LTC2945_MIN_ADIN_THRES_H:
  112. case LTC2945_MAX_ADIN_THRES_H:
  113. case LTC2945_MIN_ADIN_H:
  114. /* 0.5mV resolution. Convert to mV. */
  115. val = val >> 1;
  116. break;
  117. case LTC2945_SENSE_H:
  118. case LTC2945_MAX_SENSE_H:
  119. case LTC2945_MIN_SENSE_H:
  120. case LTC2945_MAX_SENSE_THRES_H:
  121. case LTC2945_MIN_SENSE_THRES_H:
  122. /*
  123. * 25 uV resolution. Convert to current as measured with
  124. * an 1 mOhm sense resistor, in mA. If a different sense
  125. * resistor is installed, calculate the actual current by
  126. * dividing the reported current by the sense resistor value
  127. * in mOhm.
  128. */
  129. val *= 25;
  130. break;
  131. default:
  132. return -EINVAL;
  133. }
  134. return val;
  135. }
  136. static int ltc2945_val_to_reg(struct device *dev, u8 reg,
  137. unsigned long val)
  138. {
  139. struct regmap *regmap = dev_get_drvdata(dev);
  140. unsigned int control;
  141. int ret;
  142. switch (reg) {
  143. case LTC2945_POWER_H:
  144. case LTC2945_MAX_POWER_H:
  145. case LTC2945_MIN_POWER_H:
  146. case LTC2945_MAX_POWER_THRES_H:
  147. case LTC2945_MIN_POWER_THRES_H:
  148. /*
  149. * Convert to register value by assuming current is measured
  150. * with an 1mOhm sense resistor, similar to current
  151. * measurements.
  152. * Control register bit 0 selects if voltage at SENSE+/VDD
  153. * or voltage at ADIN is used to measure power, which in turn
  154. * determines register calculations.
  155. */
  156. ret = regmap_read(regmap, LTC2945_CONTROL, &control);
  157. if (ret < 0)
  158. return ret;
  159. if (control & CONTROL_MULT_SELECT) {
  160. /* 25 mV * 25 uV = 0.625 uV resolution. */
  161. val = DIV_ROUND_CLOSEST(val, 625);
  162. } else {
  163. /*
  164. * 0.5 mV * 25 uV = 0.0125 uV resolution.
  165. * Divide first to avoid overflow;
  166. * accept loss of accuracy.
  167. */
  168. val = DIV_ROUND_CLOSEST(val, 25) * 2;
  169. }
  170. break;
  171. case LTC2945_VIN_H:
  172. case LTC2945_MAX_VIN_H:
  173. case LTC2945_MIN_VIN_H:
  174. case LTC2945_MAX_VIN_THRES_H:
  175. case LTC2945_MIN_VIN_THRES_H:
  176. /* 25 mV resolution. */
  177. val /= 25;
  178. break;
  179. case LTC2945_ADIN_H:
  180. case LTC2945_MAX_ADIN_H:
  181. case LTC2945_MIN_ADIN_THRES_H:
  182. case LTC2945_MAX_ADIN_THRES_H:
  183. case LTC2945_MIN_ADIN_H:
  184. /* 0.5mV resolution. */
  185. val *= 2;
  186. break;
  187. case LTC2945_SENSE_H:
  188. case LTC2945_MAX_SENSE_H:
  189. case LTC2945_MIN_SENSE_H:
  190. case LTC2945_MAX_SENSE_THRES_H:
  191. case LTC2945_MIN_SENSE_THRES_H:
  192. /*
  193. * 25 uV resolution. Convert to current as measured with
  194. * an 1 mOhm sense resistor, in mA. If a different sense
  195. * resistor is installed, calculate the actual current by
  196. * dividing the reported current by the sense resistor value
  197. * in mOhm.
  198. */
  199. val = DIV_ROUND_CLOSEST(val, 25);
  200. break;
  201. default:
  202. return -EINVAL;
  203. }
  204. return val;
  205. }
  206. static ssize_t ltc2945_value_show(struct device *dev,
  207. struct device_attribute *da, char *buf)
  208. {
  209. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  210. long long value;
  211. value = ltc2945_reg_to_val(dev, attr->index);
  212. if (value < 0)
  213. return value;
  214. return sysfs_emit(buf, "%lld\n", value);
  215. }
  216. static ssize_t ltc2945_value_store(struct device *dev,
  217. struct device_attribute *da,
  218. const char *buf, size_t count)
  219. {
  220. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  221. struct regmap *regmap = dev_get_drvdata(dev);
  222. u8 reg = attr->index;
  223. unsigned long val;
  224. u8 regbuf[3];
  225. int num_regs;
  226. int regval;
  227. int ret;
  228. ret = kstrtoul(buf, 10, &val);
  229. if (ret)
  230. return ret;
  231. /* convert to register value, then clamp and write result */
  232. regval = ltc2945_val_to_reg(dev, reg, val);
  233. if (regval < 0)
  234. return regval;
  235. if (is_power_reg(reg)) {
  236. regval = clamp_val(regval, 0, 0xffffff);
  237. regbuf[0] = regval >> 16;
  238. regbuf[1] = (regval >> 8) & 0xff;
  239. regbuf[2] = regval;
  240. num_regs = 3;
  241. } else {
  242. regval = clamp_val(regval, 0, 0xfff) << 4;
  243. regbuf[0] = regval >> 8;
  244. regbuf[1] = regval & 0xff;
  245. num_regs = 2;
  246. }
  247. ret = regmap_bulk_write(regmap, reg, regbuf, num_regs);
  248. return ret < 0 ? ret : count;
  249. }
  250. static ssize_t ltc2945_history_store(struct device *dev,
  251. struct device_attribute *da,
  252. const char *buf, size_t count)
  253. {
  254. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  255. struct regmap *regmap = dev_get_drvdata(dev);
  256. u8 reg = attr->index;
  257. int num_regs = is_power_reg(reg) ? 3 : 2;
  258. u8 buf_min[3] = { 0xff, 0xff, 0xff };
  259. u8 buf_max[3] = { 0, 0, 0 };
  260. unsigned long val;
  261. int ret;
  262. ret = kstrtoul(buf, 10, &val);
  263. if (ret)
  264. return ret;
  265. if (val != 1)
  266. return -EINVAL;
  267. ret = regmap_update_bits(regmap, LTC2945_CONTROL, CONTROL_TEST_MODE,
  268. CONTROL_TEST_MODE);
  269. /* Reset minimum */
  270. ret = regmap_bulk_write(regmap, reg, buf_min, num_regs);
  271. if (ret)
  272. return ret;
  273. switch (reg) {
  274. case LTC2945_MIN_POWER_H:
  275. reg = LTC2945_MAX_POWER_H;
  276. break;
  277. case LTC2945_MIN_SENSE_H:
  278. reg = LTC2945_MAX_SENSE_H;
  279. break;
  280. case LTC2945_MIN_VIN_H:
  281. reg = LTC2945_MAX_VIN_H;
  282. break;
  283. case LTC2945_MIN_ADIN_H:
  284. reg = LTC2945_MAX_ADIN_H;
  285. break;
  286. default:
  287. WARN_ONCE(1, "Bad register: 0x%x\n", reg);
  288. return -EINVAL;
  289. }
  290. /* Reset maximum */
  291. ret = regmap_bulk_write(regmap, reg, buf_max, num_regs);
  292. /* Try resetting test mode even if there was an error */
  293. regmap_update_bits(regmap, LTC2945_CONTROL, CONTROL_TEST_MODE, 0);
  294. return ret ? : count;
  295. }
  296. static ssize_t ltc2945_bool_show(struct device *dev,
  297. struct device_attribute *da, char *buf)
  298. {
  299. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  300. struct regmap *regmap = dev_get_drvdata(dev);
  301. unsigned int fault;
  302. int ret;
  303. ret = regmap_read(regmap, LTC2945_FAULT, &fault);
  304. if (ret < 0)
  305. return ret;
  306. fault &= attr->index;
  307. if (fault) /* Clear reported faults in chip register */
  308. regmap_update_bits(regmap, LTC2945_FAULT, attr->index, 0);
  309. return sysfs_emit(buf, "%d\n", !!fault);
  310. }
  311. /* Input voltages */
  312. static SENSOR_DEVICE_ATTR_RO(in1_input, ltc2945_value, LTC2945_VIN_H);
  313. static SENSOR_DEVICE_ATTR_RW(in1_min, ltc2945_value, LTC2945_MIN_VIN_THRES_H);
  314. static SENSOR_DEVICE_ATTR_RW(in1_max, ltc2945_value, LTC2945_MAX_VIN_THRES_H);
  315. static SENSOR_DEVICE_ATTR_RO(in1_lowest, ltc2945_value, LTC2945_MIN_VIN_H);
  316. static SENSOR_DEVICE_ATTR_RO(in1_highest, ltc2945_value, LTC2945_MAX_VIN_H);
  317. static SENSOR_DEVICE_ATTR_WO(in1_reset_history, ltc2945_history,
  318. LTC2945_MIN_VIN_H);
  319. static SENSOR_DEVICE_ATTR_RO(in2_input, ltc2945_value, LTC2945_ADIN_H);
  320. static SENSOR_DEVICE_ATTR_RW(in2_min, ltc2945_value, LTC2945_MIN_ADIN_THRES_H);
  321. static SENSOR_DEVICE_ATTR_RW(in2_max, ltc2945_value, LTC2945_MAX_ADIN_THRES_H);
  322. static SENSOR_DEVICE_ATTR_RO(in2_lowest, ltc2945_value, LTC2945_MIN_ADIN_H);
  323. static SENSOR_DEVICE_ATTR_RO(in2_highest, ltc2945_value, LTC2945_MAX_ADIN_H);
  324. static SENSOR_DEVICE_ATTR_WO(in2_reset_history, ltc2945_history,
  325. LTC2945_MIN_ADIN_H);
  326. /* Voltage alarms */
  327. static SENSOR_DEVICE_ATTR_RO(in1_min_alarm, ltc2945_bool, FAULT_VIN_UV);
  328. static SENSOR_DEVICE_ATTR_RO(in1_max_alarm, ltc2945_bool, FAULT_VIN_OV);
  329. static SENSOR_DEVICE_ATTR_RO(in2_min_alarm, ltc2945_bool, FAULT_ADIN_UV);
  330. static SENSOR_DEVICE_ATTR_RO(in2_max_alarm, ltc2945_bool, FAULT_ADIN_OV);
  331. /* Currents (via sense resistor) */
  332. static SENSOR_DEVICE_ATTR_RO(curr1_input, ltc2945_value, LTC2945_SENSE_H);
  333. static SENSOR_DEVICE_ATTR_RW(curr1_min, ltc2945_value,
  334. LTC2945_MIN_SENSE_THRES_H);
  335. static SENSOR_DEVICE_ATTR_RW(curr1_max, ltc2945_value,
  336. LTC2945_MAX_SENSE_THRES_H);
  337. static SENSOR_DEVICE_ATTR_RO(curr1_lowest, ltc2945_value, LTC2945_MIN_SENSE_H);
  338. static SENSOR_DEVICE_ATTR_RO(curr1_highest, ltc2945_value,
  339. LTC2945_MAX_SENSE_H);
  340. static SENSOR_DEVICE_ATTR_WO(curr1_reset_history, ltc2945_history,
  341. LTC2945_MIN_SENSE_H);
  342. /* Current alarms */
  343. static SENSOR_DEVICE_ATTR_RO(curr1_min_alarm, ltc2945_bool, FAULT_SENSE_UV);
  344. static SENSOR_DEVICE_ATTR_RO(curr1_max_alarm, ltc2945_bool, FAULT_SENSE_OV);
  345. /* Power */
  346. static SENSOR_DEVICE_ATTR_RO(power1_input, ltc2945_value, LTC2945_POWER_H);
  347. static SENSOR_DEVICE_ATTR_RW(power1_min, ltc2945_value,
  348. LTC2945_MIN_POWER_THRES_H);
  349. static SENSOR_DEVICE_ATTR_RW(power1_max, ltc2945_value,
  350. LTC2945_MAX_POWER_THRES_H);
  351. static SENSOR_DEVICE_ATTR_RO(power1_input_lowest, ltc2945_value,
  352. LTC2945_MIN_POWER_H);
  353. static SENSOR_DEVICE_ATTR_RO(power1_input_highest, ltc2945_value,
  354. LTC2945_MAX_POWER_H);
  355. static SENSOR_DEVICE_ATTR_WO(power1_reset_history, ltc2945_history,
  356. LTC2945_MIN_POWER_H);
  357. /* Power alarms */
  358. static SENSOR_DEVICE_ATTR_RO(power1_min_alarm, ltc2945_bool, FAULT_POWER_UV);
  359. static SENSOR_DEVICE_ATTR_RO(power1_max_alarm, ltc2945_bool, FAULT_POWER_OV);
  360. static struct attribute *ltc2945_attrs[] = {
  361. &sensor_dev_attr_in1_input.dev_attr.attr,
  362. &sensor_dev_attr_in1_min.dev_attr.attr,
  363. &sensor_dev_attr_in1_max.dev_attr.attr,
  364. &sensor_dev_attr_in1_lowest.dev_attr.attr,
  365. &sensor_dev_attr_in1_highest.dev_attr.attr,
  366. &sensor_dev_attr_in1_reset_history.dev_attr.attr,
  367. &sensor_dev_attr_in1_min_alarm.dev_attr.attr,
  368. &sensor_dev_attr_in1_max_alarm.dev_attr.attr,
  369. &sensor_dev_attr_in2_input.dev_attr.attr,
  370. &sensor_dev_attr_in2_min.dev_attr.attr,
  371. &sensor_dev_attr_in2_max.dev_attr.attr,
  372. &sensor_dev_attr_in2_lowest.dev_attr.attr,
  373. &sensor_dev_attr_in2_highest.dev_attr.attr,
  374. &sensor_dev_attr_in2_reset_history.dev_attr.attr,
  375. &sensor_dev_attr_in2_min_alarm.dev_attr.attr,
  376. &sensor_dev_attr_in2_max_alarm.dev_attr.attr,
  377. &sensor_dev_attr_curr1_input.dev_attr.attr,
  378. &sensor_dev_attr_curr1_min.dev_attr.attr,
  379. &sensor_dev_attr_curr1_max.dev_attr.attr,
  380. &sensor_dev_attr_curr1_lowest.dev_attr.attr,
  381. &sensor_dev_attr_curr1_highest.dev_attr.attr,
  382. &sensor_dev_attr_curr1_reset_history.dev_attr.attr,
  383. &sensor_dev_attr_curr1_min_alarm.dev_attr.attr,
  384. &sensor_dev_attr_curr1_max_alarm.dev_attr.attr,
  385. &sensor_dev_attr_power1_input.dev_attr.attr,
  386. &sensor_dev_attr_power1_min.dev_attr.attr,
  387. &sensor_dev_attr_power1_max.dev_attr.attr,
  388. &sensor_dev_attr_power1_input_lowest.dev_attr.attr,
  389. &sensor_dev_attr_power1_input_highest.dev_attr.attr,
  390. &sensor_dev_attr_power1_reset_history.dev_attr.attr,
  391. &sensor_dev_attr_power1_min_alarm.dev_attr.attr,
  392. &sensor_dev_attr_power1_max_alarm.dev_attr.attr,
  393. NULL,
  394. };
  395. ATTRIBUTE_GROUPS(ltc2945);
  396. static const struct regmap_config ltc2945_regmap_config = {
  397. .reg_bits = 8,
  398. .val_bits = 8,
  399. .max_register = LTC2945_MIN_ADIN_THRES_L,
  400. };
  401. static int ltc2945_probe(struct i2c_client *client)
  402. {
  403. struct device *dev = &client->dev;
  404. struct device *hwmon_dev;
  405. struct regmap *regmap;
  406. regmap = devm_regmap_init_i2c(client, &ltc2945_regmap_config);
  407. if (IS_ERR(regmap)) {
  408. dev_err(dev, "failed to allocate register map\n");
  409. return PTR_ERR(regmap);
  410. }
  411. /* Clear faults */
  412. regmap_write(regmap, LTC2945_FAULT, 0x00);
  413. hwmon_dev = devm_hwmon_device_register_with_groups(dev, client->name,
  414. regmap,
  415. ltc2945_groups);
  416. return PTR_ERR_OR_ZERO(hwmon_dev);
  417. }
  418. static const struct i2c_device_id ltc2945_id[] = {
  419. {"ltc2945", 0},
  420. { }
  421. };
  422. MODULE_DEVICE_TABLE(i2c, ltc2945_id);
  423. static struct i2c_driver ltc2945_driver = {
  424. .driver = {
  425. .name = "ltc2945",
  426. },
  427. .probe_new = ltc2945_probe,
  428. .id_table = ltc2945_id,
  429. };
  430. module_i2c_driver(ltc2945_driver);
  431. MODULE_AUTHOR("Guenter Roeck <[email protected]>");
  432. MODULE_DESCRIPTION("LTC2945 driver");
  433. MODULE_LICENSE("GPL");