您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

RT-Thread 的 I/O 設備管理模組與驅動實作解析

編輯:iOS 相關資訊

RT-Thread 的 I/O 設備管理模組為應用提供了一套訪問裝置的通用介面,並透過定義的資料結構對裝置驅動程式與裝置資訊進行管理。從系統整體來看,I/O 管理模組相當於裝置驅動程式與上層應用之間的一個中間層。

它實現了對裝置驅動程式的封裝:驅動程式的實作與 I/O 管理模組彼此獨立,提升了模組的可移植性。應用程式透過 I/O 管理模組提供的標準介面訪問底層裝置,因此驅動程式升級不會影響上層應用。這種方式讓與裝置硬體操作相關的程式碼和應用相互隔離,雙方只需各自關注自身功能,从而降低程式碼複雜度、提高系統可靠性。

一、IO 設備管理控制塊

裝置控制塊 rt_device 是整個模組的核心資料結構,它繼承自內核物件,並封裝了裝置類型、標誌、打開標誌、ID,以及各項通用介面與回呼函數:

struct rt_device {
    struct rt_object parent;              // 繼承自 rt_object(內核物件)
    enum rt_device_class_type type;       // IO 裝置類型
    rt_uint16_t flag;                     // 裝置標誌
    rt_uint16_t open_flag;                // 打開標誌
    rt_uint8_t  device_id;                // 裝置 ID(0 - 255)

    // 裝置回呼
    rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size); // 資料接收回呼
    rt_err_t (*tx_complete)(rt_device_t dev, void *buffer);   // 資料發送完成回呼

    // 通用裝置介面
    rt_err_t   (*init)   (rt_device_t dev);
    rt_err_t   (*open)   (rt_device_t dev, rt_uint16_t oflag);
    rt_err_t   (*close)  (rt_device_t dev);
    rt_size_t  (*read)   (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size);
    rt_size_t  (*write)  (rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size);
    rt_err_t   (*control)(rt_device_t dev, rt_uint8_t cmd, void *args);

    void *user_data;                      // 私有資料
};

其中 type 為列舉類型,涵蓋字元裝置、區塊裝置、網路介面、記憶體裝置、CAN、RTC、音效、圖形、I2C 總線、USB 裝置/主機、SPI 總線/裝置、SDIO、電源管理等多種類型。

二、介面原始碼解析

1. 註冊裝置

裝置在被上層應用訪問前,需先註冊到系統中。註冊時會先以裝置名查找,若已存在則回傳錯誤;否則初始化內核物件並記錄標誌:

rt_err_t rt_device_register(rt_device_t dev, const char *name, rt_uint16_t flags) {
    if (dev == RT_NULL) return -RT_ERROR;
    if (rt_device_find(name) != RT_NULL) return -RT_ERROR; // 已註冊則回傳錯誤
    rt_object_init(&(dev->parent), RT_Object_Class_Device, name); // 初始化並加入內核物件系統
    dev->flag = flags;
    return RT_EOK;
}

2. 卸載裝置

與註冊相反,卸載是將裝置從管理系統中移除:

rt_err_t rt_device_unregister(rt_device_t dev) {
    RT_ASSERT(dev != RT_NULL);
    rt_object_detach(&(dev->parent)); // 從內核物件系統移除
    return RT_EOK;
}

3. 初始化所有裝置

此函數會掃描所有已註冊的裝置,逐一呼叫其初始化函數,通常在 RT-Thread 啟動時被呼叫:

rt_err_t rt_device_init_all(void) {
    struct rt_object_information *information;
    information = &rt_object_container[RT_Object_Class_Device];
    for (node = information->object_list.next; node != &(information->object_list); node = node->next) {
        device = (struct rt_device *)rt_list_entry(node, struct rt_object, list);
        init = device->init;
        if (init != RT_NULL && !(device->flag & RT_DEVICE_FLAG_ACTIVATED)) {
            result = init(device);
            if (result == RT_EOK) device->flag |= RT_DEVICE_FLAG_ACTIVATED; // 標記為已啟用
        }
    }
    return RT_EOK;
}

4. 查找裝置

依裝置名找到對應的控制塊。查找過程中會進入臨界區(停止執行緒排程)以確保資料一致:

rt_device_t rt_device_find(const char *name) {
    if (rt_thread_self() != RT_NULL) rt_enter_critical();
    information = &rt_object_container[RT_Object_Class_Device];
    for (node = information->object_list.next; node != &(information->object_list); node = node->next) {
        object = rt_list_entry(node, struct rt_object, list);
        if (rt_strncmp(object->name, name, RT_NAME_MAX) == 0) {
            if (rt_thread_self() != RT_NULL) rt_exit_critical();
            return (rt_device_t)object;
        }
    }
    if (rt_thread_self() != RT_NULL) rt_exit_critical();
    return RT_NULL;
}

5. 打開與關閉裝置

打開裝置時,若尚未啟用會先呼叫初始化;並針對獨立裝置檢查是否已被打開,避免重複開啟。關閉則呼叫 close 介面並重設打開標誌:

rt_err_t rt_device_open(rt_device_t dev, rt_uint16_t oflag) {
    // 若未啟用則先初始化
    if (!(dev->flag & RT_DEVICE_FLAG_ACTIVATED) && dev->init != RT_NULL) {
        dev->init(dev);
        dev->flag |= RT_DEVICE_FLAG_ACTIVATED;
    }
    // 獨立裝置若已打開則回傳忙碌
    if ((dev->flag & RT_DEVICE_FLAG_STANDALONE) && (dev->open_flag & RT_DEVICE_OFLAG_OPEN))
        return -RT_EBUSY;
    if (dev->open != RT_NULL) result = dev->open(dev, oflag);
    if (result == RT_EOK || result == -RT_ENOSYS) dev->open_flag = oflag | RT_DEVICE_OFLAG_OPEN;
    return result;
}

rt_err_t rt_device_close(rt_device_t dev) {
    if (dev->close != RT_NULL) result = dev->close(dev);
    if (result == RT_EOK || result == -RT_ENOSYS) dev->open_flag = RT_DEVICE_OFLAG_CLOSE;
    return result;
}

6. 讀寫與控制裝置

讀寫操作會檢查裝置是否實作對應介面,若無則設定錯誤碼 -RT_ENOSYS:

rt_size_t rt_device_read(rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size) {
    if (dev->read != RT_NULL) return dev->read(dev, pos, buffer, size);
    rt_set_errno(-RT_ENOSYS);
    return 0;
}

rt_size_t rt_device_write(rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size) {
    if (dev->write != RT_NULL) return dev->write(dev, pos, buffer, size);
    rt_set_errno(-RT_ENOSYS);
    return 0;
}

rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void *arg) {
    if (dev->control != RT_NULL) return dev->control(dev, cmd, arg);
    return RT_EOK;
}

7. 接收與發送回呼

裝置收到資料時會主動呼叫接收回呼,通常僅做簡單處理(如釋放信號量),再由專門的接收執行緒處理資料;發送完成時則呼叫發送回呼。這兩個介面分別用於設定對應的回呼函數:

rt_err_t rt_device_set_rx_indicate(rt_device_t dev, rt_err_t (*rx_ind)(rt_device_t dev, rt_size_t size)) {
    dev->rx_indicate = rx_ind;
    return RT_EOK;
}

rt_err_t rt_device_set_tx_complete(rt_device_t dev, rt_err_t (*tx_done)(rt_device_t dev, void *buffer)) {
    dev->tx_complete = tx_done;
    return RT_EOK;
}

三、裝置驅動的實作步驟

了解了控制塊結構與操作介面後,實作一個裝置驅動的步驟如下:

  1. 定義裝置變數:依 rt_device 結構定義裝置變數,並實作各項公共介面(也可以是空函數)。
  2. 定義私有資料域:依裝置類型定義自己的私有資料。特別是在有多個相同裝置時,介面可共用同一套,差異只在各自的資料域(例如暫存器基底位址)。
  3. 擴展物件:依 RT-Thread 的物件模型,可將私有資料結構賦值到控制塊的 user_data 指標上,或直接就 rt_device 結構進行派生。
  4. 註冊裝置:依裝置類型呼叫 rt_device_register 介面註冊到 RT-Thread 裝置框架中。

完成以上步驟,一個可被上層應用標準化訪問的裝置驅動即告完成。這種「統一介面、獨立實作」的設計,正是 RT-Thread I/O 管理模組兼顧可移植性與可靠性的關鍵所在。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved