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.
| 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.
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.
- 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.
| 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.
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.