CF2 API Reference (PDF) - Persistor Instruments Inc

CF2 API ReferenceInterrupt and Exception Vector Wrapper FunctionsIEV_C_FUNCT -- Define C Interrupt Handler FunctionDescription:This is a macro function provided for declaring a function that you wish to install as an interruptor exception handling routineIEV_C_PROTO -- Declare C Interrupt Handler Function PrototypeDescription:Example:This is a macro provided for prototyping a function that you wish to install as an exception orinterrupt service routine written in C.IEV_C_PROTO(level7InterruptISR);IEV_C_FUNCT(level7InterruptISR){// your ISR code written in C...}IEVInsertAsmFunct -- Install an assembler function into the VBRDescription:Prototype:Inputs:Returns:This function allows you to install an interrupt or exception handler written in 68332 assemblylanguage into the vector table. This varies from the IEVInsertCFunct in that it assumes that thecalling and return conventions for interrupt and exception handling have already been usedwhen the function was written. It is not necessary to use the C handler definition macros(IEV_C_PROTO and IEV_C_FUNCT) when creating an assembly function as an interrupt orexception handler. It is assumed that you know how to write these handlers when using thisfunction. You would also use this function to reinstall a previously de-installed interrupt orexception handler whose pointer was returned by a previous call to IEVInsertCFunct orIEVInsertAsmFunct call.vfptr IEVInsertAsmFunct(vfptr afp, short vector);afp is the pointer to the assembly routine you wish to install.vector is the vector table "slot number" you wish to install this ISR into. (see the CPU32documentation for more info on the vector table)Returns a pointer to the function that was previously installed in the target slot so that you canrestore it later if you so desire.IEVInsertCFunct -- Install a C function into the vector tableDescription:Prototype:Inputs:Returns:This function allows you to install an interrupt or exception handler written in C into the vectortable. You must first prototype and declare the function using the IEV_C_PROTO andIEV_C_FUNCT macros. Normally a C compiler will return from a function using a 68000 RTSinstruction, but it an interrupt or exception handler must return with an RTE instruction to avoidcausing havoc with the registers and the stack. This is provided for with the aforementionedmacros provided.vfptr IEVInsertCFunct(IEVCWrapper *cfp, short vector);cfp is the name of the function you wish to install. It mast have been prototyped an declaredusing the IEV_C_PROTO and IEV_C_FUNCT macros.vector is the vector table "slot number" you wish to install this ISR into. (see the CPU32documentation for more info on the vector table)Returns a pointer to the function that was previously installed in the target slot so that you canrestore it later if you so desire.PERSISTORInstruments Inc.22 of 84CF2 API Reference7/19/2005