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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
|
/*
* The authors hereby grant permission to use, copy, modify, distribute,
* and license this software and its documentation for any purpose, provided
* that existing copyright notices are retained in all copies and that this
* notice is included verbatim in any distributions. No written agreement,
* license, or royalty fee is required for any of the authorized uses.
* Modifications to this software may be copyrighted by their authors
* and need not follow the licensing terms described here, provided that
* the new terms are clearly indicated on the first page of each file where
* they apply.
*/
#pragma once
#ifndef __NO_BUILTIN
#pragma system_header /* exception.h */
#endif
/************************************************************************
*
* exception.h
*
* (c) Copyright 2001-2008 Analog Devices, Inc. All rights reserved.
*
************************************************************************/
#ifndef _EXCEPTION_H
#define _EXCEPTION_H
#ifdef _MISRA_RULES
#pragma diag(push)
#pragma diag(suppress:misra_rule_5_6)
#pragma diag(suppress:misra_rule_5_7)
#pragma diag(suppress:misra_rule_6_3)
#pragma diag(suppress:misra_rule_19_4)
#pragma diag(suppress:misra_rule_19_7)
#pragma diag(suppress:misra_rule_19_10)
#pragma diag(suppress:misra_rule_19_13)
#endif /* _MISRA_RULES */
/*
** Definitions for user-friendly interrupt handling.
*/
/*
** Memory-Mapped Registers (MMRs) - these record what causes address
** exceptions.
*/
#define EX_DATA_FAULT_STATUS 0xFFE00008
#define EX_DATA_FAULT_ADDR 0xFFE0000C
#define EX_CODE_FAULT_STATUS 0xFFE01008
#define EX_CODE_FAULT_ADDR 0xFFE0100C
/*
** Event Vector Table
*/
#define EX_EVENT_VECTOR_TABLE 0xFFE02000
/*
** Meaning of the various bits in EXCAUSE field in SEQSTAT register.
*/
#define EX_BITS 0x3F /* All EXCAUSE bits */
#define EX_TYPE 0x30 /* The bits which define the type */
#define EX_DEBUG 0x10 /* If set, is a debug exception type */
#define EX_SYS 0x20 /* If set, is a system exception type */
/* If neither set, is from EXCPT instr */
#define EX_IS_DEBUG_EXCEPTION(E) (((E)&EX_TYPE)==EX_DEBUG)
#define EX_IS_SYSTEM_EXCEPTION(E) (((E)&EX_TYPE)==EX_SYS)
#define EX_IS_USER_EXCEPTION(E) (((E)&EX_TYPE)==0)
/*
** Service exceptions continue from the instruction after the one
** that raised the exception.
** Error exceptions restart the instruction that raised the exception.
*/
#define EX_IS_SERVICE_EXCEPTION(E) (!EX_IS_SYSTEM_EXCEPTION(E))
#define EX_IS_ERROR_EXCEPTION(E) (EX_IS_SYSTEM_EXCEPTION(E))
#define EX_DB_SINGLE_STEP 0x10 /* Processor is single-stepping */
#define EX_DB_EMTRCOVRFLW 0x11 /* Emulation Trace buffer overflowed */
#define EX_SYS_UNDEFINSTR 0x21 /* Undefined instruction */
#define EX_SYS_ILLINSTRC 0x22 /* Illegal instruction combination */
#define EX_SYS_DCPLBPROT 0x23 /* Data CPLB Protection violation */
#define EX_SYS_DALIGN 0x24 /* Data access misaligned address violation */
#define EX_SYS_UNRECEVT 0x25 /* Unrecoverable event */
#define EX_SYS_DCPLBMISS 0x26 /* Data access CPLB Miss */
#define EX_SYS_DCPLBMHIT 0x27 /* Data access CPLB Multiple Hits */
#define EX_SYS_EMWATCHPT 0x28 /* Emulation watch point match */
#define EX_SYS_CACCESSEX 0x29 /* Code fetch access exception */
#define EX_SYS_CALIGN 0x2A /* Attempted misaligned instr cache fetch */
#define EX_SYS_CCPLBPROT 0x2B /* Code fetch CPLB Protection */
#define EX_SYS_CCPLBMISS 0x2C /* CPLB miss on an instruction fetch */
#define EX_SYS_CCPLBMHIT 0x2D /* Code fetch CPLB Multiple Hits */
#define EX_SYS_ILLUSESUP 0x2E /* Illegal use of Supervisor Resource */
/*
** Meaning of the various bits in HWERRCAUSE in SEQSTAT
*/
#define EX_HWBITS (0x1F<<14) /* bits 18:14 */
#if !defined(__ADSPLPBLACKFIN__)
#define EX_HW_NOMEM1 (0x16<<14)
#define EX_HW_NOMEM2 (0x17<<14)
#else
#define EX_HW_SYSMMR (0x02<<14)
#define EX_HW_EXTMEM (0x03<<14)
#endif
#define EX_HW_DMAHIT (0x01<<14)
#define EX_HW_PERFMON (0x12<<14)
#define EX_HW_RAISE (0x18<<14)
/*
** Meaning of the bits in DATA_FAULT_STATUS and CODE_FAULT_STATUS
*/
#define EX_DATA_FAULT_ILLADDR (1<<19) /* non-existent memory */
#define EX_DATA_FAULT_DAG (1<<18) /* 0=>DAG0, 1=>DAG1 */
#define EX_DATA_FAULT_USERSUPV (1<<17) /* 0=>user mode, 1=> supervisor */
#define EX_DATA_FAULT_READWRITE (1<<16) /* 0=>read, 1=>write */
#define EX_DATA_FAULT_CPLB 0xFFFF /* 0=>CPLB0, 1=>CPLB1, etc */
#define EX_CODE_FAULT_ILLADDR (1<<19) /* non-existent memory */
#define EX_CODE_FAULT_USERSUPV (1<<17) /* 0=>user mode, 1=> supervisor */
#define EX_CODE_FAULT_CPLB 0xFFFF /* 0=>CPLB0, 1=>CPLB1, etc */
/*
** The kinds of interrupt that can occur. These are also the
** indices into the Event Vector Table.
*/
#ifdef __cplusplus
extern "C" {
#endif
typedef enum {
ik_err=-1,
ik_emulation,
ik_reset,
ik_nmi,
ik_exception,
ik_global_int_enable,
ik_hardware_err,
ik_timer,
ik_ivg7,
ik_ivg8,
ik_ivg9,
ik_ivg10,
ik_ivg11,
ik_ivg12,
ik_ivg13,
ik_ivg14,
ik_ivg15,
num_interrupt_kind
} interrupt_kind;
/*
** Structure for recording details of an exception or interrupt
** that has occurred.
*/
typedef struct {
interrupt_kind kind; /* whether interrupt, exception, etc. */
int value; /* interrupt number, exception type, etc. */
void *pc; /* PC at point where exception occurred */
void *addr; /* if an address faulted, which one. */
unsigned status; /* if an address faulted, why. */
} interrupt_info;
/*
** Macro for defining an interrupt routine
*/
typedef void (*ex_handler_fn)();
#define EX_HANDLER(KIND,NAME) \
_Pragma(#KIND) \
void NAME (void)
#define EX_HANDLER_PROTO(KIND, NAME) EX_HANDLER(KIND, NAME)
#define EX_INTERRUPT_HANDLER(NAME) EX_HANDLER(interrupt,NAME)
#define EX_EXCEPTION_HANDLER(NAME) EX_HANDLER(exception,NAME)
#define EX_NMI_HANDLER(NAME) EX_HANDLER(nmi,NAME)
#define EX_REENTRANT_HANDLER(NAME) \
_Pragma("interrupt_reentrant") \
EX_HANDLER(interrupt,NAME)
/*
** A convenience function for setting up the interrupt_info contents.
** Must be called from immediately with the interrupt handler.
*/
void get_interrupt_info(interrupt_kind int_kind, interrupt_info *int_info);
/*
** Diagnostics function for reporting unexpected events.
*/
void _ex_report_event(interrupt_info *int_info);
/*
** Register an interrupt handler within the EVT.
** Return previous value if there was one.
*/
ex_handler_fn register_handler(interrupt_kind int_kind, ex_handler_fn handler);
/*
** Some magic values for registering default and null handlers.
*/
#define EX_INT_DEFAULT ((ex_handler_fn)-1)
#define EX_INT_IGNORE ((ex_handler_fn)0)
/*
** Extended function to register an interrupt handler within the EVT.
** Returns the old handler.
**
** If enabled == EX_INT_ALWAYS_ENABLE, install fn (if fn != EX_INT_IGNORE
** and fn != EX_INT_DISABLE), and then enable the interrupt in IMASK then
** return
**
** If fn == EX_INT_IGNORE, disable the interrupt
** If fn == EX_INT_DEFAULT, delete the handler entry in the EVT and disable
** the interrupt in IMASK
** Otherwise, install the new interrupt handler. Then,
** If enabled == EX_INT_DISABLE, disable the interrupt in IMASK
** If enabled == EX_INT_ENABLE, enable the interrupt in IMASK
** otherwise leave the interrupt status alone.
*/
ex_handler_fn register_handler_ex(interrupt_kind kind, ex_handler_fn fn,
int enable);
/* Constants for the enabled parameter of register_handler_ex */
#define EX_INT_DISABLE 0
#define EX_INT_ENABLE 1
#define EX_INT_KEEP_IMASK -1
#define EX_INT_ALWAYS_ENABLE 2
/*
** Allow the user to raise exceptions from C.
*/
int raise_interrupt(interrupt_kind kind, int which,
int cmd, int arg1, int arg2);
#ifdef __cplusplus
} /* extern "C" */
#endif
#ifdef _MISRA_RULES
#pragma diag(pop)
#endif /* _MISRA_RULES */
#endif /* _EXCEPTION_H */
|
