DMA驱动API描述

hal_status_t hal_dma_init(dma_handle_t *p_dma)

根据dma_init_t中的指定参数初始化DMA外设的指定通道。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

HAL状态。

hal_status_t hal_dma_deinit(dma_handle_t *p_dma)

反初始化DMA外设。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

HAL状态。

hal_status_t hal_dma_start(dma_handle_t *p_dma, uint32_t src_address, uint32_t dst_address, uint32_t data_length)

开始DMA传输。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

src_address：源内存缓冲区地址，该地址必须与hal_dma_init()配置的src_data_alignment对齐。

dst_address：目的内存缓冲区地址，该地址必须与hal_dma_init()配置的dst_data_alignment对齐。

data_length：从源到目的地传输的数据的长度，该长度的最小数据单元与src_data_alignment相同。

HAL状态。

hal_status_t hal_dma_start_it(dma_handle_t *p_dma, uint32_t src_address, uint32_t dst_address, uint32_t data_length)

使能DMA传输并使能中断。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

src_address：源内存缓冲区地址，该地址必须与hal_dma_init()配置的src_data_alignment对齐。

dst_address：目的内存缓冲区地址，该地址必须与hal_dma_init()配置的dst_data_alignment对齐。

data_length：从源到目的地传输的数据的长度，该地址必须与hal_dma_init()配置的src_data_alignment对齐。

HAL状态。

hal_status_t hal_dma_abort(dma_handle_t *p_dma)

中止DMA传输。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

HAL状态。

hal_status_t hal_dma_abort_it(dma_handle_t *p_dma)

在中断模式下中止DMA传输。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

HAL状态。

hal_status_t hal_dma_poll_for_transfer(dma_handle_t *p_dma, uint32_t timeout)

轮询传输完成。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

timeout：超时时间。

HAL状态。

void hal_dma_irq_handler(dma_handle_t *p_dma)

处理DMA中断请求。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

无

hal_status_t hal_dma_register_callback(dma_handle_t *p_dma, hal_dma_callback_id_t id, void (* callback)( dma_handle_t *p_dma))

注册回调函数。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

id：回调类型标识，该参数可以是下列值中的任意一个：

• HAL_DMA_XFER_TFR_CB_ID（传输完成回调函数ID）
• HAL_DMA_XFER_BLK_CB_ID（块传输完成回调函数ID）
• HAL_DMA_XFER_ABORT_CB_ID（中止完成回调函数ID）

callback：指向私有回调函数的指针。

HAL状态。

hal_status_t hal_dma_unregister_callback(dma_handle_t *p_dma, hal_dma_callback_id_t callback_id)

注销回调函数。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

callback_id：回调类型标识，该参数可以是下列值中的任意一个：

• HAL_DMA_XFER_TFR_CB_ID（传输完成回调函数ID）
• HAL_DMA_XFER_BLK_CB_ID（块传输完成回调函数ID）
• HAL_DMA_XFER_ABORT_CB_ID（中止完成回调函数ID）
• HAL_DMA_XFER_ALL_CB_ID（所有的完成回调函数ID）

HAL状态。

hal_dma_state_t hal_dma_get_state(dma_handle_t *p_dma)

获取DMA运行状态。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

DMA运行状态，该参数的取值可能是下列值中的任意一个：

• HAL_DMA_STATE_RESET（未初始化）
• HAL_DMA_STATE_READY（已初始化且空闲）
• HAL_DMA_STATE_BUSY（忙）
• HAL_DMA_STATE_TIMEOUT（超时）
• HAL_DMA_STATE_ERROR（错误）

hal_dma_state_t hal_dma_get_state(dma_handle_t *p_dma)

获取DMA 错误码。

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

DMA错误码，该参数的取值可能是下列值中的任意一个：

• HAL_DMA_ERROR_NONE（无错误）
• HAL_DMA_ERROR_TE（传输错误）
• HAL_DMA_ERROR_NO_XFER（无正在进行的数据传输）
• HAL_DMA_ERROR_TIMEOUT（超时）

hal_status_t hal_dma_suspend_reg(dma_handle_t *p_dma)

睡眠时挂起与DMA配置相关的寄存器

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。

hal_status_t hal_dma_resume_reg(dma_handle_t *p_dma);

唤醒时恢复与DMA配置相关的寄存器

p_dma：指向dma_handle_t结构体变量的指针，该结构体变量包含指定的DMA通道的配置信息。