linux/drivers/input/touchscreen/bu21029_ts.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 * Rohm BU21029 touchscreen controller driver
   4 *
   5 * Copyright (C) 2015-2018 Bosch Sicherheitssysteme GmbH
   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 version 2 as
   9 * published by the Free Software Foundation.
  10 */
  11
  12#include <linux/delay.h>
  13#include <linux/gpio/consumer.h>
  14#include <linux/i2c.h>
  15#include <linux/input.h>
  16#include <linux/input/touchscreen.h>
  17#include <linux/interrupt.h>
  18#include <linux/irq.h>
  19#include <linux/module.h>
  20#include <linux/regulator/consumer.h>
  21#include <linux/timer.h>
  22
  23/*
  24 * HW_ID1 Register (PAGE=0, ADDR=0x0E, Reset value=0x02, Read only)
  25 * +--------+--------+--------+--------+--------+--------+--------+--------+
  26 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  27 * +--------+--------+--------+--------+--------+--------+--------+--------+
  28 * |                                 HW_IDH                                |
  29 * +--------+--------+--------+--------+--------+--------+--------+--------+
  30 * HW_ID2 Register (PAGE=0, ADDR=0x0F, Reset value=0x29, Read only)
  31 * +--------+--------+--------+--------+--------+--------+--------+--------+
  32 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  33 * +--------+--------+--------+--------+--------+--------+--------+--------+
  34 * |                                 HW_IDL                                |
  35 * +--------+--------+--------+--------+--------+--------+--------+--------+
  36 * HW_IDH: high 8bits of IC's ID
  37 * HW_IDL: low  8bits of IC's ID
  38 */
  39#define BU21029_HWID_REG        (0x0E << 3)
  40#define SUPPORTED_HWID          0x0229
  41
  42/*
  43 * CFR0 Register (PAGE=0, ADDR=0x00, Reset value=0x20)
  44 * +--------+--------+--------+--------+--------+--------+--------+--------+
  45 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  46 * +--------+--------+--------+--------+--------+--------+--------+--------+
  47 * |   0    |   0    |  CALIB |  INTRM |   0    |   0    |   0    |   0    |
  48 * +--------+--------+--------+--------+--------+--------+--------+--------+
  49 * CALIB: 0 = not to use calibration result (*)
  50 *        1 = use calibration result
  51 * INTRM: 0 = INT output depend on "pen down" (*)
  52 *        1 = INT output always "0"
  53 */
  54#define BU21029_CFR0_REG        (0x00 << 3)
  55#define CFR0_VALUE              0x00
  56
  57/*
  58 * CFR1 Register (PAGE=0, ADDR=0x01, Reset value=0xA6)
  59 * +--------+--------+--------+--------+--------+--------+--------+--------+
  60 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  61 * +--------+--------+--------+--------+--------+--------+--------+--------+
  62 * |  MAV   |         AVE[2:0]         |   0    |         SMPL[2:0]        |
  63 * +--------+--------+--------+--------+--------+--------+--------+--------+
  64 * MAV:  0 = median average filter off
  65 *       1 = median average filter on (*)
  66 * AVE:  AVE+1 = number of average samples for MAV,
  67 *               if AVE>SMPL, then AVE=SMPL (=3)
  68 * SMPL: SMPL+1 = number of conversion samples for MAV (=7)
  69 */
  70#define BU21029_CFR1_REG        (0x01 << 3)
  71#define CFR1_VALUE              0xA6
  72
  73/*
  74 * CFR2 Register (PAGE=0, ADDR=0x02, Reset value=0x04)
  75 * +--------+--------+--------+--------+--------+--------+--------+--------+
  76 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  77 * +--------+--------+--------+--------+--------+--------+--------+--------+
  78 * |          INTVL_TIME[3:0]          |          TIME_ST_ADC[3:0]         |
  79 * +--------+--------+--------+--------+--------+--------+--------+--------+
  80 * INTVL_TIME: waiting time between completion of conversion
  81 *             and start of next conversion, only usable in
  82 *             autoscan mode (=20.480ms)
  83 * TIME_ST_ADC: waiting time between application of voltage
  84 *              to panel and start of A/D conversion (=100us)
  85 */
  86#define BU21029_CFR2_REG        (0x02 << 3)
  87#define CFR2_VALUE              0xC9
  88
  89/*
  90 * CFR3 Register (PAGE=0, ADDR=0x0B, Reset value=0x72)
  91 * +--------+--------+--------+--------+--------+--------+--------+--------+
  92 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
  93 * +--------+--------+--------+--------+--------+--------+--------+--------+
  94 * |  RM8   | STRETCH|  PU90K |  DUAL  |           PIDAC_OFS[3:0]          |
  95 * +--------+--------+--------+--------+--------+--------+--------+--------+
  96 * RM8: 0 = coordinate resolution is 12bit (*)
  97 *      1 = coordinate resolution is 8bit
  98 * STRETCH: 0 = SCL_STRETCH function off
  99 *          1 = SCL_STRETCH function on (*)
 100 * PU90K: 0 = internal pull-up resistance for touch detection is ~50kohms (*)
 101 *        1 = internal pull-up resistance for touch detection is ~90kohms
 102 * DUAL: 0 = dual touch detection off (*)
 103 *       1 = dual touch detection on
 104 * PIDAC_OFS: dual touch detection circuit adjustment, it is not necessary
 105 *            to change this from initial value
 106 */
 107#define BU21029_CFR3_REG        (0x0B << 3)
 108#define CFR3_VALUE              0x42
 109
 110/*
 111 * LDO Register (PAGE=0, ADDR=0x0C, Reset value=0x00)
 112 * +--------+--------+--------+--------+--------+--------+--------+--------+
 113 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
 114 * +--------+--------+--------+--------+--------+--------+--------+--------+
 115 * |   0    |         PVDD[2:0]        |   0    |         AVDD[2:0]        |
 116 * +--------+--------+--------+--------+--------+--------+--------+--------+
 117 * PVDD: output voltage of panel output regulator (=2.000V)
 118 * AVDD: output voltage of analog circuit regulator (=2.000V)
 119 */
 120#define BU21029_LDO_REG         (0x0C << 3)
 121#define LDO_VALUE               0x77
 122
 123/*
 124 * Serial Interface Command Byte 1 (CID=1)
 125 * +--------+--------+--------+--------+--------+--------+--------+--------+
 126 * |   D7   |   D6   |   D5   |   D4   |   D3   |   D2   |   D1   |   D0   |
 127 * +--------+--------+--------+--------+--------+--------+--------+--------+
 128 * |   1    |                 CF                |  CMSK  |  PDM   |  STP   |
 129 * +--------+--------+--------+--------+--------+--------+--------+--------+
 130 * CF: conversion function, see table 3 in datasheet p6 (=0000, automatic scan)
 131 * CMSK: 0 = executes convert function (*)
 132 *       1 = reads the convert result
 133 * PDM: 0 = power down after convert function stops (*)
 134 *      1 = keep power on after convert function stops
 135 * STP: 1 = abort current conversion and power down, set to "0" automatically
 136 */
 137#define BU21029_AUTOSCAN        0x80
 138
 139/*
 140 * The timeout value needs to be larger than INTVL_TIME + tConv4 (sample and
 141 * conversion time), where tConv4 is calculated by formula:
 142 * tPON + tDLY1 + (tTIME_ST_ADC + (tADC * tSMPL) * 2 + tDLY2) * 3
 143 * see figure 8 in datasheet p15 for details of each field.
 144 */
 145#define PEN_UP_TIMEOUT_MS       50
 146
 147#define STOP_DELAY_MIN_US       50
 148#define STOP_DELAY_MAX_US       1000
 149#define START_DELAY_MS          2
 150#define BUF_LEN                 8
 151#define SCALE_12BIT             (1 << 12)
 152#define MAX_12BIT               ((1 << 12) - 1)
 153#define DRIVER_NAME             "bu21029"
 154
 155struct bu21029_ts_data {
 156        struct i2c_client               *client;
 157        struct input_dev                *in_dev;
 158        struct timer_list               timer;
 159        struct regulator                *vdd;
 160        struct gpio_desc                *reset_gpios;
 161        u32                             x_plate_ohms;
 162        struct touchscreen_properties   prop;
 163};
 164
 165static void bu21029_touch_report(struct bu21029_ts_data *bu21029, const u8 *buf)
 166{
 167        u16 x, y, z1, z2;
 168        u32 rz;
 169        s32 max_pressure = input_abs_get_max(bu21029->in_dev, ABS_PRESSURE);
 170
 171        /*
 172         * compose upper 8 and lower 4 bits into a 12bit value:
 173         * +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
 174         * |            ByteH              |            ByteL              |
 175         * +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
 176         * |b07|b06|b05|b04|b03|b02|b01|b00|b07|b06|b05|b04|b03|b02|b01|b00|
 177         * +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
 178         * |v11|v10|v09|v08|v07|v06|v05|v04|v03|v02|v01|v00| 0 | 0 | 0 | 0 |
 179         * +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
 180         */
 181        x  = (buf[0] << 4) | (buf[1] >> 4);
 182        y  = (buf[2] << 4) | (buf[3] >> 4);
 183        z1 = (buf[4] << 4) | (buf[5] >> 4);
 184        z2 = (buf[6] << 4) | (buf[7] >> 4);
 185
 186        if (z1 && z2) {
 187                /*
 188                 * calculate Rz (pressure resistance value) by equation:
 189                 * Rz = Rx * (x/Q) * ((z2/z1) - 1), where
 190                 * Rx is x-plate resistance,
 191                 * Q  is the touch screen resolution (8bit = 256, 12bit = 4096)
 192                 * x, z1, z2 are the measured positions.
 193                 */
 194                rz  = z2 - z1;
 195                rz *= x;
 196                rz *= bu21029->x_plate_ohms;
 197                rz /= z1;
 198                rz  = DIV_ROUND_CLOSEST(rz, SCALE_12BIT);
 199                if (rz <= max_pressure) {
 200                        touchscreen_report_pos(bu21029->in_dev, &bu21029->prop,
 201                                               x, y, false);
 202                        input_report_abs(bu21029->in_dev, ABS_PRESSURE,
 203                                         max_pressure - rz);
 204                        input_report_key(bu21029->in_dev, BTN_TOUCH, 1);
 205                        input_sync(bu21029->in_dev);
 206                }
 207        }
 208}
 209
 210static void bu21029_touch_release(struct timer_list *t)
 211{
 212        struct bu21029_ts_data *bu21029 = from_timer(bu21029, t, timer);
 213
 214        input_report_abs(bu21029->in_dev, ABS_PRESSURE, 0);
 215        input_report_key(bu21029->in_dev, BTN_TOUCH, 0);
 216        input_sync(bu21029->in_dev);
 217}
 218
 219static irqreturn_t bu21029_touch_soft_irq(int irq, void *data)
 220{
 221        struct bu21029_ts_data *bu21029 = data;
 222        u8 buf[BUF_LEN];
 223        int error;
 224
 225        /*
 226         * Read touch data and deassert interrupt (will assert again after
 227         * INTVL_TIME + tConv4 for continuous touch)
 228         */
 229        error = i2c_smbus_read_i2c_block_data(bu21029->client, BU21029_AUTOSCAN,
 230                                              sizeof(buf), buf);
 231        if (error < 0)
 232                goto out;
 233
 234        bu21029_touch_report(bu21029, buf);
 235
 236        /* reset timer for pen up detection */
 237        mod_timer(&bu21029->timer,
 238                  jiffies + msecs_to_jiffies(PEN_UP_TIMEOUT_MS));
 239
 240out:
 241        return IRQ_HANDLED;
 242}
 243
 244static void bu21029_put_chip_in_reset(struct bu21029_ts_data *bu21029)
 245{
 246        if (bu21029->reset_gpios) {
 247                gpiod_set_value_cansleep(bu21029->reset_gpios, 1);
 248                usleep_range(STOP_DELAY_MIN_US, STOP_DELAY_MAX_US);
 249        }
 250}
 251
 252static int bu21029_start_chip(struct input_dev *dev)
 253{
 254        struct bu21029_ts_data *bu21029 = input_get_drvdata(dev);
 255        struct i2c_client *i2c = bu21029->client;
 256        struct {
 257                u8 reg;
 258                u8 value;
 259        } init_table[] = {
 260                {BU21029_CFR0_REG, CFR0_VALUE},
 261                {BU21029_CFR1_REG, CFR1_VALUE},
 262                {BU21029_CFR2_REG, CFR2_VALUE},
 263                {BU21029_CFR3_REG, CFR3_VALUE},
 264                {BU21029_LDO_REG,  LDO_VALUE}
 265        };
 266        int error, i;
 267        __be16 hwid;
 268
 269        error = regulator_enable(bu21029->vdd);
 270        if (error) {
 271                dev_err(&i2c->dev, "failed to power up chip: %d", error);
 272                return error;
 273        }
 274
 275        /* take chip out of reset */
 276        if (bu21029->reset_gpios) {
 277                gpiod_set_value_cansleep(bu21029->reset_gpios, 0);
 278                msleep(START_DELAY_MS);
 279        }
 280
 281        error = i2c_smbus_read_i2c_block_data(i2c, BU21029_HWID_REG,
 282                                              sizeof(hwid), (u8 *)&hwid);
 283        if (error < 0) {
 284                dev_err(&i2c->dev, "failed to read HW ID\n");
 285                goto err_out;
 286        }
 287
 288        if (be16_to_cpu(hwid) != SUPPORTED_HWID) {
 289                dev_err(&i2c->dev,
 290                        "unsupported HW ID 0x%x\n", be16_to_cpu(hwid));
 291                error = -ENODEV;
 292                goto err_out;
 293        }
 294
 295        for (i = 0; i < ARRAY_SIZE(init_table); ++i) {
 296                error = i2c_smbus_write_byte_data(i2c,
 297                                                  init_table[i].reg,
 298                                                  init_table[i].value);
 299                if (error < 0) {
 300                        dev_err(&i2c->dev,
 301                                "failed to write %#02x to register %#02x: %d\n",
 302                                init_table[i].value, init_table[i].reg,
 303                                error);
 304                        goto err_out;
 305                }
 306        }
 307
 308        error = i2c_smbus_write_byte(i2c, BU21029_AUTOSCAN);
 309        if (error < 0) {
 310                dev_err(&i2c->dev, "failed to start autoscan\n");
 311                goto err_out;
 312        }
 313
 314        enable_irq(bu21029->client->irq);
 315        return 0;
 316
 317err_out:
 318        bu21029_put_chip_in_reset(bu21029);
 319        regulator_disable(bu21029->vdd);
 320        return error;
 321}
 322
 323static void bu21029_stop_chip(struct input_dev *dev)
 324{
 325        struct bu21029_ts_data *bu21029 = input_get_drvdata(dev);
 326
 327        disable_irq(bu21029->client->irq);
 328        del_timer_sync(&bu21029->timer);
 329
 330        bu21029_put_chip_in_reset(bu21029);
 331        regulator_disable(bu21029->vdd);
 332}
 333
 334static int bu21029_probe(struct i2c_client *client,
 335                         const struct i2c_device_id *id)
 336{
 337        struct bu21029_ts_data *bu21029;
 338        struct input_dev *in_dev;
 339        int error;
 340
 341        if (!i2c_check_functionality(client->adapter,
 342                                     I2C_FUNC_SMBUS_WRITE_BYTE |
 343                                     I2C_FUNC_SMBUS_WRITE_BYTE_DATA |
 344                                     I2C_FUNC_SMBUS_READ_I2C_BLOCK)) {
 345                dev_err(&client->dev,
 346                        "i2c functionality support is not sufficient\n");
 347                return -EIO;
 348        }
 349
 350        bu21029 = devm_kzalloc(&client->dev, sizeof(*bu21029), GFP_KERNEL);
 351        if (!bu21029)
 352                return -ENOMEM;
 353
 354        error = device_property_read_u32(&client->dev, "rohm,x-plate-ohms",
 355                                         &bu21029->x_plate_ohms);
 356        if (error) {
 357                dev_err(&client->dev,
 358                        "invalid 'x-plate-ohms' supplied: %d\n", error);
 359                return error;
 360        }
 361
 362        bu21029->vdd = devm_regulator_get(&client->dev, "vdd");
 363        if (IS_ERR(bu21029->vdd)) {
 364                error = PTR_ERR(bu21029->vdd);
 365                if (error != -EPROBE_DEFER)
 366                        dev_err(&client->dev,
 367                                "failed to acquire 'vdd' supply: %d\n", error);
 368                return error;
 369        }
 370
 371        bu21029->reset_gpios = devm_gpiod_get_optional(&client->dev,
 372                                                       "reset", GPIOD_OUT_HIGH);
 373        if (IS_ERR(bu21029->reset_gpios)) {
 374                error = PTR_ERR(bu21029->reset_gpios);
 375                if (error != -EPROBE_DEFER)
 376                        dev_err(&client->dev,
 377                                "failed to acquire 'reset' gpio: %d\n", error);
 378                return error;
 379        }
 380
 381        in_dev = devm_input_allocate_device(&client->dev);
 382        if (!in_dev) {
 383                dev_err(&client->dev, "unable to allocate input device\n");
 384                return -ENOMEM;
 385        }
 386
 387        bu21029->client = client;
 388        bu21029->in_dev = in_dev;
 389        timer_setup(&bu21029->timer, bu21029_touch_release, 0);
 390
 391        in_dev->name            = DRIVER_NAME;
 392        in_dev->id.bustype      = BUS_I2C;
 393        in_dev->open            = bu21029_start_chip;
 394        in_dev->close           = bu21029_stop_chip;
 395
 396        input_set_capability(in_dev, EV_KEY, BTN_TOUCH);
 397        input_set_abs_params(in_dev, ABS_X, 0, MAX_12BIT, 0, 0);
 398        input_set_abs_params(in_dev, ABS_Y, 0, MAX_12BIT, 0, 0);
 399        input_set_abs_params(in_dev, ABS_PRESSURE, 0, MAX_12BIT, 0, 0);
 400        touchscreen_parse_properties(in_dev, false, &bu21029->prop);
 401
 402        input_set_drvdata(in_dev, bu21029);
 403
 404        error = devm_request_threaded_irq(&client->dev, client->irq,
 405                                          NULL, bu21029_touch_soft_irq,
 406                                          IRQF_ONESHOT | IRQF_NO_AUTOEN,
 407                                          DRIVER_NAME, bu21029);
 408        if (error) {
 409                dev_err(&client->dev,
 410                        "unable to request touch irq: %d\n", error);
 411                return error;
 412        }
 413
 414        error = input_register_device(in_dev);
 415        if (error) {
 416                dev_err(&client->dev,
 417                        "unable to register input device: %d\n", error);
 418                return error;
 419        }
 420
 421        i2c_set_clientdata(client, bu21029);
 422
 423        return 0;
 424}
 425
 426static int __maybe_unused bu21029_suspend(struct device *dev)
 427{
 428        struct i2c_client *i2c = to_i2c_client(dev);
 429        struct bu21029_ts_data *bu21029 = i2c_get_clientdata(i2c);
 430
 431        if (!device_may_wakeup(dev)) {
 432                mutex_lock(&bu21029->in_dev->mutex);
 433                if (input_device_enabled(bu21029->in_dev))
 434                        bu21029_stop_chip(bu21029->in_dev);
 435                mutex_unlock(&bu21029->in_dev->mutex);
 436        }
 437
 438        return 0;
 439}
 440
 441static int __maybe_unused bu21029_resume(struct device *dev)
 442{
 443        struct i2c_client *i2c = to_i2c_client(dev);
 444        struct bu21029_ts_data *bu21029 = i2c_get_clientdata(i2c);
 445
 446        if (!device_may_wakeup(dev)) {
 447                mutex_lock(&bu21029->in_dev->mutex);
 448                if (input_device_enabled(bu21029->in_dev))
 449                        bu21029_start_chip(bu21029->in_dev);
 450                mutex_unlock(&bu21029->in_dev->mutex);
 451        }
 452
 453        return 0;
 454}
 455static SIMPLE_DEV_PM_OPS(bu21029_pm_ops, bu21029_suspend, bu21029_resume);
 456
 457static const struct i2c_device_id bu21029_ids[] = {
 458        { DRIVER_NAME, 0 },
 459        { /* sentinel */ }
 460};
 461MODULE_DEVICE_TABLE(i2c, bu21029_ids);
 462
 463#ifdef CONFIG_OF
 464static const struct of_device_id bu21029_of_ids[] = {
 465        { .compatible = "rohm,bu21029" },
 466        { /* sentinel */ }
 467};
 468MODULE_DEVICE_TABLE(of, bu21029_of_ids);
 469#endif
 470
 471static struct i2c_driver bu21029_driver = {
 472        .driver = {
 473                .name           = DRIVER_NAME,
 474                .of_match_table = of_match_ptr(bu21029_of_ids),
 475                .pm             = &bu21029_pm_ops,
 476        },
 477        .id_table       = bu21029_ids,
 478        .probe          = bu21029_probe,
 479};
 480module_i2c_driver(bu21029_driver);
 481
 482MODULE_AUTHOR("Zhu Yi <yi.zhu5@cn.bosch.com>");
 483MODULE_DESCRIPTION("Rohm BU21029 touchscreen controller driver");
 484MODULE_LICENSE("GPL v2");
 485