lkml.org 
[lkml]   [2022]   [Apr]   [8]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
Date
SubjectRe: [PATCH v2 10/10] Documentation: Update the recommended pattern for GPIO irqchips
On Wed, Apr 6, 2022 at 1:57 PM Marc Zyngier <maz@kernel.org> wrote:
>
> Update the documentation to get rid of the per-gpio_irq_chip
> irq_chip structure, and give examples of the new pattern.

...

> + static void my_gpio_mask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);
> +
> + /*
> + * Perform any necessary action to mask the interrupt,
> + * and then call into the core code to synchronise the
> + * state.
> + */
> +
> + gpiochip_disable_irq(gc, d->hwirq);

(1)

> + }
> +
> + static void my_gpio_unmask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);

> + gpiochip_disable_irq(gc, d->hwirq);

(2)

> + /*
> + * Perform any necessary action to unmask the interrupt,
> + * after having called into the core code to synchronise
> + * the state.
> + */
> + }

If (1) and (2) being the same is not a mistake (typo) it probably
needs additional explanation.

...

> + static void my_gpio_mask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);
> +
> + /*
> + * Perform any necessary action to mask the interrupt,
> + * and then call into the core code to synchronise the
> + * state.
> + */

> + gpiochip_disable_irq(gc, d->hwirq);

(3)

> + }
> +
> + static void my_gpio_unmask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);

> + gpiochip_disable_irq(gc, d->hwirq);

(4)

> + /*
> + * Perform any necessary action to unmask the interrupt,
> + * after having called into the core code to synchronise
> + * the state.
> + */
> + }

Ditto for (3) & (4).

...

> + static void my_gpio_mask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);
> +
> + /*
> + * Perform any necessary action to mask the interrupt,
> + * and then call into the core code to synchronise the
> + * state.
> + */
> +
> + gpiochip_disable_irq(gc, d->hwirq);

(5)

> + irq_mask_mask_parent(d);
> + }
> +
> + static void my_gpio_unmask_irq(struct irq_data *d)
> + {
> + struct gpio_chip *gc = irq_desc_get_handler_data(d);

> + gpiochip_disable_irq(gc, d->hwirq);

(6)

> + /*
> + * Perform any necessary action to unmask the interrupt,
> + * after having called into the core code to synchronise
> + * the state.
> + */
> +
> + irq_mask_unmask_parent(d);
> + }

Ditto for (5) & (6).

--
With Best Regards,
Andy Shevchenko

\
 
 \ /
  Last update: 2022-04-08 13:38    [W:0.126 / U:0.600 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site