1 // SPDX-License-Identifier: GPL-2.0
3 * Library implementing the most common irq chip callback functions
5 * Copyright (C) 2011, Thomas Gleixner
9 #include <linux/slab.h>
10 #include <linux/export.h>
11 #include <linux/irqdomain.h>
12 #include <linux/interrupt.h>
13 #include <linux/kernel_stat.h>
14 #include <linux/syscore_ops.h>
16 #include "internals.h"
18 static LIST_HEAD(gc_list
);
19 static DEFINE_RAW_SPINLOCK(gc_lock
);
22 * irq_gc_noop - NOOP function
25 void irq_gc_noop(struct irq_data
*d
)
30 * irq_gc_mask_disable_reg - Mask chip via disable register
33 * Chip has separate enable/disable registers instead of a single mask
36 void irq_gc_mask_disable_reg(struct irq_data
*d
)
38 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
39 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
43 irq_reg_writel(gc
, mask
, ct
->regs
.disable
);
44 *ct
->mask_cache
&= ~mask
;
49 * irq_gc_mask_set_bit - Mask chip via setting bit in mask register
52 * Chip has a single mask register. Values of this register are cached
53 * and protected by gc->lock
55 void irq_gc_mask_set_bit(struct irq_data
*d
)
57 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
58 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
62 *ct
->mask_cache
|= mask
;
63 irq_reg_writel(gc
, *ct
->mask_cache
, ct
->regs
.mask
);
66 EXPORT_SYMBOL_GPL(irq_gc_mask_set_bit
);
69 * irq_gc_mask_clr_bit - Mask chip via clearing bit in mask register
72 * Chip has a single mask register. Values of this register are cached
73 * and protected by gc->lock
75 void irq_gc_mask_clr_bit(struct irq_data
*d
)
77 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
78 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
82 *ct
->mask_cache
&= ~mask
;
83 irq_reg_writel(gc
, *ct
->mask_cache
, ct
->regs
.mask
);
86 EXPORT_SYMBOL_GPL(irq_gc_mask_clr_bit
);
89 * irq_gc_unmask_enable_reg - Unmask chip via enable register
92 * Chip has separate enable/disable registers instead of a single mask
95 void irq_gc_unmask_enable_reg(struct irq_data
*d
)
97 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
98 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
102 irq_reg_writel(gc
, mask
, ct
->regs
.enable
);
103 *ct
->mask_cache
|= mask
;
108 * irq_gc_ack_set_bit - Ack pending interrupt via setting bit
111 void irq_gc_ack_set_bit(struct irq_data
*d
)
113 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
114 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
118 irq_reg_writel(gc
, mask
, ct
->regs
.ack
);
121 EXPORT_SYMBOL_GPL(irq_gc_ack_set_bit
);
124 * irq_gc_ack_clr_bit - Ack pending interrupt via clearing bit
127 void irq_gc_ack_clr_bit(struct irq_data
*d
)
129 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
130 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
134 irq_reg_writel(gc
, mask
, ct
->regs
.ack
);
139 * irq_gc_mask_disable_and_ack_set - Mask and ack pending interrupt
142 * This generic implementation of the irq_mask_ack method is for chips
143 * with separate enable/disable registers instead of a single mask
144 * register and where a pending interrupt is acknowledged by setting a
147 * Note: This is the only permutation currently used. Similar generic
148 * functions should be added here if other permutations are required.
150 void irq_gc_mask_disable_and_ack_set(struct irq_data
*d
)
152 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
153 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
157 irq_reg_writel(gc
, mask
, ct
->regs
.disable
);
158 *ct
->mask_cache
&= ~mask
;
159 irq_reg_writel(gc
, mask
, ct
->regs
.ack
);
164 * irq_gc_eoi - EOI interrupt
167 void irq_gc_eoi(struct irq_data
*d
)
169 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
170 struct irq_chip_type
*ct
= irq_data_get_chip_type(d
);
174 irq_reg_writel(gc
, mask
, ct
->regs
.eoi
);
179 * irq_gc_set_wake - Set/clr wake bit for an interrupt
181 * @on: Indicates whether the wake bit should be set or cleared
183 * For chips where the wake from suspend functionality is not
184 * configured in a separate register and the wakeup active state is
185 * just stored in a bitmask.
187 int irq_gc_set_wake(struct irq_data
*d
, unsigned int on
)
189 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
192 if (!(mask
& gc
->wake_enabled
))
197 gc
->wake_active
|= mask
;
199 gc
->wake_active
&= ~mask
;
204 static u32
irq_readl_be(void __iomem
*addr
)
206 return ioread32be(addr
);
209 static void irq_writel_be(u32 val
, void __iomem
*addr
)
211 iowrite32be(val
, addr
);
214 void irq_init_generic_chip(struct irq_chip_generic
*gc
, const char *name
,
215 int num_ct
, unsigned int irq_base
,
216 void __iomem
*reg_base
, irq_flow_handler_t handler
)
218 raw_spin_lock_init(&gc
->lock
);
220 gc
->irq_base
= irq_base
;
221 gc
->reg_base
= reg_base
;
222 gc
->chip_types
->chip
.name
= name
;
223 gc
->chip_types
->handler
= handler
;
227 * irq_alloc_generic_chip - Allocate a generic chip and initialize it
228 * @name: Name of the irq chip
229 * @num_ct: Number of irq_chip_type instances associated with this
230 * @irq_base: Interrupt base nr for this chip
231 * @reg_base: Register base address (virtual)
232 * @handler: Default flow handler associated with this chip
234 * Returns an initialized irq_chip_generic structure. The chip defaults
235 * to the primary (index 0) irq_chip_type and @handler
237 struct irq_chip_generic
*
238 irq_alloc_generic_chip(const char *name
, int num_ct
, unsigned int irq_base
,
239 void __iomem
*reg_base
, irq_flow_handler_t handler
)
241 struct irq_chip_generic
*gc
;
242 unsigned long sz
= sizeof(*gc
) + num_ct
* sizeof(struct irq_chip_type
);
244 gc
= kzalloc(sz
, GFP_KERNEL
);
246 irq_init_generic_chip(gc
, name
, num_ct
, irq_base
, reg_base
,
251 EXPORT_SYMBOL_GPL(irq_alloc_generic_chip
);
254 irq_gc_init_mask_cache(struct irq_chip_generic
*gc
, enum irq_gc_flags flags
)
256 struct irq_chip_type
*ct
= gc
->chip_types
;
257 u32
*mskptr
= &gc
->mask_cache
, mskreg
= ct
->regs
.mask
;
260 for (i
= 0; i
< gc
->num_ct
; i
++) {
261 if (flags
& IRQ_GC_MASK_CACHE_PER_TYPE
) {
262 mskptr
= &ct
[i
].mask_cache_priv
;
263 mskreg
= ct
[i
].regs
.mask
;
265 ct
[i
].mask_cache
= mskptr
;
266 if (flags
& IRQ_GC_INIT_MASK_CACHE
)
267 *mskptr
= irq_reg_readl(gc
, mskreg
);
272 * __irq_alloc_domain_generic_chip - Allocate generic chips for an irq domain
273 * @d: irq domain for which to allocate chips
274 * @irqs_per_chip: Number of interrupts each chip handles (max 32)
275 * @num_ct: Number of irq_chip_type instances associated with this
276 * @name: Name of the irq chip
277 * @handler: Default flow handler associated with these chips
278 * @clr: IRQ_* bits to clear in the mapping function
279 * @set: IRQ_* bits to set in the mapping function
280 * @gcflags: Generic chip specific setup flags
282 int __irq_alloc_domain_generic_chips(struct irq_domain
*d
, int irqs_per_chip
,
283 int num_ct
, const char *name
,
284 irq_flow_handler_t handler
,
285 unsigned int clr
, unsigned int set
,
286 enum irq_gc_flags gcflags
)
288 struct irq_domain_chip_generic
*dgc
;
289 struct irq_chip_generic
*gc
;
297 numchips
= DIV_ROUND_UP(d
->revmap_size
, irqs_per_chip
);
301 /* Allocate a pointer, generic chip and chiptypes for each chip */
302 sz
= sizeof(*dgc
) + numchips
* sizeof(gc
);
303 sz
+= numchips
* (sizeof(*gc
) + num_ct
* sizeof(struct irq_chip_type
));
305 tmp
= dgc
= kzalloc(sz
, GFP_KERNEL
);
308 dgc
->irqs_per_chip
= irqs_per_chip
;
309 dgc
->num_chips
= numchips
;
310 dgc
->irq_flags_to_set
= set
;
311 dgc
->irq_flags_to_clear
= clr
;
312 dgc
->gc_flags
= gcflags
;
315 /* Calc pointer to the first generic chip */
316 tmp
+= sizeof(*dgc
) + numchips
* sizeof(gc
);
317 for (i
= 0; i
< numchips
; i
++) {
318 /* Store the pointer to the generic chip */
319 dgc
->gc
[i
] = gc
= tmp
;
320 irq_init_generic_chip(gc
, name
, num_ct
, i
* irqs_per_chip
,
324 if (gcflags
& IRQ_GC_BE_IO
) {
325 gc
->reg_readl
= &irq_readl_be
;
326 gc
->reg_writel
= &irq_writel_be
;
329 raw_spin_lock_irqsave(&gc_lock
, flags
);
330 list_add_tail(&gc
->list
, &gc_list
);
331 raw_spin_unlock_irqrestore(&gc_lock
, flags
);
332 /* Calc pointer to the next generic chip */
333 tmp
+= sizeof(*gc
) + num_ct
* sizeof(struct irq_chip_type
);
337 EXPORT_SYMBOL_GPL(__irq_alloc_domain_generic_chips
);
339 static struct irq_chip_generic
*
340 __irq_get_domain_generic_chip(struct irq_domain
*d
, unsigned int hw_irq
)
342 struct irq_domain_chip_generic
*dgc
= d
->gc
;
346 return ERR_PTR(-ENODEV
);
347 idx
= hw_irq
/ dgc
->irqs_per_chip
;
348 if (idx
>= dgc
->num_chips
)
349 return ERR_PTR(-EINVAL
);
354 * irq_get_domain_generic_chip - Get a pointer to the generic chip of a hw_irq
355 * @d: irq domain pointer
356 * @hw_irq: Hardware interrupt number
358 struct irq_chip_generic
*
359 irq_get_domain_generic_chip(struct irq_domain
*d
, unsigned int hw_irq
)
361 struct irq_chip_generic
*gc
= __irq_get_domain_generic_chip(d
, hw_irq
);
363 return !IS_ERR(gc
) ? gc
: NULL
;
365 EXPORT_SYMBOL_GPL(irq_get_domain_generic_chip
);
368 * Separate lockdep classes for interrupt chip which can nest irq_desc
369 * lock and request mutex.
371 static struct lock_class_key irq_nested_lock_class
;
372 static struct lock_class_key irq_nested_request_class
;
375 * irq_map_generic_chip - Map a generic chip for an irq domain
377 int irq_map_generic_chip(struct irq_domain
*d
, unsigned int virq
,
378 irq_hw_number_t hw_irq
)
380 struct irq_data
*data
= irq_domain_get_irq_data(d
, virq
);
381 struct irq_domain_chip_generic
*dgc
= d
->gc
;
382 struct irq_chip_generic
*gc
;
383 struct irq_chip_type
*ct
;
384 struct irq_chip
*chip
;
388 gc
= __irq_get_domain_generic_chip(d
, hw_irq
);
392 idx
= hw_irq
% dgc
->irqs_per_chip
;
394 if (test_bit(idx
, &gc
->unused
))
397 if (test_bit(idx
, &gc
->installed
))
403 /* We only init the cache for the first mapping of a generic chip */
404 if (!gc
->installed
) {
405 raw_spin_lock_irqsave(&gc
->lock
, flags
);
406 irq_gc_init_mask_cache(gc
, dgc
->gc_flags
);
407 raw_spin_unlock_irqrestore(&gc
->lock
, flags
);
410 /* Mark the interrupt as installed */
411 set_bit(idx
, &gc
->installed
);
413 if (dgc
->gc_flags
& IRQ_GC_INIT_NESTED_LOCK
)
414 irq_set_lockdep_class(virq
, &irq_nested_lock_class
,
415 &irq_nested_request_class
);
417 if (chip
->irq_calc_mask
)
418 chip
->irq_calc_mask(data
);
420 data
->mask
= 1 << idx
;
422 irq_domain_set_info(d
, virq
, hw_irq
, chip
, gc
, ct
->handler
, NULL
, NULL
);
423 irq_modify_status(virq
, dgc
->irq_flags_to_clear
, dgc
->irq_flags_to_set
);
427 static void irq_unmap_generic_chip(struct irq_domain
*d
, unsigned int virq
)
429 struct irq_data
*data
= irq_domain_get_irq_data(d
, virq
);
430 struct irq_domain_chip_generic
*dgc
= d
->gc
;
431 unsigned int hw_irq
= data
->hwirq
;
432 struct irq_chip_generic
*gc
;
435 gc
= irq_get_domain_generic_chip(d
, hw_irq
);
439 irq_idx
= hw_irq
% dgc
->irqs_per_chip
;
441 clear_bit(irq_idx
, &gc
->installed
);
442 irq_domain_set_info(d
, virq
, hw_irq
, &no_irq_chip
, NULL
, NULL
, NULL
,
447 struct irq_domain_ops irq_generic_chip_ops
= {
448 .map
= irq_map_generic_chip
,
449 .unmap
= irq_unmap_generic_chip
,
450 .xlate
= irq_domain_xlate_onetwocell
,
452 EXPORT_SYMBOL_GPL(irq_generic_chip_ops
);
455 * irq_setup_generic_chip - Setup a range of interrupts with a generic chip
456 * @gc: Generic irq chip holding all data
457 * @msk: Bitmask holding the irqs to initialize relative to gc->irq_base
458 * @flags: Flags for initialization
459 * @clr: IRQ_* bits to clear
460 * @set: IRQ_* bits to set
462 * Set up max. 32 interrupts starting from gc->irq_base. Note, this
463 * initializes all interrupts to the primary irq_chip_type and its
464 * associated handler.
466 void irq_setup_generic_chip(struct irq_chip_generic
*gc
, u32 msk
,
467 enum irq_gc_flags flags
, unsigned int clr
,
470 struct irq_chip_type
*ct
= gc
->chip_types
;
471 struct irq_chip
*chip
= &ct
->chip
;
474 raw_spin_lock(&gc_lock
);
475 list_add_tail(&gc
->list
, &gc_list
);
476 raw_spin_unlock(&gc_lock
);
478 irq_gc_init_mask_cache(gc
, flags
);
480 for (i
= gc
->irq_base
; msk
; msk
>>= 1, i
++) {
484 if (flags
& IRQ_GC_INIT_NESTED_LOCK
)
485 irq_set_lockdep_class(i
, &irq_nested_lock_class
,
486 &irq_nested_request_class
);
488 if (!(flags
& IRQ_GC_NO_MASK
)) {
489 struct irq_data
*d
= irq_get_irq_data(i
);
491 if (chip
->irq_calc_mask
)
492 chip
->irq_calc_mask(d
);
494 d
->mask
= 1 << (i
- gc
->irq_base
);
496 irq_set_chip_and_handler(i
, chip
, ct
->handler
);
497 irq_set_chip_data(i
, gc
);
498 irq_modify_status(i
, clr
, set
);
500 gc
->irq_cnt
= i
- gc
->irq_base
;
502 EXPORT_SYMBOL_GPL(irq_setup_generic_chip
);
505 * irq_setup_alt_chip - Switch to alternative chip
506 * @d: irq_data for this interrupt
507 * @type: Flow type to be initialized
509 * Only to be called from chip->irq_set_type() callbacks.
511 int irq_setup_alt_chip(struct irq_data
*d
, unsigned int type
)
513 struct irq_chip_generic
*gc
= irq_data_get_irq_chip_data(d
);
514 struct irq_chip_type
*ct
= gc
->chip_types
;
517 for (i
= 0; i
< gc
->num_ct
; i
++, ct
++) {
518 if (ct
->type
& type
) {
520 irq_data_to_desc(d
)->handle_irq
= ct
->handler
;
526 EXPORT_SYMBOL_GPL(irq_setup_alt_chip
);
529 * irq_remove_generic_chip - Remove a chip
530 * @gc: Generic irq chip holding all data
531 * @msk: Bitmask holding the irqs to initialize relative to gc->irq_base
532 * @clr: IRQ_* bits to clear
533 * @set: IRQ_* bits to set
535 * Remove up to 32 interrupts starting from gc->irq_base.
537 void irq_remove_generic_chip(struct irq_chip_generic
*gc
, u32 msk
,
538 unsigned int clr
, unsigned int set
)
540 unsigned int i
= gc
->irq_base
;
542 raw_spin_lock(&gc_lock
);
544 raw_spin_unlock(&gc_lock
);
546 for (; msk
; msk
>>= 1, i
++) {
550 /* Remove handler first. That will mask the irq line */
551 irq_set_handler(i
, NULL
);
552 irq_set_chip(i
, &no_irq_chip
);
553 irq_set_chip_data(i
, NULL
);
554 irq_modify_status(i
, clr
, set
);
557 EXPORT_SYMBOL_GPL(irq_remove_generic_chip
);
559 static struct irq_data
*irq_gc_get_irq_data(struct irq_chip_generic
*gc
)
564 return irq_get_irq_data(gc
->irq_base
);
567 * We don't know which of the irqs has been actually
568 * installed. Use the first one.
573 virq
= irq_find_mapping(gc
->domain
, gc
->irq_base
+ __ffs(gc
->installed
));
574 return virq
? irq_get_irq_data(virq
) : NULL
;
578 static int irq_gc_suspend(void)
580 struct irq_chip_generic
*gc
;
582 list_for_each_entry(gc
, &gc_list
, list
) {
583 struct irq_chip_type
*ct
= gc
->chip_types
;
585 if (ct
->chip
.irq_suspend
) {
586 struct irq_data
*data
= irq_gc_get_irq_data(gc
);
589 ct
->chip
.irq_suspend(data
);
598 static void irq_gc_resume(void)
600 struct irq_chip_generic
*gc
;
602 list_for_each_entry(gc
, &gc_list
, list
) {
603 struct irq_chip_type
*ct
= gc
->chip_types
;
608 if (ct
->chip
.irq_resume
) {
609 struct irq_data
*data
= irq_gc_get_irq_data(gc
);
612 ct
->chip
.irq_resume(data
);
617 #define irq_gc_suspend NULL
618 #define irq_gc_resume NULL
621 static void irq_gc_shutdown(void)
623 struct irq_chip_generic
*gc
;
625 list_for_each_entry(gc
, &gc_list
, list
) {
626 struct irq_chip_type
*ct
= gc
->chip_types
;
628 if (ct
->chip
.irq_pm_shutdown
) {
629 struct irq_data
*data
= irq_gc_get_irq_data(gc
);
632 ct
->chip
.irq_pm_shutdown(data
);
637 static struct syscore_ops irq_gc_syscore_ops
= {
638 .suspend
= irq_gc_suspend
,
639 .resume
= irq_gc_resume
,
640 .shutdown
= irq_gc_shutdown
,
643 static int __init
irq_gc_init_ops(void)
645 register_syscore_ops(&irq_gc_syscore_ops
);
648 device_initcall(irq_gc_init_ops
);