1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2008, 2009 Provigent Ltd.
5 * Author: Baruch Siach <baruch@tkos.co.il>
7 * Driver for the ARM PrimeCell(tm) General Purpose Input/Output (PL061)
9 * Data sheet: ARM DDI 0190B, September 2000
11 #include <linux/amba/bus.h>
12 #include <linux/bitops.h>
13 #include <linux/device.h>
14 #include <linux/errno.h>
15 #include <linux/gpio/driver.h>
16 #include <linux/init.h>
17 #include <linux/interrupt.h>
19 #include <linux/ioport.h>
20 #include <linux/irq.h>
21 #include <linux/irqchip/chained_irq.h>
22 #include <linux/module.h>
23 #include <linux/pinctrl/consumer.h>
25 #include <linux/seq_file.h>
26 #include <linux/slab.h>
27 #include <linux/spinlock.h>
38 #define PL061_GPIO_NR 8
41 struct pl061_context_save_regs
{
59 struct pl061_context_save_regs csave_regs
;
63 static int pl061_get_direction(struct gpio_chip
*gc
, unsigned offset
)
65 struct pl061
*pl061
= gpiochip_get_data(gc
);
67 if (readb(pl061
->base
+ GPIODIR
) & BIT(offset
))
68 return GPIO_LINE_DIRECTION_OUT
;
70 return GPIO_LINE_DIRECTION_IN
;
73 static int pl061_direction_input(struct gpio_chip
*gc
, unsigned offset
)
75 struct pl061
*pl061
= gpiochip_get_data(gc
);
77 unsigned char gpiodir
;
79 raw_spin_lock_irqsave(&pl061
->lock
, flags
);
80 gpiodir
= readb(pl061
->base
+ GPIODIR
);
81 gpiodir
&= ~(BIT(offset
));
82 writeb(gpiodir
, pl061
->base
+ GPIODIR
);
83 raw_spin_unlock_irqrestore(&pl061
->lock
, flags
);
88 static int pl061_direction_output(struct gpio_chip
*gc
, unsigned offset
,
91 struct pl061
*pl061
= gpiochip_get_data(gc
);
93 unsigned char gpiodir
;
95 raw_spin_lock_irqsave(&pl061
->lock
, flags
);
96 writeb(!!value
<< offset
, pl061
->base
+ (BIT(offset
+ 2)));
97 gpiodir
= readb(pl061
->base
+ GPIODIR
);
98 gpiodir
|= BIT(offset
);
99 writeb(gpiodir
, pl061
->base
+ GPIODIR
);
102 * gpio value is set again, because pl061 doesn't allow to set value of
103 * a gpio pin before configuring it in OUT mode.
105 writeb(!!value
<< offset
, pl061
->base
+ (BIT(offset
+ 2)));
106 raw_spin_unlock_irqrestore(&pl061
->lock
, flags
);
111 static int pl061_get_value(struct gpio_chip
*gc
, unsigned offset
)
113 struct pl061
*pl061
= gpiochip_get_data(gc
);
115 return !!readb(pl061
->base
+ (BIT(offset
+ 2)));
118 static void pl061_set_value(struct gpio_chip
*gc
, unsigned offset
, int value
)
120 struct pl061
*pl061
= gpiochip_get_data(gc
);
122 writeb(!!value
<< offset
, pl061
->base
+ (BIT(offset
+ 2)));
125 static int pl061_irq_type(struct irq_data
*d
, unsigned trigger
)
127 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(d
);
128 struct pl061
*pl061
= gpiochip_get_data(gc
);
129 int offset
= irqd_to_hwirq(d
);
131 u8 gpiois
, gpioibe
, gpioiev
;
132 u8 bit
= BIT(offset
);
134 if (offset
< 0 || offset
>= PL061_GPIO_NR
)
137 if ((trigger
& (IRQ_TYPE_LEVEL_HIGH
| IRQ_TYPE_LEVEL_LOW
)) &&
138 (trigger
& (IRQ_TYPE_EDGE_RISING
| IRQ_TYPE_EDGE_FALLING
)))
141 "trying to configure line %d for both level and edge "
142 "detection, choose one!\n",
148 raw_spin_lock_irqsave(&pl061
->lock
, flags
);
150 gpioiev
= readb(pl061
->base
+ GPIOIEV
);
151 gpiois
= readb(pl061
->base
+ GPIOIS
);
152 gpioibe
= readb(pl061
->base
+ GPIOIBE
);
154 if (trigger
& (IRQ_TYPE_LEVEL_HIGH
| IRQ_TYPE_LEVEL_LOW
)) {
155 bool polarity
= trigger
& IRQ_TYPE_LEVEL_HIGH
;
157 /* Disable edge detection */
159 /* Enable level detection */
161 /* Select polarity */
166 irq_set_handler_locked(d
, handle_level_irq
);
167 dev_dbg(gc
->parent
, "line %d: IRQ on %s level\n",
169 polarity
? "HIGH" : "LOW");
170 } else if ((trigger
& IRQ_TYPE_EDGE_BOTH
) == IRQ_TYPE_EDGE_BOTH
) {
171 /* Disable level detection */
173 /* Select both edges, setting this makes GPIOEV be ignored */
175 irq_set_handler_locked(d
, handle_edge_irq
);
176 dev_dbg(gc
->parent
, "line %d: IRQ on both edges\n", offset
);
177 } else if ((trigger
& IRQ_TYPE_EDGE_RISING
) ||
178 (trigger
& IRQ_TYPE_EDGE_FALLING
)) {
179 bool rising
= trigger
& IRQ_TYPE_EDGE_RISING
;
181 /* Disable level detection */
183 /* Clear detection on both edges */
190 irq_set_handler_locked(d
, handle_edge_irq
);
191 dev_dbg(gc
->parent
, "line %d: IRQ on %s edge\n",
193 rising
? "RISING" : "FALLING");
195 /* No trigger: disable everything */
199 irq_set_handler_locked(d
, handle_bad_irq
);
200 dev_warn(gc
->parent
, "no trigger selected for line %d\n",
204 writeb(gpiois
, pl061
->base
+ GPIOIS
);
205 writeb(gpioibe
, pl061
->base
+ GPIOIBE
);
206 writeb(gpioiev
, pl061
->base
+ GPIOIEV
);
208 raw_spin_unlock_irqrestore(&pl061
->lock
, flags
);
213 static void pl061_irq_handler(struct irq_desc
*desc
)
215 unsigned long pending
;
217 struct gpio_chip
*gc
= irq_desc_get_handler_data(desc
);
218 struct pl061
*pl061
= gpiochip_get_data(gc
);
219 struct irq_chip
*irqchip
= irq_desc_get_chip(desc
);
221 chained_irq_enter(irqchip
, desc
);
223 pending
= readb(pl061
->base
+ GPIOMIS
);
225 for_each_set_bit(offset
, &pending
, PL061_GPIO_NR
)
226 generic_handle_domain_irq(gc
->irq
.domain
,
230 chained_irq_exit(irqchip
, desc
);
233 static void pl061_irq_mask(struct irq_data
*d
)
235 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(d
);
236 struct pl061
*pl061
= gpiochip_get_data(gc
);
237 u8 mask
= BIT(irqd_to_hwirq(d
) % PL061_GPIO_NR
);
240 raw_spin_lock(&pl061
->lock
);
241 gpioie
= readb(pl061
->base
+ GPIOIE
) & ~mask
;
242 writeb(gpioie
, pl061
->base
+ GPIOIE
);
243 raw_spin_unlock(&pl061
->lock
);
245 gpiochip_disable_irq(gc
, d
->hwirq
);
248 static void pl061_irq_unmask(struct irq_data
*d
)
250 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(d
);
251 struct pl061
*pl061
= gpiochip_get_data(gc
);
252 u8 mask
= BIT(irqd_to_hwirq(d
) % PL061_GPIO_NR
);
255 gpiochip_enable_irq(gc
, d
->hwirq
);
257 raw_spin_lock(&pl061
->lock
);
258 gpioie
= readb(pl061
->base
+ GPIOIE
) | mask
;
259 writeb(gpioie
, pl061
->base
+ GPIOIE
);
260 raw_spin_unlock(&pl061
->lock
);
264 * pl061_irq_ack() - ACK an edge IRQ
265 * @d: IRQ data for this IRQ
267 * This gets called from the edge IRQ handler to ACK the edge IRQ
268 * in the GPIOIC (interrupt-clear) register. For level IRQs this is
269 * not needed: these go away when the level signal goes away.
271 static void pl061_irq_ack(struct irq_data
*d
)
273 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(d
);
274 struct pl061
*pl061
= gpiochip_get_data(gc
);
275 u8 mask
= BIT(irqd_to_hwirq(d
) % PL061_GPIO_NR
);
277 raw_spin_lock(&pl061
->lock
);
278 writeb(mask
, pl061
->base
+ GPIOIC
);
279 raw_spin_unlock(&pl061
->lock
);
282 static int pl061_irq_set_wake(struct irq_data
*d
, unsigned int state
)
284 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(d
);
285 struct pl061
*pl061
= gpiochip_get_data(gc
);
287 return irq_set_irq_wake(pl061
->parent_irq
, state
);
290 static void pl061_irq_print_chip(struct irq_data
*data
, struct seq_file
*p
)
292 struct gpio_chip
*gc
= irq_data_get_irq_chip_data(data
);
294 seq_puts(p
, dev_name(gc
->parent
));
297 static const struct irq_chip pl061_irq_chip
= {
298 .irq_ack
= pl061_irq_ack
,
299 .irq_mask
= pl061_irq_mask
,
300 .irq_unmask
= pl061_irq_unmask
,
301 .irq_set_type
= pl061_irq_type
,
302 .irq_set_wake
= pl061_irq_set_wake
,
303 .irq_print_chip
= pl061_irq_print_chip
,
304 .flags
= IRQCHIP_IMMUTABLE
,
305 GPIOCHIP_IRQ_RESOURCE_HELPERS
,
308 static int pl061_probe(struct amba_device
*adev
, const struct amba_id
*id
)
310 struct device
*dev
= &adev
->dev
;
312 struct gpio_irq_chip
*girq
;
315 pl061
= devm_kzalloc(dev
, sizeof(*pl061
), GFP_KERNEL
);
319 pl061
->base
= devm_ioremap_resource(dev
, &adev
->res
);
320 if (IS_ERR(pl061
->base
))
321 return PTR_ERR(pl061
->base
);
323 raw_spin_lock_init(&pl061
->lock
);
324 pl061
->gc
.request
= gpiochip_generic_request
;
325 pl061
->gc
.free
= gpiochip_generic_free
;
327 pl061
->gc
.get_direction
= pl061_get_direction
;
328 pl061
->gc
.direction_input
= pl061_direction_input
;
329 pl061
->gc
.direction_output
= pl061_direction_output
;
330 pl061
->gc
.get
= pl061_get_value
;
331 pl061
->gc
.set
= pl061_set_value
;
332 pl061
->gc
.ngpio
= PL061_GPIO_NR
;
333 pl061
->gc
.label
= dev_name(dev
);
334 pl061
->gc
.parent
= dev
;
335 pl061
->gc
.owner
= THIS_MODULE
;
340 writeb(0, pl061
->base
+ GPIOIE
); /* disable irqs */
343 dev_warn(&adev
->dev
, "IRQ support disabled\n");
344 pl061
->parent_irq
= irq
;
346 girq
= &pl061
->gc
.irq
;
347 gpio_irq_chip_set_chip(girq
, &pl061_irq_chip
);
348 girq
->parent_handler
= pl061_irq_handler
;
349 girq
->num_parents
= 1;
350 girq
->parents
= devm_kcalloc(dev
, 1, sizeof(*girq
->parents
),
354 girq
->parents
[0] = irq
;
355 girq
->default_type
= IRQ_TYPE_NONE
;
356 girq
->handler
= handle_bad_irq
;
358 ret
= devm_gpiochip_add_data(dev
, &pl061
->gc
, pl061
);
362 amba_set_drvdata(adev
, pl061
);
363 dev_info(dev
, "PL061 GPIO chip registered\n");
369 static int pl061_suspend(struct device
*dev
)
371 struct pl061
*pl061
= dev_get_drvdata(dev
);
374 pl061
->csave_regs
.gpio_data
= 0;
375 pl061
->csave_regs
.gpio_dir
= readb(pl061
->base
+ GPIODIR
);
376 pl061
->csave_regs
.gpio_is
= readb(pl061
->base
+ GPIOIS
);
377 pl061
->csave_regs
.gpio_ibe
= readb(pl061
->base
+ GPIOIBE
);
378 pl061
->csave_regs
.gpio_iev
= readb(pl061
->base
+ GPIOIEV
);
379 pl061
->csave_regs
.gpio_ie
= readb(pl061
->base
+ GPIOIE
);
381 for (offset
= 0; offset
< PL061_GPIO_NR
; offset
++) {
382 if (pl061
->csave_regs
.gpio_dir
& (BIT(offset
)))
383 pl061
->csave_regs
.gpio_data
|=
384 pl061_get_value(&pl061
->gc
, offset
) << offset
;
390 static int pl061_resume(struct device
*dev
)
392 struct pl061
*pl061
= dev_get_drvdata(dev
);
395 for (offset
= 0; offset
< PL061_GPIO_NR
; offset
++) {
396 if (pl061
->csave_regs
.gpio_dir
& (BIT(offset
)))
397 pl061_direction_output(&pl061
->gc
, offset
,
398 pl061
->csave_regs
.gpio_data
&
401 pl061_direction_input(&pl061
->gc
, offset
);
404 writeb(pl061
->csave_regs
.gpio_is
, pl061
->base
+ GPIOIS
);
405 writeb(pl061
->csave_regs
.gpio_ibe
, pl061
->base
+ GPIOIBE
);
406 writeb(pl061
->csave_regs
.gpio_iev
, pl061
->base
+ GPIOIEV
);
407 writeb(pl061
->csave_regs
.gpio_ie
, pl061
->base
+ GPIOIE
);
412 static const struct dev_pm_ops pl061_dev_pm_ops
= {
413 .suspend
= pl061_suspend
,
414 .resume
= pl061_resume
,
415 .freeze
= pl061_suspend
,
416 .restore
= pl061_resume
,
420 static const struct amba_id pl061_ids
[] = {
427 MODULE_DEVICE_TABLE(amba
, pl061_ids
);
429 static struct amba_driver pl061_gpio_driver
= {
431 .name
= "pl061_gpio",
433 .pm
= &pl061_dev_pm_ops
,
436 .id_table
= pl061_ids
,
437 .probe
= pl061_probe
,
439 module_amba_driver(pl061_gpio_driver
);
441 MODULE_DESCRIPTION("Driver for the ARM PrimeCell(tm) General Purpose Input/Output (PL061)");
442 MODULE_LICENSE("GPL v2");