blob: c0e1bc319e353bc9f8b08d91c41efc89acafa463 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifdef __KERNEL__
Paul Mackerras1b923132005-10-10 22:54:57 +10002#ifndef _ASM_POWERPC_IRQ_H
3#define _ASM_POWERPC_IRQ_H
4
5/*
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
10 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070011
Paul Mackerras1b923132005-10-10 22:54:57 +100012#include <linux/threads.h>
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100013#include <linux/list.h>
14#include <linux/radix-tree.h>
Paul Mackerras1b923132005-10-10 22:54:57 +100015
16#include <asm/types.h>
Arun Sharma600634972011-07-26 16:09:06 -070017#include <linux/atomic.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070018
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100019
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100020/* Define a way to iterate across irqs. */
21#define for_each_irq(i) \
22 for ((i) = 0; (i) < NR_IRQS; ++(i))
23
24extern atomic_t ppc_n_lost_interrupts;
25
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100026/* This number is used when no interrupt has been assigned */
27#define NO_IRQ (0)
28
29/* This is a special irq number to return from get_irq() to tell that
30 * no interrupt happened _and_ ignore it (don't count it as bad). Some
31 * platforms like iSeries rely on that.
32 */
33#define NO_IRQ_IGNORE ((unsigned int)-1)
34
Michael Ellerman551b81f2009-10-13 19:44:44 +000035/* Total number of virq in the platform */
36#define NR_IRQS CONFIG_NR_IRQS
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100037
38/* Number of irqs reserved for the legacy controller */
39#define NUM_ISA_INTERRUPTS 16
40
Michael Ellermancd015702009-10-13 19:45:03 +000041/* Same thing, used by the generic IRQ code */
42#define NR_IRQS_LEGACY NUM_ISA_INTERRUPTS
43
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100044/* This type is the placeholder for a hardware interrupt number. It has to
45 * be big enough to enclose whatever representation is used by a given
46 * platform.
47 */
48typedef unsigned long irq_hw_number_t;
49
50/* Interrupt controller "host" data structure. This could be defined as a
51 * irq domain controller. That is, it handles the mapping between hardware
52 * and virtual interrupt numbers for a given interrupt domain. The host
53 * structure is generally created by the PIC code for a given PIC instance
54 * (though a host can cover more than one PIC if they have a flat number
55 * model). It's the host callbacks that are responsible for setting the
56 * irq_chip on a given irq_desc after it's been mapped.
57 *
58 * The host code and data structures are fairly agnostic to the fact that
59 * we use an open firmware device-tree. We do have references to struct
60 * device_node in two places: in irq_find_host() to find the host matching
61 * a given interrupt controller node, and of course as an argument to its
62 * counterpart host->ops->match() callback. However, those are treated as
63 * generic pointers by the core and the fact that it's actually a device-node
64 * pointer is purely a convention between callers and implementation. This
65 * code could thus be used on other architectures by replacing those two
66 * by some sort of arch-specific void * "token" used to identify interrupt
67 * controllers.
68 */
69struct irq_host;
70struct radix_tree_root;
71
72/* Functions below are provided by the host and called whenever a new mapping
73 * is created or an old mapping is disposed. The host can then proceed to
74 * whatever internal data structures management is required. It also needs
75 * to setup the irq_desc when returning from map().
76 */
77struct irq_host_ops {
78 /* Match an interrupt controller device node to a host, returns
79 * 1 on a match
80 */
81 int (*match)(struct irq_host *h, struct device_node *node);
82
83 /* Create or update a mapping between a virtual irq number and a hw
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -070084 * irq number. This is called only once for a given mapping.
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100085 */
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -070086 int (*map)(struct irq_host *h, unsigned int virq, irq_hw_number_t hw);
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100087
88 /* Dispose of such a mapping */
89 void (*unmap)(struct irq_host *h, unsigned int virq);
90
91 /* Translate device-tree interrupt specifier from raw format coming
92 * from the firmware to a irq_hw_number_t (interrupt line number) and
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -070093 * type (sense) that can be passed to set_irq_type(). In the absence
94 * of this callback, irq_create_of_mapping() and irq_of_parse_and_map()
95 * will return the hw number in the first cell and IRQ_TYPE_NONE for
96 * the type (which amount to keeping whatever default value the
97 * interrupt controller has for that line)
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +100098 */
99 int (*xlate)(struct irq_host *h, struct device_node *ctrler,
Roman Fietze40d50cf2009-12-08 02:39:50 +0000100 const u32 *intspec, unsigned int intsize,
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -0700101 irq_hw_number_t *out_hwirq, unsigned int *out_type);
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000102};
103
104struct irq_host {
105 struct list_head link;
106
107 /* type of reverse mapping technique */
108 unsigned int revmap_type;
109#define IRQ_HOST_MAP_LEGACY 0 /* legacy 8259, gets irqs 1..15 */
110#define IRQ_HOST_MAP_NOMAP 1 /* no fast reverse mapping */
111#define IRQ_HOST_MAP_LINEAR 2 /* linear map of interrupts */
112#define IRQ_HOST_MAP_TREE 3 /* radix tree */
113 union {
114 struct {
115 unsigned int size;
116 unsigned int *revmap;
117 } linear;
118 struct radix_tree_root tree;
119 } revmap_data;
120 struct irq_host_ops *ops;
121 void *host_data;
122 irq_hw_number_t inval_irq;
Michael Ellerman52964f82007-08-28 18:47:54 +1000123
124 /* Optional device node pointer */
125 struct device_node *of_node;
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000126};
127
Grant Likely476eb492011-05-04 15:02:15 +1000128struct irq_data;
129extern irq_hw_number_t irqd_to_hwirq(struct irq_data *d);
Olof Johansson35923f122007-06-04 14:47:04 +1000130extern irq_hw_number_t virq_to_hw(unsigned int virq);
Milton Miller3ee62d32011-05-10 19:30:36 +0000131extern bool virq_is_host(unsigned int virq, struct irq_host *host);
Benjamin Herrenschmidt0b05ac62011-04-04 13:46:58 +1000132
Michael Ellerman40681b92006-08-02 11:13:50 +1000133/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000134 * irq_alloc_host - Allocate a new irq_host data structure
Michael Ellerman52964f82007-08-28 18:47:54 +1000135 * @of_node: optional device-tree node of the interrupt controller
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000136 * @revmap_type: type of reverse mapping to use
137 * @revmap_arg: for IRQ_HOST_MAP_LINEAR linear only: size of the map
138 * @ops: map/unmap host callbacks
139 * @inval_irq: provide a hw number in that host space that is always invalid
140 *
141 * Allocates and initialize and irq_host structure. Note that in the case of
142 * IRQ_HOST_MAP_LEGACY, the map() callback will be called before this returns
143 * for all legacy interrupts except 0 (which is always the invalid irq for
144 * a legacy controller). For a IRQ_HOST_MAP_LINEAR, the map is allocated by
145 * this call as well. For a IRQ_HOST_MAP_TREE, the radix tree will be allocated
146 * later during boot automatically (the reverse mapping will use the slow path
147 * until that happens).
148 */
Michael Ellerman52964f82007-08-28 18:47:54 +1000149extern struct irq_host *irq_alloc_host(struct device_node *of_node,
150 unsigned int revmap_type,
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000151 unsigned int revmap_arg,
152 struct irq_host_ops *ops,
153 irq_hw_number_t inval_irq);
154
155
Michael Ellerman40681b92006-08-02 11:13:50 +1000156/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000157 * irq_find_host - Locates a host for a given device node
158 * @node: device-tree node of the interrupt controller
159 */
160extern struct irq_host *irq_find_host(struct device_node *node);
161
162
Michael Ellerman40681b92006-08-02 11:13:50 +1000163/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000164 * irq_set_default_host - Set a "default" host
165 * @host: default host pointer
166 *
167 * For convenience, it's possible to set a "default" host that will be used
168 * whenever NULL is passed to irq_create_mapping(). It makes life easier for
169 * platforms that want to manipulate a few hard coded interrupt numbers that
170 * aren't properly represented in the device-tree.
171 */
172extern void irq_set_default_host(struct irq_host *host);
173
174
Michael Ellerman40681b92006-08-02 11:13:50 +1000175/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000176 * irq_set_virq_count - Set the maximum number of virt irqs
177 * @count: number of linux virtual irqs, capped with NR_IRQS
178 *
179 * This is mainly for use by platforms like iSeries who want to program
180 * the virtual irq number in the controller to avoid the reverse mapping
181 */
182extern void irq_set_virq_count(unsigned int count);
183
184
Michael Ellerman40681b92006-08-02 11:13:50 +1000185/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000186 * irq_create_mapping - Map a hardware interrupt into linux virq space
187 * @host: host owning this hardware interrupt or NULL for default host
188 * @hwirq: hardware irq number in that host space
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000189 *
190 * Only one mapping per hardware interrupt is permitted. Returns a linux
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -0700191 * virq number.
192 * If the sense/trigger is to be specified, set_irq_type() should be called
193 * on the number returned from that call.
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000194 */
195extern unsigned int irq_create_mapping(struct irq_host *host,
Benjamin Herrenschmidt6e99e452006-07-10 04:44:42 -0700196 irq_hw_number_t hwirq);
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000197
198
Michael Ellerman40681b92006-08-02 11:13:50 +1000199/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000200 * irq_dispose_mapping - Unmap an interrupt
201 * @virq: linux virq number of the interrupt to unmap
202 */
203extern void irq_dispose_mapping(unsigned int virq);
204
Michael Ellerman40681b92006-08-02 11:13:50 +1000205/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000206 * irq_find_mapping - Find a linux virq from an hw irq number.
207 * @host: host owning this hardware interrupt
208 * @hwirq: hardware irq number in that host space
209 *
210 * This is a slow path, for use by generic code. It's expected that an
211 * irq controller implementation directly calls the appropriate low level
212 * mapping function.
213 */
214extern unsigned int irq_find_mapping(struct irq_host *host,
215 irq_hw_number_t hwirq);
216
Michael Ellermanee51de52007-06-04 23:00:00 +1000217/**
218 * irq_create_direct_mapping - Allocate a virq for direct mapping
219 * @host: host to allocate the virq for or NULL for default host
220 *
221 * This routine is used for irq controllers which can choose the hardware
222 * interrupt numbers they generate. In such a case it's simplest to use
223 * the linux virq as the hardware interrupt number.
224 */
225extern unsigned int irq_create_direct_mapping(struct irq_host *host);
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000226
Michael Ellerman40681b92006-08-02 11:13:50 +1000227/**
Sebastien Dugue967e0122008-09-04 22:37:07 +1000228 * irq_radix_revmap_insert - Insert a hw irq to linux virq number mapping.
229 * @host: host owning this hardware interrupt
230 * @virq: linux irq number
231 * @hwirq: hardware irq number in that host space
232 *
233 * This is for use by irq controllers that use a radix tree reverse
234 * mapping for fast lookup.
235 */
236extern void irq_radix_revmap_insert(struct irq_host *host, unsigned int virq,
237 irq_hw_number_t hwirq);
238
239/**
240 * irq_radix_revmap_lookup - Find a linux virq from a hw irq number.
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000241 * @host: host owning this hardware interrupt
242 * @hwirq: hardware irq number in that host space
243 *
244 * This is a fast path, for use by irq controller code that uses radix tree
245 * revmaps
246 */
Sebastien Dugue967e0122008-09-04 22:37:07 +1000247extern unsigned int irq_radix_revmap_lookup(struct irq_host *host,
248 irq_hw_number_t hwirq);
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000249
Michael Ellerman40681b92006-08-02 11:13:50 +1000250/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000251 * irq_linear_revmap - Find a linux virq from a hw irq number.
252 * @host: host owning this hardware interrupt
253 * @hwirq: hardware irq number in that host space
254 *
255 * This is a fast path, for use by irq controller code that uses linear
256 * revmaps. It does fallback to the slow path if the revmap doesn't exist
257 * yet and will create the revmap entry with appropriate locking
258 */
259
260extern unsigned int irq_linear_revmap(struct irq_host *host,
261 irq_hw_number_t hwirq);
262
263
264
Michael Ellerman40681b92006-08-02 11:13:50 +1000265/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000266 * irq_alloc_virt - Allocate virtual irq numbers
267 * @host: host owning these new virtual irqs
268 * @count: number of consecutive numbers to allocate
269 * @hint: pass a hint number, the allocator will try to use a 1:1 mapping
270 *
271 * This is a low level function that is used internally by irq_create_mapping()
272 * and that can be used by some irq controllers implementations for things
273 * like allocating ranges of numbers for MSIs. The revmaps are left untouched.
274 */
275extern unsigned int irq_alloc_virt(struct irq_host *host,
276 unsigned int count,
277 unsigned int hint);
278
Michael Ellerman40681b92006-08-02 11:13:50 +1000279/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000280 * irq_free_virt - Free virtual irq numbers
281 * @virq: virtual irq number of the first interrupt to free
282 * @count: number of interrupts to free
283 *
284 * This function is the opposite of irq_alloc_virt. It will not clear reverse
285 * maps, this should be done previously by unmap'ing the interrupt. In fact,
286 * all interrupts covered by the range being freed should have been unmapped
287 * prior to calling this.
288 */
289extern void irq_free_virt(unsigned int virq, unsigned int count);
290
Michael Ellerman40681b92006-08-02 11:13:50 +1000291/**
Benjamin Herrenschmidt0ebfff12006-07-03 21:36:01 +1000292 * irq_early_init - Init irq remapping subsystem
293 */
294extern void irq_early_init(void);
295
296static __inline__ int irq_canonicalize(int irq)
297{
298 return irq;
299}
300
Paul Mackerras1b923132005-10-10 22:54:57 +1000301extern int distribute_irqs;
302
303struct irqaction;
304struct pt_regs;
305
Paul Mackerrasc6622f62006-02-24 10:06:59 +1100306#define __ARCH_HAS_DO_SOFTIRQ
307
Kumar Galabcf0b082008-04-30 03:49:55 -0500308#if defined(CONFIG_BOOKE) || defined(CONFIG_40x)
309/*
310 * Per-cpu stacks for handling critical, debug and machine check
311 * level interrupts.
312 */
313extern struct thread_info *critirq_ctx[NR_CPUS];
314extern struct thread_info *dbgirq_ctx[NR_CPUS];
315extern struct thread_info *mcheckirq_ctx[NR_CPUS];
316extern void exc_lvl_ctx_init(void);
317#else
318#define exc_lvl_ctx_init()
319#endif
320
Paul Mackerras1b923132005-10-10 22:54:57 +1000321/*
322 * Per-cpu stacks for handling hard and soft interrupts.
323 */
324extern struct thread_info *hardirq_ctx[NR_CPUS];
325extern struct thread_info *softirq_ctx[NR_CPUS];
326
327extern void irq_ctx_init(void);
328extern void call_do_softirq(struct thread_info *tp);
David Howells7d12e782006-10-05 14:55:46 +0100329extern int call_handle_irq(int irq, void *p1,
Benjamin Herrenschmidtb9e5b4e2006-07-03 19:32:51 +1000330 struct thread_info *tp, void *func);
Paul Mackerrasf2783c12005-10-20 09:23:26 +1000331extern void do_IRQ(struct pt_regs *regs);
332
Stuart Yoder6ec36b52011-05-19 08:54:26 -0500333int irq_choose_cpu(const struct cpumask *mask);
334
Linus Torvalds1da177e2005-04-16 15:20:36 -0700335#endif /* _ASM_IRQ_H */
336#endif /* __KERNEL__ */