blob: 1cbb7413c121f12b9d31ddd652110cf372927e67 [file] [log] [blame]
Grant Likely08a543a2011-07-26 03:19:06 -06001/*
2 * irq_domain - IRQ translation domains
3 *
4 * Translation infrastructure between hw and linux irq numbers. This is
5 * helpful for interrupt controllers to implement mapping between hardware
6 * irq numbers and the Linux irq number space.
7 *
8 * irq_domains also have a hook for translating device tree interrupt
9 * representation into a hardware irq number that can be mapped back to a
10 * Linux irq number without any extra platform support code.
11 *
Grant Likely7bb69ba2012-02-14 14:06:48 -070012 * Interrupt controller "domain" data structure. This could be defined as a
13 * irq domain controller. That is, it handles the mapping between hardware
14 * and virtual interrupt numbers for a given interrupt domain. The domain
15 * structure is generally created by the PIC code for a given PIC instance
16 * (though a domain can cover more than one PIC if they have a flat number
17 * model). It's the domain callbacks that are responsible for setting the
18 * irq_chip on a given irq_desc after it's been mapped.
Grant Likelycc79ca62012-02-16 01:37:49 -070019 *
20 * The host code and data structures are agnostic to whether or not
21 * we use an open firmware device-tree. We do have references to struct
22 * device_node in two places: in irq_find_host() to find the host matching
23 * a given interrupt controller node, and of course as an argument to its
24 * counterpart domain->ops->match() callback. However, those are treated as
25 * generic pointers by the core and the fact that it's actually a device-node
26 * pointer is purely a convention between callers and implementation. This
27 * code could thus be used on other architectures by replacing those two
28 * by some sort of arch-specific void * "token" used to identify interrupt
29 * controllers.
Grant Likely08a543a2011-07-26 03:19:06 -060030 */
Grant Likely7bb69ba2012-02-14 14:06:48 -070031
Grant Likely08a543a2011-07-26 03:19:06 -060032#ifndef _LINUX_IRQDOMAIN_H
33#define _LINUX_IRQDOMAIN_H
34
Grant Likely7bb69ba2012-02-14 14:06:48 -070035#include <linux/types.h>
36#include <linux/radix-tree.h>
Grant Likely08a543a2011-07-26 03:19:06 -060037
Grant Likely08a543a2011-07-26 03:19:06 -060038struct device_node;
39struct irq_domain;
Grant Likely7bb69ba2012-02-14 14:06:48 -070040struct of_device_id;
41
Grant Likely1bc04f22012-02-14 14:06:55 -070042/* Number of irqs reserved for a legacy isa controller */
43#define NUM_ISA_INTERRUPTS 16
44
Grant Likely08a543a2011-07-26 03:19:06 -060045/**
46 * struct irq_domain_ops - Methods for irq_domain objects
Grant Likely7bb69ba2012-02-14 14:06:48 -070047 * @match: Match an interrupt controller device node to a host, returns
48 * 1 on a match
49 * @map: Create or update a mapping between a virtual irq number and a hw
50 * irq number. This is called only once for a given mapping.
51 * @unmap: Dispose of such a mapping
Grant Likely7bb69ba2012-02-14 14:06:48 -070052 * @xlate: Given a device tree node and interrupt specifier, decode
53 * the hardware irq number and linux irq type value.
54 *
55 * Functions below are provided by the driver and called whenever a new mapping
56 * is created or an old mapping is disposed. The driver can then proceed to
57 * whatever internal data structures management is required. It also needs
58 * to setup the irq_desc when returning from map().
Grant Likely08a543a2011-07-26 03:19:06 -060059 */
60struct irq_domain_ops {
Grant Likely7bb69ba2012-02-14 14:06:48 -070061 int (*match)(struct irq_domain *d, struct device_node *node);
62 int (*map)(struct irq_domain *d, unsigned int virq, irq_hw_number_t hw);
63 void (*unmap)(struct irq_domain *d, unsigned int virq);
Grant Likely7bb69ba2012-02-14 14:06:48 -070064 int (*xlate)(struct irq_domain *d, struct device_node *node,
65 const u32 *intspec, unsigned int intsize,
66 unsigned long *out_hwirq, unsigned int *out_type);
Grant Likely08a543a2011-07-26 03:19:06 -060067};
68
Thomas Gleixner088f40b2013-05-06 14:30:27 +000069extern struct irq_domain_ops irq_generic_chip_ops;
70
71struct irq_domain_chip_generic;
72
Grant Likely08a543a2011-07-26 03:19:06 -060073/**
74 * struct irq_domain - Hardware interrupt number translation object
Grant Likely7bb69ba2012-02-14 14:06:48 -070075 * @link: Element in global irq_domain list.
76 * @revmap_type: Method used for reverse mapping hwirq numbers to linux irq. This
77 * will be one of the IRQ_DOMAIN_MAP_* values.
Grant Likely7bb69ba2012-02-14 14:06:48 -070078 * @ops: pointer to irq_domain methods
79 * @host_data: private data pointer for use by owner. Not touched by irq_domain
80 * core code.
Grant Likely08a543a2011-07-26 03:19:06 -060081 * @irq_base: Start of irq_desc range assigned to the irq_domain. The creator
82 * of the irq_domain is responsible for allocating the array of
83 * irq_desc structures.
84 * @nr_irq: Number of irqs managed by the irq domain
Rob Herring6d274302011-09-30 10:48:38 -050085 * @hwirq_base: Starting number for hwirqs managed by the irq domain
Grant Likely08a543a2011-07-26 03:19:06 -060086 * @of_node: (optional) Pointer to device tree nodes associated with the
87 * irq_domain. Used when decoding device tree interrupt specifiers.
88 */
89struct irq_domain {
Grant Likely7bb69ba2012-02-14 14:06:48 -070090 struct list_head link;
Grant Likely0bb4afb2013-06-06 14:23:30 +010091 const char *name;
Grant Likely7bb69ba2012-02-14 14:06:48 -070092
93 /* type of reverse mapping_technique */
94 unsigned int revmap_type;
Grant Likelycef50752012-07-11 17:24:31 +010095 struct {
Grant Likely7bb69ba2012-02-14 14:06:48 -070096 struct {
97 unsigned int size;
Grant Likely7bb69ba2012-02-14 14:06:48 -070098 } linear;
Grant Likely6fa6c8e22012-02-15 15:06:08 -070099 struct {
100 unsigned int max_irq;
101 } nomap;
Grant Likely7bb69ba2012-02-14 14:06:48 -0700102 struct radix_tree_root tree;
103 } revmap_data;
Grant Likelya18dc812012-01-26 12:12:14 -0700104 const struct irq_domain_ops *ops;
Grant Likely7bb69ba2012-02-14 14:06:48 -0700105 void *host_data;
106 irq_hw_number_t inval_irq;
107
Grant Likely7bb69ba2012-02-14 14:06:48 -0700108 /* Optional device node pointer */
Grant Likely08a543a2011-07-26 03:19:06 -0600109 struct device_node *of_node;
Thomas Gleixner088f40b2013-05-06 14:30:27 +0000110 /* Optional pointer to generic interrupt chips */
111 struct irq_domain_chip_generic *gc;
Grant Likelycef50752012-07-11 17:24:31 +0100112
113 /* Linear reverse map */
114 unsigned int linear_revmap[];
Grant Likely08a543a2011-07-26 03:19:06 -0600115};
116
Thomas Gleixner088f40b2013-05-06 14:30:27 +0000117#define IRQ_DOMAIN_MAP_NOMAP 1 /* no fast reverse mapping */
118#define IRQ_DOMAIN_MAP_LINEAR 2 /* linear map of interrupts */
Thomas Gleixner088f40b2013-05-06 14:30:27 +0000119
Grant Likely7bb69ba2012-02-14 14:06:48 -0700120#ifdef CONFIG_IRQ_DOMAIN
Mark Brown781d0f42012-07-05 12:19:19 +0100121struct irq_domain *irq_domain_add_simple(struct device_node *of_node,
122 unsigned int size,
123 unsigned int first_irq,
124 const struct irq_domain_ops *ops,
125 void *host_data);
Grant Likelya8db8cf2012-02-14 14:06:54 -0700126struct irq_domain *irq_domain_add_legacy(struct device_node *of_node,
Grant Likely1bc04f22012-02-14 14:06:55 -0700127 unsigned int size,
128 unsigned int first_irq,
129 irq_hw_number_t first_hwirq,
Grant Likelya18dc812012-01-26 12:12:14 -0700130 const struct irq_domain_ops *ops,
Grant Likelya8db8cf2012-02-14 14:06:54 -0700131 void *host_data);
132struct irq_domain *irq_domain_add_linear(struct device_node *of_node,
133 unsigned int size,
Grant Likelya18dc812012-01-26 12:12:14 -0700134 const struct irq_domain_ops *ops,
Grant Likelya8db8cf2012-02-14 14:06:54 -0700135 void *host_data);
136struct irq_domain *irq_domain_add_nomap(struct device_node *of_node,
Grant Likely6fa6c8e22012-02-15 15:06:08 -0700137 unsigned int max_irq,
Grant Likelya18dc812012-01-26 12:12:14 -0700138 const struct irq_domain_ops *ops,
Grant Likelya8db8cf2012-02-14 14:06:54 -0700139 void *host_data);
Grant Likelycc79ca62012-02-16 01:37:49 -0700140extern struct irq_domain *irq_find_host(struct device_node *node);
141extern void irq_set_default_host(struct irq_domain *host);
Grant Likelycc79ca62012-02-16 01:37:49 -0700142
Grant Likely1bc04f22012-02-14 14:06:55 -0700143static inline struct irq_domain *irq_domain_add_legacy_isa(
144 struct device_node *of_node,
Grant Likelya18dc812012-01-26 12:12:14 -0700145 const struct irq_domain_ops *ops,
Grant Likely1bc04f22012-02-14 14:06:55 -0700146 void *host_data)
147{
148 return irq_domain_add_legacy(of_node, NUM_ISA_INTERRUPTS, 0, 0, ops,
149 host_data);
150}
Grant Likelycef50752012-07-11 17:24:31 +0100151static inline struct irq_domain *irq_domain_add_tree(struct device_node *of_node,
152 const struct irq_domain_ops *ops,
153 void *host_data)
154{
155 return irq_domain_add_linear(of_node, 0, ops, host_data);
156}
Paul Mundt58ee99a2012-05-19 15:11:41 +0900157
158extern void irq_domain_remove(struct irq_domain *host);
159
Grant Likely98aa4682012-06-17 16:17:04 -0600160extern int irq_domain_associate_many(struct irq_domain *domain,
161 unsigned int irq_base,
162 irq_hw_number_t hwirq_base, int count);
163static inline int irq_domain_associate(struct irq_domain *domain, unsigned int irq,
164 irq_hw_number_t hwirq)
165{
166 return irq_domain_associate_many(domain, irq, hwirq, 1);
167}
168
Grant Likelycc79ca62012-02-16 01:37:49 -0700169extern unsigned int irq_create_mapping(struct irq_domain *host,
170 irq_hw_number_t hwirq);
171extern void irq_dispose_mapping(unsigned int virq);
172extern unsigned int irq_find_mapping(struct irq_domain *host,
173 irq_hw_number_t hwirq);
174extern unsigned int irq_create_direct_mapping(struct irq_domain *host);
Grant Likely98aa4682012-06-17 16:17:04 -0600175extern int irq_create_strict_mappings(struct irq_domain *domain,
176 unsigned int irq_base,
177 irq_hw_number_t hwirq_base, int count);
178
179static inline int irq_create_identity_mapping(struct irq_domain *host,
180 irq_hw_number_t hwirq)
181{
182 return irq_create_strict_mappings(host, hwirq, hwirq, 1);
183}
184
Grant Likelycc79ca62012-02-16 01:37:49 -0700185extern unsigned int irq_linear_revmap(struct irq_domain *host,
186 irq_hw_number_t hwirq);
187
Grant Likelya18dc812012-01-26 12:12:14 -0700188extern const struct irq_domain_ops irq_domain_simple_ops;
Grant Likely16b2e6e2012-01-26 11:26:52 -0700189
190/* stock xlate functions */
191int irq_domain_xlate_onecell(struct irq_domain *d, struct device_node *ctrlr,
192 const u32 *intspec, unsigned int intsize,
193 irq_hw_number_t *out_hwirq, unsigned int *out_type);
194int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
195 const u32 *intspec, unsigned int intsize,
196 irq_hw_number_t *out_hwirq, unsigned int *out_type);
197int irq_domain_xlate_onetwocell(struct irq_domain *d, struct device_node *ctrlr,
198 const u32 *intspec, unsigned int intsize,
199 irq_hw_number_t *out_hwirq, unsigned int *out_type);
200
Grant Likelycc79ca62012-02-16 01:37:49 -0700201#if defined(CONFIG_OF_IRQ)
Grant Likely7e713302011-07-26 03:19:06 -0600202extern void irq_domain_generate_simple(const struct of_device_id *match,
203 u64 phys_base, unsigned int irq_start);
Grant Likelycc79ca62012-02-16 01:37:49 -0700204#else /* CONFIG_OF_IRQ */
Grant Likely7e713302011-07-26 03:19:06 -0600205static inline void irq_domain_generate_simple(const struct of_device_id *match,
206 u64 phys_base, unsigned int irq_start) { }
Grant Likelycc79ca62012-02-16 01:37:49 -0700207#endif /* !CONFIG_OF_IRQ */
Grant Likelyd593f252012-02-24 08:24:17 -0700208
209#else /* CONFIG_IRQ_DOMAIN */
210static inline void irq_dispose_mapping(unsigned int virq) { }
211#endif /* !CONFIG_IRQ_DOMAIN */
Grant Likely7e713302011-07-26 03:19:06 -0600212
Grant Likely08a543a2011-07-26 03:19:06 -0600213#endif /* _LINUX_IRQDOMAIN_H */