src/arch/i386/include/pic8259.h

   1 /*
   2  * Basic support for controlling the 8259 Programmable Interrupt Controllers.
   3  *
   4  * Initially written by Michael Brown (mcb30).
   5  */
   6
   7 #ifndef PIC8259_H
   8 #define PIC8259_H
   9
  10 /* For segoff_t */
  11 #include "realmode.h"
  12
  13 #define IRQ_PIC_CUTOFF 8
  14
  15 /* 8259 register locations */
  16 #define PIC1_ICW1 0x20
  17 #define PIC1_OCW2 0x20
  18 #define PIC1_OCW3 0x20
  19 #define PIC1_ICR 0x20
  20 #define PIC1_IRR 0x20
  21 #define PIC1_ISR 0x20
  22 #define PIC1_ICW2 0x21
  23 #define PIC1_ICW3 0x21
  24 #define PIC1_ICW4 0x21
  25 #define PIC1_IMR 0x21
  26 #define PIC2_ICW1 0xa0
  27 #define PIC2_OCW2 0xa0
  28 #define PIC2_OCW3 0xa0
  29 #define PIC2_ICR 0xa0
  30 #define PIC2_IRR 0xa0
  31 #define PIC2_ISR 0xa0
  32 #define PIC2_ICW2 0xa1
  33 #define PIC2_ICW3 0xa1
  34 #define PIC2_ICW4 0xa1
  35 #define PIC2_IMR 0xa1
  36
  37 /* Register command values */
  38 #define OCW3_ID 0x08
  39 #define OCW3_READ_IRR 0x03
  40 #define OCW3_READ_ISR 0x02
  41 #define ICR_EOI_NON_SPECIFIC 0x20
  42 #define ICR_EOI_NOP 0x40
  43 #define ICR_EOI_SPECIFIC 0x60
  44 #define ICR_EOI_SET_PRIORITY 0xc0
  45
  46 /* Macros to enable/disable IRQs */
  47 #define IMR_REG(x) ( (x) < IRQ_PIC_CUTOFF ? PIC1_IMR : PIC2_IMR )
  48 #define IMR_BIT(x) ( 1 << ( (x) % IRQ_PIC_CUTOFF ) )
  49 #define irq_enabled(x) ( ( inb ( IMR_REG(x) ) & IMR_BIT(x) ) == 0 )
  50 #define enable_irq(x) outb ( inb( IMR_REG(x) ) & ~IMR_BIT(x), IMR_REG(x) )
  51 #define disable_irq(x) outb ( inb( IMR_REG(x) ) | IMR_BIT(x), IMR_REG(x) )
  52
  53 /* Macros for acknowledging IRQs */
  54 #define ICR_REG( irq ) ( (irq) < IRQ_PIC_CUTOFF ? PIC1_ICR : PIC2_ICR )
  55 #define ICR_VALUE( irq ) ( (irq) % IRQ_PIC_CUTOFF )
  56 #define CHAINED_IRQ 2
  57
  58 /* Utility macros to convert IRQ numbers to INT numbers and INT vectors  */
  59 #define IRQ_INT( irq ) ( ( ( (irq) - IRQ_PIC_CUTOFF ) ^ 0x70 ) & 0x7f )
  60
  61 /* Other constants */
  62 #define IRQ_MAX 15
  63 #define IRQ_NONE -1U
  64
  65 /* Function prototypes
  66  */
  67 void send_eoi ( unsigned int irq );
  68
  69 #endif /* PIC8259_H */