lm83.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438
  1. /*
  2. * lm83.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. * Heavily inspired from the lm78, lm75 and adm1021 drivers. The LM83 is
  7. * a sensor chip made by National Semiconductor. It reports up to four
  8. * temperatures (its own plus up to three external ones) with a 1 deg
  9. * resolution and a 3-4 deg accuracy. Complete datasheet can be obtained
  10. * from National's website at:
  11. * http://www.national.com/pf/LM/LM83.html
  12. * Since the datasheet omits to give the chip stepping code, I give it
  13. * here: 0x03 (at register 0xff).
  14. *
  15. * Also supports the LM82 temp sensor, which is basically a stripped down
  16. * model of the LM83. Datasheet is here:
  17. * http://www.national.com/pf/LM/LM82.html
  18. *
  19. * This program is free software; you can redistribute it and/or modify
  20. * it under the terms of the GNU General Public License as published by
  21. * the Free Software Foundation; either version 2 of the License, or
  22. * (at your option) any later version.
  23. *
  24. * This program is distributed in the hope that it will be useful,
  25. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  26. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  27. * GNU General Public License for more details.
  28. *
  29. * You should have received a copy of the GNU General Public License
  30. * along with this program; if not, write to the Free Software
  31. * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  32. */
  33. #include <linux/module.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-sysfs.h>
  39. #include <linux/hwmon.h>
  40. #include <linux/err.h>
  41. #include <linux/mutex.h>
  42. #include <linux/sysfs.h>
  43. /*
  44. * Addresses to scan
  45. * Address is selected using 2 three-level pins, resulting in 9 possible
  46. * addresses.
  47. */
  48. static const unsigned short normal_i2c[] = {
  49. 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b, 0x4c, 0x4d, 0x4e, I2C_CLIENT_END };
  50. enum chips { lm83, lm82 };
  51. /*
  52. * The LM83 registers
  53. * Manufacturer ID is 0x01 for National Semiconductor.
  54. */
  55. #define LM83_REG_R_MAN_ID 0xFE
  56. #define LM83_REG_R_CHIP_ID 0xFF
  57. #define LM83_REG_R_CONFIG 0x03
  58. #define LM83_REG_W_CONFIG 0x09
  59. #define LM83_REG_R_STATUS1 0x02
  60. #define LM83_REG_R_STATUS2 0x35
  61. #define LM83_REG_R_LOCAL_TEMP 0x00
  62. #define LM83_REG_R_LOCAL_HIGH 0x05
  63. #define LM83_REG_W_LOCAL_HIGH 0x0B
  64. #define LM83_REG_R_REMOTE1_TEMP 0x30
  65. #define LM83_REG_R_REMOTE1_HIGH 0x38
  66. #define LM83_REG_W_REMOTE1_HIGH 0x50
  67. #define LM83_REG_R_REMOTE2_TEMP 0x01
  68. #define LM83_REG_R_REMOTE2_HIGH 0x07
  69. #define LM83_REG_W_REMOTE2_HIGH 0x0D
  70. #define LM83_REG_R_REMOTE3_TEMP 0x31
  71. #define LM83_REG_R_REMOTE3_HIGH 0x3A
  72. #define LM83_REG_W_REMOTE3_HIGH 0x52
  73. #define LM83_REG_R_TCRIT 0x42
  74. #define LM83_REG_W_TCRIT 0x5A
  75. /*
  76. * Conversions and various macros
  77. * The LM83 uses signed 8-bit values with LSB = 1 degree Celsius.
  78. */
  79. #define TEMP_FROM_REG(val) ((val) * 1000)
  80. #define TEMP_TO_REG(val) ((val) <= -128000 ? -128 : \
  81. (val) >= 127000 ? 127 : \
  82. (val) < 0 ? ((val) - 500) / 1000 : \
  83. ((val) + 500) / 1000)
  84. static const u8 LM83_REG_R_TEMP[] = {
  85. LM83_REG_R_LOCAL_TEMP,
  86. LM83_REG_R_REMOTE1_TEMP,
  87. LM83_REG_R_REMOTE2_TEMP,
  88. LM83_REG_R_REMOTE3_TEMP,
  89. LM83_REG_R_LOCAL_HIGH,
  90. LM83_REG_R_REMOTE1_HIGH,
  91. LM83_REG_R_REMOTE2_HIGH,
  92. LM83_REG_R_REMOTE3_HIGH,
  93. LM83_REG_R_TCRIT,
  94. };
  95. static const u8 LM83_REG_W_HIGH[] = {
  96. LM83_REG_W_LOCAL_HIGH,
  97. LM83_REG_W_REMOTE1_HIGH,
  98. LM83_REG_W_REMOTE2_HIGH,
  99. LM83_REG_W_REMOTE3_HIGH,
  100. LM83_REG_W_TCRIT,
  101. };
  102. /*
  103. * Functions declaration
  104. */
  105. static int lm83_detect(struct i2c_client *new_client,
  106. struct i2c_board_info *info);
  107. static int lm83_probe(struct i2c_client *client,
  108. const struct i2c_device_id *id);
  109. static int lm83_remove(struct i2c_client *client);
  110. static struct lm83_data *lm83_update_device(struct device *dev);
  111. /*
  112. * Driver data (common to all clients)
  113. */
  114. static const struct i2c_device_id lm83_id[] = {
  115. { "lm83", lm83 },
  116. { "lm82", lm82 },
  117. { }
  118. };
  119. MODULE_DEVICE_TABLE(i2c, lm83_id);
  120. static struct i2c_driver lm83_driver = {
  121. .class = I2C_CLASS_HWMON,
  122. .driver = {
  123. .name = "lm83",
  124. },
  125. .probe = lm83_probe,
  126. .remove = lm83_remove,
  127. .id_table = lm83_id,
  128. .detect = lm83_detect,
  129. .address_list = normal_i2c,
  130. };
  131. /*
  132. * Client data (each client gets its own)
  133. */
  134. struct lm83_data {
  135. struct device *hwmon_dev;
  136. struct mutex update_lock;
  137. char valid; /* zero until following fields are valid */
  138. unsigned long last_updated; /* in jiffies */
  139. /* registers values */
  140. s8 temp[9]; /* 0..3: input 1-4,
  141. 4..7: high limit 1-4,
  142. 8 : critical limit */
  143. u16 alarms; /* bitvector, combined */
  144. };
  145. /*
  146. * Sysfs stuff
  147. */
  148. static ssize_t show_temp(struct device *dev, struct device_attribute *devattr,
  149. char *buf)
  150. {
  151. struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
  152. struct lm83_data *data = lm83_update_device(dev);
  153. return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp[attr->index]));
  154. }
  155. static ssize_t set_temp(struct device *dev, struct device_attribute *devattr,
  156. const char *buf, size_t count)
  157. {
  158. struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
  159. struct i2c_client *client = to_i2c_client(dev);
  160. struct lm83_data *data = i2c_get_clientdata(client);
  161. long val;
  162. int nr = attr->index;
  163. int err;
  164. err = kstrtol(buf, 10, &val);
  165. if (err < 0)
  166. return err;
  167. mutex_lock(&data->update_lock);
  168. data->temp[nr] = TEMP_TO_REG(val);
  169. i2c_smbus_write_byte_data(client, LM83_REG_W_HIGH[nr - 4],
  170. data->temp[nr]);
  171. mutex_unlock(&data->update_lock);
  172. return count;
  173. }
  174. static ssize_t show_alarms(struct device *dev, struct device_attribute *dummy,
  175. char *buf)
  176. {
  177. struct lm83_data *data = lm83_update_device(dev);
  178. return sprintf(buf, "%d\n", data->alarms);
  179. }
  180. static ssize_t show_alarm(struct device *dev, struct device_attribute
  181. *devattr, char *buf)
  182. {
  183. struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
  184. struct lm83_data *data = lm83_update_device(dev);
  185. int bitnr = attr->index;
  186. return sprintf(buf, "%d\n", (data->alarms >> bitnr) & 1);
  187. }
  188. static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0);
  189. static SENSOR_DEVICE_ATTR(temp2_input, S_IRUGO, show_temp, NULL, 1);
  190. static SENSOR_DEVICE_ATTR(temp3_input, S_IRUGO, show_temp, NULL, 2);
  191. static SENSOR_DEVICE_ATTR(temp4_input, S_IRUGO, show_temp, NULL, 3);
  192. static SENSOR_DEVICE_ATTR(temp1_max, S_IWUSR | S_IRUGO, show_temp,
  193. set_temp, 4);
  194. static SENSOR_DEVICE_ATTR(temp2_max, S_IWUSR | S_IRUGO, show_temp,
  195. set_temp, 5);
  196. static SENSOR_DEVICE_ATTR(temp3_max, S_IWUSR | S_IRUGO, show_temp,
  197. set_temp, 6);
  198. static SENSOR_DEVICE_ATTR(temp4_max, S_IWUSR | S_IRUGO, show_temp,
  199. set_temp, 7);
  200. static SENSOR_DEVICE_ATTR(temp1_crit, S_IRUGO, show_temp, NULL, 8);
  201. static SENSOR_DEVICE_ATTR(temp2_crit, S_IRUGO, show_temp, NULL, 8);
  202. static SENSOR_DEVICE_ATTR(temp3_crit, S_IWUSR | S_IRUGO, show_temp,
  203. set_temp, 8);
  204. static SENSOR_DEVICE_ATTR(temp4_crit, S_IRUGO, show_temp, NULL, 8);
  205. /* Individual alarm files */
  206. static SENSOR_DEVICE_ATTR(temp1_crit_alarm, S_IRUGO, show_alarm, NULL, 0);
  207. static SENSOR_DEVICE_ATTR(temp3_crit_alarm, S_IRUGO, show_alarm, NULL, 1);
  208. static SENSOR_DEVICE_ATTR(temp3_fault, S_IRUGO, show_alarm, NULL, 2);
  209. static SENSOR_DEVICE_ATTR(temp3_max_alarm, S_IRUGO, show_alarm, NULL, 4);
  210. static SENSOR_DEVICE_ATTR(temp1_max_alarm, S_IRUGO, show_alarm, NULL, 6);
  211. static SENSOR_DEVICE_ATTR(temp2_crit_alarm, S_IRUGO, show_alarm, NULL, 8);
  212. static SENSOR_DEVICE_ATTR(temp4_crit_alarm, S_IRUGO, show_alarm, NULL, 9);
  213. static SENSOR_DEVICE_ATTR(temp4_fault, S_IRUGO, show_alarm, NULL, 10);
  214. static SENSOR_DEVICE_ATTR(temp4_max_alarm, S_IRUGO, show_alarm, NULL, 12);
  215. static SENSOR_DEVICE_ATTR(temp2_fault, S_IRUGO, show_alarm, NULL, 13);
  216. static SENSOR_DEVICE_ATTR(temp2_max_alarm, S_IRUGO, show_alarm, NULL, 15);
  217. /* Raw alarm file for compatibility */
  218. static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL);
  219. static struct attribute *lm83_attributes[] = {
  220. &sensor_dev_attr_temp1_input.dev_attr.attr,
  221. &sensor_dev_attr_temp3_input.dev_attr.attr,
  222. &sensor_dev_attr_temp1_max.dev_attr.attr,
  223. &sensor_dev_attr_temp3_max.dev_attr.attr,
  224. &sensor_dev_attr_temp1_crit.dev_attr.attr,
  225. &sensor_dev_attr_temp3_crit.dev_attr.attr,
  226. &sensor_dev_attr_temp1_crit_alarm.dev_attr.attr,
  227. &sensor_dev_attr_temp3_crit_alarm.dev_attr.attr,
  228. &sensor_dev_attr_temp3_fault.dev_attr.attr,
  229. &sensor_dev_attr_temp3_max_alarm.dev_attr.attr,
  230. &sensor_dev_attr_temp1_max_alarm.dev_attr.attr,
  231. &dev_attr_alarms.attr,
  232. NULL
  233. };
  234. static const struct attribute_group lm83_group = {
  235. .attrs = lm83_attributes,
  236. };
  237. static struct attribute *lm83_attributes_opt[] = {
  238. &sensor_dev_attr_temp2_input.dev_attr.attr,
  239. &sensor_dev_attr_temp4_input.dev_attr.attr,
  240. &sensor_dev_attr_temp2_max.dev_attr.attr,
  241. &sensor_dev_attr_temp4_max.dev_attr.attr,
  242. &sensor_dev_attr_temp2_crit.dev_attr.attr,
  243. &sensor_dev_attr_temp4_crit.dev_attr.attr,
  244. &sensor_dev_attr_temp2_crit_alarm.dev_attr.attr,
  245. &sensor_dev_attr_temp4_crit_alarm.dev_attr.attr,
  246. &sensor_dev_attr_temp4_fault.dev_attr.attr,
  247. &sensor_dev_attr_temp4_max_alarm.dev_attr.attr,
  248. &sensor_dev_attr_temp2_fault.dev_attr.attr,
  249. &sensor_dev_attr_temp2_max_alarm.dev_attr.attr,
  250. NULL
  251. };
  252. static const struct attribute_group lm83_group_opt = {
  253. .attrs = lm83_attributes_opt,
  254. };
  255. /*
  256. * Real code
  257. */
  258. /* Return 0 if detection is successful, -ENODEV otherwise */
  259. static int lm83_detect(struct i2c_client *new_client,
  260. struct i2c_board_info *info)
  261. {
  262. struct i2c_adapter *adapter = new_client->adapter;
  263. const char *name;
  264. u8 man_id, chip_id;
  265. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
  266. return -ENODEV;
  267. /* Detection */
  268. if ((i2c_smbus_read_byte_data(new_client, LM83_REG_R_STATUS1) & 0xA8) ||
  269. (i2c_smbus_read_byte_data(new_client, LM83_REG_R_STATUS2) & 0x48) ||
  270. (i2c_smbus_read_byte_data(new_client, LM83_REG_R_CONFIG) & 0x41)) {
  271. dev_dbg(&adapter->dev, "LM83 detection failed at 0x%02x\n",
  272. new_client->addr);
  273. return -ENODEV;
  274. }
  275. /* Identification */
  276. man_id = i2c_smbus_read_byte_data(new_client, LM83_REG_R_MAN_ID);
  277. if (man_id != 0x01) /* National Semiconductor */
  278. return -ENODEV;
  279. chip_id = i2c_smbus_read_byte_data(new_client, LM83_REG_R_CHIP_ID);
  280. switch (chip_id) {
  281. case 0x03:
  282. name = "lm83";
  283. break;
  284. case 0x01:
  285. name = "lm82";
  286. break;
  287. default:
  288. /* identification failed */
  289. dev_info(&adapter->dev,
  290. "Unsupported chip (man_id=0x%02X, chip_id=0x%02X)\n",
  291. man_id, chip_id);
  292. return -ENODEV;
  293. }
  294. strlcpy(info->type, name, I2C_NAME_SIZE);
  295. return 0;
  296. }
  297. static int lm83_probe(struct i2c_client *new_client,
  298. const struct i2c_device_id *id)
  299. {
  300. struct lm83_data *data;
  301. int err;
  302. data = kzalloc(sizeof(struct lm83_data), GFP_KERNEL);
  303. if (!data) {
  304. err = -ENOMEM;
  305. goto exit;
  306. }
  307. i2c_set_clientdata(new_client, data);
  308. data->valid = 0;
  309. mutex_init(&data->update_lock);
  310. /*
  311. * Register sysfs hooks
  312. * The LM82 can only monitor one external diode which is
  313. * at the same register as the LM83 temp3 entry - so we
  314. * declare 1 and 3 common, and then 2 and 4 only for the LM83.
  315. */
  316. err = sysfs_create_group(&new_client->dev.kobj, &lm83_group);
  317. if (err)
  318. goto exit_free;
  319. if (id->driver_data == lm83) {
  320. err = sysfs_create_group(&new_client->dev.kobj,
  321. &lm83_group_opt);
  322. if (err)
  323. goto exit_remove_files;
  324. }
  325. data->hwmon_dev = hwmon_device_register(&new_client->dev);
  326. if (IS_ERR(data->hwmon_dev)) {
  327. err = PTR_ERR(data->hwmon_dev);
  328. goto exit_remove_files;
  329. }
  330. return 0;
  331. exit_remove_files:
  332. sysfs_remove_group(&new_client->dev.kobj, &lm83_group);
  333. sysfs_remove_group(&new_client->dev.kobj, &lm83_group_opt);
  334. exit_free:
  335. kfree(data);
  336. exit:
  337. return err;
  338. }
  339. static int lm83_remove(struct i2c_client *client)
  340. {
  341. struct lm83_data *data = i2c_get_clientdata(client);
  342. hwmon_device_unregister(data->hwmon_dev);
  343. sysfs_remove_group(&client->dev.kobj, &lm83_group);
  344. sysfs_remove_group(&client->dev.kobj, &lm83_group_opt);
  345. kfree(data);
  346. return 0;
  347. }
  348. static struct lm83_data *lm83_update_device(struct device *dev)
  349. {
  350. struct i2c_client *client = to_i2c_client(dev);
  351. struct lm83_data *data = i2c_get_clientdata(client);
  352. mutex_lock(&data->update_lock);
  353. if (time_after(jiffies, data->last_updated + HZ * 2) || !data->valid) {
  354. int nr;
  355. dev_dbg(&client->dev, "Updating lm83 data.\n");
  356. for (nr = 0; nr < 9; nr++) {
  357. data->temp[nr] =
  358. i2c_smbus_read_byte_data(client,
  359. LM83_REG_R_TEMP[nr]);
  360. }
  361. data->alarms =
  362. i2c_smbus_read_byte_data(client, LM83_REG_R_STATUS1)
  363. + (i2c_smbus_read_byte_data(client, LM83_REG_R_STATUS2)
  364. << 8);
  365. data->last_updated = jiffies;
  366. data->valid = 1;
  367. }
  368. mutex_unlock(&data->update_lock);
  369. return data;
  370. }
  371. module_i2c_driver(lm83_driver);
  372. MODULE_AUTHOR("Jean Delvare <khali@linux-fr.org>");
  373. MODULE_DESCRIPTION("LM83 driver");
  374. MODULE_LICENSE("GPL");