Run a virtual iPhone on an Apple Silicon Mac.
Swift
Mix a HomePod 26.5 kernelcache, and offer HomePod Software 26.5
Maximilian Paß7ee93e14fae4
diff --git a/Research/0_binary_patch_comparison.md b/Research/0_binary_patch_comparison.mdindex ffec639c..479a1936 100644--- a/Research/0_binary_patch_comparison.md+++ b/Research/0_binary_patch_comparison.md@@ -4268,6 +4268,81 @@ This enables transport testing; HomePod onboarding, Apple TV companion setupand Home/AirPlay pairing have not been validated. Existing machines need theupdated Core Bundle and `cfw update-environment` while stopped, then a boot.+## HomePod mini on the research board (2026-10-26)++HomePod Software 26.5 (23L471, AudioAccessory5,1) on cloudOS 26.5 (23F75), which+has no vphone600 components: the 26.5 research board kernel (`26.5_23F77`)+rebuilt with the HomePod's own kexts, as the watch is. `homepod-mini` keeps its+kernel and TXM patches and links this kernelcache. The firmware catalog+pairs HomePod Software 26.5 with this cloudOS, so Launchpad offers it; 27.x+keeps cloudOS 26.4.++### The HomePod kernelcache++`kernel-boot-vresearch101_kext_mix` with the recipe `homepod_26.5_23L471`+(`guest: homePod`; `KernelCacheRecipes.ownRecipeGuests` now names it, so a+HomePod no longer falls back to the iPhone recipe of the same kernel).++| Source | Kexts |+| --- | --- |+| `b520_26.5_23L471`: `kernelcache.release.b520` of the HomePod IPSW, from the guest restore tree | 91: the kexts of the vresearch101 target built with `OSPRODUCT=AppleTVOS` (`b520.mk` includes `sub.AppleTV.mk`; the method reproduces 179 of the 180 shipped b520 bundles, the miss being AppleUSBHostDeviceSupport as on the watch) |+| base: 23F75 `kernelcache.release.vresearch101` | 26: the kernel and its 7 KPI bundles, the virtual platform kexts (ARMGIC, PVPanic, ParavirtGPU, VPIOP, VirtIO, VirtualPlatform, ParavirtIOSurface, VirtIOStorage, the XHCI stack, M68Buttons, CallbackPowerSource, TypeCPhy, usb.cdc), and AMFI, corecrypto and AppleImage4 |+| `vphone600_26.4_23E5207q` | 6: VideoToolboxParavirtualization, AvpFairPlayDriver, driverkit.serial, usb.cdc.acm, usb.serial, VirtIONeuralEngineDevice |++AMFI, corecrypto and AppleImage4 are pinned to the base with the new recipe key+`kextOverrides`: b520 ships them too, but the T8006 kernel has a PPL+(`__PPLTEXT`, `__PPLDATA`) and their HomePod builds call into it; the+VRESEARCH1 kernel is SPTM/TXM (`__DATA_SPTM`) and has none. The seven KPI+symbol sets of the two kernels (xnu-12377.123.3 and .122.4) are identical.++gPTP (2026-10-27): `kextOverrides` also takes `IOTimeSyncFamily` from the base+and `IOgPTPPlugin` from `vphone600_26.4_23E5207q`, the pair of the iPhone 26.5+mix (now 89 kexts from b520, 7 from vphone600). The b520 plugin's+`IOTimeSyncgPTPManager` requires the PMU temperature sensor `PMU tdev1` and+fails to start on a VM, which left `audioclocksyncd` waiting and AirPlay 2's+PTP clock (`CM8021ASClockCreate`) hung. With Apple's VM build the manager+starts and the HomePod plays AirPlay 2 from the Mac. The vphone600 family+does not link against the 26.5 kernel (it imports an `IOPlatformExpert`+private function the base lacks). No instruction patch. See+[HomePod AirPlay](Guest/homepod_airplay.md).++Both maps are research results: the b520 kernelcache symbolicated with BinDiff+against the 23E5207i KDK, and the 26.5 recipe map with additions. The fixes+(`HomePod/mix` in the research workspace, rebuilt by its `pipeline.sh`):++- Kernel imports of the HomePod kexts, through the kernel alignment: 54 fixed,+ 15 kept after disassembly. One-instruction stubs (`mov w0,#k; ret`) lie+ 8 bytes apart in both kernels, so names drift there and identical-code folding+ gives one stub many names: a `_kc.` placeholder binds to a byte-identical+ base stub; a real name stays a name bind (checked against Apple's names in+ macOS 25F80: `_t6000dart_vo_tte` and `_pmap_has_iofilter_protected_write`+ sit on the wrong base stub, the config-specific `_ml_page_protection_type`,+ `_secure_channel_shared_page` and `_ecc_log_memory_error_ce` stay the base's).+ The base map has `_ml_set_reset_time` inside `_ml_get_conttime_offset`, as+ 23E244 had; the import binds to the `ret` the base PMGR calls.+- Family names the base VM kexts import from b520 builds: PAC-diversity vtable+ slots (`IOMobileFramebufferLegacy` slot 344 and+ `IOGPUEventMachine::incrementStampNoRelease`, as on the watch;+ `IOUSBHostPipe` slot 32), `kext_xfer_names`, and eleven IOSurface getters+ whose b520 labels sat 0x14 (two 0x2c) before their entry, on the previous+ function's `retab`, which fails PAC on return.+- Class data labels of both maps from `ipsw kernel cpp`; none of the 40 the+ donor kexts import moves.++Checked on 2026-10-26: bindcheck reports no unresolved bind for the HomePod,+base VM and donor kexts; the entry checks find no bind after a prologue (110+family, 1052 kernel, 2 donor family binds); `vphone-cli`'s native staging of+the recipe is byte-identical to the research mix (the kernel and all 119 kext+executables). Relinking the HomePod's own extraction reproduces the shipped+b520 kernelcache: the same size, and apart from the prelink `InfoPlistDigest`+entries only two words of the shared `__LINKEDIT` differ, as on the watch.++Checked on 2026-10-26 and 2026-10-27: `homepod-std` (Launchpad `vm create` with+the HomePod 26.5 IPSW, cloudOS 26.5 23F75 and `--preset homepod-mini`; `fw+kernelcache` staged as the user and linked as root) restores, boots, takes+`cfw install` and answers vphoned as `AudioAccessory5,1`, iOS 26.5. Its plan+holds `kernel-boot-vresearch101_kext_mix` beside `homepod-mini`'s kernel patches.+## iOS 18 guests on the research board (2026-10-21)iOS 18.1 to 18.7.2 run on their own release's research board kernel, rebuiltdiff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swiftindex 79161fc5..f875e10c 100644--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swift+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swift@@ -63,13 +63,19 @@ enum KernelCacheKDK {}/// Copy `base` to `output` and keep the bundles listed in `wanted`, each from- /// the first of `sources` (which includes `base`) that has it; the kernel's- /// KPI bundles (System.kext) always stay the base's. Nested bundles keep- /// their parents' directories. Returns the base bundles dropped and the- /// bundles added from each other source.- static func mix(base: URL, sources: [URL], wanted: [String], output: URL) throws -> (removed: [String], added: [URL: [String]]) {+ /// the first of `sources` (which includes `base`) that has it, or from the+ /// source `pinned` names for it; the kernel's KPI bundles (System.kext)+ /// always stay the base's. Nested bundles keep their parents' directories.+ /// Returns the base bundles dropped and the bundles added from each other+ /// source.+ static func mix(+ base: URL, sources: [URL], wanted: [String], output: URL, pinned: [String: Int] = [:],+ ) throws -> (removed: [String], added: [URL: [String]]) {let fm = FileManager.defaultlet wantedSet = Set(wanted)+ if let stray = pinned.keys.sorted().first(where: { !wantedSet.contains($0) }) {+ throw PatcherError.invalidFormat("\(stray) is pinned but not among the wanted bundles")+ }if fm.fileExists(atPath: output.path) { try fm.removeItem(at: output) }try fm.createDirectory(at: output.deletingLastPathComponent(), withIntermediateDirectories: true)try fm.copyItem(at: base, to: output)@@ -84,6 +90,11 @@ enum KernelCacheKDK {for id in wantedSet {if let relative = have[id], isKPI(relative) {owner[id] = sources.firstIndex(of: base)+ } else if let index = pinned[id] {+ guard available.indices.contains(index), available[index][id] != nil else {+ throw PatcherError.fileNotFound("\(id) is pinned to a source that does not have it")+ }+ owner[id] = index} else {owner[id] = available.indices.first { index inavailable[index][id].map { sources[index] == base || !isKPI($0) } ?? falsediff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swiftindex 20e933e6..2289c509 100644--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swift+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swift@@ -198,7 +198,10 @@ public final class KernelCacheMixer {let sources = base.kextSources.map { source inbase.donors.firstIndex(of: source).map { donorKDKs[$0] } ?? baseKDK}- let (removed, added) = try KernelCacheKDK.mix(base: baseKDK, sources: sources, wanted: identifiers, output: mixKDK)+ let pinned = try base.pinnedSources()+ let (removed, added) = try KernelCacheKDK.mix(+ base: baseKDK, sources: sources, wanted: identifiers, output: mixKDK, pinned: pinned,+ )let addedText = zip(donors, donorKDKs).map { "\(added[$1]?.count ?? 0) from \($0.id)" }.joined(separator: ", ")log(" [kc] mix: \(identifiers.count) kexts, \(removed.count) research board kexts removed, \(addedText)")try KernelCacheKDK.makeVolume(kdk: mixKDK, identifiers: identifiers, output: paths.staged.appending(path: "volume"))@@ -537,6 +540,9 @@ public final class KernelCacheMixer {if base.sources != nil {material += Data("|\(base.kextSources.joined(separator: ","))".utf8)}+ if let overrides = base.kextOverrides {+ material += Data("|\(overrides.sorted { $0.key < $1.key }.map { "\($0.key)=\($0.value)" }.joined(separator: ","))".utf8)+ }return String(KernelCacheRecipes.sha256(material).prefix(16))}diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheRecipes.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheRecipes.swiftindex bffbaa5a..a48b6a13 100644--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheRecipes.swift+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheRecipes.swift@@ -51,13 +51,20 @@ public struct KernelCacheBase: Decodable, Sendable {/// taken from the first that has it; the kernel and its KPI bundles/// (System.kext) always from the base. Default: the base, then `donor`.let sources: [String]?+ /// Kexts taken from a named source although an earlier one has them too:+ /// bundle identifier to `base` or a donor id among `sources`. A HomePod+ /// mix takes AMFI, corecrypto and AppleImage4 from the base, which they+ /// fit: the guest's own builds call into the PPL of its kernel. It also+ /// takes IOTimeSyncFamily from the base and IOgPTPPlugin from the VM+ /// build, whose gPTP manager needs no PMU temperature sensor.+ let kextOverrides: [String: String]?let donor: String?public let builderLayout: BuilderLayoutpublic internal(set) var directory = URL(fileURLWithPath: "/")enum CodingKeys: String, CodingKey {- case id, productVersion, kernel, symbols, kexts, guest, sources, donor, builderLayout+ case id, productVersion, kernel, symbols, kexts, guest, sources, kextOverrides, donor, builderLayout}static let baseSource = "base"@@ -67,6 +74,16 @@ public struct KernelCacheBase: Decodable, Sendable {sources ?? [Self.baseSource] + (donor.map { [$0] } ?? [])}+ /// `kextOverrides` as indices into `kextSources`.+ func pinnedSources() throws -> [String: Int] {+ try (kextOverrides ?? [:]).mapValues { source in+ guard let index = kextSources.firstIndex(of: source) else {+ throw PatcherError.invalidFormat("\(id): kextOverrides names \(source), which is not among its sources")+ }+ return index+ }+ }+/// The donor ids among `kextSources`.public var donors: [String] {kextSources.filter { $0 != Self.baseSource }@@ -159,8 +176,8 @@ public struct KernelCacheRecipes: Sendable {}/// Guest families that need a recipe of their own; the others share the- /// iPhone's.- static let ownRecipeGuests: Set<String> = ["watch"]+ /// iPhone's. A watch and a HomePod link their own kexts.+ static let ownRecipeGuests: Set<String> = ["watch", "homePod"]private func manifests(in subdirectory: String) throws -> [URL] {let directory = root.appending(path: subdirectory)diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/Core/KernelCacheMixerTests.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/Core/KernelCacheMixerTests.swiftindex dbf3deed..9f196ebe 100644--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/Core/KernelCacheMixerTests.swift+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/Core/KernelCacheMixerTests.swift@@ -101,7 +101,7 @@ struct KernelCacheMixerTests {let bases = try Self.recipes.bases()#expect(bases.map(\.id) == ["18.1_22B83", "18.2.1_22C161", "18.3.1_22D72", "18.5_22F76", "18.6_22G86", "18.7.2_22H124", "18.7_22H20",- "26.4_23E246", "26.5_23F77", "26.6_23G71", "26.7_23H20", "watch_26.4_23T240",+ "26.4_23E246", "26.5_23F77", "26.6_23G71", "26.7_23H20", "homepod_26.5_23L471", "watch_26.4_23T240",])for base in bases {#expect(FileManager.default.fileExists(atPath: base.symbolsURL.path), "\(base.id)")@@ -127,6 +127,24 @@ struct KernelCacheMixerTests {#expect(try Self.recipes.donor(id: "watch7c_26.4_23T240").cloudOSSource == nil)}+ @Test("A HomePod links its own kexts against the 26.5 research kernel, with the security-monitor kexts of the base and the virtual machine's gPTP")+ func homePodRecipe() throws {+ let homePod = try #require(try Self.recipes.bases().first { $0.guest == "homePod" })+ let shared = try Self.recipes.bases().filter { $0.kernel.matches(sha: homePod.kernel.sha256) }+ #expect(Set(shared.map(\.id)) == ["26.5_23F77", "homepod_26.5_23L471"])+ #expect(homePod.kextSources == ["b520_26.5_23L471", "base", "vphone600_26.4_23E5207q"])+ #expect(try homePod.pinnedSources() == [+ "com.apple.driver.AppleMobileFileIntegrity": 1, "com.apple.kec.corecrypto": 1, "com.apple.security.AppleImage4": 1,+ "com.apple.iokit.IOTimeSyncFamily": 1, "com.apple.plugin.IOgPTPPlugin": 2,+ ])+ #expect(try Self.recipes.donor(id: "b520_26.5_23L471").cloudOSSource == nil)+ #expect(try Self.recipes.donor(id: "b520_26.5_23L471").kernel.file == "kernelcache.release.b520")+ for base in try Self.recipes.bases() {+ // A pin outside the bundle list would be ignored, so mix refuses it.+ #expect(try Set(base.pinnedSources().keys).isSubset(of: base.kextIdentifiers()), "\(base.id)")+ }+ }+@Test("iOS 18 bases link kernel-first against the kexts of the cloudOS 26.1 vphone600 kernelcache")func iOS18Recipes() throws {let bases = try Self.recipes.bases().filter { $0.productVersion.hasPrefix("18.") }@@ -287,6 +305,26 @@ struct KernelCacheMixerTests {try KernelCacheKDK.mix(base: base, sources: [first, base], wanted: ["com.apple.kpi.bsd"], output: ordered)}+ // A pinned kext comes from its source although an earlier one has it.+ let pinned = root.appending(path: "pinned/KDK_26.6_23G71.kdk")+ let (_, addedPinned) = try KernelCacheKDK.mix(+ base: base, sources: [first, base, donor], wanted: ["com.apple.kept"], output: pinned, pinned: ["com.apple.kept": 1],+ )+ #expect(addedPinned[first] == nil)+ let keptPinned = pinned.appending(path: "System/Library/Extensions/Kept.kext/Kept")+ #expect(try String(contentsOf: keptPinned, encoding: .utf8) == "com.apple.kept")+ #expect(throws: PatcherError.self) {+ try KernelCacheKDK.mix(+ base: base, sources: [first, base, donor], wanted: ["com.apple.research.only"], output: pinned,+ pinned: ["com.apple.research.only": 0],+ )+ }+ #expect(throws: PatcherError.self) {+ try KernelCacheKDK.mix(+ base: base, sources: [first, base, donor], wanted: ["com.apple.kept"], output: pinned, pinned: ["com.apple.unknown": 1],+ )+ }+// The staged volume root links holds no link but the KDK's own.try KernelCacheVolumeCopy.checkLinks(in: volume, kdk: "KDK_26.6_23G71.kdk")try FileManager.default.createSymbolicLink(diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/README.md b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/README.mdindex aefd355a..31e28e73 100644--- a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/README.md+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/README.md@@ -27,6 +27,8 @@ Base `manifest.json`:| `kernel.kdk` | the KDK its extraction makes; a kernelcache whose kexts carry no `DTPlatformBuild` (26.6, 26.7) takes the build from here || `donor` | `donors/<id>`, which supplies the virtualisation kexts || `builderLayout` | `kernel-last` (iOS 26.4+, kmutil of macOS 26.4+) or `kernel-first` |+| `guest`, `sources` | the guest family of a recipe of its own (`watch`, `homePod`), and its kext sources in order: each kext from the first that has it |+| `kextOverrides` | bundle identifier to the source it is taken from although an earlier one has it (`homepod_26.5_23L471`: AMFI, corecrypto, AppleImage4 and IOTimeSyncFamily from the base, IOgPTPPlugin from `vphone600_26.4_23E5207q`) |The bundle list is the base's kexts without the research-board-only ones(CIOMesh, MLX5, Thunderbolt, RDMA, ...), plus the donor kexts that link againstdiff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/kexts.txt b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/kexts.txtnew file mode 100644index 00000000..582447c5--- /dev/null+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/kexts.txt@@ -0,0 +1,123 @@+com.apple.AppleFSCompression.AppleFSCompressionTypeZlib+com.apple.IOTextEncryptionFamily+com.apple.driver.AppleA7IOP+com.apple.driver.AppleARMGIC+com.apple.driver.AppleARMPMU+com.apple.driver.AppleARMPlatform+com.apple.driver.AppleARMWatchdogTimer+com.apple.driver.AppleAudioClockLibs+com.apple.driver.AppleBSDKextStarter+com.apple.driver.AppleBSDKextStarterTMPFS+com.apple.driver.AppleCallbackPowerSource+com.apple.driver.AppleDiagnosticDataAccessReadOnly+com.apple.driver.AppleDiskImages2+com.apple.driver.AppleEffaceableStorage+com.apple.driver.AppleEmbeddedPCIE+com.apple.driver.AppleEmbeddedTempSensor+com.apple.driver.AppleEmbeddedUSB+com.apple.driver.AppleEmbeddedUSBHost+com.apple.driver.AppleIISController+com.apple.driver.AppleM2ScalerCSCDriver+com.apple.driver.AppleM68Buttons+com.apple.driver.AppleMobileApNonce+com.apple.driver.AppleMobileFileIntegrity+com.apple.driver.AppleNANDConfigAccess+com.apple.driver.AppleOnboardSerial+com.apple.driver.ApplePIODMA+com.apple.driver.ApplePMGR+com.apple.driver.ApplePVPanic+com.apple.driver.AppleParavirtGPUIOGPUFamily+com.apple.driver.AppleS8000AES+com.apple.driver.AppleSEPCredentialManager+com.apple.driver.AppleSEPKeyStore+com.apple.driver.AppleSEPManager+com.apple.driver.AppleSMC+com.apple.driver.AppleSamsungSerial+com.apple.driver.AppleSerialShim+com.apple.driver.AppleTypeCPhy+com.apple.driver.AppleUSBDeviceMux+com.apple.driver.AppleUSBDeviceNCM+com.apple.driver.AppleUSBHostMergeProperties+com.apple.driver.AppleVPIOP+com.apple.driver.AppleVideoToolboxParavirtualization+com.apple.driver.AppleVirtIO+com.apple.driver.AppleVirtualPlatform+com.apple.driver.AvpFairPlayDriver+com.apple.driver.DiskImages+com.apple.driver.DiskImages.FileBackingStore+com.apple.driver.DiskImages.KernelBacked+com.apple.driver.DiskImages.RAMBackingStore+com.apple.driver.DiskImages.ReadWriteDiskImage+com.apple.driver.DiskImages.UDIFDiskImage+com.apple.driver.FairPlayIOKit+com.apple.driver.IODARTFamily+com.apple.driver.IOSlaveProcessor+com.apple.driver.RTBuddy+com.apple.driver.corecapture+com.apple.driver.driverkit.serial+com.apple.driver.mDNSOffloadUserClient-Embedded+com.apple.driver.usb.AppleEmbeddedUSBXHCIPCI+com.apple.driver.usb.AppleSynopsysUSBXHCI+com.apple.driver.usb.AppleUSBCommon+com.apple.driver.usb.AppleUSBHostCompositeDevice+com.apple.driver.usb.AppleUSBHostDeviceSupport+com.apple.driver.usb.AppleUSBHostPacketFilter+com.apple.driver.usb.AppleUSBHostPlatformProperties+com.apple.driver.usb.AppleUSBHostiOSDevice+com.apple.driver.usb.AppleUSBHub+com.apple.driver.usb.AppleUSBXHCI+com.apple.driver.usb.AppleUSBXHCIPCI+com.apple.driver.usb.cdc+com.apple.driver.usb.cdc.acm+com.apple.driver.usb.networking+com.apple.driver.usb.serial+com.apple.filesystems.apfs+com.apple.filesystems.hfs.kext+com.apple.filesystems.tmpfs+com.apple.iokit.AppleParavirtIOSurface+com.apple.iokit.AppleVirtIONeuralEngineDevice+com.apple.iokit.AppleVirtIOStorage+com.apple.iokit.CoreAnalyticsFamily+com.apple.iokit.IO80211Family+com.apple.iokit.IOAVFamily+com.apple.iokit.IOAccessoryManager+com.apple.iokit.IOAccessoryPortUSB+com.apple.iokit.IOAudio2Family+com.apple.iokit.IOCECFamily+com.apple.iokit.IOCryptoAcceleratorFamily+com.apple.iokit.IOGPUFamily+com.apple.iokit.IOHDCPFamily+com.apple.iokit.IOHIDEventDriver+com.apple.iokit.IOHIDEventDriverSafeBoot+com.apple.iokit.IOHIDFamily+com.apple.iokit.IOMobileGraphicsFamily+com.apple.iokit.IONetworkFamily+com.apple.iokit.IONetworkingFamily+com.apple.iokit.IOPCIFamily+com.apple.iokit.IOPortFamily+com.apple.iokit.IOReportFamily+com.apple.iokit.IOSerialFamily+com.apple.iokit.IOSkywalkFamily+com.apple.iokit.IOSlowAdaptiveClockingFamily+com.apple.iokit.IOStorageFamily+com.apple.iokit.IOStreamFamily+com.apple.iokit.IOSurface+com.apple.iokit.IOTimeSyncFamily+com.apple.iokit.IOUSBDeviceFamily+com.apple.iokit.IOUSBHostFamily+com.apple.kec.Compression+com.apple.kec.Libm+com.apple.kec.corecrypto+com.apple.kec.pthread+com.apple.kext.AppleMatch+com.apple.kext.CoreTrust+com.apple.kpi.bsd+com.apple.kpi.dsep+com.apple.kpi.iokit+com.apple.kpi.libkern+com.apple.kpi.mach+com.apple.kpi.private+com.apple.kpi.unsupported+com.apple.plugin.IOgPTPPlugin+com.apple.security.AppleImage4+com.apple.security.sandboxdiff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/manifest.json b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/manifest.jsonnew file mode 100644index 00000000..2869ec52--- /dev/null+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/manifest.json@@ -0,0 +1,26 @@+{+ "builderLayout": "kernel-last",+ "guest": "homePod",+ "id": "homepod_26.5_23L471",+ "kernel": {+ "decompressedSHA256": "622ce55b4363ac9723124f9c627af30d893707820c9ad094589a66ec5fc66dad",+ "file": "kernelcache.release.vresearch101",+ "kdk": "KDK_26.5_23F68.kdk",+ "sha256": "7f656f3cd194b3564dd374161ba10b9af94a20ad41c289f96f1af79b9a1e91ac"+ },+ "kextOverrides": {+ "com.apple.driver.AppleMobileFileIntegrity": "base",+ "com.apple.iokit.IOTimeSyncFamily": "base",+ "com.apple.kec.corecrypto": "base",+ "com.apple.plugin.IOgPTPPlugin": "vphone600_26.4_23E5207q",+ "com.apple.security.AppleImage4": "base"+ },+ "kexts": "kexts.txt",+ "productVersion": "26.5",+ "sources": [+ "b520_26.5_23L471",+ "base",+ "vphone600_26.4_23E5207q"+ ],+ "symbols": "symbols.json.gz"+}\ No newline at end of filediff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/symbols.json.gz b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/symbols.json.gznew file mode 100644index 00000000..1515d81aBinary files /dev/null and b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/symbols.json.gz differdiff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/manifest.json b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/manifest.jsonnew file mode 100644index 00000000..3e68d358--- /dev/null+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/manifest.json@@ -0,0 +1,11 @@+{+ "description": "HomePod mini kernelcache of the AudioAccessory5,1 26.5 (23L471) IPSW: the HomePod kexts, read from the guest restore tree",+ "id": "b520_26.5_23L471",+ "kernel": {+ "decompressedSHA256": "968ffd0ac71ea1f2cf349704b887f6e31a9c9106a81e9964bee9328323a3b23f",+ "file": "kernelcache.release.b520",+ "kdk": "KDK_26.5_23L468.kdk",+ "sha256": "7b1e31f91800798beb39870e8e1f8b124aa9836356a9d4c8a0219eaff0324bec"+ },+ "symbols": "symbols.json.gz"+}\ No newline at end of filediff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/symbols.json.gz b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/symbols.json.gznew file mode 100644index 00000000..ffd68348Binary files /dev/null and b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/symbols.json.gz differdiff --git a/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swift b/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swiftindex 911e5ebc..889e4531 100644--- a/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swift+++ b/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swift@@ -516,10 +516,14 @@ public enum VPhoneFirmwareCatalog {]),]- /// HomePod mini's native IPSW. The boot chain still comes from cloudOS;- /// this is a research pairing, not a claim about Siri or Home pairing.+ /// HomePod mini's native IPSWs. The boot chain still comes from cloudOS:+ /// the research board's for 26.5, whose kernelcache recipe+ /// (`homepod_26.5_23L471`) rebuilds that kernel with the HomePod's kexts,+ /// and cloudOS 26.4 for 27. These are research pairings, not a claim about+ /// Siri or Home pairing.static let homePodReleases: [(devices: [String], releases: [(version: String, url: String)])] = [(devices: ["AudioAccessory5,1"], releases: [+ ("26.5", "https://updates.cdn-apple.com/2026SpringFCS/fullrestores/122-40034/C2B2422A-6010-46B6-AF80-6D766EABA8D2/AudioAccessory5,1_26.5_23L471_Restore.ipsw"),("27.0", "https://updates.cdn-apple.com/2026SFallFCS/a595a3b2-2c42-470a-9417-a705aaafa05c/AudioAccessory5,1_27.0_24J361_Restore.ipsw"),]),]@@ -630,7 +634,8 @@ public enum VPhoneFirmwareCatalog {/// or another model's releases with the cloudOS an iPhone17,3 of that/// release uses. A cellular iPad gets its Wi-Fi model's; an Apple TV gets/// cloudOS 26.4, the only kernel its TPRO compatibility patch covers; a- /// watch gets the research board cloudOS its kernelcache recipe covers; a+ /// watch, and a HomePod of a release with one, gets the research board+ /// cloudOS its kernelcache recipe covers, a HomePod otherwise cloudOS 26.4; a/// device without an IPSW gets one per OTA for it, named for the OTA: the/// base's IPSW when the OTA is of the same version, else the OTA itself,/// which `fw prepare` restores over its base's IPSW; an unknown device@@ -667,7 +672,8 @@ public enum VPhoneFirmwareCatalog {}return releases.map { release inlet cloudOS = switch guest.family {- case .appleTV, .homePod: VPhoneCloudOSOption(name: "cloudOS 26.4", url: cloud264)+ case .appleTV: VPhoneCloudOSOption(name: "cloudOS 26.4", url: cloud264)+ case .homePod: researchBoardCloudOS(forVersion: release.version) ?? VPhoneCloudOSOption(name: "cloudOS 26.4", url: cloud264)case .watch: researchBoardCloudOS(forVersion: release.version) ?? recommendedCloudOS(forVersion: release.version)case .iPhone, .iPad: recommendedCloudOS(forVersion: release.version)}diff --git a/VPhoneKit/VPhoneCoreKitTests/Firmware/FirmwareCatalogReportTests.swift b/VPhoneKit/VPhoneCoreKitTests/Firmware/FirmwareCatalogReportTests.swiftindex b7bf324a..1e13df97 100644--- a/VPhoneKit/VPhoneCoreKitTests/Firmware/FirmwareCatalogReportTests.swift+++ b/VPhoneKit/VPhoneCoreKitTests/Firmware/FirmwareCatalogReportTests.swift@@ -134,8 +134,8 @@ struct FirmwareCatalogReportTests {@Test func `HomePod mini pairs its native 27 IPSW with cloudOS without an OTA base`() throws {let pairings = VPhoneFirmwareCatalog.pairings(for: "AudioAccessory5,1", hostMacOS: 27)- #expect(pairings.count == 2)- let pairing = try #require(pairings.first)+ #expect(pairings.map(\.iosName) == ["HomePod Software 26.5", "HomePod Software 27.0", "HomePod Software 27.2"])+ let pairing = pairings[1]#expect(pairing.device == "AudioAccessory5,1")#expect(pairing.iosName == "HomePod Software 27.0")#expect(pairing.iosURL == "https://updates.cdn-apple.com/2026SFallFCS/a595a3b2-2c42-470a-9417-a705aaafa05c/AudioAccessory5,1_27.0_24J361_Restore.ipsw")@@ -148,24 +148,36 @@ struct FirmwareCatalogReportTests {let device = try #require(VPhoneFirmwareCatalog.report.devices.first { $0.productType == "AudioAccessory5,1" })#expect(device.family == "homePod" && device.name == "HomePod mini")- let entry = try #require(device.pairings.first)+ let entry = device.pairings[1]#expect(entry.ios.name == pairing.iosName && entry.ios.url == pairing.iosURL)#expect(entry.ios.build == nil && entry.ios.files == nil)#expect(entry.recommendedCloudOS.url == VPhoneFirmwareCatalog.cloud264)}+ @Test func `HomePod mini 26 point 5 pairs with the research board cloudOS its kernelcache recipe covers`() throws {+ let pairing = try #require(VPhoneFirmwareCatalog.pairings(for: "AudioAccessory5,1").first)+ #expect(pairing.iosName == "HomePod Software 26.5")+ #expect(pairing.iosURL.hasSuffix("/AudioAccessory5,1_26.5_23L471_Restore.ipsw"))+ #expect(pairing.cloudosName == "cloudOS 26.5 (23F75)")+ #expect(pairing.cloudosURL == VPhoneFirmwareCatalog.researchBoardCloudOS(forVersion: "26.5")?.url)+ #expect(VPhoneFirmwareCatalog.otaRelease(source: pairing.iosURL) == nil)+ }+@Test func `HomePod 27 point 2 takes its full ZIP OTA over its own 27 IPSW`() throws {let release = try #require(VPhoneFirmwareCatalog.otaRelease(for: "AudioAccessory5,1", build: "24K120"))#expect(release.version == "27.2" && release.baseVersion == "27.0")#expect(release.key == nil && release.size == 3_051_441_612)#expect(release.fileName == "AudioAccessory5,1_27.2_24K120_OTA.zip")let pairings = VPhoneFirmwareCatalog.pairings(for: release.productType, hostMacOS: 27)- #expect(VPhoneFirmwareCatalog.restoreBaseURL(for: release) == pairings[0].iosURL)- #expect(pairings[1].iosURL == release.url)+ let base = try #require(pairings.first { $0.iosName == "HomePod Software 27.0" })+ let ota = try #require(pairings.first { $0.iosName == "HomePod Software 27.2" })+ #expect(VPhoneFirmwareCatalog.restoreBaseURL(for: release) == base.iosURL)+ #expect(ota.iosURL == release.url && ota.cloudosURL == VPhoneFirmwareCatalog.cloud264)#expect(VPhoneFirmwareCatalog.otaRelease(source: "/cache/ota/\(release.fileName)") == release)let device = try #require(VPhoneFirmwareCatalog.report(hostMacOS: 27).devices.first { $0.productType == release.productType })- #expect(device.pairings[1].ios.build == "24K120")- #expect(device.pairings[1].ios.files == ["ota/\(release.fileName)", (pairings[0].iosURL as NSString).lastPathComponent])+ let entry = try #require(device.pairings.first { $0.ios.url == release.url })+ #expect(entry.ios.build == "24K120")+ #expect(entry.ios.files == ["ota/\(release.fileName)", (base.iosURL as NSString).lastPathComponent])}@Test func `a Mac before macOS 27 is offered no OTA it cannot unpack`() throws {@@ -181,7 +193,7 @@ struct FirmwareCatalogReportTests {#expect(!release.unpacks(onMacOS: 26) && release.unpacks(onMacOS: 27))}#expect(VPhoneFirmwareCatalog.pairings(for: "AppleTV14,1", hostMacOS: 26).map(\.iosName) == ["tvOS 26.6"])- #expect(VPhoneFirmwareCatalog.pairings(for: "AudioAccessory5,1", hostMacOS: 26).map(\.iosName) == ["HomePod Software 27.0"])+ #expect(VPhoneFirmwareCatalog.pairings(for: "AudioAccessory5,1", hostMacOS: 26).map(\.iosName) == ["HomePod Software 26.5", "HomePod Software 27.0"])let report = VPhoneFirmwareCatalog.report(hostMacOS: 26)let tv4K = try #require(report.devices.first { $0.productType == "AppleTV14,1" })#expect(tv4K.pairings.map(\.ios.name) == ["tvOS 26.6"])