Community코딩 & 개발github.com

모바일 GPU 프로파일링 (Mali 및 Adreno 하드웨어 카운터)

휴대폰 GPU의 하드웨어 카운터를 직접 읽어 실제 병목 지점을 파악하고, 그에 맞는 최적화를 적용할 수 있도록 돕는 코딩 스킬입니다. Arm Mali (Arm Performance Studio)와 Qualcomm Adreno (Snapdragon Profiler / Android GPU Inspector) GPU를 지원하며, adb를 통해 Mali 카운터를 캡처하고 분석하는 스크립트를 제공합니다.

모바일 GPU 프로파일링 (Mali 및 Adreno 하드웨어 카운터)란 무엇인가요?

이 스킬은 모바일 GPU의 하드웨어 카운터를 직접 읽어 프레임 속도 저하의 근본 원인이 GPU 내부의 어떤 부분 (픽셀, 정점, 텍스처, 대역폭, 셰이더 연산)에 있는지 정확히 진단합니다. `mobile-3d-rendering` 스킬로 외부 지표(FPS, 메모리 등)를 측정한 후, GPU가 실제로 한계인지 확인하고 싶을 때 사용합니다. Arm Mali GPU는 `gpu_profile.py` 스크립트를 통해 Streamline (헤드리스) 캡처를 수행하고, Mali Offline Compiler(malioc)로 셰이더 비용을 분석합니다. Qualcomm Adreno GPU는 Snapdragon Profiler 또는 Android GPU Inspector(AGI)를 통해 유사한 분석을 수행합니다. 분석 결과는 GPU 바운드, 프래그먼트/지오메트리/대역폭 병목 등 구체적인 원인과 함께 권장 수정 사항을 보고서로 제공하며, 최종적으로 `device_probe.py`로 성능 개선 효과를 재확인하는 워크플로우를 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/P0r0ro/mobile-gpu-profiling-skill/tree/HEAD/mobile-gpu-profiling

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

모바일 GPU 프로파일링 (Mali 및 Adreno 하드웨어 카운터)은(는) 무엇을 하나요?

mobile-3d-rendering은 외부에서 측정합니다: fps, 메모리, 온도 및 엔진 카운터. 이 스킬은 GPU를 열고 하드웨어 카운터를 읽습니다. 질문에 답합니다: GPU가 정말 한계인가요? 만약 그렇다면, 픽셀, 정점, 텍스처, 대역폭 또는 셰이더 수학 중 어떤 것 때문인가요? 각각 다른 수정이 필요하므로 추측은 시간 낭비입니다.

언제 사용하는가 (첫 단계가 아니라, 문제 에스컬레이션 시):

  • mobile-3d-rendering 트라이지에서 드로우 콜 예산은 충분한데 fps가 목표치 이하이거나, 드로우 콜과 삼각형을 줄여도 fps가 변하지 않을 때;
  • 높은 수준의 효과(노멀 맵, MSAA 4x, 블룸 후광, 더 많은 조명)가 기준 폰에서 예산에 맞는지 결정할 때;
  • 어떤 셰이더 또는 머티리얼이 비용이 많이 드는지 찾을 때;
  • 명백한 원인 없이 발열이 발생할 때 (대역폭 문제가 여기서 드러납니다);
  • 한 벤더에서 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, 드라이버, 안드로이드 버전, 화면 크기
GPU카운터 캡처셰이더 비용프레임 캡처
Arm Mali / Immortalisgpu_profile.py mali-capture (Streamline, 헤드리스)malioc_batch.py (Mali Offline Compiler)Frame Advisor, RenderDoc for Arm GPUs
Qualcomm AdrenoSnapdragon Profiler Realtime/Trace (GUI), 또는 Android 11+ 지원 기기에서 AGIAdreno 오프라인 컴파일러 (가능한 경우) 또는 SDP 셰이더 통계Snapdragon Profiler Snapshot, AGI 프레임 프로파일러
기타 (PowerVR, Xclipse)벤더 도구 / AGI; gpu_profile.py gpu-busy—RenderDoc / AGI

각 도구 설치 방법: references/arm-performance-studio.md, references/adreno.md. 앱은 디버깅 가능한 빌드여야 합니다 (Godot: 디버그 내보내기; Unity: Development Build; android:debuggable="true").

1. Mali: 카운터 캡처 및 읽기

python3 $S/gpu_profile.py mali-capture -p <패키지> -s 30 -o gpu-profile-<이름>
#   첫 번째 실행 시 해당 GPU에 대한 Arm 템플릿에서 카운터 구성을 빌드합니다 (~/.cache/mobile-gpu-profiling에 캐시됨)
#   스크립트가 앱을 실행합니다; 측정하려는 장면을 재생합니다 (최악의 경우: 군중, 전투, 밤)
python3 $S/gpu_profile.py mali-analyze gpu-profile-<이름>/capture.apc --fps 60   # 나중에 다시 읽기

report.md + metrics.json 파일을 생성합니다. 상단의 진단 결과를 읽고, 그 다음 숫자들을 확인합니다.

메트릭중간급 폰에서 양호그렇지 않을 경우
gpu_util목표 fps에서 < 75–80% (열 헤드룸)> 85%: GPU 바운드, 다음 행을 읽으세요. < 60%에서 낮은 fps: CPU 바운드이므로 CPU를 프로파일링하세요
fragment_queue_util vs non_fragment_queue_util / tiler_util—100%에 가까운 쪽이 한계입니다: 프래그먼트 = 픽셀당 비용; 논프래그먼트/타일러 = 정점, 삼각형, 그림자 캐스터
fragments_per_screen_pixel< 2.0 (모든 패스)오버드로우, 섀도우 맵, 추가 렌더 패스 (render_passes_per_frame 참조)
alu_instr_per_fragmentBifrost에서 < 20–30무거운 프래그먼트 셰이더 → §2
tex_compressed_share / tex_mipmapped_share씬 텍스처에 대해 높음압축되지 않음/밉맵 없는 텍스처는 대역폭과 캐시를 낭비합니다 (섀도우 맵과 렌더 타겟은 절대 압축되지 않으므로 어떤 텍스처가 지배적인지 확인)
late_zs_test_share< 10%discard/알파 테스트, 또는 셰이더 깊이 쓰기, 조기-Z 비활성화
early_zs_kill_rate, fpk_occluding_share높을수록 좋음불투명체를 앞에서 뒤로 정렬; 큰 표면에서 discard 사용 피하기
bandwidth_mb_per_frame2018–2020 폰에서 60 fps 기준 < ~30–40 MB렌더 타겟, 압축되지 않은 텍스처, MSAA 리졸브 → 발열
facing_culled_share닫힌 메시에서 ~40–50%양면 머티리얼이 정점 작업을 두 배로 늘림
fp16_varying_share높음mediump varyings는 보간 비용을 절반으로 줄임

전체 카운터-수정 참조표와 공식은 references/mali-counters.md에 있습니다.

프레임 마커: Performance Advisor의 프레임별 HTML 보고서에는 Arm 레이어의 프레임 경계가 필요합니다. Arm은 Android 11+를 지원합니다. Android 10 (Galaxy Note 9에서 테스트)에서는 카운터가 작동하지만 레이어의 프레임이 gatord에 도달하지 않아 스크립트는 캡처 중 SurfaceFlinger에서 측정한 fps로 초당 카운터를 대신 사용합니다.

2. 비용이 많이 드는 셰이더 찾기 (모든 엔진, Mali 비용 모델)

# Godot (Compatibility/GLES3): 데스크톱에서 Mesa를 통해 게임이 실제로 컴파일하는 GLSL ES 덤프
HEADLESS=1 $S/godot_dump_shaders.sh <godot_프로젝트> dump/ 20 [res://test_scene.tscn]
python3 $S/malioc_batch.py --core Mali-G72 dump/ --label-src <godot_프로젝트>/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을 사용합니다. 해당 메트릭에서 동일한 질문을 읽습니다: % 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에 있습니다.

Android 11+ 기기에서 AGI가 지원하는 경우, Android GPU Inspector는 벤더 중립적인 카운터와 프레임 프로파일러를 제공합니다. 도구 없이 빠른 사용률을 읽으려면 gpu_profile.py gpu-busy -s 30이 빌드에서 허용하는 경우 커널의 busy 노드를 읽습니다.

4. 카운터에서 변경 사항으로 (그리고 확인)

  1. 보고서가 지목하는 가장 큰 제한 요소를 수정하십시오. 한 번에 하나만 변경하십시오.

  2. 일반적인 매핑:

    제한수정
    프래그먼트 바운드더 적거나 작은 섀도우 맵과 더 짧은 섀도우 거리, 더 적은 투명 오버드로우, 큰 표면에서 더 저렴한 셰이더 (수학을 정점 셰이더로 이동, Low/Medium에서 픽셀당 노이즈/안개/스펙큘러 제거, mediump 사용), 압축+밉맵 텍스처, 안전하다고 입증된 경우에만 내부 해상도 낮춤 (Mali-G72는 렌더 스케일링으로 메모리 누수 발생)
    지오메트리/타일러 바운드LOD 및 가시성 범위, 더 적은 섀도우 캐스터, 후면 컬링 켜기, 군중에 대한 단순화된 스키닝
    대역폭/발열압축된 텍스처, 더 적은 렌더 타겟/패스, 포스트 AA 대신 MSAA, 전체 화면 포스트 없음
    CPU 바운드 (GPU < 60% 사용)드로우 콜, 스크립트, 애니메이션, 물리 (performance-optimization)
  3. 동일한 장면을 다시 캡처하고 metrics.json을 이전/이후 비교합니다 (프레임당 GPU ms, 제한 요소의 비율).

  4. 기기에서 device_proxy.py로 최소 60초 동안 확인합니다 (fps, p95, 메모리 기울기, 온도). 카운터에서 이겼지만 기기를 가열시키거나 메모리 누수가 발생한다면 승리가 아닙니다.

  5. 프로젝트 노트에 결과를 기록합니다 (무엇이 바운드였는지, 무엇이 수정했는지, 이전/이후 숫자).

실제 캡처에서 얻은 까다로운 규칙

  • GPU의 템플릿에서 카운터 구성을 생성하고 기본적으로 GPU 카운터만 유지하십시오. CPU PMU 카운터는 Samsung Android 10 커널에서 캡처 자식 프로세스를 시작 시에 종료시켰습니다.
  • Wi-Fi adb는 작동하지만, 기기 ID는 ip:port입니다. 모든 곳에 전달하십시오 (스크립트가 처리합니다).
  • 충돌한 캡처는 gatord 에이전트를 앱의 샌드박스 내에 남겨둘 수 있습니다. 이들은 다음 캡처의 소켓을 차단하고 ("Address already in use") 이를 조기에 종료시킵니다. 스크립트는 PID로 이를 종료합니다 (run-as <pkg> pkill은 작동하지 않았습니다).
  • 캡처 직전에 앱을 강제 종료하면 1초 후에 캡처가 끝날 수 있습니다. 스크립트는 상황이 안정될 때까지 기다립니다.
  • Streamline-cli -generate-config는 -help 텍스트와 달리 -template <이름>을 대상 앞에 필요로 합니다.
  • Godot은 GLES 셰이더 캐시를 user://shader_cache에 유지하므로, 두 번째 데스크톱 실행에서는 아무것도 컴파일하지 않습니다. 새 XDG_DATA_HOME을 사용하십시오 (덤프 스크립트가 수행).
  • 데스크톱에서 실제 게임을 실행하여 감사하면 자동 저장이 기록됩니다. 사용자 데이터 디렉토리를 격리하십시오.

참조

파일읽을 때
references/arm-performance-studio.mdStreamline, Performance Advisor, Frame Advisor, RenderDoc for Arm, malioc 설치/사용; 헤드리스 파이프라인 세부 정보
references/mali-counters.md각 Mali 메트릭의 의미, 공식, 임계값, Bifrost vs Valhall vs 5세대
references/adreno.mdSnapdragon Profiler / AGI 설정 및 Adreno 메트릭-수정 테이블
references/shader-cost.mdGodot/Unity/three.js/Bevy에서 컴파일된 셰이더를 추출하고 malioc 출력을 읽는 방법

관련 스킬