1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Copyright (c) 2015 Intel Corporation 4 * 5 * Driver for TXC PA12203001 Proximity and Ambient Light Sensor. 6 * 7 * To do: Interrupt support. 8 */ 9 10 #include <linux/kernel.h> 11 #include <linux/module.h> 12 #include <linux/acpi.h> 13 #include <linux/delay.h> 14 #include <linux/i2c.h> 15 #include <linux/iio/iio.h> 16 #include <linux/iio/sysfs.h> 17 #include <linux/mutex.h> 18 #include <linux/pm.h> 19 #include <linux/pm_runtime.h> 20 #include <linux/regmap.h> 21 22 #define PA12203001_DRIVER_NAME "pa12203001" 23 24 #define PA12203001_REG_CFG0 0x00 25 #define PA12203001_REG_CFG1 0x01 26 #define PA12203001_REG_CFG2 0x02 27 #define PA12203001_REG_CFG3 0x03 28 29 #define PA12203001_REG_ADL 0x0b 30 #define PA12203001_REG_PDH 0x0e 31 32 #define PA12203001_REG_POFS 0x10 33 #define PA12203001_REG_PSET 0x11 34 35 #define PA12203001_ALS_EN_MASK BIT(0) 36 #define PA12203001_PX_EN_MASK BIT(1) 37 #define PA12203001_PX_NORMAL_MODE_MASK GENMASK(7, 6) 38 #define PA12203001_AFSR_MASK GENMASK(5, 4) 39 #define PA12203001_AFSR_SHIFT 4 40 41 #define PA12203001_PSCAN 0x03 42 43 /* als range 31000, ps, als disabled */ 44 #define PA12203001_REG_CFG0_DEFAULT 0x30 45 46 /* led current: 100 mA */ 47 #define PA12203001_REG_CFG1_DEFAULT 0x20 48 49 /* ps mode: normal, interrupts not active */ 50 #define PA12203001_REG_CFG2_DEFAULT 0xcc 51 52 #define PA12203001_REG_CFG3_DEFAULT 0x00 53 54 #define PA12203001_SLEEP_DELAY_MS 3000 55 56 #define PA12203001_CHIP_ENABLE 0xff 57 #define PA12203001_CHIP_DISABLE 0x00 58 59 /* available scales: corresponding to [500, 4000, 7000, 31000] lux */ 60 static const int pa12203001_scales[] = { 7629, 61036, 106813, 473029}; 61 62 struct pa12203001_data { 63 struct i2c_client *client; 64 65 /* protect device states */ 66 struct mutex lock; 67 68 bool als_enabled; 69 bool px_enabled; 70 bool als_needs_enable; 71 bool px_needs_enable; 72 73 struct regmap *map; 74 }; 75 76 static const struct { 77 u8 reg; 78 u8 val; 79 } regvals[] = { 80 {PA12203001_REG_CFG0, PA12203001_REG_CFG0_DEFAULT}, 81 {PA12203001_REG_CFG1, PA12203001_REG_CFG1_DEFAULT}, 82 {PA12203001_REG_CFG2, PA12203001_REG_CFG2_DEFAULT}, 83 {PA12203001_REG_CFG3, PA12203001_REG_CFG3_DEFAULT}, 84 {PA12203001_REG_PSET, PA12203001_PSCAN}, 85 }; 86 87 static IIO_CONST_ATTR(in_illuminance_scale_available, 88 "0.007629 0.061036 0.106813 0.473029"); 89 90 static struct attribute *pa12203001_attrs[] = { 91 &iio_const_attr_in_illuminance_scale_available.dev_attr.attr, 92 NULL 93 }; 94 95 static const struct attribute_group pa12203001_attr_group = { 96 .attrs = pa12203001_attrs, 97 }; 98 99 static const struct iio_chan_spec pa12203001_channels[] = { 100 { 101 .type = IIO_LIGHT, 102 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | 103 BIT(IIO_CHAN_INFO_SCALE), 104 }, 105 { 106 .type = IIO_PROXIMITY, 107 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW), 108 } 109 }; 110 111 static const struct regmap_range pa12203001_volatile_regs_ranges[] = { 112 regmap_reg_range(PA12203001_REG_ADL, PA12203001_REG_ADL + 1), 113 regmap_reg_range(PA12203001_REG_PDH, PA12203001_REG_PDH), 114 }; 115 116 static const struct regmap_access_table pa12203001_volatile_regs = { 117 .yes_ranges = pa12203001_volatile_regs_ranges, 118 .n_yes_ranges = ARRAY_SIZE(pa12203001_volatile_regs_ranges), 119 }; 120 121 static const struct regmap_config pa12203001_regmap_config = { 122 .reg_bits = 8, 123 .val_bits = 8, 124 .max_register = PA12203001_REG_PSET, 125 .cache_type = REGCACHE_RBTREE, 126 .volatile_table = &pa12203001_volatile_regs, 127 }; 128 129 static inline int pa12203001_als_enable(struct pa12203001_data *data, u8 enable) 130 { 131 int ret; 132 133 ret = regmap_update_bits(data->map, PA12203001_REG_CFG0, 134 PA12203001_ALS_EN_MASK, enable); 135 if (ret < 0) 136 return ret; 137 138 data->als_enabled = !!enable; 139 140 return 0; 141 } 142 143 static inline int pa12203001_px_enable(struct pa12203001_data *data, u8 enable) 144 { 145 int ret; 146 147 ret = regmap_update_bits(data->map, PA12203001_REG_CFG0, 148 PA12203001_PX_EN_MASK, enable); 149 if (ret < 0) 150 return ret; 151 152 data->px_enabled = !!enable; 153 154 return 0; 155 } 156 157 static int pa12203001_set_power_state(struct pa12203001_data *data, bool on, 158 u8 mask) 159 { 160 #ifdef CONFIG_PM 161 int ret; 162 163 if (on && (mask & PA12203001_ALS_EN_MASK)) { 164 mutex_lock(&data->lock); 165 if (data->px_enabled) { 166 ret = pa12203001_als_enable(data, 167 PA12203001_ALS_EN_MASK); 168 if (ret < 0) 169 goto err; 170 } else { 171 data->als_needs_enable = true; 172 } 173 mutex_unlock(&data->lock); 174 } 175 176 if (on && (mask & PA12203001_PX_EN_MASK)) { 177 mutex_lock(&data->lock); 178 if (data->als_enabled) { 179 ret = pa12203001_px_enable(data, PA12203001_PX_EN_MASK); 180 if (ret < 0) 181 goto err; 182 } else { 183 data->px_needs_enable = true; 184 } 185 mutex_unlock(&data->lock); 186 } 187 188 if (on) { 189 ret = pm_runtime_resume_and_get(&data->client->dev); 190 191 } else { 192 pm_runtime_mark_last_busy(&data->client->dev); 193 ret = pm_runtime_put_autosuspend(&data->client->dev); 194 } 195 196 return ret; 197 198 err: 199 mutex_unlock(&data->lock); 200 return ret; 201 202 #endif 203 return 0; 204 } 205 206 static int pa12203001_read_raw(struct iio_dev *indio_dev, 207 struct iio_chan_spec const *chan, int *val, 208 int *val2, long mask) 209 { 210 struct pa12203001_data *data = iio_priv(indio_dev); 211 int ret; 212 u8 dev_mask; 213 unsigned int reg_byte; 214 __le16 reg_word; 215 216 switch (mask) { 217 case IIO_CHAN_INFO_RAW: 218 switch (chan->type) { 219 case IIO_LIGHT: 220 dev_mask = PA12203001_ALS_EN_MASK; 221 ret = pa12203001_set_power_state(data, true, dev_mask); 222 if (ret < 0) 223 return ret; 224 /* 225 * ALS ADC value is stored in registers 226 * PA12203001_REG_ADL and in PA12203001_REG_ADL + 1. 227 */ 228 ret = regmap_bulk_read(data->map, PA12203001_REG_ADL, 229 ®_word, 2); 230 if (ret < 0) 231 goto reg_err; 232 233 *val = le16_to_cpu(reg_word); 234 ret = pa12203001_set_power_state(data, false, dev_mask); 235 if (ret < 0) 236 return ret; 237 break; 238 case IIO_PROXIMITY: 239 dev_mask = PA12203001_PX_EN_MASK; 240 ret = pa12203001_set_power_state(data, true, dev_mask); 241 if (ret < 0) 242 return ret; 243 ret = regmap_read(data->map, PA12203001_REG_PDH, 244 ®_byte); 245 if (ret < 0) 246 goto reg_err; 247 248 *val = reg_byte; 249 ret = pa12203001_set_power_state(data, false, dev_mask); 250 if (ret < 0) 251 return ret; 252 break; 253 default: 254 return -EINVAL; 255 } 256 return IIO_VAL_INT; 257 case IIO_CHAN_INFO_SCALE: 258 ret = regmap_read(data->map, PA12203001_REG_CFG0, ®_byte); 259 if (ret < 0) 260 return ret; 261 *val = 0; 262 reg_byte = (reg_byte & PA12203001_AFSR_MASK); 263 *val2 = pa12203001_scales[reg_byte >> 4]; 264 return IIO_VAL_INT_PLUS_MICRO; 265 default: 266 return -EINVAL; 267 } 268 269 reg_err: 270 pa12203001_set_power_state(data, false, dev_mask); 271 return ret; 272 } 273 274 static int pa12203001_write_raw(struct iio_dev *indio_dev, 275 struct iio_chan_spec const *chan, int val, 276 int val2, long mask) 277 { 278 struct pa12203001_data *data = iio_priv(indio_dev); 279 int i, ret, new_val; 280 unsigned int reg_byte; 281 282 switch (mask) { 283 case IIO_CHAN_INFO_SCALE: 284 ret = regmap_read(data->map, PA12203001_REG_CFG0, ®_byte); 285 if (val != 0 || ret < 0) 286 return -EINVAL; 287 for (i = 0; i < ARRAY_SIZE(pa12203001_scales); i++) { 288 if (val2 == pa12203001_scales[i]) { 289 new_val = i << PA12203001_AFSR_SHIFT; 290 return regmap_update_bits(data->map, 291 PA12203001_REG_CFG0, 292 PA12203001_AFSR_MASK, 293 new_val); 294 } 295 } 296 break; 297 default: 298 break; 299 } 300 301 return -EINVAL; 302 } 303 304 static const struct iio_info pa12203001_info = { 305 .read_raw = pa12203001_read_raw, 306 .write_raw = pa12203001_write_raw, 307 .attrs = &pa12203001_attr_group, 308 }; 309 310 static int pa12203001_init(struct iio_dev *indio_dev) 311 { 312 struct pa12203001_data *data = iio_priv(indio_dev); 313 int i, ret; 314 315 for (i = 0; i < ARRAY_SIZE(regvals); i++) { 316 ret = regmap_write(data->map, regvals[i].reg, regvals[i].val); 317 if (ret < 0) 318 return ret; 319 } 320 321 return 0; 322 } 323 324 static int pa12203001_power_chip(struct iio_dev *indio_dev, u8 state) 325 { 326 struct pa12203001_data *data = iio_priv(indio_dev); 327 int ret; 328 329 mutex_lock(&data->lock); 330 ret = pa12203001_als_enable(data, state); 331 if (ret < 0) 332 goto out; 333 334 ret = pa12203001_px_enable(data, state); 335 336 out: 337 mutex_unlock(&data->lock); 338 return ret; 339 } 340 341 static int pa12203001_probe(struct i2c_client *client) 342 { 343 struct pa12203001_data *data; 344 struct iio_dev *indio_dev; 345 int ret; 346 347 indio_dev = devm_iio_device_alloc(&client->dev, 348 sizeof(struct pa12203001_data)); 349 if (!indio_dev) 350 return -ENOMEM; 351 352 data = iio_priv(indio_dev); 353 i2c_set_clientdata(client, indio_dev); 354 data->client = client; 355 356 data->map = devm_regmap_init_i2c(client, &pa12203001_regmap_config); 357 if (IS_ERR(data->map)) 358 return PTR_ERR(data->map); 359 360 mutex_init(&data->lock); 361 362 indio_dev->info = &pa12203001_info; 363 indio_dev->name = PA12203001_DRIVER_NAME; 364 indio_dev->channels = pa12203001_channels; 365 indio_dev->num_channels = ARRAY_SIZE(pa12203001_channels); 366 indio_dev->modes = INDIO_DIRECT_MODE; 367 368 ret = pa12203001_init(indio_dev); 369 if (ret < 0) 370 return ret; 371 372 ret = pa12203001_power_chip(indio_dev, PA12203001_CHIP_ENABLE); 373 if (ret < 0) 374 return ret; 375 376 ret = pm_runtime_set_active(&client->dev); 377 if (ret < 0) 378 goto out_err; 379 380 pm_runtime_enable(&client->dev); 381 pm_runtime_set_autosuspend_delay(&client->dev, 382 PA12203001_SLEEP_DELAY_MS); 383 pm_runtime_use_autosuspend(&client->dev); 384 385 ret = iio_device_register(indio_dev); 386 if (ret < 0) 387 goto out_err; 388 389 return 0; 390 391 out_err: 392 pa12203001_power_chip(indio_dev, PA12203001_CHIP_DISABLE); 393 return ret; 394 } 395 396 static void pa12203001_remove(struct i2c_client *client) 397 { 398 struct iio_dev *indio_dev = i2c_get_clientdata(client); 399 int ret; 400 401 iio_device_unregister(indio_dev); 402 403 pm_runtime_disable(&client->dev); 404 pm_runtime_set_suspended(&client->dev); 405 406 ret = pa12203001_power_chip(indio_dev, PA12203001_CHIP_DISABLE); 407 if (ret) 408 dev_warn(&client->dev, "Failed to power down (%pe)\n", 409 ERR_PTR(ret)); 410 } 411 412 #if defined(CONFIG_PM_SLEEP) || defined(CONFIG_PM) 413 static int pa12203001_suspend(struct device *dev) 414 { 415 struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev)); 416 417 return pa12203001_power_chip(indio_dev, PA12203001_CHIP_DISABLE); 418 } 419 #endif 420 421 #ifdef CONFIG_PM_SLEEP 422 static int pa12203001_resume(struct device *dev) 423 { 424 struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev)); 425 426 return pa12203001_power_chip(indio_dev, PA12203001_CHIP_ENABLE); 427 } 428 #endif 429 430 #ifdef CONFIG_PM 431 static int pa12203001_runtime_resume(struct device *dev) 432 { 433 struct pa12203001_data *data; 434 435 data = iio_priv(i2c_get_clientdata(to_i2c_client(dev))); 436 437 mutex_lock(&data->lock); 438 if (data->als_needs_enable) { 439 pa12203001_als_enable(data, PA12203001_ALS_EN_MASK); 440 data->als_needs_enable = false; 441 } 442 if (data->px_needs_enable) { 443 pa12203001_px_enable(data, PA12203001_PX_EN_MASK); 444 data->px_needs_enable = false; 445 } 446 mutex_unlock(&data->lock); 447 448 return 0; 449 } 450 #endif 451 452 static const struct dev_pm_ops pa12203001_pm_ops = { 453 SET_SYSTEM_SLEEP_PM_OPS(pa12203001_suspend, pa12203001_resume) 454 SET_RUNTIME_PM_OPS(pa12203001_suspend, pa12203001_runtime_resume, NULL) 455 }; 456 457 static const struct acpi_device_id pa12203001_acpi_match[] = { 458 { "TXCPA122", 0 }, 459 {} 460 }; 461 462 MODULE_DEVICE_TABLE(acpi, pa12203001_acpi_match); 463 464 static const struct i2c_device_id pa12203001_id[] = { 465 { "txcpa122", 0 }, 466 {} 467 }; 468 469 MODULE_DEVICE_TABLE(i2c, pa12203001_id); 470 471 static struct i2c_driver pa12203001_driver = { 472 .driver = { 473 .name = PA12203001_DRIVER_NAME, 474 .pm = &pa12203001_pm_ops, 475 .acpi_match_table = pa12203001_acpi_match, 476 }, 477 .probe = pa12203001_probe, 478 .remove = pa12203001_remove, 479 .id_table = pa12203001_id, 480 481 }; 482 module_i2c_driver(pa12203001_driver); 483 484 MODULE_AUTHOR("Adriana Reus <adriana.reus@intel.com>"); 485 MODULE_DESCRIPTION("Driver for TXC PA12203001 Proximity and Light Sensor"); 486 MODULE_LICENSE("GPL v2"); 487