32 KiB
Lenovo Xiaoxin Pad Pro 2021 (j716f)
Lenovo Xiaoxin Pad Pro 2021 (TB-J716F / SM8250-AC) porting record for UniXNU iPadOS 17.7.11.
Source record: porting.toml, bf2d0f32f706adbe414551e452f1426ed7c4bd19.
This page is generated from the device record.
| Area | Status |
|---|---|
| Configuration | device-verified |
| Firmware and boot | device-verified |
| CPU and interrupts | device-verified |
| Memory and DMA | device-verified |
| Storage and root | device-verified |
| Display | device-verified |
| Input | device-verified |
| GPU | device-verified |
| Network | device-verified |
| Audio | planned |
| Power | device-verified |
| Image assembly | device-verified |
| Diagnostics | device-verified |
Configuration
device-verified
Components: XnuPrelink, DarwinBoot, SoftwareAES, AppleKeyStoreState.
Hardware and dependencies
- SM8250-AC (Kona) hardware identity, iPadOS 17.7.11 (21H461 / j120ap) OS profile, j716f_defconfig, and device:dts/j716f.dts.
Configuration
- board.toml uses schema_version = 2, soc = SM8250, soc_source = sm8250, os_profile = ipados-17.7.11-21H461, and device:dts/j716f.dts.
Procedure
- Run ./unixnu defconfig j716f_defconfig -D ../UniXNU-j716f, ./unixnu status --json -D ../UniXNU-j716f, and python3 scripts/porting-record.py check --device ../UniXNU-j716f.
Development findings
- 2026-11-09 Enabled sheng-wifi=4 (QCA6390 PCIe0 MHI AMSS Mission Mode + en0/wifid/unixnu-wpa_supplicant) and sheng-bluetooth=1 (QCA6390 UART6 @ 3.2 Mbps + BlueTool/bluetoothd) in board.toml.
- 2026-11-08 Synced with upstream UniXNU
5dc00d2and UniXNU-sheng 6894001; enabled armcpu-edge=1, pipa-cpufreq=4, pipa-gpu-dcvs=1, sheng-backlight=1, sheng-aks-sls=3, appsync=1, and owner-staged-apps=1 in board.toml. - 2026-11-06 Synced with upstream UniXNU
e2fdae4(AppleKeyStoreState 8c70daf8, XnuPrelink ef4fe4f9, zzy-native-gpu-addon-mount.patch) and added sheng-platform-power.patch to socs/sm8250/patches/xnu/series. - 2026-11-06 Pruned obsolete pre-mainline diagnostic suites, duplicate J716FUfs directory, unused scripts/configs, and historical bring-up logs while preserving all active mainline components.
Completion criteria
- Format 2 board identity, source paths, defconfig, and patch series resolve cleanly under scripts/package.sh.
Current limits
- The SM8250 SoC layer resides in socs/sm8250 until an upstream common SM8250 feed is pinned.
Next action
- Maintain alignment with upstream UniXNU schema_version = 2 and component catalog updates.
Evidence
device: Format 2 board.toml and j716f_defconfig boot iPadOS 17.7.11 (21H461) to the interactive desktop on Lenovo TB-J716F. Command:bash scripts/package.sh --no-deps --uefi ../uefi-j716f; fastboot flash boot_b boot.img && fastboot reboot. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Format 2 board configuration, component selection, and structured porting record pass validation. Command:python3 ../UniXNU/scripts/porting-record.py check --device .. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Firmware and boot
device-verified
Hardware and dependencies
- Mu-Silicium uefi-j716f platform (Platforms/Lenovo/j716fPkg/j716f.dsc), inherited GOP framebuffer at 0x9c000000, and ZUI 15.0.485 memory map.
Configuration
- board.toml [firmware] builds Platforms/Lenovo/j716fPkg/j716f.dsc with scripts/check-j716f.py preflight and packs SILICIUM_UEFI.fd at 0xce000000 (0x700000 bytes).
Procedure
- Run python3 scripts/check-j716f.py and build firmware via ./unixnu build firmware -D ../UniXNU-j716f --uefi ../uefi-j716f.
Development findings
- 2026-11-06 Updated scripts/check-j716f.py to allow XNU_NATIVE_UFS=1 in build-xnu-4k-baseline.sh owner-root audit/trust checks.
- 2026-11-06 Cleaned legacy bring-up DXE modules and non-J716F platforms from uefi-j716f while retaining the verified J716F UEFI firmware configuration.
Completion criteria
- UEFI firmware initializes display, PON buttons, RAM disk payload, and DarwinBoot handoff into XNU on boot_b.
Current limits
- Vendor firmware blobs remain outside Git and are verified by SHA-256 via proprietary-files.txt.
Next action
- Keep uefi-j716f memory map descriptors synchronized with dts/j716f.dts.
Evidence
device: UEFI firmware boots on TB-J716F Slot B, renders the UniXNU boot menu on the 2560x1600 OLED panel, and launches XNU via DarwinBoot. Command:python3 scripts/check-j716f.py && fastboot flash boot_b boot.img. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Preflight stages build/j716f/j716f.dtb (728300 bytes) and validates the 0xce000000/0x700000 UEFI FD configuration. Command:python3 scripts/check-j716f.py. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
CPU and interrupts
device-verified
Components: ArmCpu, ArmDTPlatform.
Hardware and dependencies
- 8-core Kryo 585 topology (CPU0..3 Cortex-A55, CPU4..6 Cortex-A77 Gold, CPU7 Cortex-A77 Prime), GICv3 (0x17a00000 / 0x17a60000), PSCI SMC, and 19.2 MHz arch timer.
Configuration
- Enabled sheng-smp=1, armcpu-self-ipi=1, armcpu-spi-ipi=1, armcpu-edge=1, and pipa-cpufreq=4 in board.toml with 8 CPU nodes (CPU0..3 E-cluster, CPU4..7 P-cluster) in socs/sm8250/dts/sm8250.dtsi.
Procedure
- Boot with sheng-smp=1, armcpu-edge=1, and pipa-cpufreq=4 and verify all 8 cores online, AMP E/P cluster scheduling, and dynamic EPSS frequency domains over USB CDC-ACM.
Development findings
- 2026-11-09 Updated ArmCpu GICv3 SPI/PPI delivery and SMP telemetry for QCA6390 PCIe0 MSI/SPI and QUPv3_0 SE6 UART6 DMA interrupts (SPI 639).
- 2026-11-08 Enabled AMP big.LITTLE edge scheduler (armcpu-edge=1, CPU0..3 E-cluster, CPU4..7 P-cluster, recommended_cores=0xff) and dynamic 3-cluster EPSS cpufreq governor (pipa-cpufreq=4, 16 ms window with touch boost and 300/691/844 MHz idle floors).
- 2026-11-06 Added sheng-platform-power.patch to socs/sm8250/patches/xnu/series for clean Format 2 patch stack application.
- 2026-11-04 Verified all 8 Kryo 585 cores online via PSCI CPU_ON (MPIDR 0x000..0x700) and 3-cluster EPSS cpufreq (1804 / 2419 / 3187 MHz + L3 1612 MHz).
Completion criteria
- All 8 CPU cores register with XNU AMP edge scheduler (E/P clusters), handle GICv3 PPI/SPI/IPI interrupts, and scale dynamically across EPSS OPP tables with touch boost.
Current limits
- Deep CPU idle states remain disabled via sleep-disabled = 1 in ADT defaults.
Next action
- Evaluate dynamic EPSS frequency scaling under thermal thresholds.
Evidence
device: All 8 Kryo 585 cores come online in XNU with active GICv3 timer/IPI delivery and 1.80 / 2.42 / 3.19 GHz cluster clocks. Command:Verify 8-core SMP registration and EPSS LUT frequency programming via USB CDC-ACM status telemetry on TB-J716F.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Hardware DTS compiles cleanly with 8 Kryo 585 CPU nodes, GICv3 redistributor stride, and PSCI SMC method. Command:dtc -I dts -O dtb -i socs/sm8250/dts dts/j716f.dts -o /tmp/j716f-hardware.dtb. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Memory and DMA
device-verified
Hardware and dependencies
- 6 GiB LPDDR4X DRAM (0x80000000 + 0x140000000), owned_memory_size 0xE0000000, and Qualcomm Apps SMMU (0x15000000) + GPU SMMU (0x03da0000).
Configuration
- Configured dram_base = 0x80000000, dram_size = 0x140000000, owned_memory_size = 0xE0000000 in board.toml, Apps SMMU S2CR bypass in package/SmmuBypass.h, and Stage-1 Normal Write-Back Inner-Shareable identity mapping on CB 71 for USB0 DWC3 DMA.
Procedure
- Verify Apps SMMU non-GPU stream mappings and GPU SMMU context banks during UFS, USB0 CDC-ACM / AppleUSBXDCI, and Adreno 650 DMA transfers.
Development findings
- 2026-11-08 Configured Apps SMMUv2 (0x15000000) Stage-1 1 GiB block identity map with MAIR0=0xff (Normal Write-Back Inner-Shareable) on Context Bank 71 for USB0 SID 0x0 hardware cache-coherent AppleUSBXDCI DMA, and added PCIe0 SID 0x1c01 Stage-1 mapping in drivers/ShengUfs/SmmuTakeover.h.
- 2026-11-06 Removed historical October 2026 MMU bring-up logs from docs/ and research/.
- 2026-11-05 Fixed Apps SMMU S2CR takeover to preserve non-UFS stream mappings (including USB0 SID 0x0000) while keeping UFS SID 0x0060 in bypass.
Completion criteria
- XNU 4 KiB page tables, Apps SMMU bypass/Stage-1 coherent mappings for UFS/USB0/PCIe0, and ArmSmmu4K Stage-1 translation for Adreno 650 operate without faults.
Current limits
- Apps SMMU uses S2CR bypass for UFS and Stage-1 identity map on CB 71 for USB0 while GPU uses dedicated 4K Stage-1 pagetables.
Next action
- Keep SMMU stream IDs documented in package/SmmuBypass.h and dts/j716f.dts.
Evidence
device: Zero Apps SMMU or GPU SMMU translation faults across concurrent UFS APFS reads, GPU command submission, and USB0 CDC-ACM transfers. Command:Boot TB-J716F with UFS root, Adreno 650 DMA, and USB0 DWC3 DMA active; inspect SMMU fault registers over USB CDC-ACM.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.source: Declares the 0x80000000..0x1c0000000 contiguous memory range and 0x9c000000 framebuffer reservation.
Storage and root
device-verified
Components: ShengUfs, RamBlock, VerifiedRoot, VirtioMmioBlock.
Hardware and dependencies
- SM8250 UFS 3.1 host controller at 0x01d84000 (IRQ 297), Apps SMMU SID 0x0060, and iPadOS 17.7.11 APFS container on UFS userdata.
Configuration
- Selected ShengUfs in board.toml with [userdata] GPT geometry (first_lba = 2315048, last_lba = 30693370, lba_bytes = 4096), native-ufs-root=1, root-unverified=1, and sheng-data-persist=2.
Procedure
- Build libShengUfs.a via scripts/build-arm-driver.py ShengUfs and boot into the APFS root and persistent Data volumes on UFS.
Development findings
- 2026-11-09 Extended ShengUfs GPT partition reader and persistent /private/var/ngpu addon staging to provision QCA6390 modem_a/bluetooth_a firmware and wifi-bin/bluetooth-bin userland overlays.
- 2026-11-08 Added native_ufs_part_find/native_ufs_part_read GPT partition helpers in drivers/ShengUfs/NativeUfs.cpp and distinct union mount f_fsid xor in vfs_syscalls.c so AppConduit and lockdownd see distinct filesystem IDs.
- 2026-11-06 Consolidated UFS driver directory to canonical drivers/ShengUfs and removed duplicate drivers/J716FUfs.
- 2026-11-04 Verified SM8250 UFS 3.1 link re-init, APFS root mount, SystemOS union mount, and persistent Data overlay on TB-J716F.
Completion criteria
- Native UFS 3.1 block driver mounts the iPadOS 17.7.11 APFS root filesystem and persistent Data volume reliably.
Current limits
- Requires an initialized APFS container on the UFS userdata partition and --data-ramdisk seed during payload packaging.
Next action
- Maintain ShengUfs compatibility with upstream storage ABI updates.
Evidence
device: SM8250 UFS 3.1 controller at 0x01d84000 initializes cleanly and mounts OS, SystemOS, and persistent Data volumes. Command:Boot TB-J716F with native-ufs-root=1 and sheng-data-persist=2; verify APFS root and Data mounts.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: libShengUfs.a builds with -Werror and passes the arm64 Mach-O object audit. Command:python3 scripts/build-arm-driver.py ShengUfs. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Display
device-verified
Components: GopFramebuffer.
Hardware and dependencies
- 2560x1600 BGRX8888 UEFI GOP scanout aperture at 0x9c000000 (stride 10240) and SM8250 MDSS DPU/DSI.
Configuration
- Enabled GopFramebuffer, CONFIG_XNU_NATIVE_LEGACY_DISPLAY=y, display-scale = 2, sheng-vsync=60, sheng-fb-gpu=1, and sheng-backlight=1 in board.toml with backlight-control = true on display0.
Procedure
- Build libNativeLegacyDisplay.a via scripts/build-gop-legacy-display.py and verify WindowServer/SpringBoard presentation and Control Center brightness slider on the 2560x1600 panel.
Development findings
- 2026-11-08 Implemented AppleARMBacklight (ShengBacklight with .bss vtable override) + BacklightMode.m (initBLControl mode 3->1) and Adreno 650 copy_rows compute shader brightness scaling (0..256 scale + 0-nit sleep blanking) on TB-J716F.
- 2026-11-05 Enabled GPU hardware scanout blitter (sheng-fb-gpu=1) and display power re-arm across lock/wake cycles on TB-J716F.
- 2026-11-04 Verified 2560x1600 @ 2x Retina desktop rendering and vsync pacing via GopFramebuffer.
Completion criteria
- IOMobileFramebuffer and AppleARMBacklight publish the 2560x1600 display to WindowServer/CoreBrightness and present GPU-rendered frames at 60 FPS with live brightness control.
Current limits
- Uses the bootloader-initialized 2560x1600 DSI panel mode without runtime refresh-rate switching.
Next action
- Investigate native MDSS brightness control integration.
Evidence
device: WindowServer and SpringBoard render artifact-free at 2560x1600 (2x scale) with GPU scanout presentation and lock/wake recovery. Command:Query display and gpu.status over USB CDC-ACM and capture live 2560x1600 desktop via screen.snapshot.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: GopFramebuffer request-state unit test passes under GCC and Clang with -Werror. Command:clang -std=c11 -O2 -Wall -Wextra -Werror -I drivers/GopFramebuffer drivers/GopFramebuffer/Test/request-state.c -o /tmp/gop-test && /tmp/gop-test. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Input
device-verified
Components: ShengHidInput, ShengNovatekTouch, QcomGeniSpi.
Hardware and dependencies
- Goodix GT7386 I2C controller on QUPv3 SE11 (0x00990000, addr 0x5d, packet 0x01d8) and PM8150/PM8150B PON keys (Power, Volume Up, Volume Down).
Configuration
- Enabled ShengHidInput, offline-hid-input=1, offline-hid-home=1, sheng-touch-hid=1, j716f-touch=1, and pipa-buttons=1 in board.toml.
Procedure
- Build ShengHidInput and verify 10-finger multi-touch gestures and physical Power/Volume buttons in iPadOS.
Development findings
- 2026-11-06 Removed standalone host unit test files from package/.
- 2026-11-04 Implemented rolling 0..255 Goodix GT7386 tracking-ID slot mapper and verified 10-finger multi-touch and PON button wake/sleep on TB-J716F.
Completion criteria
- Multi-touch gestures, keyboard typing, and physical Power/Volume buttons operate smoothly across lock/wake cycles.
Current limits
- Polls QUPv3 SE11 I2C FIFO and SPMI PON status without GPIO interrupt wake.
Next action
- Keep touch coordinate scaling aligned with display-rotation = 0.
Evidence
device: Goodix GT7386 10-point multi-touch and PMIC PON buttons deliver accurate HID events with zero stuck touches. Command:Test multi-touch gestures, Control Center swipe, and Power/Volume buttons on TB-J716F desktop.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: libShengHidInput.a builds with -Werror and passes the arm64 Mach-O object audit. Command:python3 scripts/build-sheng-hid-input.py. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
GPU
device-verified
Components: AdrenoPM4, AdrenoFirmware, ArmSmmu4K, AirNir.
Hardware and dependencies
- Qualcomm Adreno 650 GPU (patchid 06050002, 670 MHz top OPP), GMU Cortex-M3 firmware (a650_gmu.bin), SQE microcode (a650_sqe.fw), and TZ PAS 13 Zap shader (a650_zap.mbn).
Configuration
- Enabled CONFIG_XNU_NATIVE_ADRENO=y, pipa-gpu=12, pipa-gpu-dcvs=1, sheng-gpu-addon=1, sheng-fb-gpu=1, and sheng-tum=s in board.toml and j716f_defconfig.
Procedure
- Build libAdreno650.a via scripts/build-adreno650.py and package the NGPUADD2 GPU addon via scripts/build-j716f-gpu-addon.py.
Development findings
- 2026-11-09 Bundled Wi-Fi (unixnu-wpa_supplicant) and Bluetooth (BlueTool, bluetoothd) userland payloads in scripts/build-j716f-gpu-addon.py and refined NativeOsLogExport.mm.
- 2026-11-08 Enabled Adreno 650 GMU HFI dynamic frequency scaling (pipa-gpu-dcvs=1, 305..670 MHz), Turnip disk shader cache (MESA_SHADER_CACHE_DIR), NativeMetalWithhold=apple-families, and wildcard third-party app GPU sandbox access on TB-J716F.
- 2026-11-06 Removed obsolete patches/mesa directory (Turnip SYSMEM fix is built into the staged GPU addon).
- 2026-11-05 Verified full Adreno 650 hardware acceleration (pipa-gpu=12, Turnip sysmem,nocb, 1x single-sample override, 54 us/draw, 60 FPS desktop rendering) on TB-J716F.
Completion criteria
- Adreno 650 KMD, GMU, CP ring0, GPU SMMU 4K context banks, and NativeAdrenoMetal/Turnip userspace driver render iPadOS at 60 FPS.
Current limits
- Uses Turnip sysmem,nocb mode with 1x MSAA override for optimal Adreno 650 stability and frame pacing.
Next action
- Evaluate GMEM tile rendering paths for third-party Metal 3D workloads.
Evidence
device: Adreno 650 KMD and NativeAdrenoMetal/Turnip execute thousands of hardware draw calls at ~54 us/draw with zero GPU faults or pagefaults. Command:Run gpu.status over USB CDC-ACM while interacting with SpringBoard, Settings, and Dock animations on TB-J716F.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Builds libAdreno650.a and stages the NGPUADD2 GPU addon bundle with verified firmware SHA-256 digests. Command:python3 scripts/build-adreno650.py && python3 scripts/build-j716f-gpu-addon.py. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Network
device-verified
Components: Ath12kWifi, QcaBluetooth.
Hardware and dependencies
- Qualcomm QCA6390 Wi-Fi 6 (PCIe0 RC 17cb:1101) and Bluetooth 5.1 (QUPv3_0 SE6 GENI UART 0x998000).
- ZUI 15.0.485 firmware partitions modem_a/b (image/qca6390/{amss20.bin,m3.bin,bdwlan.elf}) and bluetooth_a/b (image/{htbtfw20.tlv,htnv20.bin}).
Configuration
- board.toml includes Ath12kWifi and QcaBluetooth components with sheng-wifi=4 and sheng-bluetooth=1 boot-args.
- ShengUfs maps a 128 MiB stage-1 SMMU IOVA window at 0x10000000 for PCIe0 stream ID 0x1c01 and exports native_ufs_part_find/native_ufs_part_read.
- Sm8250GeniUart drives QUPv3_0 SE6 (0x998000, wrapper 0x9c0000, SID 0x5a3, GIC SPI 639) with GCC RCG 0x17730 at 300 MHz (GPLL0_OUT_EVEN) for 115200 and 3.2 Mbps H4 HCI.
Procedure
- Vote 9 PM8150/PM8150A/PM8150L RPMh rails and assert BT_EN (GPIO 21) and WLAN_SW_CTRL (GPIO 20) via WcnPower.h.
- Bring up SM8250 PCIe0 RC (0x1c00000), Gen3x1 QMP PHY (0x1c06000), DBI ATU config/MMIO windows, and MHI AMSS PBL->SBL->RDDM/Mission boot for QCA6390 (17cb:1101), registering ShengWLANController/en0 and org.unixnu.wifi.control.
- Load QCA6390 Bluetooth TLV/NVM (htbtfw20.tlv, htnv20.bin) over QUPv3_0 SE6 via QcaBluetooth (soc_type QCA_QCA6390=8) and bridge H4 HCI over com.apple.uart.sk.bluetooth to BlueTool and bluetoothd.
Development findings
- 2026-11-09 Verified QCA6390 PCIe0 MHI AMSS Mission Mode (ee=2, state=2) with en0 + org.unixnu.wifi.control + wifid + unixnu-wpa_supplicant active, and QCA6390 UART6 Bluetooth at 3.2 Mbps with BlueTool + bluetoothd (exit=0/0) receiving live BLE Advertising Reports after intercepting 0x204a to prevent Bluetooth 5.0 Extended Advertising lockout.
- 2026-11-07 Integrated QcaBluetooth (QUPv3_0 SE6 GENI UART + QCA_QCA6390 TLV/NVM loader from UFS bluetooth_a) and Ath12kWifi/QCA6390 PCIe0 + MHI + nw_abi transport into libNativeLegacyDisplay.late.a.
- 2026-11-04 Recorded QCA6390 BDF and amss.bin SHA-256 digests from ZUI 15.0.485 in proprietary-files.txt.
Completion criteria
- Wi-Fi (en0, wifid, unixnu-wpa_supplicant) and Bluetooth (com.apple.uart.sk.bluetooth, BlueTool, bluetoothd) initialize QCA6390 firmware and operate continuously in iPadOS 17.7.11.
Current limits
- QCA6390 ath11k QMI/WMI scan and data-plane rings behind MHI AMSS Mission Mode require ath11k CE/DP wiring for live 802.11 association.
Next action
- Implement QCA6390 ath11k QMI/WMI scan result and data-plane ring forwarding into WifiNet.
Evidence
device: QCA6390 MHI enters Mission Mode (ee=2, state=2) with en0/wifid/unixnu-wpa_supplicant running, and QCA6390 UART6 runs at 3.2 Mbps with BlueTool + bluetoothd (exit=0/0) receiving live BLE Advertising Reports. Command:Query bt and wifi over USB CDC-ACM (1209:0001) on TB-J716F with sheng-wifi=4 and sheng-bluetooth=1.. Revision:6f20d189efb0608e0350679115689b37592270c7.source: Records ZUI 15.0.485 QCA6390 Wi-Fi/BT firmware SHA-256 digests.host: Builds libQcaBluetooth.a, libAth12kWifi.a, and links SM8250 QCA6390 Wi-Fi/Bluetooth probes into libNativeLegacyDisplay.late.a. Command:python3 scripts/build-qca-bluetooth.py && python3 scripts/build-ath12k-wifi.py && python3 scripts/build-gop-legacy-display.py. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Audio
planned
Hardware and dependencies
- Qualcomm ADSP PAS, SoundWire, WCD938x codec, and quad speaker amplifiers.
Configuration
- ADSP audio firmware digests are recorded in proprietary-files.txt; audio driver is not yet enabled.
Procedure
- Implement ADSP remoteproc/GPR audio routing or USB audio support.
Development findings
- 2026-11-08 Preserved ADSP PIL reserved memory region and audio firmware manifest during SM8250 device tree updates for display backlight and QCA6390 Wi-Fi/BT.
- 2026-11-04 Recorded ZUI 15.0.485 ADSP firmware digests in proprietary-files.txt and suppressed BTAudioHALPlugin crash via text_fixups.
Completion criteria
- IOAudio2Family / AppleAudioClockLibs output PCM audio to speakers or headphones.
Current limits
- Onboard speaker and headphone audio are not yet implemented.
Next action
- Evaluate ADSP Q6AFE audio playback bring-up.
Evidence
Power
device-verified
Hardware and dependencies
- PM8150B Fuel Gauge (SID 2, 0x4000..0x4400) and SMB5 Charger (0x1000..0x1600) over SPMI arbiter 0x0c400000, plus RPMh arc/vrm resources.
Configuration
- Built NativeBattery.cpp into libBootProgress.a and ShengPlatformPower.cpp into libPlatformPower.a with sheng-pmgr=2 and pipa-wd=0.
Procedure
- Verify IOPMPowerSource battery percentage, voltage, current, temperature, and charging status on the iPadOS status bar and Settings -> Battery.
Development findings
- 2026-11-08 Added PM8150B FG open-circuit voltage fallback (3350..4350 mV -> 5..100%) when MSOC reads 0% after deep discharge and filtered uncalibrated SRAM temperature words outside 5..55 C in NativeBattery.cpp.
- 2026-11-05 Verified PM8150B FG / SMB5 SPMI battery gauge publishing live SoC, voltage, current, and charging status to IOPMPowerSource on TB-J716F.
Completion criteria
- iPadOS status bar and Settings display accurate real-time battery percentage and charging state.
Current limits
- System deep sleep (S3/XO shutdown) remains disabled; screen lock/unlock blanks and restores the display.
Next action
- Monitor battery gauge accuracy across full charge/discharge cycles.
Evidence
device: PM8150B FG and SMB5 SPMI telemetry reports live SoC (%), voltage (mV), current (mA), and charging state to IOPMPowerSource. Command:Query battery.status over USB CDC-ACM and inspect iPadOS status bar battery indicator on TB-J716F.. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Qualcomm RPMh power resource driver compiles cleanly under GCC and Clang with -Werror. Command:clang -std=c11 -O2 -Wall -Wextra -Werror -c package/QcomRpmh.c -o /tmp/qcom-rpmh.o. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Image assembly
device-verified
Components: XnuPrelink, DarwinBoot.
Hardware and dependencies
- Prelinked iPadOS 17.7.11 kernel.macho, Format 2 kernel.macho.adt, trust caches, NGPUADD2 GPU addon, Data ramdisk seed, SILICIUM_UEFI.fd, and j716f.dtb.
Configuration
- Standard scripts/package.sh drives ./unixnu release -D UniXNU-j716f with canonical kits/XnuPrelink/emit_prelink.py to assemble the 96 MiB FAT payload and Android header v2 boot.img.
Procedure
- Run bash scripts/package.sh --no-deps --uefi ../uefi-j716f with UNIXNU_UNIQUE_CHIP_ID set.
Development findings
- 2026-11-09 Updated j716f-cryptex-os-view-always.patch and j716f-appsync-and-sandbox-wildcard.patch to union-mount /private/var/ngpu/wifi-bin onto /usr/libexec (sheng-wifi>=4) and /private/var/ngpu/bluetooth-bin onto /usr/sbin (sheng-bluetooth>=1).
- 2026-11-08 Integrated UniXNU AppSync kernel dynamic user-code trust cache (appsync=1) + userland runtime (UniXNUAppSync.dylib with LC_REEXPORT_DYLIB for Foundation, unixnu-ldid, unixnu-appinst, installd, backboardd, MobileInstallationHelperService) and union-mounted OS staged_system_apps over /Applications (owner-staged-apps=1).
- 2026-11-07 Rebuilt 53,497,856-byte kernel.macho (SHA-256 b16a5b85...), 96 MiB payload.img (SHA-256 49dbfb52...), and 102,453,248-byte boot.img (SHA-256 2fa05eaf...) with Ath12kWifi and QcaBluetooth integrated.
- 2026-11-06 Added native_aks_device_id in package/KeyStoreProbe.cpp for AppleKeyStoreState 8c70daf8 software keychain wrapping and rebuilt boot.img against UniXNU
e2fdae4.
Completion criteria
- scripts/package.sh builds kernel, package, firmware, payload, and Android header v2 boot.img in a single command.
Current limits
- Requires IPSW caches, Data ramdisk seed, and UNIXNU_UNIQUE_CHIP_ID at packaging time.
Next action
- Keep package.yml workflow aligned with upstream UniXNU release flags.
Evidence
device: Packaged Android v2 boot.img boots cleanly on TB-J716F Slot B into iPadOS 17.7.11. Command:bash scripts/package.sh --no-deps --uefi ../uefi-j716f && fastboot flash boot_b boot.img. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: Standard UniXNU packaging preflight and patch plan check succeed. Command:bash scripts/package.sh --check --no-deps. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.
Diagnostics
device-verified
Hardware and dependencies
- SM8250 DWC3 USB0 controller at 0x0a600000 (GIC SPI 133, Apps SMMU SID 0x0), QMP USB3 PHY, SNPS Femto v2 HS PHY at 0x088e3000, and ramoops region at 0xb0000000.
Configuration
- Enabled j716f-usb=1, sheng-aks-sls=3, and boot-progress=2 in board.toml, compiling UsbDebugCdc.cpp and BootRamoops.c into libBootProgress.a and QcomDwc3.cpp / UsbProbe.cpp (with scripts/usb-xdci-21H461.json ABI) into libNativeLegacyDisplay.late.a.
Procedure
- Connect TB-J716F to host PC via USB-C, query the 1209:0001 CDC-ACM serial interface (status, display, gpu.status, battery.status, screen.snapshot, reboot.fastboot), and send usb.xdci or usb.xdci.30 to switch to native AppleUSBXDCI (05ac:12ab) for AppleUSBDeviceMux and lockdownd pairing.
Development findings
- 2026-11-09 Enabled com.apple.bluetoothd in package/BootWatchdogPolicy.c when sheng-bluetooth>=1 and exposed live wifi/bt status commands over USB CDC-ACM.
- 2026-11-08 Verified native QcomDwc3 / AppleUSBXDCI (VID 05AC PID 12AB) enumeration, Apps SMMUv2 CB 71 Normal Write-Back Inner-Shareable DMA identity map, AppleUSBDeviceMux high-speed bulk transport (1349 reads / 810 writes / 0 errors), and passcode-free lockdownd pairing (sheng-aks-sls=3 + distinct union f_fsid) via usb.xdci.30 and persistent usb.xdci on TB-J716F.
- 2026-11-06 Updated scripts/check-j716f.py preflight and verified full kernel/boot.img rebuild against upstream UniXNU
e2fdae4. - 2026-11-05 Verified live USB CDC-ACM telemetry, GSC1 2560x1600 framebuffer capture, and one-command reboot.fastboot into bootloader fastboot.
Completion criteria
- USB0 DWC3 supports both CDC-ACM diagnostic console (with ramoops panic logger and remote fastboot recovery) and runtime handoff to native AppleUSBXDCI (05ac:12ab) for iPadOS USB mux and lockdownd host pairing.
Current limits
- USB0 boots in high-speed CDC-ACM diagnostic mode while j716f-usb=1 is set and transitions on demand to native AppleUSBXDCI via usb.xdci or usb.xdci.30.
Next action
- Maintain USB CDC-ACM diagnostic commands and native AppleUSBXDCI handoff for ongoing subsystem bring-up.
Evidence
device: USB0 enumerates reliably as J716FDBG01, streams live kernel/GPU/battery telemetry and GSC1 screenshots, and reboots into Fastboot on command. Command:Send status, gpu.status, battery.status, screen.snapshot, and reboot.fastboot over USB CDC-ACM (1209:0001).. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.host: libBootProgress.a compiles UsbDebugCdc.cpp, BootRamoops.c, and NativeBattery.cpp cleanly with -Werror. Command:python3 scripts/build-boot-progress.py. Revision:38cd04f4301a9a160f82fba98190276ccc9e35b0.