Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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.
40 changes: 40 additions & 0 deletions devices/n102/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# 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.
- The battery gauge is not described yet.

## 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 = "missing" # No fuel-gauge node in the ADT where the iPhone 6 has its HDQ gauge on uart5; how the iPod reads its battery is unknown.
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