Skip to content
Merged
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
10 changes: 10 additions & 0 deletions devices/j71t/firmware.json
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,16 @@
"coprocessor": "AOP_ext"
}
]
},
{
"destination": "lib/firmware/apple/gfx-s8003.bin",
"sha256": "33ae20cbbe2498e4f119ba4e9a55467e4e0192d4c86d5bf1903adce63ffa5dca",
"steps": [
{
"step": "agx-g5p-ldr-from-kernelcache@1",
"input": "kernelcache"
}
]
}
]
}
16 changes: 16 additions & 0 deletions docs/firmware-recipes.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,7 @@ The CLI used to do that; it isn't needed for recipes any more.
| `smartio-from-kernelcache@1` | `input` (kernelcache) | SmartIO coprocessor firmware |
| `vxd-firmware-from-kernelcache@1` | `input` (kernelcache) | the VXD (DEVA) video decoder firmware from AppleD5500 |
| `agx-g9p-firmware-from-kernelcache@1` | `input` (kernelcache) | the A10 GPU firmware from AGXFirmwareKextG9PRTBuddy |
| `agx-g5p-ldr-from-kernelcache@1` | `input` (kernelcache) | the A9 GPU firmware (a META LDR) from AGXFirmwareKextG5P; size and digest are pinned |
| `im4p-payload@1` | `input` | the payload of an IM4P container |
| `aop-image@1` | `coprocessor` | one image (`AOP`, `AOP_ext`) of an AOP firmware container, the OSSerializeBinary payload of `Firmware/AOP/aopfw-*.im4p` |
| `z2fw-from-mtprops@1` | `input`, `profile`, `packet`, `load_address`, `hbpp_version` | Z2 touch firmware with calibration records |
Expand Down Expand Up @@ -238,3 +239,18 @@ The decompressed N61 kernel's SHA-256 is
These fields are explicit recipe parameters, including zero-valued overrides.
Physical qualification of firmware loading and input events remains separate
from converting this shared firmware file.


## S8003 G5P META firmware

`agx-g5p-ldr-from-kernelcache@1` reads the unique `__TEXT,__const` section
of `com.apple.AGXFirmwareKextG5P` in the user's own legacy prelinked
kernelcache. It rejects any size other than 119112 bytes or any digest other
than `33ae20cbbe2498e4f119ba4e9a55467e4e0192d4c86d5bf1903adce63ffa5dca`.
The existing J71t kernelcache input names the active device kernelcache and
the pinned restore-image fallback. The normal recipe installer writes the
verified output to `/lib/firmware/apple/gfx-s8003.bin`, named like the A10's
`gfx-t8010.bin`: the GPU driver asks for `apple/gfx-<chip>.bin`. The file is
Apple's LDR, byte for byte. No payload patch, calibration, firmware bytes or
captured job is stored in the source tree. Other C0 revisions and other
boards require separate digest qualification.
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Berkay=20K=C3=B6sebay?= <brkosebay@users.noreply.github.com>
Date: Tue, 10 Nov 2026 15:07:45 +0000
Subject: [PATCH] arm64: dts: apple: s8003: Describe the GPU
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The A9's GPU: the Rogue core's registers, Fender, the gfx power domain
and the five interrupts, and the firmware the driver loads (the image
the firmware recipe extracts from the device's kernelcache). The node is
disabled: no driver takes it yet. The powervr driver's Apple firmware
path will, and the boards enable it then.

The registers and interrupts are those of Berkay Kösebay's G5P driver
node (orchard #74, 557ef01b), which runs the GPU on the iPad 5 (J71t).
Reworked for the powervr driver: the gpu label, the firmware name, and
no board enables it before that driver binds.

Assisted-by: LLM
---
arch/arm64/boot/dts/apple/s8003.dtsi | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)

diff --git a/arch/arm64/boot/dts/apple/s8003.dtsi b/arch/arm64/boot/dts/apple/s8003.dtsi
index b515889..1ed521d 100644
--- a/arch/arm64/boot/dts/apple/s8003.dtsi
+++ b/arch/arm64/boot/dts/apple/s8003.dtsi
@@ -336,3 +336,25 @@
* the S8003 (APL1022) on 16nm. There are some minor differences
* such as timing in cpufreq state transistions.
*/
+
+/*
+ * The GPU: a PowerVR Rogue core (GT7600) behind Apple's Fender block, with
+ * Apple's firmware on the core's own processor. Off until a driver takes it.
+ */
+&{/soc} {
+ gpu: gpu@201000000 {
+ compatible = "apple,s8003-gpu";
+ reg = <0x2 0x01000000 0x0 0x100000>,
+ <0x2 0x01e00000 0x0 0x100000>;
+ reg-names = "rgx", "fender";
+ power-domains = <&ps_gfx>;
+ interrupt-parent = <&aic>;
+ interrupts = <AIC_IRQ 170 IRQ_TYPE_LEVEL_HIGH>,
+ <AIC_IRQ 171 IRQ_TYPE_LEVEL_HIGH>,
+ <AIC_IRQ 172 IRQ_TYPE_LEVEL_HIGH>,
+ <AIC_IRQ 173 IRQ_TYPE_LEVEL_HIGH>,
+ <AIC_IRQ 174 IRQ_TYPE_LEVEL_HIGH>;
+ firmware-name = "apple/gfx-s8003.bin";
+ status = "disabled";
+ };
+};
Loading
Loading