max31730.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440
  1. // SPDX-License-Identifier: GPL-2.0-or-later
  2. /*
  3. * Driver for MAX31730 3-Channel Remote Temperature Sensor
  4. *
  5. * Copyright (c) 2019 Guenter Roeck <[email protected]>
  6. */
  7. #include <linux/bits.h>
  8. #include <linux/err.h>
  9. #include <linux/i2c.h>
  10. #include <linux/init.h>
  11. #include <linux/hwmon.h>
  12. #include <linux/module.h>
  13. #include <linux/of_device.h>
  14. #include <linux/of.h>
  15. #include <linux/slab.h>
  16. /* Addresses scanned */
  17. static const unsigned short normal_i2c[] = { 0x1c, 0x1d, 0x1e, 0x1f, 0x4c,
  18. 0x4d, 0x4e, 0x4f, I2C_CLIENT_END };
  19. /* The MAX31730 registers */
  20. #define MAX31730_REG_TEMP 0x00
  21. #define MAX31730_REG_CONF 0x13
  22. #define MAX31730_STOP BIT(7)
  23. #define MAX31730_EXTRANGE BIT(1)
  24. #define MAX31730_REG_TEMP_OFFSET 0x16
  25. #define MAX31730_TEMP_OFFSET_BASELINE 0x77
  26. #define MAX31730_REG_OFFSET_ENABLE 0x17
  27. #define MAX31730_REG_TEMP_MAX 0x20
  28. #define MAX31730_REG_TEMP_MIN 0x30
  29. #define MAX31730_REG_STATUS_HIGH 0x32
  30. #define MAX31730_REG_STATUS_LOW 0x33
  31. #define MAX31730_REG_CHANNEL_ENABLE 0x35
  32. #define MAX31730_REG_TEMP_FAULT 0x36
  33. #define MAX31730_REG_MFG_ID 0x50
  34. #define MAX31730_MFG_ID 0x4d
  35. #define MAX31730_REG_MFG_REV 0x51
  36. #define MAX31730_MFG_REV 0x01
  37. #define MAX31730_TEMP_MIN (-128000)
  38. #define MAX31730_TEMP_MAX 127937
  39. /* Each client has this additional data */
  40. struct max31730_data {
  41. struct i2c_client *client;
  42. u8 orig_conf;
  43. u8 current_conf;
  44. u8 offset_enable;
  45. u8 channel_enable;
  46. };
  47. /*-----------------------------------------------------------------------*/
  48. static inline long max31730_reg_to_mc(s16 temp)
  49. {
  50. return DIV_ROUND_CLOSEST((temp >> 4) * 1000, 16);
  51. }
  52. static int max31730_write_config(struct max31730_data *data, u8 set_mask,
  53. u8 clr_mask)
  54. {
  55. u8 value;
  56. clr_mask |= MAX31730_EXTRANGE;
  57. value = data->current_conf & ~clr_mask;
  58. value |= set_mask;
  59. if (data->current_conf != value) {
  60. s32 err;
  61. err = i2c_smbus_write_byte_data(data->client, MAX31730_REG_CONF,
  62. value);
  63. if (err)
  64. return err;
  65. data->current_conf = value;
  66. }
  67. return 0;
  68. }
  69. static int max31730_set_enable(struct i2c_client *client, int reg,
  70. u8 *confdata, int channel, bool enable)
  71. {
  72. u8 regval = *confdata;
  73. int err;
  74. if (enable)
  75. regval |= BIT(channel);
  76. else
  77. regval &= ~BIT(channel);
  78. if (regval != *confdata) {
  79. err = i2c_smbus_write_byte_data(client, reg, regval);
  80. if (err)
  81. return err;
  82. *confdata = regval;
  83. }
  84. return 0;
  85. }
  86. static int max31730_set_offset_enable(struct max31730_data *data, int channel,
  87. bool enable)
  88. {
  89. return max31730_set_enable(data->client, MAX31730_REG_OFFSET_ENABLE,
  90. &data->offset_enable, channel, enable);
  91. }
  92. static int max31730_set_channel_enable(struct max31730_data *data, int channel,
  93. bool enable)
  94. {
  95. return max31730_set_enable(data->client, MAX31730_REG_CHANNEL_ENABLE,
  96. &data->channel_enable, channel, enable);
  97. }
  98. static int max31730_read(struct device *dev, enum hwmon_sensor_types type,
  99. u32 attr, int channel, long *val)
  100. {
  101. struct max31730_data *data = dev_get_drvdata(dev);
  102. int regval, reg, offset;
  103. if (type != hwmon_temp)
  104. return -EINVAL;
  105. switch (attr) {
  106. case hwmon_temp_input:
  107. if (!(data->channel_enable & BIT(channel)))
  108. return -ENODATA;
  109. reg = MAX31730_REG_TEMP + (channel * 2);
  110. break;
  111. case hwmon_temp_max:
  112. reg = MAX31730_REG_TEMP_MAX + (channel * 2);
  113. break;
  114. case hwmon_temp_min:
  115. reg = MAX31730_REG_TEMP_MIN;
  116. break;
  117. case hwmon_temp_enable:
  118. *val = !!(data->channel_enable & BIT(channel));
  119. return 0;
  120. case hwmon_temp_offset:
  121. if (!channel)
  122. return -EINVAL;
  123. if (!(data->offset_enable & BIT(channel))) {
  124. *val = 0;
  125. return 0;
  126. }
  127. offset = i2c_smbus_read_byte_data(data->client,
  128. MAX31730_REG_TEMP_OFFSET);
  129. if (offset < 0)
  130. return offset;
  131. *val = (offset - MAX31730_TEMP_OFFSET_BASELINE) * 125;
  132. return 0;
  133. case hwmon_temp_fault:
  134. regval = i2c_smbus_read_byte_data(data->client,
  135. MAX31730_REG_TEMP_FAULT);
  136. if (regval < 0)
  137. return regval;
  138. *val = !!(regval & BIT(channel));
  139. return 0;
  140. case hwmon_temp_min_alarm:
  141. regval = i2c_smbus_read_byte_data(data->client,
  142. MAX31730_REG_STATUS_LOW);
  143. if (regval < 0)
  144. return regval;
  145. *val = !!(regval & BIT(channel));
  146. return 0;
  147. case hwmon_temp_max_alarm:
  148. regval = i2c_smbus_read_byte_data(data->client,
  149. MAX31730_REG_STATUS_HIGH);
  150. if (regval < 0)
  151. return regval;
  152. *val = !!(regval & BIT(channel));
  153. return 0;
  154. default:
  155. return -EINVAL;
  156. }
  157. regval = i2c_smbus_read_word_swapped(data->client, reg);
  158. if (regval < 0)
  159. return regval;
  160. *val = max31730_reg_to_mc(regval);
  161. return 0;
  162. }
  163. static int max31730_write(struct device *dev, enum hwmon_sensor_types type,
  164. u32 attr, int channel, long val)
  165. {
  166. struct max31730_data *data = dev_get_drvdata(dev);
  167. int reg, err;
  168. if (type != hwmon_temp)
  169. return -EINVAL;
  170. switch (attr) {
  171. case hwmon_temp_max:
  172. reg = MAX31730_REG_TEMP_MAX + channel * 2;
  173. break;
  174. case hwmon_temp_min:
  175. reg = MAX31730_REG_TEMP_MIN;
  176. break;
  177. case hwmon_temp_enable:
  178. if (val != 0 && val != 1)
  179. return -EINVAL;
  180. return max31730_set_channel_enable(data, channel, val);
  181. case hwmon_temp_offset:
  182. val = clamp_val(val, -14875, 17000) + 14875;
  183. val = DIV_ROUND_CLOSEST(val, 125);
  184. err = max31730_set_offset_enable(data, channel,
  185. val != MAX31730_TEMP_OFFSET_BASELINE);
  186. if (err)
  187. return err;
  188. return i2c_smbus_write_byte_data(data->client,
  189. MAX31730_REG_TEMP_OFFSET, val);
  190. default:
  191. return -EINVAL;
  192. }
  193. val = clamp_val(val, MAX31730_TEMP_MIN, MAX31730_TEMP_MAX);
  194. val = DIV_ROUND_CLOSEST(val << 4, 1000) << 4;
  195. return i2c_smbus_write_word_swapped(data->client, reg, (u16)val);
  196. }
  197. static umode_t max31730_is_visible(const void *data,
  198. enum hwmon_sensor_types type,
  199. u32 attr, int channel)
  200. {
  201. switch (type) {
  202. case hwmon_temp:
  203. switch (attr) {
  204. case hwmon_temp_input:
  205. case hwmon_temp_min_alarm:
  206. case hwmon_temp_max_alarm:
  207. case hwmon_temp_fault:
  208. return 0444;
  209. case hwmon_temp_min:
  210. return channel ? 0444 : 0644;
  211. case hwmon_temp_offset:
  212. case hwmon_temp_enable:
  213. case hwmon_temp_max:
  214. return 0644;
  215. }
  216. break;
  217. default:
  218. break;
  219. }
  220. return 0;
  221. }
  222. static const struct hwmon_channel_info *max31730_info[] = {
  223. HWMON_CHANNEL_INFO(chip,
  224. HWMON_C_REGISTER_TZ),
  225. HWMON_CHANNEL_INFO(temp,
  226. HWMON_T_INPUT | HWMON_T_MIN | HWMON_T_MAX |
  227. HWMON_T_ENABLE |
  228. HWMON_T_MIN_ALARM | HWMON_T_MAX_ALARM,
  229. HWMON_T_INPUT | HWMON_T_MIN | HWMON_T_MAX |
  230. HWMON_T_OFFSET | HWMON_T_ENABLE |
  231. HWMON_T_MIN_ALARM | HWMON_T_MAX_ALARM |
  232. HWMON_T_FAULT,
  233. HWMON_T_INPUT | HWMON_T_MIN | HWMON_T_MAX |
  234. HWMON_T_OFFSET | HWMON_T_ENABLE |
  235. HWMON_T_MIN_ALARM | HWMON_T_MAX_ALARM |
  236. HWMON_T_FAULT,
  237. HWMON_T_INPUT | HWMON_T_MIN | HWMON_T_MAX |
  238. HWMON_T_OFFSET | HWMON_T_ENABLE |
  239. HWMON_T_MIN_ALARM | HWMON_T_MAX_ALARM |
  240. HWMON_T_FAULT
  241. ),
  242. NULL
  243. };
  244. static const struct hwmon_ops max31730_hwmon_ops = {
  245. .is_visible = max31730_is_visible,
  246. .read = max31730_read,
  247. .write = max31730_write,
  248. };
  249. static const struct hwmon_chip_info max31730_chip_info = {
  250. .ops = &max31730_hwmon_ops,
  251. .info = max31730_info,
  252. };
  253. static void max31730_remove(void *data)
  254. {
  255. struct max31730_data *max31730 = data;
  256. struct i2c_client *client = max31730->client;
  257. i2c_smbus_write_byte_data(client, MAX31730_REG_CONF,
  258. max31730->orig_conf);
  259. }
  260. static int
  261. max31730_probe(struct i2c_client *client)
  262. {
  263. struct device *dev = &client->dev;
  264. struct device *hwmon_dev;
  265. struct max31730_data *data;
  266. int status, err;
  267. if (!i2c_check_functionality(client->adapter,
  268. I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA))
  269. return -EIO;
  270. data = devm_kzalloc(dev, sizeof(struct max31730_data), GFP_KERNEL);
  271. if (!data)
  272. return -ENOMEM;
  273. data->client = client;
  274. /* Cache original configuration and enable status */
  275. status = i2c_smbus_read_byte_data(client, MAX31730_REG_CHANNEL_ENABLE);
  276. if (status < 0)
  277. return status;
  278. data->channel_enable = status;
  279. status = i2c_smbus_read_byte_data(client, MAX31730_REG_OFFSET_ENABLE);
  280. if (status < 0)
  281. return status;
  282. data->offset_enable = status;
  283. status = i2c_smbus_read_byte_data(client, MAX31730_REG_CONF);
  284. if (status < 0)
  285. return status;
  286. data->orig_conf = status;
  287. data->current_conf = status;
  288. err = max31730_write_config(data,
  289. data->channel_enable ? 0 : MAX31730_STOP,
  290. data->channel_enable ? MAX31730_STOP : 0);
  291. if (err)
  292. return err;
  293. dev_set_drvdata(dev, data);
  294. err = devm_add_action_or_reset(dev, max31730_remove, data);
  295. if (err)
  296. return err;
  297. hwmon_dev = devm_hwmon_device_register_with_info(dev, client->name,
  298. data,
  299. &max31730_chip_info,
  300. NULL);
  301. return PTR_ERR_OR_ZERO(hwmon_dev);
  302. }
  303. static const struct i2c_device_id max31730_ids[] = {
  304. { "max31730", 0, },
  305. { }
  306. };
  307. MODULE_DEVICE_TABLE(i2c, max31730_ids);
  308. static const struct of_device_id __maybe_unused max31730_of_match[] = {
  309. {
  310. .compatible = "maxim,max31730",
  311. },
  312. { },
  313. };
  314. MODULE_DEVICE_TABLE(of, max31730_of_match);
  315. static bool max31730_check_reg_temp(struct i2c_client *client,
  316. int reg)
  317. {
  318. int regval;
  319. regval = i2c_smbus_read_byte_data(client, reg + 1);
  320. return regval < 0 || (regval & 0x0f);
  321. }
  322. /* Return 0 if detection is successful, -ENODEV otherwise */
  323. static int max31730_detect(struct i2c_client *client,
  324. struct i2c_board_info *info)
  325. {
  326. struct i2c_adapter *adapter = client->adapter;
  327. int regval;
  328. int i;
  329. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA |
  330. I2C_FUNC_SMBUS_WORD_DATA))
  331. return -ENODEV;
  332. regval = i2c_smbus_read_byte_data(client, MAX31730_REG_MFG_ID);
  333. if (regval != MAX31730_MFG_ID)
  334. return -ENODEV;
  335. regval = i2c_smbus_read_byte_data(client, MAX31730_REG_MFG_REV);
  336. if (regval != MAX31730_MFG_REV)
  337. return -ENODEV;
  338. /* lower 4 bit of temperature and limit registers must be 0 */
  339. if (max31730_check_reg_temp(client, MAX31730_REG_TEMP_MIN))
  340. return -ENODEV;
  341. for (i = 0; i < 4; i++) {
  342. if (max31730_check_reg_temp(client, MAX31730_REG_TEMP + i * 2))
  343. return -ENODEV;
  344. if (max31730_check_reg_temp(client,
  345. MAX31730_REG_TEMP_MAX + i * 2))
  346. return -ENODEV;
  347. }
  348. strscpy(info->type, "max31730", I2C_NAME_SIZE);
  349. return 0;
  350. }
  351. static int max31730_suspend(struct device *dev)
  352. {
  353. struct max31730_data *data = dev_get_drvdata(dev);
  354. return max31730_write_config(data, MAX31730_STOP, 0);
  355. }
  356. static int max31730_resume(struct device *dev)
  357. {
  358. struct max31730_data *data = dev_get_drvdata(dev);
  359. return max31730_write_config(data, 0, MAX31730_STOP);
  360. }
  361. static DEFINE_SIMPLE_DEV_PM_OPS(max31730_pm_ops, max31730_suspend, max31730_resume);
  362. static struct i2c_driver max31730_driver = {
  363. .class = I2C_CLASS_HWMON,
  364. .driver = {
  365. .name = "max31730",
  366. .of_match_table = of_match_ptr(max31730_of_match),
  367. .pm = pm_sleep_ptr(&max31730_pm_ops),
  368. },
  369. .probe_new = max31730_probe,
  370. .id_table = max31730_ids,
  371. .detect = max31730_detect,
  372. .address_list = normal_i2c,
  373. };
  374. module_i2c_driver(max31730_driver);
  375. MODULE_AUTHOR("Guenter Roeck <[email protected]>");
  376. MODULE_DESCRIPTION("MAX31730 driver");
  377. MODULE_LICENSE("GPL");