RT-Thread中的串口DMA分析

来源:https://www.cnblogs.com/dabbler/archive/2019/09/25/11582199.html
-Advertisement-
Play Games

這裡分析一下RT-Thread中串口DMA方式的實現，以供做新處理器串口支持時的參考。 背景 在如今的晶元性能和外設強大功能的情況下，串口不實現DMA/中斷方式操作，我認為在實際項目中基本是不可接受的，但遺憾的是，rt-thread現有支持的實現中，基本上沒有支持串口的DMA，文檔也沒有關於串口DM ...


這裡分析一下RT-Thread中串口DMA方式的實現，以供做新處理器串口支持時的參考。

背景

在如今的晶元性能和外設強大功能的情況下，串口不實現DMA/中斷方式操作，我認為在實際項目中基本是不可接受的，但遺憾的是，rt-thread現有支持的實現中，基本上沒有支持串口的DMA，文檔也沒有關於串口DMA支持相關的說明，這裡以STM32實現為背景，梳理一下串口DMA的實現流程，以供新處理器實現時以作參考。

DMA接收準備

啟用DMA接收，需要在打開設備的時候做一些處理，入口函數為rt_device_open()。主體實現是：

rt_err_t rt_device_open(rt_device_t dev, rt_uint16_t oflag)
{
    ......
    result = device_init(dev);
    ......
    result = device_open(dev, oflag);
    ......
}

device_init()就是rt_serial_init()函數，其主要是調用configure()函數，

static rt_err_t rt_serial_init(struct rt_device *dev)
{
    ......
    if (serial->ops->configure)
        result = serial->ops->configure(serial, &serial->config);
    ......
}

在stm32下，其configure()函數是stm32_configure()，其根據設備打開參數，配置STM32外設的寄存器。包括波特率、校驗等串口工作參數。

device_open()函數就是rt_serial_open()函數，其主要實現是：

static rt_err_t rt_serial_open(struct rt_device *dev, rt_uint16_t oflag)
{
    ......

#ifdef RT_SERIAL_USING_DMA        
    else if (oflag & RT_DEVICE_FLAG_DMA_RX)
    {
        if (serial->config.bufsz == 0) {
            struct rt_serial_rx_dma* rx_dma;

            rx_dma = (struct rt_serial_rx_dma*) rt_malloc (sizeof(struct rt_serial_rx_dma));
            RT_ASSERT(rx_dma != RT_NULL);
            rx_dma->activated = RT_FALSE;

            serial->serial_rx = rx_dma;
        } else {
            struct rt_serial_rx_fifo* rx_fifo;

            rx_fifo = (struct rt_serial_rx_fifo*) rt_malloc (sizeof(struct rt_serial_rx_fifo) +
                serial->config.bufsz);
            RT_ASSERT(rx_fifo != RT_NULL);
            rx_fifo->buffer = (rt_uint8_t*) (rx_fifo + 1);
            rt_memset(rx_fifo->buffer, 0, serial->config.bufsz);
            rx_fifo->put_index = 0;
            rx_fifo->get_index = 0;
            rx_fifo->is_full = RT_FALSE;
            serial->serial_rx = rx_fifo;
            /* configure fifo address and length to low level device */
            serial->ops->control(serial, RT_DEVICE_CTRL_CONFIG, (void *) RT_DEVICE_FLAG_DMA_RX);
        }
        dev->open_flag |= RT_DEVICE_FLAG_DMA_RX;
    }
#endif /* RT_SERIAL_USING_DMA */
	......
#ifdef RT_SERIAL_USING_DMA
    else if (oflag & RT_DEVICE_FLAG_DMA_TX)
    {
        struct rt_serial_tx_dma* tx_dma;

        tx_dma = (struct rt_serial_tx_dma*) rt_malloc (sizeof(struct rt_serial_tx_dma));
        RT_ASSERT(tx_dma != RT_NULL);
        tx_dma->activated = RT_FALSE;

        rt_data_queue_init(&(tx_dma->data_queue), 8, 4, RT_NULL);
        serial->serial_tx = tx_dma;

        dev->open_flag |= RT_DEVICE_FLAG_DMA_TX;
        /* configure low level device */
        serial->ops->control(serial, RT_DEVICE_CTRL_CONFIG, (void *)RT_DEVICE_FLAG_DMA_TX);
    }
#endif /* RT_SERIAL_USING_DMA */
    ......
}

可見，其主要工作是為DMA接收準備FIFO緩衝區；為DMA發送準備發送數據緩衝隊列，但是好像STM32中斷並沒有用到發送數據緩衝。

DMA配置數據來源是rt_hw_usart_init()函數，預設的配置參數由巨集RT_SERIAL_CONFIG_DEFAULT決定， 這裡決定了預設的接收緩衝區參數是64位元組，通訊預設參數是：115200,8N1。

#define RT_SERIAL_RB_BUFSZ              64

DMA接收

DMA接收我們從DMA中斷開始分析，DMA接收中斷服務函數為UARTn_DMA_RX_IRQHandler()，其調用HAL庫的DMA處理函數HAL_DMA_IRQHandler()，該函數調用回調函數HAL_UART_RxCpltCallback()或HAL_UART_RxHalfCpltCallback()，這兩個函數進入真正的中斷服務處理函數dma_isr(struct rt_serial_device *)，主體代碼如下：

static void dma_isr(struct rt_serial_device *serial)
{
    ......
    /* 如果是DMA-RX中斷 */
    if ((__HAL_DMA_GET_IT_SOURCE(&(uart->dma_rx.handle), DMA_IT_TC) != RESET) ||
            (__HAL_DMA_GET_IT_SOURCE(&(uart->dma_rx.handle), DMA_IT_HT) != RESET))
    {
        level = rt_hw_interrupt_disable();
        /* 得到本次接收到的數據量 */
        recv_total_index = serial->config.bufsz - __HAL_DMA_GET_COUNTER(&(uart->dma_rx.handle));
        if (recv_total_index == 0)
        {
            /* 這一句代碼，是什麼意思？ */
            recv_len = serial->config.bufsz - uart->dma_rx.last_index;
        }
        else
        {
            /* 減去以前接收到的數據量，得到本次接收到的數據數量 */
            recv_len = recv_total_index - uart->dma_rx.last_index;
        }
        /* 更新接收歷史數據量 */
        uart->dma_rx.last_index = recv_total_index;
        rt_hw_interrupt_enable(level);

        if (recv_len)
        {
            /* 如果有新數據，調用serial設備模塊的通用處理 */
            rt_hw_serial_isr(serial, RT_SERIAL_EVENT_RX_DMADONE | (recv_len << 8));
        }
    }
}

在serial模塊的函數rt_hw_serial_isr()中，主體代碼是：

void rt_hw_serial_isr(struct rt_serial_device *serial, int event)
{
    ......
    case RT_SERIAL_EVENT_RX_DMADONE:
    {
        int length;
        rt_base_t level;

        /* get DMA rx length */
        length = (event & (~0xff)) >> 8;

        if (serial->config.bufsz == 0)
        {
            /* 這個case的處理邏輯不知道怎麼應用，看起來STM32實現並沒有處理這個case */
            struct rt_serial_rx_dma* rx_dma;

            rx_dma = (struct rt_serial_rx_dma*) serial->serial_rx;
            RT_ASSERT(rx_dma != RT_NULL);

            RT_ASSERT(serial->parent.rx_indicate != RT_NULL);
            serial->parent.rx_indicate(&(serial->parent), length);
            rx_dma->activated = RT_FALSE;
        }
        else
        {
            /* disable interrupt */
            level = rt_hw_interrupt_disable();
            /* update fifo put index, 將數據放入接收緩衝區 */
            rt_dma_recv_update_put_index(serial, length);
            /* calculate received total length, 更新緩衝區信息 */
            length = rt_dma_calc_recved_len(serial);
            /* enable interrupt */
            rt_hw_interrupt_enable(level);
            /* invoke callback, 通知上層，有新數據到達 */
            if (serial->parent.rx_indicate != RT_NULL)
            {
                serial->parent.rx_indicate(&(serial->parent), length);
            }
        }
        break;
    }
    ......
}

上層接到通知後，讀取函數最終調用驅動讀函數rt_serial_read()函數，在DMA的條件下，調用_serial_dma_rx()從緩衝區讀取數據。其代碼為：

static rt_size_t rt_serial_read(struct rt_device *dev, rt_off_t pos, void *buffer, rt_size_t size)
{
    ......
    else if (dev->open_flag & RT_DEVICE_FLAG_DMA_RX)
    {
        return _serial_dma_rx(serial, (rt_uint8_t *)buffer, size);
    }
    ......
}

DMA發送

DMA發送從驅動寫函數rt_serial_write()開始，在DMA的條件下，調用_serial_dma_tx()，_serial_dma_tx()再調用操作的DMA發送函數發送數據，代碼為：

static rt_size_t rt_serial_write(struct rt_device *dev, rt_off_t pos, const void *buffer, rt_size_t size)
{
    ......
    else if (dev->open_flag & RT_DEVICE_FLAG_DMA_TX)
    {
        return _serial_dma_tx(serial, (const rt_uint8_t *)buffer, size);
    }
    ......
}

rt_inline int _serial_dma_tx(struct rt_serial_device *serial, const rt_uint8_t *data, int length)
{
    ......
    /* make a DMA transfer */
    serial->ops->dma_transmit(serial, (rt_uint8_t *)data, length, RT_SERIAL_DMA_TX);
    ......
}

STM32的dma_transmit()實現函數是stm32_dma_transmit()，其實現就是簡單調用HAL_UART_Transmit_DMA()，代碼為：

static rt_size_t stm32_dma_transmit(struct rt_serial_device *serial, rt_uint8_t *buf, rt_size_t size, int direction)
{
    ......
    if (HAL_UART_Transmit_DMA(&uart->handle, buf, size) == HAL_OK)
    ......
}

實現非常簡單。

         
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • .NET Core 3.0， 發佈將於今晚開始！
    期待已久的.NET Core 3.0即將發佈！ .NET Core 3.0在.NET Conf上發佈。大約還有9個多小時後，.NET Conf開始啟動。 為期3天的大概日程安排如下： 第1天-9月23日 9:00-10:00 Microsoft Studios播出的主題演講10:00-17:00從M ...
  • （七十）c#Winform自定義控制項-餅狀圖
    前提 入行已經7,8年了，一直想做一套漂亮點的自定義控制項，於是就有了本系列文章。 GitHub：https://github.com/kwwwvagaa/NetWinformControl 碼雲：https://gitee.com/kwwwvagaa/net_winform_custom_contr ...
  • C#動態創建單例類的對象
    單例類public class SnappingClass : ISnappingEnvironment, IExtension { // private static readonly SnappingClass instance = null; static SnappingClass() { ... ...
  • VS2019安裝好後，經常打不開軟體沒反應解決方法
    原文地址：https://blog.csdn.net/FL1623863129/article/details/89013137 VS2019於昨日正式發佈，博主立馬下載一個專業版嘗嘗鮮，但是發現項目打開都沒反應，而且VS2019都死在進程，怎麼也打不開，這不是安裝包而是沒有以管理員運行，只要在屬性 ...
  • 對try catch finally的理解
    對try catch finally的理解1.finally 總是會運行的，即使在catch中thorw拋出異常了。2.finally 在 return後沒有結束，而是繼續運行finally2.順序的話就是對try-》finally 或者 try-》catch-》finally不管怎樣finally ...
  • net core WebApi——緩存神器Redis
    @[toc] 前言 中秋過完不知不覺都已經快兩周沒動這個工程了，最近業務需要總算開始搞後臺雲服務了，果斷直接net core搞起，在做的中間遇到了不少問題，這個後續會一點點列出來包括解決方法，今天就先把之前挖的坑填一個。 Redis 之前在緩存那篇提到過， Cookie ， Session ， Ca ...
  • 4、看源碼MVC Controller如何調用Action
    Controller繼承ControllrBase，ControllerBase繼承IController，而IController里只有一個Execute方法 1、ControllrBase里的Execute()，裡面調用了ExecuteCore()，而ExecuteCore()是個抽象方法，抽象 ...
  • ASP.NET Core 2.2 : 二十三. 深入聊一聊配置的內部處理機制
    上一章介紹了配置的多種數據源被註冊、載入和獲取的過程，本節看一下這個過程系統是如何實現的。(ASP.NET Core 系列目錄) 一、數據源的註冊 在上一節介紹的數據源設置中，appsettings.json、命令行、環境變數三種方式是被系統自動載入的，這是因為系統在webHost.CreateDe ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類