w83l785ts.c 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321
  1. /*
  2. * w83l785ts.c - Part of lm_sensors, Linux kernel modules for hardware
  3. * monitoring
  4. * Copyright (C) 2003-2009 Jean Delvare <khali@linux-fr.org>
  5. *
  6. * Inspired from the lm83 driver. The W83L785TS-S is a sensor chip made
  7. * by Winbond. It reports a single external temperature with a 1 deg
  8. * resolution and a 3 deg accuracy. Datasheet can be obtained from
  9. * Winbond's website at:
  10. * http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L785TS-S.pdf
  11. *
  12. * Ported to Linux 2.6 by Wolfgang Ziegler <nuppla@gmx.at> and Jean Delvare
  13. * <khali@linux-fr.org>.
  14. *
  15. * Thanks to James Bolt <james@evilpenguin.com> for benchmarking the read
  16. * error handling mechanism.
  17. *
  18. * This program is free software; you can redistribute it and/or modify
  19. * it under the terms of the GNU General Public License as published by
  20. * the Free Software Foundation; either version 2 of the License, or
  21. * (at your option) any later version.
  22. *
  23. * This program is distributed in the hope that it will be useful,
  24. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  25. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  26. * GNU General Public License for more details.
  27. *
  28. * You should have received a copy of the GNU General Public License
  29. * along with this program; if not, write to the Free Software
  30. * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  31. */
  32. #include <linux/module.h>
  33. #include <linux/delay.h>
  34. #include <linux/init.h>
  35. #include <linux/slab.h>
  36. #include <linux/jiffies.h>
  37. #include <linux/i2c.h>
  38. #include <linux/hwmon.h>
  39. #include <linux/hwmon-sysfs.h>
  40. #include <linux/err.h>
  41. #include <linux/mutex.h>
  42. /* How many retries on register read error */
  43. #define MAX_RETRIES 5
  44. /*
  45. * Address to scan
  46. * Address is fully defined internally and cannot be changed.
  47. */
  48. static const unsigned short normal_i2c[] = { 0x2e, I2C_CLIENT_END };
  49. /*
  50. * The W83L785TS-S registers
  51. * Manufacturer ID is 0x5CA3 for Winbond.
  52. */
  53. #define W83L785TS_REG_MAN_ID1 0x4D
  54. #define W83L785TS_REG_MAN_ID2 0x4C
  55. #define W83L785TS_REG_CHIP_ID 0x4E
  56. #define W83L785TS_REG_CONFIG 0x40
  57. #define W83L785TS_REG_TYPE 0x52
  58. #define W83L785TS_REG_TEMP 0x27
  59. #define W83L785TS_REG_TEMP_OVER 0x53 /* not sure about this one */
  60. /*
  61. * Conversions
  62. * The W83L785TS-S uses signed 8-bit values.
  63. */
  64. #define TEMP_FROM_REG(val) ((val) * 1000)
  65. /*
  66. * Functions declaration
  67. */
  68. static int w83l785ts_probe(struct i2c_client *client,
  69. const struct i2c_device_id *id);
  70. static int w83l785ts_detect(struct i2c_client *client,
  71. struct i2c_board_info *info);
  72. static int w83l785ts_remove(struct i2c_client *client);
  73. static u8 w83l785ts_read_value(struct i2c_client *client, u8 reg, u8 defval);
  74. static struct w83l785ts_data *w83l785ts_update_device(struct device *dev);
  75. /*
  76. * Driver data (common to all clients)
  77. */
  78. static const struct i2c_device_id w83l785ts_id[] = {
  79. { "w83l785ts", 0 },
  80. { }
  81. };
  82. MODULE_DEVICE_TABLE(i2c, w83l785ts_id);
  83. static struct i2c_driver w83l785ts_driver = {
  84. .class = I2C_CLASS_HWMON,
  85. .driver = {
  86. .name = "w83l785ts",
  87. },
  88. .probe = w83l785ts_probe,
  89. .remove = w83l785ts_remove,
  90. .id_table = w83l785ts_id,
  91. .detect = w83l785ts_detect,
  92. .address_list = normal_i2c,
  93. };
  94. /*
  95. * Client data (each client gets its own)
  96. */
  97. struct w83l785ts_data {
  98. struct device *hwmon_dev;
  99. struct mutex update_lock;
  100. char valid; /* zero until following fields are valid */
  101. unsigned long last_updated; /* in jiffies */
  102. /* registers values */
  103. s8 temp[2]; /* 0: input
  104. 1: critical limit */
  105. };
  106. /*
  107. * Sysfs stuff
  108. */
  109. static ssize_t show_temp(struct device *dev, struct device_attribute *devattr,
  110. char *buf)
  111. {
  112. struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
  113. struct w83l785ts_data *data = w83l785ts_update_device(dev);
  114. return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp[attr->index]));
  115. }
  116. static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0);
  117. static SENSOR_DEVICE_ATTR(temp1_max, S_IRUGO, show_temp, NULL, 1);
  118. /*
  119. * Real code
  120. */
  121. /* Return 0 if detection is successful, -ENODEV otherwise */
  122. static int w83l785ts_detect(struct i2c_client *client,
  123. struct i2c_board_info *info)
  124. {
  125. struct i2c_adapter *adapter = client->adapter;
  126. u16 man_id;
  127. u8 chip_id;
  128. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
  129. return -ENODEV;
  130. /* detection */
  131. if ((w83l785ts_read_value(client, W83L785TS_REG_CONFIG, 0) & 0x80)
  132. || (w83l785ts_read_value(client, W83L785TS_REG_TYPE, 0) & 0xFC)) {
  133. dev_dbg(&adapter->dev,
  134. "W83L785TS-S detection failed at 0x%02x\n",
  135. client->addr);
  136. return -ENODEV;
  137. }
  138. /* Identification */
  139. man_id = (w83l785ts_read_value(client, W83L785TS_REG_MAN_ID1, 0) << 8)
  140. + w83l785ts_read_value(client, W83L785TS_REG_MAN_ID2, 0);
  141. chip_id = w83l785ts_read_value(client, W83L785TS_REG_CHIP_ID, 0);
  142. if (man_id != 0x5CA3 /* Winbond */
  143. || chip_id != 0x70) { /* W83L785TS-S */
  144. dev_dbg(&adapter->dev,
  145. "Unsupported chip (man_id=0x%04X, chip_id=0x%02X)\n",
  146. man_id, chip_id);
  147. return -ENODEV;
  148. }
  149. strlcpy(info->type, "w83l785ts", I2C_NAME_SIZE);
  150. return 0;
  151. }
  152. static int w83l785ts_probe(struct i2c_client *new_client,
  153. const struct i2c_device_id *id)
  154. {
  155. struct w83l785ts_data *data;
  156. int err = 0;
  157. data = kzalloc(sizeof(struct w83l785ts_data), GFP_KERNEL);
  158. if (!data) {
  159. err = -ENOMEM;
  160. goto exit;
  161. }
  162. i2c_set_clientdata(new_client, data);
  163. data->valid = 0;
  164. mutex_init(&data->update_lock);
  165. /* Default values in case the first read fails (unlikely). */
  166. data->temp[1] = data->temp[0] = 0;
  167. /*
  168. * Initialize the W83L785TS chip
  169. * Nothing yet, assume it is already started.
  170. */
  171. err = device_create_file(&new_client->dev,
  172. &sensor_dev_attr_temp1_input.dev_attr);
  173. if (err)
  174. goto exit_remove;
  175. err = device_create_file(&new_client->dev,
  176. &sensor_dev_attr_temp1_max.dev_attr);
  177. if (err)
  178. goto exit_remove;
  179. /* Register sysfs hooks */
  180. data->hwmon_dev = hwmon_device_register(&new_client->dev);
  181. if (IS_ERR(data->hwmon_dev)) {
  182. err = PTR_ERR(data->hwmon_dev);
  183. goto exit_remove;
  184. }
  185. return 0;
  186. exit_remove:
  187. device_remove_file(&new_client->dev,
  188. &sensor_dev_attr_temp1_input.dev_attr);
  189. device_remove_file(&new_client->dev,
  190. &sensor_dev_attr_temp1_max.dev_attr);
  191. kfree(data);
  192. exit:
  193. return err;
  194. }
  195. static int w83l785ts_remove(struct i2c_client *client)
  196. {
  197. struct w83l785ts_data *data = i2c_get_clientdata(client);
  198. hwmon_device_unregister(data->hwmon_dev);
  199. device_remove_file(&client->dev,
  200. &sensor_dev_attr_temp1_input.dev_attr);
  201. device_remove_file(&client->dev,
  202. &sensor_dev_attr_temp1_max.dev_attr);
  203. kfree(data);
  204. return 0;
  205. }
  206. static u8 w83l785ts_read_value(struct i2c_client *client, u8 reg, u8 defval)
  207. {
  208. int value, i;
  209. struct device *dev;
  210. const char *prefix;
  211. /* We might be called during detection, at which point the client
  212. isn't yet fully initialized, so we can't use dev_dbg on it */
  213. if (i2c_get_clientdata(client)) {
  214. dev = &client->dev;
  215. prefix = "";
  216. } else {
  217. dev = &client->adapter->dev;
  218. prefix = "w83l785ts: ";
  219. }
  220. /* Frequent read errors have been reported on Asus boards, so we
  221. * retry on read errors. If it still fails (unlikely), return the
  222. * default value requested by the caller. */
  223. for (i = 1; i <= MAX_RETRIES; i++) {
  224. value = i2c_smbus_read_byte_data(client, reg);
  225. if (value >= 0) {
  226. dev_dbg(dev, "%sRead 0x%02x from register 0x%02x.\n",
  227. prefix, value, reg);
  228. return value;
  229. }
  230. dev_dbg(dev, "%sRead failed, will retry in %d.\n", prefix, i);
  231. msleep(i);
  232. }
  233. dev_err(dev, "%sCouldn't read value from register 0x%02x.\n", prefix,
  234. reg);
  235. return defval;
  236. }
  237. static struct w83l785ts_data *w83l785ts_update_device(struct device *dev)
  238. {
  239. struct i2c_client *client = to_i2c_client(dev);
  240. struct w83l785ts_data *data = i2c_get_clientdata(client);
  241. mutex_lock(&data->update_lock);
  242. if (!data->valid || time_after(jiffies, data->last_updated + HZ * 2)) {
  243. dev_dbg(&client->dev, "Updating w83l785ts data.\n");
  244. data->temp[0] = w83l785ts_read_value(client,
  245. W83L785TS_REG_TEMP, data->temp[0]);
  246. data->temp[1] = w83l785ts_read_value(client,
  247. W83L785TS_REG_TEMP_OVER, data->temp[1]);
  248. data->last_updated = jiffies;
  249. data->valid = 1;
  250. }
  251. mutex_unlock(&data->update_lock);
  252. return data;
  253. }
  254. static int __init sensors_w83l785ts_init(void)
  255. {
  256. return i2c_add_driver(&w83l785ts_driver);
  257. }
  258. static void __exit sensors_w83l785ts_exit(void)
  259. {
  260. i2c_del_driver(&w83l785ts_driver);
  261. }
  262. MODULE_AUTHOR("Jean Delvare <khali@linux-fr.org>");
  263. MODULE_DESCRIPTION("W83L785TS-S driver");
  264. MODULE_LICENSE("GPL");
  265. module_init(sensors_w83l785ts_init);
  266. module_exit(sensors_w83l785ts_exit);