Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
18ee937
kernel: the A8 (T7000) GPU in powervr's Apple glue
brkosebay Nov 21, 2026
a63562a
devices: add the iPod touch 6 (N102) with its GPU
brkosebay Nov 21, 2026
da883a7
devices: t7000: enable the GPU on the iPad mini 4 and iPhone 6 boards
brkosebay Nov 21, 2026
5ac665f
examples: ipod-gpu-drm, a test payload for the A8 GPU
brkosebay Nov 21, 2026
8cebec9
examples: ipod-gpu-drm: the Vulkan smoke test and ladder
brkosebay Nov 21, 2026
8988872
Merge branch 'main' into a8-gpu
brkosebay Nov 21, 2026
c54a2b2
kernel: ANS1 internal storage on the iPod touch 6 (n102)
brkosebay Nov 21, 2026
8862c99
kernel: asp: send the controller only the commands the driver needs
brkosebay Nov 21, 2026
16df167
devices: n102: internal storage works; installable
brkosebay Nov 21, 2026
ce196a1
kernel: the iPod touch 6 touchscreen
brkosebay Nov 21, 2026
1ef1adc
kernel: the iPod touch 6 backlight
brkosebay Nov 21, 2026
f647fd8
devices: n102: touch, backlight, buttons and display work
brkosebay Nov 21, 2026
6ddf643
kernel: D2186 PMIC GPIOs on the A8
brkosebay Nov 21, 2026
e08fc3b
kernel: Wi-Fi and Bluetooth on the iPod touch 6
brkosebay Nov 21, 2026
2b3c0d8
kernel: brcmfmac: start the BCM4345 rev 5 firmware
brkosebay Nov 21, 2026
fc95bad
devices: n102: Wi-Fi works; Bluetooth comes up
brkosebay Nov 21, 2026
082fa91
kernel: battery status on the iPod touch 6 from the D2186
brkosebay Nov 21, 2026
ee07846
kernel: apple_d2186_battery: estimate the charge as iOS does
brkosebay Nov 21, 2026
d1dba15
devices: n102: battery status works
brkosebay Nov 21, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions devices/j96/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# iPad mini 4 (Wi-Fi), J96

Hardware identity, boot assets and the firmware recipe are in
[`device.toml`](device.toml). This file tracks what still needs testing,
open work, and contributed code that is not in the tree yet.

## Needs testing

**GPU (A8, PowerVR GX6450).** The board has the iPod touch 6's A8 GPU, and
its device tree enables it (`kernel/patches/devices/t7000/0012`). The
driver has only run on the iPod touch 6 (N102) so far. Test with
[`examples/ipod-gpu-drm`](../../examples/ipod-gpu-drm/README.md)
(`--device j96`) and report the output of `a8-gpu-drm-test probe` with
its kernel lines, and the ladder's `RESULT` lines.

## Unmerged code

None.
18 changes: 18 additions & 0 deletions devices/j97/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# iPad mini 4 (Cellular), J97

Hardware identity, boot assets and the firmware recipe are in
[`device.toml`](device.toml). This file tracks what still needs testing,
open work, and contributed code that is not in the tree yet.

## Needs testing

**GPU (A8, PowerVR GX6450).** The board has the iPod touch 6's A8 GPU, and
its device tree enables it (`kernel/patches/devices/t7000/0012`). The
driver has only run on the iPod touch 6 (N102) so far. Test with
[`examples/ipod-gpu-drm`](../../examples/ipod-gpu-drm/README.md)
(`--device j97`) and report the output of `a8-gpu-drm-test probe` with
its kernel lines, and the ladder's `RESULT` lines.

## Unmerged code

None.
44 changes: 44 additions & 0 deletions devices/n102/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# iPod touch 6, N102

Hardware identity, boot assets and the firmware recipe are in
[`device.toml`](device.toml). This file tracks what still needs testing,
open work, and contributed code that is not in the tree yet.

## Needs testing

**GPU (A8, PowerVR GX6450).** powervr's A8 variant
(`kernel/patches/drivers/gpu/0063`–`0073`, `devices/t7000/0011`) probes,
boots the GPU firmware and runs compute and render jobs on this board:
Vulkan 1.2 through Mesa's powervr driver and OpenGL ES 3.1 through Zink,
no faults over a 514k-job soak. Experimental: dEQP has not run, so the
chip has no `[gpu]` entry yet. Test with
[`examples/ipod-gpu-drm`](../../examples/ipod-gpu-drm/README.md).

## Internal storage

The flash sits behind ANS1, as on the iPad Air 2, with iOS 12.4's ANS
firmware (RTKit 10.2). `asp` shows the user area as `asp0n1` and the nine
auxiliary namespaces (LLB, firmware, NVRAM, SysCfg, ...) read-only. The
write unlock opens the whole controller, so the driver refuses every
command it does not need: only the user area is written.

To keep iOS, shrink its APFS container first (resize-apfs) and install
Orchard into the free space of `asp0n1`. A DFU restore brings iOS back; it
keeps SysCfg, which Linux never writes.

## Open work

- GPU: per-job firmware overhead, parameter-manager pool growth inside a
scene, and submitting a fragment job behind its geometry job
(`a8_joint`) by default.
- Bluetooth: hci0 comes up with the module's patchram; no input or audio
device has been paired yet.
- Battery: the charge is estimated from Apple's OCV curve for this
battery family; it has not been checked against a full charge and
discharge. The driver only reads: it reports the charge state and USB
power, while the PMIC charges at whatever limit the boot loader left.
Setting the charge current (charging) is open.

## Unmerged code

None.
43 changes: 43 additions & 0 deletions devices/n102/boot.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
{
"schema": 1,
"device": "iPod7,1",
"firmware": [
{
"ipsw": {
"version": "12.5.8",
"build": "16H88",
"url": "https://updates.cdn-apple.com/2026WinterFCS/fullrestores/047-28554/C3D5CA8F-8B6F-4B05-9456-C5E632723337/iPodtouch_12.5.8_16H88_Restore.ipsw",
"bytes": 2821634289,
"sha256": "53a645c03332cd132f52612ffdf2aba3e6908ca937ab7f6c7b81aa8e15a14ec6"
},
"selected_by": "firmware-recipe",
"inputs": {
"BuildManifest.plist": {
"ipsw": {
"zip": "BuildManifest.plist"
},
"sha256": "97fe52925b0fbc3c2062019f831a18db7d6aeba60742df4be74106b3ea33d0e3"
},
"iBSS": {
"ipsw": {
"zip": "Firmware/dfu/iBSS.n102.RELEASE.im4p"
},
"sha256": "874d5fc6384ffee72e18b89020f1396702735c879d39014f39314c7ce2b84aec"
},
"iBEC": {
"ipsw": {
"zip": "Firmware/dfu/iBEC.n102.RELEASE.im4p"
},
"sha256": "5715e383b1e3eced6202eb47d515b13f1b10c41348239c6a800019111493a07c"
},
"DeviceTree": {
"ipsw": {
"zip": "Firmware/all_flash/DeviceTree.n102ap.im4p"
},
"sha256": "f59b40ce4fa554f4bb24415201c61dd2e8a6767558ca6404a4afa74dd2ec2d35"
}
}
}
],
"methods": {}
}
59 changes: 59 additions & 0 deletions devices/n102/device.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# iPod touch 6 (N102): identity from public sources (tools/catalog/generate's read_firmware);
# A8/T7000 like the iPhone 6. Installs to its internal storage next to iOS; notes in README.md.
schema = 1
kind = "hardware.device"

[device]
profile = "n102"
name = "iPod touch 6"
apple_products = ["iPod7,1"]
dt_compatible = ["apple,n102"]

[match.dfu]
chip = 0x7000
board = 0x10

[boot]
methods = ["checkm8-pongo"] # checkra1n then PongoOS and m1n1, tethered.
entries = ["checkra1n"]

[kernel]
platform = "apple-4k"
dtb = "t7000-n102" # arch/arm64/boot/dts/apple/<dtb>.dtb

[firmware]
recipe = "firmware.json" # The touchscreen, Wi-Fi and Bluetooth firmware from this board's public IPSW.

[support]
status = "experimental"

# States: working, untested, missing, none (features.toml). "untested" means a driver
# binds in its device tree (tools/catalog/drivers.json).
[features]
display = "working" # The console and the desktop.
screen_off = "missing"
backlight = "working" # DWI and the LM3534: brightness set and read back.
touch = "working" # N1 on apple_z2: 640x1136, several contacts.
buttons = "working" # Home, power and both volume buttons (gpio-keys).
accelerometer = "missing"
gyroscope = "missing"
light_sensor = "missing"
touch_id = "none"
storage_read = "working" # ANS1 (asp) on RTKit 10.2: the user area asp0n1 and nine read-only auxiliary namespaces.
storage_write = "working" # The user area only; asp refuses every other namespace's writes. An install next to iOS wrote asp0n1 only.
wifi = "working" # BCM4345B1 on PCIe: scans 2.4 and 5 GHz, joins a network.
bluetooth_input = "untested" # The controller comes up with its patchram; nothing paired yet.
bluetooth_audio = "untested"
cellular = "none"
battery = "working" # No fuel gauge: the D2186 PMIC's ADC and charger status, read-only (apple_d2186_battery).
charging = "missing"
charging_control = "missing"
suspend = "untested"
resume = "untested"
usb_serial = "working" # The RAM shell over USB serial (CDC ACM).
usb_network = "untested"
usb_host = "missing"
audio_output = "missing"
audio_input = "missing"
camera = "missing"
video_decode_hevc = "missing"
165 changes: 165 additions & 0 deletions devices/n102/firmware.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,165 @@
{
"schema": 2,
"device": "iPod7,1",
"ipsw": {
"version": "12.5.8",
"build": "16H88",
"url": "https://updates.cdn-apple.com/2026WinterFCS/fullrestores/047-28554/C3D5CA8F-8B6F-4B05-9456-C5E632723337/iPodtouch_12.5.8_16H88_Restore.ipsw",
"bytes": 2821634289,
"sha256": "53a645c03332cd132f52612ffdf2aba3e6908ca937ab7f6c7b81aa8e15a14ec6"
},
"inputs": {
"DeviceTree.im4p": {
"ipsw": {
"zip": "Firmware/all_flash/DeviceTree.n102ap.im4p"
},
"sha256": "f59b40ce4fa554f4bb24415201c61dd2e8a6767558ca6404a4afa74dd2ec2d35"
},
"N102.mtprops": {
"ipsw": {
"rootfs": "usr/share/firmware/multitouch/N102.mtprops"
},
"device": "/usr/share/firmware/multitouch/N102.mtprops",
"sha256": "e599bb27ffd005ece0fbcdb6accab5aa23bc1a4765d81aa41ad2e4d1644f4e11"
},
"P-bacchus_M-CORO_V-u__m-3.7.txt": {
"ipsw": {
"rootfs": "usr/share/firmware/wifi/C-4345__s-B1/P-bacchus_M-CORO_V-u__m-3.7.txt"
},
"device": "/usr/share/firmware/wifi/C-4345__s-B1/P-bacchus_M-CORO_V-u__m-3.7.txt",
"sha256": "aebb3fb4944ad98946c073e77ac9ad24cc78eb0c2056aa990364da0bddab4a19"
},
"bacchus.clmb": {
"ipsw": {
"rootfs": "usr/share/firmware/wifi/C-4345__s-B1/bacchus.clmb"
},
"device": "/usr/share/firmware/wifi/C-4345__s-B1/bacchus.clmb",
"sha256": "e371396eb6b88fbb90404b4cc9b4e882b361f6c42d2ba82b0207950d342b83be"
},
"bacchus.trx": {
"ipsw": {
"rootfs": "usr/share/firmware/wifi/C-4345__s-B1/bacchus.trx"
},
"device": "/usr/share/firmware/wifi/C-4345__s-B1/bacchus.trx",
"sha256": "bc607420e25e9ca6bbb84b5789126c72a6fd682cbceead3c404bc7cf99ba95fd"
},
"bacchus.txcb": {
"ipsw": {
"rootfs": "usr/share/firmware/wifi/C-4345__s-B1/bacchus.txcb"
},
"device": "/usr/share/firmware/wifi/C-4345__s-B1/bacchus.txcb",
"sha256": "1a208b58ad3c36ebcc669d50af1cbcbbff39bfc208d4e8f2da3255c492e80661"
},
"BlueTool": {
"ipsw": {
"rootfs": "usr/sbin/BlueTool"
},
"device": "/usr/sbin/BlueTool"
}
},
"outputs": [
{
"destination": "lib/firmware/apple/n102-fwstart.z2fw",
"sha256": "b9cdcca016e20a1562fdaab2da1f1d0fe9daab18b9ba96bce4b8bdc3ed0cc9b9",
"steps": [
{
"step": "z2fw-from-z2-packet@1",
"input": "N102.mtprops",
"profile": "C1F58,1",
"calibration_address": 268472320,
"calibration_size": 1024
}
]
},
{
"destination": "lib/firmware/brcm/brcmfmac4345-pcie.apple,bacchus-CORO-u-3.7.txt",
"sha256": "aebb3fb4944ad98946c073e77ac9ad24cc78eb0c2056aa990364da0bddab4a19",
"steps": [
{
"step": "copy@1",
"input": "P-bacchus_M-CORO_V-u__m-3.7.txt"
}
]
},
{
"destination": "lib/firmware/brcm/brcmfmac4345-pcie.apple,bacchus.txt",
"sha256": "aebb3fb4944ad98946c073e77ac9ad24cc78eb0c2056aa990364da0bddab4a19",
"steps": [
{
"step": "copy@1",
"input": "P-bacchus_M-CORO_V-u__m-3.7.txt"
}
]
},
{
"destination": "lib/firmware/brcm/brcmfmac4345-pcie.apple,bacchus.clm_blob",
"sha256": "e371396eb6b88fbb90404b4cc9b4e882b361f6c42d2ba82b0207950d342b83be",
"steps": [
{
"step": "copy@1",
"input": "bacchus.clmb"
}
]
},
{
"destination": "lib/firmware/brcm/brcmfmac4345-pcie.apple,bacchus.bin",
"sha256": "bc607420e25e9ca6bbb84b5789126c72a6fd682cbceead3c404bc7cf99ba95fd",
"steps": [
{
"step": "copy@1",
"input": "bacchus.trx"
}
]
},
{
"destination": "lib/firmware/brcm/brcmfmac4345-pcie.apple,bacchus.txcap_blob",
"sha256": "1a208b58ad3c36ebcc669d50af1cbcbbff39bfc208d4e8f2da3255c492e80661",
"steps": [
{
"step": "copy@1",
"input": "bacchus.txcb"
}
]
},
{
"destination": "lib/firmware/brcm/BCM.apple,n102-MUR.hcd",
"sha256": "b78b1fc9ed84e145769ad8f3f3202f505adab0c59d6b27d86477a36ec912e519",
"steps": [
{
"step": "bluetool-hcd@1",
"input": "BlueTool"
}
]
},
{
"destination": "lib/firmware/brcm/BCM.apple,n102-TDK.hcd",
"sha256": "d818b2d1f97897290f0a59c900d87454fe7c6f844363ec81133118dc3b16d5a0",
"steps": [
{
"step": "bluetool-hcd@1",
"input": "BlueTool"
}
]
},
{
"destination": "lib/firmware/brcm/BCM.apple,n102-USI.hcd",
"sha256": "32a76158582d7d24bd6f6d7d2fe31c2b4dad5ec16180c1b84fbe09d3a9101370",
"steps": [
{
"step": "bluetool-hcd@1",
"input": "BlueTool"
}
]
},
{
"destination": "lib/firmware/brcm/BCM.apple,n102.hcd",
"sha256": "32a76158582d7d24bd6f6d7d2fe31c2b4dad5ec16180c1b84fbe09d3a9101370",
"steps": [
{
"step": "bluetool-hcd@1",
"input": "BlueTool"
}
]
}
]
}
18 changes: 18 additions & 0 deletions devices/n56/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# iPhone 6 Plus, N56

Hardware identity, boot assets and the firmware recipe are in
[`device.toml`](device.toml). This file tracks what still needs testing,
open work, and contributed code that is not in the tree yet.

## Needs testing

**GPU (A8, PowerVR GX6450).** The board has the iPod touch 6's A8 GPU, and
its device tree enables it (`kernel/patches/devices/t7000/0012`). The
driver has only run on the iPod touch 6 (N102) so far. Test with
[`examples/ipod-gpu-drm`](../../examples/ipod-gpu-drm/README.md)
(`--device n56`) and report the output of `a8-gpu-drm-test probe` with
its kernel lines, and the ladder's `RESULT` lines.

## Unmerged code

None.
18 changes: 18 additions & 0 deletions devices/n61/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# iPhone 6, N61

Hardware identity, boot assets and the firmware recipe are in
[`device.toml`](device.toml). This file tracks what still needs testing,
open work, and contributed code that is not in the tree yet.

## Needs testing

**GPU (A8, PowerVR GX6450).** The board has the iPod touch 6's A8 GPU, and
its device tree enables it (`kernel/patches/devices/t7000/0012`). The
driver has only run on the iPod touch 6 (N102) so far. Test with
[`examples/ipod-gpu-drm`](../../examples/ipod-gpu-drm/README.md)
(`--device n61`) and report the output of `a8-gpu-drm-test probe` with
its kernel lines, and the ladder's `RESULT` lines.

## Unmerged code

None.
Loading
Loading