Skip to content

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.md
index 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 setup
and Home/AirPlay pairing have not been validated. Existing machines need the
updated 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, rebuilt
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheKDK.swift
index 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.default
let 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 in
available[index][id].map { sources[index] == base || !isKPI($0) } ?? false
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/KernelCache/KernelCacheMixer.swift
index 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 in
base.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.swift
index 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: BuilderLayout
public 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.swift
index 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.md
index 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 against
diff --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.txt
new file mode 100644
index 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.sandbox
diff --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.json
new file mode 100644
index 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 file
diff --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.gz
new file mode 100644
index 00000000..1515d81a
Binary files /dev/null and b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/bases/homepod_26.5_23L471/symbols.json.gz differ
diff --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.json
new file mode 100644
index 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 file
diff --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.gz
new file mode 100644
index 00000000..ffd68348
Binary files /dev/null and b/VPhoneExecutable/VPhoneVirtualization/Resources/kernelcache_recipes/donors/b520_26.5_23L471/symbols.json.gz differ
diff --git a/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swift b/VPhoneKit/VPhoneCoreKit/Firmware/VPhoneFirmwareCatalog.swift
index 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 in
let 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.swift
index 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"])