include/hw/irq.h

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