SPIDRVEMDRV

Detailed Description

SPIDRV Serial Peripheral Interface Driver.

The spidrv.c and spidrv.h source files for the SPI driver library are in the emdrv/spidrv folder.


Introduction

The SPI driver supports the SPI capabilities of EFM32/EZR32/EFR32 USARTs. The driver is fully reentrant, supports several driver instances, and does not buffer or queue data. Both synchronous and asynchronous transfer functions are included for both master and slave SPI mode. Synchronous transfer functions are blocking and do not return before the transfer is complete. Asynchronous transfer functions report transfer completion with callback functions. Transfers are handled using DMA.

Note
Transfer completion callback functions are called from within the DMA interrupt handler with interrupts disabled.


Configuration Options

Some properties of the SPIDRV driver are compile-time configurable. These properties are stored in a file named spidrv_config.h. A template for this file, containing default values, is in the emdrv/config folder. Currently the configuration options are as follows:

  • Inclusion of slave API transfer functions.

To configure SPIDRV, provide a custom configuration file. This is a sample spidrv_config.h file:

#ifndef __SILICON_LABS_SPIDRV_CONFIG_H__
#define __SILICON_LABS_SPIDRV_CONFIG_H__

// SPIDRV configuration option. Use this define to include the
// slave part of the SPIDRV API.
#define EMDRV_SPIDRV_INCLUDE_SLAVE

#endif

The properties of each SPI driver instance are set at run-time using the SPIDRV_Init_t data structure input parameter to the SPIDRV_Init() function.


The API

This section contains brief descriptions of the API functions. For detailed information on input and output parameters and return values, click on the hyperlinked function names. Most functions return an error code, ECODE_EMDRV_SPIDRV_OK is returned on success, see ecode.h and spidrv.h for other error codes.

The application code must include spidrv.h.

SPIDRV_Init(), SPIDRV_DeInit()
These functions initialize or deinitializes the SPIDRV driver. Typically, SPIDRV_Init() is called once in the startup code.

SPIDRV_GetTransferStatus()
Query the status of a transfer. Reports number of items (frames) transmitted and remaining.

SPIDRV_AbortTransfer()
Stop an ongoing transfer.

SPIDRV_SetBitrate(), SPIDRV_GetBitrate()
Set or query the SPI bus bitrate.

SPIDRV_SetFramelength(), SPIDRV_GetFramelength()
Set or query SPI the bus frame length.

SPIDRV_MReceive(), SPIDRV_MReceiveB()
SPIDRV_MTransfer(), SPIDRV_MTransferB(), SPIDRV_MTransferSingleItemB()
SPIDRV_MTransmit(), SPIDRV_MTransmitB()
SPIDRV_SReceive(), SPIDRV_SReceiveB()
SPIDRV_STransfer(), SPIDRV_STransferB()
SPIDRV_STransmit(), SPIDRV_STransmitB()
SPI transfer functions for SPI masters have an uppercase M in their name, the slave counterparts have an S.

As previously mentioned, transfer functions are synchronous and asynchronous. The synchronous versions have an uppercase B (for Blocking) at the end of their function name.

Transmit functions discard received data, receive functions transmit a fixed data pattern set when the driver is initialized (SPIDRV_Init_t::dummyTxValue). Transfer functions both receive and transmit data.

All slave transfer functions have a millisecond timeout parameter. Use 0 for no (infinite) timeout.


Example

#include "spidrv.h"

SPIDRV_HandleData_t handleData;
SPIDRV_Handle_t handle = &handleData;

void TransferComplete(SPIDRV_Handle_t handle,
                      Ecode_t transferStatus,
                      int itemsTransferred)
{
  if (transferStatus == ECODE_EMDRV_SPIDRV_OK) {
   // Success !
  }
}

int main(void)
{
  uint8_t buffer[10];
  SPIDRV_Init_t initData = SPIDRV_MASTER_USART2;

  // Initialize an SPI driver instance.
  SPIDRV_Init(handle, &initData);

  // Transmit data using a blocking transmit function.
  SPIDRV_MTransmitB(handle, buffer, 10);

  // Transmit data using a callback to catch transfer completion.
  SPIDRV_MTransmit(handle, buffer, 10, TransferComplete);
}

Data Structures

struct  SPIDRV_HandleData
 
struct  SPIDRV_Init
 

Macros

#define ECODE_EMDRV_SPIDRV_ABORTED   (ECODE_EMDRV_SPIDRV_BASE | 0x00000007)
 An SPI transfer has been aborted.
 
#define ECODE_EMDRV_SPIDRV_BUSY   (ECODE_EMDRV_SPIDRV_BASE | 0x00000003)
 The SPI port is busy.
 
#define ECODE_EMDRV_SPIDRV_DMA_ALLOC_ERROR   (ECODE_EMDRV_SPIDRV_BASE | 0x00000009)
 Unable to allocate DMA channels.
 
#define ECODE_EMDRV_SPIDRV_IDLE   (ECODE_EMDRV_SPIDRV_BASE | 0x00000006)
 No SPI transfer in progress.
 
#define ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE   (ECODE_EMDRV_SPIDRV_BASE | 0x00000001)
 An illegal SPI handle.
 
#define ECODE_EMDRV_SPIDRV_MODE_ERROR   (ECODE_EMDRV_SPIDRV_BASE | 0x00000008)
 SPI master used slave API or vica versa.
 
#define ECODE_EMDRV_SPIDRV_OK   (ECODE_OK)
 A successful return value.
 
#define ECODE_EMDRV_SPIDRV_PARAM_ERROR   (ECODE_EMDRV_SPIDRV_BASE | 0x00000002)
 An illegal input parameter.
 
#define ECODE_EMDRV_SPIDRV_TIMEOUT   (ECODE_EMDRV_SPIDRV_BASE | 0x00000005)
 An SPI transfer timeout.
 
#define ECODE_EMDRV_SPIDRV_TIMER_ALLOC_ERROR   (ECODE_EMDRV_SPIDRV_BASE | 0x00000004)
 Unable to allocate timeout timer.
 
#define SPIDRV_MASTER_USART0
 Configuration data for SPI master using USART0.
 
#define SPIDRV_MASTER_USART1
 Configuration data for SPI master using USART1.
 
#define SPIDRV_MASTER_USART2
 Configuration data for SPI master using USART2.
 
#define SPIDRV_MASTER_USART3
 Configuration data for SPI master using USART3.
 
#define SPIDRV_MASTER_USART4
 Configuration data for SPI master using USART4.
 
#define SPIDRV_MASTER_USART5
 Configuration data for SPI master using USART5.
 
#define SPIDRV_SLAVE_USART0
 Configuration data for SPI slave using USART0.
 
#define SPIDRV_SLAVE_USART1
 Configuration data for SPI slave using USART1.
 
#define SPIDRV_SLAVE_USART2
 Configuration data for SPI slave using USART2.
 
#define SPIDRV_SLAVE_USART3
 Configuration data for SPI slave using USART3.
 
#define SPIDRV_SLAVE_USART4
 Configuration data for SPI slave using USART4.
 
#define SPIDRV_SLAVE_USART5
 Configuration data for SPI slave using USART5.
 

Typedefs

typedef enum SPIDRV_BitOrder SPIDRV_BitOrder_t
 SPI bus bit order.
 
typedef void(* SPIDRV_Callback_t) (struct SPIDRV_HandleData *handle, Ecode_t transferStatus, int itemsTransferred)
 SPIDRV transfer completion callback function.
 
typedef enum SPIDRV_ClockMode SPIDRV_ClockMode_t
 SPI clock mode (clock polarity and phase).
 
typedef enum SPIDRV_CsControl SPIDRV_CsControl_t
 SPI master chip select (CS) control scheme.
 
typedef SPIDRV_HandleData_tSPIDRV_Handle_t
 An SPI driver instance handle.
 
typedef struct SPIDRV_HandleData SPIDRV_HandleData_t
 
typedef struct SPIDRV_Init SPIDRV_Init_t
 
typedef enum SPIDRV_SlaveStart SPIDRV_SlaveStart_t
 SPI slave transfer start scheme.
 
typedef enum SPIDRV_Type SPIDRV_Type_t
 SPI driver instance type.
 

Enumerations

enum  SPIDRV_BitOrder {
  spidrvBitOrderLsbFirst = 0,
  spidrvBitOrderMsbFirst = 1
}
 SPI bus bit order.
 
enum  SPIDRV_ClockMode {
  spidrvClockMode0 = 0,
  spidrvClockMode1 = 1,
  spidrvClockMode2 = 2,
  spidrvClockMode3 = 3
}
 SPI clock mode (clock polarity and phase).
 
enum  SPIDRV_CsControl {
  spidrvCsControlAuto = 0,
  spidrvCsControlApplication = 1
}
 SPI master chip select (CS) control scheme.
 
enum  SPIDRV_SlaveStart {
  spidrvSlaveStartImmediate = 0,
  spidrvSlaveStartDelayed = 1
}
 SPI slave transfer start scheme.
 
enum  SPIDRV_Type {
  spidrvMaster = 0,
  spidrvSlave = 1
}
 SPI driver instance type.
 

Functions

Ecode_t SPIDRV_AbortTransfer (SPIDRV_Handle_t handle)
 Abort an ongoing SPI transfer.
 
Ecode_t SPIDRV_DeInit (SPIDRV_Handle_t handle)
 Deinitialize an SPI driver instance.
 
Ecode_t SPIDRV_GetBitrate (SPIDRV_Handle_t handle, uint32_t *bitRate)
 Get current SPI bus bitrate.
 
Ecode_t SPIDRV_GetFramelength (SPIDRV_Handle_t handle, uint32_t *frameLength)
 Get current SPI framelength.
 
Ecode_t SPIDRV_GetTransferStatus (SPIDRV_Handle_t handle, int *itemsTransferred, int *itemsRemaining)
 Get the status of an SPI transfer.
 
Ecode_t SPIDRV_Init (SPIDRV_Handle_t handle, SPIDRV_Init_t *initData)
 Initialize an SPI driver instance.
 
Ecode_t SPIDRV_MReceive (SPIDRV_Handle_t handle, void *buffer, int count, SPIDRV_Callback_t callback)
 Start an SPI master receive transfer.
 
Ecode_t SPIDRV_MReceiveB (SPIDRV_Handle_t handle, void *buffer, int count)
 Start an SPI master blocking receive transfer.
 
Ecode_t SPIDRV_MTransfer (SPIDRV_Handle_t handle, const void *txBuffer, void *rxBuffer, int count, SPIDRV_Callback_t callback)
 Start an SPI master transfer.
 
Ecode_t SPIDRV_MTransferB (SPIDRV_Handle_t handle, const void *txBuffer, void *rxBuffer, int count)
 Start an SPI master blocking transfer.
 
Ecode_t SPIDRV_MTransferSingleItemB (SPIDRV_Handle_t handle, uint32_t txValue, void *rxValue)
 Start an SPI master blocking single item (frame) transfer.
 
Ecode_t SPIDRV_MTransmit (SPIDRV_Handle_t handle, const void *buffer, int count, SPIDRV_Callback_t callback)
 Start an SPI master transmit transfer.
 
Ecode_t SPIDRV_MTransmitB (SPIDRV_Handle_t handle, const void *buffer, int count)
 Start an SPI master blocking transmit transfer.
 
Ecode_t SPIDRV_SetBitrate (SPIDRV_Handle_t handle, uint32_t bitRate)
 Set SPI bus bitrate.
 
Ecode_t SPIDRV_SetFramelength (SPIDRV_Handle_t handle, uint32_t frameLength)
 Set SPI framelength.
 
Ecode_t SPIDRV_SReceive (SPIDRV_Handle_t handle, void *buffer, int count, SPIDRV_Callback_t callback, int timeoutMs)
 Start an SPI slave receive transfer.
 
Ecode_t SPIDRV_SReceiveB (SPIDRV_Handle_t handle, void *buffer, int count, int timeoutMs)
 Start an SPI slave blocking receive transfer.
 
Ecode_t SPIDRV_STransfer (SPIDRV_Handle_t handle, const void *txBuffer, void *rxBuffer, int count, SPIDRV_Callback_t callback, int timeoutMs)
 Start an SPI slave transfer.
 
Ecode_t SPIDRV_STransferB (SPIDRV_Handle_t handle, const void *txBuffer, void *rxBuffer, int count, int timeoutMs)
 Start an SPI slave blocking transfer.
 
Ecode_t SPIDRV_STransmit (SPIDRV_Handle_t handle, const void *buffer, int count, SPIDRV_Callback_t callback, int timeoutMs)
 Start an SPI slave transmit transfer.
 
Ecode_t SPIDRV_STransmitB (SPIDRV_Handle_t handle, const void *buffer, int count, int timeoutMs)
 Start an SPI slave blocking transmit transfer.
 

Macro Definition Documentation

#define SPIDRV_MASTER_USART0
Value:
{ \
USART0, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC1, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC1, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART0.

Definition at line 191 of file spidrv.h.

#define SPIDRV_MASTER_USART1
Value:
{ \
USART1, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC11, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC11, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC11,/* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC11, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART1.

Definition at line 247 of file spidrv.h.

Referenced by KSZ8851SNL_SPI_Init().

#define SPIDRV_MASTER_USART2
Value:
{ \
USART2, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART2.

Definition at line 268 of file spidrv.h.

#define SPIDRV_MASTER_USART3
Value:
{ \
USART3, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART3.

Definition at line 288 of file spidrv.h.

#define SPIDRV_MASTER_USART4
Value:
{ \
USART4, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART4.

Definition at line 308 of file spidrv.h.

#define SPIDRV_MASTER_USART5
Value:
{ \
USART5, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
1000000, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvMaster, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI master using USART5.

Definition at line 328 of file spidrv.h.

#define SPIDRV_SLAVE_USART0
Value:
{ \
USART0, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC1, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC1, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART0.

Definition at line 366 of file spidrv.h.

#define SPIDRV_SLAVE_USART1
Value:
{ \
USART1, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC11, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC11, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC11,/* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC11, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART1.

Definition at line 422 of file spidrv.h.

#define SPIDRV_SLAVE_USART2
Value:
{ \
USART2, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART2.

Definition at line 443 of file spidrv.h.

#define SPIDRV_SLAVE_USART3
Value:
{ \
USART3, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART3.

Definition at line 463 of file spidrv.h.

#define SPIDRV_SLAVE_USART4
Value:
{ \
USART4, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART4.

Definition at line 483 of file spidrv.h.

#define SPIDRV_SLAVE_USART5
Value:
{ \
USART5, /* USART port */ \
_USART_ROUTELOC0_TXLOC_LOC0, /* USART Tx pin location number */ \
_USART_ROUTELOC0_RXLOC_LOC0, /* USART Rx pin location number */ \
_USART_ROUTELOC0_CLKLOC_LOC0, /* USART Clk pin location number */ \
_USART_ROUTELOC0_CSLOC_LOC0, /* USART Cs pin location number */ \
0, /* Bitrate */ \
8, /* Frame length */ \
0, /* Dummy Tx value for Rx only funcs */ \
spidrvSlave, /* SPI mode */ \
spidrvBitOrderMsbFirst, /* Bit order on bus */ \
spidrvClockMode0, /* SPI clock/phase mode */ \
spidrvCsControlAuto, /* CS controlled by the driver */ \
spidrvSlaveStartImmediate /* Slave start transfers immediately*/ \
}

Configuration data for SPI slave using USART5.

Definition at line 503 of file spidrv.h.

Typedef Documentation

typedef void(* SPIDRV_Callback_t) (struct SPIDRV_HandleData *handle, Ecode_t transferStatus, int itemsTransferred)

SPIDRV transfer completion callback function.

Called when a transfer is complete. An application should check the transferStatus and itemsTransferred values.

Parameters
[in]handleThe SPIDRV device handle used to start the transfer.
[in]transferStatusA number of bytes actually transferred.
[in]itemsTransferredA number of bytes transferred.
Returns
ECODE_EMDRV_SPIDRV_OK on success, ECODE_EMDRV_SPIDRV_TIMEOUT on timeout. Timeouts are only relevant for slave mode transfers.

Definition at line 109 of file spidrv.h.

An SPI driver instance handle data structure. The handle is allocated by the application using the SPIDRV. Several concurrent driver instances can exist in an application. The application is neither supposed to write or read the contents of the handle.

typedef struct SPIDRV_Init SPIDRV_Init_t

An SPI driver instance initialization structure. Contains a number of SPIDRV configuration options. This structure is passed to SPIDRV_Init() when initializing a SPIDRV instance. Some common initialization data sets are predefined in SPIDRV_MASTER_USART0 and friends.

Enumeration Type Documentation

SPI bus bit order.

Enumerator
spidrvBitOrderLsbFirst 

LSB bit is transmitted first.

spidrvBitOrderMsbFirst 

MSB bit is transmitted first.

Definition at line 61 of file spidrv.h.

SPI clock mode (clock polarity and phase).

Enumerator
spidrvClockMode0 

SPI mode 0: CLKPOL=0, CLKPHA=0.

spidrvClockMode1 

SPI mode 1: CLKPOL=0, CLKPHA=1.

spidrvClockMode2 

SPI mode 2: CLKPOL=1, CLKPHA=0.

spidrvClockMode3 

SPI mode 3: CLKPOL=1, CLKPHA=1.

Definition at line 67 of file spidrv.h.

SPI master chip select (CS) control scheme.

Enumerator
spidrvCsControlAuto 

CS controlled by the SPI driver.

spidrvCsControlApplication 

CS controlled by the application.

Definition at line 75 of file spidrv.h.

SPI slave transfer start scheme.

Enumerator
spidrvSlaveStartImmediate 

Transfer starts immediately.

spidrvSlaveStartDelayed 

Transfer starts when the bus is idle (CS deasserted).

Definition at line 81 of file spidrv.h.

SPI driver instance type.

Enumerator
spidrvMaster 

Act as an SPI master.

spidrvSlave 

Act as an SPI slave.

Definition at line 55 of file spidrv.h.

Function Documentation

Ecode_t SPIDRV_AbortTransfer ( SPIDRV_Handle_t  handle)

Abort an ongoing SPI transfer.

Parameters
[in]handlePointer to an SPI driver handle.
Returns
ECODE_EMDRV_SPIDRV_OK on success, ECODE_EMDRV_SPIDRV_IDLE if SPI is idle. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 340 of file spidrv.c.

References CORE_DECLARE_IRQ_STATE, CORE_ENTER_ATOMIC, CORE_EXIT_ATOMIC, DMADRV_StopTransfer(), DMADRV_TransferRemainingCount(), ECODE_EMDRV_SPIDRV_ABORTED, ECODE_EMDRV_SPIDRV_IDLE, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, RTCDRV_StopTimer(), and spidrvSlave.

Ecode_t SPIDRV_DeInit ( SPIDRV_Handle_t  handle)

Deinitialize an SPI driver instance.

Parameters
[in]handlePointer to an SPI driver handle.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 301 of file spidrv.c.

References CMU_ClockEnable(), DMADRV_DeInit(), DMADRV_FreeChannel(), DMADRV_StopTransfer(), ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, RTCDRV_FreeTimer(), RTCDRV_StopTimer(), spidrvSlave, and USART_Reset().

Ecode_t SPIDRV_GetBitrate ( SPIDRV_Handle_t  handle,
uint32_t *  bitRate 
)

Get current SPI bus bitrate.

Parameters
[in]handlePointer to an SPI driver handle.
[out]bitRateCurrent SPI bus bitrate.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 391 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, and USART_BaudrateGet().

Ecode_t SPIDRV_GetFramelength ( SPIDRV_Handle_t  handle,
uint32_t *  frameLength 
)

Get current SPI framelength.

Parameters
[in]handlePointer to an SPI driver handle.
[out]frameLengthCurrent SPI bus framelength.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 418 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, and ECODE_EMDRV_SPIDRV_PARAM_ERROR.

Ecode_t SPIDRV_GetTransferStatus ( SPIDRV_Handle_t  handle,
int *  itemsTransferred,
int *  itemsRemaining 
)

Get the status of an SPI transfer.

Returns status of an ongoing transfer. If no transfer is in progress, the status of the last transfer is reported.

Parameters
[in]handlePointer to an SPI driver handle.
[out]itemsTransferredNumber of items (frames) transferred.
[out]itemsRemainingNumber of items (frames) remaining.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 451 of file spidrv.c.

References CORE_ATOMIC_SECTION, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, and ECODE_EMDRV_SPIDRV_PARAM_ERROR.

Ecode_t SPIDRV_Init ( SPIDRV_Handle_t  handle,
SPIDRV_Init_t initData 
)

Initialize an SPI driver instance.

Parameters
[out]handlePointer to an SPI driver handle; refer to SPIDRV_Handle_t.
[in]initDataPointer to an initialization data structure; refer to SPIDRV_Init_t.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 101 of file spidrv.c.

References _USART_ROUTELOC0_CLKLOC_MASK, _USART_ROUTELOC0_CLKLOC_SHIFT, _USART_ROUTELOC0_CSLOC_MASK, _USART_ROUTELOC0_CSLOC_SHIFT, _USART_ROUTELOC0_RXLOC_MASK, _USART_ROUTELOC0_RXLOC_SHIFT, _USART_ROUTELOC0_TXLOC_MASK, _USART_ROUTELOC0_TXLOC_SHIFT, USART_InitSync_TypeDef::baudrate, SPIDRV_Init::bitOrder, SPIDRV_Init::bitRate, SPIDRV_Init::clockMode, USART_InitSync_TypeDef::clockMode, CMU_ClockEnable(), cmuClock_GPIO, cmuClock_HFPER, cmuClock_USART0, cmuClock_USART1, cmuClock_USART2, cmuClock_USART3, cmuClock_USART4, cmuClock_USART5, CORE_DECLARE_IRQ_STATE, CORE_ENTER_ATOMIC, CORE_EXIT_ATOMIC, SPIDRV_Init::csControl, USART_TypeDef::CTRL, DMADRV_AllocateChannel(), DMADRV_Init(), dmadrvPeripheralSignal_USART0_RXDATAV, dmadrvPeripheralSignal_USART0_TXBL, dmadrvPeripheralSignal_USART1_RXDATAV, dmadrvPeripheralSignal_USART1_TXBL, dmadrvPeripheralSignal_USART2_RXDATAV, dmadrvPeripheralSignal_USART2_TXBL, dmadrvPeripheralSignal_USART3_RXDATAV, dmadrvPeripheralSignal_USART3_TXBL, dmadrvPeripheralSignal_USART4_RXDATAV, dmadrvPeripheralSignal_USART4_TXBL, dmadrvPeripheralSignal_USART5_RXDATAV, dmadrvPeripheralSignal_USART5_TXBL, ECODE_EMDRV_DMADRV_OK, ECODE_EMDRV_RTCDRV_OK, ECODE_EMDRV_SPIDRV_DMA_ALLOC_ERROR, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, ECODE_EMDRV_SPIDRV_TIMER_ALLOC_ERROR, USART_InitSync_TypeDef::master, USART_InitSync_TypeDef::msbf, SPIDRV_Init::port, SPIDRV_Init::portLocationClk, SPIDRV_Init::portLocationCs, SPIDRV_Init::portLocationRx, SPIDRV_Init::portLocationTx, USART_TypeDef::ROUTELOC0, USART_TypeDef::ROUTEPEN, RTCDRV_AllocateTimer(), RTCDRV_Init(), spidrvBitOrderMsbFirst, spidrvClockMode0, spidrvClockMode1, spidrvClockMode2, spidrvClockMode3, spidrvCsControlAuto, spidrvMaster, spidrvSlave, SPIDRV_Init::type, USART0, USART1, USART2, USART3, USART4, USART5, USART_CTRL_AUTOCS, USART_InitSync(), USART_INITSYNC_DEFAULT, USART_ROUTEPEN_CLKPEN, USART_ROUTEPEN_CSPEN, USART_ROUTEPEN_RXPEN, USART_ROUTEPEN_TXPEN, usartClockMode0, usartClockMode1, usartClockMode2, and usartClockMode3.

Referenced by ezradio_hal_SpiInit(), and KSZ8851SNL_SPI_Init().

Ecode_t SPIDRV_MReceive ( SPIDRV_Handle_t  handle,
void *  buffer,
int  count,
SPIDRV_Callback_t  callback 
)

Start an SPI master receive transfer.

Note
The MOSI wire will transmit SPIDRV_Init_t::dummyTxValue.
Parameters
[in]handlePointer to an SPI driver handle.
[out]bufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 498 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, and spidrvSlave.

Ecode_t SPIDRV_MReceiveB ( SPIDRV_Handle_t  handle,
void *  buffer,
int  count 
)

Start an SPI master blocking receive transfer.

Note
The MOSI wire will transmit SPIDRV_Init_t::dummyTxValue.
This function is blocking and returns when the transfer is complete or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[out]bufferReceive data buffer.
[in]countNumber of bytes in transfer.
Returns
ECODE_EMDRV_SPIDRV_OK on success or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 539 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, and spidrvSlave.

Referenced by ezradio_hal_SpiReadByte(), ezradio_hal_SpiReadData(), and KSZ8851SNL_SPI_Receive().

Ecode_t SPIDRV_MTransfer ( SPIDRV_Handle_t  handle,
const void *  txBuffer,
void *  rxBuffer,
int  count,
SPIDRV_Callback_t  callback 
)

Start an SPI master transfer.

Parameters
[in]handlePointer to an SPI driver handle.
[in]txBufferTransmit data buffer.
[out]rxBufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 579 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, and spidrvSlave.

Ecode_t SPIDRV_MTransferB ( SPIDRV_Handle_t  handle,
const void *  txBuffer,
void *  rxBuffer,
int  count 
)

Start an SPI master blocking transfer.

Note
This function is blocking and returns when the transfer is complete or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[in]txBufferTransmit data buffer.
[out]rxBufferReceive data buffer.
[in]countNumber of bytes in transfer.
Returns
ECODE_EMDRV_SPIDRV_OK on success or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 626 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, and spidrvSlave.

Referenced by ezradio_hal_SpiWriteReadData(), and KSZ8851SNL_SPI_ReadRegister().

Ecode_t SPIDRV_MTransferSingleItemB ( SPIDRV_Handle_t  handle,
uint32_t  txValue,
void *  rxValue 
)

Start an SPI master blocking single item (frame) transfer.

Note
This function is blocking and returns when the transfer is complete or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[in]txValueValue to transmit.
[out]rxValueValue received.
Returns
ECODE_EMDRV_SPIDRV_OK on success or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 672 of file spidrv.c.

References CORE_DECLARE_IRQ_STATE, CORE_ENTER_ATOMIC, CORE_EXIT_ATOMIC, ECODE_EMDRV_SPIDRV_BUSY, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_MODE_ERROR, rxBuffer, and spidrvSlave.

Ecode_t SPIDRV_MTransmit ( SPIDRV_Handle_t  handle,
const void *  buffer,
int  count,
SPIDRV_Callback_t  callback 
)

Start an SPI master transmit transfer.

Note
The data received on the MISO wire is discarded.
Parameters
[in]handlePointer to an SPI driver handle.
[in]bufferTransmit data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 726 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, and spidrvSlave.

Ecode_t SPIDRV_MTransmitB ( SPIDRV_Handle_t  handle,
const void *  buffer,
int  count 
)

Start an SPI master blocking transmit transfer.

Note
The data received on the MISO wire is discarded.
This function is blocking and returns when the transfer is complete.
Parameters
[in]handlePointer to an SPI driver handle.
[in]bufferTransmit data buffer.
[in]countNumber of bytes in transfer.
Returns
ECODE_EMDRV_SPIDRV_OK on success or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 766 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, and spidrvSlave.

Referenced by ezradio_hal_SpiWriteByte(), ezradio_hal_SpiWriteData(), and KSZ8851SNL_SPI_Transmit().

Ecode_t SPIDRV_SetBitrate ( SPIDRV_Handle_t  handle,
uint32_t  bitRate 
)

Set SPI bus bitrate.

Parameters
[in]handlePointer to an SPI driver handle.
[in]bitRateNew SPI bus bitrate.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 800 of file spidrv.c.

References CORE_DECLARE_IRQ_STATE, CORE_ENTER_ATOMIC, CORE_EXIT_ATOMIC, ECODE_EMDRV_SPIDRV_BUSY, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, and USART_BaudrateSyncSet().

Ecode_t SPIDRV_SetFramelength ( SPIDRV_Handle_t  handle,
uint32_t  frameLength 
)

Set SPI framelength.

Parameters
[in]handlePointer to an SPI driver handle.
[in]frameLengthNew SPI bus framelength.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 833 of file spidrv.c.

References _USART_FRAME_DATABITS_FOUR, _USART_FRAME_DATABITS_MASK, _USART_FRAME_DATABITS_SHIFT, _USART_FRAME_DATABITS_SIXTEEN, CORE_DECLARE_IRQ_STATE, CORE_ENTER_ATOMIC, CORE_EXIT_ATOMIC, ECODE_EMDRV_SPIDRV_BUSY, ECODE_EMDRV_SPIDRV_ILLEGAL_HANDLE, ECODE_EMDRV_SPIDRV_OK, and ECODE_EMDRV_SPIDRV_PARAM_ERROR.

Ecode_t SPIDRV_SReceive ( SPIDRV_Handle_t  handle,
void *  buffer,
int  count,
SPIDRV_Callback_t  callback,
int  timeoutMs 
)

Start an SPI slave receive transfer.

Note
The MISO wire will transmit SPIDRV_Init_t::dummyTxValue.
Parameters
[in]handlePointer to an SPI driver handle.
[out]bufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 885 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.

Ecode_t SPIDRV_SReceiveB ( SPIDRV_Handle_t  handle,
void *  buffer,
int  count,
int  timeoutMs 
)

Start an SPI slave blocking receive transfer.

Note
The MISO wire will transmit SPIDRV_Init_t::dummyTxValue.
This function is blocking and returns when the transfer is complete, on timeout, or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[out]bufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success, ECODE_EMDRV_SPIDRV_TIMEOUT on timeout or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 944 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.

Ecode_t SPIDRV_STransfer ( SPIDRV_Handle_t  handle,
const void *  txBuffer,
void *  rxBuffer,
int  count,
SPIDRV_Callback_t  callback,
int  timeoutMs 
)

Start an SPI slave transfer.

Parameters
[in]handlePointer to an SPI driver handle.
[in]txBufferTransmit data buffer.
[out]rxBufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 1001 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.

Ecode_t SPIDRV_STransferB ( SPIDRV_Handle_t  handle,
const void *  txBuffer,
void *  rxBuffer,
int  count,
int  timeoutMs 
)

Start an SPI slave blocking transfer.

Note

This function is blocking and returns when the transfer is complete, on timeout, or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[in]txBufferTransmit data buffer.
[out]rxBufferReceive data buffer.
[in]countNumber of bytes in transfer.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success, ECODE_EMDRV_SPIDRV_TIMEOUT on timeout or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 1066 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, ECODE_EMDRV_SPIDRV_PARAM_ERROR, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.

Ecode_t SPIDRV_STransmit ( SPIDRV_Handle_t  handle,
const void *  buffer,
int  count,
SPIDRV_Callback_t  callback,
int  timeoutMs 
)

Start an SPI slave transmit transfer.

Note
The data received on the MOSI wire is discarded.
Parameters
[in]handlePointer to an SPI driver handle.
[in]bufferTransmit data buffer.
[in]countNumber of bytes in transfer.
[in]callbackTransfer completion callback.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 1129 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.

Ecode_t SPIDRV_STransmitB ( SPIDRV_Handle_t  handle,
const void *  buffer,
int  count,
int  timeoutMs 
)

Start an SPI slave blocking transmit transfer.

Note
The data received on the MOSI wire is discarded.
This function is blocking and returns when the transfer is complete, on timeout, or when SPIDRV_AbortTransfer() is called.
Parameters
[in]handlePointer to an SPI driver handle.
[in]bufferTransmit data buffer.
[in]countNumber of bytes in transfer.
[in]timeoutMsTransfer timeout in milliseconds.
Returns
ECODE_EMDRV_SPIDRV_OK on success, ECODE_EMDRV_SPIDRV_TIMEOUT on timeout or ECODE_EMDRV_SPIDRV_ABORTED if SPIDRV_AbortTransfer() has been called. On failure, an appropriate SPIDRV Ecode_t is returned.

Definition at line 1188 of file spidrv.c.

References ECODE_EMDRV_SPIDRV_MODE_ERROR, ECODE_EMDRV_SPIDRV_OK, RTCDRV_StartTimer(), rtcdrvTimerTypeOneshot, spidrvMaster, and spidrvSlaveStartDelayed.