Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 1 | /* |
| 2 | * TI Touch Screen driver |
| 3 | * |
| 4 | * Copyright (C) 2011 Texas Instruments Incorporated - http://www.ti.com/ |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or |
| 7 | * modify it under the terms of the GNU General Public License as |
| 8 | * published by the Free Software Foundation version 2. |
| 9 | * |
| 10 | * This program is distributed "as is" WITHOUT ANY WARRANTY of any |
| 11 | * kind, whether express or implied; without even the implied warranty |
| 12 | * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | * GNU General Public License for more details. |
| 14 | */ |
| 15 | |
| 16 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 17 | #include <linux/kernel.h> |
| 18 | #include <linux/err.h> |
| 19 | #include <linux/module.h> |
| 20 | #include <linux/input.h> |
| 21 | #include <linux/slab.h> |
| 22 | #include <linux/interrupt.h> |
| 23 | #include <linux/clk.h> |
| 24 | #include <linux/platform_device.h> |
| 25 | #include <linux/io.h> |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 26 | #include <linux/delay.h> |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 27 | #include <linux/of.h> |
| 28 | #include <linux/of_device.h> |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 29 | #include <linux/sort.h> |
Vignesh R | 7a39915 | 2018-06-30 16:03:18 +0530 | [diff] [blame] | 30 | #include <linux/pm_wakeirq.h> |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 31 | |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 32 | #include <linux/mfd/ti_am335x_tscadc.h> |
Patil, Rachna | 33f5cc6 | 2012-10-16 12:55:38 +0530 | [diff] [blame] | 33 | |
| 34 | #define ADCFSM_STEPID 0x10 |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 35 | #define SEQ_SETTLE 275 |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 36 | #define MAX_12BIT ((1 << 12) - 1) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 37 | |
Grygorii Strashko | 4685042 | 2018-05-30 14:23:15 -0700 | [diff] [blame] | 38 | #define TSC_IRQENB_MASK (IRQENB_FIFO0THRES | IRQENB_EOS | IRQENB_HW_PEN) |
| 39 | |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 40 | static const int config_pins[] = { |
| 41 | STEPCONFIG_XPP, |
| 42 | STEPCONFIG_XNN, |
| 43 | STEPCONFIG_YPP, |
| 44 | STEPCONFIG_YNN, |
| 45 | }; |
| 46 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 47 | struct titsc { |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 48 | struct input_dev *input; |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 49 | struct ti_tscadc_dev *mfd_tscadc; |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 50 | struct device *dev; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 51 | unsigned int irq; |
| 52 | unsigned int wires; |
| 53 | unsigned int x_plate_resistance; |
| 54 | bool pen_down; |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 55 | int coordinate_readouts; |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 56 | u32 config_inp[4]; |
| 57 | u32 bit_xp, bit_xn, bit_yp, bit_yn; |
| 58 | u32 inp_xp, inp_xn, inp_yp, inp_yn; |
Zubair Lutfullah | baee539 | 2013-09-19 07:24:00 +0100 | [diff] [blame] | 59 | u32 step_mask; |
Vignesh R | bf22361 | 2015-02-03 11:45:34 -0800 | [diff] [blame] | 60 | u32 charge_delay; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 61 | }; |
| 62 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 63 | static unsigned int titsc_readl(struct titsc *ts, unsigned int reg) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 64 | { |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 65 | return readl(ts->mfd_tscadc->tscadc_base + reg); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 66 | } |
| 67 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 68 | static void titsc_writel(struct titsc *tsc, unsigned int reg, |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 69 | unsigned int val) |
| 70 | { |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 71 | writel(val, tsc->mfd_tscadc->tscadc_base + reg); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 72 | } |
| 73 | |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 74 | static int titsc_config_wires(struct titsc *ts_dev) |
| 75 | { |
| 76 | u32 analog_line[4]; |
| 77 | u32 wire_order[4]; |
| 78 | int i, bit_cfg; |
| 79 | |
| 80 | for (i = 0; i < 4; i++) { |
| 81 | /* |
| 82 | * Get the order in which TSC wires are attached |
| 83 | * w.r.t. each of the analog input lines on the EVM. |
| 84 | */ |
| 85 | analog_line[i] = (ts_dev->config_inp[i] & 0xF0) >> 4; |
| 86 | wire_order[i] = ts_dev->config_inp[i] & 0x0F; |
| 87 | if (WARN_ON(analog_line[i] > 7)) |
| 88 | return -EINVAL; |
| 89 | if (WARN_ON(wire_order[i] > ARRAY_SIZE(config_pins))) |
| 90 | return -EINVAL; |
| 91 | } |
| 92 | |
| 93 | for (i = 0; i < 4; i++) { |
| 94 | int an_line; |
| 95 | int wi_order; |
| 96 | |
| 97 | an_line = analog_line[i]; |
| 98 | wi_order = wire_order[i]; |
| 99 | bit_cfg = config_pins[wi_order]; |
| 100 | if (bit_cfg == 0) |
| 101 | return -EINVAL; |
| 102 | switch (wi_order) { |
| 103 | case 0: |
| 104 | ts_dev->bit_xp = bit_cfg; |
| 105 | ts_dev->inp_xp = an_line; |
| 106 | break; |
| 107 | |
| 108 | case 1: |
| 109 | ts_dev->bit_xn = bit_cfg; |
| 110 | ts_dev->inp_xn = an_line; |
| 111 | break; |
| 112 | |
| 113 | case 2: |
| 114 | ts_dev->bit_yp = bit_cfg; |
| 115 | ts_dev->inp_yp = an_line; |
| 116 | break; |
| 117 | case 3: |
| 118 | ts_dev->bit_yn = bit_cfg; |
| 119 | ts_dev->inp_yn = an_line; |
| 120 | break; |
| 121 | } |
| 122 | } |
| 123 | return 0; |
| 124 | } |
| 125 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 126 | static void titsc_step_config(struct titsc *ts_dev) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 127 | { |
| 128 | unsigned int config; |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 129 | int i; |
Brad Griffis | 3a59684 | 2015-02-03 11:41:58 -0800 | [diff] [blame] | 130 | int end_step, first_step, tsc_steps; |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 131 | u32 stepenable; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 132 | |
| 133 | config = STEPCONFIG_MODE_HWSYNC | |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 134 | STEPCONFIG_AVG_16 | ts_dev->bit_xp; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 135 | switch (ts_dev->wires) { |
| 136 | case 4: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 137 | config |= STEPCONFIG_INP(ts_dev->inp_yp) | ts_dev->bit_xn; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 138 | break; |
| 139 | case 5: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 140 | config |= ts_dev->bit_yn | |
| 141 | STEPCONFIG_INP_AN4 | ts_dev->bit_xn | |
| 142 | ts_dev->bit_yp; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 143 | break; |
| 144 | case 8: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 145 | config |= STEPCONFIG_INP(ts_dev->inp_yp) | ts_dev->bit_xn; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 146 | break; |
| 147 | } |
| 148 | |
Brad Griffis | 3a59684 | 2015-02-03 11:41:58 -0800 | [diff] [blame] | 149 | tsc_steps = ts_dev->coordinate_readouts * 2 + 2; |
| 150 | first_step = TOTAL_STEPS - tsc_steps; |
| 151 | /* Steps 16 to 16-coordinate_readouts is for X */ |
| 152 | end_step = first_step + tsc_steps; |
| 153 | for (i = end_step - ts_dev->coordinate_readouts; i < end_step; i++) { |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 154 | titsc_writel(ts_dev, REG_STEPCONFIG(i), config); |
| 155 | titsc_writel(ts_dev, REG_STEPDELAY(i), STEPCONFIG_OPENDLY); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 156 | } |
| 157 | |
| 158 | config = 0; |
| 159 | config = STEPCONFIG_MODE_HWSYNC | |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 160 | STEPCONFIG_AVG_16 | ts_dev->bit_yn | |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 161 | STEPCONFIG_INM_ADCREFM; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 162 | switch (ts_dev->wires) { |
| 163 | case 4: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 164 | config |= ts_dev->bit_yp | STEPCONFIG_INP(ts_dev->inp_xp); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 165 | break; |
| 166 | case 5: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 167 | config |= ts_dev->bit_xp | STEPCONFIG_INP_AN4 | |
Jeff Lance | cf5dd48 | 2017-10-18 17:25:52 -0700 | [diff] [blame] | 168 | STEPCONFIG_XNP | STEPCONFIG_YPN; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 169 | break; |
| 170 | case 8: |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 171 | config |= ts_dev->bit_yp | STEPCONFIG_INP(ts_dev->inp_xp); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 172 | break; |
| 173 | } |
| 174 | |
Brad Griffis | 3a59684 | 2015-02-03 11:41:58 -0800 | [diff] [blame] | 175 | /* 1 ... coordinate_readouts is for Y */ |
| 176 | end_step = first_step + ts_dev->coordinate_readouts; |
| 177 | for (i = first_step; i < end_step; i++) { |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 178 | titsc_writel(ts_dev, REG_STEPCONFIG(i), config); |
| 179 | titsc_writel(ts_dev, REG_STEPDELAY(i), STEPCONFIG_OPENDLY); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 180 | } |
| 181 | |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 182 | /* Make CHARGECONFIG same as IDLECONFIG */ |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 183 | |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 184 | config = titsc_readl(ts_dev, REG_IDLECONFIG); |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 185 | titsc_writel(ts_dev, REG_CHARGECONFIG, config); |
Vignesh R | bf22361 | 2015-02-03 11:45:34 -0800 | [diff] [blame] | 186 | titsc_writel(ts_dev, REG_CHARGEDELAY, ts_dev->charge_delay); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 187 | |
Brad Griffis | 3a59684 | 2015-02-03 11:41:58 -0800 | [diff] [blame] | 188 | /* coordinate_readouts + 1 ... coordinate_readouts + 2 is for Z */ |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 189 | config = STEPCONFIG_MODE_HWSYNC | |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 190 | STEPCONFIG_AVG_16 | ts_dev->bit_yp | |
| 191 | ts_dev->bit_xn | STEPCONFIG_INM_ADCREFM | |
| 192 | STEPCONFIG_INP(ts_dev->inp_xp); |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 193 | titsc_writel(ts_dev, REG_STEPCONFIG(end_step), config); |
| 194 | titsc_writel(ts_dev, REG_STEPDELAY(end_step), |
Patil, Rachna | d1fb574 | 2012-10-16 12:55:39 +0530 | [diff] [blame] | 195 | STEPCONFIG_OPENDLY); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 196 | |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 197 | end_step++; |
| 198 | config |= STEPCONFIG_INP(ts_dev->inp_yn); |
| 199 | titsc_writel(ts_dev, REG_STEPCONFIG(end_step), config); |
| 200 | titsc_writel(ts_dev, REG_STEPDELAY(end_step), |
Patil, Rachna | d1fb574 | 2012-10-16 12:55:39 +0530 | [diff] [blame] | 201 | STEPCONFIG_OPENDLY); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 202 | |
Brad Griffis | 3a59684 | 2015-02-03 11:41:58 -0800 | [diff] [blame] | 203 | /* The steps end ... end - readouts * 2 + 2 and bit 0 for TS_Charge */ |
| 204 | stepenable = 1; |
| 205 | for (i = 0; i < tsc_steps; i++) |
| 206 | stepenable |= 1 << (first_step + i + 1); |
| 207 | |
Zubair Lutfullah | baee539 | 2013-09-19 07:24:00 +0100 | [diff] [blame] | 208 | ts_dev->step_mask = stepenable; |
Sebastian Andrzej Siewior | 7e170c6 | 2013-12-19 16:28:29 +0100 | [diff] [blame] | 209 | am335x_tsc_se_set_cache(ts_dev->mfd_tscadc, ts_dev->step_mask); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 210 | } |
| 211 | |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 212 | static int titsc_cmp_coord(const void *a, const void *b) |
| 213 | { |
| 214 | return *(int *)a - *(int *)b; |
| 215 | } |
| 216 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 217 | static void titsc_read_coordinates(struct titsc *ts_dev, |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 218 | u32 *x, u32 *y, u32 *z1, u32 *z2) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 219 | { |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 220 | unsigned int yvals[7], xvals[7]; |
| 221 | unsigned int i, xsum = 0, ysum = 0; |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 222 | unsigned int creads = ts_dev->coordinate_readouts; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 223 | |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 224 | for (i = 0; i < creads; i++) { |
| 225 | yvals[i] = titsc_readl(ts_dev, REG_FIFO0); |
| 226 | yvals[i] &= 0xfff; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 227 | } |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 228 | |
| 229 | *z1 = titsc_readl(ts_dev, REG_FIFO0); |
| 230 | *z1 &= 0xfff; |
| 231 | *z2 = titsc_readl(ts_dev, REG_FIFO0); |
| 232 | *z2 &= 0xfff; |
| 233 | |
| 234 | for (i = 0; i < creads; i++) { |
| 235 | xvals[i] = titsc_readl(ts_dev, REG_FIFO0); |
| 236 | xvals[i] &= 0xfff; |
| 237 | } |
| 238 | |
| 239 | /* |
| 240 | * If co-ordinates readouts is less than 4 then |
| 241 | * report the average. In case of 4 or more |
| 242 | * readouts, sort the co-ordinate samples, drop |
| 243 | * min and max values and report the average of |
| 244 | * remaining values. |
| 245 | */ |
| 246 | if (creads <= 3) { |
| 247 | for (i = 0; i < creads; i++) { |
| 248 | ysum += yvals[i]; |
| 249 | xsum += xvals[i]; |
| 250 | } |
| 251 | ysum /= creads; |
| 252 | xsum /= creads; |
| 253 | } else { |
| 254 | sort(yvals, creads, sizeof(unsigned int), |
| 255 | titsc_cmp_coord, NULL); |
| 256 | sort(xvals, creads, sizeof(unsigned int), |
| 257 | titsc_cmp_coord, NULL); |
| 258 | for (i = 1; i < creads - 1; i++) { |
| 259 | ysum += yvals[i]; |
| 260 | xsum += xvals[i]; |
| 261 | } |
| 262 | ysum /= creads - 2; |
| 263 | xsum /= creads - 2; |
| 264 | } |
| 265 | *y = ysum; |
| 266 | *x = xsum; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 267 | } |
| 268 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 269 | static irqreturn_t titsc_irq(int irq, void *dev) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 270 | { |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 271 | struct titsc *ts_dev = dev; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 272 | struct input_dev *input_dev = ts_dev->input; |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 273 | unsigned int fsm, status, irqclr = 0; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 274 | unsigned int x = 0, y = 0; |
| 275 | unsigned int z1, z2, z; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 276 | |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 277 | status = titsc_readl(ts_dev, REG_RAWIRQSTATUS); |
| 278 | if (status & IRQENB_HW_PEN) { |
| 279 | ts_dev->pen_down = true; |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 280 | irqclr |= IRQENB_HW_PEN; |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 281 | pm_stay_awake(ts_dev->dev); |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 282 | } |
| 283 | |
| 284 | if (status & IRQENB_PENUP) { |
| 285 | fsm = titsc_readl(ts_dev, REG_ADCFSM); |
| 286 | if (fsm == ADCFSM_STEPID) { |
| 287 | ts_dev->pen_down = false; |
| 288 | input_report_key(input_dev, BTN_TOUCH, 0); |
| 289 | input_report_abs(input_dev, ABS_PRESSURE, 0); |
| 290 | input_sync(input_dev); |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 291 | pm_relax(ts_dev->dev); |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 292 | } else { |
| 293 | ts_dev->pen_down = true; |
| 294 | } |
| 295 | irqclr |= IRQENB_PENUP; |
| 296 | } |
| 297 | |
| 298 | if (status & IRQENB_EOS) |
| 299 | irqclr |= IRQENB_EOS; |
| 300 | |
Zubair Lutfullah | baee539 | 2013-09-19 07:24:00 +0100 | [diff] [blame] | 301 | /* |
| 302 | * ADC and touchscreen share the IRQ line. |
| 303 | * FIFO1 interrupts are used by ADC. Handle FIFO0 IRQs here only |
| 304 | */ |
Patil, Rachna | 30af55f | 2012-10-16 12:55:40 +0530 | [diff] [blame] | 305 | if (status & IRQENB_FIFO0THRES) { |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 306 | |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 307 | titsc_read_coordinates(ts_dev, &x, &y, &z1, &z2); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 308 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 309 | if (ts_dev->pen_down && z1 != 0 && z2 != 0) { |
| 310 | /* |
| 311 | * Calculate pressure using formula |
| 312 | * Resistance(touch) = x plate resistance * |
| 313 | * x postion/4096 * ((z2 / z1) - 1) |
| 314 | */ |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 315 | z = z1 - z2; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 316 | z *= x; |
| 317 | z *= ts_dev->x_plate_resistance; |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 318 | z /= z2; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 319 | z = (z + 2047) >> 12; |
| 320 | |
| 321 | if (z <= MAX_12BIT) { |
| 322 | input_report_abs(input_dev, ABS_X, x); |
| 323 | input_report_abs(input_dev, ABS_Y, y); |
| 324 | input_report_abs(input_dev, ABS_PRESSURE, z); |
| 325 | input_report_key(input_dev, BTN_TOUCH, 1); |
| 326 | input_sync(input_dev); |
| 327 | } |
| 328 | } |
Patil, Rachna | 30af55f | 2012-10-16 12:55:40 +0530 | [diff] [blame] | 329 | irqclr |= IRQENB_FIFO0THRES; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 330 | } |
Sebastian Andrzej Siewior | 9a28b88 | 2013-06-05 16:30:00 +0200 | [diff] [blame] | 331 | if (irqclr) { |
| 332 | titsc_writel(ts_dev, REG_IRQSTATUS, irqclr); |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 333 | if (status & IRQENB_EOS) |
| 334 | am335x_tsc_se_set_cache(ts_dev->mfd_tscadc, |
| 335 | ts_dev->step_mask); |
Sebastian Andrzej Siewior | 9a28b88 | 2013-06-05 16:30:00 +0200 | [diff] [blame] | 336 | return IRQ_HANDLED; |
| 337 | } |
| 338 | return IRQ_NONE; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 339 | } |
| 340 | |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 341 | static int titsc_parse_dt(struct platform_device *pdev, |
| 342 | struct titsc *ts_dev) |
| 343 | { |
| 344 | struct device_node *node = pdev->dev.of_node; |
| 345 | int err; |
| 346 | |
| 347 | if (!node) |
| 348 | return -EINVAL; |
| 349 | |
| 350 | err = of_property_read_u32(node, "ti,wires", &ts_dev->wires); |
| 351 | if (err < 0) |
| 352 | return err; |
| 353 | switch (ts_dev->wires) { |
| 354 | case 4: |
| 355 | case 5: |
| 356 | case 8: |
| 357 | break; |
| 358 | default: |
| 359 | return -EINVAL; |
| 360 | } |
| 361 | |
| 362 | err = of_property_read_u32(node, "ti,x-plate-resistance", |
| 363 | &ts_dev->x_plate_resistance); |
| 364 | if (err < 0) |
| 365 | return err; |
| 366 | |
Felipe Balbi | c9aeb24 | 2013-11-10 23:56:43 -0800 | [diff] [blame] | 367 | /* |
| 368 | * Try with the new binding first. If it fails, try again with |
| 369 | * bogus, miss-spelled version. |
| 370 | */ |
| 371 | err = of_property_read_u32(node, "ti,coordinate-readouts", |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 372 | &ts_dev->coordinate_readouts); |
Felipe Balbi | 31972f6 | 2014-06-15 00:15:09 -0700 | [diff] [blame] | 373 | if (err < 0) { |
| 374 | dev_warn(&pdev->dev, "please use 'ti,coordinate-readouts' instead\n"); |
Felipe Balbi | c9aeb24 | 2013-11-10 23:56:43 -0800 | [diff] [blame] | 375 | err = of_property_read_u32(node, "ti,coordiante-readouts", |
| 376 | &ts_dev->coordinate_readouts); |
Felipe Balbi | 31972f6 | 2014-06-15 00:15:09 -0700 | [diff] [blame] | 377 | } |
| 378 | |
Felipe Balbi | c9aeb24 | 2013-11-10 23:56:43 -0800 | [diff] [blame] | 379 | if (err < 0) |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 380 | return err; |
| 381 | |
Vignesh R | 83edfdf | 2015-02-03 11:47:05 -0800 | [diff] [blame] | 382 | if (ts_dev->coordinate_readouts <= 0) { |
| 383 | dev_warn(&pdev->dev, |
| 384 | "invalid co-ordinate readouts, resetting it to 5\n"); |
| 385 | ts_dev->coordinate_readouts = 5; |
| 386 | } |
| 387 | |
Vignesh R | bf22361 | 2015-02-03 11:45:34 -0800 | [diff] [blame] | 388 | err = of_property_read_u32(node, "ti,charge-delay", |
| 389 | &ts_dev->charge_delay); |
| 390 | /* |
| 391 | * If ti,charge-delay value is not specified, then use |
| 392 | * CHARGEDLY_OPENDLY as the default value. |
| 393 | */ |
| 394 | if (err < 0) { |
| 395 | ts_dev->charge_delay = CHARGEDLY_OPENDLY; |
| 396 | dev_warn(&pdev->dev, "ti,charge-delay not specified\n"); |
| 397 | } |
| 398 | |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 399 | return of_property_read_u32_array(node, "ti,wire-config", |
| 400 | ts_dev->config_inp, ARRAY_SIZE(ts_dev->config_inp)); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 401 | } |
| 402 | |
| 403 | /* |
| 404 | * The functions for inserting/removing driver as a module. |
| 405 | */ |
| 406 | |
Linus Torvalds | 31564cb | 2012-12-18 12:46:37 -0800 | [diff] [blame] | 407 | static int titsc_probe(struct platform_device *pdev) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 408 | { |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 409 | struct titsc *ts_dev; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 410 | struct input_dev *input_dev; |
Sebastian Andrzej Siewior | a9bce1b | 2013-06-05 16:13:47 +0200 | [diff] [blame] | 411 | struct ti_tscadc_dev *tscadc_dev = ti_tscadc_dev_get(pdev); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 412 | int err; |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 413 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 414 | /* Allocate memory for device */ |
Andrew F. Davis | 520d826 | 2016-06-01 11:35:05 -0700 | [diff] [blame] | 415 | ts_dev = kzalloc(sizeof(*ts_dev), GFP_KERNEL); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 416 | input_dev = input_allocate_device(); |
| 417 | if (!ts_dev || !input_dev) { |
| 418 | dev_err(&pdev->dev, "failed to allocate memory.\n"); |
| 419 | err = -ENOMEM; |
| 420 | goto err_free_mem; |
| 421 | } |
| 422 | |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 423 | tscadc_dev->tsc = ts_dev; |
| 424 | ts_dev->mfd_tscadc = tscadc_dev; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 425 | ts_dev->input = input_dev; |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 426 | ts_dev->irq = tscadc_dev->irq; |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 427 | ts_dev->dev = &pdev->dev; |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 428 | |
Sebastian Andrzej Siewior | b9194fd | 2013-05-21 17:39:13 +0200 | [diff] [blame] | 429 | err = titsc_parse_dt(pdev, ts_dev); |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 430 | if (err) { |
| 431 | dev_err(&pdev->dev, "Could not find valid DT data.\n"); |
| 432 | goto err_free_mem; |
| 433 | } |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 434 | |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 435 | err = request_irq(ts_dev->irq, titsc_irq, |
Zubair Lutfullah | baee539 | 2013-09-19 07:24:00 +0100 | [diff] [blame] | 436 | IRQF_SHARED, pdev->dev.driver->name, ts_dev); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 437 | if (err) { |
| 438 | dev_err(&pdev->dev, "failed to allocate irq.\n"); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 439 | goto err_free_mem; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 440 | } |
| 441 | |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 442 | device_init_wakeup(&pdev->dev, true); |
Vignesh R | 7a39915 | 2018-06-30 16:03:18 +0530 | [diff] [blame] | 443 | err = dev_pm_set_wake_irq(&pdev->dev, ts_dev->irq); |
| 444 | if (err) |
| 445 | dev_err(&pdev->dev, "irq wake enable failed.\n"); |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 446 | |
Grygorii Strashko | 4685042 | 2018-05-30 14:23:15 -0700 | [diff] [blame] | 447 | titsc_writel(ts_dev, REG_IRQSTATUS, TSC_IRQENB_MASK); |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 448 | titsc_writel(ts_dev, REG_IRQENABLE, IRQENB_FIFO0THRES); |
Brad Griffis | 344d635 | 2015-02-03 11:44:12 -0800 | [diff] [blame] | 449 | titsc_writel(ts_dev, REG_IRQENABLE, IRQENB_EOS); |
Patil, Rachna | bb76dc0 | 2013-01-24 03:45:06 +0000 | [diff] [blame] | 450 | err = titsc_config_wires(ts_dev); |
| 451 | if (err) { |
| 452 | dev_err(&pdev->dev, "wrong i/p wire configuration\n"); |
| 453 | goto err_free_irq; |
| 454 | } |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 455 | titsc_step_config(ts_dev); |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 456 | titsc_writel(ts_dev, REG_FIFO0THR, |
| 457 | ts_dev->coordinate_readouts * 2 + 2 - 1); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 458 | |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 459 | input_dev->name = "ti-tsc"; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 460 | input_dev->dev.parent = &pdev->dev; |
| 461 | |
| 462 | input_dev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_ABS); |
| 463 | input_dev->keybit[BIT_WORD(BTN_TOUCH)] = BIT_MASK(BTN_TOUCH); |
| 464 | |
| 465 | input_set_abs_params(input_dev, ABS_X, 0, MAX_12BIT, 0, 0); |
| 466 | input_set_abs_params(input_dev, ABS_Y, 0, MAX_12BIT, 0, 0); |
| 467 | input_set_abs_params(input_dev, ABS_PRESSURE, 0, MAX_12BIT, 0, 0); |
| 468 | |
| 469 | /* register to the input system */ |
| 470 | err = input_register_device(input_dev); |
| 471 | if (err) |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 472 | goto err_free_irq; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 473 | |
| 474 | platform_set_drvdata(pdev, ts_dev); |
| 475 | return 0; |
| 476 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 477 | err_free_irq: |
Vignesh R | 7a39915 | 2018-06-30 16:03:18 +0530 | [diff] [blame] | 478 | dev_pm_clear_wake_irq(&pdev->dev); |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 479 | device_init_wakeup(&pdev->dev, false); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 480 | free_irq(ts_dev->irq, ts_dev); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 481 | err_free_mem: |
| 482 | input_free_device(input_dev); |
| 483 | kfree(ts_dev); |
| 484 | return err; |
| 485 | } |
| 486 | |
Linus Torvalds | 31564cb | 2012-12-18 12:46:37 -0800 | [diff] [blame] | 487 | static int titsc_remove(struct platform_device *pdev) |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 488 | { |
Sebastian Andrzej Siewior | a9bce1b | 2013-06-05 16:13:47 +0200 | [diff] [blame] | 489 | struct titsc *ts_dev = platform_get_drvdata(pdev); |
| 490 | u32 steps; |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 491 | |
Vignesh R | 7a39915 | 2018-06-30 16:03:18 +0530 | [diff] [blame] | 492 | dev_pm_clear_wake_irq(&pdev->dev); |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 493 | device_init_wakeup(&pdev->dev, false); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 494 | free_irq(ts_dev->irq, ts_dev); |
| 495 | |
Patil, Rachna | abeccee | 2013-01-24 03:45:05 +0000 | [diff] [blame] | 496 | /* total steps followed by the enable mask */ |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 497 | steps = 2 * ts_dev->coordinate_readouts + 2; |
Patil, Rachna | abeccee | 2013-01-24 03:45:05 +0000 | [diff] [blame] | 498 | steps = (1 << steps) - 1; |
| 499 | am335x_tsc_se_clr(ts_dev->mfd_tscadc, steps); |
| 500 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 501 | input_unregister_device(ts_dev->input); |
| 502 | |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 503 | kfree(ts_dev); |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 504 | return 0; |
| 505 | } |
| 506 | |
Dmitry Torokhov | 20aa787 | 2016-01-07 17:28:06 -0800 | [diff] [blame] | 507 | static int __maybe_unused titsc_suspend(struct device *dev) |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 508 | { |
Sebastian Andrzej Siewior | a9bce1b | 2013-06-05 16:13:47 +0200 | [diff] [blame] | 509 | struct titsc *ts_dev = dev_get_drvdata(dev); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 510 | unsigned int idle; |
| 511 | |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 512 | if (device_may_wakeup(dev)) { |
Grygorii Strashko | 4685042 | 2018-05-30 14:23:15 -0700 | [diff] [blame] | 513 | titsc_writel(ts_dev, REG_IRQSTATUS, TSC_IRQENB_MASK); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 514 | idle = titsc_readl(ts_dev, REG_IRQENABLE); |
| 515 | titsc_writel(ts_dev, REG_IRQENABLE, |
| 516 | (idle | IRQENB_HW_PEN)); |
| 517 | titsc_writel(ts_dev, REG_IRQWAKEUP, IRQWKUP_ENB); |
| 518 | } |
| 519 | return 0; |
| 520 | } |
| 521 | |
Dmitry Torokhov | 20aa787 | 2016-01-07 17:28:06 -0800 | [diff] [blame] | 522 | static int __maybe_unused titsc_resume(struct device *dev) |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 523 | { |
Sebastian Andrzej Siewior | a9bce1b | 2013-06-05 16:13:47 +0200 | [diff] [blame] | 524 | struct titsc *ts_dev = dev_get_drvdata(dev); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 525 | |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 526 | if (device_may_wakeup(dev)) { |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 527 | titsc_writel(ts_dev, REG_IRQWAKEUP, |
| 528 | 0x00); |
| 529 | titsc_writel(ts_dev, REG_IRQCLR, IRQENB_HW_PEN); |
Vignesh R | 333e07e | 2018-06-30 16:03:15 +0530 | [diff] [blame] | 530 | pm_relax(dev); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 531 | } |
| 532 | titsc_step_config(ts_dev); |
| 533 | titsc_writel(ts_dev, REG_FIFO0THR, |
Sebastian Andrzej Siewior | 8c89630 | 2013-05-29 14:46:21 +0200 | [diff] [blame] | 534 | ts_dev->coordinate_readouts * 2 + 2 - 1); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 535 | return 0; |
| 536 | } |
| 537 | |
Dmitry Torokhov | 20aa787 | 2016-01-07 17:28:06 -0800 | [diff] [blame] | 538 | static SIMPLE_DEV_PM_OPS(titsc_pm_ops, titsc_suspend, titsc_resume); |
Patil, Rachna | 2b99baf | 2012-10-16 12:55:44 +0530 | [diff] [blame] | 539 | |
Patil, Rachna | 0396310 | 2013-01-24 03:45:10 +0000 | [diff] [blame] | 540 | static const struct of_device_id ti_tsc_dt_ids[] = { |
| 541 | { .compatible = "ti,am3359-tsc", }, |
| 542 | { } |
| 543 | }; |
| 544 | MODULE_DEVICE_TABLE(of, ti_tsc_dt_ids); |
| 545 | |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 546 | static struct platform_driver ti_tsc_driver = { |
Patil, Rachna | 55c04de | 2012-10-16 12:55:42 +0530 | [diff] [blame] | 547 | .probe = titsc_probe, |
Linus Torvalds | 31564cb | 2012-12-18 12:46:37 -0800 | [diff] [blame] | 548 | .remove = titsc_remove, |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 549 | .driver = { |
Sebastian Andrzej Siewior | 5f184e6 | 2013-05-27 17:08:28 +0200 | [diff] [blame] | 550 | .name = "TI-am335x-tsc", |
Dmitry Torokhov | 20aa787 | 2016-01-07 17:28:06 -0800 | [diff] [blame] | 551 | .pm = &titsc_pm_ops, |
Sachin Kamat | 8e6146b | 2013-10-06 00:53:52 -0700 | [diff] [blame] | 552 | .of_match_table = ti_tsc_dt_ids, |
Rachna Patil | 1b8be32 | 2012-03-04 08:11:57 -0800 | [diff] [blame] | 553 | }, |
| 554 | }; |
| 555 | module_platform_driver(ti_tsc_driver); |
| 556 | |
| 557 | MODULE_DESCRIPTION("TI touchscreen controller driver"); |
| 558 | MODULE_AUTHOR("Rachna Patil <rachna@ti.com>"); |
| 559 | MODULE_LICENSE("GPL"); |