SDK3.5
This document shows Ameba SDK 3.5 APIs
|
spi extended functions More...
Ameba Common | |
enum | { SPI_SCLK_IDLE_LOW =0, SPI_SCLK_IDLE_HIGH =2 } |
enum | { SPI_CS_TOGGLE_EVERY_FRAME =0, SPI_CS_TOGGLE_START_STOP =1 } |
enum | { SPI_SCLK_TOGGLE_MIDDLE =0, SPI_SCLK_TOGGLE_START =1 } |
enum | ChipSelect { CS_0 = 0, CS_1 = 1, CS_2 = 2, CS_3 = 3, CS_4 = 4, CS_5 = 5, CS_6 = 6, CS_7 = 7 } |
enum | SpiIrq { SpiRxIrq, SpiTxIrq } |
typedef void(* | spi_irq_handler) (uint32_t id, SpiIrq event) |
void | spi_irq_hook (spi_t *obj, spi_irq_handler handler, uint32_t id) |
Set SPI interrupt handler if needed. More... | |
void | spi_bus_tx_done_irq_hook (spi_t *obj, spi_irq_handler handler, uint32_t id) |
Set SPI interrupt bus tx done handler if needed. More... | |
void | spi_slave_flush_fifo (spi_t *obj) |
Slave device to flush tx fifo. More... | |
int32_t | spi_slave_read_stream (spi_t *obj, char *rx_buffer, uint32_t length) |
slave recv target length data use interrupt mode. More... | |
int32_t | spi_slave_write_stream (spi_t *obj, char *tx_buffer, uint32_t length) |
slave send target length data use interrupt mode. More... | |
int32_t | spi_master_read_stream (spi_t *obj, char *rx_buffer, uint32_t length) |
master recv target length data use interrupt mode. More... | |
int32_t | spi_master_write_stream (spi_t *obj, char *tx_buffer, uint32_t length) |
master send target length data use interrupt mode. More... | |
int32_t | spi_master_write_read_stream (spi_t *obj, char *tx_buffer, char *rx_buffer, uint32_t length) |
master send & recv target length data use interrupt mode. More... | |
int32_t | spi_slave_read_stream_timeout (spi_t *obj, char *rx_buffer, uint32_t length, uint32_t timeout_ms) |
slave recv target length data use interrupt mode and timeout mechanism. More... | |
int32_t | spi_slave_read_stream_terminate (spi_t *obj, char *rx_buffer, uint32_t length) |
slave recv target length data use interrupt mode and stop if the spi bus is idle. More... | |
int32_t | spi_slave_read_stream_dma (spi_t *obj, char *rx_buffer, uint32_t length) |
slave recv target length data use DMA mode. More... | |
int32_t | spi_slave_write_stream_dma (spi_t *obj, char *tx_buffer, uint32_t length) |
slave send target length data use DMA mode. More... | |
int32_t | spi_master_write_read_stream_dma (spi_t *obj, char *tx_buffer, char *rx_buffer, uint32_t length) |
master send & recv target length data use DMA mode. More... | |
int32_t | spi_master_read_stream_dma (spi_t *obj, char *rx_buffer, uint32_t length) |
master recv target length data use DMA mode. More... | |
int32_t | spi_master_write_stream_dma (spi_t *obj, char *tx_buffer, uint32_t length) |
master send target length data use DMA mode. More... | |
int32_t | spi_slave_read_stream_dma_timeout (spi_t *obj, char *rx_buffer, uint32_t length, uint32_t timeout_ms) |
slave recv target length data use DMA mode and timeout mechanism. More... | |
int32_t | spi_slave_read_stream_dma_terminate (spi_t *obj, char *rx_buffer, uint32_t length) |
slave recv target length data use DMA mode and stop if the spi bus is idle. More... | |
spi extended functions
void spi_bus_tx_done_irq_hook | ( | spi_t * | obj, |
spi_irq_handler | handler, | ||
uint32_t | id | ||
) |
Set SPI interrupt bus tx done handler if needed.
obj | spi object define in application software. |
handler | interrupt bus tx done callback function |
id | interrupt callback parameter |
none |
void spi_irq_hook | ( | spi_t * | obj, |
spi_irq_handler | handler, | ||
uint32_t | id | ||
) |
Set SPI interrupt handler if needed.
obj | spi object define in application software. |
handler | interrupt callback function |
id | interrupt callback parameter |
none |
int32_t spi_master_read_stream | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
master recv target length data use interrupt mode.
obj | spi master object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
stream init status |
int32_t spi_master_read_stream_dma | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
master recv target length data use DMA mode.
obj | spi master object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
stream init status |
int32_t spi_master_write_read_stream | ( | spi_t * | obj, |
char * | tx_buffer, | ||
char * | rx_buffer, | ||
uint32_t | length | ||
) |
master send & recv target length data use interrupt mode.
obj | spi master object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be send & recv. |
stream init status |
int32_t spi_master_write_read_stream_dma | ( | spi_t * | obj, |
char * | tx_buffer, | ||
char * | rx_buffer, | ||
uint32_t | length | ||
) |
master send & recv target length data use DMA mode.
obj | spi master object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be send & recv. |
stream init status |
int32_t spi_master_write_stream | ( | spi_t * | obj, |
char * | tx_buffer, | ||
uint32_t | length | ||
) |
master send target length data use interrupt mode.
obj | spi master object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
length | number of data bytes to be send. |
stream init status |
int32_t spi_master_write_stream_dma | ( | spi_t * | obj, |
char * | tx_buffer, | ||
uint32_t | length | ||
) |
master send target length data use DMA mode.
obj | spi master object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
length | number of data bytes to be send. |
stream init status |
void spi_slave_flush_fifo | ( | spi_t * | obj | ) |
Slave device to flush tx fifo.
obj | spi slave object define in application software. |
int32_t spi_slave_read_stream | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
slave recv target length data use interrupt mode.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
stream init status |
int32_t spi_slave_read_stream_dma | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
slave recv target length data use DMA mode.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
stream init status |
int32_t spi_slave_read_stream_dma_terminate | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
slave recv target length data use DMA mode and stop if the spi bus is idle.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
number of bytes read already |
int32_t spi_slave_read_stream_dma_timeout | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length, | ||
uint32_t | timeout_ms | ||
) |
slave recv target length data use DMA mode and timeout mechanism.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
timeout_ms | timeout waiting time. |
number of bytes read already |
int32_t spi_slave_read_stream_terminate | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length | ||
) |
slave recv target length data use interrupt mode and stop if the spi bus is idle.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
number of bytes read already |
int32_t spi_slave_read_stream_timeout | ( | spi_t * | obj, |
char * | rx_buffer, | ||
uint32_t | length, | ||
uint32_t | timeout_ms | ||
) |
slave recv target length data use interrupt mode and timeout mechanism.
obj | spi slave object define in application software. |
rx_buffer | buffer to save data read from SPI FIFO. |
length | number of data bytes to be read. |
timeout_ms | timeout waiting time. |
number of bytes read already |
int32_t spi_slave_write_stream | ( | spi_t * | obj, |
char * | tx_buffer, | ||
uint32_t | length | ||
) |
slave send target length data use interrupt mode.
obj | spi slave object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
length | number of data bytes to be send. |
stream init status |
int32_t spi_slave_write_stream_dma | ( | spi_t * | obj, |
char * | tx_buffer, | ||
uint32_t | length | ||
) |
slave send target length data use DMA mode.
obj | spi slave object define in application software. |
tx_buffer | buffer to be written to Tx FIFO. |
length | number of data bytes to be send. |
stream init status |