2 * linux/arch/arm/kernel/irq.c
4 * Copyright (C) 1992 Linus Torvalds
5 * Modifications for ARM processor Copyright (C) 1995-2000 Russell King.
6 * 'Borrowed' for ARM26 and (C) 2003 Ian Molton.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
12 * This file contains the code used by various IRQ handling routines:
13 * asking for different IRQ's should be done through these routines
14 * instead of just grabbing them. Thus setups with different IRQ numbers
15 * shouldn't result in any weird surprises, and installing new handlers
18 * IRQ's are in fact implemented a bit like signal handlers for the kernel.
19 * Naturally it's not a 1:1 relation, but there are similarities.
21 #include <linux/module.h>
22 #include <linux/ptrace.h>
23 #include <linux/kernel_stat.h>
24 #include <linux/signal.h>
25 #include <linux/sched.h>
26 #include <linux/ioport.h>
27 #include <linux/interrupt.h>
28 #include <linux/slab.h>
29 #include <linux/random.h>
30 #include <linux/smp.h>
31 #include <linux/init.h>
32 #include <linux/seq_file.h>
33 #include <linux/errno.h>
34 #include <linux/vs_context.h>
37 #include <asm/system.h>
38 #include <asm/irqchip.h>
40 //FIXME - this ought to be in a header IMO
41 void __init arc_init_irq(void);
44 * Maximum IRQ count. Currently, this is arbitary. However, it should
45 * not be set too low to prevent false triggering. Conversely, if it
46 * is set too high, then you could miss a stuck IRQ.
48 * FIXME Maybe we ought to set a timer and re-enable the IRQ at a later time?
50 #define MAX_IRQ_CNT 100000
52 static volatile unsigned long irq_err_count;
53 static DEFINE_SPINLOCK(irq_controller_lock);
55 struct irqdesc irq_desc[NR_IRQS];
58 * Dummy mask/unmask handler
60 void dummy_mask_unmask_irq(unsigned int irq)
64 void do_bad_IRQ(unsigned int irq, struct irqdesc *desc, struct pt_regs *regs)
67 printk(KERN_ERR "IRQ: spurious interrupt %d\n", irq);
70 static struct irqchip bad_chip = {
71 .ack = dummy_mask_unmask_irq,
72 .mask = dummy_mask_unmask_irq,
73 .unmask = dummy_mask_unmask_irq,
76 static struct irqdesc bad_irq_desc = {
83 * disable_irq - disable an irq and wait for completion
84 * @irq: Interrupt to disable
86 * Disable the selected interrupt line. We do this lazily.
88 * This function may be called from IRQ context.
90 void disable_irq(unsigned int irq)
92 struct irqdesc *desc = irq_desc + irq;
94 spin_lock_irqsave(&irq_controller_lock, flags);
97 spin_unlock_irqrestore(&irq_controller_lock, flags);
101 * enable_irq - enable interrupt handling on an irq
102 * @irq: Interrupt to enable
104 * Re-enables the processing of interrupts on this IRQ line.
105 * Note that this may call the interrupt handler, so you may
106 * get unexpected results if you hold IRQs disabled.
108 * This function may be called from IRQ context.
110 void enable_irq(unsigned int irq)
112 struct irqdesc *desc = irq_desc + irq;
116 spin_lock_irqsave(&irq_controller_lock, flags);
117 if (unlikely(!desc->depth)) {
118 printk("enable_irq(%u) unbalanced from %p\n", irq,
119 __builtin_return_address(0)); //FIXME bum addresses reported - why?
120 } else if (!--desc->depth) {
123 desc->chip->unmask(irq);
124 pending = desc->pending;
127 * If the interrupt was waiting to be processed,
131 desc->chip->rerun(irq);
133 spin_unlock_irqrestore(&irq_controller_lock, flags);
136 int show_interrupts(struct seq_file *p, void *v)
138 int i = *(loff_t *) v;
139 struct irqaction * action;
142 action = irq_desc[i].action;
145 seq_printf(p, "%3d: %10u ", i, kstat_irqs(i));
146 seq_printf(p, " %s", action->name);
147 for (action = action->next; action; action = action->next) {
148 seq_printf(p, ", %s", action->name);
151 } else if (i == NR_IRQS) {
153 seq_printf(p, "Err: %10lu\n", irq_err_count);
160 * IRQ lock detection.
162 * Hopefully, this should get us out of a few locked situations.
163 * However, it may take a while for this to happen, since we need
164 * a large number if IRQs to appear in the same jiffie with the
165 * same instruction pointer (or within 2 instructions).
167 static int check_irq_lock(struct irqdesc *desc, int irq, struct pt_regs *regs)
169 unsigned long instr_ptr = instruction_pointer(regs);
171 if (desc->lck_jif == jiffies &&
172 desc->lck_pc >= instr_ptr && desc->lck_pc < instr_ptr + 8) {
175 if (desc->lck_cnt > MAX_IRQ_CNT) {
176 printk(KERN_ERR "IRQ LOCK: IRQ%d is locking the system, disabled\n", irq);
181 desc->lck_pc = instruction_pointer(regs);
182 desc->lck_jif = jiffies;
188 __do_irq(unsigned int irq, struct irqaction *action, struct pt_regs *regs)
193 spin_unlock(&irq_controller_lock);
194 if (!(action->flags & IRQF_DISABLED))
199 ret = action->handler(irq, action->dev_id, regs);
200 if (ret == IRQ_HANDLED)
201 status |= action->flags;
202 action = action->next;
205 if (status & IRQF_SAMPLE_RANDOM)
206 add_interrupt_randomness(irq);
208 spin_lock_irq(&irq_controller_lock);
212 * This is for software-decoded IRQs. The caller is expected to
213 * handle the ack, clear, mask and unmask issues.
216 do_simple_IRQ(unsigned int irq, struct irqdesc *desc, struct pt_regs *regs)
218 struct irqaction *action;
219 const int cpu = smp_processor_id();
223 kstat_cpu(cpu).irqs[irq]++;
225 action = desc->action;
227 __do_irq(irq, desc->action, regs);
231 * Most edge-triggered IRQ implementations seem to take a broken
232 * approach to this. Hence the complexity.
235 do_edge_IRQ(unsigned int irq, struct irqdesc *desc, struct pt_regs *regs)
237 const int cpu = smp_processor_id();
242 * If we're currently running this IRQ, or its disabled,
243 * we shouldn't process the IRQ. Instead, turn on the
246 if (unlikely(desc->running || !desc->enabled))
250 * Acknowledge and clear the IRQ, but don't mask it.
252 desc->chip->ack(irq);
255 * Mark the IRQ currently in progress.
259 kstat_cpu(cpu).irqs[irq]++;
262 struct irqaction *action;
264 action = desc->action;
268 if (desc->pending && desc->enabled) {
270 desc->chip->unmask(irq);
273 __do_irq(irq, action, regs);
274 } while (desc->pending);
279 * If we were disabled or freed, shut down the handler.
281 if (likely(desc->action && !check_irq_lock(desc, irq, regs)))
286 * We got another IRQ while this one was masked or
287 * currently running. Delay it.
290 desc->chip->mask(irq);
291 desc->chip->ack(irq);
295 * Level-based IRQ handler. Nice and simple.
298 do_level_IRQ(unsigned int irq, struct irqdesc *desc, struct pt_regs *regs)
300 struct irqaction *action;
301 const int cpu = smp_processor_id();
306 * Acknowledge, clear _AND_ disable the interrupt.
308 desc->chip->ack(irq);
310 if (likely(desc->enabled)) {
311 kstat_cpu(cpu).irqs[irq]++;
314 * Return with this interrupt masked if no action
316 action = desc->action;
318 __do_irq(irq, desc->action, regs);
320 if (likely(desc->enabled &&
321 !check_irq_lock(desc, irq, regs)))
322 desc->chip->unmask(irq);
328 * do_IRQ handles all hardware IRQ's. Decoded IRQs should not
329 * come via this function. Instead, they should provide their
332 asmlinkage void asm_do_IRQ(int irq, struct pt_regs *regs)
334 struct irqdesc *desc = irq_desc + irq;
335 struct vx_info_save vxis;
338 * Some hardware gives randomly wrong interrupts. Rather
339 * than crashing, do something sensible.
342 desc = &bad_irq_desc;
345 spin_lock(&irq_controller_lock);
346 __enter_vx_admin(&vxis);
347 desc->handle(irq, desc, regs);
348 __leave_vx_admin(&vxis);
349 spin_unlock(&irq_controller_lock);
353 void __set_irq_handler(unsigned int irq, irq_handler_t handle, int is_chained)
355 struct irqdesc *desc;
358 if (irq >= NR_IRQS) {
359 printk(KERN_ERR "Trying to install handler for IRQ%d\n", irq);
366 desc = irq_desc + irq;
368 if (is_chained && desc->chip == &bad_chip)
369 printk(KERN_WARNING "Trying to install chained handler for IRQ%d\n", irq);
371 spin_lock_irqsave(&irq_controller_lock, flags);
372 if (handle == do_bad_IRQ) {
373 desc->chip->mask(irq);
374 desc->chip->ack(irq);
378 desc->handle = handle;
379 if (handle != do_bad_IRQ && is_chained) {
383 desc->chip->unmask(irq);
385 spin_unlock_irqrestore(&irq_controller_lock, flags);
388 void set_irq_chip(unsigned int irq, struct irqchip *chip)
390 struct irqdesc *desc;
393 if (irq >= NR_IRQS) {
394 printk(KERN_ERR "Trying to install chip for IRQ%d\n", irq);
401 desc = irq_desc + irq;
402 spin_lock_irqsave(&irq_controller_lock, flags);
404 spin_unlock_irqrestore(&irq_controller_lock, flags);
407 int set_irq_type(unsigned int irq, unsigned int type)
409 struct irqdesc *desc;
413 if (irq >= NR_IRQS) {
414 printk(KERN_ERR "Trying to set irq type for IRQ%d\n", irq);
418 desc = irq_desc + irq;
419 if (desc->chip->type) {
420 spin_lock_irqsave(&irq_controller_lock, flags);
421 ret = desc->chip->type(irq, type);
422 spin_unlock_irqrestore(&irq_controller_lock, flags);
428 void set_irq_flags(unsigned int irq, unsigned int iflags)
430 struct irqdesc *desc;
433 if (irq >= NR_IRQS) {
434 printk(KERN_ERR "Trying to set irq flags for IRQ%d\n", irq);
438 desc = irq_desc + irq;
439 spin_lock_irqsave(&irq_controller_lock, flags);
440 desc->valid = (iflags & IRQF_VALID) != 0;
441 desc->probe_ok = (iflags & IRQF_PROBE) != 0;
442 desc->noautoenable = (iflags & IRQF_NOAUTOEN) != 0;
443 spin_unlock_irqrestore(&irq_controller_lock, flags);
446 int setup_irq(unsigned int irq, struct irqaction *new)
449 struct irqaction *old, **p;
451 struct irqdesc *desc;
454 * Some drivers like serial.c use request_irq() heavily,
455 * so we have to be careful not to interfere with a
458 if (new->flags & IRQF_SAMPLE_RANDOM) {
460 * This function might sleep, we want to call it first,
461 * outside of the atomic block.
462 * Yes, this might clear the entropy pool if the wrong
463 * driver is attempted to be loaded, without actually
464 * installing a new handler, but is this really a problem,
465 * only the sysadmin is able to do this.
467 rand_initialize_irq(irq);
471 * The following block of code has to be executed atomically
473 desc = irq_desc + irq;
474 spin_lock_irqsave(&irq_controller_lock, flags);
476 if ((old = *p) != NULL) {
477 /* Can't share interrupts unless both agree to */
478 if (!(old->flags & new->flags & IRQF_SHARED)) {
479 spin_unlock_irqrestore(&irq_controller_lock, flags);
483 /* add new interrupt at end of irq queue */
498 if (!desc->noautoenable) {
501 desc->chip->unmask(irq);
505 spin_unlock_irqrestore(&irq_controller_lock, flags);
510 * request_irq - allocate an interrupt line
511 * @irq: Interrupt line to allocate
512 * @handler: Function to be called when the IRQ occurs
513 * @irqflags: Interrupt type flags
514 * @devname: An ascii name for the claiming device
515 * @dev_id: A cookie passed back to the handler function
517 * This call allocates interrupt resources and enables the
518 * interrupt line and IRQ handling. From the point this
519 * call is made your handler function may be invoked. Since
520 * your handler function must clear any interrupt the board
521 * raises, you must take care both to initialise your hardware
522 * and to set up the interrupt handler in the right order.
524 * Dev_id must be globally unique. Normally the address of the
525 * device data structure is used as the cookie. Since the handler
526 * receives this value it makes sense to use it.
528 * If your interrupt is shared you must pass a non NULL dev_id
529 * as this is required when freeing the interrupt.
533 * IRQF_SHARED Interrupt is shared
535 * IRQF_DISABLED Disable local interrupts while processing
537 * IRQF_SAMPLE_RANDOM The interrupt can be used for entropy
541 //FIXME - handler used to return void - whats the significance of the change?
542 int request_irq(unsigned int irq, irqreturn_t (*handler)(int, void *, struct pt_regs *),
543 unsigned long irq_flags, const char * devname, void *dev_id)
545 unsigned long retval;
546 struct irqaction *action;
548 if (irq >= NR_IRQS || !irq_desc[irq].valid || !handler ||
549 (irq_flags & IRQF_SHARED && !dev_id))
552 action = (struct irqaction *)kmalloc(sizeof(struct irqaction), GFP_KERNEL);
556 action->handler = handler;
557 action->flags = irq_flags;
558 cpus_clear(action->mask);
559 action->name = devname;
561 action->dev_id = dev_id;
563 retval = setup_irq(irq, action);
570 EXPORT_SYMBOL(request_irq);
573 * free_irq - free an interrupt
574 * @irq: Interrupt line to free
575 * @dev_id: Device identity to free
577 * Remove an interrupt handler. The handler is removed and if the
578 * interrupt line is no longer in use by any driver it is disabled.
579 * On a shared IRQ the caller must ensure the interrupt is disabled
580 * on the card it drives before calling this function.
582 * This function may be called from interrupt context.
584 void free_irq(unsigned int irq, void *dev_id)
586 struct irqaction * action, **p;
589 if (irq >= NR_IRQS || !irq_desc[irq].valid) {
590 printk(KERN_ERR "Trying to free IRQ%d\n",irq);
591 #ifdef CONFIG_DEBUG_ERRORS
597 spin_lock_irqsave(&irq_controller_lock, flags);
598 for (p = &irq_desc[irq].action; (action = *p) != NULL; p = &action->next) {
599 if (action->dev_id != dev_id)
602 /* Found it - now free it */
607 printk(KERN_ERR "Trying to free free IRQ%d\n",irq);
608 #ifdef CONFIG_DEBUG_ERRORS
612 spin_unlock_irqrestore(&irq_controller_lock, flags);
615 EXPORT_SYMBOL(free_irq);
617 /* Start the interrupt probing. Unlike other architectures,
618 * we don't return a mask of interrupts from probe_irq_on,
619 * but return the number of interrupts enabled for the probe.
620 * The interrupts which have been enabled for probing is
621 * instead recorded in the irq_desc structure.
623 unsigned long probe_irq_on(void)
625 unsigned int i, irqs = 0;
629 * first snaffle up any unassigned but
630 * probe-able interrupts
632 spin_lock_irq(&irq_controller_lock);
633 for (i = 0; i < NR_IRQS; i++) {
634 if (!irq_desc[i].probe_ok || irq_desc[i].action)
637 irq_desc[i].probing = 1;
638 irq_desc[i].triggered = 0;
639 if (irq_desc[i].chip->type)
640 irq_desc[i].chip->type(i, IRQT_PROBE);
641 irq_desc[i].chip->unmask(i);
644 spin_unlock_irq(&irq_controller_lock);
647 * wait for spurious interrupts to mask themselves out again
649 for (delay = jiffies + HZ/10; time_before(jiffies, delay); )
650 /* min 100ms delay */;
653 * now filter out any obviously spurious interrupts
655 spin_lock_irq(&irq_controller_lock);
656 for (i = 0; i < NR_IRQS; i++) {
657 if (irq_desc[i].probing && irq_desc[i].triggered) {
658 irq_desc[i].probing = 0;
662 spin_unlock_irq(&irq_controller_lock);
667 EXPORT_SYMBOL(probe_irq_on);
670 * Possible return values:
671 * >= 0 - interrupt number
672 * -1 - no interrupt/many interrupts
674 int probe_irq_off(unsigned long irqs)
677 int irq_found = NO_IRQ;
680 * look at the interrupts, and find exactly one
681 * that we were probing has been triggered
683 spin_lock_irq(&irq_controller_lock);
684 for (i = 0; i < NR_IRQS; i++) {
685 if (irq_desc[i].probing &&
686 irq_desc[i].triggered) {
687 if (irq_found != NO_IRQ) {
698 spin_unlock_irq(&irq_controller_lock);
703 EXPORT_SYMBOL(probe_irq_off);
705 void __init init_irq_proc(void)
709 void __init init_IRQ(void)
711 struct irqdesc *desc;
712 extern void init_dma(void);
715 for (irq = 0, desc = irq_desc; irq < NR_IRQS; irq++, desc++)
716 *desc = bad_irq_desc;