drivers/misc/tsl2550.c

   1 /*
   2  *  tsl2550.c - Linux kernel modules for ambient light sensor
   3  *
   4  *  Copyright (C) 2007 Rodolfo Giometti <giometti@linux.it>
   5  *  Copyright (C) 2007 Eurotech S.p.A. <info@eurotech.it>
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License as published by
   9  *  the Free Software Foundation; either version 2 of the License, or
  10  *  (at your option) any later version.
  11  *
  12  *  This program is distributed in the hope that it will be useful,
  13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *  GNU General Public License for more details.
  16  *
  17  *  You should have received a copy of the GNU General Public License
  18  *  along with this program; if not, write to the Free Software
  19  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20  */
  21
  22 #include <linux/module.h>
  23 #include <linux/slab.h>
  24 #include <linux/i2c.h>
  25 #include <linux/mutex.h>
  26
  27 #define TSL2550_DRV_NAME        "tsl2550"
  28 #define DRIVER_VERSION          "1.2"
  29
  30 /*
  31  * Defines
  32  */
  33
  34 #define TSL2550_POWER_DOWN              0x00
  35 #define TSL2550_POWER_UP                0x03
  36 #define TSL2550_STANDARD_RANGE          0x18
  37 #define TSL2550_EXTENDED_RANGE          0x1d
  38 #define TSL2550_READ_ADC0               0x43
  39 #define TSL2550_READ_ADC1               0x83
  40
  41 /*
  42  * Structs
  43  */
  44
  45 struct tsl2550_data {
  46         struct i2c_client *client;
  47         struct mutex update_lock;
  48
  49         unsigned int power_state:1;
  50         unsigned int operating_mode:1;
  51 };
  52
  53 /*
  54  * Global data
  55  */
  56
  57 static const u8 TSL2550_MODE_RANGE[2] = {
  58         TSL2550_STANDARD_RANGE, TSL2550_EXTENDED_RANGE,
  59 };
  60
  61 /*
  62  * Management functions
  63  */
  64
  65 static int tsl2550_set_operating_mode(struct i2c_client *client, int mode)
  66 {
  67         struct tsl2550_data *data = i2c_get_clientdata(client);
  68
  69         int ret = i2c_smbus_write_byte(client, TSL2550_MODE_RANGE[mode]);
  70
  71         data->operating_mode = mode;
  72
  73         return ret;
  74 }
  75
  76 static int tsl2550_set_power_state(struct i2c_client *client, int state)
  77 {
  78         struct tsl2550_data *data = i2c_get_clientdata(client);
  79         int ret;
  80
  81         if (state == 0)
  82                 ret = i2c_smbus_write_byte(client, TSL2550_POWER_DOWN);
  83         else {
  84                 ret = i2c_smbus_write_byte(client, TSL2550_POWER_UP);
  85
  86                 /* On power up we should reset operating mode also... */
  87                 tsl2550_set_operating_mode(client, data->operating_mode);
  88         }
  89
  90         data->power_state = state;
  91
  92         return ret;
  93 }
  94
  95 static int tsl2550_get_adc_value(struct i2c_client *client, u8 cmd)
  96 {
  97         int ret;
  98
  99         ret = i2c_smbus_read_byte_data(client, cmd);
 100         if (ret < 0)
 101                 return ret;
 102         if (!(ret & 0x80))
 103                 return -EAGAIN;
 104         return ret & 0x7f;      /* remove the "valid" bit */
 105 }
 106
 107 /*
 108  * LUX calculation
 109  */
 110
 111 #define TSL2550_MAX_LUX         1846
 112
 113 static const u8 ratio_lut[] = {
 114         100, 100, 100, 100, 100, 100, 100, 100,
 115         100, 100, 100, 100, 100, 100, 99, 99,
 116         99, 99, 99, 99, 99, 99, 99, 99,
 117         99, 99, 99, 98, 98, 98, 98, 98,
 118         98, 98, 97, 97, 97, 97, 97, 96,
 119         96, 96, 96, 95, 95, 95, 94, 94,
 120         93, 93, 93, 92, 92, 91, 91, 90,
 121         89, 89, 88, 87, 87, 86, 85, 84,
 122         83, 82, 81, 80, 79, 78, 77, 75,
 123         74, 73, 71, 69, 68, 66, 64, 62,
 124         60, 58, 56, 54, 52, 49, 47, 44,
 125         42, 41, 40, 40, 39, 39, 38, 38,
 126         37, 37, 37, 36, 36, 36, 35, 35,
 127         35, 35, 34, 34, 34, 34, 33, 33,
 128         33, 33, 32, 32, 32, 32, 32, 31,
 129         31, 31, 31, 31, 30, 30, 30, 30,
 130         30,
 131 };
 132
 133 static const u16 count_lut[] = {
 134         0, 1, 2, 3, 4, 5, 6, 7,
 135         8, 9, 10, 11, 12, 13, 14, 15,
 136         16, 18, 20, 22, 24, 26, 28, 30,
 137         32, 34, 36, 38, 40, 42, 44, 46,
 138         49, 53, 57, 61, 65, 69, 73, 77,
 139         81, 85, 89, 93, 97, 101, 105, 109,
 140         115, 123, 131, 139, 147, 155, 163, 171,
 141         179, 187, 195, 203, 211, 219, 227, 235,
 142         247, 263, 279, 295, 311, 327, 343, 359,
 143         375, 391, 407, 423, 439, 455, 471, 487,
 144         511, 543, 575, 607, 639, 671, 703, 735,
 145         767, 799, 831, 863, 895, 927, 959, 991,
 146         1039, 1103, 1167, 1231, 1295, 1359, 1423, 1487,
 147         1551, 1615, 1679, 1743, 1807, 1871, 1935, 1999,
 148         2095, 2223, 2351, 2479, 2607, 2735, 2863, 2991,
 149         3119, 3247, 3375, 3503, 3631, 3759, 3887, 4015,
 150 };
 151
 152 /*
 153  * This function is described into Taos TSL2550 Designer's Notebook
 154  * pages 2, 3.
 155  */
 156 static int tsl2550_calculate_lux(u8 ch0, u8 ch1)
 157 {
 158         unsigned int lux;
 159
 160         /* Look up count from channel values */
 161         u16 c0 = count_lut[ch0];
 162         u16 c1 = count_lut[ch1];
 163
 164         /*
 165          * Calculate ratio.
 166          * Note: the "128" is a scaling factor
 167          */
 168         u8 r = 128;
 169
 170         /* Avoid division by 0 and count 1 cannot be greater than count 0 */
 171         if (c1 <= c0)
 172                 if (c0) {
 173                         r = c1 * 128 / c0;
 174
 175                         /* Calculate LUX */
 176                         lux = ((c0 - c1) * ratio_lut[r]) / 256;
 177                 } else
 178                         lux = 0;
 179         else
 180                 return -EAGAIN;
 181
 182         /* LUX range check */
 183         return lux > TSL2550_MAX_LUX ? TSL2550_MAX_LUX : lux;
 184 }
 185
 186 /*
 187  * SysFS support
 188  */
 189
 190 static ssize_t tsl2550_show_power_state(struct device *dev,
 191                 struct device_attribute *attr, char *buf)
 192 {
 193         struct tsl2550_data *data = i2c_get_clientdata(to_i2c_client(dev));
 194
 195         return sprintf(buf, "%u\n", data->power_state);
 196 }
 197
 198 static ssize_t tsl2550_store_power_state(struct device *dev,
 199                 struct device_attribute *attr, const char *buf, size_t count)
 200 {
 201         struct i2c_client *client = to_i2c_client(dev);
 202         struct tsl2550_data *data = i2c_get_clientdata(client);
 203         unsigned long val = simple_strtoul(buf, NULL, 10);
 204         int ret;
 205
 206         if (val > 1)
 207                 return -EINVAL;
 208
 209         mutex_lock(&data->update_lock);
 210         ret = tsl2550_set_power_state(client, val);
 211         mutex_unlock(&data->update_lock);
 212
 213         if (ret < 0)
 214                 return ret;
 215
 216         return count;
 217 }
 218
 219 static DEVICE_ATTR(power_state, S_IWUSR | S_IRUGO,
 220                    tsl2550_show_power_state, tsl2550_store_power_state);
 221
 222 static ssize_t tsl2550_show_operating_mode(struct device *dev,
 223                 struct device_attribute *attr, char *buf)
 224 {
 225         struct tsl2550_data *data = i2c_get_clientdata(to_i2c_client(dev));
 226
 227         return sprintf(buf, "%u\n", data->operating_mode);
 228 }
 229
 230 static ssize_t tsl2550_store_operating_mode(struct device *dev,
 231                 struct device_attribute *attr, const char *buf, size_t count)
 232 {
 233         struct i2c_client *client = to_i2c_client(dev);
 234         struct tsl2550_data *data = i2c_get_clientdata(client);
 235         unsigned long val = simple_strtoul(buf, NULL, 10);
 236         int ret;
 237
 238         if (val > 1)
 239                 return -EINVAL;
 240
 241         if (data->power_state == 0)
 242                 return -EBUSY;
 243
 244         mutex_lock(&data->update_lock);
 245         ret = tsl2550_set_operating_mode(client, val);
 246         mutex_unlock(&data->update_lock);
 247
 248         if (ret < 0)
 249                 return ret;
 250
 251         return count;
 252 }
 253
 254 static DEVICE_ATTR(operating_mode, S_IWUSR | S_IRUGO,
 255                    tsl2550_show_operating_mode, tsl2550_store_operating_mode);
 256
 257 static ssize_t __tsl2550_show_lux(struct i2c_client *client, char *buf)
 258 {
 259         struct tsl2550_data *data = i2c_get_clientdata(client);
 260         u8 ch0, ch1;
 261         int ret;
 262
 263         ret = tsl2550_get_adc_value(client, TSL2550_READ_ADC0);
 264         if (ret < 0)
 265                 return ret;
 266         ch0 = ret;
 267
 268         ret = tsl2550_get_adc_value(client, TSL2550_READ_ADC1);
 269         if (ret < 0)
 270                 return ret;
 271         ch1 = ret;
 272
 273         /* Do the job */
 274         ret = tsl2550_calculate_lux(ch0, ch1);
 275         if (ret < 0)
 276                 return ret;
 277         if (data->operating_mode == 1)
 278                 ret *= 5;
 279
 280         return sprintf(buf, "%d\n", ret);
 281 }
 282
 283 static ssize_t tsl2550_show_lux1_input(struct device *dev,
 284                         struct device_attribute *attr, char *buf)
 285 {
 286         struct i2c_client *client = to_i2c_client(dev);
 287         struct tsl2550_data *data = i2c_get_clientdata(client);
 288         int ret;
 289
 290         /* No LUX data if not operational */
 291         if (!data->power_state)
 292                 return -EBUSY;
 293
 294         mutex_lock(&data->update_lock);
 295         ret = __tsl2550_show_lux(client, buf);
 296         mutex_unlock(&data->update_lock);
 297
 298         return ret;
 299 }
 300
 301 static DEVICE_ATTR(lux1_input, S_IRUGO,
 302                    tsl2550_show_lux1_input, NULL);
 303
 304 static struct attribute *tsl2550_attributes[] = {
 305         &dev_attr_power_state.attr,
 306         &dev_attr_operating_mode.attr,
 307         &dev_attr_lux1_input.attr,
 308         NULL
 309 };
 310
 311 static const struct attribute_group tsl2550_attr_group = {
 312         .attrs = tsl2550_attributes,
 313 };
 314
 315 /*
 316  * Initialization function
 317  */
 318
 319 static int tsl2550_init_client(struct i2c_client *client)
 320 {
 321         struct tsl2550_data *data = i2c_get_clientdata(client);
 322         int err;
 323
 324         /*
 325          * Probe the chip. To do so we try to power up the device and then to
 326          * read back the 0x03 code
 327          */
 328         err = i2c_smbus_read_byte_data(client, TSL2550_POWER_UP);
 329         if (err < 0)
 330                 return err;
 331         if (err != TSL2550_POWER_UP)
 332                 return -ENODEV;
 333         data->power_state = 1;
 334
 335         /* Set the default operating mode */
 336         err = i2c_smbus_write_byte(client,
 337                                    TSL2550_MODE_RANGE[data->operating_mode]);
 338         if (err < 0)
 339                 return err;
 340
 341         return 0;
 342 }
 343
 344 /*
 345  * I2C init/probing/exit functions
 346  */
 347
 348 static struct i2c_driver tsl2550_driver;
 349 static int tsl2550_probe(struct i2c_client *client,
 350                                    const struct i2c_device_id *id)
 351 {
 352         struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
 353         struct tsl2550_data *data;
 354         int *opmode, err = 0;
 355
 356         if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WRITE_BYTE
 357                                             | I2C_FUNC_SMBUS_READ_BYTE_DATA)) {
 358                 err = -EIO;
 359                 goto exit;
 360         }
 361
 362         data = kzalloc(sizeof(struct tsl2550_data), GFP_KERNEL);
 363         if (!data) {
 364                 err = -ENOMEM;
 365                 goto exit;
 366         }
 367         data->client = client;
 368         i2c_set_clientdata(client, data);
 369
 370         /* Check platform data */
 371         opmode = client->dev.platform_data;
 372         if (opmode) {
 373                 if (*opmode < 0 || *opmode > 1) {
 374                         dev_err(&client->dev, "invalid operating_mode (%d)\n",
 375                                         *opmode);
 376                         err = -EINVAL;
 377                         goto exit_kfree;
 378                 }
 379                 data->operating_mode = *opmode;
 380         } else
 381                 data->operating_mode = 0;       /* default mode is standard */
 382         dev_info(&client->dev, "%s operating mode\n",
 383                         data->operating_mode ? "extended" : "standard");
 384
 385         mutex_init(&data->update_lock);
 386
 387         /* Initialize the TSL2550 chip */
 388         err = tsl2550_init_client(client);
 389         if (err)
 390                 goto exit_kfree;
 391
 392         /* Register sysfs hooks */
 393         err = sysfs_create_group(&client->dev.kobj, &tsl2550_attr_group);
 394         if (err)
 395                 goto exit_kfree;
 396
 397         dev_info(&client->dev, "support ver. %s enabled\n", DRIVER_VERSION);
 398
 399         return 0;
 400
 401 exit_kfree:
 402         kfree(data);
 403 exit:
 404         return err;
 405 }
 406
 407 static int tsl2550_remove(struct i2c_client *client)
 408 {
 409         sysfs_remove_group(&client->dev.kobj, &tsl2550_attr_group);
 410
 411         /* Power down the device */
 412         tsl2550_set_power_state(client, 0);
 413
 414         kfree(i2c_get_clientdata(client));
 415
 416         return 0;
 417 }
 418
 419 #ifdef CONFIG_PM_SLEEP
 420
 421 static int tsl2550_suspend(struct device *dev)
 422 {
 423         return tsl2550_set_power_state(to_i2c_client(dev), 0);
 424 }
 425
 426 static int tsl2550_resume(struct device *dev)
 427 {
 428         return tsl2550_set_power_state(to_i2c_client(dev), 1);
 429 }
 430
 431 static SIMPLE_DEV_PM_OPS(tsl2550_pm_ops, tsl2550_suspend, tsl2550_resume);
 432 #define TSL2550_PM_OPS (&tsl2550_pm_ops)
 433
 434 #else
 435
 436 #define TSL2550_PM_OPS NULL
 437
 438 #endif /* CONFIG_PM_SLEEP */
 439
 440 static const struct i2c_device_id tsl2550_id[] = {
 441         { "tsl2550", 0 },
 442         { }
 443 };
 444 MODULE_DEVICE_TABLE(i2c, tsl2550_id);
 445
 446 static struct i2c_driver tsl2550_driver = {
 447         .driver = {
 448                 .name   = TSL2550_DRV_NAME,
 449                 .owner  = THIS_MODULE,
 450                 .pm     = TSL2550_PM_OPS,
 451         },
 452         .probe  = tsl2550_probe,
 453         .remove = tsl2550_remove,
 454         .id_table = tsl2550_id,
 455 };
 456
 457 module_i2c_driver(tsl2550_driver);
 458
 459 MODULE_AUTHOR("Rodolfo Giometti <giometti@linux.it>");
 460 MODULE_DESCRIPTION("TSL2550 ambient light sensor driver");
 461 MODULE_LICENSE("GPL");
 462 MODULE_VERSION(DRIVER_VERSION);