目標與激勵
驅動程式架構會管理硬體裝置和用戶端之間的連線。過去,這個連線提供三種 FIDL 通訊協定:
- fuchsia.io/Node
- fuchsia.device/Controller
- 裝置的實際 FIDL 通訊協定
此多工處理需要驅動程式架構擁有管道,以便手動提供節點和控制器通訊協定。這樣可以防止基礎驅動程式庫擁有管道,進而限制驅動程式能執行的作業,並避免驅動程式使用標準 FIDL 線路伺服器物件和模式。
這種隱式多工處理也會違反組合的 FIDL 設計原則。FIDL 設計原則中,通訊協定在編譯時可以是多個通訊協定的 composed
。然而,驅動程式架構會在執行階段執行這項組成,而且不知道裝置所說的 FIDL 通訊協定。
與 devfs 互動的許多用戶端會將各自的管道從一種 FIDL 通訊協定投放到另一個,進而消除類型安全,讓程式碼更難以依循。
這項專案最初目標是從驅動程式架構中移除 FIDL 多工處理功能。在這種情況下,你必須更新與駕駛員互動的用戶端。
完成這項專案後,駕駛人將能在自己與其用戶端之間取得管道。
技術背景
貢獻者應熟悉 FIDL 用戶端。貢獻者不必熟悉駕駛人或驅動程式庫架構。
如何提供協助
挑選工作
許可清單中的每一行都代表一項工作。您可以在這裡挑選這些工作。
fuchsia.io/Node
有 1 個許可清單和 fuchsia.device/Controller
的許可清單。
執行工作
遺憾的是,這個多工處理是隱式的,所以沒有什麼好方法能得知哪個程式碼需要先使用此程式碼。最好的工具就是從許可清單中移除一行 並找出會造成破壞的情況
要找出元件最簡單的方法,就是先確認 QEMU 啟動。如果仍無法啟動,請檢查並修正所有錯誤。QEMU 啟動後,您可以透過 CQ 執行 CL,以嘗試尋找其他錯誤。
依賴多工處理的元件會先擁有相關 Devfs 路徑的存取權。藉由搜尋 dev
、dev-class
或 dev-class-{name}
的 CML 檔案,是找到相關元件的好方法。
修正 fuchsia.io/Node
如果移除這個多工處理,則使用裝置做為檔案描述元 (或稱 fd
) 的程式碼將會中斷。
這類程式碼非常可疑:
fbl::unique_fd fd;
zx_status_t status = fdio_open(dev_path, 0, fd.reset_and_get_address());
應替換為 FIDL 導向的程式碼:
zx::result client_end = component::Connect<fidl_my_protocol::Protocol>(dev_path);
修正 fuchsia.device/Controller
如果移除這個多工處理,連線至 fuchsia.device/Controller
的程式碼將會中斷。使用者可能會更容易找到這些位置,因為在損壞的任何元件中,g 代表可能會使用這個通訊協定。
程式碼看起來會像這樣:
component::ConnectAt<fuchsia_device::Controller>(caller.directory(), device_path);
修正方式為開啟裝置控制器的路徑,此路徑一律為裝置路徑加上 /device_controller
。
舉例來說,以下是更新後的程式碼:std::string device_controller_path = device_path + "/device_controller";
component::ConnectAt<fuchsia_device::Controller>(caller.directory(), device_controller_path);
這適用於類別路徑和邏輯路徑,例如:/dev/class/input/000/device_controller
/dev/sys/platform/usb/usb-hid/device_controller
此外,也請留意將管道投放到裝置控制器的程式碼:
fidl::WireCall<fuchsia_device::Controller>(channel)->Rebind();
您必須找出程式碼接收 channel
的位置,然後更新以連線至裝置控制器。
如果程式碼會來回轉換單一管道,則需要更新才能傳輸兩個頻道。
完成工作
您的 CL 通過 CQ 後,應該就可以合併了!感謝你提供協助。
範例
偵錯
如果您移除類別,但仍有程式碼使用多工處理,您將會看到以下錯誤訊息:
{$TOPOLOGICAL_PATH} ({$PROTOCOL_ID}): Failed to send message with ordinal={$ORDINAL} to device: FIDL endpoint was unbound due to unexpected message, status: ZX_ERR_NOT_SUPPORTED (-2), detail: unknown ordinal
It is possible that this message relied on deprecated FIDL multiplexing.
For more information see https://fuchsia.dev/fuchsia-src/contribute/open_projects/drivers/fidl_multiplexing
拓撲路徑和通訊協定 ID 可做為良好提示,說明哪些裝置和 FIDL 通訊協定仍依賴多工處理。
贊助商
提出問題或查看最新狀態: