RT-Thread 的 I/O 設備管理模組為應用提供了一套訪問裝置的通用介面,並透過定義的資料結構對裝置驅動程式與裝置資訊進行管理。從系統整體來看,I/O 管理模組相當於裝置驅動程式與上層應用之間的一個中間層。
它實現了對裝置驅動程式的封裝:驅動程式的實作與 I/O 管理模組彼此獨立,提升了模組的可移植性。應用程式透過 I/O 管理模組提供的標準介面訪問底層裝置,因此驅動程式升級不會影響上層應用。這種方式讓與裝置硬體操作相關的程式碼和應用相互隔離,雙方只需各自關注自身功能,从而降低程式碼複雜度、提高系統可靠性。
裝置控制塊 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、電源管理等多種類型。
裝置在被上層應用訪問前,需先註冊到系統中。註冊時會先以裝置名查找,若已存在則回傳錯誤;否則初始化內核物件並記錄標誌:
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;
}
與註冊相反,卸載是將裝置從管理系統中移除:
rt_err_t rt_device_unregister(rt_device_t dev) {
RT_ASSERT(dev != RT_NULL);
rt_object_detach(&(dev->parent)); // 從內核物件系統移除
return RT_EOK;
}
此函數會掃描所有已註冊的裝置,逐一呼叫其初始化函數,通常在 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;
}
依裝置名找到對應的控制塊。查找過程中會進入臨界區(停止執行緒排程)以確保資料一致:
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;
}
打開裝置時,若尚未啟用會先呼叫初始化;並針對獨立裝置檢查是否已被打開,避免重複開啟。關閉則呼叫 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;
}
讀寫操作會檢查裝置是否實作對應介面,若無則設定錯誤碼 -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;
}
裝置收到資料時會主動呼叫接收回呼,通常僅做簡單處理(如釋放信號量),再由專門的接收執行緒處理資料;發送完成時則呼叫發送回呼。這兩個介面分別用於設定對應的回呼函數:
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;
}
了解了控制塊結構與操作介面後,實作一個裝置驅動的步驟如下:
rt_device_register 介面註冊到 RT-Thread 裝置框架中。完成以上步驟,一個可被上層應用標準化訪問的裝置驅動即告完成。這種「統一介面、獨立實作」的設計,正是 RT-Thread I/O 管理模組兼顧可移植性與可靠性的關鍵所在。