HelenOS/USB: doxygen-tmp/development_branch/uspace/lib/drv/include/ddf/interrupt.h Source File

00001 /*
00002  * Copyright (c) 2010 Lenka Trochtova
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions
00007  * are met:
00008  *
00009  * - Redistributions of source code must retain the above copyright
00010  *   notice, this list of conditions and the following disclaimer.
00011  * - Redistributions in binary form must reproduce the above copyright
00012  *   notice, this list of conditions and the following disclaimer in the
00013  *   documentation and/or other materials provided with the distribution.
00014  * - The name of the author may not be used to endorse or promote products
00015  *   derived from this software without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
00018  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
00019  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
00020  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
00021  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
00022  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
00023  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
00024  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
00025  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
00026  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00027  */
00028 
00035 #ifndef DDF_INTERRUPT_H_
00036 #define DDF_INTERRUPT_H_
00037 
00038 #include <kernel/ddi/irq.h>
00039 #include <adt/list.h>
00040 #include <ddi.h>
00041 #include <fibril_synch.h>
00042 
00043 #include "driver.h"
00044 #include "../dev_iface.h"
00045 
00046 /*
00047  * Interrupts
00048  */
00049 
00050 typedef void interrupt_handler_t(ddf_dev_t *, ipc_callid_t, ipc_call_t *);
00051 
00052 typedef struct interrupt_context {
00053         int id;
00054         ddf_dev_t *dev;
00055         int irq;
00056         interrupt_handler_t *handler;
00057         link_t link;
00058 } interrupt_context_t;
00059 
00060 typedef struct interrupt_context_list {
00061         int curr_id;
00062         link_t contexts;
00063         fibril_mutex_t mutex;
00064 } interrupt_context_list_t;
00065 
00066 extern interrupt_context_t *create_interrupt_context(void);
00067 extern void delete_interrupt_context(interrupt_context_t *);
00068 extern void init_interrupt_context_list(interrupt_context_list_t *);
00069 extern void add_interrupt_context(interrupt_context_list_t *,
00070     interrupt_context_t *);
00071 extern void remove_interrupt_context(interrupt_context_list_t *,
00072     interrupt_context_t *);
00073 extern interrupt_context_t *find_interrupt_context_by_id(
00074     interrupt_context_list_t *, int);
00075 extern interrupt_context_t *find_interrupt_context(
00076     interrupt_context_list_t *, ddf_dev_t *, int);
00077 
00078 extern int register_interrupt_handler(ddf_dev_t *, int, interrupt_handler_t *,
00079     irq_code_t *);
00080 extern int unregister_interrupt_handler(ddf_dev_t *, int);
00081 
00082 #endif
00083