1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * include/asm-mips/i8259.h 4 * 5 * i8259A interrupt definitions. 6 * 7 * Copyright (C) 2003 Maciej W. Rozycki 8 * Copyright (C) 2003 Ralf Baechle <ralf@linux-mips.org> 9 */ 10 #ifndef _ASM_I8259_H 11 #define _ASM_I8259_H 12 13 #include <linux/compiler.h> 14 #include <linux/spinlock.h> 15 16 #include <asm/io.h> 17 #include <irq.h> 18 19 /* i8259A PIC registers */ 20 #define PIC_MASTER_CMD 0x20 21 #define PIC_MASTER_IMR 0x21 22 #define PIC_MASTER_ISR PIC_MASTER_CMD 23 #define PIC_MASTER_POLL PIC_MASTER_ISR 24 #define PIC_MASTER_OCW3 PIC_MASTER_ISR 25 #define PIC_SLAVE_CMD 0xa0 26 #define PIC_SLAVE_IMR 0xa1 27 28 /* i8259A PIC related value */ 29 #define PIC_CASCADE_IR 2 30 #define MASTER_ICW4_DEFAULT 0x01 31 #define SLAVE_ICW4_DEFAULT 0x01 32 #define PIC_ICW4_AEOI 2 33 34 extern raw_spinlock_t i8259A_lock; 35 36 extern void make_8259A_irq(unsigned int irq); 37 38 extern void init_i8259_irqs(void); 39 extern struct irq_domain *__init_i8259_irqs(struct device_node *node); 40 41 /** 42 * i8159_set_poll() - Override the i8259 polling function 43 * @poll: pointer to platform-specific polling function 44 * 45 * Call this to override the generic i8259 polling function, which directly 46 * accesses i8259 registers, with a platform specific one which may be faster 47 * in cases where hardware provides a more optimal means of polling for an 48 * interrupt. 49 */ 50 extern void i8259_set_poll(int (*poll)(void)); 51 52 /* 53 * Do the traditional i8259 interrupt polling thing. This is for the few 54 * cases where no better interrupt acknowledge method is available and we 55 * absolutely must touch the i8259. 56 */ 57 static inline int i8259_irq(void) 58 { 59 int irq; 60 61 raw_spin_lock(&i8259A_lock); 62 63 /* Perform an interrupt acknowledge cycle on controller 1. */ 64 outb(0x0C, PIC_MASTER_CMD); /* prepare for poll */ 65 irq = inb(PIC_MASTER_CMD) & 7; 66 if (irq == PIC_CASCADE_IR) { 67 /* 68 * Interrupt is cascaded so perform interrupt 69 * acknowledge on controller 2. 70 */ 71 outb(0x0C, PIC_SLAVE_CMD); /* prepare for poll */ 72 irq = (inb(PIC_SLAVE_CMD) & 7) + 8; 73 } 74 75 if (unlikely(irq == 7)) { 76 /* 77 * This may be a spurious interrupt. 78 * 79 * Read the interrupt status register (ISR). If the most 80 * significant bit is not set then there is no valid 81 * interrupt. 82 */ 83 outb(0x0B, PIC_MASTER_ISR); /* ISR register */ 84 if(~inb(PIC_MASTER_ISR) & 0x80) 85 irq = -1; 86 } 87 88 raw_spin_unlock(&i8259A_lock); 89 90 return likely(irq >= 0) ? irq + I8259A_IRQ_BASE : irq; 91 } 92 93 #endif /* _ASM_I8259_H */ 94