Skip to content

iPod touch 6 (N102): touchscreen, backlight, buttons - #200

Open
brkosebay wants to merge 12 commits into
OrchardLinux:mainfrom
brkosebay:pr/n102-touch-io
Open

brkosebay wants to merge 12 commits into
OrchardLinux:mainfrom
brkosebay:pr/n102-touch-io

Conversation

@brkosebay

Copy link
Copy Markdown
Contributor

Stacked on #199 (storage), which depends on #196. Review only the last 3 commits.

Commits

  • kernel: the iPod touch 6 touchscreen.
    • input/0030-0031: apple_z2 gets the N102's N1 touchscreen (the C1F58,1 personality, its clocks and firmware entry point), with a core supply that is a regulator instead of a GPIO LDO.
    • devices/t7000/0015: SPI2, the touch clock, the Chestnut and D2186 supplies, and the calibration alias.
  • kernel: the iPod touch 6 backlight.
    • backlight/0007-0008: the DWI backlight switches on the LM3534's outputs over I2C (register 0x10 bit 0), as AppleLMBacklight does.
    • backlight/0006: on the T7000 the DWI starts a transfer with 0x71, without the extra send bit.
    • devices/t7000/0016: the LM3534 on the N102.
  • devices: n102: touch, backlight, buttons and display work. The firmware recipe makes apple/n102-fwstart.z2fw from N102.mtprops in the pinned IPSW. Touch, backlight, buttons and display are set to working. Touch ID and cellular are set to none, because the iPod has neither. The catalog and the matrix are regenerated.

Tested (iPod touch 6)

  • Touch: a diagonal drag from (23,27) to (639,1135) on 640x1136, taps, and one tracking ID per contact. Also used on the installed desktop.
  • Backlight: brightness 1023, 255 and 0 set and read back.
  • Buttons: Home, power, volume up and volume down each give press and release events.
  • Display: console and desktop.
  • Flown as one kernel with the storage, Wi-Fi and battery branches. The storage PR lists how that kernel differs from this head.

Shared code

backlight/0006 changes the DWI transfer on every T7000 board (iPad mini 4, iPhone 6 and 6 Plus). It ran on the iPod touch 6 only. The apple_z2 changes add match data, and other boards keep theirs.

Proposed changelog line: "iPod touch 6 (N102): touchscreen and backlight."

🤖 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
The N102's N1 touchscreen on apple_z2, as AppleMultitouchSPIN102 drives
it: the N1 protocol with its C1F58,1 personality and clock settings, its
core supply from a D2186 regulator instead of a GPIO LDO
(input/0030-0031), and the SPI2 node with the Chestnut and D2186
supplies, the touch clock and the calibration alias
(devices/t7000/0015).

Other apple_z2 boards keep their match data; not retested.

Assisted-by: LLM
The N102's DWI backlight drives an LM3534 whose outputs are switched on
over I2C (register 0x10 bit 0, then 600 us), as AppleLMBacklight does
(backlight/0007-0008, devices/t7000/0016). On the T7000 the DWI starts a
transfer with 0x71 in the channel control register, without the extra
send bit (backlight/0006).

backlight/0006 changes the DWI transfer on every T7000 board (iPad mini
4, iPhone 6 and 6 Plus); it was run on the iPod touch 6 only.

Assisted-by: LLM
The firmware recipe makes the touchscreen's firmware
(apple/n102-fwstart.z2fw) from N102.mtprops in the pinned IPSW, with
the C1F58,1 personality and the unit's calibration.

Touch, backlight, the four buttons and the display were seen working on
the iPod touch 6. It has no Touch ID and no cellular modem: none, not
missing.

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