1495e0022SThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */ 29a489f45SDavid Vrabel /* 39a489f45SDavid Vrabel * Xen Event Channels (internal header) 49a489f45SDavid Vrabel * 59a489f45SDavid Vrabel * Copyright (C) 2013 Citrix Systems R&D Ltd. 69a489f45SDavid Vrabel */ 79a489f45SDavid Vrabel #ifndef __EVENTS_INTERNAL_H__ 89a489f45SDavid Vrabel #define __EVENTS_INTERNAL_H__ 99a489f45SDavid Vrabel 109a489f45SDavid Vrabel /* Interrupt types. */ 119a489f45SDavid Vrabel enum xen_irq_type { 129a489f45SDavid Vrabel IRQT_UNBOUND = 0, 139a489f45SDavid Vrabel IRQT_PIRQ, 149a489f45SDavid Vrabel IRQT_VIRQ, 159a489f45SDavid Vrabel IRQT_IPI, 169a489f45SDavid Vrabel IRQT_EVTCHN 179a489f45SDavid Vrabel }; 189a489f45SDavid Vrabel 199a489f45SDavid Vrabel /* 209a489f45SDavid Vrabel * Packed IRQ information: 219a489f45SDavid Vrabel * type - enum xen_irq_type 229a489f45SDavid Vrabel * event channel - irq->event channel mapping 239a489f45SDavid Vrabel * cpu - cpu this event channel is bound to 249a489f45SDavid Vrabel * index - type-specific information: 259a489f45SDavid Vrabel * PIRQ - vector, with MSB being "needs EIO", or physical IRQ of the HVM 269a489f45SDavid Vrabel * guest, or GSI (real passthrough IRQ) of the device. 279a489f45SDavid Vrabel * VIRQ - virq number 289a489f45SDavid Vrabel * IPI - IPI vector 299a489f45SDavid Vrabel * EVTCHN - 309a489f45SDavid Vrabel */ 319a489f45SDavid Vrabel struct irq_info { 329a489f45SDavid Vrabel struct list_head list; 339a489f45SDavid Vrabel int refcnt; 349a489f45SDavid Vrabel enum xen_irq_type type; /* type */ 359a489f45SDavid Vrabel unsigned irq; 360102e4efSYan Yankovskyi evtchn_port_t evtchn; /* event channel */ 379a489f45SDavid Vrabel unsigned short cpu; /* cpu bound */ 389a489f45SDavid Vrabel 399a489f45SDavid Vrabel union { 409a489f45SDavid Vrabel unsigned short virq; 419a489f45SDavid Vrabel enum ipi_vector ipi; 429a489f45SDavid Vrabel struct { 439a489f45SDavid Vrabel unsigned short pirq; 449a489f45SDavid Vrabel unsigned short gsi; 459a489f45SDavid Vrabel unsigned char vector; 469a489f45SDavid Vrabel unsigned char flags; 479a489f45SDavid Vrabel uint16_t domid; 489a489f45SDavid Vrabel } pirq; 499a489f45SDavid Vrabel } u; 509a489f45SDavid Vrabel }; 519a489f45SDavid Vrabel 529a489f45SDavid Vrabel #define PIRQ_NEEDS_EOI (1 << 0) 539a489f45SDavid Vrabel #define PIRQ_SHAREABLE (1 << 1) 544892c9b4SRoger Pau Monne #define PIRQ_MSI_GROUP (1 << 2) 559a489f45SDavid Vrabel 56ab9a1ccaSDavid Vrabel struct evtchn_ops { 57d0b075ffSDavid Vrabel unsigned (*max_channels)(void); 58d0b075ffSDavid Vrabel unsigned (*nr_channels)(void); 59d0b075ffSDavid Vrabel 6008385875SDavid Vrabel int (*setup)(struct irq_info *info); 61ab9a1ccaSDavid Vrabel void (*bind_to_cpu)(struct irq_info *info, unsigned cpu); 62ab9a1ccaSDavid Vrabel 630102e4efSYan Yankovskyi void (*clear_pending)(evtchn_port_t port); 640102e4efSYan Yankovskyi void (*set_pending)(evtchn_port_t port); 650102e4efSYan Yankovskyi bool (*is_pending)(evtchn_port_t port); 660102e4efSYan Yankovskyi bool (*test_and_set_mask)(evtchn_port_t port); 670102e4efSYan Yankovskyi void (*mask)(evtchn_port_t port); 680102e4efSYan Yankovskyi void (*unmask)(evtchn_port_t port); 69ab9a1ccaSDavid Vrabel 70ab9a1ccaSDavid Vrabel void (*handle_events)(unsigned cpu); 711fe56551SDavid Vrabel void (*resume)(void); 72*7beb290cSJuergen Gross 73*7beb290cSJuergen Gross int (*percpu_init)(unsigned int cpu); 74*7beb290cSJuergen Gross int (*percpu_deinit)(unsigned int cpu); 75ab9a1ccaSDavid Vrabel }; 76ab9a1ccaSDavid Vrabel 77ab9a1ccaSDavid Vrabel extern const struct evtchn_ops *evtchn_ops; 78ab9a1ccaSDavid Vrabel 79d0b075ffSDavid Vrabel extern int **evtchn_to_irq; 800102e4efSYan Yankovskyi int get_evtchn_to_irq(evtchn_port_t evtchn); 819a489f45SDavid Vrabel 829a489f45SDavid Vrabel struct irq_info *info_for_irq(unsigned irq); 839a489f45SDavid Vrabel unsigned cpu_from_irq(unsigned irq); 840102e4efSYan Yankovskyi unsigned int cpu_from_evtchn(evtchn_port_t evtchn); 859a489f45SDavid Vrabel 86d0b075ffSDavid Vrabel static inline unsigned xen_evtchn_max_channels(void) 87d0b075ffSDavid Vrabel { 88d0b075ffSDavid Vrabel return evtchn_ops->max_channels(); 89d0b075ffSDavid Vrabel } 90d0b075ffSDavid Vrabel 9108385875SDavid Vrabel /* 9208385875SDavid Vrabel * Do any ABI specific setup for a bound event channel before it can 9308385875SDavid Vrabel * be unmasked and used. 9408385875SDavid Vrabel */ 9508385875SDavid Vrabel static inline int xen_evtchn_port_setup(struct irq_info *info) 9608385875SDavid Vrabel { 9708385875SDavid Vrabel if (evtchn_ops->setup) 9808385875SDavid Vrabel return evtchn_ops->setup(info); 9908385875SDavid Vrabel return 0; 10008385875SDavid Vrabel } 10108385875SDavid Vrabel 102ab9a1ccaSDavid Vrabel static inline void xen_evtchn_port_bind_to_cpu(struct irq_info *info, 103ab9a1ccaSDavid Vrabel unsigned cpu) 104ab9a1ccaSDavid Vrabel { 105ab9a1ccaSDavid Vrabel evtchn_ops->bind_to_cpu(info, cpu); 106ab9a1ccaSDavid Vrabel } 1079a489f45SDavid Vrabel 1080102e4efSYan Yankovskyi static inline void clear_evtchn(evtchn_port_t port) 109ab9a1ccaSDavid Vrabel { 110ab9a1ccaSDavid Vrabel evtchn_ops->clear_pending(port); 111ab9a1ccaSDavid Vrabel } 1129a489f45SDavid Vrabel 1130102e4efSYan Yankovskyi static inline void set_evtchn(evtchn_port_t port) 114ab9a1ccaSDavid Vrabel { 115ab9a1ccaSDavid Vrabel evtchn_ops->set_pending(port); 116ab9a1ccaSDavid Vrabel } 117ab9a1ccaSDavid Vrabel 1180102e4efSYan Yankovskyi static inline bool test_evtchn(evtchn_port_t port) 119ab9a1ccaSDavid Vrabel { 120ab9a1ccaSDavid Vrabel return evtchn_ops->is_pending(port); 121ab9a1ccaSDavid Vrabel } 122ab9a1ccaSDavid Vrabel 1230102e4efSYan Yankovskyi static inline bool test_and_set_mask(evtchn_port_t port) 124ab9a1ccaSDavid Vrabel { 125ab9a1ccaSDavid Vrabel return evtchn_ops->test_and_set_mask(port); 126ab9a1ccaSDavid Vrabel } 127ab9a1ccaSDavid Vrabel 1280102e4efSYan Yankovskyi static inline void mask_evtchn(evtchn_port_t port) 129ab9a1ccaSDavid Vrabel { 130ab9a1ccaSDavid Vrabel return evtchn_ops->mask(port); 131ab9a1ccaSDavid Vrabel } 132ab9a1ccaSDavid Vrabel 1330102e4efSYan Yankovskyi static inline void unmask_evtchn(evtchn_port_t port) 134ab9a1ccaSDavid Vrabel { 135ab9a1ccaSDavid Vrabel return evtchn_ops->unmask(port); 136ab9a1ccaSDavid Vrabel } 137ab9a1ccaSDavid Vrabel 138ab9a1ccaSDavid Vrabel static inline void xen_evtchn_handle_events(unsigned cpu) 139ab9a1ccaSDavid Vrabel { 140ab9a1ccaSDavid Vrabel return evtchn_ops->handle_events(cpu); 141ab9a1ccaSDavid Vrabel } 142ab9a1ccaSDavid Vrabel 1431fe56551SDavid Vrabel static inline void xen_evtchn_resume(void) 1441fe56551SDavid Vrabel { 1451fe56551SDavid Vrabel if (evtchn_ops->resume) 1461fe56551SDavid Vrabel evtchn_ops->resume(); 1471fe56551SDavid Vrabel } 1481fe56551SDavid Vrabel 149ab9a1ccaSDavid Vrabel void xen_evtchn_2l_init(void); 1501fe56551SDavid Vrabel int xen_evtchn_fifo_init(void); 1519a489f45SDavid Vrabel 1529a489f45SDavid Vrabel #endif /* #ifndef __EVENTS_INTERNAL_H__ */ 153