Classes
struct	_sai_bit_clock
	sai bit clock configurations More...

struct	_sai_config
	SAI user configuration structure. More...

struct	_sai_frame_sync
	sai frame sync configurations More...

struct	_sai_handle
	SAI handle structure. More...

struct	_sai_serial_data
	sai serial data configurations More...

struct	_sai_transceiver
	sai transceiver configurations More...

struct	_sai_transfer
	SAI transfer structure. More...

struct	_sai_transfer_format
	sai transfer format More...

Driver version
enum	{ kStatus_SAI_TxBusy = MAKE_STATUS(kStatusGroup_SAI, 0), kStatus_SAI_RxBusy = MAKE_STATUS(kStatusGroup_SAI, 1), kStatus_SAI_TxError = MAKE_STATUS(kStatusGroup_SAI, 2), kStatus_SAI_RxError = MAKE_STATUS(kStatusGroup_SAI, 3), kStatus_SAI_QueueFull = MAKE_STATUS(kStatusGroup_SAI, 4), kStatus_SAI_TxIdle = MAKE_STATUS(kStatusGroup_SAI, 5), kStatus_SAI_RxIdle = MAKE_STATUS(kStatusGroup_SAI, 6) }
	_sai_status_t, SAI return status. More...

enum	{ kSAI_Channel0Mask = 1 << 0U, kSAI_Channel1Mask = 1 << 1U, kSAI_Channel2Mask = 1 << 2U, kSAI_Channel3Mask = 1 << 3U, kSAI_Channel4Mask = 1 << 4U, kSAI_Channel5Mask = 1 << 5U, kSAI_Channel6Mask = 1 << 6U, kSAI_Channel7Mask = 1 << 7U }
	_sai_channel_mask,.sai channel mask value, actual channel numbers is depend soc specific More...

enum	_sai_protocol { kSAI_BusLeftJustified = 0x0U, kSAI_BusRightJustified, kSAI_BusI2S, kSAI_BusPCMA, kSAI_BusPCMB }
	Define the SAI bus type. More...

enum	_sai_master_slave { kSAI_Master = 0x0U, kSAI_Slave = 0x1U, kSAI_Bclk_Master_FrameSync_Slave = 0x2U, kSAI_Bclk_Slave_FrameSync_Master = 0x3U }
	Master or slave mode. More...

enum	_sai_mono_stereo { kSAI_Stereo = 0x0U, kSAI_MonoRight, kSAI_MonoLeft }
	Mono or stereo audio format. More...

enum	_sai_data_order { kSAI_DataLSB = 0x0U, kSAI_DataMSB }
	SAI data order, MSB or LSB. More...

enum	_sai_clock_polarity { kSAI_PolarityActiveHigh = 0x0U, kSAI_PolarityActiveLow = 0x1U, kSAI_SampleOnFallingEdge = 0x0U, kSAI_SampleOnRisingEdge = 0x1U }
	SAI clock polarity, active high or low. More...

enum	_sai_sync_mode { kSAI_ModeAsync = 0x0U, kSAI_ModeSync }
	Synchronous or asynchronous mode. More...

enum	_sai_mclk_source { kSAI_MclkSourceSysclk = 0x0U, kSAI_MclkSourceSelect1, kSAI_MclkSourceSelect2, kSAI_MclkSourceSelect3 }
	Mater clock source. More...

enum	_sai_bclk_source { kSAI_BclkSourceBusclk = 0x0U, kSAI_BclkSourceMclkOption1 = 0x1U, kSAI_BclkSourceMclkOption2 = 0x2U, kSAI_BclkSourceMclkOption3 = 0x3U, kSAI_BclkSourceMclkDiv = 0x1U, kSAI_BclkSourceOtherSai0 = 0x2U, kSAI_BclkSourceOtherSai1 = 0x3U }
	Bit clock source. More...

enum	{ kSAI_WordStartInterruptEnable, kSAI_SyncErrorInterruptEnable = I2S_TCSR_SEIE_MASK, kSAI_FIFOWarningInterruptEnable = I2S_TCSR_FWIE_MASK, kSAI_FIFOErrorInterruptEnable = I2S_TCSR_FEIE_MASK }
	_sai_interrupt_enable_t, The SAI interrupt enable flag More...

enum	{ kSAI_FIFOWarningDMAEnable = I2S_TCSR_FWDE_MASK }
	_sai_dma_enable_t, The DMA request sources More...

enum	{ kSAI_WordStartFlag = I2S_TCSR_WSF_MASK, kSAI_SyncErrorFlag = I2S_TCSR_SEF_MASK, kSAI_FIFOErrorFlag = I2S_TCSR_FEF_MASK, kSAI_FIFOWarningFlag = I2S_TCSR_FWF_MASK }
	_sai_flags, The SAI status flag More...

enum	_sai_reset_type { kSAI_ResetTypeSoftware = I2S_TCSR_SR_MASK, kSAI_ResetTypeFIFO = I2S_TCSR_FR_MASK, kSAI_ResetAll = I2S_TCSR_SR_MASK \| I2S_TCSR_FR_MASK }
	The reset type. More...

enum	_sai_sample_rate { kSAI_SampleRate8KHz = 8000U, kSAI_SampleRate11025Hz = 11025U, kSAI_SampleRate12KHz = 12000U, kSAI_SampleRate16KHz = 16000U, kSAI_SampleRate22050Hz = 22050U, kSAI_SampleRate24KHz = 24000U, kSAI_SampleRate32KHz = 32000U, kSAI_SampleRate44100Hz = 44100U, kSAI_SampleRate48KHz = 48000U, kSAI_SampleRate96KHz = 96000U, kSAI_SampleRate192KHz = 192000U, kSAI_SampleRate384KHz = 384000U }
	Audio sample rate. More...

enum	_sai_word_width { kSAI_WordWidth8bits = 8U, kSAI_WordWidth16bits = 16U, kSAI_WordWidth24bits = 24U, kSAI_WordWidth32bits = 32U }
	Audio word width. More...

enum	_sai_transceiver_type { kSAI_Transmitter = 0U, kSAI_Receiver = 1U }
	sai transceiver type More...

enum	_sai_frame_sync_len { kSAI_FrameSyncLenOneBitClk = 0U, kSAI_FrameSyncLenPerWordWidth = 1U }
	sai frame sync len More...

typedef enum _sai_protocol	sai_protocol_t
	Define the SAI bus type. More...

typedef enum _sai_master_slave	sai_master_slave_t
	Master or slave mode. More...

typedef enum _sai_mono_stereo	sai_mono_stereo_t
	Mono or stereo audio format. More...

typedef enum _sai_data_order	sai_data_order_t
	SAI data order, MSB or LSB. More...

typedef enum _sai_clock_polarity	sai_clock_polarity_t
	SAI clock polarity, active high or low. More...

typedef enum _sai_sync_mode	sai_sync_mode_t
	Synchronous or asynchronous mode. More...

typedef enum _sai_mclk_source	sai_mclk_source_t
	Mater clock source. More...

typedef enum _sai_bclk_source	sai_bclk_source_t
	Bit clock source. More...

typedef enum _sai_reset_type	sai_reset_type_t
	The reset type. More...

typedef struct _sai_config	sai_config_t
	SAI user configuration structure. More...

typedef enum _sai_sample_rate	sai_sample_rate_t
	Audio sample rate. More...

typedef enum _sai_word_width	sai_word_width_t
	Audio word width. More...

typedef enum _sai_transceiver_type	sai_transceiver_type_t
	sai transceiver type More...

typedef enum _sai_frame_sync_len	sai_frame_sync_len_t
	sai frame sync len More...

typedef struct _sai_transfer_format	sai_transfer_format_t
	sai transfer format More...

typedef struct _sai_bit_clock	sai_bit_clock_t
	sai bit clock configurations More...

typedef struct _sai_frame_sync	sai_frame_sync_t
	sai frame sync configurations More...

typedef struct _sai_serial_data	sai_serial_data_t
	sai serial data configurations More...

typedef struct _sai_transceiver	sai_transceiver_t
	sai transceiver configurations More...

typedef struct _sai_transfer	sai_transfer_t
	SAI transfer structure. More...

typedef struct _sai_handle	sai_handle_t

typedef void(*	sai_transfer_callback_t) (I2S_Type base, sai_handle_t handle, status_t status, void *userData)
	SAI transfer callback prototype. More...

#define	FSL_SAI_DRIVER_VERSION (MAKE_VERSION(2, 3, 1))

#define	SAI_XFER_QUEUE_SIZE (4U)
	SAI transfer queue size, user can refine it according to use case. More...

#define	FSL_SAI_HAS_FIFO_EXTEND_FEATURE 0
	sai fifo feature More...

Initialization and deinitialization
void	SAI_TxInit (I2S_Type base, const sai_config_t config)
	Initializes the SAI Tx peripheral. More...

void	SAI_RxInit (I2S_Type base, const sai_config_t config)
	Initializes the SAI Rx peripheral. More...

void	SAI_TxGetDefaultConfig (sai_config_t *config)
	Sets the SAI Tx configuration structure to default values. More...

void	SAI_RxGetDefaultConfig (sai_config_t *config)
	Sets the SAI Rx configuration structure to default values. More...

void	SAI_Init (I2S_Type *base)
	Initializes the SAI peripheral. More...

void	SAI_Deinit (I2S_Type *base)
	De-initializes the SAI peripheral. More...

void	SAI_TxReset (I2S_Type *base)
	Resets the SAI Tx. More...

void	SAI_RxReset (I2S_Type *base)
	Resets the SAI Rx. More...

void	SAI_TxEnable (I2S_Type *base, bool enable)
	Enables/disables the SAI Tx. More...

void	SAI_RxEnable (I2S_Type *base, bool enable)
	Enables/disables the SAI Rx. More...

static void	SAI_TxSetBitClockDirection (I2S_Type *base, sai_master_slave_t masterSlave)
	Set Rx bit clock direction. More...

static void	SAI_RxSetBitClockDirection (I2S_Type *base, sai_master_slave_t masterSlave)
	Set Rx bit clock direction. More...

static void	SAI_RxSetFrameSyncDirection (I2S_Type *base, sai_master_slave_t masterSlave)
	Set Rx frame sync direction. More...

static void	SAI_TxSetFrameSyncDirection (I2S_Type *base, sai_master_slave_t masterSlave)
	Set Tx frame sync direction. More...

void	SAI_TxSetBitClockRate (I2S_Type *base, uint32_t sourceClockHz, uint32_t sampleRate, uint32_t bitWidth, uint32_t channelNumbers)
	Transmitter bit clock rate configurations. More...

void	SAI_RxSetBitClockRate (I2S_Type *base, uint32_t sourceClockHz, uint32_t sampleRate, uint32_t bitWidth, uint32_t channelNumbers)
	Receiver bit clock rate configurations. More...

void	SAI_TxSetBitclockConfig (I2S_Type base, sai_master_slave_t masterSlave, sai_bit_clock_t config)
	Transmitter Bit clock configurations. More...

void	SAI_RxSetBitclockConfig (I2S_Type base, sai_master_slave_t masterSlave, sai_bit_clock_t config)
	Receiver Bit clock configurations. More...

void	SAI_TxSetFrameSyncConfig (I2S_Type base, sai_master_slave_t masterSlave, sai_frame_sync_t config)
	SAI transmitter Frame sync configurations. More...

void	SAI_RxSetFrameSyncConfig (I2S_Type base, sai_master_slave_t masterSlave, sai_frame_sync_t config)
	SAI receiver Frame sync configurations. More...

void	SAI_TxSetSerialDataConfig (I2S_Type base, sai_serial_data_t config)
	SAI transmitter Serial data configurations. More...

void	SAI_RxSetSerialDataConfig (I2S_Type base, sai_serial_data_t config)
	SAI receiver Serial data configurations. More...

void	SAI_TxSetConfig (I2S_Type base, sai_transceiver_t config)
	SAI transmitter configurations. More...

void	SAI_RxSetConfig (I2S_Type base, sai_transceiver_t config)
	SAI receiver configurations. More...

void	SAI_GetClassicI2SConfig (sai_transceiver_t *config, sai_word_width_t bitWidth, sai_mono_stereo_t mode, uint32_t saiChannelMask)
	Get classic I2S mode configurations. More...

void	SAI_GetLeftJustifiedConfig (sai_transceiver_t *config, sai_word_width_t bitWidth, sai_mono_stereo_t mode, uint32_t saiChannelMask)
	Get left justified mode configurations. More...

void	SAI_GetRightJustifiedConfig (sai_transceiver_t *config, sai_word_width_t bitWidth, sai_mono_stereo_t mode, uint32_t saiChannelMask)
	Get right justified mode configurations. More...

void	SAI_GetTDMConfig (sai_transceiver_t *config, sai_frame_sync_len_t frameSyncWidth, sai_word_width_t bitWidth, uint32_t dataWordNum, uint32_t saiChannelMask)
	Get TDM mode configurations. More...

void	SAI_GetDSPConfig (sai_transceiver_t *config, sai_frame_sync_len_t frameSyncWidth, sai_word_width_t bitWidth, sai_mono_stereo_t mode, uint32_t saiChannelMask)
	Get DSP mode configurations. More...

Status
static uint32_t	SAI_TxGetStatusFlag (I2S_Type *base)
	Gets the SAI Tx status flag state. More...

static void	SAI_TxClearStatusFlags (I2S_Type *base, uint32_t mask)
	Clears the SAI Tx status flag state. More...

static uint32_t	SAI_RxGetStatusFlag (I2S_Type *base)
	Gets the SAI Tx status flag state. More...

static void	SAI_RxClearStatusFlags (I2S_Type *base, uint32_t mask)
	Clears the SAI Rx status flag state. More...

void	SAI_TxSoftwareReset (I2S_Type *base, sai_reset_type_t type)
	Do software reset or FIFO reset . More...

void	SAI_RxSoftwareReset (I2S_Type *base, sai_reset_type_t type)
	Do software reset or FIFO reset . More...

void	SAI_TxSetChannelFIFOMask (I2S_Type *base, uint8_t mask)
	Set the Tx channel FIFO enable mask. More...

void	SAI_RxSetChannelFIFOMask (I2S_Type *base, uint8_t mask)
	Set the Rx channel FIFO enable mask. More...

void	SAI_TxSetDataOrder (I2S_Type *base, sai_data_order_t order)
	Set the Tx data order. More...

void	SAI_RxSetDataOrder (I2S_Type *base, sai_data_order_t order)
	Set the Rx data order. More...

void	SAI_TxSetBitClockPolarity (I2S_Type *base, sai_clock_polarity_t polarity)
	Set the Tx data order. More...

void	SAI_RxSetBitClockPolarity (I2S_Type *base, sai_clock_polarity_t polarity)
	Set the Rx data order. More...

void	SAI_TxSetFrameSyncPolarity (I2S_Type *base, sai_clock_polarity_t polarity)
	Set the Tx data order. More...

void	SAI_RxSetFrameSyncPolarity (I2S_Type *base, sai_clock_polarity_t polarity)
	Set the Rx data order. More...

Interrupts
static void	SAI_TxEnableInterrupts (I2S_Type *base, uint32_t mask)
	Enables the SAI Tx interrupt requests. More...

static void	SAI_RxEnableInterrupts (I2S_Type *base, uint32_t mask)
	Enables the SAI Rx interrupt requests. More...

static void	SAI_TxDisableInterrupts (I2S_Type *base, uint32_t mask)
	Disables the SAI Tx interrupt requests. More...

static void	SAI_RxDisableInterrupts (I2S_Type *base, uint32_t mask)
	Disables the SAI Rx interrupt requests. More...

DMA Control
static void	SAI_TxEnableDMA (I2S_Type *base, uint32_t mask, bool enable)
	Enables/disables the SAI Tx DMA requests. More...

static void	SAI_RxEnableDMA (I2S_Type *base, uint32_t mask, bool enable)
	Enables/disables the SAI Rx DMA requests. More...

static uint32_t	SAI_TxGetDataRegisterAddress (I2S_Type *base, uint32_t channel)
	Gets the SAI Tx data register address. More...

static uint32_t	SAI_RxGetDataRegisterAddress (I2S_Type *base, uint32_t channel)
	Gets the SAI Rx data register address. More...

Bus Operations
void	SAI_TxSetFormat (I2S_Type base, sai_transfer_format_t format, uint32_t mclkSourceClockHz, uint32_t bclkSourceClockHz)
	Configures the SAI Tx audio format. More...

void	SAI_RxSetFormat (I2S_Type base, sai_transfer_format_t format, uint32_t mclkSourceClockHz, uint32_t bclkSourceClockHz)
	Configures the SAI Rx audio format. More...

void	SAI_WriteBlocking (I2S_Type base, uint32_t channel, uint32_t bitWidth, uint8_t buffer, uint32_t size)
	Sends data using a blocking method. More...

void	SAI_WriteMultiChannelBlocking (I2S_Type base, uint32_t channel, uint32_t channelMask, uint32_t bitWidth, uint8_t buffer, uint32_t size)
	Sends data to multi channel using a blocking method. More...

static void	SAI_WriteData (I2S_Type *base, uint32_t channel, uint32_t data)
	Writes data into SAI FIFO. More...

void	SAI_ReadBlocking (I2S_Type base, uint32_t channel, uint32_t bitWidth, uint8_t buffer, uint32_t size)
	Receives data using a blocking method. More...

void	SAI_ReadMultiChannelBlocking (I2S_Type base, uint32_t channel, uint32_t channelMask, uint32_t bitWidth, uint8_t buffer, uint32_t size)
	Receives multi channel data using a blocking method. More...

static uint32_t	SAI_ReadData (I2S_Type *base, uint32_t channel)
	Reads data from the SAI FIFO. More...

Transactional
void	SAI_TransferTxCreateHandle (I2S_Type base, sai_handle_t handle, sai_transfer_callback_t callback, void *userData)
	Initializes the SAI Tx handle. More...

void	SAI_TransferRxCreateHandle (I2S_Type base, sai_handle_t handle, sai_transfer_callback_t callback, void *userData)
	Initializes the SAI Rx handle. More...

void	SAI_TransferTxSetConfig (I2S_Type base, sai_handle_t handle, sai_transceiver_t *config)
	SAI transmitter transfer configurations. More...

void	SAI_TransferRxSetConfig (I2S_Type base, sai_handle_t handle, sai_transceiver_t *config)
	SAI receiver transfer configurations. More...

status_t	SAI_TransferTxSetFormat (I2S_Type base, sai_handle_t handle, sai_transfer_format_t *format, uint32_t mclkSourceClockHz, uint32_t bclkSourceClockHz)
	Configures the SAI Tx audio format. More...

status_t	SAI_TransferRxSetFormat (I2S_Type base, sai_handle_t handle, sai_transfer_format_t *format, uint32_t mclkSourceClockHz, uint32_t bclkSourceClockHz)
	Configures the SAI Rx audio format. More...

status_t	SAI_TransferSendNonBlocking (I2S_Type base, sai_handle_t handle, sai_transfer_t *xfer)
	Performs an interrupt non-blocking send transfer on SAI. More...

status_t	SAI_TransferReceiveNonBlocking (I2S_Type base, sai_handle_t handle, sai_transfer_t *xfer)
	Performs an interrupt non-blocking receive transfer on SAI. More...

status_t	SAI_TransferGetSendCount (I2S_Type base, sai_handle_t handle, size_t *count)
	Gets a set byte count. More...

status_t	SAI_TransferGetReceiveCount (I2S_Type base, sai_handle_t handle, size_t *count)
	Gets a received byte count. More...

void	SAI_TransferAbortSend (I2S_Type base, sai_handle_t handle)
	Aborts the current send. More...

void	SAI_TransferAbortReceive (I2S_Type base, sai_handle_t handle)
	Aborts the current IRQ receive. More...

void	SAI_TransferTerminateSend (I2S_Type base, sai_handle_t handle)
	Terminate all SAI send. More...

void	SAI_TransferTerminateReceive (I2S_Type base, sai_handle_t handle)
	Terminate all SAI receive. More...

void	SAI_TransferTxHandleIRQ (I2S_Type base, sai_handle_t handle)
	Tx interrupt handler. More...

void	SAI_TransferRxHandleIRQ (I2S_Type base, sai_handle_t handle)
	Tx interrupt handler. More...

Detailed Description

Macro Definition Documentation

◆ FSL_SAI_DRIVER_VERSION

#define FSL_SAI_DRIVER_VERSION (MAKE_VERSION(2, 3, 1))

Version 2.3.1

Definition at line 25 of file fsl_sai.h.

◆ FSL_SAI_HAS_FIFO_EXTEND_FEATURE

#define FSL_SAI_HAS_FIFO_EXTEND_FEATURE 0

sai fifo feature

Definition at line 326 of file fsl_sai.h.

◆ SAI_XFER_QUEUE_SIZE

#define SAI_XFER_QUEUE_SIZE (4U)

SAI transfer queue size, user can refine it according to use case.

Definition at line 204 of file fsl_sai.h.

Typedef Documentation

◆ sai_bclk_source_t

typedef enum _sai_bclk_source sai_bclk_source_t

Bit clock source.

◆ sai_bit_clock_t

typedef struct _sai_bit_clock sai_bit_clock_t

sai bit clock configurations

◆ sai_clock_polarity_t

typedef enum _sai_clock_polarity sai_clock_polarity_t

SAI clock polarity, active high or low.

◆ sai_config_t

typedef struct _sai_config sai_config_t

SAI user configuration structure.

◆ sai_data_order_t

typedef enum _sai_data_order sai_data_order_t

SAI data order, MSB or LSB.

◆ sai_frame_sync_len_t

typedef enum _sai_frame_sync_len sai_frame_sync_len_t

sai frame sync len

◆ sai_frame_sync_t

typedef struct _sai_frame_sync sai_frame_sync_t

sai frame sync configurations

◆ sai_handle_t

typedef struct _sai_handle sai_handle_t

Definition at line 420 of file fsl_sai.h.

◆ sai_master_slave_t

typedef enum _sai_master_slave sai_master_slave_t

Master or slave mode.

◆ sai_mclk_source_t

typedef enum _sai_mclk_source sai_mclk_source_t

Mater clock source.

◆ sai_mono_stereo_t

typedef enum _sai_mono_stereo sai_mono_stereo_t

Mono or stereo audio format.

◆ sai_protocol_t

typedef enum _sai_protocol sai_protocol_t

Define the SAI bus type.

◆ sai_reset_type_t

typedef enum _sai_reset_type sai_reset_type_t

The reset type.

◆ sai_sample_rate_t

typedef enum _sai_sample_rate sai_sample_rate_t

Audio sample rate.

◆ sai_serial_data_t

typedef struct _sai_serial_data sai_serial_data_t

sai serial data configurations

◆ sai_sync_mode_t

typedef enum _sai_sync_mode sai_sync_mode_t

Synchronous or asynchronous mode.

◆ sai_transceiver_t

typedef struct _sai_transceiver sai_transceiver_t

sai transceiver configurations

◆ sai_transceiver_type_t

typedef enum _sai_transceiver_type sai_transceiver_type_t

sai transceiver type

◆ sai_transfer_callback_t

typedef void(* sai_transfer_callback_t) (I2S_Type *base, sai_handle_t *handle, status_t status, void *userData)

SAI transfer callback prototype.

Definition at line 423 of file fsl_sai.h.

◆ sai_transfer_format_t

typedef struct _sai_transfer_format sai_transfer_format_t

sai transfer format

◆ sai_transfer_t

typedef struct _sai_transfer sai_transfer_t

SAI transfer structure.

◆ sai_word_width_t

typedef enum _sai_word_width sai_word_width_t

Audio word width.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

_sai_status_t, SAI return status.

Enumerator
kStatus_SAI_TxBusy	SAI Tx is busy.
kStatus_SAI_RxBusy	SAI Rx is busy.
kStatus_SAI_TxError	SAI Tx FIFO error.
kStatus_SAI_RxError	SAI Rx FIFO error.
kStatus_SAI_QueueFull	SAI transfer queue is full.
kStatus_SAI_TxIdle	SAI Tx is idle
kStatus_SAI_RxIdle	SAI Rx is idle

Definition at line 29 of file fsl_sai.h.

◆ anonymous enum

anonymous enum

_sai_channel_mask,.sai channel mask value, actual channel numbers is depend soc specific

Enumerator
kSAI_Channel0Mask	channel 0 mask value
kSAI_Channel1Mask	channel 1 mask value
kSAI_Channel2Mask	channel 2 mask value
kSAI_Channel3Mask	channel 3 mask value
kSAI_Channel4Mask	channel 4 mask value
kSAI_Channel5Mask	channel 5 mask value
kSAI_Channel6Mask	channel 6 mask value
kSAI_Channel7Mask	channel 7 mask value

Definition at line 41 of file fsl_sai.h.

◆ anonymous enum

anonymous enum

_sai_interrupt_enable_t, The SAI interrupt enable flag

Enumerator
kSAI_WordStartInterruptEnable	Word start flag, means the first word in a frame detected
kSAI_SyncErrorInterruptEnable	Sync error flag, means the sync error is detected
kSAI_FIFOWarningInterruptEnable	FIFO warning flag, means the FIFO is empty
kSAI_FIFOErrorInterruptEnable	FIFO error flag

Definition at line 133 of file fsl_sai.h.

◆ anonymous enum

anonymous enum

_sai_dma_enable_t, The DMA request sources

Enumerator
kSAI_FIFOWarningDMAEnable	FIFO warning caused by the DMA request

Definition at line 146 of file fsl_sai.h.

◆ anonymous enum

anonymous enum

_sai_flags, The SAI status flag

Enumerator
kSAI_WordStartFlag	Word start flag, means the first word in a frame detected
kSAI_SyncErrorFlag	Sync error flag, means the sync error is detected
kSAI_FIFOErrorFlag	FIFO error flag
kSAI_FIFOWarningFlag	FIFO warning flag

Definition at line 155 of file fsl_sai.h.

◆ _sai_bclk_source

enum _sai_bclk_source

Bit clock source.

Enumerator
kSAI_BclkSourceBusclk	Bit clock using bus clock
kSAI_BclkSourceMclkOption1	Bit clock MCLK option 1
kSAI_BclkSourceMclkOption2	Bit clock MCLK option2
kSAI_BclkSourceMclkOption3	Bit clock MCLK option3
kSAI_BclkSourceMclkDiv	Bit clock using master clock divider
kSAI_BclkSourceOtherSai0	Bit clock from other SAI device
kSAI_BclkSourceOtherSai1	Bit clock from other SAI device

Definition at line 119 of file fsl_sai.h.

◆ _sai_clock_polarity

enum _sai_clock_polarity

SAI clock polarity, active high or low.

Enumerator
kSAI_PolarityActiveHigh	Drive outputs on rising edge
kSAI_PolarityActiveLow	Drive outputs on falling edge
kSAI_SampleOnFallingEdge	Sample inputs on falling edge
kSAI_SampleOnRisingEdge	Sample inputs on rising edge

Definition at line 88 of file fsl_sai.h.

◆ _sai_data_order

enum _sai_data_order

SAI data order, MSB or LSB.

Enumerator
kSAI_DataLSB	LSB bit transferred first
kSAI_DataMSB	MSB bit transferred first

Definition at line 81 of file fsl_sai.h.

◆ _sai_frame_sync_len

enum _sai_frame_sync_len

sai frame sync len

Enumerator
kSAI_FrameSyncLenOneBitClk	1 bit clock frame sync len for DSP mode
kSAI_FrameSyncLenPerWordWidth	Frame sync length decided by word width

Definition at line 263 of file fsl_sai.h.

◆ _sai_master_slave

enum _sai_master_slave

Master or slave mode.

Enumerator
kSAI_Master	Master mode include bclk and frame sync
kSAI_Slave	Slave mode include bclk and frame sync
kSAI_Bclk_Master_FrameSync_Slave	bclk in master mode, frame sync in slave mode
kSAI_Bclk_Slave_FrameSync_Master	bclk in slave mode, frame sync in master mode

Definition at line 64 of file fsl_sai.h.

◆ _sai_mclk_source

enum _sai_mclk_source

Mater clock source.

Enumerator
kSAI_MclkSourceSysclk	Master clock from the system clock
kSAI_MclkSourceSelect1	Master clock from source 1
kSAI_MclkSourceSelect2	Master clock from source 2
kSAI_MclkSourceSelect3	Master clock from source 3

Definition at line 109 of file fsl_sai.h.

◆ _sai_mono_stereo

enum _sai_mono_stereo

Mono or stereo audio format.

Enumerator
kSAI_Stereo	Stereo sound.
kSAI_MonoRight	Only Right channel have sound.
kSAI_MonoLeft	Only left channel have sound.

Definition at line 73 of file fsl_sai.h.

◆ _sai_protocol

enum _sai_protocol

Define the SAI bus type.

Enumerator
kSAI_BusLeftJustified	Uses left justified format.
kSAI_BusRightJustified	Uses right justified format.
kSAI_BusI2S	Uses I2S format.
kSAI_BusPCMA	Uses I2S PCM A format.
kSAI_BusPCMB	Uses I2S PCM B format.

Definition at line 54 of file fsl_sai.h.

◆ _sai_reset_type

enum _sai_reset_type

The reset type.

Enumerator
kSAI_ResetTypeSoftware	Software reset, reset the logic state
kSAI_ResetTypeFIFO	FIFO reset, reset the FIFO read and write pointer
kSAI_ResetAll	All reset.

Definition at line 167 of file fsl_sai.h.

◆ _sai_sample_rate

enum _sai_sample_rate

Audio sample rate.

Enumerator
kSAI_SampleRate8KHz	Sample rate 8000 Hz
kSAI_SampleRate11025Hz	Sample rate 11025 Hz
kSAI_SampleRate12KHz	Sample rate 12000 Hz
kSAI_SampleRate16KHz	Sample rate 16000 Hz
kSAI_SampleRate22050Hz	Sample rate 22050 Hz
kSAI_SampleRate24KHz	Sample rate 24000 Hz
kSAI_SampleRate32KHz	Sample rate 32000 Hz
kSAI_SampleRate44100Hz	Sample rate 44100 Hz
kSAI_SampleRate48KHz	Sample rate 48000 Hz
kSAI_SampleRate96KHz	Sample rate 96000 Hz
kSAI_SampleRate192KHz	Sample rate 192000 Hz
kSAI_SampleRate384KHz	Sample rate 384000 Hz

Definition at line 208 of file fsl_sai.h.

◆ _sai_sync_mode

enum _sai_sync_mode

Synchronous or asynchronous mode.

Enumerator
kSAI_ModeAsync	Asynchronous mode
kSAI_ModeSync	Synchronous mode (with receiver or transmit)

Definition at line 97 of file fsl_sai.h.

◆ _sai_transceiver_type

enum _sai_transceiver_type

sai transceiver type

Enumerator
kSAI_Transmitter	sai transmitter
kSAI_Receiver	sai receiver

Definition at line 256 of file fsl_sai.h.

◆ _sai_word_width

enum _sai_word_width

Audio word width.

Enumerator
kSAI_WordWidth8bits	Audio data width 8 bits
kSAI_WordWidth16bits	Audio data width 16 bits
kSAI_WordWidth24bits	Audio data width 24 bits
kSAI_WordWidth32bits	Audio data width 32 bits

Definition at line 225 of file fsl_sai.h.

Function Documentation

◆ SAI_Deinit()

void SAI_Deinit ( I2S_Type * base )

De-initializes the SAI peripheral.

This API gates the SAI clock. The SAI module can't operate unless SAI_TxInit or SAI_RxInit is called to enable the clock.

Parameters

base	SAI base pointer.

brief De-initializes the SAI peripheral.

This API gates the SAI clock. The SAI module can't operate unless SAI_TxInit or SAI_RxInit is called to enable the clock.

param base SAI base pointer

Definition at line 676 of file fsl_sai.c.

◆ SAI_GetClassicI2SConfig()

void SAI_GetClassicI2SConfig	(	sai_transceiver_t *	config,
		sai_word_width_t	bitWidth,
		sai_mono_stereo_t	mode,
		uint32_t	saiChannelMask
	)

Get classic I2S mode configurations.

Parameters

config	transceiver configurations.
bitWidth	audio data bitWidth.
mode	audio data channel.
saiChannelMask	mask value of the channel to be enable.

brief Get classic I2S mode configurations.

param config transceiver configurations. param bitWidth audio data bitWidth. param mode audio data channel. param saiChannelMask channel mask value to enable.

Definition at line 1693 of file fsl_sai.c.

◆ SAI_GetDSPConfig()

void SAI_GetDSPConfig	(	sai_transceiver_t *	config,
		sai_frame_sync_len_t	frameSyncWidth,
		sai_word_width_t	bitWidth,
		sai_mono_stereo_t	mode,
		uint32_t	saiChannelMask
	)

Get DSP mode configurations.

Parameters

config	transceiver configurations.
frameSyncWidth	length of frame sync.
bitWidth	audio data bitWidth.
mode	audio data channel.
saiChannelMask	mask value of the channel to enable.

brief Get DSP mode configurations.

param config transceiver configurations. param bitWidth audio data bitWidth. param mode audio data channel. param saiChannelMask channel mask value to enable.

Definition at line 1753 of file fsl_sai.c.

◆ SAI_GetLeftJustifiedConfig()

void SAI_GetLeftJustifiedConfig	(	sai_transceiver_t *	config,
		sai_word_width_t	bitWidth,
		sai_mono_stereo_t	mode,
		uint32_t	saiChannelMask
	)

Get left justified mode configurations.

Parameters

config	transceiver configurations.
bitWidth	audio data bitWidth.
mode	audio data channel.
saiChannelMask	mask value of the channel to be enable.

brief Get left justified mode configurations.

param config transceiver configurations. param bitWidth audio data bitWidth. param mode audio data channel. param saiChannelMask channel mask value to enable.

Definition at line 1709 of file fsl_sai.c.

◆ SAI_GetRightJustifiedConfig()

void SAI_GetRightJustifiedConfig	(	sai_transceiver_t *	config,
		sai_word_width_t	bitWidth,
		sai_mono_stereo_t	mode,
		uint32_t	saiChannelMask
	)

Get right justified mode configurations.

Parameters

config	transceiver configurations.
bitWidth	audio data bitWidth.
mode	audio data channel.
saiChannelMask	mask value of the channel to be enable.

brief Get right justified mode configurations.

param config transceiver configurations. param bitWidth audio data bitWidth. param mode audio data channel. param saiChannelMask channel mask value to enable.

Definition at line 1731 of file fsl_sai.c.

◆ SAI_GetTDMConfig()

void SAI_GetTDMConfig	(	sai_transceiver_t *	config,
		sai_frame_sync_len_t	frameSyncWidth,
		sai_word_width_t	bitWidth,
		uint32_t	dataWordNum,
		uint32_t	saiChannelMask
	)

Get TDM mode configurations.

Parameters

config	transceiver configurations.
frameSyncWidth	length of frame sync.
bitWidth	audio data word width.
dataWordNum	word number in one frame.
saiChannelMask	mask value of the channel to be enable.

brief Get TDM mode configurations.

param config transceiver configurations. param bitWidth audio data bitWidth. param mode audio data channel. param saiChannelMask channel mask value to enable.

Definition at line 1786 of file fsl_sai.c.

◆ SAI_Init()

void SAI_Init ( I2S_Type * base )

Initializes the SAI peripheral.

This API gates the SAI clock. The SAI module can't operate unless SAI_Init is called to enable the clock.

Parameters

base	SAI base pointer.

brief Initializes the SAI peripheral.

This API gates the SAI clock. The SAI module can't operate unless SAI_Init is called to enable the clock.

param base SAI base pointer

Definition at line 648 of file fsl_sai.c.

◆ SAI_ReadBlocking()

void SAI_ReadBlocking	(	I2S_Type *	base,
		uint32_t	channel,
		uint32_t	bitWidth,
		uint8_t *	buffer,
		uint32_t	size
	)

Receives data using a blocking method.

Note: This function blocks by polling until data is ready to be sent.

Parameters

base	SAI base pointer.
channel	Data channel used.
bitWidth	How many bits in an audio word; usually 8/16/24/32 bits.
buffer	Pointer to the data to be read.
size	Bytes to be read.

brief Receives data using a blocking method.

note This function blocks by polling until data is ready to be sent.

param base SAI base pointer. param channel Data channel used. param bitWidth How many bits in an audio word; usually 8/16/24/32 bits. param buffer Pointer to the data to be read. param size Bytes to be read.

Definition at line 2251 of file fsl_sai.c.

◆ SAI_ReadData()

static uint32_t SAI_ReadData	(	I2S_Type *	base,
		uint32_t	channel
	)

inlinestatic

Reads data from the SAI FIFO.

Parameters

base	SAI base pointer.
channel	Data channel used.

Returns: Data in SAI FIFO.

Definition at line 1344 of file fsl_sai.h.

◆ SAI_ReadMultiChannelBlocking()

void SAI_ReadMultiChannelBlocking	(	I2S_Type *	base,
		uint32_t	channel,
		uint32_t	channelMask,
		uint32_t	bitWidth,
		uint8_t *	buffer,
		uint32_t	size
	)

Receives multi channel data using a blocking method.

Note: This function blocks by polling until data is ready to be sent.

Parameters

base	SAI base pointer.
channel	Data channel used.
channelMask	channel mask.
bitWidth	How many bits in an audio word; usually 8/16/24/32 bits.
buffer	Pointer to the data to be read.
size	Bytes to be read.

brief Receives multi channel data using a blocking method.

note This function blocks by polling until data is ready to be sent.

param base SAI base pointer. param channel Data channel used. param channelMask channel mask. param bitWidth How many bits in an audio word; usually 8/16/24/32 bits. param buffer Pointer to the data to be read. param size Bytes to be read.

Definition at line 2205 of file fsl_sai.c.

◆ SAI_RxClearStatusFlags()

static void SAI_RxClearStatusFlags	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Clears the SAI Rx status flag state.

Parameters

base	SAI base pointer
mask	State mask. It can be a combination of the following sources if defined. kSAI_WordStartFlag kSAI_SyncErrorFlag kSAI_FIFOErrorFlag

Definition at line 915 of file fsl_sai.h.

◆ SAI_RxDisableInterrupts()

static void SAI_RxDisableInterrupts	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Disables the SAI Rx interrupt requests.

Parameters

base	SAI base pointer
mask	interrupt source The parameter can be a combination of the following sources if defined. kSAI_WordStartInterruptEnable kSAI_SyncErrorInterruptEnable kSAI_FIFOWarningInterruptEnable kSAI_FIFORequestInterruptEnable kSAI_FIFOErrorInterruptEnable

Definition at line 1144 of file fsl_sai.h.

◆ SAI_RxEnable()

void SAI_RxEnable	(	I2S_Type *	base,
		bool	enable
	)

Enables/disables the SAI Rx.

Parameters

base	SAI base pointer.
enable	True means enable SAI Rx, false means disable.

brief Enables/disables the SAI Rx.

param base SAI base pointer param enable True means enable SAI Rx, false means disable.

Definition at line 835 of file fsl_sai.c.

◆ SAI_RxEnableDMA()

static void SAI_RxEnableDMA	(	I2S_Type *	base,
		uint32_t	mask,
		bool	enable
	)

inlinestatic

Enables/disables the SAI Rx DMA requests.

Parameters

base	SAI base pointer
mask	DMA source The parameter can be a combination of the following sources if defined. kSAI_FIFOWarningDMAEnable kSAI_FIFORequestDMAEnable
enable	True means enable DMA, false means disable DMA.

Definition at line 1186 of file fsl_sai.h.

◆ SAI_RxEnableInterrupts()

static void SAI_RxEnableInterrupts	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Enables the SAI Rx interrupt requests.

Parameters

base	SAI base pointer
mask	interrupt source The parameter can be a combination of the following sources if defined. kSAI_WordStartInterruptEnable kSAI_SyncErrorInterruptEnable kSAI_FIFOWarningInterruptEnable kSAI_FIFORequestInterruptEnable kSAI_FIFOErrorInterruptEnable

Definition at line 1110 of file fsl_sai.h.

◆ SAI_RxGetDataRegisterAddress()

static uint32_t SAI_RxGetDataRegisterAddress	(	I2S_Type *	base,
		uint32_t	channel
	)

inlinestatic

Gets the SAI Rx data register address.

This API is used to provide a transfer address for the SAI DMA transfer configuration.

Parameters

base	SAI base pointer.
channel	Which data channel used.

Returns: data register address.

Definition at line 1221 of file fsl_sai.h.

◆ SAI_RxGetDefaultConfig()

void SAI_RxGetDefaultConfig ( sai_config_t * config )

Sets the SAI Rx configuration structure to default values.

Deprecated:: Do not use this function. It has been superceded by SAI_GetClassicI2SConfig, SAI_GetLeftJustifiedConfig , SAI_GetRightJustifiedConfig, SAI_GetDSPConfig, SAI_GetTDMConfig

This API initializes the configuration structure for use in SAI_RxConfig(). The initialized structure can remain unchanged in SAI_RxConfig() or it can be modified before calling SAI_RxConfig(). This is an example.

sai_config_t config;

SAI_RxGetDefaultConfig(&config);

Parameters

config pointer to master configuration structure

brief Sets the SAI Rx configuration structure to default values.

deprecated Do not use this function. It has been superceded by SAI_GetClassicI2SConfig,SAI_GetLeftJustifiedConfig,SAI_GetRightJustifiedConfig,SAI_GetDSPConfig,SAI_GetTDMConfig

This API initializes the configuration structure for use in SAI_RxConfig(). The initialized structure can remain unchanged in SAI_RxConfig() or it can be modified before calling SAI_RxConfig(). This is an example. code sai_config_t config; SAI_RxGetDefaultConfig(&config); endcode

param config pointer to master configuration structure

Definition at line 736 of file fsl_sai.c.

◆ SAI_RxGetStatusFlag()

static uint32_t SAI_RxGetStatusFlag ( I2S_Type * base )

inlinestatic

Gets the SAI Tx status flag state.

Parameters

base	SAI base pointer

Returns: SAI Rx status flag value. Use the Status Mask to get the status value needed.

Definition at line 901 of file fsl_sai.h.

◆ SAI_RxInit()

void SAI_RxInit	(	I2S_Type *	base,
		const sai_config_t *	config
	)

Initializes the SAI Rx peripheral.

Deprecated:: Do not use this function. It has been superceded by SAI_Init

Ungates the SAI clock, resets the module, and configures the SAI Rx with a configuration structure. The configuration structure can be custom filled or set with default values by SAI_RxGetDefaultConfig().

Note: This API should be called at the beginning of the application to use the SAI driver. Otherwise, accessing the SAI module can cause a hard fault because the clock is not enabled.

Parameters

base	SAI base pointer
config	SAI configuration structure.

brief Initializes the SAI Rx peripheral.

deprecated Do not use this function. It has been superceded by SAI_Init

Ungates the SAI clock, resets the module, and configures the SAI Rx with a configuration structure. The configuration structure can be custom filled or set with default values by SAI_RxGetDefaultConfig().

note This API should be called at the beginning of the application to use the SAI driver. Otherwise, accessing the SAI module can cause a hard fault because the clock is not enabled.

param base SAI base pointer param config SAI configuration structure.

Definition at line 533 of file fsl_sai.c.

◆ SAI_RxReset()

void SAI_RxReset ( I2S_Type * base )

Resets the SAI Rx.

This function enables the software reset and FIFO reset of SAI Rx. After reset, clear the reset bit.

Parameters

base	SAI base pointer

brief Resets the SAI Rx.

This function enables the software reset and FIFO reset of SAI Rx. After reset, clear the reset bit.

param base SAI base pointer

Definition at line 783 of file fsl_sai.c.

◆ SAI_RxSetBitclockConfig()

void SAI_RxSetBitclockConfig	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave,
		sai_bit_clock_t *	config
	)

Receiver Bit clock configurations.

Parameters

base	SAI base pointer.
masterSlave	master or slave.
config	bit clock other configurations, can be NULL in slave mode.

brief Receiver Bit clock configurations.

param base SAI base pointer. param masterSlave master or slave. param config bit clock other configurations, can be NULL in slave mode.

Definition at line 1167 of file fsl_sai.c.

◆ SAI_RxSetBitClockDirection()

static void SAI_RxSetBitClockDirection	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave
	)

inlinestatic

Set Rx bit clock direction.

Select bit clock direction, master or slave.

Parameters

base	SAI base pointer.
masterSlave	reference sai_master_slave_t.

Definition at line 622 of file fsl_sai.h.

◆ SAI_RxSetBitClockPolarity()

void SAI_RxSetBitClockPolarity	(	I2S_Type *	base,
		sai_clock_polarity_t	polarity
	)

Set the Rx data order.

Parameters

base	SAI base pointer
polarity	brief Set the Rx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 971 of file fsl_sai.c.

◆ SAI_RxSetBitClockRate()

void SAI_RxSetBitClockRate	(	I2S_Type *	base,
		uint32_t	sourceClockHz,
		uint32_t	sampleRate,
		uint32_t	bitWidth,
		uint32_t	channelNumbers
	)

Receiver bit clock rate configurations.

Parameters

base	SAI base pointer.
sourceClockHz	Bit clock source frequency.
sampleRate	Audio data sample rate.
bitWidth	Audio data bitWidth.
channelNumbers	Audio channel numbers.

brief Receiver bit clock rate configurations.

param base SAI base pointer. param sourceClockHz, bit clock source frequency. param sampleRate audio data sample rate. param bitWidth, audio data bitWidth. param channelNumbers, audio channel numbers.

Definition at line 1095 of file fsl_sai.c.

◆ SAI_RxSetChannelFIFOMask()

void SAI_RxSetChannelFIFOMask	(	I2S_Type *	base,
		uint8_t	mask
	)

Set the Rx channel FIFO enable mask.

Parameters

base	SAI base pointer
mask	Channel enable mask, 0 means all channel FIFO disabled, 1 means channel 0 enabled, 3 means both channel 0 and channel 1 enabled.

brief Set the Rx channel FIFO enable mask.

param base SAI base pointer param mask Channel enable mask, 0 means all channel FIFO disabled, 1 means channel 0 enabled, 3 means both channel 0 and channel 1 enabled.

Definition at line 917 of file fsl_sai.c.

◆ SAI_RxSetConfig()

void SAI_RxSetConfig	(	I2S_Type *	base,
		sai_transceiver_t *	config
	)

SAI receiver configurations.

Parameters

base	SAI base pointer.
config	receiver configurations.

brief SAI receiver configurations.

param base SAI base pointer. param config transmitter configurations.

Definition at line 1562 of file fsl_sai.c.

◆ SAI_RxSetDataOrder()

void SAI_RxSetDataOrder	(	I2S_Type *	base,
		sai_data_order_t	order
	)

Set the Rx data order.

Parameters

base	SAI base pointer
order	Data order MSB or LSB

brief Set the Rx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 943 of file fsl_sai.c.

◆ SAI_RxSetFormat()

void SAI_RxSetFormat	(	I2S_Type *	base,
		sai_transfer_format_t *	format,
		uint32_t	mclkSourceClockHz,
		uint32_t	bclkSourceClockHz
	)

Configures the SAI Rx audio format.

Deprecated:: Do not use this function. It has been superceded by SAI_RxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

Parameters

base	SAI base pointer.
format	Pointer to the SAI audio data format structure.
mclkSourceClockHz	SAI master clock source frequency in Hz.
bclkSourceClockHz	SAI bit clock source frequency in Hz. If the bit clock source is a master clock, this value should equal the masterClockHz.

brief Configures the SAI Rx audio format.

deprecated Do not use this function. It has been superceded by SAI_RxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

param base SAI base pointer. param format Pointer to the SAI audio data format structure. param mclkSourceClockHz SAI master clock source frequency in Hz. param bclkSourceClockHz SAI bit clock source frequency in Hz. If the bit clock source is a master clock, this value should equal the masterClockHz.

Definition at line 1972 of file fsl_sai.c.

◆ SAI_RxSetFrameSyncConfig()

void SAI_RxSetFrameSyncConfig	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave,
		sai_frame_sync_t *	config
	)

SAI receiver Frame sync configurations.

Parameters

base	SAI base pointer.
masterSlave	master or slave.
config	frame sync configurations, can be NULL in slave mode.

brief SAI receiver Frame sync configurations.

param base SAI base pointer. param masterSlave master or slave. param config frame sync configurations, can be NULL in slave mode.

Definition at line 1344 of file fsl_sai.c.

◆ SAI_RxSetFrameSyncDirection()

static void SAI_RxSetFrameSyncDirection	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave
	)

inlinestatic

Set Rx frame sync direction.

Select frame sync direction, master or slave.

Parameters

base	SAI base pointer.
masterSlave	reference sai_master_slave_t.

Definition at line 642 of file fsl_sai.h.

◆ SAI_RxSetFrameSyncPolarity()

void SAI_RxSetFrameSyncPolarity	(	I2S_Type *	base,
		sai_clock_polarity_t	polarity
	)

Set the Rx data order.

Parameters

base	SAI base pointer
polarity	brief Set the Rx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 999 of file fsl_sai.c.

◆ SAI_RxSetSerialDataConfig()

void SAI_RxSetSerialDataConfig	(	I2S_Type *	base,
		sai_serial_data_t *	config
	)

SAI receiver Serial data configurations.

Parameters

base	SAI base pointer.
config	serial data configurations.

Definition at line 1411 of file fsl_sai.c.

◆ SAI_RxSoftwareReset()

void SAI_RxSoftwareReset	(	I2S_Type *	base,
		sai_reset_type_t	type
	)

Do software reset or FIFO reset .

FIFO reset means clear all the data in the FIFO, and make the FIFO pointer both to 0. Software reset means clear the Rx internal logic, including the bit clock, frame count etc. But software reset will not clear any configuration registers like RCR1~RCR5. This function will also clear all the error flags such as FIFO error, sync error etc.

Parameters

base	SAI base pointer
type	Reset type, FIFO reset or software reset

brief Do software reset or FIFO reset .

FIFO reset means clear all the data in the FIFO, and make the FIFO pointer both to 0. Software reset means clear the Rx internal logic, including the bit clock, frame count etc. But software reset will not clear any configuration registers like RCR1~RCR5. This function will also clear all the error flags such as FIFO error, sync error etc.

param base SAI base pointer param type Reset type, FIFO reset or software reset

Definition at line 889 of file fsl_sai.c.

◆ SAI_TransferAbortReceive()

void SAI_TransferAbortReceive	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Aborts the current IRQ receive.

Note: This API can be called when an interrupt non-blocking transfer initiates to abort the transfer early.

Parameters

base	SAI base pointer
handle	Pointer to the sai_handle_t structure which stores the transfer state.

brief Aborts the current IRQ receive.

note This API can be called when an interrupt non-blocking transfer initiates to abort the transfer early.

param base SAI base pointer param handle Pointer to the sai_handle_t structure which stores the transfer state.

Definition at line 2627 of file fsl_sai.c.

◆ SAI_TransferAbortSend()

void SAI_TransferAbortSend	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Aborts the current send.

Note: This API can be called any time when an interrupt non-blocking transfer initiates to abort the transfer early.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure which stores the transfer state.

brief Aborts the current send.

note This API can be called any time when an interrupt non-blocking transfer initiates to abort the transfer early.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure which stores the transfer state.

Definition at line 2597 of file fsl_sai.c.

◆ SAI_TransferGetReceiveCount()

status_t SAI_TransferGetReceiveCount	(	I2S_Type *	base,
		sai_handle_t *	handle,
		size_t *	count
	)

Gets a received byte count.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure which stores the transfer state.
count	Bytes count received.

Return values

kStatus_Success	Succeed get the transfer count.
kStatus_NoTransferInProgress	There is not a non-blocking transaction currently in progress.

brief Gets a received byte count.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure which stores the transfer state. param count Bytes count received. retval kStatus_Success Succeed get the transfer count. retval kStatus_NoTransferInProgress There is not a non-blocking transaction currently in progress.

Definition at line 2569 of file fsl_sai.c.

◆ SAI_TransferGetSendCount()

status_t SAI_TransferGetSendCount	(	I2S_Type *	base,
		sai_handle_t *	handle,
		size_t *	count
	)

Gets a set byte count.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure which stores the transfer state.
count	Bytes count sent.

Return values

kStatus_Success	Succeed get the transfer count.
kStatus_NoTransferInProgress	There is not a non-blocking transaction currently in progress.

brief Gets a set byte count.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure which stores the transfer state. param count Bytes count sent. retval kStatus_Success Succeed get the transfer count. retval kStatus_NoTransferInProgress There is not a non-blocking transaction currently in progress.

Definition at line 2541 of file fsl_sai.c.

◆ SAI_TransferReceiveNonBlocking()

status_t SAI_TransferReceiveNonBlocking	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_t *	xfer
	)

Performs an interrupt non-blocking receive transfer on SAI.

Note: This API returns immediately after the transfer initiates. Call the SAI_RxGetTransferStatusIRQ to poll the transfer status and check whether the transfer is finished. If the return status is not kStatus_SAI_Busy, the transfer is finished.

Parameters

base	SAI base pointer
handle	Pointer to the sai_handle_t structure which stores the transfer state.
xfer	Pointer to the sai_transfer_t structure.

Return values

kStatus_Success	Successfully started the data receive.
kStatus_SAI_RxBusy	Previous receive still not finished.
kStatus_InvalidArgument	The input parameter is invalid.

brief Performs an interrupt non-blocking receive transfer on SAI.

note This API returns immediately after the transfer initiates. Call the SAI_RxGetTransferStatusIRQ to poll the transfer status and check whether the transfer is finished. If the return status is not kStatus_SAI_Busy, the transfer is finished.

param base SAI base pointer param handle Pointer to the sai_handle_t structure which stores the transfer state. param xfer Pointer to the sai_transfer_t structure. retval kStatus_Success Successfully started the data receive. retval kStatus_SAI_RxBusy Previous receive still not finished. retval kStatus_InvalidArgument The input parameter is invalid.

Definition at line 2498 of file fsl_sai.c.

◆ SAI_TransferRxCreateHandle()

void SAI_TransferRxCreateHandle	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_callback_t	callback,
		void *	userData
	)

Initializes the SAI Rx handle.

This function initializes the Rx handle for the SAI Rx transactional APIs. Call this function once to get the handle initialized.

Parameters

base	SAI base pointer.
handle	SAI handle pointer.
callback	Pointer to the user callback function.
userData	User parameter passed to the callback function.

brief Initializes the SAI Rx handle.

This function initializes the Rx handle for the SAI Rx transactional APIs. Call this function once to get the handle initialized.

param base SAI base pointer. param handle SAI handle pointer. param callback Pointer to the user callback function. param userData User parameter passed to the callback function.

Definition at line 2314 of file fsl_sai.c.

◆ SAI_TransferRxHandleIRQ()

void SAI_TransferRxHandleIRQ	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Tx interrupt handler.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure.

brief Tx interrupt handler.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure.

Definition at line 2779 of file fsl_sai.c.

◆ SAI_TransferRxSetConfig()

void SAI_TransferRxSetConfig	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transceiver_t *	config
	)

SAI receiver transfer configurations.

This function initializes the Rx, include bit clock, frame sync, master clock, serial data and fifo configurations.

Parameters

base	SAI base pointer.
handle	SAI handle pointer.
config	receiver configurations.

brief SAI receiver transfer configurations.

This function initializes the TX, include bit clock, frame sync, master clock, serial data and fifo configurations.

param base SAI base pointer. param handle SAI handle pointer. param config tranmitter configurations.

Definition at line 1665 of file fsl_sai.c.

◆ SAI_TransferRxSetFormat()

status_t SAI_TransferRxSetFormat	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_format_t *	format,
		uint32_t	mclkSourceClockHz,
		uint32_t	bclkSourceClockHz
	)

Configures the SAI Rx audio format.

Deprecated:: Do not use this function. It has been superceded by SAI_TransferRxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

Parameters

base	SAI base pointer.
handle	SAI handle pointer.
format	Pointer to the SAI audio data format structure.
mclkSourceClockHz	SAI master clock source frequency in Hz.
bclkSourceClockHz	SAI bit clock source frequency in Hz. If a bit clock source is a master clock, this value should equal the masterClockHz in format.

Returns: Status of this function. Return value is one of status_t.

brief Configures the SAI Rx audio format.

deprecated Do not use this function. It has been superceded by SAI_TransferRxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

param base SAI base pointer. param handle SAI handle pointer. param format Pointer to the SAI audio data format structure. param mclkSourceClockHz SAI master clock source frequency in Hz. param bclkSourceClockHz SAI bit clock source frequency in Hz. If a bit clock source is a master clock, this value should equal the masterClockHz in format. return Status of this function. Return value is one of status_t.

Definition at line 2400 of file fsl_sai.c.

◆ SAI_TransferSendNonBlocking()

status_t SAI_TransferSendNonBlocking	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_t *	xfer
	)

Performs an interrupt non-blocking send transfer on SAI.

Note: This API returns immediately after the transfer initiates. Call the SAI_TxGetTransferStatusIRQ to poll the transfer status and check whether the transfer is finished. If the return status is not kStatus_SAI_Busy, the transfer is finished.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure which stores the transfer state.
xfer	Pointer to the sai_transfer_t structure.

Return values

kStatus_Success	Successfully started the data receive.
kStatus_SAI_TxBusy	Previous receive still not finished.
kStatus_InvalidArgument	The input parameter is invalid.

brief Performs an interrupt non-blocking send transfer on SAI.

note This API returns immediately after the transfer initiates. Call the SAI_TxGetTransferStatusIRQ to poll the transfer status and check whether the transfer is finished. If the return status is not kStatus_SAI_Busy, the transfer is finished.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure which stores the transfer state. param xfer Pointer to the sai_transfer_t structure. retval kStatus_Success Successfully started the data receive. retval kStatus_SAI_TxBusy Previous receive still not finished. retval kStatus_InvalidArgument The input parameter is invalid.

Definition at line 2449 of file fsl_sai.c.

◆ SAI_TransferTerminateReceive()

void SAI_TransferTerminateReceive	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Terminate all SAI receive.

This function will clear all transfer slots buffered in the sai queue. If users only want to abort the current transfer slot, please call SAI_TransferAbortReceive.

Parameters

base	SAI base pointer.
handle	SAI eDMA handle pointer.

brief Terminate all SAI receive.

This function will clear all transfer slots buffered in the sai queue. If users only want to abort the current transfer slot, please call SAI_TransferAbortReceive.

param base SAI base pointer. param handle SAI eDMA handle pointer.

Definition at line 2681 of file fsl_sai.c.

◆ SAI_TransferTerminateSend()

void SAI_TransferTerminateSend	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Terminate all SAI send.

This function will clear all transfer slots buffered in the sai queue. If users only want to abort the current transfer slot, please call SAI_TransferAbortSend.

Parameters

base	SAI base pointer.
handle	SAI eDMA handle pointer.

brief Terminate all SAI send.

This function will clear all transfer slots buffered in the sai queue. If users only want to abort the current transfer slot, please call SAI_TransferAbortSend.

param base SAI base pointer. param handle SAI eDMA handle pointer.

Definition at line 2657 of file fsl_sai.c.

◆ SAI_TransferTxCreateHandle()

void SAI_TransferTxCreateHandle	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_callback_t	callback,
		void *	userData
	)

Initializes the SAI Tx handle.

This function initializes the Tx handle for the SAI Tx transactional APIs. Call this function once to get the handle initialized.

Parameters

base	SAI base pointer
handle	SAI handle pointer.
callback	Pointer to the user callback function.
userData	User parameter passed to the callback function

brief Initializes the SAI Tx handle.

This function initializes the Tx handle for the SAI Tx transactional APIs. Call this function once to get the handle initialized.

param base SAI base pointer param handle SAI handle pointer. param callback Pointer to the user callback function. param userData User parameter passed to the callback function

Definition at line 2283 of file fsl_sai.c.

◆ SAI_TransferTxHandleIRQ()

void SAI_TransferTxHandleIRQ	(	I2S_Type *	base,
		sai_handle_t *	handle
	)

Tx interrupt handler.

Parameters

base	SAI base pointer.
handle	Pointer to the sai_handle_t structure.

brief Tx interrupt handler.

param base SAI base pointer. param handle Pointer to the sai_handle_t structure.

Definition at line 2702 of file fsl_sai.c.

◆ SAI_TransferTxSetConfig()

void SAI_TransferTxSetConfig	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transceiver_t *	config
	)

SAI transmitter transfer configurations.

This function initializes the Tx, include bit clock, frame sync, master clock, serial data and fifo configurations.

Parameters

base	SAI base pointer.
handle	SAI handle pointer.
config	tranmitter configurations.

brief SAI transmitter transfer configurations.

This function initializes the TX, include bit clock, frame sync, master clock, serial data and fifo configurations.

param base SAI base pointer. param handle SAI handle pointer. param config tranmitter configurations.

Definition at line 1535 of file fsl_sai.c.

◆ SAI_TransferTxSetFormat()

status_t SAI_TransferTxSetFormat	(	I2S_Type *	base,
		sai_handle_t *	handle,
		sai_transfer_format_t *	format,
		uint32_t	mclkSourceClockHz,
		uint32_t	bclkSourceClockHz
	)

Configures the SAI Tx audio format.

Deprecated:: Do not use this function. It has been superceded by SAI_TransferTxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

Parameters

base	SAI base pointer.
handle	SAI handle pointer.
format	Pointer to the SAI audio data format structure.
mclkSourceClockHz	SAI master clock source frequency in Hz.
bclkSourceClockHz	SAI bit clock source frequency in Hz. If a bit clock source is a master clock, this value should equal the masterClockHz in format.

Returns: Status of this function. Return value is the status_t.

brief Configures the SAI Tx audio format.

deprecated Do not use this function. It has been superceded by SAI_TransferTxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

param base SAI base pointer. param handle SAI handle pointer. param format Pointer to the SAI audio data format structure. param mclkSourceClockHz SAI master clock source frequency in Hz. param bclkSourceClockHz SAI bit clock source frequency in Hz. If a bit clock source is a master clock, this value should equal the masterClockHz in format. return Status of this function. Return value is the status_t.

Definition at line 2350 of file fsl_sai.c.

◆ SAI_TxClearStatusFlags()

static void SAI_TxClearStatusFlags	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Clears the SAI Tx status flag state.

Parameters

base	SAI base pointer
mask	State mask. It can be a combination of the following source if defined: kSAI_WordStartFlag kSAI_SyncErrorFlag kSAI_FIFOErrorFlag

Definition at line 890 of file fsl_sai.h.

◆ SAI_TxDisableInterrupts()

static void SAI_TxDisableInterrupts	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Disables the SAI Tx interrupt requests.

Parameters

base	SAI base pointer
mask	interrupt source The parameter can be a combination of the following sources if defined. kSAI_WordStartInterruptEnable kSAI_SyncErrorInterruptEnable kSAI_FIFOWarningInterruptEnable kSAI_FIFORequestInterruptEnable kSAI_FIFOErrorInterruptEnable

Definition at line 1127 of file fsl_sai.h.

◆ SAI_TxEnable()

void SAI_TxEnable	(	I2S_Type *	base,
		bool	enable
	)

Enables/disables the SAI Tx.

Parameters

base	SAI base pointer.
enable	True means enable SAI Tx, false means disable.

brief Enables/disables the SAI Tx.

param base SAI base pointer param enable True means enable SAI Tx, false means disable.

Definition at line 805 of file fsl_sai.c.

◆ SAI_TxEnableDMA()

static void SAI_TxEnableDMA	(	I2S_Type *	base,
		uint32_t	mask,
		bool	enable
	)

inlinestatic

Enables/disables the SAI Tx DMA requests.

Parameters

base	SAI base pointer
mask	DMA source The parameter can be combination of the following sources if defined. kSAI_FIFOWarningDMAEnable kSAI_FIFORequestDMAEnable
enable	True means enable DMA, false means disable DMA.

Definition at line 1165 of file fsl_sai.h.

◆ SAI_TxEnableInterrupts()

static void SAI_TxEnableInterrupts	(	I2S_Type *	base,
		uint32_t	mask
	)

inlinestatic

Enables the SAI Tx interrupt requests.

Parameters

base	SAI base pointer
mask	interrupt source The parameter can be a combination of the following sources if defined. kSAI_WordStartInterruptEnable kSAI_SyncErrorInterruptEnable kSAI_FIFOWarningInterruptEnable kSAI_FIFORequestInterruptEnable kSAI_FIFOErrorInterruptEnable

Definition at line 1093 of file fsl_sai.h.

◆ SAI_TxGetDataRegisterAddress()

static uint32_t SAI_TxGetDataRegisterAddress	(	I2S_Type *	base,
		uint32_t	channel
	)

inlinestatic

Gets the SAI Tx data register address.

This API is used to provide a transfer address for the SAI DMA transfer configuration.

Parameters

base	SAI base pointer.
channel	Which data channel used.

Returns: data register address.

Definition at line 1207 of file fsl_sai.h.

◆ SAI_TxGetDefaultConfig()

void SAI_TxGetDefaultConfig ( sai_config_t * config )

Sets the SAI Tx configuration structure to default values.

Deprecated:: Do not use this function. It has been superceded by SAI_GetClassicI2SConfig, SAI_GetLeftJustifiedConfig , SAI_GetRightJustifiedConfig, SAI_GetDSPConfig, SAI_GetTDMConfig

This API initializes the configuration structure for use in SAI_TxConfig(). The initialized structure can remain unchanged in SAI_TxConfig(), or it can be modified before calling SAI_TxConfig(). This is an example.

sai_config_t config;

SAI_TxGetDefaultConfig(&config);

Parameters

config pointer to master configuration structure

brief Sets the SAI Tx configuration structure to default values.

deprecated Do not use this function. It has been superceded by SAI_GetClassicI2SConfig, SAI_GetLeftJustifiedConfig,SAI_GetRightJustifiedConfig, SAI_GetDSPConfig,SAI_GetTDMConfig

This API initializes the configuration structure for use in SAI_TxConfig(). The initialized structure can remain unchanged in SAI_TxConfig(), or it can be modified before calling SAI_TxConfig(). This is an example. code sai_config_t config; SAI_TxGetDefaultConfig(&config); endcode

param config pointer to master configuration structure

Definition at line 702 of file fsl_sai.c.

◆ SAI_TxGetStatusFlag()

static uint32_t SAI_TxGetStatusFlag ( I2S_Type * base )

inlinestatic

Gets the SAI Tx status flag state.

Parameters

base	SAI base pointer

Returns: SAI Tx status flag value. Use the Status Mask to get the status value needed.

Definition at line 876 of file fsl_sai.h.

◆ SAI_TxInit()

void SAI_TxInit	(	I2S_Type *	base,
		const sai_config_t *	config
	)

Initializes the SAI Tx peripheral.

Deprecated:: Do not use this function. It has been superceded by SAI_Init

Ungates the SAI clock, resets the module, and configures SAI Tx with a configuration structure. The configuration structure can be custom filled or set with default values by SAI_TxGetDefaultConfig().

Note: This API should be called at the beginning of the application to use the SAI driver. Otherwise, accessing the SAIM module can cause a hard fault because the clock is not enabled.

Parameters

base	SAI base pointer
config	SAI configuration structure.

brief Initializes the SAI Tx peripheral.

deprecated Do not use this function. It has been superceded by SAI_Init

Ungates the SAI clock, resets the module, and configures SAI Tx with a configuration structure. The configuration structure can be custom filled or set with default values by SAI_TxGetDefaultConfig().

note This API should be called at the beginning of the application to use the SAI driver. Otherwise, accessing the SAIM module can cause a hard fault because the clock is not enabled.

param base SAI base pointer param config SAI configuration structure.

Definition at line 409 of file fsl_sai.c.

◆ SAI_TxReset()

void SAI_TxReset ( I2S_Type * base )

Resets the SAI Tx.

This function enables the software reset and FIFO reset of SAI Tx. After reset, clear the reset bit.

Parameters

base	SAI base pointer

brief Resets the SAI Tx.

This function enables the software reset and FIFO reset of SAI Tx. After reset, clear the reset bit.

param base SAI base pointer

Definition at line 760 of file fsl_sai.c.

◆ SAI_TxSetBitclockConfig()

void SAI_TxSetBitclockConfig	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave,
		sai_bit_clock_t *	config
	)

Transmitter Bit clock configurations.

Parameters

base	SAI base pointer.
masterSlave	master or slave.
config	bit clock other configurations, can be NULL in slave mode.

brief Transmitter Bit clock configurations.

param base SAI base pointer. param masterSlave master or slave. param config bit clock other configurations, can be NULL in slave mode.

Definition at line 1140 of file fsl_sai.c.

◆ SAI_TxSetBitClockDirection()

static void SAI_TxSetBitClockDirection	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave
	)

inlinestatic

Set Rx bit clock direction.

Select bit clock direction, master or slave.

Parameters

base	SAI base pointer.
masterSlave	reference sai_master_slave_t.

Definition at line 602 of file fsl_sai.h.

◆ SAI_TxSetBitClockPolarity()

void SAI_TxSetBitClockPolarity	(	I2S_Type *	base,
		sai_clock_polarity_t	polarity
	)

Set the Tx data order.

Parameters

base	SAI base pointer
polarity	brief Set the Tx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 957 of file fsl_sai.c.

◆ SAI_TxSetBitClockRate()

void SAI_TxSetBitClockRate	(	I2S_Type *	base,
		uint32_t	sourceClockHz,
		uint32_t	sampleRate,
		uint32_t	bitWidth,
		uint32_t	channelNumbers
	)

Transmitter bit clock rate configurations.

Parameters

base	SAI base pointer.
sourceClockHz	Bit clock source frequency.
sampleRate	Audio data sample rate.
bitWidth	Audio data bitWidth.
channelNumbers	Audio channel numbers.

brief Transmitter bit clock rate configurations.

param base SAI base pointer. param sourceClockHz, bit clock source frequency. param sampleRate audio data sample rate. param bitWidth, audio data bitWidth. param channelNumbers, audio channel numbers.

Definition at line 1048 of file fsl_sai.c.

◆ SAI_TxSetChannelFIFOMask()

void SAI_TxSetChannelFIFOMask	(	I2S_Type *	base,
		uint8_t	mask
	)

Set the Tx channel FIFO enable mask.

Parameters

base	SAI base pointer
mask	Channel enable mask, 0 means all channel FIFO disabled, 1 means channel 0 enabled, 3 means both channel 0 and channel 1 enabled.

brief Set the Tx channel FIFO enable mask.

param base SAI base pointer param mask Channel enable mask, 0 means all channel FIFO disabled, 1 means channel 0 enabled, 3 means both channel 0 and channel 1 enabled.

Definition at line 904 of file fsl_sai.c.

◆ SAI_TxSetConfig()

void SAI_TxSetConfig	(	I2S_Type *	base,
		sai_transceiver_t *	config
	)

SAI transmitter configurations.

Parameters

base	SAI base pointer.
config	transmitter configurations.

brief SAI transmitter configurations.

param base SAI base pointer. param config transmitter configurations.

Definition at line 1433 of file fsl_sai.c.

◆ SAI_TxSetDataOrder()

void SAI_TxSetDataOrder	(	I2S_Type *	base,
		sai_data_order_t	order
	)

Set the Tx data order.

Parameters

base	SAI base pointer
order	Data order MSB or LSB

brief Set the Tx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 929 of file fsl_sai.c.

◆ SAI_TxSetFormat()

void SAI_TxSetFormat	(	I2S_Type *	base,
		sai_transfer_format_t *	format,
		uint32_t	mclkSourceClockHz,
		uint32_t	bclkSourceClockHz
	)

Configures the SAI Tx audio format.

Deprecated:: Do not use this function. It has been superceded by SAI_TxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

Parameters

base	SAI base pointer.
format	Pointer to the SAI audio data format structure.
mclkSourceClockHz	SAI master clock source frequency in Hz.
bclkSourceClockHz	SAI bit clock source frequency in Hz. If the bit clock source is a master clock, this value should equal the masterClockHz.

brief Configures the SAI Tx audio format.

deprecated Do not use this function. It has been superceded by SAI_TxSetConfig

The audio format can be changed at run-time. This function configures the sample rate and audio data format to be transferred.

param base SAI base pointer. param format Pointer to the SAI audio data format structure. param mclkSourceClockHz SAI master clock source frequency in Hz. param bclkSourceClockHz SAI bit clock source frequency in Hz. If the bit clock source is a master clock, this value should equal the masterClockHz.

Definition at line 1829 of file fsl_sai.c.

◆ SAI_TxSetFrameSyncConfig()

void SAI_TxSetFrameSyncConfig	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave,
		sai_frame_sync_t *	config
	)

SAI transmitter Frame sync configurations.

Parameters

base	SAI base pointer.
masterSlave	master or slave.
config	frame sync configurations, can be NULL in slave mode.

brief SAI transmitter Frame sync configurations.

param base SAI base pointer. param masterSlave master or slave. param config frame sync configurations, can be NULL in slave mode.

Definition at line 1310 of file fsl_sai.c.

◆ SAI_TxSetFrameSyncDirection()

static void SAI_TxSetFrameSyncDirection	(	I2S_Type *	base,
		sai_master_slave_t	masterSlave
	)

inlinestatic

Set Tx frame sync direction.

Select frame sync direction, master or slave.

Parameters

base	SAI base pointer.
masterSlave	reference sai_master_slave_t.

Definition at line 662 of file fsl_sai.h.

◆ SAI_TxSetFrameSyncPolarity()

void SAI_TxSetFrameSyncPolarity	(	I2S_Type *	base,
		sai_clock_polarity_t	polarity
	)

Set the Tx data order.

Parameters

base	SAI base pointer
polarity	brief Set the Tx data order.

param base SAI base pointer param order Data order MSB or LSB

Definition at line 985 of file fsl_sai.c.

◆ SAI_TxSetSerialDataConfig()

void SAI_TxSetSerialDataConfig	(	I2S_Type *	base,
		sai_serial_data_t *	config
	)

SAI transmitter Serial data configurations.

Parameters

base	SAI base pointer.
config	serial data configurations.

brief SAI transmitter Serial data configurations.

param base SAI base pointer. param config serial data configurations.

Definition at line 1377 of file fsl_sai.c.

◆ SAI_TxSoftwareReset()

void SAI_TxSoftwareReset	(	I2S_Type *	base,
		sai_reset_type_t	type
	)

Do software reset or FIFO reset .

FIFO reset means clear all the data in the FIFO, and make the FIFO pointer both to 0. Software reset means clear the Tx internal logic, including the bit clock, frame count etc. But software reset will not clear any configuration registers like TCR1~TCR5. This function will also clear all the error flags such as FIFO error, sync error etc.

Parameters

base	SAI base pointer
type	Reset type, FIFO reset or software reset

brief Do software reset or FIFO reset .

FIFO reset means clear all the data in the FIFO, and make the FIFO pointer both to 0. Software reset means clear the Tx internal logic, including the bit clock, frame count etc. But software reset will not clear any configuration registers like TCR1~TCR5. This function will also clear all the error flags such as FIFO error, sync error etc.

param base SAI base pointer param type Reset type, FIFO reset or software reset

Definition at line 870 of file fsl_sai.c.

◆ SAI_WriteBlocking()

void SAI_WriteBlocking	(	I2S_Type *	base,
		uint32_t	channel,
		uint32_t	bitWidth,
		uint8_t *	buffer,
		uint32_t	size
	)

Sends data using a blocking method.

Note: This function blocks by polling until data is ready to be sent.

Parameters

base	SAI base pointer.
channel	Data channel used.
bitWidth	How many bits in an audio word; usually 8/16/24/32 bits.
buffer	Pointer to the data to be written.
size	Bytes to be written.

brief Sends data using a blocking method.

note This function blocks by polling until data is ready to be sent.

param base SAI base pointer. param channel Data channel used. param bitWidth How many bits in an audio word; usually 8/16/24/32 bits. param buffer Pointer to the data to be written. param size Bytes to be written.

Definition at line 2113 of file fsl_sai.c.

◆ SAI_WriteData()

static void SAI_WriteData	(	I2S_Type *	base,
		uint32_t	channel,
		uint32_t	data
	)

inlinestatic

Writes data into SAI FIFO.

Parameters

base	SAI base pointer.
channel	Data channel used.
data	Data needs to be written.

Definition at line 1304 of file fsl_sai.h.

◆ SAI_WriteMultiChannelBlocking()

void SAI_WriteMultiChannelBlocking	(	I2S_Type *	base,
		uint32_t	channel,
		uint32_t	channelMask,
		uint32_t	bitWidth,
		uint8_t *	buffer,
		uint32_t	size
	)

Sends data to multi channel using a blocking method.

Note: This function blocks by polling until data is ready to be sent.

Parameters

base	SAI base pointer.
channel	Data channel used.
channelMask	channel mask.
bitWidth	How many bits in an audio word; usually 8/16/24/32 bits.
buffer	Pointer to the data to be written.
size	Bytes to be written.

brief Sends data to multi channel using a blocking method.

note This function blocks by polling until data is ready to be sent.

param base SAI base pointer. param channel Data channel used. param channelMask channel mask. param bitWidth How many bits in an audio word; usually 8/16/24/32 bits. param buffer Pointer to the data to be written. param size Bytes to be written.

Definition at line 2151 of file fsl_sai.c.

Classes

Driver version

Initialization and deinitialization

Status

Interrupts

DMA Control

Bus Operations

Transactional

Detailed Description

Macro Definition Documentation

◆ FSL_SAI_DRIVER_VERSION

◆ FSL_SAI_HAS_FIFO_EXTEND_FEATURE

◆ SAI_XFER_QUEUE_SIZE

Typedef Documentation

◆ sai_bclk_source_t

◆ sai_bit_clock_t

◆ sai_clock_polarity_t

◆ sai_config_t

◆ sai_data_order_t

◆ sai_frame_sync_len_t

◆ sai_frame_sync_t

◆ sai_handle_t

◆ sai_master_slave_t

◆ sai_mclk_source_t

◆ sai_mono_stereo_t

◆ sai_protocol_t

◆ sai_reset_type_t

◆ sai_sample_rate_t

◆ sai_serial_data_t

◆ sai_sync_mode_t

◆ sai_transceiver_t

◆ sai_transceiver_type_t

◆ sai_transfer_callback_t

◆ sai_transfer_format_t

◆ sai_transfer_t

◆ sai_word_width_t

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ _sai_bclk_source

◆ _sai_clock_polarity

◆ _sai_data_order

◆ _sai_frame_sync_len

◆ _sai_master_slave

◆ _sai_mclk_source

◆ _sai_mono_stereo

◆ _sai_protocol

◆ _sai_reset_type

◆ _sai_sample_rate

◆ _sai_sync_mode

◆ _sai_transceiver_type

◆ _sai_word_width

Function Documentation

◆ SAI_Deinit()

◆ SAI_GetClassicI2SConfig()

◆ SAI_GetDSPConfig()

◆ SAI_GetLeftJustifiedConfig()

◆ SAI_GetRightJustifiedConfig()

◆ SAI_GetTDMConfig()

◆ SAI_Init()

◆ SAI_ReadBlocking()

◆ SAI_ReadData()

◆ SAI_ReadMultiChannelBlocking()

◆ SAI_RxClearStatusFlags()

◆ SAI_RxDisableInterrupts()

◆ SAI_RxEnable()

◆ SAI_RxEnableDMA()

◆ SAI_RxEnableInterrupts()

◆ SAI_RxGetDataRegisterAddress()

◆ SAI_RxGetDefaultConfig()

◆ SAI_RxGetStatusFlag()

◆ SAI_RxInit()

◆ SAI_RxReset()

◆ SAI_RxSetBitclockConfig()

◆ SAI_RxSetBitClockDirection()

◆ SAI_RxSetBitClockPolarity()

◆ SAI_RxSetBitClockRate()