1.26.5.38 SPIx_TransferSetup Function

C

/* x = FLEXCOM instance number */

/* SPI master mode */

bool FLEXCOMx_SPI_TransferSetup(FLEXCOM_SPI_TRANSFER_SETUP* setup, uint32_t spiSourceClock)

Summary

Configure FLEXCOM SPI operational parameters at run time.

Description

This function allows the application to change the FLEXCOM SPI operational parameter at run time. The application can thus override the MHC defined configuration for these parameters. The parameter are specified via the FLEXCOM_SPI_TRANSFER_SETUP type setup parameter. Each member of this parameter should be initialized to the desired value. The application may need to call this function in situation where multiple SPI slaves are connected on the sam SPI bus, each with different operation parameters. This function can thus be used to setup the SPI Master to meet the communication needs of the slave being talked to. Calling this function will affect any ongoing communication. The application must thus ensure that there is no on-going communication on the SPI before calling this function.

Precondition

FLEXCOM SPI must first be initialized using FLEXCOMx_SPI_Initialize().

Parameters


Param	Description
setup	Pointer to the data structure of type FLEXCOM_SPI_TRANSFER_SETUP containing the operation parameters. Each operation parameter must be specified even if the parameter does not need to change.
spiSourceClock	FLEXCOM SPI peripheral clock source frequency. If configured to 0, PLIB takes the peripheral clock frequency from MHC.

Returns

true - setup was successful.

false - if spiSourceClock and SPI clock frequencies are such that resultant baud value is out of the possible range.

Example

FLEXCOM_SPI_TRANSFER_SETUP setup;
setup.clockFrequency = 1000000;
setup.clockPhase = SPI_CLOCK_PHASE_TRAILING_EDGE;
setup.clockPolarity = SPI_CLOCK_POLARITY_IDLE_LOW;
setup.dataBits = SPI_DATA_BITS_8;

// Assuming 150 MHz as peripheral input clock frequency
if (FLEXCOM0_SPI_TransferSetup (&setup, 150000000) == false)
{
    // this means setup could not be done, debug the reason.
}

Remarks

The application would need to call this function only if the operational parameter need to be different than the ones configured in MHC.