본문으로 건너뛰기
오픈소스 전체 목록

DroidDeck Turnip Drivers

  • 추천0
  • GitHub 별38
  • 게임라이선스GPL-3.0

DroidDeck용 Turnip(Mesa freedreno Vulkan) 드라이버 빌드. 안드로이드용과 리눅스 ARM64용을 한 묶음으로 내요(GPL-3.0)

원본:Droid-Deck/Drivers

요약

DroidDeck용 Turnip(Mesa freedreno Vulkan) 드라이버 빌드. 안드로이드용과 리눅스 ARM64용을 한 묶음으로 내요(GPL-3.0)

설명

DroidDeck Turnip Drivers

DroidDeck용 Turnip(Mesa freedreno Vulkan)입니다. 빌드할 때마다 최신 Mesa main을 받아 patches/의 패치 세트를 적용하고, 같은 Mesa 커밋 하나에서 드라이버 둘을 빌드합니다. 안드로이드 드라이버(Adrenotools 방식)와 리눅스 ARM64 드라이버이며, 둘은 릴리스마다 한 묶음으로 나옵니다.

묶음

릴리스마다 DD-Turnip-vX.Y.Z.zip, 그 .sha256, DD-Turnip-vX.Y.Z-source.tar.xz가 올라옵니다.

manifest.json
android/libvulkan_freedreno.so
android/meta.json
linux/libvulkan_freedreno.so
linux/meta.json
NOTICE
LICENSES/GPL-3.0.txt
LICENSES/mesa/…

패치 세트는 GPL-3.0으로 배포되므로, 릴리스마다 드라이버 옆에 대응 소스(Corresponding Source)가 함께 나옵니다. -source.tar.xz에는 빌드한 커밋의 Mesa(mesa/)와 그것을 빌드한 커밋의 이 저장소(drivers/)가 들어 있습니다. zip 안의 NOTICE가 그 위치와 적용되는 라이선스를 알려 줍니다.

경로드라이버
android/안드로이드, bionic libc, NDK r26d, KGSL. meta.json은 Adrenotools 형식이라 폴더 그대로 불러올 수 있습니다.
linux/리눅스 ARM64, glibc, KGSL + MSM, Wayland/X11 WSI. meta.json에 플랫폼, libc, Mesa 커밋, 라이브러리 SHA-256이 적혀 있습니다.

manifest.json이 두 드라이버를 색인해서 로더가 플랫폼으로 하나를 고릅니다.

{
  "schemaVersion": 1,
  "package": "DD-Turnip",
  "version": "0.1.0",
  "tag": "DD-Turnip-v0.1.0",
  "mesa": { "version": "26.3.0-devel", "commit": "…", "source": "https://gitlab.freedesktop.org/mesa/mesa" },
  "drivers": {
    "android": { "path": "android", "library": "android/libvulkan_freedreno.so", "meta": "android/meta.json", "architecture": "aarch64", "libc": "bionic", "sha256": "…" },
    "linux":   { "path": "linux",   "library": "linux/libvulkan_freedreno.so",   "meta": "linux/meta.json",   "architecture": "aarch64", "libc": "glibc",  "sha256": "…" }
  }
}

패키징은 두 라이브러리가 모두 AArch64이고, 알맞은 libc에 링크되고, 플랫폼 표식(안드로이드는 IMapper5 gralloc, 리눅스는 Wayland와 XCB WSI)을 지니고, 같은 Mesa 커밋에서 빌드된 경우에만 묶음을 만들어 줍니다.

패치 세트

patches/series.json이 모든 패치를 순서대로, 대상과 요약과 함께 나열합니다. 같은 파일이 빌드와 릴리스 노트를 움직입니다.

패치안드로이드리눅스
scripts/gralloc_ubwc_detect.py✓
scripts/fix_a8xx_dev_info.py✓✓
scripts/apply_a8xx_gpus.py✓✓
scripts/apply_a8xx_cat4_rpt.py✓✓
scripts/apply_a7xx_gen1_quirks.py✓✓
scripts/add_aimapper_gralloc.py + aimapper/u_gralloc_aimapper.c✓
scripts/add_ubwc_swapchain_usage.py✓
scripts/a8xx_resolve_cr_cntl.py✓✓
scripts/a8xx_sp_hysteresis.py✓✓
scripts/a8xx_lrz_color_mask.py✓✓
scripts/autotune_bandwidth.py✓✓
scripts/android_ndk_compat.py✓
scripts/linux_kgsl_wsi.py✓
scripts/process_heap_usage.py✓✓
linux/0001 … linux/0006(메시 셰이더, 반파(half-wave) 서브그룹, A8XX 큐브, 바인드리스와 IB 수정, 서브그룹 셔플 브로드캐스트)✓
lrz/0001(다음 렌더 패스 전의 A8XX LRZ 플러시)✓✓
linux/0007(풀을 리셋한 뒤에도 디스크립터 세트가 정렬을 유지)✓
nir/0001(미리 시프트한 스트라이드의 32비트 SSBO 오프셋 랩, UE5 Nanite)✓✓
tu/0001(명령 버퍼에 걸쳐 쪼개진 렌더 패스 체인 앞의 플러시, UE5 간접 드로우)✓✓

앵커가 더는 Mesa main과 맞지 않는 스크립트는 0이 아닌 값으로 종료하고, 더는 적용되지 않는 .patch는 git apply가 실패합니다. 그래서 업스트림이 바뀌면 수정이 빠진 드라이버를 내보내지 않고 빌드가 실패합니다. Check 워크플로가 푸시마다 전체 패치 세트를 현재 Mesa main에 적용해 봅니다.

RedMagic UBWC 스왑체인과 IMapper5 gralloc 작업은 Leb-Sun의 것입니다. A8XX 리졸브, 히스테리시스, LRZ 컬러 마스크 레지스터 패치는 Vauzi-17/710에서 가져와 고쳤습니다. A845 / A850 카테고리 4 반복 우회는 misakayuuki의 것입니다. SSBO 오프셋 랩과 렌더 패스 체인 플러시 수정은 K11MCH1의 것입니다. airidosas252의 A8XX 버퍼 디스크립터 크기 수정은 이제 Mesa main에 들어가 있어서(5b2db4b8) 여기서는 더 싣지 않습니다.

버전 규칙

태그는 DD-Turnip-vX.Y.Z입니다. 다음 버전은 게시된(초안도 시험판도 아닌) 가장 높은 DD-Turnip-v* 릴리스에서 정해집니다.

계기규칙예
아직 릴리스 없음0.1.0→ 0.1.0
주간 일정, 또는 Hotfix 없이 수동 실행minor + 1, 패치 초기화. minor 9는 다음 major로 넘어감0.1.0 → 0.2.0, 0.1.5 → 0.2.0, 0.9.0 → 1.0.0, 1.9.3 → 2.0.0
Hotfix로 수동 실행patch + 10.1.0 → 0.1.1 → 0.1.2, 0.9.0 → 0.9.1

승격하지 않은 시험판은 세지 않으므로, 같은 버전의 다음 빌드가 그것을 대체합니다.

릴리스 노트

  • 0.1.0은 빌드 커밋까지 30일 동안 Mesa main에 병합된 Turnip, Vulkan 런타임, gralloc 커밋을 나열합니다.
  • 이후 릴리스는 이전 릴리스 노트에서 Mesa 커밋을 읽고, 두 빌드 사이의 모든 업스트림 커밋을 나열합니다. Turnip, Vulkan 런타임, gralloc 커밋은 따로 짚고 GitLab 비교 링크를 붙입니다.
  • 모든 릴리스는 대상별로 적용한 패치를 나열합니다.

워크플로

  • release.yml은 매주 수요일 12:00 UTC와 수동 실행(Hotfix와 Prerelease 체크 상자)에 돕니다. 정해진 일정 실행은 마지막 릴리스나 시험판 이후 Mesa main에 Turnip, Vulkan 런타임, gralloc 커밋이 있거나 이 저장소가 바뀐 경우(scripts/turnip_changed.py)에만 빌드합니다. 정해진 일정 실행이 실패하면(보통 패치가 더는 적용되지 않을 때) 이슈를 열고(이미 열려 있으면 댓글을 달고), 다음 정해진 빌드가 그것을 닫습니다. 정해진 일정이나 수동 실행이 성공하면 Drivers-CI에 최신 릴리스로 바로 게시됩니다. Prerelease 실행은 여기에만 시험판을 게시하며 DroidDeck은 그것을 보지 못합니다. promote.yml이 승인된 시험판을 Drivers-CI에 게시하고 최신으로 표시합니다. 버전과 Mesa main 커밋을 정하고, 그 커밋에서 안드로이드와 리눅스를 병렬로 빌드하고, 묶음을 패키징해 검증한 뒤, 여기와 공개 저장소 Droid-Deck/Drivers-CI에 릴리스를 게시합니다. Drivers-CI에는 릴리스 자산(묶음, .sha256, 소스 아카이브)만 있고, DroidDeck이 드라이버를 내려받는 곳입니다. 거기에 게시하려면 DRIVERS_CI_TOKEN 비밀 값이 필요합니다. Drivers-CI에 Contents 읽기·쓰기 권한이 있는 세분화된 토큰입니다.
  • promote.yml은 시험판 태그를 넣어 수동 실행하며, 자산과 노트를 Drivers-CI로 복사하고 두 저장소에서 최신 릴리스로 표시합니다.
  • check.yml은 푸시와 풀 리퀘스트마다 버전 테스트를 돌리고 패치 세트를 Mesa main에 적용합니다.
gh workflow run release.yml
gh workflow run release.yml -f hotfix=true
gh workflow run release.yml -f prerelease=true
gh workflow run promote.yml -f tag=DD-Turnip-v0.4.0

로컬 빌드

./build.sh 0.1.0

Mesa main을 받아(MESA_REF로 다른 ref 선택) work/ 아래에서 두 드라이버를 빌드하고 dist/DD-Turnip-v0.1.0.zip과 .sha256, 소스 아카이브를 씁니다. 필요한 것: meson 1.5 이상, ninja, mako와 PyYAML이 있는 Python, flex, bison, 안드로이드 NDK를 가리키는 ANDROID_NDK_HOME, 그리고 리눅스 교차 빌드용 aarch64-linux-gnu-gcc/g++/binutils와 호스트 wayland-scanner입니다. 리눅스 sysroot는 우분투 24.04 arm64 패키지로 root 없이 만들어지며(scripts/linux_sysroot.sh), 이미 있으면 LINUX_SYSROOT로 재사용합니다.

라이선스

GPL-3.0입니다. LICENSE를 보세요.

저장소: https://github.com/Droid-Deck/Drivers

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0