include/hw/irq.h

   1 #ifndef QEMU_IRQ_H
   2 #define QEMU_IRQ_H
   3
   4 #include "qom/object.h"
   5
   6 /* Generic IRQ/GPIO pin infrastructure.  */
   7
   8 #define TYPE_IRQ "irq"
   9 OBJECT_DECLARE_SIMPLE_TYPE(IRQState, IRQ)
  10
  11 struct IRQState {
  12     Object parent_obj;
  13
  14     qemu_irq_handler handler;
  15     void *opaque;
  16     int n;
  17 };
  18
  19 void qemu_set_irq(qemu_irq irq, int level);
  20
  21 static inline void qemu_irq_raise(qemu_irq irq)
  22 {
  23     qemu_set_irq(irq, 1);
  24 }
  25
  26 static inline void qemu_irq_lower(qemu_irq irq)
  27 {
  28     qemu_set_irq(irq, 0);
  29 }
  30
  31 static inline void qemu_irq_pulse(qemu_irq irq)
  32 {
  33     qemu_set_irq(irq, 1);
  34     qemu_set_irq(irq, 0);
  35 }
  36
  37 /*
  38  * Init a single IRQ. The irq is assigned with a handler, an opaque data
  39  * and the interrupt number.
  40  */
  41 void qemu_init_irq(IRQState *irq, qemu_irq_handler handler, void *opaque,
  42                    int n);
  43
  44 /* Returns an array of N IRQs. Each IRQ is assigned the argument handler and
  45  * opaque data.
  46  */
  47 qemu_irq *qemu_allocate_irqs(qemu_irq_handler handler, void *opaque, int n);
  48
  49 /*
  50  * Allocates a single IRQ. The irq is assigned with a handler, an opaque
  51  * data and the interrupt number.
  52  */
  53 qemu_irq qemu_allocate_irq(qemu_irq_handler handler, void *opaque, int n);
  54
  55 /* Extends an Array of IRQs. Old IRQs have their handlers and opaque data
  56  * preserved. New IRQs are assigned the argument handler and opaque data.
  57  */
  58 qemu_irq *qemu_extend_irqs(qemu_irq *old, int n_old, qemu_irq_handler handler,
  59                                 void *opaque, int n);
  60
  61 void qemu_free_irqs(qemu_irq *s, int n);
  62 void qemu_free_irq(qemu_irq irq);
  63
  64 /* Returns a new IRQ with opposite polarity.  */
  65 qemu_irq qemu_irq_invert(qemu_irq irq);
  66
  67 /* For internal use in qtest.  Similar to qemu_irq_split, but operating
  68    on an existing vector of qemu_irq.  */
  69 void qemu_irq_intercept_in(qemu_irq *gpio_in, qemu_irq_handler handler, int n);
  70
  71 /**
  72  * qemu_irq_is_connected: Return true if IRQ line is wired up
  73  *
  74  * If a qemu_irq has a device on the other (receiving) end of it,
  75  * return true; otherwise return false.
  76  *
  77  * Usually device models don't need to care whether the machine model
  78  * has wired up their outbound qemu_irq lines, because functions like
  79  * qemu_set_irq() silently do nothing if there is nothing on the other
  80  * end of the line. However occasionally a device model will want to
  81  * provide default behaviour if its output is left floating, and
  82  * it can use this function to identify when that is the case.
  83  */
  84 static inline bool qemu_irq_is_connected(qemu_irq irq)
  85 {
  86     return irq != NULL;
  87 }
  88
  89 #endif