irq.h 11.8 KB
Newer Older
1 2
#ifndef _LINUX_IRQ_H
#define _LINUX_IRQ_H
L
Linus Torvalds 已提交
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>
L
Linus Torvalds 已提交
13

14
#ifndef CONFIG_S390
L
Linus Torvalds 已提交
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>
L
Linus Torvalds 已提交
21 22 23

#include <asm/irq.h>
#include <asm/ptrace.h>
24
#include <asm/irq_regs.h>
L
Linus Torvalds 已提交
25

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


L
Linus Torvalds 已提交
31 32
/*
 * IRQ line status.
33
 *
34
 * Bits 0-7 are reserved for the IRQF_* bits in linux/interrupt.h
35 36
 *
 * IRQ types
L
Linus Torvalds 已提交
37
 */
38 39 40 41 42 43 44 45 46 47
#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 */
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
#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 */
#define IRQ_DELAYED_DISABLE	0x00100000	/* IRQ disable (masking) happens delayed. */
#define IRQ_WAKEUP		0x00200000	/* IRQ triggers system wakeup */
#define IRQ_MOVE_PENDING	0x00400000	/* need to re-target IRQ destination */
#define IRQ_NO_BALANCING	0x00800000	/* IRQ is excluded from balancing */

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
L
Linus Torvalds 已提交
72

T
Thomas Gleixner 已提交
73
struct proc_dir_entry;
74
struct msi_desc;
T
Thomas Gleixner 已提交
75

76
/**
T
Thomas Gleixner 已提交
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
T
Thomas Gleixner 已提交
96
 * @typename:		obsoleted by name, kept as migration helper
L
Linus Torvalds 已提交
97
 */
T
Thomas Gleixner 已提交
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);
T
Thomas Gleixner 已提交
104

105
	void		(*ack)(unsigned int irq);
T
Thomas Gleixner 已提交
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);
T
Thomas Gleixner 已提交
110

111 112
	void		(*end)(unsigned int irq);
	void		(*set_affinity)(unsigned int irq, cpumask_t dest);
113
	int		(*retrigger)(unsigned int irq);
T
Thomas Gleixner 已提交
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
T
Thomas Gleixner 已提交
121 122 123 124 125
	/*
	 * For compatibility, ->typename is copied into ->name.
	 * Will disappear.
	 */
	const char	*typename;
L
Linus Torvalds 已提交
126 127
};

128 129 130
/**
 * struct irq_desc - interrupt descriptor
 *
T
Thomas Gleixner 已提交
131 132 133 134 135
 * @handle_irq:		highlevel irq-events handler [if NULL, __do_IRQ()]
 * @chip:		low level interrupt hardware access
 * @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
136 137 138
 * @action:		the irq action chain
 * @status:		status information
 * @depth:		disable-depth, for nested irq_disable() calls
139
 * @wake_depth:		enable depth, for multiple set_irq_wake() callers
140 141 142 143
 * @irq_count:		stats field to detect stalled irqs
 * @irqs_unhandled:	stats field for spurious unhandled interrupts
 * @lock:		locking for SMP
 * @affinity:		IRQ affinity on SMP
T
Thomas Gleixner 已提交
144
 * @cpu:		cpu index useful for balancing
145 146 147
 * @pending_mask:	pending rebalanced interrupts
 * @dir:		/proc/irq/ procfs entry
 * @affinity_entry:	/proc/irq/smp_affinity procfs entry on SMP
148
 * @name:		flow handler name for /proc/interrupts output
L
Linus Torvalds 已提交
149 150 151
 *
 * Pad this out to 32 bytes for cache and indexing reasons.
 */
152
struct irq_desc {
153
	irq_flow_handler_t	handle_irq;
T
Thomas Gleixner 已提交
154
	struct irq_chip		*chip;
155
	struct msi_desc		*msi_desc;
T
Thomas Gleixner 已提交
156
	void			*handler_data;
157 158 159
	void			*chip_data;
	struct irqaction	*action;	/* IRQ action list */
	unsigned int		status;		/* IRQ status */
T
Thomas Gleixner 已提交
160

161
	unsigned int		depth;		/* nested irq disables */
162
	unsigned int		wake_depth;	/* nested wake enables */
163 164 165
	unsigned int		irq_count;	/* For detecting broken IRQs */
	unsigned int		irqs_unhandled;
	spinlock_t		lock;
166
#ifdef CONFIG_SMP
167
	cpumask_t		affinity;
T
Thomas Gleixner 已提交
168
	unsigned int		cpu;
169
#endif
170
#if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
171
	cpumask_t		pending_mask;
172
#endif
173
#ifdef CONFIG_PROC_FS
174
	struct proc_dir_entry	*dir;
175
#endif
176
	const char		*name;
177
} ____cacheline_aligned;
L
Linus Torvalds 已提交
178

179
extern struct irq_desc irq_desc[NR_IRQS];
L
Linus Torvalds 已提交
180

181 182 183
/*
 * Migration helpers for obsolete names, they will go away:
 */
T
Thomas Gleixner 已提交
184 185 186
#define hw_interrupt_type	irq_chip
typedef struct irq_chip		hw_irq_controller;
#define no_irq_type		no_irq_chip
187 188 189 190 191 192
typedef struct irq_desc		irq_desc_t;

/*
 * Pick up the arch-dependent methods:
 */
#include <asm/hw_irq.h>
L
Linus Torvalds 已提交
193

194
extern int setup_irq(unsigned int irq, struct irqaction *new);
L
Linus Torvalds 已提交
195 196

#ifdef CONFIG_GENERIC_HARDIRQS
197

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

202 203 204
#ifdef CONFIG_SMP
static inline void set_native_irq_info(int irq, cpumask_t mask)
{
205
	irq_desc[irq].affinity = mask;
206 207 208 209 210 211 212 213 214
}
#else
static inline void set_native_irq_info(int irq, cpumask_t mask)
{
}
#endif

#ifdef CONFIG_SMP

215
#if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
216

217 218
void set_pending_irq(unsigned int irq, cpumask_t mask);
void move_native_irq(int irq);
219
void move_masked_irq(int irq);
220

221 222 223 224 225 226 227 228 229 230
#else /* CONFIG_GENERIC_PENDING_IRQ || CONFIG_IRQBALANCE */

static inline void move_irq(int irq)
{
}

static inline void move_native_irq(int irq)
{
}

231 232 233 234
static inline void move_masked_irq(int irq)
{
}

235 236 237
static inline void set_pending_irq(unsigned int irq, cpumask_t mask)
{
}
238

239
#endif /* CONFIG_GENERIC_PENDING_IRQ */
240

241
#else /* CONFIG_SMP */
242 243

#define move_native_irq(x)
244
#define move_masked_irq(x)
245

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

L
Linus Torvalds 已提交
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;
}

T
Thomas Gleixner 已提交
272
/* Handle irq action chains: */
273
extern int handle_IRQ_event(unsigned int irq, struct irqaction *action);
T
Thomas Gleixner 已提交
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);
T
Thomas Gleixner 已提交
285

286
/*
T
Thomas Gleixner 已提交
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

I
Ingo Molnar 已提交
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)
I
Ingo Molnar 已提交
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
I
Ingo Molnar 已提交
307
	if (likely(desc->handle_irq))
308
		desc->handle_irq(irq, desc);
I
Ingo Molnar 已提交
309
	else
310
		__do_IRQ(irq);
311
#endif
I
Ingo Molnar 已提交
312 313
}

T
Thomas Gleixner 已提交
314
/* Handling of unhandled and spurious interrupts: */
315
extern void note_interrupt(unsigned int irq, struct irq_desc *desc,
316
			   int action_ret);
L
Linus Torvalds 已提交
317

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

T
Thomas Gleixner 已提交
321
/* Initialize /proc/irq/ */
L
Linus Torvalds 已提交
322
extern void init_irq_proc(void);
323

T
Thomas Gleixner 已提交
324 325 326 327 328 329
/* 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);

330
/* Dummy irq-chip implementations: */
T
Thomas Gleixner 已提交
331
extern struct irq_chip no_irq_chip;
332
extern struct irq_chip dummy_irq_chip;
T
Thomas Gleixner 已提交
333

334 335 336
extern void
set_irq_chip_and_handler(unsigned int irq, struct irq_chip *chip,
			 irq_flow_handler_t handle);
T
Thomas Gleixner 已提交
337
extern void
338 339 340
set_irq_chip_and_handler_name(unsigned int irq, struct irq_chip *chip,
			      irq_flow_handler_t handle, const char *name);

T
Thomas Gleixner 已提交
341
extern void
342 343
__set_irq_handler(unsigned int irq, irq_flow_handler_t handle, int is_chained,
		  const char *name);
L
Linus Torvalds 已提交
344

T
Thomas Gleixner 已提交
345 346 347 348
/*
 * Set a highlevel flow handler for a given IRQ:
 */
static inline void
349
set_irq_handler(unsigned int irq, irq_flow_handler_t handle)
T
Thomas Gleixner 已提交
350
{
351
	__set_irq_handler(irq, handle, 0, NULL);
T
Thomas Gleixner 已提交
352 353 354 355 356 357 358 359 360
}

/*
 * 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,
361
			irq_flow_handler_t handle)
T
Thomas Gleixner 已提交
362
{
363
	__set_irq_handler(irq, handle, 1, NULL);
T
Thomas Gleixner 已提交
364 365
}

366 367 368 369
/* Handle dynamic irq creation and destruction */
extern int create_irq(void);
extern void destroy_irq(unsigned int irq);

370 371 372 373 374 375 376
/* 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;
}

377 378 379
/* Dynamic irq helper functions */
extern void dynamic_irq_init(unsigned int irq);
extern void dynamic_irq_cleanup(unsigned int irq);
380

381
/* Set/get chip/data for an IRQ: */
382 383 384 385
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);
386
extern int set_irq_msi(unsigned int irq, struct msi_desc *entry);
387 388 389 390

#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)
391
#define get_irq_msi(irq)	(irq_desc[irq].msi_desc)
392

T
Thomas Gleixner 已提交
393
#endif /* CONFIG_GENERIC_HARDIRQS */
L
Linus Torvalds 已提交
394

395
#endif /* !CONFIG_S390 */
L
Linus Torvalds 已提交
396

397
#endif /* _LINUX_IRQ_H */