irq.h 11.9 KB
Newer Older
1
2
#ifndef _LINUX_IRQ_H
#define _LINUX_IRQ_H
Linus Torvalds's avatar
Linus Torvalds committed
3
4
5
6
7
8
9
10
11

/*
 * Please do not include this file in generic code.  There is currently
 * no requirement for any architecture to implement anything held
 * within this file.
 *
 * Thanks. --rmk
 */

12
#include <linux/smp.h>
Linus Torvalds's avatar
Linus Torvalds committed
13

14
#ifndef CONFIG_S390
Linus Torvalds's avatar
Linus Torvalds committed
15
16
17
18
19

#include <linux/linkage.h>
#include <linux/cache.h>
#include <linux/spinlock.h>
#include <linux/cpumask.h>
20
#include <linux/irqreturn.h>
21
#include <linux/errno.h>
Linus Torvalds's avatar
Linus Torvalds committed
22
23
24

#include <asm/irq.h>
#include <asm/ptrace.h>
25
#include <asm/irq_regs.h>
Linus Torvalds's avatar
Linus Torvalds committed
26

27
28
struct irq_desc;
typedef	void fastcall (*irq_flow_handler_t)(unsigned int irq,
29
					    struct irq_desc *desc);
30
31


Linus Torvalds's avatar
Linus Torvalds committed
32
33
/*
 * IRQ line status.
34
 *
35
 * Bits 0-7 are reserved for the IRQF_* bits in linux/interrupt.h
36
37
 *
 * IRQ types
Linus Torvalds's avatar
Linus Torvalds committed
38
 */
39
40
41
42
43
44
45
46
47
48
#define IRQ_TYPE_NONE		0x00000000	/* Default, unspecified type */
#define IRQ_TYPE_EDGE_RISING	0x00000001	/* Edge rising type */
#define IRQ_TYPE_EDGE_FALLING	0x00000002	/* Edge falling type */
#define IRQ_TYPE_EDGE_BOTH (IRQ_TYPE_EDGE_FALLING | IRQ_TYPE_EDGE_RISING)
#define IRQ_TYPE_LEVEL_HIGH	0x00000004	/* Level high type */
#define IRQ_TYPE_LEVEL_LOW	0x00000008	/* Level low type */
#define IRQ_TYPE_SENSE_MASK	0x0000000f	/* Mask of the above */
#define IRQ_TYPE_PROBE		0x00000010	/* Probing in progress */

/* Internal flags */
49
50
51
52
53
54
55
56
57
58
59
60
#define IRQ_INPROGRESS		0x00000100	/* IRQ handler active - do not enter! */
#define IRQ_DISABLED		0x00000200	/* IRQ disabled - do not enter! */
#define IRQ_PENDING		0x00000400	/* IRQ pending - replay on enable */
#define IRQ_REPLAY		0x00000800	/* IRQ has been replayed but not acked yet */
#define IRQ_AUTODETECT		0x00001000	/* IRQ is being autodetected */
#define IRQ_WAITING		0x00002000	/* IRQ not yet seen - for autodetection */
#define IRQ_LEVEL		0x00004000	/* IRQ level triggered */
#define IRQ_MASKED		0x00008000	/* IRQ masked - shouldn't be seen again */
#define IRQ_PER_CPU		0x00010000	/* IRQ is per CPU */
#define IRQ_NOPROBE		0x00020000	/* IRQ is not valid for probing */
#define IRQ_NOREQUEST		0x00040000	/* IRQ cannot be requested */
#define IRQ_NOAUTOEN		0x00080000	/* IRQ will not be enabled on request irq */
61
62
63
#define IRQ_WAKEUP		0x00100000	/* IRQ triggers system wakeup */
#define IRQ_MOVE_PENDING	0x00200000	/* need to re-target IRQ destination */
#define IRQ_NO_BALANCING	0x00400000	/* IRQ is excluded from balancing */
64

65
#ifdef CONFIG_IRQ_PER_CPU
66
# define CHECK_IRQ_PER_CPU(var) ((var) & IRQ_PER_CPU)
67
# define IRQ_NO_BALANCING_MASK	(IRQ_PER_CPU | IRQ_NO_BALANCING)
68
69
#else
# define CHECK_IRQ_PER_CPU(var) 0
70
# define IRQ_NO_BALANCING_MASK	IRQ_NO_BALANCING
71
#endif
Linus Torvalds's avatar
Linus Torvalds committed
72

Thomas Gleixner's avatar
Thomas Gleixner committed
73
struct proc_dir_entry;
74
struct msi_desc;
Thomas Gleixner's avatar
Thomas Gleixner committed
75

76
/**
Thomas Gleixner's avatar
Thomas Gleixner committed
77
 * struct irq_chip - hardware interrupt chip descriptor
78
79
80
81
82
83
84
85
86
87
 *
 * @name:		name for /proc/interrupts
 * @startup:		start up the interrupt (defaults to ->enable if NULL)
 * @shutdown:		shut down the interrupt (defaults to ->disable if NULL)
 * @enable:		enable the interrupt (defaults to chip->unmask if NULL)
 * @disable:		disable the interrupt (defaults to chip->mask if NULL)
 * @ack:		start of a new interrupt
 * @mask:		mask an interrupt source
 * @mask_ack:		ack and mask an interrupt source
 * @unmask:		unmask an interrupt source
88
89
 * @eoi:		end of interrupt - chip level
 * @end:		end of interrupt - flow level
90
91
92
93
94
95
 * @set_affinity:	set the CPU affinity on SMP machines
 * @retrigger:		resend an IRQ to the CPU
 * @set_type:		set the flow type (IRQ_TYPE_LEVEL/etc.) of an IRQ
 * @set_wake:		enable/disable power-management wake-on of an IRQ
 *
 * @release:		release function solely used by UML
Thomas Gleixner's avatar
Thomas Gleixner committed
96
 * @typename:		obsoleted by name, kept as migration helper
Linus Torvalds's avatar
Linus Torvalds committed
97
 */
Thomas Gleixner's avatar
Thomas Gleixner committed
98
99
struct irq_chip {
	const char	*name;
100
101
102
103
	unsigned int	(*startup)(unsigned int irq);
	void		(*shutdown)(unsigned int irq);
	void		(*enable)(unsigned int irq);
	void		(*disable)(unsigned int irq);
Thomas Gleixner's avatar
Thomas Gleixner committed
104

105
	void		(*ack)(unsigned int irq);
Thomas Gleixner's avatar
Thomas Gleixner committed
106
107
108
	void		(*mask)(unsigned int irq);
	void		(*mask_ack)(unsigned int irq);
	void		(*unmask)(unsigned int irq);
109
	void		(*eoi)(unsigned int irq);
Thomas Gleixner's avatar
Thomas Gleixner committed
110

111
112
	void		(*end)(unsigned int irq);
	void		(*set_affinity)(unsigned int irq, cpumask_t dest);
113
	int		(*retrigger)(unsigned int irq);
Thomas Gleixner's avatar
Thomas Gleixner committed
114
115
	int		(*set_type)(unsigned int irq, unsigned int flow_type);
	int		(*set_wake)(unsigned int irq, unsigned int on);
116

117
118
	/* Currently used only by UML, might disappear one day.*/
#ifdef CONFIG_IRQ_RELEASE_METHOD
119
	void		(*release)(unsigned int irq, void *dev_id);
120
#endif
Thomas Gleixner's avatar
Thomas Gleixner committed
121
122
123
124
125
	/*
	 * For compatibility, ->typename is copied into ->name.
	 * Will disappear.
	 */
	const char	*typename;
Linus Torvalds's avatar
Linus Torvalds committed
126
127
};

128
129
130
/**
 * struct irq_desc - interrupt descriptor
 *
Thomas Gleixner's avatar
Thomas Gleixner committed
131
132
 * @handle_irq:		highlevel irq-events handler [if NULL, __do_IRQ()]
 * @chip:		low level interrupt hardware access
Randy Dunlap's avatar
Randy Dunlap committed
133
 * @msi_desc:		MSI descriptor
Thomas Gleixner's avatar
Thomas Gleixner committed
134
135
136
 * @handler_data:	per-IRQ data for the irq_chip methods
 * @chip_data:		platform-specific per-chip private data for the chip
 *			methods, to allow shared chip implementations
137
138
139
 * @action:		the irq action chain
 * @status:		status information
 * @depth:		disable-depth, for nested irq_disable() calls
140
 * @wake_depth:		enable depth, for multiple set_irq_wake() callers
141
142
 * @irq_count:		stats field to detect stalled irqs
 * @irqs_unhandled:	stats field for spurious unhandled interrupts
Randy Dunlap's avatar
Randy Dunlap committed
143
 * @last_unhandled:	aging timer for unhandled count
144
145
 * @lock:		locking for SMP
 * @affinity:		IRQ affinity on SMP
Thomas Gleixner's avatar
Thomas Gleixner committed
146
 * @cpu:		cpu index useful for balancing
147
148
149
 * @pending_mask:	pending rebalanced interrupts
 * @dir:		/proc/irq/ procfs entry
 * @affinity_entry:	/proc/irq/smp_affinity procfs entry on SMP
150
 * @name:		flow handler name for /proc/interrupts output
Linus Torvalds's avatar
Linus Torvalds committed
151
 */
152
struct irq_desc {
153
	irq_flow_handler_t	handle_irq;
Thomas Gleixner's avatar
Thomas Gleixner committed
154
	struct irq_chip		*chip;
155
	struct msi_desc		*msi_desc;
Thomas Gleixner's avatar
Thomas Gleixner committed
156
	void			*handler_data;
157
158
159
	void			*chip_data;
	struct irqaction	*action;	/* IRQ action list */
	unsigned int		status;		/* IRQ status */
Thomas Gleixner's avatar
Thomas Gleixner committed
160

161
	unsigned int		depth;		/* nested irq disables */
162
	unsigned int		wake_depth;	/* nested wake enables */
163
164
	unsigned int		irq_count;	/* For detecting broken IRQs */
	unsigned int		irqs_unhandled;
165
	unsigned long		last_unhandled;	/* Aging timer for unhandled count */
166
	spinlock_t		lock;
167
#ifdef CONFIG_SMP
168
	cpumask_t		affinity;
Thomas Gleixner's avatar
Thomas Gleixner committed
169
	unsigned int		cpu;
170
#endif
171
#if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
172
	cpumask_t		pending_mask;
173
#endif
174
#ifdef CONFIG_PROC_FS
175
	struct proc_dir_entry	*dir;
176
#endif
177
	const char		*name;
178
} ____cacheline_internodealigned_in_smp;
Linus Torvalds's avatar
Linus Torvalds committed
179

180
extern struct irq_desc irq_desc[NR_IRQS];
Linus Torvalds's avatar
Linus Torvalds committed
181

182
183
184
/*
 * Migration helpers for obsolete names, they will go away:
 */
Thomas Gleixner's avatar
Thomas Gleixner committed
185
186
187
#define hw_interrupt_type	irq_chip
typedef struct irq_chip		hw_irq_controller;
#define no_irq_type		no_irq_chip
188
189
190
191
192
193
typedef struct irq_desc		irq_desc_t;

/*
 * Pick up the arch-dependent methods:
 */
#include <asm/hw_irq.h>
Linus Torvalds's avatar
Linus Torvalds committed
194

195
extern int setup_irq(unsigned int irq, struct irqaction *new);
Linus Torvalds's avatar
Linus Torvalds committed
196
197

#ifdef CONFIG_GENERIC_HARDIRQS
198

199
200
201
202
#ifndef handle_dynamic_tick
# define handle_dynamic_tick(a)		do { } while (0)
#endif

203
204
#ifdef CONFIG_SMP

205
#if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
206

207
208
void set_pending_irq(unsigned int irq, cpumask_t mask);
void move_native_irq(int irq);
209
void move_masked_irq(int irq);
210

211
212
213
214
215
216
217
218
219
220
#else /* CONFIG_GENERIC_PENDING_IRQ || CONFIG_IRQBALANCE */

static inline void move_irq(int irq)
{
}

static inline void move_native_irq(int irq)
{
}

221
222
223
224
static inline void move_masked_irq(int irq)
{
}

225
226
227
static inline void set_pending_irq(unsigned int irq, cpumask_t mask)
{
}
228

229
#endif /* CONFIG_GENERIC_PENDING_IRQ */
230

231
232
233
extern int irq_set_affinity(unsigned int irq, cpumask_t cpumask);
extern int irq_can_set_affinity(unsigned int irq);

234
#else /* CONFIG_SMP */
235
236

#define move_native_irq(x)
237
#define move_masked_irq(x)
238

239
240
241
242
243
244
245
static inline int irq_set_affinity(unsigned int irq, cpumask_t cpumask)
{
	return -EINVAL;
}

static inline int irq_can_set_affinity(unsigned int irq) { return 0; }

246
#endif /* CONFIG_SMP */
247

248
249
250
251
252
253
254
255
#ifdef CONFIG_IRQBALANCE
extern void set_balance_irq_affinity(unsigned int irq, cpumask_t mask);
#else
static inline void set_balance_irq_affinity(unsigned int irq, cpumask_t mask)
{
}
#endif

256
257
258
259
260
261
262
263
264
#ifdef CONFIG_AUTO_IRQ_AFFINITY
extern int select_smp_affinity(unsigned int irq);
#else
static inline int select_smp_affinity(unsigned int irq)
{
	return 1;
}
#endif

Linus Torvalds's avatar
Linus Torvalds committed
265
266
extern int no_irq_affinity;

267
268
269
270
271
static inline int irq_balancing_disabled(unsigned int irq)
{
	return irq_desc[irq].status & IRQ_NO_BALANCING_MASK;
}

Thomas Gleixner's avatar
Thomas Gleixner committed
272
/* Handle irq action chains: */
273
extern int handle_IRQ_event(unsigned int irq, struct irqaction *action);
Thomas Gleixner's avatar
Thomas Gleixner committed
274
275
276
277
278

/*
 * Built-in IRQ handlers for various IRQ types,
 * callable via desc->chip->handle_irq()
 */
279
280
281
282
283
284
extern void fastcall handle_level_irq(unsigned int irq, struct irq_desc *desc);
extern void fastcall handle_fasteoi_irq(unsigned int irq, struct irq_desc *desc);
extern void fastcall handle_edge_irq(unsigned int irq, struct irq_desc *desc);
extern void fastcall handle_simple_irq(unsigned int irq, struct irq_desc *desc);
extern void fastcall handle_percpu_irq(unsigned int irq, struct irq_desc *desc);
extern void fastcall handle_bad_irq(unsigned int irq, struct irq_desc *desc);
Thomas Gleixner's avatar
Thomas Gleixner committed
285

286
/*
Thomas Gleixner's avatar
Thomas Gleixner committed
287
288
 * Monolithic do_IRQ implementation.
 * (is an explicit fastcall, because i386 4KSTACKS calls it from assembly)
289
 */
290
#ifndef CONFIG_GENERIC_HARDIRQS_NO__DO_IRQ
291
extern fastcall unsigned int __do_IRQ(unsigned int irq);
292
#endif
293

Ingo Molnar's avatar
Ingo Molnar committed
294
295
296
297
298
299
/*
 * Architectures call this to let the generic IRQ layer
 * handle an interrupt. If the descriptor is attached to an
 * irqchip-style controller then we call the ->handle_irq() handler,
 * and it calls __do_IRQ() if it's attached to an irqtype-style controller.
 */
300
static inline void generic_handle_irq(unsigned int irq)
Ingo Molnar's avatar
Ingo Molnar committed
301
302
303
{
	struct irq_desc *desc = irq_desc + irq;

304
#ifdef CONFIG_GENERIC_HARDIRQS_NO__DO_IRQ
305
	desc->handle_irq(irq, desc);
306
#else
Ingo Molnar's avatar
Ingo Molnar committed
307
	if (likely(desc->handle_irq))
308
		desc->handle_irq(irq, desc);
Ingo Molnar's avatar
Ingo Molnar committed
309
	else
310
		__do_IRQ(irq);
311
#endif
Ingo Molnar's avatar
Ingo Molnar committed
312
313
}

Thomas Gleixner's avatar
Thomas Gleixner committed
314
/* Handling of unhandled and spurious interrupts: */
315
extern void note_interrupt(unsigned int irq, struct irq_desc *desc,
316
			   int action_ret);
Linus Torvalds's avatar
Linus Torvalds committed
317

318
319
320
/* Resending of interrupts :*/
void check_irq_resend(struct irq_desc *desc, unsigned int irq);

Thomas Gleixner's avatar
Thomas Gleixner committed
321
322
323
324
325
326
/* Enable/disable irq debugging output: */
extern int noirqdebug_setup(char *str);

/* Checks whether the interrupt can be requested by request_irq(): */
extern int can_request_irq(unsigned int irq, unsigned long irqflags);

327
/* Dummy irq-chip implementations: */
Thomas Gleixner's avatar
Thomas Gleixner committed
328
extern struct irq_chip no_irq_chip;
329
extern struct irq_chip dummy_irq_chip;
Thomas Gleixner's avatar
Thomas Gleixner committed
330

331
332
333
extern void
set_irq_chip_and_handler(unsigned int irq, struct irq_chip *chip,
			 irq_flow_handler_t handle);
Thomas Gleixner's avatar
Thomas Gleixner committed
334
extern void
335
336
337
set_irq_chip_and_handler_name(unsigned int irq, struct irq_chip *chip,
			      irq_flow_handler_t handle, const char *name);

Thomas Gleixner's avatar
Thomas Gleixner committed
338
extern void
339
340
__set_irq_handler(unsigned int irq, irq_flow_handler_t handle, int is_chained,
		  const char *name);
Linus Torvalds's avatar
Linus Torvalds committed
341

Thomas Gleixner's avatar
Thomas Gleixner committed
342
343
344
345
/*
 * Set a highlevel flow handler for a given IRQ:
 */
static inline void
346
set_irq_handler(unsigned int irq, irq_flow_handler_t handle)
Thomas Gleixner's avatar
Thomas Gleixner committed
347
{
348
	__set_irq_handler(irq, handle, 0, NULL);
Thomas Gleixner's avatar
Thomas Gleixner committed
349
350
351
352
353
354
355
356
357
}

/*
 * Set a highlevel chained flow handler for a given IRQ.
 * (a chained handler is automatically enabled and set to
 *  IRQ_NOREQUEST and IRQ_NOPROBE)
 */
static inline void
set_irq_chained_handler(unsigned int irq,
358
			irq_flow_handler_t handle)
Thomas Gleixner's avatar
Thomas Gleixner committed
359
{
360
	__set_irq_handler(irq, handle, 1, NULL);
Thomas Gleixner's avatar
Thomas Gleixner committed
361
362
}

363
364
365
366
/* Handle dynamic irq creation and destruction */
extern int create_irq(void);
extern void destroy_irq(unsigned int irq);

367
368
369
370
371
372
373
/* Test to see if a driver has successfully requested an irq */
static inline int irq_has_action(unsigned int irq)
{
	struct irq_desc *desc = irq_desc + irq;
	return desc->action != NULL;
}

374
375
376
/* Dynamic irq helper functions */
extern void dynamic_irq_init(unsigned int irq);
extern void dynamic_irq_cleanup(unsigned int irq);
377

378
/* Set/get chip/data for an IRQ: */
379
380
381
382
extern int set_irq_chip(unsigned int irq, struct irq_chip *chip);
extern int set_irq_data(unsigned int irq, void *data);
extern int set_irq_chip_data(unsigned int irq, void *data);
extern int set_irq_type(unsigned int irq, unsigned int type);
383
extern int set_irq_msi(unsigned int irq, struct msi_desc *entry);
384
385
386
387

#define get_irq_chip(irq)	(irq_desc[irq].chip)
#define get_irq_chip_data(irq)	(irq_desc[irq].chip_data)
#define get_irq_data(irq)	(irq_desc[irq].handler_data)
388
#define get_irq_msi(irq)	(irq_desc[irq].msi_desc)
389

Thomas Gleixner's avatar
Thomas Gleixner committed
390
#endif /* CONFIG_GENERIC_HARDIRQS */
Linus Torvalds's avatar
Linus Torvalds committed
391

392
#endif /* !CONFIG_S390 */
Linus Torvalds's avatar
Linus Torvalds committed
393

394
#endif /* _LINUX_IRQ_H */