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