This fork adds an experimental Mac14,2 / T8112 / J413 firmware target and local hardware research to the original M1 project. The J413 UEFI component builds, exposes eight CPU entries and a 2560×1664 framebuffer contract, and has host-tested AIC2 IRQ routing patches. Windows boot, G14G GPU acceleration and built-in M2 input have not been qualified. The firmware component is not an installable boot image.
Start with J413 status and build instructions and organized local kext research. The research includes an inventory of 27 Apple bundles, instruction-level DockChannel findings, an extraction tool and a tested portable FIFO core.
The following historical status describes the upstream M1 (j313) platform;
it does not establish M2 compatibility. Upstream GPU work lives on its separate
M1 branch, whose exact source pins are recorded in the J413 status guide.
Experimental native Windows boot for the 2020 M1 MacBook Air (j313, Apple T8103), built
from a Project Mu firmware fork and an m1n1 EL2 hypervisor fork.
Warning: This project exposes the internal SSD to experimental firmware and a custom NVMe bridge. A wrong
diskpartcommand can destroy macOS, Recovery, or the Asahi boot environment. Keep a complete backup and read the entire installation guide before making disk changes.
Windows 11 ARM64 has booted from the internal Apple SSD, completed OOBE with a local account, reached the desktop, accepted USB keyboard and mouse input, and sustained an RDP session long enough to install software. The current validated assisted configuration exposes:
- all eight M1 CPU cores: four Icestorm efficiency cores and four Firestorm performance cores, with distinct Windows efficiency and scheduling classes;
- a synthetic PCIe NVMe controller backed by the physical Apple ANS storage device;
- physical USB xHCI with keyboard, mouse, hubs, and installation media;
- native built-in Apple keyboard and Precision Touchpad through the J313 SPI-HID driver;
- a Project Mu GOP framebuffer and a remotely observable virtual framebuffer;
- virtual UART and Windows kernel-debug transport for assisted development.
The eight-core assisted checkpoint reached the lock screen inside the hardware boot gate, completed bounded load on all processors, remained responsive during independent SSH probes, and retained healthy built-in keyboard and Precision Touchpad devices. It is still an experimental checkpoint: standalone cold boot, suspend/resume, long-duration thermal stress, and GPU acceleration remain separate qualification gates.
GPU acceleration (work in progress, assisted mode only). On 2026-10-05 the Windows
desktop was, for the first time, composed by DWM through this project's own Apple AGX
driver stack (a WDDM 3.2 kernel-mode driver plus a Mesa-based D3D10 user-mode driver) and
scanned out by the Apple display coprocessor (DCP): wallpaper, desktop icons, and the
taskbar render correctly on the internal panel. It is not usable yet: every GPU job
currently takes 35–325 ms, so a full-screen redraw takes about 30 seconds and areas that
have not been redrawn stay black. This requires the assisted m1n1 hypervisor launch and is
developed on feature/j313-gpu-acceleration, not on main.
Only j313 is currently supported. This is not a general Apple Silicon Windows installer.
| Branch | Purpose | State |
|---|---|---|
main |
Published platform baseline and documentation | Eight CPU cores, NVMe, USB, built-in keyboard and touchpad; GOP framebuffer only |
feature/j313-gpu-acceleration |
AGX GPU driver (KMD + Mesa UMD), DCP scanout, GPU VA broker in m1n1 | Active. First correct GPU-composed desktop; per-job latency is the current blocker |
feature/j313-native-input |
Built-in SPI-HID keyboard and Precision Touchpad | Validated checkpoint, merged into main |
feature/j313-4e4p-cpu-stability |
Eight-core (4E+4P) bring-up | Validated, merged into main |
feature/j313-cpu-stability, feature/j313-4e2p-cpu-stability, feature/j313-4e3p-cpu-stability |
Incremental P-core bring-up (4E+1P … 4E+3P) | Historical validated checkpoints |
stable/j313-4e-baseline |
Frozen four-efficiency-core baseline | Historical recovery reference |
codex/* |
Earlier stability and release-preparation snapshots | Historical |
The submodule forks follow the same naming: m1n1_windows
and apple_silicon_platforms_mu
carry the matching GPU work on their own feature/j313-gpu-acceleration branches, and the
root branch pins the exact submodule commits it was tested with. Every hardware run on the
GPU branch is recorded in investigation/EXPERIMENTS.md and indexed in
investigation/CHANGES.csv.
- Standalone mode: iBoot loads an Asahi-provisioned boot entry, m1n1 starts the embedded Mu firmware, and Mu starts Windows from the internal SSD. A second computer is not part of the runtime path.
- Assisted development mode: another Mac chainloads matching m1n1 and Mu builds over USB and captures UART, hypervisor logs, framebuffer updates, telemetry, and KD traffic. This mode can test firmware and driver changes without rewriting the Air ESP.
- Standalone installation
- Build and packaging
- Standalone and assisted operation
- Launch profiles
- Architecture
- Platform roadmap and milestone gates
- Current stability checkpoint and iteration workflow
- Validated J313 four-efficiency-core baseline
- Validated J313 eight-core and native-input checkpoint
- Debugging and KD tools
- Engineering history
- Historical artifact provenance
- Known limitations
- Built-in Apple keyboard and Precision Touchpad
- Changelog
m1n1_windows/— pinned hypervisor fork submodule.mu/— pinned Apple Silicon Project Mu fork submodule.scripts/— public build, ESP-install, standalone, and assisted-mode entry points.tools/— deterministic layout and image-packaging tools.config/j313-guest-layout.json— canonical guest physical-memory contract.run_uefi.py— Python-assisted guest launcher used for development.tools/kd/— focused Windows serial kernel-debug utilities.extra/— framebuffer, UART, and source-level diagnostic helpers.
This work builds on Asahi Linux, m1n1, Project Mu, and the Apple Silicon Windows work from NT-for-ASi. The active source forks are paulsmir/m1n1_windows and paulsmir/apple_silicon_platforms_mu. See the submodule histories and licenses for their respective copyrights and terms.
Documentation distinguishes three states:
- validated: observed on the development J313;
- implemented: present in source and host-tested but awaiting the relevant hardware run;
- planned: not yet implemented.
The physical internal-panel handoff, full-panel 2560x1600 Windows framebuffer, all four Icestorm and all four Firestorm guest CPUs, synthetic NVMe bridge, physical USB, and the test-signed built-in Apple keyboard and Precision Touchpad driver have been validated together in the assisted J313 checkpoint. GPU acceleration remains an implementation milestone.
Native built-in input build, installation, diagnostics, and rollback are documented in
documentation/APPLE_INPUT.md.