行動裝置 GPU 效能分析 (Mali 與 Adreno 硬體計數器) 是做什麼的?
mobile-3d-rendering 從外部進行測量:FPS、記憶體、溫度與引擎計數器。
這個技能則直接打開 GPU,讀取它的硬體計數器。它能回答:GPU 真的是極限嗎?
如果是,瓶頸是來自 像素、頂點、紋理、頻寬還是著色器運算?每一種都需要不同的
修正方式,靠猜測只會浪費好幾天。
何時啟用它(升級處理,非第一步驟):
mobile-3d-rendering的初步分析顯示 FPS 未達標,但 Draw Calls 數量在預算內,或者 即使減少了 Draw Calls 和三角形數量,FPS 仍然沒有改善;- 需要決定某個高畫質特效(法線貼圖、4x MSAA、Bloom 光暈、更多動態光源)是否能在參考 手機的預算內運作;
- 找出哪個著色器或材質消耗效能;
- 出現原因不明的發熱(頻寬消耗是常見原因);
- 在某個特定 GPU 廠牌上出現 GPU 端的異常行為。
完成分析後,務必使用 mobile-3d-rendering/scripts/device_probe.py 在裝置上重新測量
(FPS、p95、記憶體斜率、溫度)。計數器負責解釋原因,而這個探測腳本負責確認結果。
0. 偵測 GPU 並選擇分析路徑
S=~/.claude/skills/mobile-gpu-profiling/scripts
python3 $S/gpu_profile.py detect # 廠牌、GPU、驅動程式版本、Android 版本、螢幕尺寸
| GPU | 計數器捕捉 | 著色器成本 | 幀捕捉 |
|---|---|---|---|
| Arm Mali / Immortalis | gpu_profile.py mali-capture (Streamline, 無頭模式) | malioc_batch.py (Mali Offline Compiler) | Frame Advisor, RenderDoc for Arm GPUs |
| Qualcomm Adreno | Snapdragon Profiler Realtime/Trace (GUI),或在支援的 Android 11+ 裝置上使用 AGI | Adreno offline compiler (若有) 或 SDP 著色器統計 | Snapdragon Profiler Snapshot, AGI 幀剖析器 |
| 其他 (PowerVR, Xclipse) | 廠商工具 / AGI; gpu_profile.py gpu-busy | — | RenderDoc / AGI |
各工具的安裝說明:references/arm-performance-studio.md, references/adreno.md。
應用程式必須是 可偵錯版本(Godot:debug export;Unity:Development Build;
android:debuggable="true")。
1. Mali:捕捉並讀取計數器
python3 $S/gpu_profile.py mali-capture -p <package> -s 30 -o gpu-profile-<name>
# 首次執行會根據 Arm 針對該 GPU 的範本建立計數器設定檔(快取在 ~/.cache/mobile-gpu-profiling)
# 腳本會啟動應用程式;請遊玩你想測量的場景(最壞情況:人群、戰鬥、夜晚)
python3 $S/gpu_profile.py mali-analyze gpu-profile-<name>/capture.apc --fps 60 # 稍後重新讀取
它會寫出 report.md 和 metrics.json。先閱讀報告頂部的判決,再查看數據:
| 計量指標 | 在中階手機上的健康數值 | 如果不正常 |
|---|---|---|
gpu_util | < 75–80% 在目標 FPS 時(保留散熱餘裕) | > 85%:GPU 瓶頸,請閱讀以下行。< 60% 且 FPS 低:CPU 瓶頸,請對 CPU 進行分析 |
fragment_queue_util vs non_fragment_queue_util / tiler_util | — | 哪個接近 100% 就是極限:fragment = 每像素成本;non-fragment/tiler = 頂點、三角形、陰影投射物 |
fragments_per_screen_pixel | < 2.0 (所有渲染 Pass) | 過度繪製、陰影貼圖、額外的渲染 Pass(請參閱 render_passes_per_frame) |
alu_instr_per_fragment | < 20–30 (Bifrost 架構) | 複雜的片段著色器 → 請參閱 §2 |
tex_compressed_share / tex_mipmapped_share | 場景紋理應為高 | 未壓縮/無 Mipmap 的紋理浪費頻寬和快取(陰影貼圖和渲染目標永遠不會被壓縮,所以請檢查哪些紋理佔主導地位) |
late_zs_test_share | < 10% | discard/alpha test,或著色器深度寫入,停用 Early-Z |
early_zs_kill_rate, fpk_occluding_share | 高是好的 | 由前到後排序不透明物件;避免在大型表面使用 discard |
bandwidth_mb_per_frame | < 約 30–40 MB (60 fps, 2018–2020 年手機) | 渲染目標、未壓縮紋理、MSAA 解析 → 發熱 |
facing_culled_share | 約 40–50%(封閉網格) | 雙面材質使頂點工作量加倍 |
fp16_varying_share | 高 | mediump varyings 可將插值成本減半 |
完整的計數器對應修正參考,包含公式,位於 references/mali-counters.md。
幀標記:Performance Advisor 的逐幀 HTML 報告需要來自 Arm Layer 的幀邊界。
Arm 支援 Android 11+。在 Android 10(已在 Galaxy Note 9 上測試)上,計數器可以運作,但
Layer 的幀從未到達 gatord,因此腳本會改為使用捕捉期間從 SurfaceFlinger 測量到的 FPS,
乘以每秒計數器來推算。
2. 找出耗費效能的著色器(任何引擎,Mali 成本模型)
# Godot (Compatibility/GLES3):透過桌面的 Mesa 傾印遊戲實際編譯的 GLSL ES
HEADLESS=1 $S/godot_dump_shaders.sh <godot_project> dump/ 20 [res://test_scene.tscn]
python3 $S/malioc_batch.py --core Mali-G72 dump/ --label-src <godot_project>/shaders --top 15
- 排名列表會顯示每個像素(或每個頂點)的週期數,以及哪個管線階段是瓶頸(A 算術、 LS 載入/儲存、V 變數、T 紋理)。標籤會標明 你的 著色器檔案;"engine" 表示內建模 材。
- 旗標:
occ50表示使用了超過 32 個工作暫存器,因此只有一半的執行緒在運行(延遲隱藏 效果較差);SPILL表示堆疊溢出;lateZS表示使用了 discard;fp16:0%表示沒有 使用 16 位元運算。 - 一個著色器的成本 ≈ 週期數 × 它所覆蓋的像素。一個覆蓋地面和建築物的 38 週期著色器, 遠比一個只用在小型招牌上的 60 週期著色器重要。
- Unity、three.js 和 Bevy 的著色器提取方法:
references/shader-cost.md。
傾印腳本會針對一份使用者資料的複製品執行遊戲,因此不會影響存檔和設定,同時 Godot 的 著色器快取也不會隱藏編譯過程。請在執行期間造訪你關心的區域(或傳入一個測試場景)。 Godot 會惰性編譯著色器變體。
3. Adreno (Qualcomm)
使用 Snapdragon Profiler:Realtime 模式用於即時指標,Trace 模式用於時間軸,Snapshot 模式
用於單一幀的逐個 Draw Call 統計資料。從它的指標中讀取相同的問題:% Shaders Busy、
% Time Shading Fragments vs Vertices、Avg Bytes / Fragment、% Texture Fetch Stall、
% Texture L1 Miss、ALU / Fragment、% Prims Trivially Rejected、Read/Write Total。
指標對應修正的表格在 references/adreno.md 中。
在支援 AGI 的 Android 11+ 裝置上,Android GPU Inspector 提供廠商中立的計數器以及一個
幀剖析器。如果想要一個不需要工具的快速使用率讀數,可以執行 gpu_profile.py gpu-busy -s 30,
它會讀取核心的 busy 節點(如果版本允許)。
4. 從計數器到修改(然後驗證)
-
修正報告指出的最大限制因素。一次只做一個修改。
-
典型的對應關係:
極限 修正方法 Fragment-bound 使用更少/更小的陰影貼圖和更短的陰影距離、減少透明物體的 Overdraw、在大型表面使用更便宜的著色器(將運算移至頂點著色器、在低/中畫質設定下移除逐像素噪點/霧氣/高光、使用 mediump)、使用壓縮且具有 Mipmap 的紋理、僅在確認安全的地方降低內部解析度(Mali-G72 在渲染縮放時曾發生記憶體洩漏) Geometry/Tiler-bound 設定 LOD 和可見範圍、減少陰影投射物、啟用背面剔除、對人群模型使用更簡單的蒙皮 Bandwidth/Heat 使用壓縮紋理、減少渲染目標/Pass、使用 MSAA 取代後處理反鋸齒、避免全螢幕後處理特效 CPU-bound (GPU < 60% 忙碌) 減少 Draw Calls、改善腳本、動畫、物理運算 ( performance-optimization) -
重新捕捉同一個場景,並比較修改前後的
metrics.json(GPU 每幀毫秒數、限制因素的佔比)。 -
使用
device_probe.py在裝置上確認至少 60 秒(FPS、p95、記憶體斜率、溫度)。一個讓手機 發熱或導致記憶體洩漏的計數器勝利不是真正的勝利。 -
將發現記錄在專案筆記中(什麼是瓶頸、如何修正、修改前後的數值)。
實戰經驗法則(來自真實捕捉經驗)
- 從 GPU 的範本產生計數器設定,並且預設只保留 GPU 計數器。CPU PMU 計數器曾經導致 Samsung Android 10 核心上的捕捉子程序在一開始就結束。
- Wi-Fi adb 可以運作,但裝置 ID 是
ip:port。請在每個命令中都傳入它(腳本已經這樣做)。 - 崩潰的捕捉可能會在應用程式的沙盒中留下仍在執行的
gatord代理程式。它們會阻擋下一次 捕捉的 socket(「Address already in use」)並使捕捉提前結束。腳本會透過 PID 殺死它們 (run-as <pkg> pkill無效)。 - 在捕捉前立即強制停止應用程式,可能會導致捕捉在一秒後就結束。腳本會等待系統穩定。
Streamline-cli -generate-config的-template <name>參數必須放在目標之前,儘管其-help說明文字指示不同。- Godot 會在
user://shader_cache中保留 GLES 著色器快取,因此第二次在桌面執行時將不會 編譯任何內容。請使用一個全新的XDG_DATA_HOME(傾印腳本已經這樣做)。 - 在桌面上執行真實遊戲以進行審計時,會寫入遊戲的自動存檔。請隔離使用者資料目錄。
參考資料
| 檔案 | 何時閱讀 |
|---|---|
references/arm-performance-studio.md | 安裝/使用 Streamline、Performance Advisor、Frame Advisor、RenderDoc for Arm、malioc;無頭管線細節 |
references/mali-counters.md | 每個 Mali 指標的意義、公式、閥值、Bifrost vs Valhall vs 第五代架構 |
references/adreno.md | Snapdragon Profiler / AGI 設定以及 Adreno 的指標對應修正表格 |
references/shader-cost.md | 從 Godot/Unity/three.js/Bevy 中取得已編譯著色器,並讀取 malioc 輸出 |