1 /*
2 * NXP LPC32xx SoC Key Scan Interface
3 *
4 * Authors:
5 * Kevin Wells <kevin.wells@nxp.com>
6 * Roland Stigge <stigge@antcom.de>
7 *
8 * Copyright (C) 2010 NXP Semiconductors
9 * Copyright (C) 2012 Roland Stigge
10 *
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
15 *
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
20 *
21 *
22 * This controller supports square key matrices from 1x1 up to 8x8
23 */
24
25 #include <linux/module.h>
26 #include <linux/interrupt.h>
27 #include <linux/slab.h>
28 #include <linux/irq.h>
29 #include <linux/pm.h>
30 #include <linux/platform_device.h>
31 #include <linux/input.h>
32 #include <linux/clk.h>
33 #include <linux/io.h>
34 #include <linux/of.h>
35 #include <linux/input/matrix_keypad.h>
36
37 #define DRV_NAME "lpc32xx_keys"
38
39 /*
40 * Key scanner register offsets
41 */
42 #define LPC32XX_KS_DEB(x) ((x) + 0x00)
43 #define LPC32XX_KS_STATE_COND(x) ((x) + 0x04)
44 #define LPC32XX_KS_IRQ(x) ((x) + 0x08)
45 #define LPC32XX_KS_SCAN_CTL(x) ((x) + 0x0C)
46 #define LPC32XX_KS_FAST_TST(x) ((x) + 0x10)
47 #define LPC32XX_KS_MATRIX_DIM(x) ((x) + 0x14) /* 1..8 */
48 #define LPC32XX_KS_DATA(x, y) ((x) + 0x40 + ((y) << 2))
49
50 #define LPC32XX_KSCAN_DEB_NUM_DEB_PASS(n) ((n) & 0xFF)
51
52 #define LPC32XX_KSCAN_SCOND_IN_IDLE 0x0
53 #define LPC32XX_KSCAN_SCOND_IN_SCANONCE 0x1
54 #define LPC32XX_KSCAN_SCOND_IN_IRQGEN 0x2
55 #define LPC32XX_KSCAN_SCOND_IN_SCAN_MATRIX 0x3
56
57 #define LPC32XX_KSCAN_IRQ_PENDING_CLR 0x1
58
59 #define LPC32XX_KSCAN_SCTRL_SCAN_DELAY(n) ((n) & 0xFF)
60
61 #define LPC32XX_KSCAN_FTST_FORCESCANONCE 0x1
62 #define LPC32XX_KSCAN_FTST_USE32K_CLK 0x2
63
64 #define LPC32XX_KSCAN_MSEL_SELECT(n) ((n) & 0xF)
65
66 struct lpc32xx_kscan_drv {
67 struct input_dev *input;
68 struct clk *clk;
69 void __iomem *kscan_base;
70 unsigned int irq;
71
72 u32 matrix_sz; /* Size of matrix in XxY, ie. 3 = 3x3 */
73 u32 deb_clks; /* Debounce clocks (based on 32KHz clock) */
74 u32 scan_delay; /* Scan delay (based on 32KHz clock) */
75
76 unsigned short *keymap; /* Pointer to key map for the scan matrix */
77 unsigned int row_shift;
78
79 u8 lastkeystates[8];
80 };
81
lpc32xx_mod_states(struct lpc32xx_kscan_drv * kscandat,int col)82 static void lpc32xx_mod_states(struct lpc32xx_kscan_drv *kscandat, int col)
83 {
84 struct input_dev *input = kscandat->input;
85 unsigned row, changed, scancode, keycode;
86 u8 key;
87
88 key = readl(LPC32XX_KS_DATA(kscandat->kscan_base, col));
89 changed = key ^ kscandat->lastkeystates[col];
90 kscandat->lastkeystates[col] = key;
91
92 for (row = 0; changed; row++, changed >>= 1) {
93 if (changed & 1) {
94 /* Key state changed, signal an event */
95 scancode = MATRIX_SCAN_CODE(row, col,
96 kscandat->row_shift);
97 keycode = kscandat->keymap[scancode];
98 input_event(input, EV_MSC, MSC_SCAN, scancode);
99 input_report_key(input, keycode, key & (1 << row));
100 }
101 }
102 }
103
lpc32xx_kscan_irq(int irq,void * dev_id)104 static irqreturn_t lpc32xx_kscan_irq(int irq, void *dev_id)
105 {
106 struct lpc32xx_kscan_drv *kscandat = dev_id;
107 int i;
108
109 for (i = 0; i < kscandat->matrix_sz; i++)
110 lpc32xx_mod_states(kscandat, i);
111
112 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
113
114 input_sync(kscandat->input);
115
116 return IRQ_HANDLED;
117 }
118
lpc32xx_kscan_open(struct input_dev * dev)119 static int lpc32xx_kscan_open(struct input_dev *dev)
120 {
121 struct lpc32xx_kscan_drv *kscandat = input_get_drvdata(dev);
122 int error;
123
124 error = clk_prepare_enable(kscandat->clk);
125 if (error)
126 return error;
127
128 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
129
130 return 0;
131 }
132
lpc32xx_kscan_close(struct input_dev * dev)133 static void lpc32xx_kscan_close(struct input_dev *dev)
134 {
135 struct lpc32xx_kscan_drv *kscandat = input_get_drvdata(dev);
136
137 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
138 clk_disable_unprepare(kscandat->clk);
139 }
140
lpc32xx_parse_dt(struct device * dev,struct lpc32xx_kscan_drv * kscandat)141 static int lpc32xx_parse_dt(struct device *dev,
142 struct lpc32xx_kscan_drv *kscandat)
143 {
144 struct device_node *np = dev->of_node;
145 u32 rows = 0, columns = 0;
146 int err;
147
148 err = matrix_keypad_parse_of_params(dev, &rows, &columns);
149 if (err)
150 return err;
151 if (rows != columns) {
152 dev_err(dev, "rows and columns must be equal!\n");
153 return -EINVAL;
154 }
155
156 kscandat->matrix_sz = rows;
157 kscandat->row_shift = get_count_order(columns);
158
159 of_property_read_u32(np, "nxp,debounce-delay-ms", &kscandat->deb_clks);
160 of_property_read_u32(np, "nxp,scan-delay-ms", &kscandat->scan_delay);
161 if (!kscandat->deb_clks || !kscandat->scan_delay) {
162 dev_err(dev, "debounce or scan delay not specified\n");
163 return -EINVAL;
164 }
165
166 return 0;
167 }
168
lpc32xx_kscan_probe(struct platform_device * pdev)169 static int lpc32xx_kscan_probe(struct platform_device *pdev)
170 {
171 struct lpc32xx_kscan_drv *kscandat;
172 struct input_dev *input;
173 struct resource *res;
174 size_t keymap_size;
175 int error;
176 int irq;
177
178 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
179 if (!res) {
180 dev_err(&pdev->dev, "failed to get platform I/O memory\n");
181 return -EINVAL;
182 }
183
184 irq = platform_get_irq(pdev, 0);
185 if (irq < 0 || irq >= NR_IRQS) {
186 dev_err(&pdev->dev, "failed to get platform irq\n");
187 return -EINVAL;
188 }
189
190 kscandat = devm_kzalloc(&pdev->dev, sizeof(*kscandat),
191 GFP_KERNEL);
192 if (!kscandat)
193 return -ENOMEM;
194
195 error = lpc32xx_parse_dt(&pdev->dev, kscandat);
196 if (error) {
197 dev_err(&pdev->dev, "failed to parse device tree\n");
198 return error;
199 }
200
201 keymap_size = sizeof(kscandat->keymap[0]) *
202 (kscandat->matrix_sz << kscandat->row_shift);
203 kscandat->keymap = devm_kzalloc(&pdev->dev, keymap_size, GFP_KERNEL);
204 if (!kscandat->keymap)
205 return -ENOMEM;
206
207 kscandat->input = input = devm_input_allocate_device(&pdev->dev);
208 if (!input) {
209 dev_err(&pdev->dev, "failed to allocate input device\n");
210 return -ENOMEM;
211 }
212
213 /* Setup key input */
214 input->name = pdev->name;
215 input->phys = "lpc32xx/input0";
216 input->id.vendor = 0x0001;
217 input->id.product = 0x0001;
218 input->id.version = 0x0100;
219 input->open = lpc32xx_kscan_open;
220 input->close = lpc32xx_kscan_close;
221 input->dev.parent = &pdev->dev;
222
223 input_set_capability(input, EV_MSC, MSC_SCAN);
224
225 error = matrix_keypad_build_keymap(NULL, NULL,
226 kscandat->matrix_sz,
227 kscandat->matrix_sz,
228 kscandat->keymap, kscandat->input);
229 if (error) {
230 dev_err(&pdev->dev, "failed to build keymap\n");
231 return error;
232 }
233
234 input_set_drvdata(kscandat->input, kscandat);
235
236 kscandat->kscan_base = devm_ioremap_resource(&pdev->dev, res);
237 if (IS_ERR(kscandat->kscan_base))
238 return PTR_ERR(kscandat->kscan_base);
239
240 /* Get the key scanner clock */
241 kscandat->clk = devm_clk_get(&pdev->dev, NULL);
242 if (IS_ERR(kscandat->clk)) {
243 dev_err(&pdev->dev, "failed to get clock\n");
244 return PTR_ERR(kscandat->clk);
245 }
246
247 /* Configure the key scanner */
248 error = clk_prepare_enable(kscandat->clk);
249 if (error)
250 return error;
251
252 writel(kscandat->deb_clks, LPC32XX_KS_DEB(kscandat->kscan_base));
253 writel(kscandat->scan_delay, LPC32XX_KS_SCAN_CTL(kscandat->kscan_base));
254 writel(LPC32XX_KSCAN_FTST_USE32K_CLK,
255 LPC32XX_KS_FAST_TST(kscandat->kscan_base));
256 writel(kscandat->matrix_sz,
257 LPC32XX_KS_MATRIX_DIM(kscandat->kscan_base));
258 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
259 clk_disable_unprepare(kscandat->clk);
260
261 error = devm_request_irq(&pdev->dev, irq, lpc32xx_kscan_irq, 0,
262 pdev->name, kscandat);
263 if (error) {
264 dev_err(&pdev->dev, "failed to request irq\n");
265 return error;
266 }
267
268 error = input_register_device(kscandat->input);
269 if (error) {
270 dev_err(&pdev->dev, "failed to register input device\n");
271 return error;
272 }
273
274 platform_set_drvdata(pdev, kscandat);
275
276 return 0;
277 }
278
279 #ifdef CONFIG_PM_SLEEP
lpc32xx_kscan_suspend(struct device * dev)280 static int lpc32xx_kscan_suspend(struct device *dev)
281 {
282 struct platform_device *pdev = to_platform_device(dev);
283 struct lpc32xx_kscan_drv *kscandat = platform_get_drvdata(pdev);
284 struct input_dev *input = kscandat->input;
285
286 mutex_lock(&input->mutex);
287
288 if (input->users) {
289 /* Clear IRQ and disable clock */
290 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
291 clk_disable_unprepare(kscandat->clk);
292 }
293
294 mutex_unlock(&input->mutex);
295 return 0;
296 }
297
lpc32xx_kscan_resume(struct device * dev)298 static int lpc32xx_kscan_resume(struct device *dev)
299 {
300 struct platform_device *pdev = to_platform_device(dev);
301 struct lpc32xx_kscan_drv *kscandat = platform_get_drvdata(pdev);
302 struct input_dev *input = kscandat->input;
303 int retval = 0;
304
305 mutex_lock(&input->mutex);
306
307 if (input->users) {
308 /* Enable clock and clear IRQ */
309 retval = clk_prepare_enable(kscandat->clk);
310 if (retval == 0)
311 writel(1, LPC32XX_KS_IRQ(kscandat->kscan_base));
312 }
313
314 mutex_unlock(&input->mutex);
315 return retval;
316 }
317 #endif
318
319 static SIMPLE_DEV_PM_OPS(lpc32xx_kscan_pm_ops, lpc32xx_kscan_suspend,
320 lpc32xx_kscan_resume);
321
322 static const struct of_device_id lpc32xx_kscan_match[] = {
323 { .compatible = "nxp,lpc3220-key" },
324 {},
325 };
326 MODULE_DEVICE_TABLE(of, lpc32xx_kscan_match);
327
328 static struct platform_driver lpc32xx_kscan_driver = {
329 .probe = lpc32xx_kscan_probe,
330 .driver = {
331 .name = DRV_NAME,
332 .pm = &lpc32xx_kscan_pm_ops,
333 .of_match_table = lpc32xx_kscan_match,
334 }
335 };
336
337 module_platform_driver(lpc32xx_kscan_driver);
338
339 MODULE_LICENSE("GPL");
340 MODULE_AUTHOR("Kevin Wells <kevin.wells@nxp.com>");
341 MODULE_AUTHOR("Roland Stigge <stigge@antcom.de>");
342 MODULE_DESCRIPTION("Key scanner driver for LPC32XX devices");
343