執行階段依附元件
Magma 驅動程式庫和程式庫應該已內建於完整的 Fuchsia 映像檔中。系統會根據建構時所選的主面板,建構並載入正確的驅動程式庫。
元件資訊清單
請納入下列內容,以便存取 Vulkan 驅動程式庫:
行銷長
針對使用 .cml 資訊清單宣告的元件:
{
include: [
"vulkan/client.shard.cml"
],
use: [
{ protocol: "fuchsia.media.ProfileProvider" },
],
...
}
fuchsia.media.ProfileProvider
能力選用,但建議使用。
必要的能力路徑
使用 Vulkan 的元件必須將下列 FIDL 服務轉送到該元件:
fuchsia.sysmem.Allocator
fuchsia.vulkan.loader.Loader
fuchsia.tracing.provider.Registry
fuchsia.logger.LogSink
fuchsia.media.ProfileProvider
- 選用,但強烈建議使用;只有在 Vulkan ICD 中的期限執行緒使用安全疑慮時,才應將其省略。如未指定,Vulkan ICD 將對內部執行緒使用預設執行緒優先順序,可能導致效能降低。未包含在vulkan/client.shard.cml
中,因此必須以手動方式use
。
測試元件可在非密封的領域執行以接收這些功能:
# BUILD.gn
fuchsia_test_component("my_test_component") {
component_name = "my_test"
manifest = "meta/my_test.cml"
deps = [ ":my_test_bin" ]
# This runs the test in "vulkan-tests" non-hermetic realm.
test_type = "vulkan"
}
- 針對
vulkan-test
,請將 test_type 標示為vulkan
- 針對
system-test
,請將 test_type 標示為system
測試元件可以使用 vulkan_envs 環境,確保這些元件會在所有支援 Vulkan 的建構機器人上執行。
建構時間依附元件
樹狀結構內建構
樹狀結構內程式碼應依附於 //src/lib/vulkan
,以便加入 vulkan 標頭和與 libvulkan.so
的連結。
其他實用目標:
//src/lib/vulkan:vulkan_validation_layers
:必須啟用 Vulkan 驗證層才能啟用。
SDK 用戶端
使用 Bazel SDK 的程式碼應依附於 @fuchsia_sdk//pkg/vulkan
。
在螢幕上轉譯
顯示轉譯輸出內容的方式有兩種:
系統合成器
詳情請參閱景觀說明文件。
直接在螢幕上
這個方法與具有系統合成器的系統不相容。
您可以使用自訂版本的 WSI 交換鏈。
如要進一步瞭解 Fuchsia 自訂,請參閱 vkcube 範例。請注意,已移除選項 1 的交換鏈支援。
報表問題
請留意各種圖形驅動程式庫相關問題的系統記錄,並在 Magma 專案中提交支援單。發生這些問題時,驅動程式應終止與當下執行環境相對應的連線,但應妥善處理這個錯誤。
如果之後仍無法解決問題,請同樣地提報問題。
GPU 錯誤
如下所示。這可能是因為使用者錯誤或驅動程式庫錯誤。請確保應用程式沒有 Vulkan 驗證層問題。
如果您認為您的應用程式純屬無害,請提交 Magma 支援單,並至少附上這部分記錄,而且最好附上重新驗證的食譜:
> [WARNING] GPU fault detected
> ---- device dump begin ----
> RELEASE build
> Device id: 0x1916
> RENDER_COMMAND_STREAMER
> sequence_number 0x1003
> active head pointer: 0x1f328
> ENGINE FAULT DETECTED
> engine 0x0 src 0x3 type 0x0 gpu_address 0x1000000
> mapping cache footprint 11.9 MB cap 190.0 MB
> ---- device dump end ----
> [WARNING] resetting render engine
GPU 停止運作
如果指令緩衝區無法在特定時間內完成,gpu 驅動程式應偵測其狀況,並將其視為錯誤發生。
這也可能是應用程式錯誤或驅動程式庫錯誤。如果您認為您的應用程式純屬無害,請提交 Magma 支援單,並至少附上這部分記錄,而且最好附上重新驗證的食譜:
> [WARNING] Suspected GPU hang: last submitted sequence number 0x1007 master_interrupt_control 0x80000000
> ---- device dump begin ----
> DEBUG build
> Device id: 0x1916
> RENDER_COMMAND_STREAMER
> sequence_number 0x1006
> active head pointer: 0x20
> No engine faults detected.
> mapping cache footprint 0.0 MB cap 0.0 MB
> ---- device dump end ----
> [WARNING] resetting render engine