1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2008, 2009 Provigent Ltd.
7 * Driver for the ARM PrimeCell(tm) General Purpose Input/Output (PL061)
9 * Data sheet: ARM DDI 0190B, September 2000
11 #include <linux/spinlock.h>
12 #include <linux/errno.h>
13 #include <linux/init.h>
15 #include <linux/ioport.h>
16 #include <linux/interrupt.h>
17 #include <linux/irq.h>
18 #include <linux/irqchip/chained_irq.h>
19 #include <linux/bitops.h>
20 #include <linux/gpio/driver.h>
21 #include <linux/device.h>
22 #include <linux/amba/bus.h>
23 #include <linux/slab.h>
24 #include <linux/pinctrl/consumer.h>
36 #define PL061_GPIO_NR 8
39 struct pl061_context_save_regs {
54 struct irq_chip irq_chip;
58 struct pl061_context_save_regs csave_regs;
62 static int pl061_get_direction(struct gpio_chip *gc, unsigned offset)
64 struct pl061 *pl061 = gpiochip_get_data(gc);
66 return !(readb(pl061->base + GPIODIR) & BIT(offset));
69 static int pl061_direction_input(struct gpio_chip *gc, unsigned offset)
71 struct pl061 *pl061 = gpiochip_get_data(gc);
73 unsigned char gpiodir;
75 raw_spin_lock_irqsave(&pl061->lock, flags);
76 gpiodir = readb(pl061->base + GPIODIR);
77 gpiodir &= ~(BIT(offset));
78 writeb(gpiodir, pl061->base + GPIODIR);
79 raw_spin_unlock_irqrestore(&pl061->lock, flags);
84 static int pl061_direction_output(struct gpio_chip *gc, unsigned offset,
87 struct pl061 *pl061 = gpiochip_get_data(gc);
89 unsigned char gpiodir;
91 raw_spin_lock_irqsave(&pl061->lock, flags);
92 writeb(!!value << offset, pl061->base + (BIT(offset + 2)));
93 gpiodir = readb(pl061->base + GPIODIR);
94 gpiodir |= BIT(offset);
95 writeb(gpiodir, pl061->base + GPIODIR);
98 * gpio value is set again, because pl061 doesn't allow to set value of
99 * a gpio pin before configuring it in OUT mode.
101 writeb(!!value << offset, pl061->base + (BIT(offset + 2)));
102 raw_spin_unlock_irqrestore(&pl061->lock, flags);
107 static int pl061_get_value(struct gpio_chip *gc, unsigned offset)
109 struct pl061 *pl061 = gpiochip_get_data(gc);
111 return !!readb(pl061->base + (BIT(offset + 2)));
114 static void pl061_set_value(struct gpio_chip *gc, unsigned offset, int value)
116 struct pl061 *pl061 = gpiochip_get_data(gc);
118 writeb(!!value << offset, pl061->base + (BIT(offset + 2)));
121 static int pl061_irq_type(struct irq_data *d, unsigned trigger)
123 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
124 struct pl061 *pl061 = gpiochip_get_data(gc);
125 int offset = irqd_to_hwirq(d);
127 u8 gpiois, gpioibe, gpioiev;
128 u8 bit = BIT(offset);
130 if (offset < 0 || offset >= PL061_GPIO_NR)
133 if ((trigger & (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_LEVEL_LOW)) &&
134 (trigger & (IRQ_TYPE_EDGE_RISING | IRQ_TYPE_EDGE_FALLING)))
137 "trying to configure line %d for both level and edge "
138 "detection, choose one!\n",
144 raw_spin_lock_irqsave(&pl061->lock, flags);
146 gpioiev = readb(pl061->base + GPIOIEV);
147 gpiois = readb(pl061->base + GPIOIS);
148 gpioibe = readb(pl061->base + GPIOIBE);
150 if (trigger & (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_LEVEL_LOW)) {
151 bool polarity = trigger & IRQ_TYPE_LEVEL_HIGH;
153 /* Disable edge detection */
155 /* Enable level detection */
157 /* Select polarity */
162 irq_set_handler_locked(d, handle_level_irq);
163 dev_dbg(gc->parent, "line %d: IRQ on %s level\n",
165 polarity ? "HIGH" : "LOW");
166 } else if ((trigger & IRQ_TYPE_EDGE_BOTH) == IRQ_TYPE_EDGE_BOTH) {
167 /* Disable level detection */
169 /* Select both edges, setting this makes GPIOEV be ignored */
171 irq_set_handler_locked(d, handle_edge_irq);
172 dev_dbg(gc->parent, "line %d: IRQ on both edges\n", offset);
173 } else if ((trigger & IRQ_TYPE_EDGE_RISING) ||
174 (trigger & IRQ_TYPE_EDGE_FALLING)) {
175 bool rising = trigger & IRQ_TYPE_EDGE_RISING;
177 /* Disable level detection */
179 /* Clear detection on both edges */
186 irq_set_handler_locked(d, handle_edge_irq);
187 dev_dbg(gc->parent, "line %d: IRQ on %s edge\n",
189 rising ? "RISING" : "FALLING");
191 /* No trigger: disable everything */
195 irq_set_handler_locked(d, handle_bad_irq);
196 dev_warn(gc->parent, "no trigger selected for line %d\n",
200 writeb(gpiois, pl061->base + GPIOIS);
201 writeb(gpioibe, pl061->base + GPIOIBE);
202 writeb(gpioiev, pl061->base + GPIOIEV);
204 raw_spin_unlock_irqrestore(&pl061->lock, flags);
209 static void pl061_irq_handler(struct irq_desc *desc)
211 unsigned long pending;
213 struct gpio_chip *gc = irq_desc_get_handler_data(desc);
214 struct pl061 *pl061 = gpiochip_get_data(gc);
215 struct irq_chip *irqchip = irq_desc_get_chip(desc);
217 chained_irq_enter(irqchip, desc);
219 pending = readb(pl061->base + GPIOMIS);
221 for_each_set_bit(offset, &pending, PL061_GPIO_NR)
222 generic_handle_irq(irq_find_mapping(gc->irq.domain,
226 chained_irq_exit(irqchip, desc);
229 static void pl061_irq_mask(struct irq_data *d)
231 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
232 struct pl061 *pl061 = gpiochip_get_data(gc);
233 u8 mask = BIT(irqd_to_hwirq(d) % PL061_GPIO_NR);
236 raw_spin_lock(&pl061->lock);
237 gpioie = readb(pl061->base + GPIOIE) & ~mask;
238 writeb(gpioie, pl061->base + GPIOIE);
239 raw_spin_unlock(&pl061->lock);
242 static void pl061_irq_unmask(struct irq_data *d)
244 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
245 struct pl061 *pl061 = gpiochip_get_data(gc);
246 u8 mask = BIT(irqd_to_hwirq(d) % PL061_GPIO_NR);
249 raw_spin_lock(&pl061->lock);
250 gpioie = readb(pl061->base + GPIOIE) | mask;
251 writeb(gpioie, pl061->base + GPIOIE);
252 raw_spin_unlock(&pl061->lock);
256 * pl061_irq_ack() - ACK an edge IRQ
257 * @d: IRQ data for this IRQ
259 * This gets called from the edge IRQ handler to ACK the edge IRQ
260 * in the GPIOIC (interrupt-clear) register. For level IRQs this is
261 * not needed: these go away when the level signal goes away.
263 static void pl061_irq_ack(struct irq_data *d)
265 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
266 struct pl061 *pl061 = gpiochip_get_data(gc);
267 u8 mask = BIT(irqd_to_hwirq(d) % PL061_GPIO_NR);
269 raw_spin_lock(&pl061->lock);
270 writeb(mask, pl061->base + GPIOIC);
271 raw_spin_unlock(&pl061->lock);
274 static int pl061_irq_set_wake(struct irq_data *d, unsigned int state)
276 struct gpio_chip *gc = irq_data_get_irq_chip_data(d);
277 struct pl061 *pl061 = gpiochip_get_data(gc);
279 return irq_set_irq_wake(pl061->parent_irq, state);
282 static int pl061_probe(struct amba_device *adev, const struct amba_id *id)
284 struct device *dev = &adev->dev;
286 struct gpio_irq_chip *girq;
289 pl061 = devm_kzalloc(dev, sizeof(*pl061), GFP_KERNEL);
293 pl061->base = devm_ioremap_resource(dev, &adev->res);
294 if (IS_ERR(pl061->base))
295 return PTR_ERR(pl061->base);
297 raw_spin_lock_init(&pl061->lock);
298 if (of_property_read_bool(dev->of_node, "gpio-ranges")) {
299 pl061->gc.request = gpiochip_generic_request;
300 pl061->gc.free = gpiochip_generic_free;
304 pl061->gc.get_direction = pl061_get_direction;
305 pl061->gc.direction_input = pl061_direction_input;
306 pl061->gc.direction_output = pl061_direction_output;
307 pl061->gc.get = pl061_get_value;
308 pl061->gc.set = pl061_set_value;
309 pl061->gc.ngpio = PL061_GPIO_NR;
310 pl061->gc.label = dev_name(dev);
311 pl061->gc.parent = dev;
312 pl061->gc.owner = THIS_MODULE;
317 pl061->irq_chip.name = dev_name(dev);
318 pl061->irq_chip.irq_ack = pl061_irq_ack;
319 pl061->irq_chip.irq_mask = pl061_irq_mask;
320 pl061->irq_chip.irq_unmask = pl061_irq_unmask;
321 pl061->irq_chip.irq_set_type = pl061_irq_type;
322 pl061->irq_chip.irq_set_wake = pl061_irq_set_wake;
324 writeb(0, pl061->base + GPIOIE); /* disable irqs */
327 dev_err(&adev->dev, "invalid IRQ\n");
330 pl061->parent_irq = irq;
332 girq = &pl061->gc.irq;
333 girq->chip = &pl061->irq_chip;
334 girq->parent_handler = pl061_irq_handler;
335 girq->num_parents = 1;
336 girq->parents = devm_kcalloc(dev, 1, sizeof(*girq->parents),
340 girq->parents[0] = irq;
341 girq->default_type = IRQ_TYPE_NONE;
342 girq->handler = handle_bad_irq;
344 ret = devm_gpiochip_add_data(dev, &pl061->gc, pl061);
348 amba_set_drvdata(adev, pl061);
349 dev_info(dev, "PL061 GPIO chip registered\n");
355 static int pl061_suspend(struct device *dev)
357 struct pl061 *pl061 = dev_get_drvdata(dev);
360 pl061->csave_regs.gpio_data = 0;
361 pl061->csave_regs.gpio_dir = readb(pl061->base + GPIODIR);
362 pl061->csave_regs.gpio_is = readb(pl061->base + GPIOIS);
363 pl061->csave_regs.gpio_ibe = readb(pl061->base + GPIOIBE);
364 pl061->csave_regs.gpio_iev = readb(pl061->base + GPIOIEV);
365 pl061->csave_regs.gpio_ie = readb(pl061->base + GPIOIE);
367 for (offset = 0; offset < PL061_GPIO_NR; offset++) {
368 if (pl061->csave_regs.gpio_dir & (BIT(offset)))
369 pl061->csave_regs.gpio_data |=
370 pl061_get_value(&pl061->gc, offset) << offset;
376 static int pl061_resume(struct device *dev)
378 struct pl061 *pl061 = dev_get_drvdata(dev);
381 for (offset = 0; offset < PL061_GPIO_NR; offset++) {
382 if (pl061->csave_regs.gpio_dir & (BIT(offset)))
383 pl061_direction_output(&pl061->gc, offset,
384 pl061->csave_regs.gpio_data &
387 pl061_direction_input(&pl061->gc, offset);
390 writeb(pl061->csave_regs.gpio_is, pl061->base + GPIOIS);
391 writeb(pl061->csave_regs.gpio_ibe, pl061->base + GPIOIBE);
392 writeb(pl061->csave_regs.gpio_iev, pl061->base + GPIOIEV);
393 writeb(pl061->csave_regs.gpio_ie, pl061->base + GPIOIE);
398 static const struct dev_pm_ops pl061_dev_pm_ops = {
399 .suspend = pl061_suspend,
400 .resume = pl061_resume,
401 .freeze = pl061_suspend,
402 .restore = pl061_resume,
406 static const struct amba_id pl061_ids[] = {
414 static struct amba_driver pl061_gpio_driver = {
416 .name = "pl061_gpio",
418 .pm = &pl061_dev_pm_ops,
421 .id_table = pl061_ids,
422 .probe = pl061_probe,
425 static int __init pl061_gpio_init(void)
427 return amba_driver_register(&pl061_gpio_driver);
429 device_initcall(pl061_gpio_init);