WebSVN – HelenOS – Blame – /trunk/kernel/generic/include/ddi/irq.h/

Rev	Author	Line No.	Line
1919	jermar	1	/*
2071	jermar	2	* Copyright (c) 2006 Jakub Jermar
1919	jermar	3	* All rights reserved.
		4	*
		5	* Redistribution and use in source and binary forms, with or without
		6	* modification, are permitted provided that the following conditions
		7	* are met:
		8	*
		9	* - Redistributions of source code must retain the above copyright
		10	* notice, this list of conditions and the following disclaimer.
		11	* - Redistributions in binary form must reproduce the above copyright
		12	* notice, this list of conditions and the following disclaimer in the
		13	* documentation and/or other materials provided with the distribution.
		14	* - The name of the author may not be used to endorse or promote products
		15	* derived from this software without specific prior written permission.
		16	*
		17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
		18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
		19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
		20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
		21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
		22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
		23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
		24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
		25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
		26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
		27	*/
		28
1920	jermar	29	/** @addtogroup genericddi
1919	jermar	30	* @{
		31	*/
		32	/** @file
		33	*/
		34
		35	#ifndef KERN_IRQ_H_
		36	#define KERN_IRQ_H_
		37
2089	decky	38	typedef enum {
		39	CMD_MEM_READ_1 = 0,
		40	CMD_MEM_READ_2,
		41	CMD_MEM_READ_4,
		42	CMD_MEM_READ_8,
		43	CMD_MEM_WRITE_1,
		44	CMD_MEM_WRITE_2,
		45	CMD_MEM_WRITE_4,
		46	CMD_MEM_WRITE_8,
		47	CMD_PORT_READ_1,
		48	CMD_PORT_WRITE_1,
		49	CMD_IA64_GETCHAR,
		50	CMD_PPC32_GETCHAR,
		51	CMD_LAST
		52	} irq_cmd_type;
		53
		54	typedef struct {
		55	irq_cmd_type cmd;
		56	void *addr;
		57	unsigned long long value;
		58	int dstarg;
		59	} irq_cmd_t;
		60
		61	typedef struct {
		62	unsigned int cmdcount;
		63	irq_cmd_t *cmds;
		64	} irq_code_t;
		65
		66	#ifdef KERNEL
		67
1919	jermar	68	#include <arch/types.h>
		69	#include <adt/list.h>
1921	jermar	70	#include <synch/spinlock.h>
2089	decky	71	#include <proc/task.h>
1919	jermar	72
		73	typedef enum {
		74	IRQ_DECLINE, /*< Decline to service. /
		75	IRQ_ACCEPT /*< Accept to service. /
		76	} irq_ownership_t;
		77
		78	typedef enum {
		79	IRQ_TRIGGER_LEVEL = 1,
		80	IRQ_TRIGGER_EDGE
		81	} irq_trigger_t;
		82
2089	decky	83	struct irq;
		84	typedef void (* irq_handler_t)(struct irq irq, void arg, ...);
1919	jermar	85
3655	jermar	86	/** Type for function used to clear the interrupt. */
		87	typedef void (* cir_t)(void *arg, inr_t inr);
		88
2089	decky	89	/** IPC notification config structure.
		90	*
		91	* Primarily, this structure is encapsulated in the irq_t structure.
		92	* It is protected by irq_t::lock.
		93	*/
		94	typedef struct {
2106	jermar	95	/** When false, notifications are not sent. */
		96	bool notify;
		97	/** Answerbox for notifications. */
		98	answerbox_t *answerbox;
		99	/** Method to be used for the notification. */
		100	unative_t method;
		101	/** Top-half pseudocode. */
		102	irq_code_t *code;
		103	/** Counter. */
		104	count_t counter;
		105	/**
		106	* Link between IRQs that are notifying the same answerbox. The list is
		107	* protected by the answerbox irq_lock.
		108	*/
		109	link_t link;
2089	decky	110	} ipc_notif_cfg_t;
		111
1919	jermar	112	/** Structure representing one device IRQ.
		113	*
2106	jermar	114	* If one device has multiple interrupts, there will be multiple irq_t
		115	* instantions with the same devno.
1919	jermar	116	*/
2089	decky	117	typedef struct irq {
1919	jermar	118	/** Hash table link. */
		119	link_t link;
		120
1921	jermar	121	/** Lock protecting everything in this structure
		122	* except the link member. When both the IRQ
		123	* hash table lock and this lock are to be acquired,
		124	* this lock must not be taken first.
		125	*/
		126	SPINLOCK_DECLARE(lock);
2218	decky	127
		128	/** Send EOI before processing the interrupt.
		129	* This is essential for timer interrupt which
		130	* has to be acknowledged before doing preemption
		131	* to make sure another timer interrupt will
		132	* be eventually generated.
		133	*/
		134	bool preack;
1921	jermar	135
1919	jermar	136	/** Unique device number. -1 if not yet assigned. */
		137	devno_t devno;
		138
		139	/** Actual IRQ number. -1 if not yet assigned. */
		140	inr_t inr;
2218	decky	141	/** Trigger level of the IRQ. */
1919	jermar	142	irq_trigger_t trigger;
		143	/** Claim ownership of the IRQ. */
		144	irq_ownership_t (* claim)(void);
		145	/** Handler for this IRQ and device. */
		146	irq_handler_t handler;
		147	/** Argument for the handler. */
		148	void *arg;
1921	jermar	149
3655	jermar	150	/** Clear interrupt routine. */
		151	cir_t cir;
		152	/** First argument to the clear interrupt routine. */
		153	void *cir_arg;
		154
1923	jermar	155	/** Notification configuration structure. */
		156	ipc_notif_cfg_t notif_cfg;
2089	decky	157	} irq_t;
1919	jermar	158
		159	extern void irq_init(count_t inrs, count_t chains);
		160	extern void irq_initialize(irq_t *irq);
		161	extern void irq_register(irq_t *irq);
1922	jermar	162	extern irq_t *irq_dispatch_and_lock(inr_t inr);
		163	extern irq_t *irq_find_and_lock(inr_t inr, devno_t devno);
1919	jermar	164
		165	#endif
		166
2089	decky	167	#endif
		168
1919	jermar	169	/** @}
		170	*/

Subversion Repositories HelenOS

(root)/trunk/kernel/generic/include/ddi/irq.h/ – Rev 3655