Skip to content

About

Original Apple T2 platform research for Linux: firmware, protocols, graphics, audio, sensors, and subsystem maps for readers and tools.

Topics

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

T2 platform research

Original research into Apple T2 hardware, firmware, and the interfaces Linux needs to use them. The collection brings together recovered protocols, board topology, driver comparisons, hardware observations, and the boundaries that remain unresolved.

Find a subsystem

Subject Start with
Secure Enclave and Touch ID SEP services and AKS identity · Fingerprint lifecycle
Dual-GPU graphics gmux, i915/amdgpu, panel timing, and VFCT
Audio Bridge audio state and clock feedback · AOP audio and voice trigger
Camera and media ISP exposure and UVC controls · AVE video encoding
Sensors Lid-angle sensor (LAS) · AOP/SPU motion and time · Ambient light
Input Trackpad and Force Touch · Touch Bar USB/DRM
Power and charging Sleep, wake, and hibernate · SMC, battery, thermal, and USB-PD
Transport and storage BCE, VHCI, and DART · ANS2, NVMe, and xART
Boot and recovery iBoot, EFI, firmware updates, and Linux boot
Network and clocks Wi-Fi · Bluetooth · Thunderbolt · Ethernet · RTC

The research map connects Linux names, firmware components, device IDs, functionality, and findings. The platform overview explains the host/T2 boundary; the board matrix identifies model-specific policy. The coverage map states what was examined and what evidence is still needed.

Read the evidence

The main firmware inventory covers 16 production configurations in bridgeOS 23P6068. Most host observations concern MacBookPro16,1 / J152fAP. A separate SEP reference covers identity-create-v4 on MacBookPro16,2 / J214K with 23P2048. A recovered interface or a successful experiment on one configuration does not establish support across the family.

Chapters distinguish static analysis, hardware observations, comparisons, and inference. Artifact identities and extraction methods and the SEP artifact record make results traceable without redistributing firmware. Use the investigation guide to identify a missing measurement or contribute a correction.

Machine-readable references

  • Research catalog: topic IDs, aliases, Linux and firmware names, document routes, qualified relationships, and coverage.
  • Findings: stable finding IDs with evidence type, scope, and links to the analysis.
  • Boards: production configurations and DeviceTree identities.
  • Catalog guide: schema, lookup commands, and maintenance rules. Human maps are generated from the same catalog.

Repository contents

Directory Purpose
docs Research chapters, evidence, and subsystem maps for readers.
catalog Machine-readable indexes and optional scripts to search them, regenerate maps, and check the collection.
reference-code Python implementations of recovered AKS message formats and activation-bundle storage, with examples and tests for integrators.

The catalog scripts operate on this repository's documents and indexes. The reference code illustrates specific protocol and persistence contracts; it does not provide a driver or fingerprint service. Neither is needed to read the research, and there is nothing to install.

Reuse and contributions

The original explanations, reference code, and collection tools use the MIT license. Credits identify contributed findings, comparison sources, and analysis tools. Contributing explains how to add evidence and keep both reader and machine indexes useful.

About

Original Apple T2 platform research for Linux: firmware, protocols, graphics, audio, sensors, and subsystem maps for readers and tools.

Topics

Resources

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages