Linux 4.15.6
[linux/fpc-iii.git] / kernel / irq / generic-chip.c
blob508c03dfef254b9dc8c3a7a1e3e7307d3a7201b3
1 /*
2 * Library implementing the most common irq chip callback functions
4 * Copyright (C) 2011, Thomas Gleixner
5 */
6 #include <linux/io.h>
7 #include <linux/irq.h>
8 #include <linux/slab.h>
9 #include <linux/export.h>
10 #include <linux/irqdomain.h>
11 #include <linux/interrupt.h>
12 #include <linux/kernel_stat.h>
13 #include <linux/syscore_ops.h>
15 #include "internals.h"
17 static LIST_HEAD(gc_list);
18 static DEFINE_RAW_SPINLOCK(gc_lock);
20 /**
21 * irq_gc_noop - NOOP function
22 * @d: irq_data
24 void irq_gc_noop(struct irq_data *d)
28 /**
29 * irq_gc_mask_disable_reg - Mask chip via disable register
30 * @d: irq_data
32 * Chip has separate enable/disable registers instead of a single mask
33 * register.
35 void irq_gc_mask_disable_reg(struct irq_data *d)
37 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
38 struct irq_chip_type *ct = irq_data_get_chip_type(d);
39 u32 mask = d->mask;
41 irq_gc_lock(gc);
42 irq_reg_writel(gc, mask, ct->regs.disable);
43 *ct->mask_cache &= ~mask;
44 irq_gc_unlock(gc);
47 /**
48 * irq_gc_mask_set_bit - Mask chip via setting bit in mask register
49 * @d: irq_data
51 * Chip has a single mask register. Values of this register are cached
52 * and protected by gc->lock
54 void irq_gc_mask_set_bit(struct irq_data *d)
56 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
57 struct irq_chip_type *ct = irq_data_get_chip_type(d);
58 u32 mask = d->mask;
60 irq_gc_lock(gc);
61 *ct->mask_cache |= mask;
62 irq_reg_writel(gc, *ct->mask_cache, ct->regs.mask);
63 irq_gc_unlock(gc);
65 EXPORT_SYMBOL_GPL(irq_gc_mask_set_bit);
67 /**
68 * irq_gc_mask_clr_bit - Mask chip via clearing bit in mask register
69 * @d: irq_data
71 * Chip has a single mask register. Values of this register are cached
72 * and protected by gc->lock
74 void irq_gc_mask_clr_bit(struct irq_data *d)
76 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
77 struct irq_chip_type *ct = irq_data_get_chip_type(d);
78 u32 mask = d->mask;
80 irq_gc_lock(gc);
81 *ct->mask_cache &= ~mask;
82 irq_reg_writel(gc, *ct->mask_cache, ct->regs.mask);
83 irq_gc_unlock(gc);
85 EXPORT_SYMBOL_GPL(irq_gc_mask_clr_bit);
87 /**
88 * irq_gc_unmask_enable_reg - Unmask chip via enable register
89 * @d: irq_data
91 * Chip has separate enable/disable registers instead of a single mask
92 * register.
94 void irq_gc_unmask_enable_reg(struct irq_data *d)
96 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
97 struct irq_chip_type *ct = irq_data_get_chip_type(d);
98 u32 mask = d->mask;
100 irq_gc_lock(gc);
101 irq_reg_writel(gc, mask, ct->regs.enable);
102 *ct->mask_cache |= mask;
103 irq_gc_unlock(gc);
107 * irq_gc_ack_set_bit - Ack pending interrupt via setting bit
108 * @d: irq_data
110 void irq_gc_ack_set_bit(struct irq_data *d)
112 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
113 struct irq_chip_type *ct = irq_data_get_chip_type(d);
114 u32 mask = d->mask;
116 irq_gc_lock(gc);
117 irq_reg_writel(gc, mask, ct->regs.ack);
118 irq_gc_unlock(gc);
120 EXPORT_SYMBOL_GPL(irq_gc_ack_set_bit);
123 * irq_gc_ack_clr_bit - Ack pending interrupt via clearing bit
124 * @d: irq_data
126 void irq_gc_ack_clr_bit(struct irq_data *d)
128 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
129 struct irq_chip_type *ct = irq_data_get_chip_type(d);
130 u32 mask = ~d->mask;
132 irq_gc_lock(gc);
133 irq_reg_writel(gc, mask, ct->regs.ack);
134 irq_gc_unlock(gc);
138 * irq_gc_mask_disable_and_ack_set - Mask and ack pending interrupt
139 * @d: irq_data
141 * This generic implementation of the irq_mask_ack method is for chips
142 * with separate enable/disable registers instead of a single mask
143 * register and where a pending interrupt is acknowledged by setting a
144 * bit.
146 * Note: This is the only permutation currently used. Similar generic
147 * functions should be added here if other permutations are required.
149 void irq_gc_mask_disable_and_ack_set(struct irq_data *d)
151 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
152 struct irq_chip_type *ct = irq_data_get_chip_type(d);
153 u32 mask = d->mask;
155 irq_gc_lock(gc);
156 irq_reg_writel(gc, mask, ct->regs.disable);
157 *ct->mask_cache &= ~mask;
158 irq_reg_writel(gc, mask, ct->regs.ack);
159 irq_gc_unlock(gc);
163 * irq_gc_eoi - EOI interrupt
164 * @d: irq_data
166 void irq_gc_eoi(struct irq_data *d)
168 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
169 struct irq_chip_type *ct = irq_data_get_chip_type(d);
170 u32 mask = d->mask;
172 irq_gc_lock(gc);
173 irq_reg_writel(gc, mask, ct->regs.eoi);
174 irq_gc_unlock(gc);
178 * irq_gc_set_wake - Set/clr wake bit for an interrupt
179 * @d: irq_data
180 * @on: Indicates whether the wake bit should be set or cleared
182 * For chips where the wake from suspend functionality is not
183 * configured in a separate register and the wakeup active state is
184 * just stored in a bitmask.
186 int irq_gc_set_wake(struct irq_data *d, unsigned int on)
188 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
189 u32 mask = d->mask;
191 if (!(mask & gc->wake_enabled))
192 return -EINVAL;
194 irq_gc_lock(gc);
195 if (on)
196 gc->wake_active |= mask;
197 else
198 gc->wake_active &= ~mask;
199 irq_gc_unlock(gc);
200 return 0;
203 static u32 irq_readl_be(void __iomem *addr)
205 return ioread32be(addr);
208 static void irq_writel_be(u32 val, void __iomem *addr)
210 iowrite32be(val, addr);
213 void irq_init_generic_chip(struct irq_chip_generic *gc, const char *name,
214 int num_ct, unsigned int irq_base,
215 void __iomem *reg_base, irq_flow_handler_t handler)
217 raw_spin_lock_init(&gc->lock);
218 gc->num_ct = num_ct;
219 gc->irq_base = irq_base;
220 gc->reg_base = reg_base;
221 gc->chip_types->chip.name = name;
222 gc->chip_types->handler = handler;
226 * irq_alloc_generic_chip - Allocate a generic chip and initialize it
227 * @name: Name of the irq chip
228 * @num_ct: Number of irq_chip_type instances associated with this
229 * @irq_base: Interrupt base nr for this chip
230 * @reg_base: Register base address (virtual)
231 * @handler: Default flow handler associated with this chip
233 * Returns an initialized irq_chip_generic structure. The chip defaults
234 * to the primary (index 0) irq_chip_type and @handler
236 struct irq_chip_generic *
237 irq_alloc_generic_chip(const char *name, int num_ct, unsigned int irq_base,
238 void __iomem *reg_base, irq_flow_handler_t handler)
240 struct irq_chip_generic *gc;
241 unsigned long sz = sizeof(*gc) + num_ct * sizeof(struct irq_chip_type);
243 gc = kzalloc(sz, GFP_KERNEL);
244 if (gc) {
245 irq_init_generic_chip(gc, name, num_ct, irq_base, reg_base,
246 handler);
248 return gc;
250 EXPORT_SYMBOL_GPL(irq_alloc_generic_chip);
252 static void
253 irq_gc_init_mask_cache(struct irq_chip_generic *gc, enum irq_gc_flags flags)
255 struct irq_chip_type *ct = gc->chip_types;
256 u32 *mskptr = &gc->mask_cache, mskreg = ct->regs.mask;
257 int i;
259 for (i = 0; i < gc->num_ct; i++) {
260 if (flags & IRQ_GC_MASK_CACHE_PER_TYPE) {
261 mskptr = &ct[i].mask_cache_priv;
262 mskreg = ct[i].regs.mask;
264 ct[i].mask_cache = mskptr;
265 if (flags & IRQ_GC_INIT_MASK_CACHE)
266 *mskptr = irq_reg_readl(gc, mskreg);
271 * __irq_alloc_domain_generic_chip - Allocate generic chips for an irq domain
272 * @d: irq domain for which to allocate chips
273 * @irqs_per_chip: Number of interrupts each chip handles (max 32)
274 * @num_ct: Number of irq_chip_type instances associated with this
275 * @name: Name of the irq chip
276 * @handler: Default flow handler associated with these chips
277 * @clr: IRQ_* bits to clear in the mapping function
278 * @set: IRQ_* bits to set in the mapping function
279 * @gcflags: Generic chip specific setup flags
281 int __irq_alloc_domain_generic_chips(struct irq_domain *d, int irqs_per_chip,
282 int num_ct, const char *name,
283 irq_flow_handler_t handler,
284 unsigned int clr, unsigned int set,
285 enum irq_gc_flags gcflags)
287 struct irq_domain_chip_generic *dgc;
288 struct irq_chip_generic *gc;
289 int numchips, sz, i;
290 unsigned long flags;
291 void *tmp;
293 if (d->gc)
294 return -EBUSY;
296 numchips = DIV_ROUND_UP(d->revmap_size, irqs_per_chip);
297 if (!numchips)
298 return -EINVAL;
300 /* Allocate a pointer, generic chip and chiptypes for each chip */
301 sz = sizeof(*dgc) + numchips * sizeof(gc);
302 sz += numchips * (sizeof(*gc) + num_ct * sizeof(struct irq_chip_type));
304 tmp = dgc = kzalloc(sz, GFP_KERNEL);
305 if (!dgc)
306 return -ENOMEM;
307 dgc->irqs_per_chip = irqs_per_chip;
308 dgc->num_chips = numchips;
309 dgc->irq_flags_to_set = set;
310 dgc->irq_flags_to_clear = clr;
311 dgc->gc_flags = gcflags;
312 d->gc = dgc;
314 /* Calc pointer to the first generic chip */
315 tmp += sizeof(*dgc) + numchips * sizeof(gc);
316 for (i = 0; i < numchips; i++) {
317 /* Store the pointer to the generic chip */
318 dgc->gc[i] = gc = tmp;
319 irq_init_generic_chip(gc, name, num_ct, i * irqs_per_chip,
320 NULL, handler);
322 gc->domain = d;
323 if (gcflags & IRQ_GC_BE_IO) {
324 gc->reg_readl = &irq_readl_be;
325 gc->reg_writel = &irq_writel_be;
328 raw_spin_lock_irqsave(&gc_lock, flags);
329 list_add_tail(&gc->list, &gc_list);
330 raw_spin_unlock_irqrestore(&gc_lock, flags);
331 /* Calc pointer to the next generic chip */
332 tmp += sizeof(*gc) + num_ct * sizeof(struct irq_chip_type);
334 return 0;
336 EXPORT_SYMBOL_GPL(__irq_alloc_domain_generic_chips);
338 static struct irq_chip_generic *
339 __irq_get_domain_generic_chip(struct irq_domain *d, unsigned int hw_irq)
341 struct irq_domain_chip_generic *dgc = d->gc;
342 int idx;
344 if (!dgc)
345 return ERR_PTR(-ENODEV);
346 idx = hw_irq / dgc->irqs_per_chip;
347 if (idx >= dgc->num_chips)
348 return ERR_PTR(-EINVAL);
349 return dgc->gc[idx];
353 * irq_get_domain_generic_chip - Get a pointer to the generic chip of a hw_irq
354 * @d: irq domain pointer
355 * @hw_irq: Hardware interrupt number
357 struct irq_chip_generic *
358 irq_get_domain_generic_chip(struct irq_domain *d, unsigned int hw_irq)
360 struct irq_chip_generic *gc = __irq_get_domain_generic_chip(d, hw_irq);
362 return !IS_ERR(gc) ? gc : NULL;
364 EXPORT_SYMBOL_GPL(irq_get_domain_generic_chip);
367 * Separate lockdep classes for interrupt chip which can nest irq_desc
368 * lock and request mutex.
370 static struct lock_class_key irq_nested_lock_class;
371 static struct lock_class_key irq_nested_request_class;
374 * irq_map_generic_chip - Map a generic chip for an irq domain
376 int irq_map_generic_chip(struct irq_domain *d, unsigned int virq,
377 irq_hw_number_t hw_irq)
379 struct irq_data *data = irq_domain_get_irq_data(d, virq);
380 struct irq_domain_chip_generic *dgc = d->gc;
381 struct irq_chip_generic *gc;
382 struct irq_chip_type *ct;
383 struct irq_chip *chip;
384 unsigned long flags;
385 int idx;
387 gc = __irq_get_domain_generic_chip(d, hw_irq);
388 if (IS_ERR(gc))
389 return PTR_ERR(gc);
391 idx = hw_irq % dgc->irqs_per_chip;
393 if (test_bit(idx, &gc->unused))
394 return -ENOTSUPP;
396 if (test_bit(idx, &gc->installed))
397 return -EBUSY;
399 ct = gc->chip_types;
400 chip = &ct->chip;
402 /* We only init the cache for the first mapping of a generic chip */
403 if (!gc->installed) {
404 raw_spin_lock_irqsave(&gc->lock, flags);
405 irq_gc_init_mask_cache(gc, dgc->gc_flags);
406 raw_spin_unlock_irqrestore(&gc->lock, flags);
409 /* Mark the interrupt as installed */
410 set_bit(idx, &gc->installed);
412 if (dgc->gc_flags & IRQ_GC_INIT_NESTED_LOCK)
413 irq_set_lockdep_class(virq, &irq_nested_lock_class,
414 &irq_nested_request_class);
416 if (chip->irq_calc_mask)
417 chip->irq_calc_mask(data);
418 else
419 data->mask = 1 << idx;
421 irq_domain_set_info(d, virq, hw_irq, chip, gc, ct->handler, NULL, NULL);
422 irq_modify_status(virq, dgc->irq_flags_to_clear, dgc->irq_flags_to_set);
423 return 0;
426 static void irq_unmap_generic_chip(struct irq_domain *d, unsigned int virq)
428 struct irq_data *data = irq_domain_get_irq_data(d, virq);
429 struct irq_domain_chip_generic *dgc = d->gc;
430 unsigned int hw_irq = data->hwirq;
431 struct irq_chip_generic *gc;
432 int irq_idx;
434 gc = irq_get_domain_generic_chip(d, hw_irq);
435 if (!gc)
436 return;
438 irq_idx = hw_irq % dgc->irqs_per_chip;
440 clear_bit(irq_idx, &gc->installed);
441 irq_domain_set_info(d, virq, hw_irq, &no_irq_chip, NULL, NULL, NULL,
442 NULL);
446 struct irq_domain_ops irq_generic_chip_ops = {
447 .map = irq_map_generic_chip,
448 .unmap = irq_unmap_generic_chip,
449 .xlate = irq_domain_xlate_onetwocell,
451 EXPORT_SYMBOL_GPL(irq_generic_chip_ops);
454 * irq_setup_generic_chip - Setup a range of interrupts with a generic chip
455 * @gc: Generic irq chip holding all data
456 * @msk: Bitmask holding the irqs to initialize relative to gc->irq_base
457 * @flags: Flags for initialization
458 * @clr: IRQ_* bits to clear
459 * @set: IRQ_* bits to set
461 * Set up max. 32 interrupts starting from gc->irq_base. Note, this
462 * initializes all interrupts to the primary irq_chip_type and its
463 * associated handler.
465 void irq_setup_generic_chip(struct irq_chip_generic *gc, u32 msk,
466 enum irq_gc_flags flags, unsigned int clr,
467 unsigned int set)
469 struct irq_chip_type *ct = gc->chip_types;
470 struct irq_chip *chip = &ct->chip;
471 unsigned int i;
473 raw_spin_lock(&gc_lock);
474 list_add_tail(&gc->list, &gc_list);
475 raw_spin_unlock(&gc_lock);
477 irq_gc_init_mask_cache(gc, flags);
479 for (i = gc->irq_base; msk; msk >>= 1, i++) {
480 if (!(msk & 0x01))
481 continue;
483 if (flags & IRQ_GC_INIT_NESTED_LOCK)
484 irq_set_lockdep_class(i, &irq_nested_lock_class,
485 &irq_nested_request_class);
487 if (!(flags & IRQ_GC_NO_MASK)) {
488 struct irq_data *d = irq_get_irq_data(i);
490 if (chip->irq_calc_mask)
491 chip->irq_calc_mask(d);
492 else
493 d->mask = 1 << (i - gc->irq_base);
495 irq_set_chip_and_handler(i, chip, ct->handler);
496 irq_set_chip_data(i, gc);
497 irq_modify_status(i, clr, set);
499 gc->irq_cnt = i - gc->irq_base;
501 EXPORT_SYMBOL_GPL(irq_setup_generic_chip);
504 * irq_setup_alt_chip - Switch to alternative chip
505 * @d: irq_data for this interrupt
506 * @type: Flow type to be initialized
508 * Only to be called from chip->irq_set_type() callbacks.
510 int irq_setup_alt_chip(struct irq_data *d, unsigned int type)
512 struct irq_chip_generic *gc = irq_data_get_irq_chip_data(d);
513 struct irq_chip_type *ct = gc->chip_types;
514 unsigned int i;
516 for (i = 0; i < gc->num_ct; i++, ct++) {
517 if (ct->type & type) {
518 d->chip = &ct->chip;
519 irq_data_to_desc(d)->handle_irq = ct->handler;
520 return 0;
523 return -EINVAL;
525 EXPORT_SYMBOL_GPL(irq_setup_alt_chip);
528 * irq_remove_generic_chip - Remove a chip
529 * @gc: Generic irq chip holding all data
530 * @msk: Bitmask holding the irqs to initialize relative to gc->irq_base
531 * @clr: IRQ_* bits to clear
532 * @set: IRQ_* bits to set
534 * Remove up to 32 interrupts starting from gc->irq_base.
536 void irq_remove_generic_chip(struct irq_chip_generic *gc, u32 msk,
537 unsigned int clr, unsigned int set)
539 unsigned int i = gc->irq_base;
541 raw_spin_lock(&gc_lock);
542 list_del(&gc->list);
543 raw_spin_unlock(&gc_lock);
545 for (; msk; msk >>= 1, i++) {
546 if (!(msk & 0x01))
547 continue;
549 /* Remove handler first. That will mask the irq line */
550 irq_set_handler(i, NULL);
551 irq_set_chip(i, &no_irq_chip);
552 irq_set_chip_data(i, NULL);
553 irq_modify_status(i, clr, set);
556 EXPORT_SYMBOL_GPL(irq_remove_generic_chip);
558 static struct irq_data *irq_gc_get_irq_data(struct irq_chip_generic *gc)
560 unsigned int virq;
562 if (!gc->domain)
563 return irq_get_irq_data(gc->irq_base);
566 * We don't know which of the irqs has been actually
567 * installed. Use the first one.
569 if (!gc->installed)
570 return NULL;
572 virq = irq_find_mapping(gc->domain, gc->irq_base + __ffs(gc->installed));
573 return virq ? irq_get_irq_data(virq) : NULL;
576 #ifdef CONFIG_PM
577 static int irq_gc_suspend(void)
579 struct irq_chip_generic *gc;
581 list_for_each_entry(gc, &gc_list, list) {
582 struct irq_chip_type *ct = gc->chip_types;
584 if (ct->chip.irq_suspend) {
585 struct irq_data *data = irq_gc_get_irq_data(gc);
587 if (data)
588 ct->chip.irq_suspend(data);
591 if (gc->suspend)
592 gc->suspend(gc);
594 return 0;
597 static void irq_gc_resume(void)
599 struct irq_chip_generic *gc;
601 list_for_each_entry(gc, &gc_list, list) {
602 struct irq_chip_type *ct = gc->chip_types;
604 if (gc->resume)
605 gc->resume(gc);
607 if (ct->chip.irq_resume) {
608 struct irq_data *data = irq_gc_get_irq_data(gc);
610 if (data)
611 ct->chip.irq_resume(data);
615 #else
616 #define irq_gc_suspend NULL
617 #define irq_gc_resume NULL
618 #endif
620 static void irq_gc_shutdown(void)
622 struct irq_chip_generic *gc;
624 list_for_each_entry(gc, &gc_list, list) {
625 struct irq_chip_type *ct = gc->chip_types;
627 if (ct->chip.irq_pm_shutdown) {
628 struct irq_data *data = irq_gc_get_irq_data(gc);
630 if (data)
631 ct->chip.irq_pm_shutdown(data);
636 static struct syscore_ops irq_gc_syscore_ops = {
637 .suspend = irq_gc_suspend,
638 .resume = irq_gc_resume,
639 .shutdown = irq_gc_shutdown,
642 static int __init irq_gc_init_ops(void)
644 register_syscore_ops(&irq_gc_syscore_ops);
645 return 0;
647 device_initcall(irq_gc_init_ops);