Repository navigation
Conversation
Add Nick Chan's ANS1 (asp) block driver from Hoolock, the mailbox match it needs and a small opt-in RTKit hook, as a module in both configs: - CONFIG_APPLE_ASP=m: the iPad Air 2 (J81, A8X) keeps its internal storage behind ANS1; the platform initrd loads it to find the root. apple-16k builds it too, as both configs carry the same options. - RTKit gains an epmap_done callback (only drivers that set it see a change) and decodes armv7 crash logs. Hoolock's RTKit 10.0 support is left out: the J81's ANS speaks RTKit 12.0 and does not need it, and it would change behaviour for other RTKit firmware. Each patch names its Hoolock origin and what changed on the way (hardening from mattonik/ipad-nixos and micro23/ipadair2-omarchy; no read-only default or LBA write window). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFMaVe993UGYsK61nbtYhR
Describe the A8X ANS coprocessor and its mailbox (disabled in t7001.dtsi) and enable them on the iPad Air 2 with the firmware region m1n1 fills in through the asp alias. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFMaVe993UGYsK61nbtYhR
- apple-4k's initrd loads asp instead of nvme: A7-A8X have no NVMe. - The installer takes asp<N>n1, the ANS1 user area, as the internal disk. - udev names asp partitions under /dev/disk/by-partuuid and by-uuid: systemd's 60-persistent-storage.rules skips asp*, so the installer's /boot fstab entry by PARTUUID timed out into emergency mode. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFMaVe993UGYsK61nbtYhR
Seen on an iPad Air 2 Wi-Fi: orchard install wrote Omarchy A next to iPadOS and orchard launch starts it from internal storage, root and /boot read-write, desktop, touch and Wi-Fi working. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFMaVe993UGYsK61nbtYhR
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Internal storage on the iPad Air 2 (J81, A8X). With it,
orchard installputs Omarchy A next to iPadOS, andorchard launchstarts it from the iPad.The A7, A8 and A8X keep their flash behind ANS1, an RTKit coprocessor with its own command protocol (not NVMe). This PR carries Nick Chan's ANS1 driver from HoolockLinux/linux (
ans1, ed8528f), with the hardening from mattonik/ipad-nixos and micro23/ipadair2-omarchy. Of Hoolock's RTKit changes it keeps only what the J81 needs. Each patch names its origin commits and what changed.Changes
drivers/soc-apple0025-0027, newdrivers/block):epmap_donecallback, and decoding of the armv7 crashlog section (CrgA).aspblock driver.CONFIG_APPLE_ASP=min both configs.devices/t70010010-0011): ANS and mailbox nodes int7001.dtsi, disabled there, and enabled ont7001-air2.asp.asp<N>n1(the user area) as the internal disk.asp*partitions/dev/disk/by-partuuidand by-uuid links. systemd's60-persistent-storage.rulesskipsasp*, and without these links the installer's/bootfstab entry by PARTUUID timed out into emergency mode.storage_readandstorage_writeareworking, and J81 is now installable. Includes the regenerated matrix and a CHANGELOG line.Shared code
drivers/soc/appleis used by every Apple coprocessor driver, so the changes there are kept small and opt-in:apple,akf-mailbox-v1, mapped to the existing A7 IOP variant. Nothing else matches it.epmap_done: the ANS only reaches its power-on state once its app endpoint is started, and RTKit allows that only after boot. A driver that setsepmap_donemay start its app endpoints when the endpoint map is complete. Drivers without the callback behave exactly as before.Write safety
kernel/REVIEW.md, safety comes from the test order instead: RAM boot, then read-only, then read-write on the Linux partition, then the installer.Not included
Nick's ANS nodes for s5l8960x (A7) and t7000 (A8) are left out because they are untested on hardware. Owners of those boards can add them with this driver, after checking which RTKit version their ANS firmware speaks.
Testing
orchard installran with earlier revisions of this driver. Those revisions passed a write window on the kernel command line; this PR drops that. The install wrote the GPT, XBOOTLDR and root, and the system booted to its desktop.orchard build --device j81) and its platform layer (python -m orchard.image.platform apple-4k). I installed the layer on that system withboot-entries syncand started it withorchard launch. Theasp.korunning on the device matches the one in the layer (sha256). Rebasing onto currentmainchanged nothing underkernel/,platforms/orsystem/except the m1n1 fix from m1n1: ANS1: free the command queue once on shutdown #185, which the launch already used. Results:RTKit: Initializing (protocol version 12),ASP endpoint is 32,ASP block device 64000000000 bytes, partitions found. No new errors./proc/cmdlinehas noasp.options.asp0n1is ro=0, andasp0n2..asp0n10are ro=1./(asp0n1p3, ext4) and/boot(asp0n1p2) are mounted rw, and a write/fsync/read test passed./dev/disk/by-partuuidhas the partitions.systemctl is-system-runningreportsrunningwith no failed units.python -m unittest discover -s tests: everything passes except 5 tests intest_ramandtest_cascadia_loader, which also fail on unmodifiedmainon this host.kernel/audit-patches.pypasses for apple-4k and apple-16k.tools/catalog/generate matrix --checkpasses.🤖 Generated with Claude Code
https://claude.ai/code/session_01SFMaVe993UGYsK61nbtYhR