Skip to content

accel/ane: T8142: admit the macOS 27.2 (26B123) firmware build - #1899

Open
m0d16l14n1 wants to merge 1 commit into
aurora-silicon:integration/aurorafrom
m0d16l14n1:j815/t8142-ane-272
Open

m0d16l14n1 wants to merge 1 commit into
aurora-silicon:integration/aurorafrom
m0d16l14n1:j815/t8142-ane-272

Conversation

@m0d16l14n1

@m0d16l14n1 m0d16l14n1 commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Admits the ANE firmware that the macOS 27.2 (26B123) stub preloads on the M5. macOS 27.2.1 (26B131) ships the same image. Follows #1883.

What differs from 27.0

  • TEXT 0xbc000 and DATA 0x2b0000, with DATA at 0x100_000b_c000. 27.0 is 0xc0000 and 0x2ac000 at 0x100_000c_0000; both end at the same IOVA.
  • iBoot fills two environment sections in TEXT: text_env (32 bytes) and a new __TEXT,ce_env (0x4000 bytes at 0xb4f80). The live TEXT can therefore never hash to the image.

Change

  • Code pin: a TEXT digest with the platform's environment sections zeroed, computed from the IPSW image. It sits beside the existing measured pin, and TEXT matching either is accepted.
  • Builds: a platform can name further builds (next_build), and the preload layout the loader handed over selects one. T8142 gets the 27.2 build pinned by code digest. 27.0 keeps its measured pin and gains a code pin.
  • Reload after sleep compares TEXT with its boot-time digest.
  • Logging: each boot logs firmware <build>, TEXT code sha256 … (code pin|not the code pin). On a miss it also logs the digest of the TEXT before the first environment section, which tells a loader write elsewhere from a new build.

Tested on J815 (MacBook Air 15" M5), 27.2 stub, loader with aurora-silicon/aura#251 (the T8142 ANE preload hand-off):

  • H17 ANE: firmware 27.2 26B123, TEXT code sha256 9b57486790ff4145… (code pin), then loader hand-off verified; starting the engine.
  • An H17 program's output (1080p frame) matches macOS's on the same input: luma 100.00% within 1, chroma kept.
  • ANE KUnit suites: 296 cases ok (the 1 known upstream case excepted).

The first boot, with text_env alone zeroed, missed the pin. That's how ce_env was found.

This base wasn't built separately. drivers/accel/ane is byte-identical to the tree that was booted (integration/aurora with #1883 merged). Not re-run on 27.0: its code pin comes from the 27.0 image, and its measured pin is unchanged. checkpatch --strict: 0 errors; the 2 warnings are the Co-Authored-By trailer.

Part of the J815 bring-up: board results are summarised in discussion #135.

Update 2026-11-19: rebased onto integration/aurora 0abc2f3. The only conflict was in struct ane_fw_platform: upstream added has_xl (H16) beside this patch's new fields, and both are kept. W=1 build clean, ANE KUnit 236/236.

🤖 Generated with Claude Code

@m0d16l14n1

Copy link
Copy Markdown
Contributor Author

@DjDeveloperr ready for review. Hardware on the macOS 27.2 stub (J815 boot 9a636e2e): firmware admitted by the code pin (9b574867); the 960x540 H17 program matches the macOS reference (luma 100% within 1), and the engine parks and comes back across s2idle. Green and mergeable.

Assisted-by: Claude Opus 5.5

DjDeveloperr pushed a commit to m0d16l14n1/aurora-installer that referenced this pull request Nov 17, 2026
List j815 in the pinned 26B123 entry and record it in
firmware-qualification.json, so a J815 on macOS 27.2 or later gets the
27.2 stub, which is the one its macOS can boot alongside.

Hardware result: J815 on the 27.2 stub boots Linux with ANE, AVE, AVD,
JPEG, ProRes, GPU, Wi-Fi and camera working (aurora-silicon/linux#1899).
It needs, in the kernel, linux#1899 and #1900 (the 27.2 ANE and AVE
builds) and #1683 (GPU and display on 27.2), and in the payload's boot
loader aura#250 (without it a b13.1 Stage 1 can't chainload on T8142)
and aura#251. The record's kernel field says so until a release ships
them; this stays a draft until then.

Signed-off-by: Nick <nekreshen@yandex.ru>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The macOS 27.2 (26B123) stub's iBoot preloads a different ANE build on
the M5: TEXT 0xbc000 and DATA 0x2b0000, DATA at 0x100_000b_c000 (27.0:
0xc0000 and 0x2ac000 at 0x100_000c_0000); both end at the same IOVA.
macOS 27.2.1 (26B131) ships the same image byte for byte.

The TEXT pin so far is the digest of TEXT as loaded, which can only be
measured: iBoot fills environment sections in TEXT, so no IPSW image
hashes to it. Add a code pin beside it, the TEXT digest with those
sections zeroed, which is computed from the image, and accept TEXT
matching either. The 27.0 build has one such section, text_env (32
bytes, a fixed 00 01 .. 07 pattern in the image). The 27.2 build adds
__TEXT,ce_env (0x4000 bytes at 0xb4f80, zero in the image but its first
byte) ahead of text_env, and iBoot fills it too, so a platform lists its
environment sections as ranges. On a code pin miss the driver logs the
digest of the TEXT before the first of them, which tells a loader write
elsewhere from a different build in one boot.

Let a platform name further builds (next_build), each with its preload
layout and pins, and select the one whose layout the loader handed
over. T8142 gets the 27.2 build, pinned by its code digest from
h17_ane_fw_theia_j73y (RTKit 3514.41.1), and 27.0 keeps its measured
pin with its code pin added. A reload after sleep now compares TEXT
with the digest it had at boot. Each boot logs the build and its code
digest.

Tested on J815 with the 27.2 stub: "firmware 27.2 26B123, TEXT code
sha256 9b574867... (code pin)", loader hand-off verified, and an H17
program's output matches macOS's (1080p frame, luma 100% within 1).
The ANE KUnit suites pass. Not re-run on 27.0: its code pin is computed
from the 27.0 image and hasn't been checked against a live preload, and
its measured pin is kept unchanged.

Signed-off-by: Nick <nekreshen@yandex.ru>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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