lm75.c 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451
  1. /*
  2. * lm75.c - Part of lm_sensors, Linux kernel modules for hardware
  3. * monitoring
  4. * Copyright (c) 1998, 1999 Frodo Looijaard <frodol@dds.nl>
  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/module.h>
  21. #include <linux/init.h>
  22. #include <linux/slab.h>
  23. #include <linux/jiffies.h>
  24. #include <linux/i2c.h>
  25. #include <linux/hwmon.h>
  26. #include <linux/hwmon-sysfs.h>
  27. #include <linux/err.h>
  28. #include <linux/mutex.h>
  29. #include "lm75.h"
  30. /*
  31. * This driver handles the LM75 and compatible digital temperature sensors.
  32. */
  33. enum lm75_type { /* keep sorted in alphabetical order */
  34. adt75,
  35. ds1775,
  36. ds75,
  37. lm75,
  38. lm75a,
  39. max6625,
  40. max6626,
  41. mcp980x,
  42. stds75,
  43. tcn75,
  44. tmp100,
  45. tmp101,
  46. tmp105,
  47. tmp175,
  48. tmp275,
  49. tmp75,
  50. };
  51. /* Addresses scanned */
  52. static const unsigned short normal_i2c[] = { 0x48, 0x49, 0x4a, 0x4b, 0x4c,
  53. 0x4d, 0x4e, 0x4f, I2C_CLIENT_END };
  54. /* The LM75 registers */
  55. #define LM75_REG_CONF 0x01
  56. static const u8 LM75_REG_TEMP[3] = {
  57. 0x00, /* input */
  58. 0x03, /* max */
  59. 0x02, /* hyst */
  60. };
  61. /* Each client has this additional data */
  62. struct lm75_data {
  63. struct device *hwmon_dev;
  64. struct mutex update_lock;
  65. u8 orig_conf;
  66. char valid; /* !=0 if registers are valid */
  67. unsigned long last_updated; /* In jiffies */
  68. u16 temp[3]; /* Register values,
  69. 0 = input
  70. 1 = max
  71. 2 = hyst */
  72. };
  73. static int lm75_read_value(struct i2c_client *client, u8 reg);
  74. static int lm75_write_value(struct i2c_client *client, u8 reg, u16 value);
  75. static struct lm75_data *lm75_update_device(struct device *dev);
  76. /*-----------------------------------------------------------------------*/
  77. /* sysfs attributes for hwmon */
  78. static ssize_t show_temp(struct device *dev, struct device_attribute *da,
  79. char *buf)
  80. {
  81. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  82. struct lm75_data *data = lm75_update_device(dev);
  83. return sprintf(buf, "%d\n",
  84. LM75_TEMP_FROM_REG(data->temp[attr->index]));
  85. }
  86. static ssize_t set_temp(struct device *dev, struct device_attribute *da,
  87. const char *buf, size_t count)
  88. {
  89. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  90. struct i2c_client *client = to_i2c_client(dev);
  91. struct lm75_data *data = i2c_get_clientdata(client);
  92. int nr = attr->index;
  93. long temp;
  94. int error;
  95. error = strict_strtol(buf, 10, &temp);
  96. if (error)
  97. return error;
  98. mutex_lock(&data->update_lock);
  99. data->temp[nr] = LM75_TEMP_TO_REG(temp);
  100. lm75_write_value(client, LM75_REG_TEMP[nr], data->temp[nr]);
  101. mutex_unlock(&data->update_lock);
  102. return count;
  103. }
  104. static SENSOR_DEVICE_ATTR(temp1_max, S_IWUSR | S_IRUGO,
  105. show_temp, set_temp, 1);
  106. static SENSOR_DEVICE_ATTR(temp1_max_hyst, S_IWUSR | S_IRUGO,
  107. show_temp, set_temp, 2);
  108. static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0);
  109. static struct attribute *lm75_attributes[] = {
  110. &sensor_dev_attr_temp1_input.dev_attr.attr,
  111. &sensor_dev_attr_temp1_max.dev_attr.attr,
  112. &sensor_dev_attr_temp1_max_hyst.dev_attr.attr,
  113. NULL
  114. };
  115. static const struct attribute_group lm75_group = {
  116. .attrs = lm75_attributes,
  117. };
  118. /*-----------------------------------------------------------------------*/
  119. /* device probe and removal */
  120. static int
  121. lm75_probe(struct i2c_client *client, const struct i2c_device_id *id)
  122. {
  123. struct lm75_data *data;
  124. int status;
  125. u8 set_mask, clr_mask;
  126. int new;
  127. if (!i2c_check_functionality(client->adapter,
  128. I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA))
  129. return -EIO;
  130. data = kzalloc(sizeof(struct lm75_data), GFP_KERNEL);
  131. if (!data)
  132. return -ENOMEM;
  133. i2c_set_clientdata(client, data);
  134. mutex_init(&data->update_lock);
  135. /* Set to LM75 resolution (9 bits, 1/2 degree C) and range.
  136. * Then tweak to be more precise when appropriate.
  137. */
  138. set_mask = 0;
  139. clr_mask = (1 << 0) /* continuous conversions */
  140. | (1 << 6) | (1 << 5); /* 9-bit mode */
  141. /* configure as specified */
  142. status = lm75_read_value(client, LM75_REG_CONF);
  143. if (status < 0) {
  144. dev_dbg(&client->dev, "Can't read config? %d\n", status);
  145. goto exit_free;
  146. }
  147. data->orig_conf = status;
  148. new = status & ~clr_mask;
  149. new |= set_mask;
  150. if (status != new)
  151. lm75_write_value(client, LM75_REG_CONF, new);
  152. dev_dbg(&client->dev, "Config %02x\n", new);
  153. /* Register sysfs hooks */
  154. status = sysfs_create_group(&client->dev.kobj, &lm75_group);
  155. if (status)
  156. goto exit_free;
  157. data->hwmon_dev = hwmon_device_register(&client->dev);
  158. if (IS_ERR(data->hwmon_dev)) {
  159. status = PTR_ERR(data->hwmon_dev);
  160. goto exit_remove;
  161. }
  162. dev_info(&client->dev, "%s: sensor '%s'\n",
  163. dev_name(data->hwmon_dev), client->name);
  164. return 0;
  165. exit_remove:
  166. sysfs_remove_group(&client->dev.kobj, &lm75_group);
  167. exit_free:
  168. kfree(data);
  169. return status;
  170. }
  171. static int lm75_remove(struct i2c_client *client)
  172. {
  173. struct lm75_data *data = i2c_get_clientdata(client);
  174. hwmon_device_unregister(data->hwmon_dev);
  175. sysfs_remove_group(&client->dev.kobj, &lm75_group);
  176. lm75_write_value(client, LM75_REG_CONF, data->orig_conf);
  177. kfree(data);
  178. return 0;
  179. }
  180. static const struct i2c_device_id lm75_ids[] = {
  181. { "adt75", adt75, },
  182. { "ds1775", ds1775, },
  183. { "ds75", ds75, },
  184. { "lm75", lm75, },
  185. { "lm75a", lm75a, },
  186. { "max6625", max6625, },
  187. { "max6626", max6626, },
  188. { "mcp980x", mcp980x, },
  189. { "stds75", stds75, },
  190. { "tcn75", tcn75, },
  191. { "tmp100", tmp100, },
  192. { "tmp101", tmp101, },
  193. { "tmp105", tmp105, },
  194. { "tmp175", tmp175, },
  195. { "tmp275", tmp275, },
  196. { "tmp75", tmp75, },
  197. { /* LIST END */ }
  198. };
  199. MODULE_DEVICE_TABLE(i2c, lm75_ids);
  200. #define LM75A_ID 0xA1
  201. /* Return 0 if detection is successful, -ENODEV otherwise */
  202. static int lm75_detect(struct i2c_client *new_client,
  203. struct i2c_board_info *info)
  204. {
  205. struct i2c_adapter *adapter = new_client->adapter;
  206. int i;
  207. int conf, hyst, os;
  208. bool is_lm75a = 0;
  209. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA |
  210. I2C_FUNC_SMBUS_WORD_DATA))
  211. return -ENODEV;
  212. /*
  213. * Now, we do the remaining detection. There is no identification-
  214. * dedicated register so we have to rely on several tricks:
  215. * unused bits, registers cycling over 8-address boundaries,
  216. * addresses 0x04-0x07 returning the last read value.
  217. * The cycling+unused addresses combination is not tested,
  218. * since it would significantly slow the detection down and would
  219. * hardly add any value.
  220. *
  221. * The National Semiconductor LM75A is different than earlier
  222. * LM75s. It has an ID byte of 0xaX (where X is the chip
  223. * revision, with 1 being the only revision in existence) in
  224. * register 7, and unused registers return 0xff rather than the
  225. * last read value.
  226. *
  227. * Note that this function only detects the original National
  228. * Semiconductor LM75 and the LM75A. Clones from other vendors
  229. * aren't detected, on purpose, because they are typically never
  230. * found on PC hardware. They are found on embedded designs where
  231. * they can be instantiated explicitly so detection is not needed.
  232. * The absence of identification registers on all these clones
  233. * would make their exhaustive detection very difficult and weak,
  234. * and odds are that the driver would bind to unsupported devices.
  235. */
  236. /* Unused bits */
  237. conf = i2c_smbus_read_byte_data(new_client, 1);
  238. if (conf & 0xe0)
  239. return -ENODEV;
  240. /* First check for LM75A */
  241. if (i2c_smbus_read_byte_data(new_client, 7) == LM75A_ID) {
  242. /* LM75A returns 0xff on unused registers so
  243. just to be sure we check for that too. */
  244. if (i2c_smbus_read_byte_data(new_client, 4) != 0xff
  245. || i2c_smbus_read_byte_data(new_client, 5) != 0xff
  246. || i2c_smbus_read_byte_data(new_client, 6) != 0xff)
  247. return -ENODEV;
  248. is_lm75a = 1;
  249. hyst = i2c_smbus_read_byte_data(new_client, 2);
  250. os = i2c_smbus_read_byte_data(new_client, 3);
  251. } else { /* Traditional style LM75 detection */
  252. /* Unused addresses */
  253. hyst = i2c_smbus_read_byte_data(new_client, 2);
  254. if (i2c_smbus_read_byte_data(new_client, 4) != hyst
  255. || i2c_smbus_read_byte_data(new_client, 5) != hyst
  256. || i2c_smbus_read_byte_data(new_client, 6) != hyst
  257. || i2c_smbus_read_byte_data(new_client, 7) != hyst)
  258. return -ENODEV;
  259. os = i2c_smbus_read_byte_data(new_client, 3);
  260. if (i2c_smbus_read_byte_data(new_client, 4) != os
  261. || i2c_smbus_read_byte_data(new_client, 5) != os
  262. || i2c_smbus_read_byte_data(new_client, 6) != os
  263. || i2c_smbus_read_byte_data(new_client, 7) != os)
  264. return -ENODEV;
  265. }
  266. /* Addresses cycling */
  267. for (i = 8; i <= 248; i += 40) {
  268. if (i2c_smbus_read_byte_data(new_client, i + 1) != conf
  269. || i2c_smbus_read_byte_data(new_client, i + 2) != hyst
  270. || i2c_smbus_read_byte_data(new_client, i + 3) != os)
  271. return -ENODEV;
  272. if (is_lm75a && i2c_smbus_read_byte_data(new_client, i + 7)
  273. != LM75A_ID)
  274. return -ENODEV;
  275. }
  276. strlcpy(info->type, is_lm75a ? "lm75a" : "lm75", I2C_NAME_SIZE);
  277. return 0;
  278. }
  279. #ifdef CONFIG_PM
  280. static int lm75_suspend(struct device *dev)
  281. {
  282. int status;
  283. struct i2c_client *client = to_i2c_client(dev);
  284. status = lm75_read_value(client, LM75_REG_CONF);
  285. if (status < 0) {
  286. dev_dbg(&client->dev, "Can't read config? %d\n", status);
  287. return status;
  288. }
  289. status = status | LM75_SHUTDOWN;
  290. lm75_write_value(client, LM75_REG_CONF, status);
  291. return 0;
  292. }
  293. static int lm75_resume(struct device *dev)
  294. {
  295. int status;
  296. struct i2c_client *client = to_i2c_client(dev);
  297. status = lm75_read_value(client, LM75_REG_CONF);
  298. if (status < 0) {
  299. dev_dbg(&client->dev, "Can't read config? %d\n", status);
  300. return status;
  301. }
  302. status = status & ~LM75_SHUTDOWN;
  303. lm75_write_value(client, LM75_REG_CONF, status);
  304. return 0;
  305. }
  306. static const struct dev_pm_ops lm75_dev_pm_ops = {
  307. .suspend = lm75_suspend,
  308. .resume = lm75_resume,
  309. };
  310. #define LM75_DEV_PM_OPS (&lm75_dev_pm_ops)
  311. #else
  312. #define LM75_DEV_PM_OPS NULL
  313. #endif /* CONFIG_PM */
  314. static struct i2c_driver lm75_driver = {
  315. .class = I2C_CLASS_HWMON,
  316. .driver = {
  317. .name = "lm75",
  318. .pm = LM75_DEV_PM_OPS,
  319. },
  320. .probe = lm75_probe,
  321. .remove = lm75_remove,
  322. .id_table = lm75_ids,
  323. .detect = lm75_detect,
  324. .address_list = normal_i2c,
  325. };
  326. /*-----------------------------------------------------------------------*/
  327. /* register access */
  328. /*
  329. * All registers are word-sized, except for the configuration register.
  330. * LM75 uses a high-byte first convention, which is exactly opposite to
  331. * the SMBus standard.
  332. */
  333. static int lm75_read_value(struct i2c_client *client, u8 reg)
  334. {
  335. if (reg == LM75_REG_CONF)
  336. return i2c_smbus_read_byte_data(client, reg);
  337. else
  338. return i2c_smbus_read_word_swapped(client, reg);
  339. }
  340. static int lm75_write_value(struct i2c_client *client, u8 reg, u16 value)
  341. {
  342. if (reg == LM75_REG_CONF)
  343. return i2c_smbus_write_byte_data(client, reg, value);
  344. else
  345. return i2c_smbus_write_word_swapped(client, reg, value);
  346. }
  347. static struct lm75_data *lm75_update_device(struct device *dev)
  348. {
  349. struct i2c_client *client = to_i2c_client(dev);
  350. struct lm75_data *data = i2c_get_clientdata(client);
  351. mutex_lock(&data->update_lock);
  352. if (time_after(jiffies, data->last_updated + HZ + HZ / 2)
  353. || !data->valid) {
  354. int i;
  355. dev_dbg(&client->dev, "Starting lm75 update\n");
  356. for (i = 0; i < ARRAY_SIZE(data->temp); i++) {
  357. int status;
  358. status = lm75_read_value(client, LM75_REG_TEMP[i]);
  359. if (status < 0)
  360. dev_dbg(&client->dev, "reg %d, err %d\n",
  361. LM75_REG_TEMP[i], status);
  362. else
  363. data->temp[i] = status;
  364. }
  365. data->last_updated = jiffies;
  366. data->valid = 1;
  367. }
  368. mutex_unlock(&data->update_lock);
  369. return data;
  370. }
  371. /*-----------------------------------------------------------------------*/
  372. /* module glue */
  373. static int __init sensors_lm75_init(void)
  374. {
  375. return i2c_add_driver(&lm75_driver);
  376. }
  377. static void __exit sensors_lm75_exit(void)
  378. {
  379. i2c_del_driver(&lm75_driver);
  380. }
  381. MODULE_AUTHOR("Frodo Looijaard <frodol@dds.nl>");
  382. MODULE_DESCRIPTION("LM75 driver");
  383. MODULE_LICENSE("GPL");
  384. module_init(sensors_lm75_init);
  385. module_exit(sensors_lm75_exit);