Files
UniXNU/docs/porting/index.md
UniXNU Docs 1446f449b6 docs(porting): cover the macOS path
The porting flow covers the macos-27.3-26C5035r profile from profile
selection to the porting record: the macOS profile page lists the profile
contents, host inputs, board.toml override, Data seed, build commands,
driver adaptations and boot checkpoints, and the steps, arm64e, packaging,
records, bring-up, building, requirements and reference pages point to it.
The iPadOS instructions are unchanged.

Porting pages link porting pages for driver topics: Develop a driver and
Brightness interface are porting pages, and component names in porting
pages are plain text. English and Chinese pages.
2026-11-10 19:26:10 +08:00

2.0 KiB

Welcome

UniXNU is a general UEFI environment and driver loading system, similar to OpenCore. A common UEFI layer starts on the device, loads the drivers the device repository selects and boots the OS. UniXNU applies that model to non-Apple ARM64 hardware: it boots iOS and macOS from the device's own UEFI firmware.

Architecture

The stack has six layers. Each layer has a repository, a build output and a handoff to the next layer.

flowchart TD
  A[Android bootloader] -->|fastboot boot boot.img| B[BootShim and UEFI firmware]
  B -->|UEFI starts UniXNU| C[UniXNU boot manager]
  C -->|UNIXNU_LOADER_PROTOCOL| D[DarwinBoot]
  D -->|boot_args, ADT, trust cache, ramdisk| E[Patched XNU kernel]
  E -->|IOKit, BSD, launchd| F[IPSW userland]
Layer Source Output Hands over
1. Boot image Device repository, ./unixnu bootimg Android boot image: BootShim, firmware volume, device tree, payload ramdisk The stock bootloader jumps to BootShim
2. UEFI firmware uefi-<device> (Mu-Silicium) SILICIUM_UEFI.fd Graphics, input, block and file system services
3. Boot manager UniXNU package/UniXNUPkg UniXNU.efi Loads drivers, ACPI tables, kits and the device tree, then starts the selected entry
4. XNU loader DarwinBoot UEFI driver Copies the kernel, ADT, trust cache and ramdisk, builds boot_args, enters the kernel
5. Kernel Pinned XNU source, ordered patch series, prelink kernel.macho and its ADT Native drivers and the original kexts, then launchd
6. Userland Target IPSW OS and SystemOS images in userdata iOS or macOS user space

Shared code lives in UniXNU and its component repositories. SoC repositories add platform support, and device repositories add board configuration, drivers and packaging. See the boot chain for the handoff details.

Next

Follow Port a device in order. For macOS, read macOS profile beside it.