Api Specification - Freescale Semiconductor DSP56800E User Manual

Table 5-592. SPI Operation Items for appconfig.h (Continued)
SYMBOL
INT_VECTOR_ADDR_yy
yy = SPI1 Receiver Full Interrupt
INT_VECTOR_ADDR_yy
yy = SPI1 Transmitter Empty Interrupt
INT_PRIORITY_LEVEL_yy
yy = the four SPI interrupts as described
above
The built-in software layer is implemented in the spibl.c file. The file implements the interface
using read and write operations in BLOCKING or NON_BLOCKING modes - this
implementation is backward compatible with previous (HawkV1) implementations.
There are several appconfig.h configuration items for the built in software layer:
Table 5-593. Built-in Software Layer Configuration Items
SYMBOL
SPI_ x _RX_CHAR_HOOK
SPI_ x _RX_ERROR_HOOK
SPI_ x _TX_CHAR_HOOK
SPI_ x _RX_FINISHED_HOOK
SPI_ x _TX_FINISHED_HOOK
5.16.2.3

API Specification

This section specifies the exact usage for each API function.
Function arguments for each routine are described as in, out, or inout.
1. in argument means that the parameter value is an input only to the function.
2. out argument means that the parameter value is an output only from the function.
FREESCALE SEMICONDUCTOR
TYPE
/ VALUE
Spi1RxFullISR
Spi1TxEmptyISR
INTC_LEVEL0 |
INTC_LEVEL1 |
INTC_LEVEL2
TYPE
/ VALUE
function name declared as:
UWord16 hook(UWord16
rxchar)
function name declared as:
void hook(void)
function name declared as:
UWord16 hook(UWord16
txchar)
function name declared as:
void hook(void)
function name declared as:
void hook(void)
Targeting 56F8xxx Platform
DESCRIPTION
Name of the built in interrupt service routine imple-
mented in spi.c file.
Name of the built in interrupt service routine imple-
mented in spi.c file.
To enable the SPI interrupts, they must be assigned a
interrupt priority level.
DESCRIPTION
The name of callback function which is called after
each character received. Return nonzero to dis-
card the received character.
The name of callback function which is called
when any error is detected by the receiver.
The name of callback function which is called after
each character transmitted. Return nonzero when
custom (asynchronous) character was inserted to
the SPI transmit buffer.
The name of callback function which is called
when NON_BLOCKING read operation finishes,
The name of callback function which is called
when NON_BLOCKING write operation finishes,
5-715