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_printf(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_LICENSE("GPL v2");