UniXNU

简体中文

English

简体中文

English

外观

Xiaomi Redmi Note 12 Pro 5G (ruby, MediaTek Dimensity 1080 / MT6877) ​

lky005/UniXNU-ruby

Catalog identity for the ruby (Redmi Note 12 Pro 5G, MT6877) XNU 8796 + iPhone X iOS 16.7.16 (20H392) userland bring-up. Public main documents the verified 0155 line; p3-eint-hal (0160, ruby_eint/EINT14) is in development. The implementation, build recipe and device evidence live in lky005/ruby-ios-bringup. This repository selects no UniXNU components and does not claim a UniXNU UEFI or format-2 build.

源记录: porting.toml, d321b43deae0fba70f3fd566fa25d41648b7bf82.

本页按设备记录自动生成。

部分状态
配置host-verified
固件与启动not-applicable
CPU 与中断implemented
内存与 DMAimplemented
存储与根卷implemented
显示implemented
输入device-verified
GPUplanned
网络planned
音频planned
电源device-verified
镜像组装implemented
诊断device-verified

配置 ​

host-verified

硬件与依赖 ​

  • MT6877 board identity, iPhone X iOS 16.7.16 (20H392) userland, XNU 8796 recipe and the 0155 patchset from lky005/ruby-ios-bringup.

配置 ​

  • board.name = ruby; board.soc = MT6877; board.os_profile = ios-16.7.16-20H392; [components].include = [].
  • No SoC source, kit, defconfig, firmware or package section is selected in this catalog repository.

操作步骤 ​

  • Read README.md and follow the pinned links to the main repository.
  • Use the main repository xnu-0155 workflow as the build gate; this repository has no CI.

开发经验 ​

  • Public main is the 0155 line: patchset da13b6df (151 files), exec-data 2e98fd85 and image 3b44c0e2.
  • The development branch p3-eint-hal (0160) adds ruby_eint and wires EINT14 into the touch thread; its CI builds are green, but this record does not claim a 0160 device gate.

完成条件 ​

  • The catalog identity matches the main repository and the generated device page links to the pinned record.

当前范围 ​

  • This repository is not a UniXNU build tree; it has no configs, patches, firmware, package or component sources.

下一步 ​

  • Merge the 0160 line to main and refresh the public status links after its device gate is published.

证据 ​

固件与启动 ​

not-applicable

硬件与依赖 ​

  • Stock LK bootloader and a 128 MiB Android boot image; no UniXNU UEFI firmware.

配置 ​

  • UEFI firmware is not used; the boot chain is stock LK -> boot image -> XNU.

操作步骤 ​

  • Follow the main repository reproduction steps for the LK boot image.

开发经验 ​

  • The port does not use the UniXNU UEFI framework or DarwinBoot; the 128 MiB boot image layout is the boot contract.

完成条件 ​

  • Not applicable: the board is outside the UniXNU UEFI boot model.

当前范围 ​

  • No UEFI firmware volume, DSC/FDF, firmware defines or PSCI handoff is produced by this repository.

下一步 ​

  • Keep UEFI out of scope unless the project changes boot model.

证据 ​

CPU 与中断 ​

implemented

硬件与依赖 ​

  • Six Cortex-A55 cores, GICv3, ARM generic timers and 16K pages.

配置 ​

  • The XNU kernel is built for the MT6877 CPU/GIC/timer topology; the pinned 0155 image boots on the author's unit.

操作步骤 ​

  • Boot the 0155 image and inspect the boot log and GIC/timer initialization.

开发经验 ​

  • Public STATUS records six Cortex-A55 cores, 16K pages, GICv3 and timers.
  • EINT work checks GIC SPI256 -> INTID288 read-only before arming; the public 0155 line does not yet ship the EINT14 consumer.

完成条件 ​

  • All enabled CPUs boot and the GIC/timer path reaches userland.

当前范围 ​

  • CPU frequency policy, secondary-core power and thermal behavior are not verified by this record.

下一步 ​

  • Record per-core entry and timer/IPI checks from a clean 0160 build after it lands on main.

证据 ​

内存与 DMA ​

implemented

硬件与依赖 ​

  • 128 MiB boot image, MT6877 memory map and the HFS+ root/rescue layout.

配置 ​

  • The boot image and root layout are pinned in the main repository; no SMMU or DMA ownership is claimed here.

操作步骤 ​

  • Boot the 0155 image and inspect the handoff and root layout.

开发经验 ​

  • Public STATUS documents the 128 MiB boot image, UFS root and a 4 MB HFS rescue root.

完成条件 ​

  • The handoff reaches a working HFS+ root and the rescue root path.

当前范围 ​

  • DMA widths, SMMU ownership and memory reservations are not independently audited by this record.

下一步 ​

  • Add the memory map and reservation evidence when the 0160 line is published.

证据 ​

存储与根卷 ​

implemented

硬件与依赖 ​

  • MT6877 UFS LUN 2, HFS+ iosroot and the LK ramdisk slot for the md0 rescue root.

配置 ​

  • The root is HFS+ on UFS LUN 2; the rescue root is a 4 MB HFS image in the LK ramdisk slot.

操作步骤 ​

  • Boot the 0155 image; mount iosroot read/write; boot the rescue image and run the /etc/rc checks.

开发经验 ​

  • Public STATUS records read/write HFS+ on iosroot and 8/8 rescue /etc/rc checks from md0.

完成条件 ​

  • The UFS root mounts read/write and the rescue root completes its checks.

当前范围 ​

  • No UniXNU storage component, UFS driver kit or format-2 userdata window is selected in this repository.

下一步 ​

  • Keep the root recipe in the main repository; do not duplicate storage code here.

证据 ​

显示 ​

implemented

硬件与依赖 ​

  • MT6877 display path, LK framebuffer and the IOSurface/IOMFB bridge.

配置 ​

  • The kernel presents IOSurface/IOMFB frames to the LK framebuffer at 1080x2400.

操作步骤 ​

  • Boot the 0155 image and observe SpringBoard on the panel; the public demo shows the home screen.

开发经验 ​

  • Public README/STATUS record IOSurface/IOMFB -> LK framebuffer at 1080x2400 and a live SpringBoard.
  • The demo clip was captured on the 0084 build; it is not a 0160 display claim.

完成条件 ​

  • The panel shows the iOS userland and the home screen.

当前范围 ​

  • No GPU acceleration, external display or backlight control is claimed.

下一步 ​

  • Re-capture the demo on the 0160 line after it is published.

证据 ​

输入 ​

device-verified

硬件与依赖 ​

  • Goodix GT9916R touch panel on bit-bang SPI3 and the volume/power keys.

配置 ​

  • The 0155 line boots with the real touch driver (sweetgt=1); volume/power keys arrive through HID.

操作步骤 ​

  • Boot the 0155 image; touch the panel; observe SWEET GT initialization and HID down/up; press the volume and power keys.

开发经验 ​

  • Public STATUS records real GT9916R HID down/up, 11+ HID lines, volume-down KPD, power/volume-up TOPSTATUS 0x2a and zero PMIC writes.
  • EINT14 touch events are a 0159/0160 development feature, not a public 0155 claim.

完成条件 ​

  • Real touch and the hardware keys reach userland on the 0155 image.

当前范围 ​

  • Multi-touch gestures beyond the documented two-contact dispatch and the EINT14 event path are not claimed for public main.

下一步 ​

  • Publish the 0160 EINT14 device gate before adding it to this record.

证据 ​

GPU ​

planned

硬件与依赖 ​

  • MT6877 Mali-G68 MC4 GPU; no driver is selected.

配置 ​

  • No GPU driver, firmware or userland acceleration is configured.

操作步骤 ​

  • Not started.

开发经验 ​

  • Public STATUS lists GPU as not yet implemented.

完成条件 ​

  • A GPU driver and on-device composition are verified.

当前范围 ​

  • No GPU acceleration, Metal or external display support exists in the current line.

下一步 ​

  • Keep GPU in the P3 target; do not add a placeholder component to this catalog repository.

证据 ​

网络 ​

planned

硬件与依赖 ​

  • MT6877 Wi-Fi/Bluetooth/cellular hardware; no driver is selected.

配置 ​

  • No Wi-Fi, Bluetooth or cellular driver is configured.

操作步骤 ​

  • Not started.

开发经验 ​

  • Public STATUS lists Wi-Fi, Bluetooth and cellular as not yet implemented.

完成条件 ​

  • A network driver and on-device connectivity are verified.

当前范围 ​

  • No wireless or cellular support exists in the current line.

下一步 ​

  • Keep network work in the P3 target; do not add a placeholder component here.

证据 ​

音频 ​

planned

硬件与依赖 ​

  • MT6877 audio codec and DSP paths; no driver is selected.

配置 ​

  • No audio codec, DSP or routing is configured.

操作步骤 ​

  • Not started.

开发经验 ​

  • Public STATUS lists audio as not yet implemented.

完成条件 ​

  • Playback and recording work on the device.

当前范围 ​

  • No audio support exists in the current line.

下一步 ​

  • Keep audio work in the P3 target; do not add a placeholder component here.

证据 ​

电源 ​

device-verified

硬件与依赖 ​

  • MT6360 PMIC battery/charger read-only path over I2C5; KPD/TOPSTATUS keys.

配置 ​

  • The 0155 line reads battery/charger state read-only; it does not write PMIC, charger or rail registers.

操作步骤 ​

  • Boot the 0155 image; run 'battery status'; read the SWEET BATTERY line and the I2C5 arbiter counters.

开发经验 ​

  • Public STATUS records OCV 4311 mV, CHG 0xa2 FULL, FOD 0x94 external, external=1/full=1, 8/8 I2C5 arbiter and no PMIC/charger/rail writes.
  • Battery UI latency (P2.4, 30 s poll, 100->98 on unplug) remains open; Type-C is read-only.

完成条件 ​

  • Battery/charger state is read correctly without writing PMIC or charger registers.

当前范围 ​

  • No charger control, OTG, Type-C role or battery UI latency fix is claimed.

下一步 ​

  • Keep the read-only boundary until a separately approved charger-control change.

证据 ​

镜像组装 ​

implemented

硬件与依赖 ​

  • 128 MiB Android boot image layout, pinned kernel/ADT/shim inputs and deterministic host pipeline.

配置 ​

  • The main repository assembles the boot image and records the kernel, exec-data, payload and image hashes.

操作步骤 ​

  • Follow the main repository reproduction steps with config/0155.env.

开发经验 ​

  • Public README records patchset da13b6df, kernel full 491f2373, exec-data 2e98fd85, image 3b44c0e2 and payload a00dd751.
  • The boot image itself is not published in the repository.

完成条件 ​

  • The host pipeline reproduces the pinned image layout and hashes.

当前范围 ​

  • This catalog repository does not package or publish a boot image.

下一步 ​

  • Record the 0160 image hashes when that line lands on main.

证据 ​

诊断 ​

device-verified

硬件与依赖 ​

  • USB CDC console, SWEETLOG ring decoder and the 19-command read-only board probe.

配置 ​

  • The diagnostic path is read-only; it does not write PMIC, rail, clock or WDT registers.

操作步骤 ​

  • Boot the 0155 image; run the 19-command read-only probe over the USB console; decode the SWEETLOG ring with tools/sweetlog/decode.py.

开发经验 ​

  • Public STATUS records 19/19 probe commands, 8/8 I2C5 arbiter, six snapshots and no panic.

完成条件 ​

  • The probe completes read-only and the log decoder recovers the console ring.

当前范围 ​

  • The probe is read-only; it does not provide charger control, PMIC writes or a complete peripheral inventory.

下一步 ​

  • Keep the diagnostic path read-only; add EINT status only after the 0160 gate is public.

证据 ​

Released under the BSD-2-Clause-Patent License.

Copyright 2026 UniXNU contributors