1*495e0022SThomas 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; 36d0b075ffSDavid Vrabel unsigned int 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 63ab9a1ccaSDavid Vrabel void (*clear_pending)(unsigned port); 64ab9a1ccaSDavid Vrabel void (*set_pending)(unsigned port); 65ab9a1ccaSDavid Vrabel bool (*is_pending)(unsigned port); 66ab9a1ccaSDavid Vrabel bool (*test_and_set_mask)(unsigned port); 67ab9a1ccaSDavid Vrabel void (*mask)(unsigned port); 68ab9a1ccaSDavid Vrabel void (*unmask)(unsigned port); 69ab9a1ccaSDavid Vrabel 70ab9a1ccaSDavid Vrabel void (*handle_events)(unsigned cpu); 711fe56551SDavid Vrabel void (*resume)(void); 72ab9a1ccaSDavid Vrabel }; 73ab9a1ccaSDavid Vrabel 74ab9a1ccaSDavid Vrabel extern const struct evtchn_ops *evtchn_ops; 75ab9a1ccaSDavid Vrabel 76d0b075ffSDavid Vrabel extern int **evtchn_to_irq; 77d0b075ffSDavid Vrabel int get_evtchn_to_irq(unsigned int evtchn); 789a489f45SDavid Vrabel 799a489f45SDavid Vrabel struct irq_info *info_for_irq(unsigned irq); 809a489f45SDavid Vrabel unsigned cpu_from_irq(unsigned irq); 819a489f45SDavid Vrabel unsigned cpu_from_evtchn(unsigned int evtchn); 829a489f45SDavid Vrabel 83d0b075ffSDavid Vrabel static inline unsigned xen_evtchn_max_channels(void) 84d0b075ffSDavid Vrabel { 85d0b075ffSDavid Vrabel return evtchn_ops->max_channels(); 86d0b075ffSDavid Vrabel } 87d0b075ffSDavid Vrabel 8808385875SDavid Vrabel /* 8908385875SDavid Vrabel * Do any ABI specific setup for a bound event channel before it can 9008385875SDavid Vrabel * be unmasked and used. 9108385875SDavid Vrabel */ 9208385875SDavid Vrabel static inline int xen_evtchn_port_setup(struct irq_info *info) 9308385875SDavid Vrabel { 9408385875SDavid Vrabel if (evtchn_ops->setup) 9508385875SDavid Vrabel return evtchn_ops->setup(info); 9608385875SDavid Vrabel return 0; 9708385875SDavid Vrabel } 9808385875SDavid Vrabel 99ab9a1ccaSDavid Vrabel static inline void xen_evtchn_port_bind_to_cpu(struct irq_info *info, 100ab9a1ccaSDavid Vrabel unsigned cpu) 101ab9a1ccaSDavid Vrabel { 102ab9a1ccaSDavid Vrabel evtchn_ops->bind_to_cpu(info, cpu); 103ab9a1ccaSDavid Vrabel } 1049a489f45SDavid Vrabel 105ab9a1ccaSDavid Vrabel static inline void clear_evtchn(unsigned port) 106ab9a1ccaSDavid Vrabel { 107ab9a1ccaSDavid Vrabel evtchn_ops->clear_pending(port); 108ab9a1ccaSDavid Vrabel } 1099a489f45SDavid Vrabel 110ab9a1ccaSDavid Vrabel static inline void set_evtchn(unsigned port) 111ab9a1ccaSDavid Vrabel { 112ab9a1ccaSDavid Vrabel evtchn_ops->set_pending(port); 113ab9a1ccaSDavid Vrabel } 114ab9a1ccaSDavid Vrabel 115ab9a1ccaSDavid Vrabel static inline bool test_evtchn(unsigned port) 116ab9a1ccaSDavid Vrabel { 117ab9a1ccaSDavid Vrabel return evtchn_ops->is_pending(port); 118ab9a1ccaSDavid Vrabel } 119ab9a1ccaSDavid Vrabel 120ab9a1ccaSDavid Vrabel static inline bool test_and_set_mask(unsigned port) 121ab9a1ccaSDavid Vrabel { 122ab9a1ccaSDavid Vrabel return evtchn_ops->test_and_set_mask(port); 123ab9a1ccaSDavid Vrabel } 124ab9a1ccaSDavid Vrabel 125ab9a1ccaSDavid Vrabel static inline void mask_evtchn(unsigned port) 126ab9a1ccaSDavid Vrabel { 127ab9a1ccaSDavid Vrabel return evtchn_ops->mask(port); 128ab9a1ccaSDavid Vrabel } 129ab9a1ccaSDavid Vrabel 130ab9a1ccaSDavid Vrabel static inline void unmask_evtchn(unsigned port) 131ab9a1ccaSDavid Vrabel { 132ab9a1ccaSDavid Vrabel return evtchn_ops->unmask(port); 133ab9a1ccaSDavid Vrabel } 134ab9a1ccaSDavid Vrabel 135ab9a1ccaSDavid Vrabel static inline void xen_evtchn_handle_events(unsigned cpu) 136ab9a1ccaSDavid Vrabel { 137ab9a1ccaSDavid Vrabel return evtchn_ops->handle_events(cpu); 138ab9a1ccaSDavid Vrabel } 139ab9a1ccaSDavid Vrabel 1401fe56551SDavid Vrabel static inline void xen_evtchn_resume(void) 1411fe56551SDavid Vrabel { 1421fe56551SDavid Vrabel if (evtchn_ops->resume) 1431fe56551SDavid Vrabel evtchn_ops->resume(); 1441fe56551SDavid Vrabel } 1451fe56551SDavid Vrabel 146ab9a1ccaSDavid Vrabel void xen_evtchn_2l_init(void); 1471fe56551SDavid Vrabel int xen_evtchn_fifo_init(void); 1489a489f45SDavid Vrabel 1499a489f45SDavid Vrabel #endif /* #ifndef __EVENTS_INTERNAL_H__ */ 150