[FAQ] [参考译文] 【常见问题解答】AM62P-Q1：使用 DMA 通过 UART 进行连续数据流式传输

先决条件：MCU+ SDK UART 驱动程序 — 传输完成行为

摘要

UART 驱动程序的 uart_write () API 行为因传输模式而异。 只有轮询模式才能保证在函数返回时数据已在线路上完全传输。 所有其他模式（中断和 DMA，阻塞和回调）只保证数据已传输到 UART TX FIFO、而不保证数据已在物理 TX 线路上发送。

关键术语

详细模式分析

轮询模式

实施： 驱动程序繁忙 — 等待 TX FIFO 和移位寄存器均为空后再返回。

中断+阻塞模式

实施： 信标块；当最后一个字节进入 FIFO 时、ISR 会发布信标。

中断+回调模式

实施： 立即返回；在最后一个字节进入 FIFO 时调用回调。

DMA +阻塞模式

实施： 信标上的块；DMA 完成 ISR 发布信标。

DMA +回调模式

实施： 立即返回；DMA 完成时调用回调。

摘要矩阵：

uart_flushTxFifo() 限制

uart_flushTxFifo() 在内部调用 TaskP_youne()、从 ISR/回调上下文调用不安全。 这样做会导致未定义的行为。

相反、可以使用以下实现：

/*
 * Wait for UART TX to complete - ISR safe version
 * Polls the Line Status Register directly without calling TaskP_yield()
 *
 * NOTE: UART_flushTxFifo() is NOT safe to call from ISR/callback context
 * because it calls TaskP_yield() internally, which causes a crash.
 */
static void waitForTxComplete_IsrSafe(UART_Handle handle)
{
    uint32_t baseAddr = UART_getBaseAddr(handle);
    uint32_t lineStatus;

    /*
     * Wait until both:
     * - TX FIFO is empty (bit 5: UART_LSR_TX_FIFO_E_MASK = 0x20)
     * - TX Shift Register is empty (bit 6: UART_LSR_TX_SR_E_MASK = 0x40)
     */
    do
    {
        lineStatus = UART_readLineStatus(baseAddr);
    }
    while ((lineStatus & (UART_LSR_TX_FIFO_E_MASK | UART_LSR_TX_SR_E_MASK))
           != (UART_LSR_TX_FIFO_E_MASK | UART_LSR_TX_SR_E_MASK));
}