Repository navigation
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, andSTLR;LDARno 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_barrierno 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.shnow 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/aeakeeps 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_ECIDmust 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.pywaits 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=0turns 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_PPIneeds 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.