Kernel patches of the macOS 27.3 profile:
- the kernel window may span gaps between DRAM banks (excluded ranges),
and boot payload memory is reported and returned on request;
- the highwater and compressor-thrashing kills of the embedded memory
policy are not taken on the macOS target;
- the scaled timebase converts without divisions and, with
timebase-user=1, is read in userspace without a trap;
- the signature pass over 16 KiB-signed images is counted and shared
between processors for large images;
- union lookups walk the parent chain under one name cache lock and the
readdir report is gone; stuck-thread rows can name the waited file;
- counters for work intervals and timebase traps;
- gpu-bundle-system=1 shows the Metal plugin over
/System/Library/Extensions.
The profile's kernel collection gains com.apple.filesystems.lifs.
Build: the bridge applies runtime patches 0031 to 0034, Turnip's weak
flat-namespace imports are bound to the library, and the device tree
generator knows the excluded-range, loader-input and outside-memory
tables. Driver modules move to their current main.
Compiled and linked; not run on hardware.
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.
Describe the root-built macOS Data seed and its firmlink mount, the [payload.runtime] keys, and how an os_overrides remove list acts on the merged profile and board values. English and Chinese pages.
The target table names the iOS 16.7.16 (iPhone X), iPadOS 17.7.11,
iOS 27.0.1 (iPhone 16 Pro) and iPadOS 27.0.1 restore images from
ipsw.me with their architecture. iOS 16 and iPadOS 17 are both arm64 and
share the arm64 patch series. Pages that named iPadOS alone now name iOS
or iPadOS where both apply, and the iPadOS 26 profile is no longer
described.
A payload larger than a few megabytes cannot live in boot on a GKI device: the
field is empty by design and the ABL rejects one. Record the three limits that
decide whether a vendor_boot image is accepted, that the AVB footer is retargeted
rather than removed, and that mformat needs an explicit FAT16 geometry.
Add what the framebuffer reports when there is no serial console: the loader's
green band, the entry probe's blue and magenta stage bands, the reset probe that
turns a stage into a reboot, the panic screen sharing the padding after _start
with a stage-four probe, and the need to hold a failing loader's own diagnostics
on screen before the menu redraws them.
Document [bootimg.image] kernel_compression in both locales.
GKI devices carry no ramdisk in boot and a vendor ABL rejects one there, so
anything large that has to reach the bootloader belongs in vendor_boot's vendor
ramdisk. Nothing in the tree could rewrite that image while leaving the stock one
intact.
Copy the device tree, the ramdisk table, the bootconfig and the vbmeta blob
verbatim; change only the ramdisk bytes, the header's vendor_ramdisk_size, the
ramdisk address and each table entry's size and offset; retarget the AVB footer
because the vbmeta blob moves. --ramdisk-addr relocates the ramdisk, which stock
images need when the default window is smaller than the payload.
--verify-against repacks the stock ramdisk and requires a byte-identical result
before the real ramdisk is written, so a device whose layout differs fails loudly
instead of producing an unbootable partition.
The offline tests build a synthetic v4 image and cover the repack, the
relocation, the partition limit and the refusals; the command and its flags are
documented in docs/reference/cli.md and the Chinese page. Checked on the NX769J
against its stock vendor_boot: the stock image is reproduced byte for byte, and
the 64 MiB payload image the tool produces is the one that boots on hardware.
The packaging page describes the implemented unixnu release command, its
board.toml keys, the outputs and the checks verify makes. The arm64e page states
that arm64e needs native PAC hardware, that iPadOS 18 is the last version that
supports arm64, recommends PAC devices and the iOS or iPadOS 27 profile, and
states that every driver and optimization must work for 17 and 27 with the
build target as the only difference.
Introduce a generic Tools submenu plus a menu-plugin protocol so device
tools can be discovered at runtime instead of being hardcoded in UniXNU.
Structure:
- UniXNUPkg/Include/Protocol/UniXNUMenuPlugin.h: plugin protocol with a
Run callback, a content rect and a DrawStatus footer callback.
- UniXNUPkg/Library/UniXNULib: discover installed plugins, render a
Back + plugin list, and run the selected plugin between the header and
footer while keeping the upper UI visible.
- UniXNUPkg/Driver/AdvancedLogDxe: first plugin; exports the Advanced
Logger log as OneSend QR frames with 5 volume-key speed gears and a
5-segment level bar, drawn with a single Blt.
- UniXNUPkg.dec: adds the menu plugin GUID and PcdUniXNUDeviceModel so
exported log files are named with the device model.
- scripts/unixnu/payload.py, built-in config and docs: `tools = true`
appends a Tools entry and documents the `tools` action.
The exported QR frames are read with OneSend (扫传):
https://onesend.01mvp.com
Scope: loader and boot logic are unchanged. This commit only adds the
menu/UI plugin path and the Advanced Logger tool; device wiring lives in
the platform checkout and is not part of this change.
The boot menu uses a column layout on a framebuffer whose width/height
is below [ui] portrait_below (default 800 thousandths): the vector logo
on top, numbered entry cards at the bottom and wrapping status lines.
[ui] layout forces landscape or portrait. qemu-run.py gains
--display-size to test tall panels, and smoke.sh a layout scenario.
Add English and Simplified Chinese documentation under docs/, covering the boot chain, build, boot, debugging, porting, drivers, XNU 4 KiB pages, macOS and device notes. Add the Pages workflow and CNAME. Rename the boot manager from CrabApple to UniXNU across the package, symbols, paths, configuration file and logs. Update README with the documentation badge and CONTRIBUTING link.