[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <20090531032802.GA14148@tarshish>
Date: Sun, 31 May 2009 06:28:03 +0300
From: Baruch Siach <baruch@...s.co.il>
To: Andrew Morton <akpm@...ux-foundation.org>
Cc: linux-kernel@...r.kernel.org, dbrownell@...rs.sourceforge.net
Subject: Re: [PATCH] gpio: driver for PrimeCell PL061 GPIO controller
Hi Andrew,
On Wed, May 27, 2009 at 04:38:44PM -0700, Andrew Morton wrote:
> On Tue, 19 May 2009 10:35:29 +0300
> Baruch Siach <baruch@...s.co.il> wrote:
>
> >
> > Signed-off-by: Baruch Siach <baruch@...s.co.il>
>
> Patch looks nice and simple. Was there really nothing you can think of
> for a changelog? Like, what's a "PrimeCell PL061 GPIO"? What hardware
> would one find it on? Is it possible that a "PrimeCell PL061 GPIO" can
> appear on any CPU architecture at all, or is it specific to
> arm/x86/whatever?
>
> etc.
OK. I'll add a changelog.
> > --- a/drivers/gpio/Kconfig
> > +++ b/drivers/gpio/Kconfig
> > @@ -67,6 +67,11 @@ config GPIO_SYSFS
> >
> > comment "Memory mapped GPIO expanders:"
> >
> > +config GPIO_PL061
> > + bool "PrimeCell PL061 GPIO support"
> > + help
> > + Say yes here to support the PrimeCell PL061 GPIO device
> > +
>
> hm, so gpio drivers can't be loaded as modules?
I guess gpio drives can be loaded as modules, but this is also an interrupt
controller. Is there a safe way to unload an interrupt controller? Is there an
example of a driver doing this?
> > ...
> >
> > --- /dev/null
> > +++ b/drivers/gpio/pl061.c
> > @@ -0,0 +1,336 @@
> > +/*
> > + * linux/drivers/gpio/pl061.c
> > + *
> > + * Copyright (C) 2008, 2009 Provigent Ltd.
> > + *
> > + * This program is free software; you can redistribute it and/or modify
> > + * it under the terms of the GNU General Public License version 2 as
> > + * published by the Free Software Foundation.
> > + *
> > + * Driver for the ARM PrimeCell(tm) General Purpose Input/Output (PL061)
> > + *
> > + * Data sheet: ARM DDI 0190B, September 2000
> > + */
> > +#include <linux/spinlock.h>
> > +#include <linux/errno.h>
> > +#include <linux/module.h>
> > +#include <linux/platform_device.h>
> > +#include <linux/io.h>
> > +#include <linux/irq.h>
> > +#include <linux/bitops.h>
> > +#include <linux/workqueue.h>
> > +#include <linux/gpio.h>
> > +#include <linux/gpio/pl061.h>
> > +
> > +#define PL061_GPIO_NR 8
> > +
> > +struct pl061_gpio {
> > + spinlock_t lock;
> > + spinlock_t irq_lock;
>
> It's unclear (to me) why this has two different locks. Perhaps only
> one was needed. If we indeed need two locks then please add code
> comments which explain the role of each one. And the nesting rules if
> appropriate.
The first lock protects the GPIO related hardware registers. The irq_lock
protects the interrupt handling registers. They are mostly independent from
each other. I'll add a comment explaining this.
> > + void __iomem *base;
> > + struct gpio_chip gc;
> > + struct work_struct gpio_free_work;
> > + DECLARE_BITMAP(gpios_to_free, PL061_GPIO_NR);
> > +};
> > +
> > +static u32 (*pl061_pending_irq)(int irq);
> > +
> > +static int pl061_direction_input(struct gpio_chip *gc, unsigned offset)
> > +{
> > + struct pl061_gpio *chip = container_of(gc, struct pl061_gpio, gc);
> > + unsigned long flags;
> > + unsigned char gpiodir;
> > +
> > + if (offset >= gc->ngpio)
> > + return -EINVAL;
> > +
> > + spin_lock_irqsave(&chip->lock, flags);
> > + gpiodir = readb (chip->base + GPIODIR);
>
> Please pass this patch (and indeed, all patches) through
> scripts/checkpatch.pl and consider the resulting output.
OK.
> > + gpiodir &= ~(1 << offset);
> > + writeb(gpiodir, chip->base + GPIODIR);
> > + spin_unlock_irqrestore(&chip->lock, flags);
> > +
> > + return 0;
> > +}
> > +
> >
> > ...
> >
> > +static void pl061_irq_shutdown(unsigned irq)
> > +{
> > + struct pl061_gpio *chip = get_irq_chip_data(irq);
> > + int offset = irq_to_gpio(irq) - chip->gc.base;
> > +
> > + pl061_irq_disable(irq);
> > + set_bit(offset, chip->gpios_to_free);
> > + schedule_work(&chip->gpio_free_work);
> > +}
>
> It's usually a bug to add a schedule_work() and no corresponding
> flush_work()/cancel_work_sync()/etc.
>
> Because the callback might still be pending after module removal,
> device shutdown, etc.
>
> If this is for some reason not a bug, I'd suggest that code somments be
> added explaining why.
Is this still a bug when the driver can't be removed?
> > ...
> >
> > +static void pl061_irq_handler(unsigned irq, struct irq_desc *desc)
> > +{
> > + desc->chip->ack(irq);
> > + while (1) {
> > + unsigned long pending;
> > + int gpio;
> > +
> > + pending = pl061_pending_irq(irq);
> > + if (pending == 0)
> > + break;
> > +
> > + for_each_bit(gpio, &pending, BITS_PER_LONG) {
> > + generic_handle_irq(gpio_to_irq(gpio));
> > + }
>
> The braces are superfluous, but checkpatch misses this.
OK.
> > + }
> > + desc->chip->unmask(irq);
> > +}
> > +
> > +static void pl061_gpio_free(struct work_struct *work)
> > +{
> > + struct pl061_gpio *chip = container_of(work, struct pl061_gpio,
> > + gpio_free_work);
> > + int offset;
> > +
> > + while (!bitmap_empty(chip->gpios_to_free, PL061_GPIO_NR)) {
> > + for_each_bit(offset, chip->gpios_to_free, PL061_GPIO_NR) {
> > + int gpio = offset + chip->gc.base;
> > +
> > + if (test_and_clear_bit(offset, chip->gpios_to_free))
> > + gpio_free(gpio);
> > + }
> > + }
>
> Does this function need to do multiple passes over gpios_to_free like
> this? It seems unnecessary.
>
> If it is indeed needed then please add a comment explaining what's
> going on.
It's probably not needed. I'll remove this.
> > +}
> > +
> > +static int __init pl061_probe(struct platform_device *dev)
> > +{
> > + struct pl061_platform_data *pdata;
> > + struct pl061_gpio *chip;
> > + struct resource *r;
> > + int ret, irq, i;
> > +
> > + pdata = dev->dev.platform_data;
> > + if (pdata == NULL)
> > + return -ENODEV;
> > +
> > + chip = kzalloc(sizeof(*chip), GFP_KERNEL);
> > + if (chip == NULL)
> > + return -ENOMEM;
> > +
> > + r = platform_get_resource(dev, IORESOURCE_MEM, 0);
> > + if (r == NULL) {
> > + ret = -ENODEV;
> > + goto free_mem;
> > + }
> > +
> > + chip->base = ioremap(r->start, r->end - r->start + 1);
> > + if (chip->base == NULL) {
> > + ret = -ENOMEM;
> > + goto free_mem;
> > + }
> > +
> > + spin_lock_init(&chip->lock);
> > + spin_lock_init(&chip->irq_lock);
> > +
> > + bitmap_zero(chip->gpios_to_free, PL061_GPIO_NR);
>
> Well. kzalloc() already did that.
OK.
> > + INIT_WORK(&chip->gpio_free_work, pl061_gpio_free);
> > +
> > + chip->gc.direction_input = pl061_direction_input;
> > + chip->gc.direction_output = pl061_direction_output;
> > + chip->gc.get = pl061_get_value;
> > + chip->gc.set = pl061_set_value;
> > + chip->gc.base = pdata->gpio_base;
> > + chip->gc.ngpio = PL061_GPIO_NR;
> > + chip->gc.label = dev->name;
> > + chip->gc.dev = &dev->dev;
> > + chip->gc.owner = THIS_MODULE;
> > +
> > + ret = gpiochip_add(&chip->gc);
> > + if (ret)
> > + goto iounmap;
> > +
> > + /*
> > + * irq_chip support
> > + */
> > + writeb(0, chip->base + GPIOIE); /* disable irqs */
> > + irq = platform_get_irq(dev, 0);
> > + if (irq < 0) {
> > + ret = -ENODEV;
> > + goto iounmap;
> > + }
> > + set_irq_chained_handler(irq, pl061_irq_handler);
> > + pl061_pending_irq = pdata->pending_irqs;
> > +
> > + for (i = 0; i < PL061_GPIO_NR; i++) {
> > + if (pdata->directions & (1 << i))
> > + pl061_direction_output(&chip->gc, i,
> > + pdata->values & (1 << i));
> > + else
> > + pl061_direction_input(&chip->gc, i);
> > +
> > + set_irq_chip(gpio_to_irq(i+pdata->gpio_base), &pl061_irqchip);
> > + set_irq_handler(gpio_to_irq(i+pdata->gpio_base),
> > + handle_simple_irq);
> > + set_irq_flags(gpio_to_irq(i+pdata->gpio_base), IRQF_VALID);
> > + set_irq_chip_data(gpio_to_irq(i+pdata->gpio_base), chip);
> > + }
> > +
> > + return 0;
> > +
> > +iounmap:
> > + iounmap(chip->base);
> > +free_mem:
> > + kfree(chip);
> > +
> > + return ret;
> > +}
> > +
> >
> > ...
baruch
--
~. .~ Tk Open Systems
=}------------------------------------------------ooO--U--Ooo------------{=
- baruch@...s.co.il - tel: +972.2.679.5364, http://www.tkos.co.il -
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists