Skip to content

vphone-linux v0.5

Latest

Choose a tag to compare

@YahiaAngelo YahiaAngelo released this 09 Nov 20:13
· 3 commits to main since this release

The GPU stack moves to upstream's latest reims-vgpu and metal2vulkan, the emulated CPU gets faster again, and setup is more robust on more Linux hosts, thanks largely to contributors.

New GPU stack

reims-vgpu and metal2vulkan are rebased onto upstream development (1,311 reims-vgpu commits since v0.4's base): faster presents, IOSurface texture fixes, shared events across processes. Our vphone patches carry over on the new vphone-next4 branches.

On the iPhone Duo (iOS 27.1), Settings scrolls at 53.8 frames/s instead of 36.9, with less vCPU load, and unlocks about 9 s sooner (161 vs 170 s). On an iOS 26 iPhone 16 guest at 1x with warm caches, every boot of the new stack unlocked in about a minute and scrolled Settings at 51–71 frames/s and paged the home screen at 24–38; two of three boots on v0.4's stack unlocked late (121–155 s) and stalled on the home screen. On a good boot the two are about as fast. Details in docs/PERFORMANCE.md.

  • Home-screen icons (#63): on the first cut of the new stack, about half of iOS 26's app icons drew as dark squares or striped tiles. A bisect of upstream found the cause in metal2vulkan: a pass whose draws are recorded again took the last draw's scissor rectangle for all of them. Fixed in metal2vulkan 82797567b, verified on fresh boots with every icon drawn correctly.

Safari works

Safari and every in-app web view showed no page: WebKit's page process crashed at startup (#62). QEMU masked a process's writes to Apple's SPRR permission register with the kernel's mask instead of the per-process one, so WebKit could never make its JIT memory writable. Found and fixed by @felipeoes (qemu-vphone#5); tested on the iPhone Duo.

Faster emulation (qemu-vphone)

Measured on the iPhone Duo; the rows and switches are in docs/PERFORMANCE.md.

  • Return-address stack (VPHONE_RAS): 98.6% of returns jump straight to their block. QEMU's share of vCPU time under guestbench 44.4% → 35.0%.
  • Indirect-branch cache (VPHONE_IBC), cross-page link refill (VPHONE_XPAGE_REFILL) and DC ZVA in generated code (VPHONE_INLINE_ZVA): together with the fence change below, host cycles −6.8% and host instructions −11% for the same guest work.
  • Release-store fences on x86 (VPHONE_FENCE): one fence per release store, about 20× fewer, and STLR;LDAR no longer reorder (a correctness fix).
  • Invalidated code no longer empties every jump cache (VPHONE_JC_LAZY_INVAL): first Calendar launch while switching apps 22.6–43 s → 12.7–19.6 s.
  • The TLB flush barrier waits only for running vCPUs: at rest its wait fell from 3.6% to 0.95% of QEMU's time.
  • avp-rtc is a running clock (#24), and the generic timer counts at exactly its frequency.

metal2vulkan

  • AIR 2.8 barrier scopes: a simdgroup_barrier no longer waits for the whole threadgroup.
  • Acceleration structures read from argument buffers translate.
  • Three translator fixes ported from Nullmoth's driver (empty inline assembly, phis of constexpr samplers, inline sampler state words).

Setup and restore

  • 7-Zip 26.04 can't read iOS disks ("Cannot open the file as [APFS] archive"), which broke the GPU-driver step on Arch. tools/gpu-driver-from-cloudos.sh now falls back to reading the disk read-only through linux-apfs-rw (tools/apfs-copy-out.sh).
  • Retried restores start from a blank disk, NVRAM and SEP storage (#38, #34); a restore without macOS's /usr/bin/aea keeps the AEA component's manifest digest (#37, #33).
  • USB/IP: the host's SET_CONFIGURATION 0 → 1 cycle is answered locally, so recovery iBoot no longer panics and the SSH ramdisk shows up (#36, #32); fixed unlink framing and host-owned bulk waits (#25); driver resets during discovery are retried (#56).
  • Explicit ECIDs: VPHONE_ECID must match a device exactly (#42), and an opt-in ECID-aware SSH-ramdisk bootstrap (#47).
  • First boot: no limit on the data migration by default, and longer boot and shutdown waits (#17); guest-1x-logo.py waits for the remount instead of 10 s (#39, #35); an optional first-boot QMP socket (#27).
  • Interrupted work is kept, and setup's waits are bounded (#26); incomplete release bundles are recovered (#49).
  • Configurable locations: firmware cache (#45), CFW work directory (#46), CFW mounts bound to the selected VM (#43).
  • Toolchains: private Swiftly binary directories (#44), the release vphone-cli by default (#30), CLI sources chosen independently of releases (#52, #55, #60), Arch's rustup PATH, git worktrees count as checkouts.
  • Catalog labels for iPhone 16 and iPad mini corrected (#40).

Window

  • State-aware Home and Lock buttons (#29); Home falls back to the plain button without a lock state.
  • The host clock is relayed to the guest (#58); VPHONE_CLOCK_SYNC=0 turns it off.
  • Works with Python builds that lack AF_VSOCK (#41); RPC requests are bounded (#57).

Docs and tools

  • How to raise FrontBoard's scene-create watchdog limit for apps that take over 15 s to draw (#51, #50).
  • GFX_PPI needs qemu-vphone#3 (#53); privacy-safe USB restore tracing (#28).

Thanks

@bvolpato, @felipeoes, and everyone who filed issues.

Components

Submodule Commit
qemu (YahiaAngelo/qemu-vphone vphone) 86e6a93
reims-vgpu (YahiaAngelo/reims-vgpu vphone-next4) 310da07
metal2vulkan (YahiaAngelo/metal2vulkan vphone-next4) 8279756

Upgrading: git pull, git submodule update, then ./setup/setup.sh rebuilds QEMU, reims-vgpu and metal2vulkan. reims-vgpu now needs Rust nightly-2026-11-03 (rustup installs it from rust-toolchain.toml). Existing VMs keep working; their shader caches are rebuilt on first use.