Files

T

Matteo Benedetto b08ac8c6a1 Add Linux ARM64 preset, Raspberry Pi 5 docs and remote zip fetcher

- export_presets.cfg: new "Linux ARM64" preset (arch arm64, embedded PCK,
  ETC2/ASTC textures, S3TC/BPTC off since the Pi 5 V3D driver lacks it).
- tools/zipfetch.py: pull a single member out of the remote export-templates
  tpz with HTTP Range requests instead of downloading the whole 1.28 GB.
- docs/BUILD-RASPBERRY-PI.md: reproducible procedure, Pi 5 renderer
  expectations (GLES3 fallback, Forward+ downgraded to Mobile) and the
  pitfalls verified on the field.

Verified: arm64 export produced (74.094.536 B, PCK embedded at the end of the
official template); the x86_64 export from the same tree runs without missing
resources.

2026-10-24 16:08:32 +02:00

4.5 KiB

Raw Permalink Blame History

Build standalone per Raspberry Pi 5 (arm64)

Stato: procedura verificata sulla generazione del binario (export reale prodotto e validato); la prova di esecuzione va fatta sul Pi 5, che non è questa macchina.

Artefatto prodotto il 2026-10-24 con Godot 4.7.1.stable (a13da4feb), commit 4af402f8 (tag v1.0.0-kiosk).

Esito

Voce	Valore
File	`build/linux-arm64/work_death_balance.arm64`
Tipo	ELF 64-bit LSB, ARM aarch64, interpreter `/lib/ld-linux-aarch64.so.1`
Dimensione	74.094.536 byte (≈70,7 MiB) = template 67.046.672 + PCK 7.047.864
PCK	incorporato (`embed_pck=true`), magic `GDPC` a offset 67.046.672, pack_version 4
Texture	`etc2_astc=true`, `s3tc_bptc=false` (v3d/V3D 7.1 non supporta S3TC/BPTC)
Addon nativo	non incluso: il preset esclude `addons/*`; nessun `.so` arm64 necessario

Perché serve poco lavoro

I template ufficiali Godot includono Linux arm64 (le architetture ufficiali sono x86_32, x86_64, arm32, arm64). L'export è un cross-export: si esegue su x86_64, non serve toolchain aarch64 né compilare il motore.
La GDExtension goldsrc non è nel gioco esportato: export_presets.cfg ha exclude_filter="addons/*" e l'unico riferimento nel codice è un commento in scripts/grenade_explosion.gd:3. I modelli sono già .scn pre-estratti. (Nel repository i binari dell'addon sono solo x86_64: irrilevante per l'export.)

Procedura riproducibile

# 1. Godot 4.7.1 editor (x86_64) in ~/.local/opt/godot-4.7.1/
#    https://github.com/godotengine/godot-builds/releases/tag/4.7.1-stable
#    (solo il template che serve: templates/linux_release.arm64 dal tpz)

# 2. template installati in:
#    ~/.local/share/godot/export_templates/4.7.1.stable/{linux_release.arm64,version.txt}
#    version.txt deve contenere esattamente: 4.7.1.stable

# 3. import del progetto (genera .godot/), una volta sola
godot --headless --path . --import

# 4. export
godot --headless --path . --export-release "Linux ARM64" \
      build/linux-arm64/work_death_balance.arm64

Il preset Linux ARM64 è in export_presets.cfg ([preset.2]) ed è identico a Linux tranne per: binary_format/architecture="arm64", texture_format/etc2_astc=true, texture_format/s3tc_bptc=false, export_path="build/linux-arm64/work_death_balance.arm64".

Scaricare solo il template che serve (1,28 GB → 27 MB)

Il tpz dei template è uno zip: tools/zipfetch.py legge EOCD e central directory via HTTP Range e scarica il solo membro richiesto. Comodo su connessioni lente.

Sul Pi 5: aspettative e leve

GPU: Broadcom VideoCore VII (V3D 7.1). Mesa espone OpenGL 3.1 desktop + OpenGL ES 3.1 (v3d) e Vulkan 1.2/1.3 conformante (v3dv).

Il progetto è forward_plus. Su Vulkan il Forward+ viene declassato automaticamente a Mobile ("Platform supports less than 48 textures per stage … Defaulting to Mobile renderer"): è il comportamento atteso, non un errore.
Con --rendering-driver opengl3 il driver desktop GL 3.3 non è disponibile su V3D e Godot ripiega su OpenGL ES 3.1: per questo servono le texture ETC2 (già abilitate nel preset arm64).
Nessuna aspettativa da 1080p: il target realistico è 960x540 (o 640x360) con --max-fps 30. Da misurare sul campo con --print-fps se compilato in debug.

Avvio consigliato (script fornito: build/linux-arm64/run-arm64.sh):

./run-arm64.sh                      # GL/GLES3, 960x540, 30 fps, classifica attiva
WDB_MODE=vulkan ./run-arm64.sh      # percorso Vulkan (Mobile)
WDB_RES=640x360 ./run-arm64.sh      # se non regge
WDB_API= ./run-arm64.sh             # senza classifica

Insidie verificate

--api= solo dopo --: leaderboard.gd legge OS.get_cmdline_user_args(). Senza separatore il gioco stampa "Classifica disattivata".
curl -C - senza -L su GitHub scarica il corpo del 302 (0 byte) e sembra "riuscito": il download resta fermo per sempre. Serve -L.
Resume fragile: la CDN può restituire 206 anche dopo uno stallo; con --speed-time 30 --speed-limit 20000 si riprende senza perdere i byte già scaricati.
L'addon goldsrc non si carica su host con glibc più vecchia del build (GLIBC_2.43 not found): errore cosmetico in import/export, non incide sul PCK perché addons/* è escluso.
Verifica del PCK: la controprova x86_64 esportata dallo stesso clone si avvia e gira senza risorse mancanti; per l'arm64 l'unica verifica possibile qui è strutturale (file, offset/size del PCK). La prova reale richiede il Pi.

4.5 KiB Raw Permalink Blame History