T-Kernel Specification (1.B0.02)

4.8. INTERRUPT MANAGEMENT FUNCTIONS 185
tk def int
Define Interrupt Handler
[C Language Interface]
ER ercd = tk_def_int ( UINT dintno, T_DINT *pk_dint ) ;
[Parameters]
UINT dintno Interrupt definition number
T DINT* pk dint Packet of interrupt handler definition information
pk dint detail:
ATR intatr Interrupt handler attributes
FP inthdr Interrupt handler address
(Other implementation-dependent parameters may be added beyond this point.)
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E NOMEM
E RSATR
E PAR
Normal completion
Insufficient memory (memory for control block cannot be allocated)
Reserved attribute (intatr is invalid or cannot be used)
Parameter error (dintno, pk dint, or inthdr is invalid or cannot be used)
[Description]
Defines an interrupt handler for interrupt definition number dintno, and enables use of the interrupt
handler. Here “interrupts” include both external interrupts from a device and CPU exceptions.
This system call maps the interrupt definition number indicated in dintno to the interrupt handler
address and attributes.
The specific significance of dintno is defined separately for each implementation, but generally it means
an interrupt vector number.
intatr indicates system attributes in its low bits, with the high bits used for implementation-dependent
attributes. The system attributes part of intatr is designated in the following format.
intatr := (TA_ASM || TA_HLNG)
TA ASM
TA HLNG
The handler is written in assembly language
The handler is written in high-level language
#define TA_ASM 0x00000000 /* assembly program */
#define TA_HLNG 0x00000001 /* high-level language program */
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02