1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
/**
* @file irq.h
*
* This include file describe the data structure and the functions implemented
* by rtems to write interrupt handlers.
*/
/*
* RTEMS GBA BSP
*
* Copyright (c) 2004 Markku Puro <markku.puro@kopteri.net>
*
* The license and distribution terms for this file may be
* found in found in the file LICENSE in this distribution or at
* http://www.rtems.com/license/LICENSE.
*
* $Id$
*/
#ifndef _IRQ_H_
#define _IRQ_H_
#ifdef __cplusplus
extern "C" {
#endif
/*
* Include some preprocessor value also used by assember code
*/
#define VECTOR_TABLE (&irq_vector_table[0])
#include <stdint.h>
#include <rtems.h>
extern void default_int_handler();
/*---------------------------------------------------------------------------*
* MACROS *
*---------------------------------------------------------------------------*/
#define ENABLE_IRQ() GBA_REG_IME = 1;
#define DISABLE_IRQ() GBA_REG_IME = 0;
/*-------------------------------------------------------------------------+
| Constants
+--------------------------------------------------------------------------*/
typedef enum {
BSP_IRQ_VBLANK = 0,
BSP_IRQ_HBLANK = 1,
BSP_IRQ_VCOUNTER = 2,
BSP_IRQ_TIMER0 = 3,
BSP_IRQ_TIMER1 = 4,
BSP_IRQ_TIMER2 = 5,
BSP_IRQ_TIMER3 = 6,
BSP_IRQ_SERIAL = 7,
BSP_IRQ_DMA0 = 8,
BSP_IRQ_DMA1 = 9,
BSP_IRQ_DMA2 = 10,
BSP_IRQ_DMA3 = 11,
BSP_IRQ_KEY = 12,
BSP_IRQ_CART = 13,
BSP_IRQ_NA14 = 14,
BSP_IRQ_NA15 = 15,
BSP_MAX_INT = 16 /**< BSP_MAX_INT <= _irq_max_vector in linkcmds */
} rtems_irq_symbolic_name;
/*
* Type definition for RTEMS managed interrupts
*/
typedef unsigned char rtems_irq_level;
typedef unsigned char rtems_irq_trigger;
extern void _irq_max_vector; /**< defined in lincmds */
extern uint32_t irq_vector_table[BSP_MAX_INT]; /**< allocated in linkcmds */
struct __rtems_irq_connect_data__; /* forward declaratiuon */
typedef void (*rtems_irq_hdl) (void);
typedef void (*rtems_irq_enable) (const struct __rtems_irq_connect_data__*);
typedef void (*rtems_irq_disable) (const struct __rtems_irq_connect_data__*);
typedef int (*rtems_irq_is_enabled) (const struct __rtems_irq_connect_data__*);
/** irq connection data structure */
typedef struct __rtems_irq_connect_data__ {
/**
* IRQ line
*/
rtems_irq_symbolic_name name;
/**
* handler. See comment on handler properties below in function prototype.
*/
rtems_irq_hdl hdl;
/**
* function for enabling interrupts at device level (ONLY!).
* The BSP code will automatically enable it at PIC level.
* RATIONALE : anyway such code has to exist in current driver code.
* It is usually called immediately AFTER connecting the interrupt handler.
* RTEMS may well need such a function when restoring normal interrupt
* processing after a debug session.
*
*/
rtems_irq_enable on;
/**
* function for disabling interrupts at device level (ONLY!).
* The code will disable it at PIC level. RATIONALE : anyway
* such code has to exist for clean shutdown. It is usually called
* BEFORE disconnecting the interrupt. RTEMS may well need such
* a function when disabling normal interrupt processing for
* a debug session. May well be a NOP function.
*/
rtems_irq_disable off;
/**
* function enabling to know what interrupt may currently occur
* if someone manipulates the PIC interrupt mask without care...
*/
rtems_irq_is_enabled isOn;
/**
* irq priority level
*/
rtems_irq_level irqLevel;
/**
* Trigger way : Rising or falling edge or High or low level
*/
rtems_irq_trigger irqTrigger;
} rtems_irq_connect_data;
/*-------------------------------------------------------------------------+
| Function Prototypes.
+--------------------------------------------------------------------------*/
/*
* ------------------------ RTEMS Single Irq Handler Mngt Routines ----------------
*/
/**
* @brief function to initialize the interrupt for a specific BSP
*/
void BSP_rtems_irq_mngt_init();
/**
* @brief function to connect a particular irq handler.
* This hanlder will NOT be called directly as the result of the corresponding interrupt.
* Instead, a RTEMS irq prologue will be called that will :
* 1) save the C scratch registers,
* 2) switch to a interrupt stack if the interrupt is not nested,
* 3) store the current i8259s' interrupt masks
* 4) modify them to disable the current interrupt at 8259 level (and may
* be others depending on software priorities)
* 5) aknowledge the i8259s',
* 6) demask the processor,
* 7) call the application handler
*
* As a result the hdl function provided
* a) can perfectly be written is C,
* b) may also well directly call the part of the RTEMS API that can be used
* from interrupt level,
* c) It only responsible for handling the jobs that need to be done at
* the device level including (aknowledging/re-enabling the interrupt at device,
* level, getting the data,...)
*
* When returning from the function, the following will be performed by
* the RTEMS irq epilogue :
*
* 1) masks the interrupts again,
* 2) restore the original i8259s' interrupt masks
* 3) switch back on the orinal stack if needed,
* 4) perform rescheduling when necessary,
* 5) restore the C scratch registers...
* 6) restore initial execution flow
*
*/
int BSP_install_rtems_irq_handler (const rtems_irq_connect_data*);
/**
* function to get the current RTEMS irq handler for ptr->name. It enables to
* define hanlder chain...
*/
int BSP_get_current_rtems_irq_handler (rtems_irq_connect_data* ptr);
/**
* @brief function to get disconnect the RTEMS irq handler for ptr->name.
* This function checks that the value given is the current one for safety reason.
* The user can use the previous function to get it.
*/
int BSP_remove_rtems_irq_handler (const rtems_irq_connect_data*);
#ifdef __cplusplus
}
#endif
#endif /* _IRQ_H_ */
|
