Overview

Data Structures
struct	pdm_edma_transfer_t
	PDM edma transfer. More...

struct	pdm_edma_handle_t
	PDM DMA transfer handle, users should not touch the content of the handle. More...

Typedefs
typedef void(*	pdm_edma_callback_t )(PDM_Type base, pdm_edma_handle_t handle, status_t status, void *userData)
	PDM eDMA transfer callback function for finish and error.

Enumerations
enum	pdm_edma_multi_channel_interleave_t { kPDM_EDMAMultiChannelInterleavePerChannelSample, kPDM_EDMAMultiChannelInterleavePerChannelBlock }
	pdm multi channel interleave type More...

Driver version
#define	FSL_PDM_EDMA_DRIVER_VERSION (MAKE_VERSION(2, 6, 1))
	Version 2.6.1.

PDM eDMA Transactional
void	PDM_TransferInstallEDMATCDMemory (pdm_edma_handle_t handle, void tcdAddr, size_t tcdNum)
	Install EDMA descriptor memory. More...

void	PDM_TransferCreateHandleEDMA (PDM_Type base, pdm_edma_handle_t handle, pdm_edma_callback_t callback, void userData, edma_handle_t dmaHandle)
	Initializes the PDM Rx eDMA handle. More...

void	PDM_TransferSetMultiChannelInterleaveType (pdm_edma_handle_t *handle, pdm_edma_multi_channel_interleave_t multiChannelInterleaveType)
	Initializes the multi PDM channel interleave type. More...

void	PDM_TransferSetChannelConfigEDMA (PDM_Type base, pdm_edma_handle_t handle, uint32_t channel, const pdm_channel_config_t *config)
	Configures the PDM channel. More...

status_t	PDM_TransferReceiveEDMA (PDM_Type base, pdm_edma_handle_t handle, pdm_edma_transfer_t *xfer)
	Performs a non-blocking PDM receive using eDMA. More...

void	PDM_TransferTerminateReceiveEDMA (PDM_Type base, pdm_edma_handle_t handle)
	Terminate all PDM receive. More...

void	PDM_TransferAbortReceiveEDMA (PDM_Type base, pdm_edma_handle_t handle)
	Aborts a PDM receive using eDMA. More...

status_t	PDM_TransferGetReceiveCountEDMA (PDM_Type base, pdm_edma_handle_t handle, size_t *count)
	Gets byte count received by PDM. More...

Data Structure Documentation

struct pdm_edma_transfer_t

Data Fields
volatile uint8_t *	data
	Data start address to transfer. More...

volatile size_t	dataSize
	Total Transfer bytes size. More...

struct _pdm_edma_transfer *	linkTransfer
	linked transfer configurations

Field Documentation

volatile uint8_t* pdm_edma_transfer_t::data

volatile size_t pdm_edma_transfer_t::dataSize

struct _pdm_edma_handle

PDM edma handler.

Data Fields
edma_handle_t *	dmaHandle
	DMA handler for PDM send.

uint8_t	count
	The transfer data count in a DMA request.

uint32_t	receivedBytes
	total transfer count

uint32_t	state
	Internal state for PDM eDMA transfer.

pdm_edma_callback_t	callback
	Callback for users while transfer finish or error occurs.

bool	isLoopTransfer
	loop transfer

void *	userData
	User callback parameter.

edma_tcd_t *	tcd
	TCD pool for eDMA transfer. More...

uint32_t	tcdNum
	TCD number.

uint32_t	tcdUser
	Index for user to queue transfer. More...

uint32_t	tcdDriver
	Index for driver to get the transfer data and size.

volatile uint32_t	tcdUsedNum
	Index for user to queue transfer. More...

pdm_edma_multi_channel_interleave_t	interleaveType
	multi channel transfer interleave type

uint8_t	endChannel
	The last enabled channel.

uint8_t	channelNums
	total channel numbers

Field Documentation

edma_tcd_t* pdm_edma_handle_t::tcd

uint32_t pdm_edma_handle_t::tcdUser

volatile uint32_t pdm_edma_handle_t::tcdUsedNum

Enumeration Type Documentation

enum pdm_edma_multi_channel_interleave_t

Enumerator

kPDM_EDMAMultiChannelInterleavePerChannelSample

multi channel PDM data interleave per channel sample

|

kPDM_EDMAMultiChannelInterleavePerChannelBlock

multi channel PDM data interleave per channel block

|CHANNEL0 | CHANNEL0 | CHANNEL0 | ......

| CHANNEL 2 | ....|

Function Documentation

void PDM_TransferInstallEDMATCDMemory	(	pdm_edma_handle_t *	handle,
		void *	tcdAddr,
		size_t	tcdNum
	)

Parameters

handle	Pointer to EDMA channel transfer handle.
tcdAddr	EDMA head descriptor address.
tcdNum	EDMA link descriptor address.

void PDM_TransferCreateHandleEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle,
		pdm_edma_callback_t	callback,
		void *	userData,
		edma_handle_t *	dmaHandle
	)

This function initializes the PDM slave DMA handle, which can be used for other PDM master transactional APIs. Usually, for a specified PDM instance, call this API once to get the initialized handle.

Parameters

base	PDM base pointer.
handle	PDM eDMA handle pointer.
callback	Pointer to user callback function.
userData	User parameter passed to the callback function.
dmaHandle	eDMA handle pointer, this handle shall be static allocated by users.

void PDM_TransferSetMultiChannelInterleaveType	(	pdm_edma_handle_t *	handle,
		pdm_edma_multi_channel_interleave_t	multiChannelInterleaveType
	)

This function initializes the PDM DMA handle member interleaveType, it shall be called only when application would like to use type kPDM_EDMAMultiChannelInterleavePerChannelBlock, since the default interleaveType is kPDM_EDMAMultiChannelInterleavePerChannelSample always

Parameters

handle	PDM eDMA handle pointer.
multiChannelInterleaveType	Multi channel interleave type.

void PDM_TransferSetChannelConfigEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle,
		uint32_t	channel,
		const pdm_channel_config_t *	config
	)

Parameters

base	PDM base pointer.
handle	PDM eDMA handle pointer.
channel	channel index.
config	pdm channel configurations.

status_t PDM_TransferReceiveEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle,
		pdm_edma_transfer_t *	xfer
	)

Note: This interface returns immediately after the transfer initiates. Call the PDM_GetReceiveRemainingBytes to poll the transfer status and check whether the PDM transfer is finished.

Scatter gather case: This functio support dynamic scatter gather and staic scatter gather, a. for the dynamic scatter gather case: Application should call PDM_TransferReceiveEDMA function continuously to make sure new receive request is submit before the previous one finish. b. for the static scatter gather case: Application should use the link transfer feature and make sure a loop link transfer is provided, such as:
pdm_edma_transfer_t pdmXfer[2] =

* {

* {

* .data = s_buffer,

* .dataSize = BUFFER_SIZE,

* .linkTransfer = &pdmXfer[1],

* },

*

* {

* .data = &s_buffer[BUFFER_SIZE],

* .dataSize = BUFFER_SIZE,

* .linkTransfer = &pdmXfer[0]

* },

* };

*
Multi channel case: This function support receive multi pdm channel data, for example, if two channel is requested,
* PDM_TransferSetChannelConfigEDMA(DEMO_PDM, &s_pdmRxHandle_0, DEMO_PDM_ENABLE_CHANNEL_0, &channelConfig);

* PDM_TransferSetChannelConfigEDMA(DEMO_PDM, &s_pdmRxHandle_0, DEMO_PDM_ENABLE_CHANNEL_1, &channelConfig);

* PDM_TransferReceiveEDMA(DEMO_PDM, &s_pdmRxHandle_0, pdmXfer);

*

The output data will be formatted as below if handle->interleaveType =
kPDM_EDMAMultiChannelInterleavePerChannelSample :

|CHANNEL0 | CHANNEL1 | CHANNEL0 | CHANNEL1 | CHANNEL0 | CHANNEL 1 | ....|

The output data will be formatted as below if handle->interleaveType = kPDM_EDMAMultiChannelInterleavePerChannelBlock

:

|....|

Note: the dataSize of xfer is the total data size, while application using kPDM_EDMAMultiChannelInterleavePerChannelBlock, the buffer size for each PDM channel is channelSize = dataSize / channelNums, then there are limitation for this feature,

3 DMIC array: the dataSize shall be 4 * (channelSize) The addtional buffer is mandantory for edma modulo feature.
The kPDM_EDMAMultiChannelInterleavePerChannelBlock feature support below dmic array only, 2 DMIC array: CHANNEL3, CHANNEL4 3 DMIC array: CHANNEL3, CHANNEL4, CHANNEL5 4 DMIC array: CHANNEL3, CHANNEL4, CHANNEL5, CHANNEL6 Any other combinations is not support, that is to SAY, THE FEATURE SUPPORT RECEIVE START FROM CHANNEL3 ONLY AND 4 MAXIMUM DMIC CHANNELS.

Parameters

base	PDM base pointer
handle	PDM eDMA handle pointer.
xfer	Pointer to DMA transfer structure.

Return values

kStatus_Success	Start a PDM eDMA receive successfully.
kStatus_InvalidArgument	The input argument is invalid.
kStatus_RxBusy	PDM is busy receiving data.

void PDM_TransferTerminateReceiveEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle
	)

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

Parameters

base	PDM base pointer.
handle	PDM eDMA handle pointer.

void PDM_TransferAbortReceiveEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle
	)

This function only aborts the current transfer slots, the other transfer slots' information still kept in the handler. If users want to terminate all transfer slots, just call PDM_TransferTerminateReceiveEDMA.

Parameters

base	PDM base pointer
handle	PDM eDMA handle pointer.

status_t PDM_TransferGetReceiveCountEDMA	(	PDM_Type *	base,
		pdm_edma_handle_t *	handle,
		size_t *	count
	)

Parameters

base	PDM base pointer
handle	PDM eDMA handle pointer.
count	Bytes count received by PDM.

Return values

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

Overview

Data Structures

Typedefs

Enumerations

Driver version

PDM eDMA Transactional

Data Structure Documentation

Data Fields

Field Documentation

Data Fields

Field Documentation

Enumeration Type Documentation

multi channel PDM data interleave per channel sample

|

multi channel PDM data interleave per channel block

| CHANNEL 2 | ....|

Function Documentation

kPDM_EDMAMultiChannelInterleavePerChannelSample :

|CHANNEL0 | CHANNEL1 | CHANNEL0 | CHANNEL1 | CHANNEL0 | CHANNEL 1 | ....|

:

|....|