Skip to content

iPod touch 6 (N102): internal storage on ANS1, installable - #199

Open
brkosebay wants to merge 9 commits into
OrchardLinux:mainfrom
brkosebay:pr/n102-storage
Open

brkosebay wants to merge 9 commits into
OrchardLinux:mainfrom
brkosebay:pr/n102-storage

Conversation

@brkosebay

Copy link
Copy Markdown
Contributor

Depends on #196 (it adds devices/n102). This branch carries #196's commits plus a merge of current main, so review only the last 3 commits.

The iPod touch 6 keeps its flash behind ANS1, like the iPad Air 2, but its ANS firmware (iOS 12.4) speaks RTKit 10.2. There the storage endpoint is 6, not 0x20.

Commits

  • kernel: ANS1 internal storage on the iPod touch 6 (n102)
    • soc-apple/0028: RTKit 10 firmware sends its minor version in the HELLO and wants it back. Taken from Nick Chan's ans1 branch (author kept) and reduced to that handshake, on top of Hoolock's RTKit 10 support.
    • block/0003: asp takes its storage endpoint from the protocol version.
    • devices/t7000/0013: Nick's ANS nodes, unchanged.
    • devices/t7000/0014: enabled on the N102 only.
  • kernel: asp: send the controller only the commands the driver needs (block/0004). ANS1's write unlock opens the whole controller, so the driver refuses every command it doesn't use. That covers writes to the auxiliary namespaces (LLB, firmware, NVRAM, SysCfg) and the format commands.
  • devices: n102: internal storage works; installable. Sets storage_read and storage_write to working, makes n102 installable (tests/test_catalog.py), adds n102's entry to drivers.json and regenerates the matrix.

Tested (iPod touch 6, iOS 12.4 next to it)

Shared code

soc-apple/0028, block/0003 and block/0004 also run on the iPad Air 2 (J81, RTKit 12). Its path is meant to be unchanged. It was not retested.

Notes

  • The catalog doesn't map the ANS1 driver (asp) to a storage feature, so the matrix lists n102's storage as "working, but no driver binds", like J81 today. Adding asp to feature-drivers.toml would fix both boards, but it also changes J81 and J82's rows, so it is left for a separate change.
  • Proposed changelog line: "iPod touch 6 (N102): internal storage, installable next to iOS."

🤖 Generated with Claude Code

The A8's GX6450 runs the same family of firmware as the A9's, so it
becomes a variant of the S8003 chip file rather than a new driver
(drivers/gpu/0063-0073):

- 0063-0064: the S8003 chip described in a variant table, and chip
  hooks for its own GPU ID read and heap table. These touch the A9 and
  A10 paths; their values and functions are unchanged.
- 0065: dt-bindings for apple,t7000-gpu.
- 0066: a GPU node without power domains, and the failing probe step
  named (shared powervr code; nodes with power domains are unchanged).
- 0067-0069: the A8's firmware boot and power up and down in Apple's
  order, compute jobs, and TA/3D render jobs with the parameter-manager
  pool (a8_pm_blocks, a8_pm_grow) and the region-header ring kept in
  the HWRT data set.
- 0070: fault and hang reports and recovery.
- 0071: completion checks in the firmware interrupt's thread, the
  re-check after an early interrupt, a publish that cannot leave a
  failed job in the firmware's ring, Apple's doorbell.
- 0072: a fragment job submitted behind its geometry job, with two
  alternating 3D records (a8_joint, off by default).
- 0073: statistics and the A8's job timeline in debugfs apple_jobs,
  last. It also points the firmware's TA and 3D time words at the
  channel's times; the series without it has not run on the device.

Config: CONFIG_DRM_POWERVR_APPLE goes from unset to =y on apple-4k, as
on apple-16k, so the A8 gets powervr's Apple glue. It builds into the
powervr module on every A7, A8 and A8X kernel; only boards whose device
tree enables an apple,t7000-gpu node bind it.

Assisted-by: LLM
The iPod touch 6 RAM-boots through checkm8, PongoOS and m1n1 to the USB
serial shell. Its descriptor, boot assets and firmware recipe pin the
public iOS 12.5.8 IPSW.

devices/t7000/0011 describes the A8's GPU in t7000.dtsi (the Rogue core,
Fender, the power manager and GPU bridge registers, five interrupts,
the firmware name) and enables it on the N102, where powervr's A8
variant runs Vulkan and OpenGL ES (through Zink) jobs.

Orchard's feature list has no GPU entry and the chip's [gpu] table
records dEQP results, which the A8 does not have yet, so the GPU state
is in devices/n102/README.md. docs/compatibility.md is regenerated.

Assisted-by: LLM
The iPad mini 4 (J96, J97) and the iPhone 6 and 6 Plus (N61, N56) have
the iPod touch 6's A8 GPU. devices/t7000/0012 enables the GPU node in
their shared board files (t7000-mini4.dtsi, t7000-6.dtsi) so people with
these boards can test it; the driver has run only on the iPod touch 6.
Each board's README asks for the probe and ladder results. The A8X
(T7001) has a different GPU and is unchanged.

Assisted-by: LLM
minimal-boot with a constant USB serial number, the kernel's modules,
the GPU firmware and a8-gpu-drm-test, which loads powervr and checks the
probe, Mesa's Vulkan path and two DRM-level replays, each step under a
hardware watchdog with its kernel lines saved. It builds for every A8
board (n102, j96, j97, n61, n56).

tools/extract-fw.py writes the GPU firmware and its border colour table
from Apple's public iPod touch 6 iOS 12.4 IPSW, read over HTTP ranges
with orchard's own IPSW and kernelcache code, or from another IPSW or
kernelcache. Nothing from Apple is in the repository, and everything
build.sh stages is git-ignored.

Assisted-by: LLM
a8-vk-smoke (Vulkan probe, compute, a triangle) and a8-vk-ladder, a set
of Vulkan tests from one clear to vkmark's scenes with every pixel or
value checked on the CPU, both MIT. vk/make-bundle.sh builds them with a
Mesa build of the A8 branch into the self-contained /opt/a8vk bundle
that build.sh's A8_VK_DIR stages, with vkmark when it is installed.

Assisted-by: LLM
The iPod touch 6 keeps its flash behind ANS1 like the iPad Air 2, but
its ANS firmware (iOS 12.4) speaks RTKit 10.2, where the storage
endpoint is 6 instead of 0x20.

- soc-apple/0028: RTKit 10 firmware sends its minor version in the
  HELLO's minimum-version field and wants it back; keep it, answer with
  it and let drivers read the protocol version. RTKit 11 and later are
  unchanged.
- block/0003: asp takes its storage endpoint from the protocol version
  (6 on 10.2, 0x20 on 11 and later); 10.0 is refused by name.
- devices/t7000/0013: the ANS nodes, as Nick Chan wrote them.
- devices/t7000/0014: enabled on the N102 only, ps_ans kept on as the
  boot loader leaves it.

The iPad Air 2 (J81, RTKit 12) runs the same rtkit and asp code; its
path is meant to be unchanged and was not retested.

Assisted-by: LLM
ANS1's write unlock opens the whole controller, so only the driver keeps
writes off the auxiliary namespaces (LLB, firmware, NVRAM, SysCfg with
the factory calibration, ...). Check each command against the ones the
driver uses (identify, the user area's read, write and flush, the write
unlock and the auxiliary reads) before it is queued; anything else,
auxiliary writes and format commands included, is refused.

Shared with the iPad Air 2 (J81), which uses only those commands; not
retested there.

Assisted-by: LLM
With ANS1 on the iPod touch 6, Orchard installs to its user area
(asp0n1) next to a shrunk iOS: storage_read and storage_write are
working. The board now meets every install requirement.

The catalog gets the board's drivers (it had none yet). The ANS1
driver is not one the catalog looks for, so the matrix lists storage as
working with no driver binding, as for the iPad Air 2.

Assisted-by: LLM
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant