Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * max1619.c - Part of lm_sensors, Linux kernel modules for hardware |
| 3 | * monitoring |
| 4 | * Copyright (C) 2003-2004 Alexey Fisher <fishor@mail.ru> |
| 5 | * Jean Delvare <khali@linux-fr.org> |
| 6 | * |
| 7 | * Based on the lm90 driver. The MAX1619 is a sensor chip made by Maxim. |
| 8 | * It reports up to two temperatures (its own plus up to |
| 9 | * one external one). Complete datasheet can be |
| 10 | * obtained from Maxim's website at: |
| 11 | * http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf |
| 12 | * |
| 13 | * This program is free software; you can redistribute it and/or modify |
| 14 | * it under the terms of the GNU General Public License as published by |
| 15 | * the Free Software Foundation; either version 2 of the License, or |
| 16 | * (at your option) any later version. |
| 17 | * |
| 18 | * This program is distributed in the hope that it will be useful, |
| 19 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 20 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 21 | * GNU General Public License for more details. |
| 22 | * |
| 23 | * You should have received a copy of the GNU General Public License |
| 24 | * along with this program; if not, write to the Free Software |
| 25 | * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| 26 | */ |
| 27 | |
| 28 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | #include <linux/module.h> |
| 30 | #include <linux/init.h> |
| 31 | #include <linux/slab.h> |
| 32 | #include <linux/jiffies.h> |
| 33 | #include <linux/i2c.h> |
| 34 | #include <linux/i2c-sensor.h> |
| 35 | |
| 36 | |
| 37 | static unsigned short normal_i2c[] = { 0x18, 0x19, 0x1a, |
| 38 | 0x29, 0x2a, 0x2b, |
| 39 | 0x4c, 0x4d, 0x4e, |
| 40 | I2C_CLIENT_END }; |
| 41 | static unsigned int normal_isa[] = { I2C_CLIENT_ISA_END }; |
| 42 | |
| 43 | /* |
| 44 | * Insmod parameters |
| 45 | */ |
| 46 | |
| 47 | SENSORS_INSMOD_1(max1619); |
| 48 | |
| 49 | /* |
| 50 | * The MAX1619 registers |
| 51 | */ |
| 52 | |
| 53 | #define MAX1619_REG_R_MAN_ID 0xFE |
| 54 | #define MAX1619_REG_R_CHIP_ID 0xFF |
| 55 | #define MAX1619_REG_R_CONFIG 0x03 |
| 56 | #define MAX1619_REG_W_CONFIG 0x09 |
| 57 | #define MAX1619_REG_R_CONVRATE 0x04 |
| 58 | #define MAX1619_REG_W_CONVRATE 0x0A |
| 59 | #define MAX1619_REG_R_STATUS 0x02 |
| 60 | #define MAX1619_REG_R_LOCAL_TEMP 0x00 |
| 61 | #define MAX1619_REG_R_REMOTE_TEMP 0x01 |
| 62 | #define MAX1619_REG_R_REMOTE_HIGH 0x07 |
| 63 | #define MAX1619_REG_W_REMOTE_HIGH 0x0D |
| 64 | #define MAX1619_REG_R_REMOTE_LOW 0x08 |
| 65 | #define MAX1619_REG_W_REMOTE_LOW 0x0E |
| 66 | #define MAX1619_REG_R_REMOTE_CRIT 0x10 |
| 67 | #define MAX1619_REG_W_REMOTE_CRIT 0x12 |
| 68 | #define MAX1619_REG_R_TCRIT_HYST 0x11 |
| 69 | #define MAX1619_REG_W_TCRIT_HYST 0x13 |
| 70 | |
| 71 | /* |
| 72 | * Conversions and various macros |
| 73 | */ |
| 74 | |
| 75 | #define TEMP_FROM_REG(val) ((val & 0x80 ? val-0x100 : val) * 1000) |
| 76 | #define TEMP_TO_REG(val) ((val < 0 ? val+0x100*1000 : val) / 1000) |
| 77 | |
| 78 | /* |
| 79 | * Functions declaration |
| 80 | */ |
| 81 | |
| 82 | static int max1619_attach_adapter(struct i2c_adapter *adapter); |
| 83 | static int max1619_detect(struct i2c_adapter *adapter, int address, |
| 84 | int kind); |
| 85 | static void max1619_init_client(struct i2c_client *client); |
| 86 | static int max1619_detach_client(struct i2c_client *client); |
| 87 | static struct max1619_data *max1619_update_device(struct device *dev); |
| 88 | |
| 89 | /* |
| 90 | * Driver data (common to all clients) |
| 91 | */ |
| 92 | |
| 93 | static struct i2c_driver max1619_driver = { |
| 94 | .owner = THIS_MODULE, |
| 95 | .name = "max1619", |
| 96 | .flags = I2C_DF_NOTIFY, |
| 97 | .attach_adapter = max1619_attach_adapter, |
| 98 | .detach_client = max1619_detach_client, |
| 99 | }; |
| 100 | |
| 101 | /* |
| 102 | * Client data (each client gets its own) |
| 103 | */ |
| 104 | |
| 105 | struct max1619_data { |
| 106 | struct i2c_client client; |
| 107 | struct semaphore update_lock; |
| 108 | char valid; /* zero until following fields are valid */ |
| 109 | unsigned long last_updated; /* in jiffies */ |
| 110 | |
| 111 | /* registers values */ |
| 112 | u8 temp_input1; /* local */ |
| 113 | u8 temp_input2, temp_low2, temp_high2; /* remote */ |
| 114 | u8 temp_crit2; |
| 115 | u8 temp_hyst2; |
| 116 | u8 alarms; |
| 117 | }; |
| 118 | |
| 119 | /* |
| 120 | * Sysfs stuff |
| 121 | */ |
| 122 | |
| 123 | #define show_temp(value) \ |
Yani Ioannou | 8627f9b | 2005-05-17 06:42:03 -0400 | [diff] [blame] | 124 | static ssize_t show_##value(struct device *dev, struct device_attribute *attr, char *buf) \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 125 | { \ |
| 126 | struct max1619_data *data = max1619_update_device(dev); \ |
| 127 | return sprintf(buf, "%d\n", TEMP_FROM_REG(data->value)); \ |
| 128 | } |
| 129 | show_temp(temp_input1); |
| 130 | show_temp(temp_input2); |
| 131 | show_temp(temp_low2); |
| 132 | show_temp(temp_high2); |
| 133 | show_temp(temp_crit2); |
| 134 | show_temp(temp_hyst2); |
| 135 | |
| 136 | #define set_temp2(value, reg) \ |
Yani Ioannou | 8627f9b | 2005-05-17 06:42:03 -0400 | [diff] [blame] | 137 | static ssize_t set_##value(struct device *dev, struct device_attribute *attr, const char *buf, \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 138 | size_t count) \ |
| 139 | { \ |
| 140 | struct i2c_client *client = to_i2c_client(dev); \ |
| 141 | struct max1619_data *data = i2c_get_clientdata(client); \ |
| 142 | long val = simple_strtol(buf, NULL, 10); \ |
| 143 | \ |
| 144 | down(&data->update_lock); \ |
| 145 | data->value = TEMP_TO_REG(val); \ |
| 146 | i2c_smbus_write_byte_data(client, reg, data->value); \ |
| 147 | up(&data->update_lock); \ |
| 148 | return count; \ |
| 149 | } |
| 150 | |
| 151 | set_temp2(temp_low2, MAX1619_REG_W_REMOTE_LOW); |
| 152 | set_temp2(temp_high2, MAX1619_REG_W_REMOTE_HIGH); |
| 153 | set_temp2(temp_crit2, MAX1619_REG_W_REMOTE_CRIT); |
| 154 | set_temp2(temp_hyst2, MAX1619_REG_W_TCRIT_HYST); |
| 155 | |
Yani Ioannou | 8627f9b | 2005-05-17 06:42:03 -0400 | [diff] [blame] | 156 | static ssize_t show_alarms(struct device *dev, struct device_attribute *attr, char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | { |
| 158 | struct max1619_data *data = max1619_update_device(dev); |
| 159 | return sprintf(buf, "%d\n", data->alarms); |
| 160 | } |
| 161 | |
| 162 | static DEVICE_ATTR(temp1_input, S_IRUGO, show_temp_input1, NULL); |
| 163 | static DEVICE_ATTR(temp2_input, S_IRUGO, show_temp_input2, NULL); |
| 164 | static DEVICE_ATTR(temp2_min, S_IWUSR | S_IRUGO, show_temp_low2, |
| 165 | set_temp_low2); |
| 166 | static DEVICE_ATTR(temp2_max, S_IWUSR | S_IRUGO, show_temp_high2, |
| 167 | set_temp_high2); |
| 168 | static DEVICE_ATTR(temp2_crit, S_IWUSR | S_IRUGO, show_temp_crit2, |
| 169 | set_temp_crit2); |
| 170 | static DEVICE_ATTR(temp2_crit_hyst, S_IWUSR | S_IRUGO, show_temp_hyst2, |
| 171 | set_temp_hyst2); |
| 172 | static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL); |
| 173 | |
| 174 | /* |
| 175 | * Real code |
| 176 | */ |
| 177 | |
| 178 | static int max1619_attach_adapter(struct i2c_adapter *adapter) |
| 179 | { |
| 180 | if (!(adapter->class & I2C_CLASS_HWMON)) |
| 181 | return 0; |
| 182 | return i2c_detect(adapter, &addr_data, max1619_detect); |
| 183 | } |
| 184 | |
| 185 | /* |
| 186 | * The following function does more than just detection. If detection |
| 187 | * succeeds, it also registers the new chip. |
| 188 | */ |
| 189 | static int max1619_detect(struct i2c_adapter *adapter, int address, int kind) |
| 190 | { |
| 191 | struct i2c_client *new_client; |
| 192 | struct max1619_data *data; |
| 193 | int err = 0; |
| 194 | const char *name = ""; |
| 195 | u8 reg_config=0, reg_convrate=0, reg_status=0; |
| 196 | u8 man_id, chip_id; |
| 197 | if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA)) |
| 198 | goto exit; |
| 199 | |
| 200 | if (!(data = kmalloc(sizeof(struct max1619_data), GFP_KERNEL))) { |
| 201 | err = -ENOMEM; |
| 202 | goto exit; |
| 203 | } |
| 204 | memset(data, 0, sizeof(struct max1619_data)); |
| 205 | |
| 206 | /* The common I2C client data is placed right before the |
| 207 | MAX1619-specific data. */ |
| 208 | new_client = &data->client; |
| 209 | i2c_set_clientdata(new_client, data); |
| 210 | new_client->addr = address; |
| 211 | new_client->adapter = adapter; |
| 212 | new_client->driver = &max1619_driver; |
| 213 | new_client->flags = 0; |
| 214 | |
| 215 | /* |
| 216 | * Now we do the remaining detection. A negative kind means that |
| 217 | * the driver was loaded with no force parameter (default), so we |
| 218 | * must both detect and identify the chip. A zero kind means that |
| 219 | * the driver was loaded with the force parameter, the detection |
| 220 | * step shall be skipped. A positive kind means that the driver |
| 221 | * was loaded with the force parameter and a given kind of chip is |
| 222 | * requested, so both the detection and the identification steps |
| 223 | * are skipped. |
| 224 | */ |
| 225 | if (kind < 0) { /* detection */ |
| 226 | reg_config = i2c_smbus_read_byte_data(new_client, |
| 227 | MAX1619_REG_R_CONFIG); |
| 228 | reg_convrate = i2c_smbus_read_byte_data(new_client, |
| 229 | MAX1619_REG_R_CONVRATE); |
| 230 | reg_status = i2c_smbus_read_byte_data(new_client, |
| 231 | MAX1619_REG_R_STATUS); |
| 232 | if ((reg_config & 0x03) != 0x00 |
| 233 | || reg_convrate > 0x07 || (reg_status & 0x61 ) !=0x00) { |
| 234 | dev_dbg(&adapter->dev, |
| 235 | "MAX1619 detection failed at 0x%02x.\n", |
| 236 | address); |
| 237 | goto exit_free; |
| 238 | } |
| 239 | } |
| 240 | |
| 241 | if (kind <= 0) { /* identification */ |
| 242 | |
| 243 | man_id = i2c_smbus_read_byte_data(new_client, |
| 244 | MAX1619_REG_R_MAN_ID); |
| 245 | chip_id = i2c_smbus_read_byte_data(new_client, |
| 246 | MAX1619_REG_R_CHIP_ID); |
| 247 | |
| 248 | if ((man_id == 0x4D) && (chip_id == 0x04)){ |
| 249 | kind = max1619; |
| 250 | } |
| 251 | } |
| 252 | |
| 253 | if (kind <= 0) { /* identification failed */ |
| 254 | dev_info(&adapter->dev, |
| 255 | "Unsupported chip (man_id=0x%02X, " |
| 256 | "chip_id=0x%02X).\n", man_id, chip_id); |
| 257 | goto exit_free; |
| 258 | } |
| 259 | |
| 260 | |
| 261 | if (kind == max1619){ |
| 262 | name = "max1619"; |
| 263 | } |
| 264 | |
| 265 | /* We can fill in the remaining client fields */ |
| 266 | strlcpy(new_client->name, name, I2C_NAME_SIZE); |
| 267 | data->valid = 0; |
| 268 | init_MUTEX(&data->update_lock); |
| 269 | |
| 270 | /* Tell the I2C layer a new client has arrived */ |
| 271 | if ((err = i2c_attach_client(new_client))) |
| 272 | goto exit_free; |
| 273 | |
| 274 | /* Initialize the MAX1619 chip */ |
| 275 | max1619_init_client(new_client); |
| 276 | |
| 277 | /* Register sysfs hooks */ |
| 278 | device_create_file(&new_client->dev, &dev_attr_temp1_input); |
| 279 | device_create_file(&new_client->dev, &dev_attr_temp2_input); |
| 280 | device_create_file(&new_client->dev, &dev_attr_temp2_min); |
| 281 | device_create_file(&new_client->dev, &dev_attr_temp2_max); |
| 282 | device_create_file(&new_client->dev, &dev_attr_temp2_crit); |
| 283 | device_create_file(&new_client->dev, &dev_attr_temp2_crit_hyst); |
| 284 | device_create_file(&new_client->dev, &dev_attr_alarms); |
| 285 | |
| 286 | return 0; |
| 287 | |
| 288 | exit_free: |
| 289 | kfree(data); |
| 290 | exit: |
| 291 | return err; |
| 292 | } |
| 293 | |
| 294 | static void max1619_init_client(struct i2c_client *client) |
| 295 | { |
| 296 | u8 config; |
| 297 | |
| 298 | /* |
| 299 | * Start the conversions. |
| 300 | */ |
| 301 | i2c_smbus_write_byte_data(client, MAX1619_REG_W_CONVRATE, |
| 302 | 5); /* 2 Hz */ |
| 303 | config = i2c_smbus_read_byte_data(client, MAX1619_REG_R_CONFIG); |
| 304 | if (config & 0x40) |
| 305 | i2c_smbus_write_byte_data(client, MAX1619_REG_W_CONFIG, |
| 306 | config & 0xBF); /* run */ |
| 307 | } |
| 308 | |
| 309 | static int max1619_detach_client(struct i2c_client *client) |
| 310 | { |
| 311 | int err; |
| 312 | |
| 313 | if ((err = i2c_detach_client(client))) { |
| 314 | dev_err(&client->dev, "Client deregistration failed, " |
| 315 | "client not detached.\n"); |
| 316 | return err; |
| 317 | } |
| 318 | |
| 319 | kfree(i2c_get_clientdata(client)); |
| 320 | return 0; |
| 321 | } |
| 322 | |
| 323 | static struct max1619_data *max1619_update_device(struct device *dev) |
| 324 | { |
| 325 | struct i2c_client *client = to_i2c_client(dev); |
| 326 | struct max1619_data *data = i2c_get_clientdata(client); |
| 327 | |
| 328 | down(&data->update_lock); |
| 329 | |
| 330 | if (time_after(jiffies, data->last_updated + HZ * 2) || !data->valid) { |
| 331 | dev_dbg(&client->dev, "Updating max1619 data.\n"); |
| 332 | data->temp_input1 = i2c_smbus_read_byte_data(client, |
| 333 | MAX1619_REG_R_LOCAL_TEMP); |
| 334 | data->temp_input2 = i2c_smbus_read_byte_data(client, |
| 335 | MAX1619_REG_R_REMOTE_TEMP); |
| 336 | data->temp_high2 = i2c_smbus_read_byte_data(client, |
| 337 | MAX1619_REG_R_REMOTE_HIGH); |
| 338 | data->temp_low2 = i2c_smbus_read_byte_data(client, |
| 339 | MAX1619_REG_R_REMOTE_LOW); |
| 340 | data->temp_crit2 = i2c_smbus_read_byte_data(client, |
| 341 | MAX1619_REG_R_REMOTE_CRIT); |
| 342 | data->temp_hyst2 = i2c_smbus_read_byte_data(client, |
| 343 | MAX1619_REG_R_TCRIT_HYST); |
| 344 | data->alarms = i2c_smbus_read_byte_data(client, |
| 345 | MAX1619_REG_R_STATUS); |
| 346 | |
| 347 | data->last_updated = jiffies; |
| 348 | data->valid = 1; |
| 349 | } |
| 350 | |
| 351 | up(&data->update_lock); |
| 352 | |
| 353 | return data; |
| 354 | } |
| 355 | |
| 356 | static int __init sensors_max1619_init(void) |
| 357 | { |
| 358 | return i2c_add_driver(&max1619_driver); |
| 359 | } |
| 360 | |
| 361 | static void __exit sensors_max1619_exit(void) |
| 362 | { |
| 363 | i2c_del_driver(&max1619_driver); |
| 364 | } |
| 365 | |
Jean Delvare | 368609c | 2005-07-29 12:15:07 -0700 | [diff] [blame] | 366 | MODULE_AUTHOR("Alexey Fisher <fishor@mail.ru> and " |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 367 | "Jean Delvare <khali@linux-fr.org>"); |
| 368 | MODULE_DESCRIPTION("MAX1619 sensor driver"); |
| 369 | MODULE_LICENSE("GPL"); |
| 370 | |
| 371 | module_init(sensors_max1619_init); |
| 372 | module_exit(sensors_max1619_exit); |