19a489f45SDavid Vrabel /* 29a489f45SDavid Vrabel * Xen Event Channels (internal header) 39a489f45SDavid Vrabel * 49a489f45SDavid Vrabel * Copyright (C) 2013 Citrix Systems R&D Ltd. 59a489f45SDavid Vrabel * 69a489f45SDavid Vrabel * This source code is licensed under the GNU General Public License, 79a489f45SDavid Vrabel * Version 2 or later. See the file COPYING for more details. 89a489f45SDavid Vrabel */ 99a489f45SDavid Vrabel #ifndef __EVENTS_INTERNAL_H__ 109a489f45SDavid Vrabel #define __EVENTS_INTERNAL_H__ 119a489f45SDavid Vrabel 129a489f45SDavid Vrabel /* Interrupt types. */ 139a489f45SDavid Vrabel enum xen_irq_type { 149a489f45SDavid Vrabel IRQT_UNBOUND = 0, 159a489f45SDavid Vrabel IRQT_PIRQ, 169a489f45SDavid Vrabel IRQT_VIRQ, 179a489f45SDavid Vrabel IRQT_IPI, 189a489f45SDavid Vrabel IRQT_EVTCHN 199a489f45SDavid Vrabel }; 209a489f45SDavid Vrabel 219a489f45SDavid Vrabel /* 229a489f45SDavid Vrabel * Packed IRQ information: 239a489f45SDavid Vrabel * type - enum xen_irq_type 249a489f45SDavid Vrabel * event channel - irq->event channel mapping 259a489f45SDavid Vrabel * cpu - cpu this event channel is bound to 269a489f45SDavid Vrabel * index - type-specific information: 279a489f45SDavid Vrabel * PIRQ - vector, with MSB being "needs EIO", or physical IRQ of the HVM 289a489f45SDavid Vrabel * guest, or GSI (real passthrough IRQ) of the device. 299a489f45SDavid Vrabel * VIRQ - virq number 309a489f45SDavid Vrabel * IPI - IPI vector 319a489f45SDavid Vrabel * EVTCHN - 329a489f45SDavid Vrabel */ 339a489f45SDavid Vrabel struct irq_info { 349a489f45SDavid Vrabel struct list_head list; 359a489f45SDavid Vrabel int refcnt; 369a489f45SDavid Vrabel enum xen_irq_type type; /* type */ 379a489f45SDavid Vrabel unsigned irq; 38*d0b075ffSDavid Vrabel unsigned int evtchn; /* event channel */ 399a489f45SDavid Vrabel unsigned short cpu; /* cpu bound */ 409a489f45SDavid Vrabel 419a489f45SDavid Vrabel union { 429a489f45SDavid Vrabel unsigned short virq; 439a489f45SDavid Vrabel enum ipi_vector ipi; 449a489f45SDavid Vrabel struct { 459a489f45SDavid Vrabel unsigned short pirq; 469a489f45SDavid Vrabel unsigned short gsi; 479a489f45SDavid Vrabel unsigned char vector; 489a489f45SDavid Vrabel unsigned char flags; 499a489f45SDavid Vrabel uint16_t domid; 509a489f45SDavid Vrabel } pirq; 519a489f45SDavid Vrabel } u; 529a489f45SDavid Vrabel }; 539a489f45SDavid Vrabel 549a489f45SDavid Vrabel #define PIRQ_NEEDS_EOI (1 << 0) 559a489f45SDavid Vrabel #define PIRQ_SHAREABLE (1 << 1) 569a489f45SDavid Vrabel 57ab9a1ccaSDavid Vrabel struct evtchn_ops { 58*d0b075ffSDavid Vrabel unsigned (*max_channels)(void); 59*d0b075ffSDavid Vrabel unsigned (*nr_channels)(void); 60*d0b075ffSDavid Vrabel 6108385875SDavid Vrabel int (*setup)(struct irq_info *info); 62ab9a1ccaSDavid Vrabel void (*bind_to_cpu)(struct irq_info *info, unsigned cpu); 63ab9a1ccaSDavid Vrabel 64ab9a1ccaSDavid Vrabel void (*clear_pending)(unsigned port); 65ab9a1ccaSDavid Vrabel void (*set_pending)(unsigned port); 66ab9a1ccaSDavid Vrabel bool (*is_pending)(unsigned port); 67ab9a1ccaSDavid Vrabel bool (*test_and_set_mask)(unsigned port); 68ab9a1ccaSDavid Vrabel void (*mask)(unsigned port); 69ab9a1ccaSDavid Vrabel void (*unmask)(unsigned port); 70ab9a1ccaSDavid Vrabel 71ab9a1ccaSDavid Vrabel void (*handle_events)(unsigned cpu); 72ab9a1ccaSDavid Vrabel }; 73ab9a1ccaSDavid Vrabel 74ab9a1ccaSDavid Vrabel extern const struct evtchn_ops *evtchn_ops; 75ab9a1ccaSDavid Vrabel 76*d0b075ffSDavid Vrabel extern int **evtchn_to_irq; 77*d0b075ffSDavid 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 83*d0b075ffSDavid Vrabel static inline unsigned xen_evtchn_max_channels(void) 84*d0b075ffSDavid Vrabel { 85*d0b075ffSDavid Vrabel return evtchn_ops->max_channels(); 86*d0b075ffSDavid Vrabel } 87*d0b075ffSDavid Vrabel 88*d0b075ffSDavid Vrabel static inline unsigned xen_evtchn_nr_channels(void) 89*d0b075ffSDavid Vrabel { 90*d0b075ffSDavid Vrabel return evtchn_ops->nr_channels(); 91*d0b075ffSDavid Vrabel } 92*d0b075ffSDavid Vrabel 9308385875SDavid Vrabel /* 9408385875SDavid Vrabel * Do any ABI specific setup for a bound event channel before it can 9508385875SDavid Vrabel * be unmasked and used. 9608385875SDavid Vrabel */ 9708385875SDavid Vrabel static inline int xen_evtchn_port_setup(struct irq_info *info) 9808385875SDavid Vrabel { 9908385875SDavid Vrabel if (evtchn_ops->setup) 10008385875SDavid Vrabel return evtchn_ops->setup(info); 10108385875SDavid Vrabel return 0; 10208385875SDavid Vrabel } 10308385875SDavid Vrabel 104ab9a1ccaSDavid Vrabel static inline void xen_evtchn_port_bind_to_cpu(struct irq_info *info, 105ab9a1ccaSDavid Vrabel unsigned cpu) 106ab9a1ccaSDavid Vrabel { 107ab9a1ccaSDavid Vrabel evtchn_ops->bind_to_cpu(info, cpu); 108ab9a1ccaSDavid Vrabel } 1099a489f45SDavid Vrabel 110ab9a1ccaSDavid Vrabel static inline void clear_evtchn(unsigned port) 111ab9a1ccaSDavid Vrabel { 112ab9a1ccaSDavid Vrabel evtchn_ops->clear_pending(port); 113ab9a1ccaSDavid Vrabel } 1149a489f45SDavid Vrabel 115ab9a1ccaSDavid Vrabel static inline void set_evtchn(unsigned port) 116ab9a1ccaSDavid Vrabel { 117ab9a1ccaSDavid Vrabel evtchn_ops->set_pending(port); 118ab9a1ccaSDavid Vrabel } 119ab9a1ccaSDavid Vrabel 120ab9a1ccaSDavid Vrabel static inline bool test_evtchn(unsigned port) 121ab9a1ccaSDavid Vrabel { 122ab9a1ccaSDavid Vrabel return evtchn_ops->is_pending(port); 123ab9a1ccaSDavid Vrabel } 124ab9a1ccaSDavid Vrabel 125ab9a1ccaSDavid Vrabel static inline bool test_and_set_mask(unsigned port) 126ab9a1ccaSDavid Vrabel { 127ab9a1ccaSDavid Vrabel return evtchn_ops->test_and_set_mask(port); 128ab9a1ccaSDavid Vrabel } 129ab9a1ccaSDavid Vrabel 130ab9a1ccaSDavid Vrabel static inline void mask_evtchn(unsigned port) 131ab9a1ccaSDavid Vrabel { 132ab9a1ccaSDavid Vrabel return evtchn_ops->mask(port); 133ab9a1ccaSDavid Vrabel } 134ab9a1ccaSDavid Vrabel 135ab9a1ccaSDavid Vrabel static inline void unmask_evtchn(unsigned port) 136ab9a1ccaSDavid Vrabel { 137ab9a1ccaSDavid Vrabel return evtchn_ops->unmask(port); 138ab9a1ccaSDavid Vrabel } 139ab9a1ccaSDavid Vrabel 140ab9a1ccaSDavid Vrabel static inline void xen_evtchn_handle_events(unsigned cpu) 141ab9a1ccaSDavid Vrabel { 142ab9a1ccaSDavid Vrabel return evtchn_ops->handle_events(cpu); 143ab9a1ccaSDavid Vrabel } 144ab9a1ccaSDavid Vrabel 145ab9a1ccaSDavid Vrabel void xen_evtchn_2l_init(void); 1469a489f45SDavid Vrabel 1479a489f45SDavid Vrabel #endif /* #ifndef __EVENTS_INTERNAL_H__ */ 148