RTEMS 6.1-rc1
Data Structures | Enumerator | Variables
Edma

Data Structures

struct  _edma_config
 eDMA global configuration structure. More...
 
struct  _edma_transfer_config
 eDMA transfer configuration More...
 
struct  _edma_channel_Preemption_config
 eDMA channel priority configuration More...
 
struct  _edma_minor_offset_config
 eDMA minor offset configuration More...
 
struct  _edma_tcd
 eDMA TCD. More...
 
struct  _edma_handle
 eDMA transfer handle structure More...
 

Variables

bool _edma_config::enableContinuousLinkMode
 
bool _edma_config::enableHaltOnError
 
bool _edma_config::enableRoundRobinArbitration
 
bool _edma_config::enableDebugMode
 
uint32_t _edma_transfer_config::srcAddr
 
uint32_t _edma_transfer_config::destAddr
 
edma_transfer_size_t _edma_transfer_config::srcTransferSize
 
edma_transfer_size_t _edma_transfer_config::destTransferSize
 
int16_t _edma_transfer_config::srcOffset
 
int16_t _edma_transfer_config::destOffset
 
uint32_t _edma_transfer_config::minorLoopBytes
 
uint32_t _edma_transfer_config::majorLoopCounts
 
bool _edma_channel_Preemption_config::enableChannelPreemption
 
bool _edma_channel_Preemption_config::enablePreemptAbility
 
uint8_t _edma_channel_Preemption_config::channelPriority
 
bool _edma_minor_offset_config::enableSrcMinorOffset
 
bool _edma_minor_offset_config::enableDestMinorOffset
 
uint32_t _edma_minor_offset_config::minorOffset
 
__IO uint32_t _edma_tcd::SADDR
 
__IO uint16_t _edma_tcd::SOFF
 
__IO uint16_t _edma_tcd::ATTR
 
__IO uint32_t _edma_tcd::NBYTES
 
__IO uint32_t _edma_tcd::SLAST
 
__IO uint32_t _edma_tcd::DADDR
 
__IO uint16_t _edma_tcd::DOFF
 
__IO uint16_t _edma_tcd::CITER
 
__IO uint32_t _edma_tcd::DLAST_SGA
 
__IO uint16_t _edma_tcd::CSR
 
__IO uint16_t _edma_tcd::BITER
 
edma_callback _edma_handle::callback
 
void * _edma_handle::userData
 
DMA_Type_edma_handle::base
 
edma_tcd_t_edma_handle::tcdPool
 
uint8_t _edma_handle::channel
 
volatile int8_t _edma_handle::header
 
volatile int8_t _edma_handle::tail
 
volatile int8_t _edma_handle::tcdUsed
 
volatile int8_t _edma_handle::tcdSize
 
uint8_t _edma_handle::flags
 

Driver version

enum  _edma_transfer_size {
  kEDMA_TransferSize1Bytes = 0x0U , kEDMA_TransferSize2Bytes = 0x1U , kEDMA_TransferSize4Bytes = 0x2U , kEDMA_TransferSize8Bytes = 0x3U ,
  kEDMA_TransferSize16Bytes = 0x4U , kEDMA_TransferSize32Bytes = 0x5U
}
 eDMA transfer configuration More...
 
enum  _edma_modulo {
  kEDMA_ModuloDisable = 0x0U , kEDMA_Modulo2bytes , kEDMA_Modulo4bytes , kEDMA_Modulo8bytes ,
  kEDMA_Modulo16bytes , kEDMA_Modulo32bytes , kEDMA_Modulo64bytes , kEDMA_Modulo128bytes ,
  kEDMA_Modulo256bytes , kEDMA_Modulo512bytes , kEDMA_Modulo1Kbytes , kEDMA_Modulo2Kbytes ,
  kEDMA_Modulo4Kbytes , kEDMA_Modulo8Kbytes , kEDMA_Modulo16Kbytes , kEDMA_Modulo32Kbytes ,
  kEDMA_Modulo64Kbytes , kEDMA_Modulo128Kbytes , kEDMA_Modulo256Kbytes , kEDMA_Modulo512Kbytes ,
  kEDMA_Modulo1Mbytes , kEDMA_Modulo2Mbytes , kEDMA_Modulo4Mbytes , kEDMA_Modulo8Mbytes ,
  kEDMA_Modulo16Mbytes , kEDMA_Modulo32Mbytes , kEDMA_Modulo64Mbytes , kEDMA_Modulo128Mbytes ,
  kEDMA_Modulo256Mbytes , kEDMA_Modulo512Mbytes , kEDMA_Modulo1Gbytes , kEDMA_Modulo2Gbytes
}
 eDMA modulo configuration More...
 
enum  _edma_bandwidth { kEDMA_BandwidthStallNone = 0x0U , kEDMA_BandwidthStall4Cycle = 0x2U , kEDMA_BandwidthStall8Cycle = 0x3U }
 Bandwidth control. More...
 
enum  _edma_channel_link_type { kEDMA_LinkNone = 0x0U , kEDMA_MinorLink , kEDMA_MajorLink }
 Channel link type. More...
 
enum  { kEDMA_DoneFlag = 0x1U , kEDMA_ErrorFlag = 0x2U , kEDMA_InterruptFlag = 0x4U }
 _edma_channel_status_flags eDMA channel status flags. More...
 
enum  {
  kEDMA_DestinationBusErrorFlag = DMA_ES_DBE_MASK , kEDMA_SourceBusErrorFlag = DMA_ES_SBE_MASK , kEDMA_ScatterGatherErrorFlag = DMA_ES_SGE_MASK , kEDMA_NbytesErrorFlag = DMA_ES_NCE_MASK ,
  kEDMA_DestinationOffsetErrorFlag = DMA_ES_DOE_MASK , kEDMA_DestinationAddressErrorFlag = DMA_ES_DAE_MASK , kEDMA_SourceOffsetErrorFlag = DMA_ES_SOE_MASK , kEDMA_SourceAddressErrorFlag = DMA_ES_SAE_MASK ,
  kEDMA_ErrorChannelFlag = DMA_ES_ERRCHN_MASK , kEDMA_ChannelPriorityErrorFlag = DMA_ES_CPE_MASK , kEDMA_TransferCanceledFlag = DMA_ES_ECX_MASK , kEDMA_ValidFlag = (int)DMA_ES_VLD_MASK
}
 _edma_error_status_flags eDMA channel error status flags. More...
 
enum  _edma_interrupt_enable { kEDMA_ErrorInterruptEnable = 0x1U , kEDMA_MajorInterruptEnable = DMA_CSR_INTMAJOR_MASK , kEDMA_HalfInterruptEnable = DMA_CSR_INTHALF_MASK }
 eDMA interrupt source More...
 
enum  _edma_transfer_type { kEDMA_MemoryToMemory = 0x0U , kEDMA_PeripheralToMemory , kEDMA_MemoryToPeripheral , kEDMA_PeripheralToPeripheral }
 eDMA transfer type More...
 
enum  { kStatus_EDMA_QueueFull = MAKE_STATUS(kStatusGroup_EDMA, 0) , kStatus_EDMA_Busy = MAKE_STATUS(kStatusGroup_EDMA, 1) }
 _edma_transfer_status eDMA transfer status More...
 
typedef enum _edma_transfer_size edma_transfer_size_t
 eDMA transfer configuration
 
typedef enum _edma_modulo edma_modulo_t
 eDMA modulo configuration
 
typedef enum _edma_bandwidth edma_bandwidth_t
 Bandwidth control.
 
typedef enum _edma_channel_link_type edma_channel_link_type_t
 Channel link type.
 
typedef enum _edma_interrupt_enable edma_interrupt_enable_t
 eDMA interrupt source
 
typedef enum _edma_transfer_type edma_transfer_type_t
 eDMA transfer type
 
typedef struct _edma_config edma_config_t
 eDMA global configuration structure.
 
typedef struct _edma_transfer_config edma_transfer_config_t
 eDMA transfer configuration More...
 
typedef struct _edma_channel_Preemption_config edma_channel_Preemption_config_t
 eDMA channel priority configuration
 
typedef struct _edma_minor_offset_config edma_minor_offset_config_t
 eDMA minor offset configuration
 
typedef struct _edma_tcd edma_tcd_t
 eDMA TCD. More...
 
typedef void(* edma_callback) (struct _edma_handle *handle, void *userData, bool transferDone, uint32_t tcds)
 Define callback function for eDMA. More...
 
typedef struct _edma_handle edma_handle_t
 eDMA transfer handle structure
 
#define FSL_EDMA_DRIVER_VERSION   (MAKE_VERSION(2, 4, 3))
 eDMA driver version More...
 
#define DMA_DCHPRI_INDEX(channel)   (((channel) & ~0x03U) | (3U - ((channel)&0x03U)))
 Compute the offset unit from DCHPRI3.
 

eDMA initialization and de-initialization

void EDMA_Init (DMA_Type *base, const edma_config_t *config)
 Initializes the eDMA peripheral. More...
 
void EDMA_Deinit (DMA_Type *base)
 Deinitializes the eDMA peripheral. More...
 
void EDMA_InstallTCD (DMA_Type *base, uint32_t channel, edma_tcd_t *tcd)
 Push content of TCD structure into hardware TCD register. More...
 
void EDMA_GetDefaultConfig (edma_config_t *config)
 Gets the eDMA default configuration structure. More...
 

eDMA Channel Operation

void EDMA_ResetChannel (DMA_Type *base, uint32_t channel)
 Sets all TCD registers to default values. More...
 
void EDMA_SetTransferConfig (DMA_Type *base, uint32_t channel, const edma_transfer_config_t *config, edma_tcd_t *nextTcd)
 Configures the eDMA transfer attribute. More...
 
void EDMA_SetMinorOffsetConfig (DMA_Type *base, uint32_t channel, const edma_minor_offset_config_t *config)
 Configures the eDMA minor offset feature. More...
 
void EDMA_SetChannelPreemptionConfig (DMA_Type *base, uint32_t channel, const edma_channel_Preemption_config_t *config)
 Configures the eDMA channel preemption feature. More...
 
void EDMA_SetChannelLink (DMA_Type *base, uint32_t channel, edma_channel_link_type_t linkType, uint32_t linkedChannel)
 Sets the channel link for the eDMA transfer. More...
 
void EDMA_SetBandWidth (DMA_Type *base, uint32_t channel, edma_bandwidth_t bandWidth)
 Sets the bandwidth for the eDMA transfer. More...
 
void EDMA_SetModulo (DMA_Type *base, uint32_t channel, edma_modulo_t srcModulo, edma_modulo_t destModulo)
 Sets the source modulo and the destination modulo for the eDMA transfer. More...
 
void EDMA_EnableChannelInterrupts (DMA_Type *base, uint32_t channel, uint32_t mask)
 Enables the interrupt source for the eDMA transfer. More...
 
void EDMA_DisableChannelInterrupts (DMA_Type *base, uint32_t channel, uint32_t mask)
 Disables the interrupt source for the eDMA transfer. More...
 
void EDMA_SetMajorOffsetConfig (DMA_Type *base, uint32_t channel, int32_t sourceOffset, int32_t destOffset)
 Configures the eDMA channel TCD major offset feature. More...
 

eDMA TCD Operation

void EDMA_TcdReset (edma_tcd_t *tcd)
 Sets all fields to default values for the TCD structure. More...
 
void EDMA_TcdSetTransferConfig (edma_tcd_t *tcd, const edma_transfer_config_t *config, edma_tcd_t *nextTcd)
 Configures the eDMA TCD transfer attribute. More...
 
void EDMA_TcdSetMinorOffsetConfig (edma_tcd_t *tcd, const edma_minor_offset_config_t *config)
 Configures the eDMA TCD minor offset feature. More...
 
void EDMA_TcdSetChannelLink (edma_tcd_t *tcd, edma_channel_link_type_t linkType, uint32_t linkedChannel)
 Sets the channel link for the eDMA TCD. More...
 
void EDMA_TcdSetModulo (edma_tcd_t *tcd, edma_modulo_t srcModulo, edma_modulo_t destModulo)
 Sets the source modulo and the destination modulo for the eDMA TCD. More...
 
void EDMA_TcdEnableInterrupts (edma_tcd_t *tcd, uint32_t mask)
 Enables the interrupt source for the eDMA TCD. More...
 
void EDMA_TcdDisableInterrupts (edma_tcd_t *tcd, uint32_t mask)
 Disables the interrupt source for the eDMA TCD. More...
 
void EDMA_TcdSetMajorOffsetConfig (edma_tcd_t *tcd, int32_t sourceOffset, int32_t destOffset)
 Configures the eDMA TCD major offset feature. More...
 

eDMA Channel Status Operation

uint32_t EDMA_GetRemainingMajorLoopCount (DMA_Type *base, uint32_t channel)
 Gets the remaining major loop count from the eDMA current channel TCD. More...
 
uint32_t EDMA_GetChannelStatusFlags (DMA_Type *base, uint32_t channel)
 Gets the eDMA channel status flags. More...
 
void EDMA_ClearChannelStatusFlags (DMA_Type *base, uint32_t channel, uint32_t mask)
 Clears the eDMA channel status flags. More...
 

eDMA Transactional Operation

void EDMA_CreateHandle (edma_handle_t *handle, DMA_Type *base, uint32_t channel)
 Creates the eDMA handle. More...
 
void EDMA_InstallTCDMemory (edma_handle_t *handle, edma_tcd_t *tcdPool, uint32_t tcdSize)
 Installs the TCDs memory pool into the eDMA handle. More...
 
void EDMA_SetCallback (edma_handle_t *handle, edma_callback callback, void *userData)
 Installs a callback function for the eDMA transfer. More...
 
void EDMA_PrepareTransferConfig (edma_transfer_config_t *config, void *srcAddr, uint32_t srcWidth, int16_t srcOffset, void *destAddr, uint32_t destWidth, int16_t destOffset, uint32_t bytesEachRequest, uint32_t transferBytes)
 Prepares the eDMA transfer structure configurations. More...
 
void EDMA_PrepareTransfer (edma_transfer_config_t *config, void *srcAddr, uint32_t srcWidth, void *destAddr, uint32_t destWidth, uint32_t bytesEachRequest, uint32_t transferBytes, edma_transfer_type_t transferType)
 Prepares the eDMA transfer structure. More...
 
status_t EDMA_SubmitTransfer (edma_handle_t *handle, const edma_transfer_config_t *config)
 Submits the eDMA transfer request. More...
 
void EDMA_StartTransfer (edma_handle_t *handle)
 eDMA starts transfer. More...
 
void EDMA_StopTransfer (edma_handle_t *handle)
 eDMA stops transfer. More...
 
void EDMA_AbortTransfer (edma_handle_t *handle)
 eDMA aborts transfer. More...
 
void EDMA_HandleIRQ (edma_handle_t *handle)
 eDMA IRQ handler for the current major loop transfer completion. More...
 

Detailed Description

Macro Definition Documentation

◆ FSL_EDMA_DRIVER_VERSION

#define FSL_EDMA_DRIVER_VERSION   (MAKE_VERSION(2, 4, 3))

eDMA driver version

Version 2.4.3.

Typedef Documentation

◆ edma_callback

typedef void(* edma_callback) (struct _edma_handle *handle, void *userData, bool transferDone, uint32_t tcds)

Define callback function for eDMA.

This callback function is called in the EDMA interrupt handle. In normal mode, run into callback function means the transfer users need is done. In scatter gather mode, run into callback function means a transfer control block (tcd) is finished. Not all transfer finished, users can get the finished tcd numbers using interface EDMA_GetUnusedTCDNumber.

Parameters
handleEDMA handle pointer, users shall not touch the values inside.
userDataThe callback user parameter pointer. Users can use this parameter to involve things users need to change in EDMA callback function.
transferDoneIf the current loaded transfer done. In normal mode it means if all transfer done. In scatter gather mode, this parameter shows is the current transfer block in EDMA register is done. As the load of core is different, it will be different if the new tcd loaded into EDMA registers while this callback called. If true, it always means new tcd still not loaded into registers, while false means new tcd already loaded into registers.
tcdsHow many tcds are done from the last callback. This parameter only used in scatter gather mode. It tells user how many tcds are finished between the last callback and this.

◆ edma_tcd_t

typedef struct _edma_tcd edma_tcd_t

eDMA TCD.

This structure is same as TCD register which is described in reference manual, and is used to configure the scatter/gather feature as a next hardware TCD.

◆ edma_transfer_config_t

eDMA transfer configuration

This structure configures the source/destination transfer attribute.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

_edma_channel_status_flags eDMA channel status flags.

Enumerator
kEDMA_DoneFlag 

DONE flag, set while transfer finished, CITER value exhausted

kEDMA_ErrorFlag 

eDMA error flag, an error occurred in a transfer

kEDMA_InterruptFlag 

eDMA interrupt flag, set while an interrupt occurred of this channel

◆ anonymous enum

anonymous enum

_edma_error_status_flags eDMA channel error status flags.

Enumerator
kEDMA_DestinationBusErrorFlag 

Bus error on destination address

kEDMA_SourceBusErrorFlag 

Bus error on the source address

kEDMA_ScatterGatherErrorFlag 

Error on the Scatter/Gather address, not 32byte aligned.

kEDMA_NbytesErrorFlag 

NBYTES/CITER configuration error

kEDMA_DestinationOffsetErrorFlag 

Destination offset not aligned with destination size

kEDMA_DestinationAddressErrorFlag 

Destination address not aligned with destination size

kEDMA_SourceOffsetErrorFlag 

Source offset not aligned with source size

kEDMA_SourceAddressErrorFlag 

Source address not aligned with source size

kEDMA_ErrorChannelFlag 

Error channel number of the cancelled channel number

kEDMA_ChannelPriorityErrorFlag 

Channel priority is not unique.

kEDMA_TransferCanceledFlag 

Transfer cancelled

kEDMA_ValidFlag 

No error occurred, this bit is 0. Otherwise, it is 1.

◆ anonymous enum

anonymous enum

_edma_transfer_status eDMA transfer status

Enumerator
kStatus_EDMA_QueueFull 

TCD queue is full.

kStatus_EDMA_Busy 

Channel is busy and can't handle the transfer request.

◆ _edma_bandwidth

Bandwidth control.

Enumerator
kEDMA_BandwidthStallNone 

No eDMA engine stalls.

kEDMA_BandwidthStall4Cycle 

eDMA engine stalls for 4 cycles after each read/write.

kEDMA_BandwidthStall8Cycle 

eDMA engine stalls for 8 cycles after each read/write.

◆ _edma_channel_link_type

Channel link type.

Enumerator
kEDMA_LinkNone 

No channel link

kEDMA_MinorLink 

Channel link after each minor loop

kEDMA_MajorLink 

Channel link while major loop count exhausted

◆ _edma_interrupt_enable

eDMA interrupt source

Enumerator
kEDMA_ErrorInterruptEnable 

Enable interrupt while channel error occurs.

kEDMA_MajorInterruptEnable 

Enable interrupt while major count exhausted.

kEDMA_HalfInterruptEnable 

Enable interrupt while major count to half value.

◆ _edma_modulo

eDMA modulo configuration

Enumerator
kEDMA_ModuloDisable 

Disable modulo

kEDMA_Modulo2bytes 

Circular buffer size is 2 bytes.

kEDMA_Modulo4bytes 

Circular buffer size is 4 bytes.

kEDMA_Modulo8bytes 

Circular buffer size is 8 bytes.

kEDMA_Modulo16bytes 

Circular buffer size is 16 bytes.

kEDMA_Modulo32bytes 

Circular buffer size is 32 bytes.

kEDMA_Modulo64bytes 

Circular buffer size is 64 bytes.

kEDMA_Modulo128bytes 

Circular buffer size is 128 bytes.

kEDMA_Modulo256bytes 

Circular buffer size is 256 bytes.

kEDMA_Modulo512bytes 

Circular buffer size is 512 bytes.

kEDMA_Modulo1Kbytes 

Circular buffer size is 1 K bytes.

kEDMA_Modulo2Kbytes 

Circular buffer size is 2 K bytes.

kEDMA_Modulo4Kbytes 

Circular buffer size is 4 K bytes.

kEDMA_Modulo8Kbytes 

Circular buffer size is 8 K bytes.

kEDMA_Modulo16Kbytes 

Circular buffer size is 16 K bytes.

kEDMA_Modulo32Kbytes 

Circular buffer size is 32 K bytes.

kEDMA_Modulo64Kbytes 

Circular buffer size is 64 K bytes.

kEDMA_Modulo128Kbytes 

Circular buffer size is 128 K bytes.

kEDMA_Modulo256Kbytes 

Circular buffer size is 256 K bytes.

kEDMA_Modulo512Kbytes 

Circular buffer size is 512 K bytes.

kEDMA_Modulo1Mbytes 

Circular buffer size is 1 M bytes.

kEDMA_Modulo2Mbytes 

Circular buffer size is 2 M bytes.

kEDMA_Modulo4Mbytes 

Circular buffer size is 4 M bytes.

kEDMA_Modulo8Mbytes 

Circular buffer size is 8 M bytes.

kEDMA_Modulo16Mbytes 

Circular buffer size is 16 M bytes.

kEDMA_Modulo32Mbytes 

Circular buffer size is 32 M bytes.

kEDMA_Modulo64Mbytes 

Circular buffer size is 64 M bytes.

kEDMA_Modulo128Mbytes 

Circular buffer size is 128 M bytes.

kEDMA_Modulo256Mbytes 

Circular buffer size is 256 M bytes.

kEDMA_Modulo512Mbytes 

Circular buffer size is 512 M bytes.

kEDMA_Modulo1Gbytes 

Circular buffer size is 1 G bytes.

kEDMA_Modulo2Gbytes 

Circular buffer size is 2 G bytes.

◆ _edma_transfer_size

eDMA transfer configuration

Enumerator
kEDMA_TransferSize1Bytes 

Source/Destination data transfer size is 1 byte every time

kEDMA_TransferSize2Bytes 

Source/Destination data transfer size is 2 bytes every time

kEDMA_TransferSize4Bytes 

Source/Destination data transfer size is 4 bytes every time

kEDMA_TransferSize8Bytes 

Source/Destination data transfer size is 8 bytes every time

kEDMA_TransferSize16Bytes 

Source/Destination data transfer size is 16 bytes every time

kEDMA_TransferSize32Bytes 

Source/Destination data transfer size is 32 bytes every time

◆ _edma_transfer_type

eDMA transfer type

Enumerator
kEDMA_MemoryToMemory 

Transfer from memory to memory

kEDMA_PeripheralToMemory 

Transfer from peripheral to memory

kEDMA_MemoryToPeripheral 

Transfer from memory to peripheral

kEDMA_PeripheralToPeripheral 

Transfer from Peripheral to peripheral

Function Documentation

◆ EDMA_AbortTransfer()

void EDMA_AbortTransfer ( edma_handle_t handle)

eDMA aborts transfer.

This function disables the channel request and clear transfer status bits. Users can submit another transfer after calling this API.

Parameters
handleDMA handle pointer.

brief eDMA aborts transfer.

This function disables the channel request and clear transfer status bits. Users can submit another transfer after calling this API.

param handle DMA handle pointer.

◆ EDMA_ClearChannelStatusFlags()

void EDMA_ClearChannelStatusFlags ( DMA_Type base,
uint32_t  channel,
uint32_t  mask 
)

Clears the eDMA channel status flags.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
maskThe mask of channel status to be cleared. Users need to use the defined _edma_channel_status_flags type.

brief Clears the eDMA channel status flags.

param base eDMA peripheral base address. param channel eDMA channel number. param mask The mask of channel status to be cleared. Users need to use the defined _edma_channel_status_flags type.

◆ EDMA_CreateHandle()

void EDMA_CreateHandle ( edma_handle_t handle,
DMA_Type base,
uint32_t  channel 
)

Creates the eDMA handle.

This function is called if using the transactional API for eDMA. This function initializes the internal state of the eDMA handle.

Parameters
handleeDMA handle pointer. The eDMA handle stores callback function and parameters.
baseeDMA peripheral base address.
channeleDMA channel number.

brief Creates the eDMA handle.

This function is called if using the transactional API for eDMA. This function initializes the internal state of the eDMA handle.

param handle eDMA handle pointer. The eDMA handle stores callback function and parameters. param base eDMA peripheral base address. param channel eDMA channel number.

◆ EDMA_Deinit()

void EDMA_Deinit ( DMA_Type base)

Deinitializes the eDMA peripheral.

This function gates the eDMA clock.

Parameters
baseeDMA peripheral base address.

brief Deinitializes the eDMA peripheral.

This function gates the eDMA clock.

param base eDMA peripheral base address.

◆ EDMA_DisableChannelInterrupts()

void EDMA_DisableChannelInterrupts ( DMA_Type base,
uint32_t  channel,
uint32_t  mask 
)

Disables the interrupt source for the eDMA transfer.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
maskThe mask of the interrupt source to be set. Use the defined edma_interrupt_enable_t type.

brief Disables the interrupt source for the eDMA transfer.

param base eDMA peripheral base address. param channel eDMA channel number. param mask The mask of the interrupt source to be set. Use the defined edma_interrupt_enable_t type.

◆ EDMA_EnableChannelInterrupts()

void EDMA_EnableChannelInterrupts ( DMA_Type base,
uint32_t  channel,
uint32_t  mask 
)

Enables the interrupt source for the eDMA transfer.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
maskThe mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

brief Enables the interrupt source for the eDMA transfer.

param base eDMA peripheral base address. param channel eDMA channel number. param mask The mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

◆ EDMA_GetChannelStatusFlags()

uint32_t EDMA_GetChannelStatusFlags ( DMA_Type base,
uint32_t  channel 
)

Gets the eDMA channel status flags.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
Returns
The mask of channel status flags. Users need to use the _edma_channel_status_flags type to decode the return variables.

brief Gets the eDMA channel status flags.

param base eDMA peripheral base address. param channel eDMA channel number. return The mask of channel status flags. Users need to use the _edma_channel_status_flags type to decode the return variables.

◆ EDMA_GetDefaultConfig()

void EDMA_GetDefaultConfig ( edma_config_t config)

Gets the eDMA default configuration structure.

This function sets the configuration structure to default values. The default configuration is set to the following values.

config.enableContinuousLinkMode = false;
config.enableHaltOnError = true;
config.enableRoundRobinArbitration = false;
config.enableDebugMode = false;
Definition: deflate.c:114
Parameters
configA pointer to the eDMA configuration structure.

brief Gets the eDMA default configuration structure.

This function sets the configuration structure to default values. The default configuration is set to the following values. code config.enableContinuousLinkMode = false; config.enableHaltOnError = true; config.enableRoundRobinArbitration = false; config.enableDebugMode = false; endcode

param config A pointer to the eDMA configuration structure.

◆ EDMA_GetRemainingMajorLoopCount()

uint32_t EDMA_GetRemainingMajorLoopCount ( DMA_Type base,
uint32_t  channel 
)

Gets the remaining major loop count from the eDMA current channel TCD.

This function checks the TCD (Task Control Descriptor) status for a specified eDMA channel and returns the number of major loop count that has not finished.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
Returns
Major loop count which has not been transferred yet for the current TCD.
Note
1. This function can only be used to get unfinished major loop count of transfer without the next TCD, or it might be inaccuracy.
  1. The unfinished/remaining transfer bytes cannot be obtained directly from registers while the channel is running. Because to calculate the remaining bytes, the initial NBYTES configured in DMA_TCDn_NBYTES_MLNO register is needed while the eDMA IP does not support getting it while a channel is active. In another word, the NBYTES value reading is always the actual (decrementing) NBYTES value the dma_engine is working with while a channel is running. Consequently, to get the remaining transfer bytes, a software-saved initial value of NBYTES (for example copied before enabling the channel) is needed. The formula to calculate it is shown below: RemainingBytes = RemainingMajorLoopCount * NBYTES(initially configured)

brief Gets the remaining major loop count from the eDMA current channel TCD.

This function checks the TCD (Task Control Descriptor) status for a specified eDMA channel and returns the number of major loop count that has not finished.

param base eDMA peripheral base address. param channel eDMA channel number. return Major loop count which has not been transferred yet for the current TCD. note 1. This function can only be used to get unfinished major loop count of transfer without the next TCD, or it might be inaccuracy.

  1. The unfinished/remaining transfer bytes cannot be obtained directly from registers while the channel is running. Because to calculate the remaining bytes, the initial NBYTES configured in DMA_TCDn_NBYTES_MLNO register is needed while the eDMA IP does not support getting it while a channel is active. In another word, the NBYTES value reading is always the actual (decrementing) NBYTES value the dma_engine is working with while a channel is running. Consequently, to get the remaining transfer bytes, a software-saved initial value of NBYTES (for example copied before enabling the channel) is needed. The formula to calculate it is shown below: RemainingBytes = RemainingMajorLoopCount * NBYTES(initially configured)

◆ EDMA_HandleIRQ()

void EDMA_HandleIRQ ( edma_handle_t handle)

eDMA IRQ handler for the current major loop transfer completion.

This function clears the channel major interrupt flag and calls the callback function if it is not NULL.

Note: For the case using TCD queue, when the major iteration count is exhausted, additional operations are performed. These include the final address adjustments and reloading of the BITER field into the CITER. Assertion of an optional interrupt request also occurs at this time, as does a possible fetch of a new TCD from memory using the scatter/gather address pointer included in the descriptor (if scatter/gather is enabled).

For instance, when the time interrupt of TCD[0] happens, the TCD[1] has already been loaded into the eDMA engine. As sga and sga_index are calculated based on the DLAST_SGA bitfield lies in the TCD_CSR register, the sga_index in this case should be 2 (DLAST_SGA of TCD[1] stores the address of TCD[2]). Thus, the "tcdUsed" updated should be (tcdUsed - 2U) which indicates the number of TCDs can be loaded in the memory pool (because TCD[0] and TCD[1] have been loaded into the eDMA engine at this point already.).

For the last two continuous ISRs in a scatter/gather process, they both load the last TCD (The last ISR does not load a new TCD) from the memory pool to the eDMA engine when major loop completes. Therefore, ensure that the header and tcdUsed updated are identical for them. tcdUsed are both 0 in this case as no TCD to be loaded.

See the "eDMA basic data flow" in the eDMA Functional description section of the Reference Manual for further details.

Parameters
handleeDMA handle pointer.

brief eDMA IRQ handler for the current major loop transfer completion.

This function clears the channel major interrupt flag and calls the callback function if it is not NULL.

Note: For the case using TCD queue, when the major iteration count is exhausted, additional operations are performed. These include the final address adjustments and reloading of the BITER field into the CITER. Assertion of an optional interrupt request also occurs at this time, as does a possible fetch of a new TCD from memory using the scatter/gather address pointer included in the descriptor (if scatter/gather is enabled).

For instance, when the time interrupt of TCD[0] happens, the TCD[1] has already been loaded into the eDMA engine. As sga and sga_index are calculated based on the DLAST_SGA bitfield lies in the TCD_CSR register, the sga_index in this case should be 2 (DLAST_SGA of TCD[1] stores the address of TCD[2]). Thus, the "tcdUsed" updated should be (tcdUsed - 2U) which indicates the number of TCDs can be loaded in the memory pool (because TCD[0] and TCD[1] have been loaded into the eDMA engine at this point already.).

For the last two continuous ISRs in a scatter/gather process, they both load the last TCD (The last ISR does not load a new TCD) from the memory pool to the eDMA engine when major loop completes. Therefore, ensure that the header and tcdUsed updated are identical for them. tcdUsed are both 0 in this case as no TCD to be loaded.

See the "eDMA basic data flow" in the eDMA Functional description section of the Reference Manual for further details.

param handle eDMA handle pointer.

◆ EDMA_Init()

void EDMA_Init ( DMA_Type base,
const edma_config_t config 
)

Initializes the eDMA peripheral.

This function ungates the eDMA clock and configures the eDMA peripheral according to the configuration structure.

Parameters
baseeDMA peripheral base address.
configA pointer to the configuration structure, see "edma_config_t".
Note
This function enables the minor loop map feature.

brief Initializes the eDMA peripheral.

This function ungates the eDMA clock and configures the eDMA peripheral according to the configuration structure.

param base eDMA peripheral base address. param config A pointer to the configuration structure, see "edma_config_t". note This function enables the minor loop map feature.

◆ EDMA_InstallTCD()

void EDMA_InstallTCD ( DMA_Type base,
uint32_t  channel,
edma_tcd_t tcd 
)

Push content of TCD structure into hardware TCD register.

Parameters
baseEDMA peripheral base address.
channelEDMA channel number.
tcdPoint to TCD structure.

brief Push content of TCD structure into hardware TCD register.

param base EDMA peripheral base address. param channel EDMA channel number. param tcd Point to TCD structure.

◆ EDMA_InstallTCDMemory()

void EDMA_InstallTCDMemory ( edma_handle_t handle,
edma_tcd_t tcdPool,
uint32_t  tcdSize 
)

Installs the TCDs memory pool into the eDMA handle.

This function is called after the EDMA_CreateHandle to use scatter/gather feature. This function shall only be used while users need to use scatter gather mode. Scatter gather mode enables EDMA to load a new transfer control block (tcd) in hardware, and automatically reconfigure that DMA channel for a new transfer. Users need to prepare tcd memory and also configure tcds using interface EDMA_SubmitTransfer.

Parameters
handleeDMA handle pointer.
tcdPoolA memory pool to store TCDs. It must be 32 bytes aligned.
tcdSizeThe number of TCD slots.

brief Installs the TCDs memory pool into the eDMA handle.

This function is called after the EDMA_CreateHandle to use scatter/gather feature. This function shall only be used while users need to use scatter gather mode. Scatter gather mode enables EDMA to load a new transfer control block (tcd) in hardware, and automatically reconfigure that DMA channel for a new transfer. Users need to prepare tcd memory and also configure tcds using interface EDMA_SubmitTransfer.

param handle eDMA handle pointer. param tcdPool A memory pool to store TCDs. It must be 32 bytes aligned. param tcdSize The number of TCD slots.

◆ EDMA_PrepareTransfer()

void EDMA_PrepareTransfer ( edma_transfer_config_t config,
void *  srcAddr,
uint32_t  srcWidth,
void *  destAddr,
uint32_t  destWidth,
uint32_t  bytesEachRequest,
uint32_t  transferBytes,
edma_transfer_type_t  transferType 
)

Prepares the eDMA transfer structure.

This function prepares the transfer configuration structure according to the user input.

Parameters
configThe user configuration structure of type edma_transfer_t.
srcAddreDMA transfer source address.
srcWidtheDMA transfer source address width(bytes).
destAddreDMA transfer destination address.
destWidtheDMA transfer destination address width(bytes).
bytesEachRequesteDMA transfer bytes per channel request.
transferByteseDMA transfer bytes to be transferred.
transferTypeeDMA transfer type.
Note
The data address and the data width must be consistent. For example, if the SRC is 4 bytes, the source address must be 4 bytes aligned, or it results in source address error (SAE).

brief Prepares the eDMA transfer structure.

This function prepares the transfer configuration structure according to the user input.

param config The user configuration structure of type edma_transfer_t. param srcAddr eDMA transfer source address. param srcWidth eDMA transfer source address width(bytes). param destAddr eDMA transfer destination address. param destWidth eDMA transfer destination address width(bytes). param bytesEachRequest eDMA transfer bytes per channel request. param transferBytes eDMA transfer bytes to be transferred. param transferType eDMA transfer type. note The data address and the data width must be consistent. For example, if the SRC is 4 bytes, the source address must be 4 bytes aligned, or it results in source address error (SAE).

◆ EDMA_PrepareTransferConfig()

void EDMA_PrepareTransferConfig ( edma_transfer_config_t config,
void *  srcAddr,
uint32_t  srcWidth,
int16_t  srcOffset,
void *  destAddr,
uint32_t  destWidth,
int16_t  destOffset,
uint32_t  bytesEachRequest,
uint32_t  transferBytes 
)

Prepares the eDMA transfer structure configurations.

This function prepares the transfer configuration structure according to the user input.

Parameters
configThe user configuration structure of type edma_transfer_t.
srcAddreDMA transfer source address.
srcWidtheDMA transfer source address width(bytes).
srcOffsetsource address offset.
destAddreDMA transfer destination address.
destWidtheDMA transfer destination address width(bytes).
destOffsetdestination address offset.
bytesEachRequesteDMA transfer bytes per channel request.
transferByteseDMA transfer bytes to be transferred.
Note
The data address and the data width must be consistent. For example, if the SRC is 4 bytes, the source address must be 4 bytes aligned, or it results in source address error (SAE).

brief Prepares the eDMA transfer structure configurations.

This function prepares the transfer configuration structure according to the user input.

param config The user configuration structure of type edma_transfer_t. param srcAddr eDMA transfer source address. param srcWidth eDMA transfer source address width(bytes). param srcOffset source address offset. param destAddr eDMA transfer destination address. param destWidth eDMA transfer destination address width(bytes). param destOffset destination address offset. param bytesEachRequest eDMA transfer bytes per channel request. param transferBytes eDMA transfer bytes to be transferred. note The data address and the data width must be consistent. For example, if the SRC is 4 bytes, the source address must be 4 bytes aligned, or it results in source address error (SAE).

◆ EDMA_ResetChannel()

void EDMA_ResetChannel ( DMA_Type base,
uint32_t  channel 
)

Sets all TCD registers to default values.

This function sets TCD registers for this channel to default values.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
Note
This function must not be called while the channel transfer is ongoing or it causes unpredictable results.
This function enables the auto stop request feature.

brief Sets all TCD registers to default values.

This function sets TCD registers for this channel to default values.

param base eDMA peripheral base address. param channel eDMA channel number. note This function must not be called while the channel transfer is ongoing or it causes unpredictable results. note This function enables the auto stop request feature.

◆ EDMA_SetBandWidth()

void EDMA_SetBandWidth ( DMA_Type base,
uint32_t  channel,
edma_bandwidth_t  bandWidth 
)

Sets the bandwidth for the eDMA transfer.

Because the eDMA processes the minor loop, it continuously generates read/write sequences until the minor count is exhausted. The bandwidth forces the eDMA to stall after the completion of each read/write access to control the bus request bandwidth seen by the crossbar switch.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
bandWidthA bandwidth setting, which can be one of the following:
  • kEDMABandwidthStallNone
  • kEDMABandwidthStall4Cycle
  • kEDMABandwidthStall8Cycle
brief Sets the bandwidth for the eDMA transfer.

Because the eDMA processes the minor loop, it continuously generates read/write sequences until the minor count is exhausted. The bandwidth forces the eDMA to stall after the completion of each read/write access to control the bus request bandwidth seen by the crossbar switch.

param base eDMA peripheral base address. param channel eDMA channel number. param bandWidth A bandwidth setting, which can be one of the following: arg kEDMABandwidthStallNone arg kEDMABandwidthStall4Cycle arg kEDMABandwidthStall8Cycle

◆ EDMA_SetCallback()

void EDMA_SetCallback ( edma_handle_t handle,
edma_callback  callback,
void *  userData 
)

Installs a callback function for the eDMA transfer.

This callback is called in the eDMA IRQ handler. Use the callback to do something after the current major loop transfer completes. This function will be called every time one tcd finished transfer.

Parameters
handleeDMA handle pointer.
callbackeDMA callback function pointer.
userDataA parameter for the callback function.

brief Installs a callback function for the eDMA transfer.

This callback is called in the eDMA IRQ handler. Use the callback to do something after the current major loop transfer completes. This function will be called every time one tcd finished transfer.

param handle eDMA handle pointer. param callback eDMA callback function pointer. param userData A parameter for the callback function.

◆ EDMA_SetChannelLink()

void EDMA_SetChannelLink ( DMA_Type base,
uint32_t  channel,
edma_channel_link_type_t  linkType,
uint32_t  linkedChannel 
)

Sets the channel link for the eDMA transfer.

This function configures either the minor link or the major link mode. The minor link means that the channel link is triggered every time CITER decreases by 1. The major link means that the channel link is triggered when the CITER is exhausted.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
linkTypeA channel link type, which can be one of the following:
  • kEDMA_LinkNone
  • kEDMA_MinorLink
  • kEDMA_MajorLink
linkedChannelThe linked channel number.
Note
Users should ensure that DONE flag is cleared before calling this interface, or the configuration is invalid.

brief Sets the channel link for the eDMA transfer.

This function configures either the minor link or the major link mode. The minor link means that the channel link is triggered every time CITER decreases by 1. The major link means that the channel link is triggered when the CITER is exhausted.

param base eDMA peripheral base address. param channel eDMA channel number. param linkType A channel link type, which can be one of the following: arg kEDMA_LinkNone arg kEDMA_MinorLink arg kEDMA_MajorLink param linkedChannel The linked channel number. note Users should ensure that DONE flag is cleared before calling this interface, or the configuration is invalid.

◆ EDMA_SetChannelPreemptionConfig()

void EDMA_SetChannelPreemptionConfig ( DMA_Type base,
uint32_t  channel,
const edma_channel_Preemption_config_t config 
)

Configures the eDMA channel preemption feature.

This function configures the channel preemption attribute and the priority of the channel.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number
configA pointer to the channel preemption configuration structure.

brief Configures the eDMA channel preemption feature.

This function configures the channel preemption attribute and the priority of the channel.

param base eDMA peripheral base address. param channel eDMA channel number param config A pointer to the channel preemption configuration structure.

◆ EDMA_SetMajorOffsetConfig()

void EDMA_SetMajorOffsetConfig ( DMA_Type base,
uint32_t  channel,
int32_t  sourceOffset,
int32_t  destOffset 
)

Configures the eDMA channel TCD major offset feature.

Adjustment value added to the source address at the completion of the major iteration count

Parameters
baseeDMA peripheral base address.
channeledma channel number.
sourceOffsetsource address offset will be applied to source address after major loop done.
destOffsetdestination address offset will be applied to source address after major loop done.

brief Configures the eDMA channel TCD major offset feature.

Adjustment value added to the source address at the completion of the major iteration count

param base eDMA peripheral base address. param channel edma channel number. param sourceOffset source address offset. param destOffset destination address offset.

◆ EDMA_SetMinorOffsetConfig()

void EDMA_SetMinorOffsetConfig ( DMA_Type base,
uint32_t  channel,
const edma_minor_offset_config_t config 
)

Configures the eDMA minor offset feature.

The minor offset means that the signed-extended value is added to the source address or destination address after each minor loop.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
configA pointer to the minor offset configuration structure.

brief Configures the eDMA minor offset feature.

The minor offset means that the signed-extended value is added to the source address or destination address after each minor loop.

param base eDMA peripheral base address. param channel eDMA channel number. param config A pointer to the minor offset configuration structure.

◆ EDMA_SetModulo()

void EDMA_SetModulo ( DMA_Type base,
uint32_t  channel,
edma_modulo_t  srcModulo,
edma_modulo_t  destModulo 
)

Sets the source modulo and the destination modulo for the eDMA transfer.

This function defines a specific address range specified to be the value after (SADDR + SOFF)/(DADDR + DOFF) calculation is performed or the original register value. It provides the ability to implement a circular data queue easily.

Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
srcModuloA source modulo value.
destModuloA destination modulo value.

brief Sets the source modulo and the destination modulo for the eDMA transfer.

This function defines a specific address range specified to be the value after (SADDR + SOFF)/(DADDR + DOFF) calculation is performed or the original register value. It provides the ability to implement a circular data queue easily.

param base eDMA peripheral base address. param channel eDMA channel number. param srcModulo A source modulo value. param destModulo A destination modulo value.

◆ EDMA_SetTransferConfig()

void EDMA_SetTransferConfig ( DMA_Type base,
uint32_t  channel,
const edma_transfer_config_t config,
edma_tcd_t nextTcd 
)

Configures the eDMA transfer attribute.

This function configures the transfer attribute, including source address, destination address, transfer size, address offset, and so on. It also configures the scatter gather feature if the user supplies the TCD address. Example:

edma_transfer_t config;
config.srcAddr = ..;
config.destAddr = ..;
...
EDMA_SetTransferConfig(DMA0, channel, &config, &stcd);
#define DMA0
Definition: MIMXRT1052.h:17840
eDMA TCD.
Definition: fsl_edma.h:205
Parameters
baseeDMA peripheral base address.
channeleDMA channel number.
configPointer to eDMA transfer configuration structure.
nextTcdPoint to TCD structure. It can be NULL if users do not want to enable scatter/gather feature.
Note
If nextTcd is not NULL, it means scatter gather feature is enabled and DREQ bit is cleared in the previous transfer configuration, which is set in the eDMA_ResetChannel.

brief Configures the eDMA transfer attribute.

This function configures the transfer attribute, including source address, destination address, transfer size, address offset, and so on. It also configures the scatter gather feature if the user supplies the TCD address. Example: code edma_transfer_t config; edma_tcd_t tcd; config.srcAddr = ..; config.destAddr = ..; ... EDMA_SetTransferConfig(DMA0, channel, &config, &stcd); endcode

param base eDMA peripheral base address. param channel eDMA channel number. param config Pointer to eDMA transfer configuration structure. param nextTcd Point to TCD structure. It can be NULL if users do not want to enable scatter/gather feature. note If nextTcd is not NULL, it means scatter gather feature is enabled and DREQ bit is cleared in the previous transfer configuration, which is set in the eDMA_ResetChannel.

◆ EDMA_StartTransfer()

void EDMA_StartTransfer ( edma_handle_t handle)

eDMA starts transfer.

This function enables the channel request. Users can call this function after submitting the transfer request or before submitting the transfer request.

Parameters
handleeDMA handle pointer.

brief eDMA starts transfer.

This function enables the channel request. Users can call this function after submitting the transfer request or before submitting the transfer request.

param handle eDMA handle pointer.

◆ EDMA_StopTransfer()

void EDMA_StopTransfer ( edma_handle_t handle)

eDMA stops transfer.

This function disables the channel request to pause the transfer. Users can call EDMA_StartTransfer() again to resume the transfer.

Parameters
handleeDMA handle pointer.

brief eDMA stops transfer.

This function disables the channel request to pause the transfer. Users can call EDMA_StartTransfer() again to resume the transfer.

param handle eDMA handle pointer.

◆ EDMA_SubmitTransfer()

status_t EDMA_SubmitTransfer ( edma_handle_t handle,
const edma_transfer_config_t config 
)

Submits the eDMA transfer request.

This function submits the eDMA transfer request according to the transfer configuration structure. In scatter gather mode, call this function will add a configured tcd to the circular list of tcd pool. The tcd pools is setup by call function EDMA_InstallTCDMemory before.

Parameters
handleeDMA handle pointer.
configPointer to eDMA transfer configuration structure.
Return values
kStatus_EDMA_SuccessIt means submit transfer request succeed.
kStatus_EDMA_QueueFullIt means TCD queue is full. Submit transfer request is not allowed.
kStatus_EDMA_BusyIt means the given channel is busy, need to submit request later.

brief Submits the eDMA transfer request.

This function submits the eDMA transfer request according to the transfer configuration structure. In scatter gather mode, call this function will add a configured tcd to the circular list of tcd pool. The tcd pools is setup by call function EDMA_InstallTCDMemory before.

param handle eDMA handle pointer. param config Pointer to eDMA transfer configuration structure. retval kStatus_EDMA_Success It means submit transfer request succeed. retval kStatus_EDMA_QueueFull It means TCD queue is full. Submit transfer request is not allowed. retval kStatus_EDMA_Busy It means the given channel is busy, need to submit request later.

◆ EDMA_TcdDisableInterrupts()

void EDMA_TcdDisableInterrupts ( edma_tcd_t tcd,
uint32_t  mask 
)

Disables the interrupt source for the eDMA TCD.

Parameters
tcdPoint to the TCD structure.
maskThe mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

brief Disables the interrupt source for the eDMA TCD.

param tcd Point to the TCD structure. param mask The mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

◆ EDMA_TcdEnableInterrupts()

void EDMA_TcdEnableInterrupts ( edma_tcd_t tcd,
uint32_t  mask 
)

Enables the interrupt source for the eDMA TCD.

Parameters
tcdPoint to the TCD structure.
maskThe mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

brief Enables the interrupt source for the eDMA TCD.

param tcd Point to the TCD structure. param mask The mask of interrupt source to be set. Users need to use the defined edma_interrupt_enable_t type.

◆ EDMA_TcdReset()

void EDMA_TcdReset ( edma_tcd_t tcd)

Sets all fields to default values for the TCD structure.

This function sets all fields for this TCD structure to default value.

Parameters
tcdPointer to the TCD structure.
Note
This function enables the auto stop request feature.

brief Sets all fields to default values for the TCD structure.

This function sets all fields for this TCD structure to default value.

param tcd Pointer to the TCD structure. note This function enables the auto stop request feature.

◆ EDMA_TcdSetChannelLink()

void EDMA_TcdSetChannelLink ( edma_tcd_t tcd,
edma_channel_link_type_t  linkType,
uint32_t  linkedChannel 
)

Sets the channel link for the eDMA TCD.

This function configures either a minor link or a major link. The minor link means the channel link is triggered every time CITER decreases by 1. The major link means that the channel link is triggered when the CITER is exhausted.

Note
Users should ensure that DONE flag is cleared before calling this interface, or the configuration is invalid.
Parameters
tcdPoint to the TCD structure.
linkTypeChannel link type, it can be one of:
  • kEDMA_LinkNone
  • kEDMA_MinorLink
  • kEDMA_MajorLink
linkedChannelThe linked channel number.

brief Sets the channel link for the eDMA TCD.

This function configures either a minor link or a major link. The minor link means the channel link is triggered every time CITER decreases by 1. The major link means that the channel link is triggered when the CITER is exhausted.

note Users should ensure that DONE flag is cleared before calling this interface, or the configuration is invalid. param tcd Point to the TCD structure. param linkType Channel link type, it can be one of: arg kEDMA_LinkNone arg kEDMA_MinorLink arg kEDMA_MajorLink param linkedChannel The linked channel number.

◆ EDMA_TcdSetMajorOffsetConfig()

void EDMA_TcdSetMajorOffsetConfig ( edma_tcd_t tcd,
int32_t  sourceOffset,
int32_t  destOffset 
)

Configures the eDMA TCD major offset feature.

Adjustment value added to the source address at the completion of the major iteration count

Parameters
tcdA point to the TCD structure.
sourceOffsetsource address offset wiil be applied to source address after major loop done.
destOffsetdestination address offset will be applied to source address after major loop done.

brief Configures the eDMA TCD major offset feature.

Adjustment value added to the source address at the completion of the major iteration count

param tcd A point to the TCD structure. param sourceOffset source address offset. param destOffset destination address offset.

◆ EDMA_TcdSetMinorOffsetConfig()

void EDMA_TcdSetMinorOffsetConfig ( edma_tcd_t tcd,
const edma_minor_offset_config_t config 
)

Configures the eDMA TCD minor offset feature.

A minor offset is a signed-extended value added to the source address or a destination address after each minor loop.

Parameters
tcdA point to the TCD structure.
configA pointer to the minor offset configuration structure.

brief Configures the eDMA TCD minor offset feature.

A minor offset is a signed-extended value added to the source address or a destination address after each minor loop.

param tcd A point to the TCD structure. param config A pointer to the minor offset configuration structure.

◆ EDMA_TcdSetModulo()

void EDMA_TcdSetModulo ( edma_tcd_t tcd,
edma_modulo_t  srcModulo,
edma_modulo_t  destModulo 
)

Sets the source modulo and the destination modulo for the eDMA TCD.

This function defines a specific address range specified to be the value after (SADDR + SOFF)/(DADDR + DOFF) calculation is performed or the original register value. It provides the ability to implement a circular data queue easily.

Parameters
tcdA pointer to the TCD structure.
srcModuloA source modulo value.
destModuloA destination modulo value.

brief Sets the source modulo and the destination modulo for the eDMA TCD.

This function defines a specific address range specified to be the value after (SADDR + SOFF)/(DADDR + DOFF) calculation is performed or the original register value. It provides the ability to implement a circular data queue easily.

param tcd A pointer to the TCD structure. param srcModulo A source modulo value. param destModulo A destination modulo value.

◆ EDMA_TcdSetTransferConfig()

void EDMA_TcdSetTransferConfig ( edma_tcd_t tcd,
const edma_transfer_config_t config,
edma_tcd_t nextTcd 
)

Configures the eDMA TCD transfer attribute.

The TCD is a transfer control descriptor. The content of the TCD is the same as the hardware TCD registers. The TCD is used in the scatter-gather mode. This function configures the TCD transfer attribute, including source address, destination address, transfer size, address offset, and so on. It also configures the scatter gather feature if the user supplies the next TCD address. Example:

edma_transfer_t config = {
...
}
edma_tcd_t tcd __aligned(32);
edma_tcd_t nextTcd __aligned(32);
void EDMA_TcdSetTransferConfig(edma_tcd_t *tcd, const edma_transfer_config_t *config, edma_tcd_t *nextTcd)
Configures the eDMA TCD transfer attribute.
Definition: fsl_edma.c:492
Parameters
tcdPointer to the TCD structure.
configPointer to eDMA transfer configuration structure.
nextTcdPointer to the next TCD structure. It can be NULL if users do not want to enable scatter/gather feature.
Note
TCD address should be 32 bytes aligned or it causes an eDMA error.
If the nextTcd is not NULL, the scatter gather feature is enabled and DREQ bit is cleared in the previous transfer configuration, which is set in the EDMA_TcdReset.

brief Configures the eDMA TCD transfer attribute.

The TCD is a transfer control descriptor. The content of the TCD is the same as the hardware TCD registers. The TCD is used in the scatter-gather mode. This function configures the TCD transfer attribute, including source address, destination address, transfer size, address offset, and so on. It also configures the scatter gather feature if the user supplies the next TCD address. Example: code edma_transfer_t config = { ... } edma_tcd_t tcd __aligned(32); edma_tcd_t nextTcd __aligned(32); EDMA_TcdSetTransferConfig(&tcd, &config, &nextTcd); endcode

param tcd Pointer to the TCD structure. param config Pointer to eDMA transfer configuration structure. param nextTcd Pointer to the next TCD structure. It can be NULL if users do not want to enable scatter/gather feature. note TCD address should be 32 bytes aligned or it causes an eDMA error. note If the nextTcd is not NULL, the scatter gather feature is enabled and DREQ bit is cleared in the previous transfer configuration, which is set in the EDMA_TcdReset.

Variable Documentation

◆ ATTR

__IO uint16_t _edma_tcd::ATTR

ATTR register, source/destination transfer size and modulo

◆ base

DMA_Type* _edma_handle::base

eDMA peripheral base address.

◆ BITER

__IO uint16_t _edma_tcd::BITER

BITER register, begin minor loop count.

◆ callback

edma_callback _edma_handle::callback

Callback function for major count exhausted.

◆ channel

uint8_t _edma_handle::channel

eDMA channel number.

◆ channelPriority

uint8_t _edma_channel_Preemption_config::channelPriority

Channel priority

◆ CITER

__IO uint16_t _edma_tcd::CITER

CITER register, current minor loop numbers, for unfinished minor loop.

◆ CSR

__IO uint16_t _edma_tcd::CSR

CSR register, for TCD control status

◆ DADDR

__IO uint32_t _edma_tcd::DADDR

DADDR register, used for destination address

◆ destAddr

uint32_t _edma_transfer_config::destAddr

Destination data address.

◆ destOffset

int16_t _edma_transfer_config::destOffset

Sign-extended offset applied to the current destination address to form the next-state value as each destination write is completed.

◆ destTransferSize

edma_transfer_size_t _edma_transfer_config::destTransferSize

Destination data transfer size.

◆ DLAST_SGA

__IO uint32_t _edma_tcd::DLAST_SGA

DLASTSGA register, next tcd address used in scatter-gather mode

◆ DOFF

__IO uint16_t _edma_tcd::DOFF

DOFF register, used for destination offset

◆ enableChannelPreemption

bool _edma_channel_Preemption_config::enableChannelPreemption

If true: a channel can be suspended by other channel with higher priority

◆ enableContinuousLinkMode

bool _edma_config::enableContinuousLinkMode

Enable (true) continuous link mode. Upon minor loop completion, the channel activates again if that channel has a minor loop channel link enabled and the link channel is itself.

◆ enableDebugMode

bool _edma_config::enableDebugMode

Enable(true) eDMA debug mode. When in debug mode, the eDMA stalls the start of a new channel. Executing channels are allowed to complete.

◆ enableDestMinorOffset

bool _edma_minor_offset_config::enableDestMinorOffset

Enable(true) or Disable(false) destination minor loop offset.

◆ enableHaltOnError

bool _edma_config::enableHaltOnError

Enable (true) transfer halt on error. Any error causes the HALT bit to set. Subsequently, all service requests are ignored until the HALT bit is cleared.

◆ enablePreemptAbility

bool _edma_channel_Preemption_config::enablePreemptAbility

If true: a channel can suspend other channel with low priority

◆ enableRoundRobinArbitration

bool _edma_config::enableRoundRobinArbitration

Enable (true) round robin channel arbitration method or fixed priority arbitration is used for channel selection

◆ enableSrcMinorOffset

bool _edma_minor_offset_config::enableSrcMinorOffset

Enable(true) or Disable(false) source minor loop offset.

◆ flags

uint8_t _edma_handle::flags

The status of the current channel.

◆ header

volatile int8_t _edma_handle::header

The first TCD index. Should point to the next TCD to be loaded into the eDMA engine.

◆ majorLoopCounts

uint32_t _edma_transfer_config::majorLoopCounts

Major loop iteration count.

◆ minorLoopBytes

uint32_t _edma_transfer_config::minorLoopBytes

Bytes to transfer in a minor loop

◆ minorOffset

uint32_t _edma_minor_offset_config::minorOffset

Offset for a minor loop mapping.

◆ NBYTES

__IO uint32_t _edma_tcd::NBYTES

Nbytes register, minor loop length in bytes

◆ SADDR

__IO uint32_t _edma_tcd::SADDR

SADDR register, used to save source address

◆ SLAST

__IO uint32_t _edma_tcd::SLAST

SLAST register

◆ SOFF

__IO uint16_t _edma_tcd::SOFF

SOFF register, save offset bytes every transfer

◆ srcAddr

uint32_t _edma_transfer_config::srcAddr

Source data address.

◆ srcOffset

int16_t _edma_transfer_config::srcOffset

Sign-extended offset applied to the current source address to form the next-state value as each source read is completed.

◆ srcTransferSize

edma_transfer_size_t _edma_transfer_config::srcTransferSize

Source data transfer size.

◆ tail

volatile int8_t _edma_handle::tail

The last TCD index. Should point to the next TCD to be stored into the memory pool.

◆ tcdPool

edma_tcd_t* _edma_handle::tcdPool

Pointer to memory stored TCDs.

◆ tcdSize

volatile int8_t _edma_handle::tcdSize

The total number of TCD slots in the queue.

◆ tcdUsed

volatile int8_t _edma_handle::tcdUsed

The number of used TCD slots. Should reflect the number of TCDs can be used/loaded in the memory.

◆ userData

void* _edma_handle::userData

Callback function parameter.