1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32#ifndef _LINUX_IRQDOMAIN_H
33#define _LINUX_IRQDOMAIN_H
34
35#include <linux/types.h>
36#include <linux/irqhandler.h>
37#include <linux/radix-tree.h>
38
39struct device_node;
40struct irq_domain;
41struct of_device_id;
42struct irq_chip;
43struct irq_data;
44
45
46#define NUM_ISA_INTERRUPTS 16
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63struct irq_domain_ops {
64 int (*match)(struct irq_domain *d, struct device_node *node);
65 int (*map)(struct irq_domain *d, unsigned int virq, irq_hw_number_t hw);
66 void (*unmap)(struct irq_domain *d, unsigned int virq);
67 int (*xlate)(struct irq_domain *d, struct device_node *node,
68 const u32 *intspec, unsigned int intsize,
69 unsigned long *out_hwirq, unsigned int *out_type);
70
71#ifdef CONFIG_IRQ_DOMAIN_HIERARCHY
72
73 int (*alloc)(struct irq_domain *d, unsigned int virq,
74 unsigned int nr_irqs, void *arg);
75 void (*free)(struct irq_domain *d, unsigned int virq,
76 unsigned int nr_irqs);
77 void (*activate)(struct irq_domain *d, struct irq_data *irq_data);
78 void (*deactivate)(struct irq_domain *d, struct irq_data *irq_data);
79#endif
80};
81
82extern struct irq_domain_ops irq_generic_chip_ops;
83
84struct irq_domain_chip_generic;
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110struct irq_domain {
111 struct list_head link;
112 const char *name;
113 const struct irq_domain_ops *ops;
114 void *host_data;
115 unsigned int flags;
116
117
118 struct device_node *of_node;
119 struct irq_domain_chip_generic *gc;
120#ifdef CONFIG_IRQ_DOMAIN_HIERARCHY
121 struct irq_domain *parent;
122#endif
123
124
125 irq_hw_number_t hwirq_max;
126 unsigned int revmap_direct_max_irq;
127 unsigned int revmap_size;
128 struct radix_tree_root revmap_tree;
129 unsigned int linear_revmap[];
130};
131
132
133enum {
134
135 IRQ_DOMAIN_FLAG_HIERARCHY = (1 << 0),
136
137
138 IRQ_DOMAIN_FLAG_AUTO_RECURSIVE = (1 << 1),
139
140
141
142
143
144
145 IRQ_DOMAIN_FLAG_NONCORE = (1 << 16),
146};
147
148#ifdef CONFIG_IRQ_DOMAIN
149struct irq_domain *__irq_domain_add(struct device_node *of_node, int size,
150 irq_hw_number_t hwirq_max, int direct_max,
151 const struct irq_domain_ops *ops,
152 void *host_data);
153struct irq_domain *irq_domain_add_simple(struct device_node *of_node,
154 unsigned int size,
155 unsigned int first_irq,
156 const struct irq_domain_ops *ops,
157 void *host_data);
158struct irq_domain *irq_domain_add_legacy(struct device_node *of_node,
159 unsigned int size,
160 unsigned int first_irq,
161 irq_hw_number_t first_hwirq,
162 const struct irq_domain_ops *ops,
163 void *host_data);
164extern struct irq_domain *irq_find_host(struct device_node *node);
165extern void irq_set_default_host(struct irq_domain *host);
166
167
168
169
170
171
172
173
174static inline struct irq_domain *irq_domain_add_linear(struct device_node *of_node,
175 unsigned int size,
176 const struct irq_domain_ops *ops,
177 void *host_data)
178{
179 return __irq_domain_add(of_node, size, size, 0, ops, host_data);
180}
181static inline struct irq_domain *irq_domain_add_nomap(struct device_node *of_node,
182 unsigned int max_irq,
183 const struct irq_domain_ops *ops,
184 void *host_data)
185{
186 return __irq_domain_add(of_node, 0, max_irq, max_irq, ops, host_data);
187}
188static inline struct irq_domain *irq_domain_add_legacy_isa(
189 struct device_node *of_node,
190 const struct irq_domain_ops *ops,
191 void *host_data)
192{
193 return irq_domain_add_legacy(of_node, NUM_ISA_INTERRUPTS, 0, 0, ops,
194 host_data);
195}
196static inline struct irq_domain *irq_domain_add_tree(struct device_node *of_node,
197 const struct irq_domain_ops *ops,
198 void *host_data)
199{
200 return __irq_domain_add(of_node, 0, ~0, 0, ops, host_data);
201}
202
203extern void irq_domain_remove(struct irq_domain *host);
204
205extern int irq_domain_associate(struct irq_domain *domain, unsigned int irq,
206 irq_hw_number_t hwirq);
207extern void irq_domain_associate_many(struct irq_domain *domain,
208 unsigned int irq_base,
209 irq_hw_number_t hwirq_base, int count);
210extern void irq_domain_disassociate(struct irq_domain *domain,
211 unsigned int irq);
212
213extern unsigned int irq_create_mapping(struct irq_domain *host,
214 irq_hw_number_t hwirq);
215extern void irq_dispose_mapping(unsigned int virq);
216
217
218
219
220
221
222
223
224
225
226
227static inline unsigned int irq_linear_revmap(struct irq_domain *domain,
228 irq_hw_number_t hwirq)
229{
230 return hwirq < domain->revmap_size ? domain->linear_revmap[hwirq] : 0;
231}
232extern unsigned int irq_find_mapping(struct irq_domain *host,
233 irq_hw_number_t hwirq);
234extern unsigned int irq_create_direct_mapping(struct irq_domain *host);
235extern int irq_create_strict_mappings(struct irq_domain *domain,
236 unsigned int irq_base,
237 irq_hw_number_t hwirq_base, int count);
238
239static inline int irq_create_identity_mapping(struct irq_domain *host,
240 irq_hw_number_t hwirq)
241{
242 return irq_create_strict_mappings(host, hwirq, hwirq, 1);
243}
244
245extern const struct irq_domain_ops irq_domain_simple_ops;
246
247
248int irq_domain_xlate_onecell(struct irq_domain *d, struct device_node *ctrlr,
249 const u32 *intspec, unsigned int intsize,
250 irq_hw_number_t *out_hwirq, unsigned int *out_type);
251int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
252 const u32 *intspec, unsigned int intsize,
253 irq_hw_number_t *out_hwirq, unsigned int *out_type);
254int irq_domain_xlate_onetwocell(struct irq_domain *d, struct device_node *ctrlr,
255 const u32 *intspec, unsigned int intsize,
256 irq_hw_number_t *out_hwirq, unsigned int *out_type);
257
258
259extern struct irq_data *irq_domain_get_irq_data(struct irq_domain *domain,
260 unsigned int virq);
261#ifdef CONFIG_IRQ_DOMAIN_HIERARCHY
262extern struct irq_domain *irq_domain_add_hierarchy(struct irq_domain *parent,
263 unsigned int flags, unsigned int size,
264 struct device_node *node,
265 const struct irq_domain_ops *ops, void *host_data);
266extern int __irq_domain_alloc_irqs(struct irq_domain *domain, int irq_base,
267 unsigned int nr_irqs, int node, void *arg,
268 bool realloc);
269extern void irq_domain_free_irqs(unsigned int virq, unsigned int nr_irqs);
270extern void irq_domain_activate_irq(struct irq_data *irq_data);
271extern void irq_domain_deactivate_irq(struct irq_data *irq_data);
272
273static inline int irq_domain_alloc_irqs(struct irq_domain *domain,
274 unsigned int nr_irqs, int node, void *arg)
275{
276 return __irq_domain_alloc_irqs(domain, -1, nr_irqs, node, arg, false);
277}
278
279extern int irq_domain_set_hwirq_and_chip(struct irq_domain *domain,
280 unsigned int virq,
281 irq_hw_number_t hwirq,
282 struct irq_chip *chip,
283 void *chip_data);
284extern void irq_domain_set_info(struct irq_domain *domain, unsigned int virq,
285 irq_hw_number_t hwirq, struct irq_chip *chip,
286 void *chip_data, irq_flow_handler_t handler,
287 void *handler_data, const char *handler_name);
288extern void irq_domain_reset_irq_data(struct irq_data *irq_data);
289extern void irq_domain_free_irqs_common(struct irq_domain *domain,
290 unsigned int virq,
291 unsigned int nr_irqs);
292extern void irq_domain_free_irqs_top(struct irq_domain *domain,
293 unsigned int virq, unsigned int nr_irqs);
294
295extern int irq_domain_alloc_irqs_parent(struct irq_domain *domain,
296 unsigned int irq_base,
297 unsigned int nr_irqs, void *arg);
298
299extern void irq_domain_free_irqs_parent(struct irq_domain *domain,
300 unsigned int irq_base,
301 unsigned int nr_irqs);
302
303static inline bool irq_domain_is_hierarchy(struct irq_domain *domain)
304{
305 return domain->flags & IRQ_DOMAIN_FLAG_HIERARCHY;
306}
307#else
308static inline void irq_domain_activate_irq(struct irq_data *data) { }
309static inline void irq_domain_deactivate_irq(struct irq_data *data) { }
310static inline int irq_domain_alloc_irqs(struct irq_domain *domain,
311 unsigned int nr_irqs, int node, void *arg)
312{
313 return -1;
314}
315
316static inline bool irq_domain_is_hierarchy(struct irq_domain *domain)
317{
318 return false;
319}
320#endif
321
322#else
323static inline void irq_dispose_mapping(unsigned int virq) { }
324static inline void irq_domain_activate_irq(struct irq_data *data) { }
325static inline void irq_domain_deactivate_irq(struct irq_data *data) { }
326#endif
327
328#endif
329