source: rtems/c/src/lib/libbsp/arm/nds/libnds/include/nds/interrupts.h @ 311dfa6

4.104.114.9
Last change on this file since 311dfa6 was 311dfa6, checked in by Joel Sherrill <joel.sherrill@…>, on Apr 16, 2008 at 6:37:33 PM

2008-04-16 Matthieu Bucchianeri <mbucchia@…>

  • ChangeLog?, Makefile.am, README, bsp_specs, configure.ac, mk_libnds.sh, patch.libnds, preinstall.am, block/block.c, clock/clock.c, console/console.c, coproc/coproc.S, coproc/coproc.c, coproc/coproc.ld, dswifi/dswifi_license.txt, dswifi/makefile, dswifi/arm7/makefile, dswifi/arm7/source/wifi_arm7.c, dswifi/arm7/source/wifi_arm7.h, dswifi/arm9/makefile, dswifi/arm9/source/sgIP.c, dswifi/arm9/source/sgIP.h, dswifi/arm9/source/sgIP_ARP.c, dswifi/arm9/source/sgIP_ARP.h, dswifi/arm9/source/sgIP_Config.h, dswifi/arm9/source/sgIP_DHCP.c, dswifi/arm9/source/sgIP_DHCP.h, dswifi/arm9/source/sgIP_DNS.c, dswifi/arm9/source/sgIP_DNS.h, dswifi/arm9/source/sgIP_Hub.c, dswifi/arm9/source/sgIP_Hub.h, dswifi/arm9/source/sgIP_ICMP.c, dswifi/arm9/source/sgIP_ICMP.h, dswifi/arm9/source/sgIP_IP.c, dswifi/arm9/source/sgIP_IP.h, dswifi/arm9/source/sgIP_TCP.c, dswifi/arm9/source/sgIP_TCP.h, dswifi/arm9/source/sgIP_UDP.c, dswifi/arm9/source/sgIP_UDP.h, dswifi/arm9/source/sgIP_memblock.c, dswifi/arm9/source/sgIP_memblock.h, dswifi/arm9/source/sgIP_sockets.c, dswifi/arm9/source/sgIP_sockets.h, dswifi/arm9/source/wifi_arm9.c, dswifi/arm9/source/wifi_arm9.h, dswifi/common/source/dsregs.h, dswifi/common/source/spinlock.h, dswifi/common/source/spinlock.s, dswifi/common/source/wifi_shared.h, dswifi/include/dswifi7.h, dswifi/include/dswifi9.h, dswifi/include/dswifi_version.h, dswifi/include/netdb.h, dswifi/include/sgIP_errno.h, dswifi/include/netinet/in.h, fb/fb.c, fb/fb.h, include/bsp.h, include/my_ipc.h, include/tm27.h, include/types.h, include/sys/iosupport.h, irq/irq.c, irq/irq.h, libfat/gba/include/fat.h, libfat/include/fat.h, libfat/nds/include/fat.h, libfat/source/bit_ops.h, libfat/source/cache.c, libfat/source/cache.h, libfat/source/common.h, libfat/source/directory.c, libfat/source/directory.h, libfat/source/fatdir.c, libfat/source/fatdir.h, libfat/source/fatfile.c, libfat/source/fatfile.h, libfat/source/file_allocation_table.c, libfat/source/file_allocation_table.h, libfat/source/filetime.c, libfat/source/filetime.h, libfat/source/libfat.c, libfat/source/mem_allocate.h, libfat/source/partition.c, libfat/source/partition.h, libfat/source/disc_io/disc.c, libfat/source/disc_io/disc.h, libfat/source/disc_io/disc_io.h, libfat/source/disc_io/io_cf_common.c, libfat/source/disc_io/io_cf_common.h, libfat/source/disc_io/io_dldi.h, libfat/source/disc_io/io_dldi.s, libfat/source/disc_io/io_efa2.c, libfat/source/disc_io/io_efa2.h, libfat/source/disc_io/io_fcsr.c, libfat/source/disc_io/io_fcsr.h, libfat/source/disc_io/io_m3_common.c, libfat/source/disc_io/io_m3_common.h, libfat/source/disc_io/io_m3cf.c, libfat/source/disc_io/io_m3cf.h, libfat/source/disc_io/io_m3sd.c, libfat/source/disc_io/io_m3sd.h, libfat/source/disc_io/io_mpcf.c, libfat/source/disc_io/io_mpcf.h, libfat/source/disc_io/io_njsd.c, libfat/source/disc_io/io_njsd.h, libfat/source/disc_io/io_nmmc.c, libfat/source/disc_io/io_nmmc.h, libfat/source/disc_io/io_sc_common.c, libfat/source/disc_io/io_sc_common.h, libfat/source/disc_io/io_sccf.c, libfat/source/disc_io/io_sccf.h, libfat/source/disc_io/io_scsd.c, libfat/source/disc_io/io_scsd.h, libfat/source/disc_io/io_scsd_s.s, libfat/source/disc_io/io_sd_common.c, libfat/source/disc_io/io_sd_common.h, libnds/Makefile.arm7, libnds/Makefile.arm9, libnds/libnds_license.txt, libnds/basicARM7/source/defaultARM7.c, libnds/include/default_font_bin.h, libnds/include/gbfs.h, libnds/include/nds.h, libnds/include/nds/bios.h, libnds/include/nds/card.h, libnds/include/nds/dma.h, libnds/include/nds/interrupts.h, libnds/include/nds/ipc.h, libnds/include/nds/jtypes.h, libnds/include/nds/memory.h, libnds/include/nds/registers_alt.h, libnds/include/nds/reload.h, libnds/include/nds/system.h, libnds/include/nds/timers.h, libnds/include/nds/arm7/audio.h, libnds/include/nds/arm7/clock.h, libnds/include/nds/arm7/serial.h, libnds/include/nds/arm7/touch.h, libnds/include/nds/arm9/background.h, libnds/include/nds/arm9/boxtest.h, libnds/include/nds/arm9/cache.h, libnds/include/nds/arm9/console.h, libnds/include/nds/arm9/exceptions.h, libnds/include/nds/arm9/image.h, libnds/include/nds/arm9/input.h, libnds/include/nds/arm9/math.h, libnds/include/nds/arm9/ndsmotion.h, libnds/include/nds/arm9/pcx.h, libnds/include/nds/arm9/postest.h, libnds/include/nds/arm9/rumble.h, libnds/include/nds/arm9/sound.h, libnds/include/nds/arm9/sprite.h, libnds/include/nds/arm9/trig_lut.h, libnds/include/nds/arm9/video.h, libnds/include/nds/arm9/videoGL.h, libnds/source/arm7/audio.c, libnds/source/arm7/clock.c, libnds/source/arm7/microphone.c, libnds/source/arm7/spi.c, libnds/source/arm7/touch.c, libnds/source/arm7/userSettings.c, libnds/source/arm9/COS.bin, libnds/source/arm9/COS.s, libnds/source/arm9/SIN.bin, libnds/source/arm9/SIN.s, libnds/source/arm9/TAN.bin, libnds/source/arm9/TAN.s, libnds/source/arm9/boxtest.c, libnds/source/arm9/console.c, libnds/source/arm9/dcache.s, libnds/source/arm9/default_font.bin, libnds/source/arm9/default_font.s, libnds/source/arm9/exceptionHandler.S, libnds/source/arm9/exceptionHandler.s, libnds/source/arm9/exceptions.c, libnds/source/arm9/gurumeditation.c, libnds/source/arm9/icache.s, libnds/source/arm9/image.c, libnds/source/arm9/initSystem.c, libnds/source/arm9/keys.c, libnds/source/arm9/ndsmotion.c, libnds/source/arm9/pcx.c, libnds/source/arm9/rumble.c, libnds/source/arm9/sound.c, libnds/source/arm9/system.c, libnds/source/arm9/touch.c, libnds/source/arm9/video.c, libnds/source/arm9/videoGL.c, libnds/source/common/biosCalls.s, libnds/source/common/card.c, libnds/source/common/gbfs.c, libnds/source/common/interruptDispatcher.s, libnds/source/common/interrupts.c, rtc/rtc.c, sound/sound.c, sound/sound.h, start/start.S, startup/linkcmds, startup/start.c, timer/timer.c, tools/Makefile.am, tools/bin2s, tools/bin2s.c, tools/configure.ac, tools/runtest, tools/ndstool/include/arm7_sha1_homebrew.h, tools/ndstool/include/arm7_sha1_nintendo.h, tools/ndstool/include/banner.h, tools/ndstool/include/bigint.h, tools/ndstool/include/crc.h, tools/ndstool/include/default_icon.h, tools/ndstool/include/encryption.h, tools/ndstool/include/header.h, tools/ndstool/include/hook.h, tools/ndstool/include/little.h, tools/ndstool/include/loadme.h, tools/ndstool/include/logo.h, tools/ndstool/include/ndscreate.h, tools/ndstool/include/ndsextract.h, tools/ndstool/include/ndstool.h, tools/ndstool/include/ndstree.h, tools/ndstool/include/overlay.h, tools/ndstool/include/passme.h, tools/ndstool/include/passme_sram.h, tools/ndstool/include/passme_vhd1.h, tools/ndstool/include/passme_vhd2.h, tools/ndstool/include/raster.h, tools/ndstool/include/sha1.h, tools/ndstool/include/types.h, tools/ndstool/source/arm7_sha1_homebrew.c, tools/ndstool/source/arm7_sha1_nintendo.c, tools/ndstool/source/banner.cpp, tools/ndstool/source/bigint.cpp, tools/ndstool/source/compile_date.c, tools/ndstool/source/crc.cpp, tools/ndstool/source/default_icon.c, tools/ndstool/source/encryption.cpp, tools/ndstool/source/header.cpp, tools/ndstool/source/hook.cpp, tools/ndstool/source/loadme.c, tools/ndstool/source/logo.cpp, tools/ndstool/source/ndscodes.cpp, tools/ndstool/source/ndscreate.cpp, tools/ndstool/source/ndsextract.cpp, tools/ndstool/source/ndstool.cpp, tools/ndstool/source/ndstree.cpp, tools/ndstool/source/passme.cpp, tools/ndstool/source/passme_sram.c, tools/ndstool/source/raster.cpp, tools/ndstool/source/sha1.cpp, touchscreen/README.reco, touchscreen/parser.c, touchscreen/reco.c, touchscreen/reco.h, touchscreen/touchscreen.c, touchscreen/touchscreen.h, wifi/compat.c, wifi/compat.h, wifi/wifi.c: New files.
  • Property mode set to 100644
File size: 6.2 KB
Line 
1/*---------------------------------------------------------------------------------
2        $Id$
3
4        Interrupt registers and vector pointers
5
6        Copyright (C) 2005
7                Jason Rogers (dovoto)
8                Dave Murphy (WinterMute)
9
10        This software is provided 'as-is', without any express or implied
11        warranty.  In no event will the authors be held liable for any
12        damages arising from the use of this software.
13
14        Permission is granted to anyone to use this software for any
15        purpose, including commercial applications, and to alter it and
16        redistribute it freely, subject to the following restrictions:
17
18        1.      The origin of this software must not be misrepresented; you
19                must not claim that you wrote the original software. If you use
20                this software in a product, an acknowledgment in the product
21                documentation would be appreciated but is not required.
22
23        2.      Altered source versions must be plainly marked as such, and
24                must not be misrepresented as being the original software.
25
26        3.      This notice may not be removed or altered from any source
27                distribution.
28
29
30---------------------------------------------------------------------------------*/
31
32/*! \file interrupts.h
33
34    \brief nds interrupt support.
35
36*/
37
38#ifndef NDS_INTERRUPTS_INCLUDE
39#define NDS_INTERRUPTS_INCLUDE
40
41#include <nds/jtypes.h>
42
43/*! \enum IRQ_MASKS
44        \brief values allowed for REG_IE and REG_IF
45
46*/
47enum IRQ_MASKS {
48        IRQ_VBLANK                      =       BIT(0),         /*!< vertical blank interrupt mask */
49        IRQ_HBLANK                      =       BIT(1),         /*!< horizontal blank interrupt mask */
50        IRQ_VCOUNT                      =       BIT(2),         /*!< vcount match interrupt mask */
51        IRQ_TIMER0                      =       BIT(3),         /*!< timer 0 interrupt mask */
52        IRQ_TIMER1                      =       BIT(4),         /*!< timer 1 interrupt mask */
53        IRQ_TIMER2                      =       BIT(5),         /*!< timer 2 interrupt mask */
54        IRQ_TIMER3                      =       BIT(6),         /*!< timer 3 interrupt mask */
55        IRQ_NETWORK                     =       BIT(7),         /*!< serial interrupt mask */
56        IRQ_DMA0                        =       BIT(8),         /*!< DMA 0 interrupt mask */
57        IRQ_DMA1                        =       BIT(9),         /*!< DMA 1 interrupt mask */
58        IRQ_DMA2                        =       BIT(10),        /*!< DMA 2 interrupt mask */
59        IRQ_DMA3                        =       BIT(11),        /*!< DMA 3 interrupt mask */
60        IRQ_KEYS                        =       BIT(12),        /*!< Keypad interrupt mask */
61        IRQ_CART                        =       BIT(13),        /*!< GBA cartridge interrupt mask */
62        IRQ_IPC_SYNC            =       BIT(16),        /*!< IPC sync interrupt mask */
63        IRQ_FIFO_EMPTY          =       BIT(17),        /*!< Send FIFO empty interrupt mask */
64        IRQ_FIFO_NOT_EMPTY      =       BIT(18),        /*!< Receive FIFO empty interrupt mask */
65        IRQ_CARD                        =       BIT(19),        /*!< interrupt mask */
66        IRQ_CARD_LINE           =       BIT(20),        /*!< interrupt mask */
67        IRQ_GEOMETRY_FIFO       =       BIT(21),        /*!< geometry FIFO interrupt mask */
68        IRQ_LID                         =       BIT(22),        /*!< interrupt mask */
69        IRQ_SPI                         =       BIT(23),        /*!< SPI interrupt mask */
70        IRQ_WIFI                        =       BIT(24),        /*!< WIFI interrupt mask (ARM7)*/
71        IRQ_ALL                         =       (~0)
72};
73
74#define MAX_INTERRUPTS  25
75
76typedef enum IRQ_MASKS IRQ_MASK;
77
78/*! \def REG_IE
79
80    \brief Interrupt Enable Register.
81
82        This is the activation mask for the internal interrupts.  Unless
83        the corresponding bit is set, the IRQ will be masked out.
84*/
85#define REG_IE  (*(vuint32*)0x04000210)
86
87/*! \def REG_IF
88
89    \brief Interrupt Flag Register.
90
91        Since there is only one hardware interrupt vector, the IF register
92        contains flags to indicate when a particular of interrupt has occured.
93        To acknowledge processing interrupts, set IF to the value of the
94        interrupt handled.
95
96*/
97#define REG_IF  (*(vuint32*)0x04000214)
98
99/*! \def REG_IME
100
101    \brief Interrupt Master Enable Register.
102
103        When bit 0 is clear, all interrupts are masked.  When it is 1,
104        interrupts will occur if not masked out in REG_IE.
105
106*/
107#define REG_IME (*(vuint16*)0x04000208)
108
109/*! \enum IME_VALUE
110        \brief values allowed for REG_IME
111*/
112enum IME_VALUE {
113        IME_DISABLE = 0,        /*!< Disable all interrupts. */
114        IME_ENABLE = 1, /*!< Enable all interrupts not masked out in REG_IE */
115};
116
117
118#ifdef __cplusplus
119extern "C" {
120#endif
121
122
123extern VoidFunctionPointer      __irq_vector[];
124extern  vuint32 __irq_flags[];
125#define VBLANK_INTR_WAIT_FLAGS  *(__irq_flags)
126#define IRQ_HANDLER             *(__irq_vector)
127
128struct IntTable{IntFn handler; u32 mask;};
129
130/*! \fn irqInit()
131        \brief Initialise the libnds interrupt system.
132
133        Call this function at the start of any application which requires interrupt support.
134        This function should be used in preference to irqInitHandler.
135         
136*/
137void irqInit();
138/*! \fn irqSet(IRQ_MASK irq, VoidFunctionPointer handler)
139        \brief Add a handler for the given interrupt mask.
140
141        Specify the handler to use for the given interrupt. This only works with
142        the default interrupt handler, do not mix the use of this routine with a
143        user-installed IRQ handler.
144        \param irq Mask associated with the interrupt.
145        \param handler Address of the function to use as an interrupt service routine
146        \note
147        When any handler specifies using IRQ_VBLANK or IRQ_HBLANK, DISP_SR
148        is automatically updated to include the corresponding DISP_VBLANK_IRQ or DISP_HBLANK_IRQ.
149
150        \warning Only one IRQ_MASK can be specified with this function.
151*/
152void irqSet(IRQ_MASK irq, VoidFunctionPointer handler);
153/*! \fn irqClear(IRQ_MASK irq)
154        \brief remove the handler associated with the interrupt mask irq.
155        \param irq Mask associated with the interrupt.
156*/
157void irqClear(IRQ_MASK irq);
158/*! \fn irqInitHandler(VoidFunctionPointer handler)
159        \brief Install a user interrupt dispatcher.
160
161        This function installs the main interrupt function, all interrupts are serviced through this routine. For most
162        purposes the libnds interrupt dispacther should be used in preference to user code unless you know *exactly* what you're doing.
163       
164        \param handler Address of the function to use as an interrupt dispatcher
165        \note the function *must* be ARM code
166*/
167void irqInitHandler(VoidFunctionPointer handler);
168/*! \fn irqEnable(uint32 irq)
169        \brief Allow the given interrupt to occur.
170        \param irq The set of interrupt masks to enable.
171        \note Specify multiple interrupts to enable by ORing several IRQ_MASKS.
172*/
173void irqEnable(uint32 irq);
174/*! \fn irqDisable(uint32 irq)
175        \brief Prevent the given interrupt from occuring.
176        \param irq The set of interrupt masks to disable.
177        \note Specify multiple interrupts to disable by ORing several IRQ_MASKS.
178*/
179void irqDisable(uint32 irq);
180
181
182#ifdef __cplusplus
183}
184#endif
185
186#endif //NDS_INTERRUPTS_INCLUDE
187
Note: See TracBrowser for help on using the repository browser.