v0.6.0 — 原生指纹登录、DP 外屏与双系统修复

v0.6.0 — 原生指纹登录、DP 外屏与双系统修复

本版将已完成的设备支持整合进完整安装包：匹配的内核、系统、安装器及双系统辅助工具。

• 原生指纹：Ubuntu“设置 → 系统 → 用户”录入，正常登录及锁屏使用系统认证；目前支持第一个普通账号（UID 1000）的一枚指纹。修复采样重试被误报为致命错误、模板权限不匹配导致匹配成功仍无法解锁的问题。
• USB-C DisplayPort：接入外屏所需的 PHY、方向切换和 AUX 处理，已测显示器/转接器可输出画面并在拔插后恢复内屏和 USB。
• 双系统：继续两个系统共用 A 槽、切换 boot.img 的方案；安装器核对并修复所需的原厂 Android 固件分区。包内提供 KernelSU 返回 Ubuntu 模块及固定版本下载/补丁工具。
• 首次启动接入：指纹不再绑定开发机用户名；所需 OEM TA 从本机原厂固件分区只读提取并核验，不分发测试机数据或指纹固件二进制。

安装材料

下载同一版本全部附件，将 rootfs.tar.gz.part-* 合并成 rootfs.tar.gz 后核对 SHA256SUMS，按 INSTALL-TESTING.zh-CN.md 操作。fingerprint-build-inputs.tar.gz 是公开程序/对应源码构建输入，已经包含在镜像的指纹包中，普通使用不需另行安装。dualboot-tools.zip 包含主机辅助工具；KernelSU 上游管理器/组件通过附带脚本按固定版本下载校验。

仅支持已知的 Xiaomi Pad 6 Pro / liuqin 256 GB 分区布局和文档指定的原厂 ROM；其他容量或改过的布局未验证。首次安装会改分区并清数据。--keep-home 只保留独立 /home，仍会重建 Ubuntu 系统分区；已有指纹的系统重装前还需保留系统中的账号和指纹私态，不能把它当完整系统升级。个人文件、密码、指纹模板、密钥及每机校准不在发布包内。

本机验证

• 已完成：组合内核在开发机持久启动；原生录入、已录手指接受/未录手指拒绝、锁屏与正常重启后 GDM 指纹登录；同一组合内核外屏及 USB 恢复。
• 已完成：公开指纹输入与 Debian 包的文件闭包/确定性检查、UID1000授权及固件只读提取；新固件提取路径已在真实 modem 分区验证。
• 已完成：2026-10-08 在已知 256 GB 开发机执行完整双系统安装，按维护者要求使用 --keep-home --no-backup，保留独立 /home，重建 Ubuntu 系统分区。A/B 镜像回读匹配，首次启动自动取固件和指纹模块服务正常；用户完成首次设置、进入桌面并确认功能正常。
• 指纹的录入、正反例、锁屏与重启登录以及 DP 实际画面，有此前同一组合内核的专项验证记录；本次重装未逐项重新采集所有专项日志，不将它表述为完整硬件回归矩阵。

已知范围

多指、多用户、其他显示配件、DP 音频/高刷、长期挂起稳定性及 Linux 指纹建立后的 Android 安全存储往返不在本轮验证范围。指纹登录不会解密密码保护的 GNOME 密钥环，应用访问其中秘密时仍可能请求密码。较早的 b87 开发测试曾发生一次原因未明的硬复位；本轮组合内核验证未复现，不能视为根因已经修复。

本版作为正式 GitHub Release 发布；项目仍是实验性设备移植，上述单台设备验收不代表全部硬件批次兼容。

v0.5.0 — 双系统、后置摄像头与扬声器修复

Xiaomi Pad 6 Pro（liuqin）Ubuntu 26.04 移植，第七个预发布，取代已撤回的 v0.4.0。内核 6.17.0-rc1-gaa148f3421f8，主仓 982767b。

本版变化（相对 v0.3.1）

v0.4.0 已撤回，以下列出相对 v0.3.1 的全部变化。

• 双系统：--layout dual 在保留 A 槽原厂 Android（OS2.0.6.0.VMYCNXM）的同时安装 Ubuntu，两个系统都从 A 槽启动。切换时把另一系统的启动镜像整分区写入 boot_a，回读核对一致后才重启；写入失败或核对不一致时写回原镜像并停止，不重启平板。切换不改变活动槽位。boot_b 保存一份 Ubuntu 启动镜像，boot_a 无法加载时由引导程序自动回退到该副本。当前未使用的启动镜像保存在 Ubuntu 系统分区的 /var/lib/liuqin/switch/ 中，由安装器一并写入。
• 系统切换：在 Ubuntu 中，从应用列表打开"重启到 Android"（需输入管理员密码），或使用 liuqin-switch（status、verify、to-android、import-android）。Android 侧提供由 tools/build-ksu-module.sh 构建的 KernelSU 模块 liuqin_boot_ubuntu，包含"重启到 Ubuntu"按钮与 boot-ubuntu 命令，并在每次启动时停用 Android 系统更新，以免系统更新覆盖 B 槽中的 Ubuntu 回退镜像。
• Android 启动镜像：--android-boot 可指定经 KernelSU（v3.3.0）补丁的 Android 启动镜像，补丁由 tools/patch-android-boot-ksu.py 在电脑上完成；安装后也可用 liuqin-switch import-android 导入。原厂镜像不随本项目分发。
• 分区布局：安装器提供两种布局。--layout linux-only 删除 Android 数据分区，把磁盘尾部全部交给 Ubuntu，Ubuntu 从 B 槽启动，A 槽保持不变；--layout dual 保留 A 槽的原厂 Android 及其数据分区。两种布局都把 Ubuntu 系统与用户数据分开：系统位于 linux_root，/home 位于 linux_home。
• 分区尺寸：--android-size 与 --root-size 接受 NNG 或百分比。默认值：双系统为 Android 96 GiB、系统 32 GiB；单系统为系统 32 GiB；其余空间均归 /home。所有边界按 4 MiB 对齐，userdata 只在原位缩小并保留原有标识；超出可行范围的尺寸在接触设备之前即被拒绝，并给出可行范围。
• 分区表保护：修改前备份并校验两份分区表，修改后回读并与计划逐项比对；--restore-partition-table 可写回备份的分区表。恢复时分区表按安装环境命令行长度上限分段传输，任何超出上限的远程命令都会在发送前被拒绝。
• 保留 /home 重装：在已采用本项目分区布局的设备上，--keep-home 只重装系统分区并保留 /home。格式化任何分区之前，安装器先确认 linux_home 为原有的 LIUQIN_HOME 文件系统并通过 e2fsck -p 检查，不满足时停止安装；只有空的 /home 才会写入默认内容。已撤回的 v0.4.0 中该选项仍会格式化 /home，本版已更正。
• 启动镜像写入：安装器把项目启动镜像零填充至整个 boot 分区（192 MiB）后写入 boot_a 与 boot_b，使切换工具能够按整个分区识别当前镜像。手动修复时同样需要零填充，命令见 INSTALL-TESTING.zh-CN.md。
• 后置摄像头（实验功能）：后置摄像头（三星 S5KJN1，5000 万像素）可在"相机"应用（GNOME Snapshot）中预览、拍照和录像。图像由 libcamera 软件 ISP 在 CPU 上处理，没有自动对焦与校准调校，也不使用硬件编码；画面比原厂系统偏软，录像中的运动画面有卡顿。前置摄像头尚未启用。镜像预装诊断工具 cam（libcamera-tools）与 media-ctl、v4l2-ctl（v4l-utils）。详见 docs/CAMERA.zh-CN.md。
• 扬声器：修复全新安装后桌面只显示"虚拟输出"（Dummy Output）、内置扬声器无声的问题（issue #10）。录音前端的路由改为在整个 HiFi 配置期间保持连通，不再依赖此前保存的混音器状态。
• 触控笔：笔的坐标改为按与手指相同的比例换算；此前所有笔输入都落在屏幕右下角。
• 传感器处理器：存在空文件 /etc/liuqin-slpi-disabled 时，系统不启动传感器处理器（SLPI），供启动 SLPI 会导致重启的设备使用，详见"已知问题"。
• 启动：启动阶段按启动参数识别当前槽位并标记启动成功；/home 分区与系统分区一同放行读写，存储保护服务在 /home 挂载完成后执行。
• 内核：6.17.0-rc1-gaa148f3421f8（liuqin-6.17 分支），新增后置摄像头所需的相机时钟控制器、CAMSS、CCI 与 S5KJN1 驱动及相应内核配置，并包含上述触控笔修正。

真机验证

在 256 GB 开发机（硬件版本 16.9.0）上验证。该机此前已采用双系统布局，本次以 --layout dual --keep-home 重装：原厂线刷包按固定校验值核对通过，保留原有分区尺寸与 /home，写入 super（其余 A 槽原厂镜像与设备现有内容一致，按设计跳过），安装 Ubuntu，把零填充的启动镜像写入 boot_a 与 boot_b 并选择 A 槽，全程约 7 分钟。

• 启动与切换存储：从 A 槽启动 Ubuntu，持久根校验通过，重装前的 /home 内容保留；liuqin-switch status 与 liuqin-switch verify 确认 boot_a 中为切换存储内的 Ubuntu 镜像，存储中的 Ubuntu 与 Android 启动镜像均校验通过。
• 音频：重装后首次启动，四个扬声器功放均完成校准加载，录音前端路由处于连通状态；维护者人耳确认内置扬声器正常出声。
• 传感器：SLPI 由系统服务正常启动，SLPI、ADSP、CDSP 三个远程处理器均在运行，iio-sensor-proxy 运行正常。
• 摄像头：相关驱动模块加载，cam -l 列出后置摄像头，media-ctl 显示传感器与采集节点；枚举结束后相机电源域回到关闭状态；cam 连续采集 3 帧，帧率约 30 fps；维护者在"相机"应用中确认预览正常。
• 系统：没有失败的系统服务；USB 网络、触摸屏、触控笔输入设备、键盘与按键均正常枚举。

本版未验证的部分：首次启动时的 GNOME 初始设置（创建用户）；A 槽 Android 的首次启动、KernelSU 镜像导入，以及两个系统之间任一方向的切换和切换后的冷启动；本版镜像中"相机"应用的拍照与录像；触控笔在真机上的使用；单系统布局的真机安装；--restore-partition-table 的真机恢复；128 GB 与 512 GB 机型。

从 v0.3.x 或 v0.4.0 升级

• v0.3.x：本版改变了分区布局，需要全量安装，安装会清除 userdata；不提供从 v0.3.x 原地升级的路径。
• v0.4.0（已撤回）的双系统安装：此类安装从 B 槽启动 Ubuntu，且没有切换存储。使用本版安装器加 --keep-home 重装系统，即可保留 /home 并改为从 A 槽启动，命令见 INSTALL-TESTING.zh-CN.md"双系统切换"一节中的"升级早先的双系统安装"。请务必使用本版安装器：v0.4.0 安装器的 --keep-home 会格式化 /home。
• 不要把本版的 boot.img 刷入旧版本系统：启动镜像会校验已安装系统的关键文件，两者不一致时会停在启动诊断界面；刷回原版本的 boot.img 即可恢复。本版 boot.img 只与本版安装的系统配合使用。

已知问题

• 在部分设备上，启动传感器处理器（SLPI）会导致平板重启（issue #10），原因仍在调查。受影响的设备可创建空文件 /etc/liuqin-slpi-disabled（例如 sudo touch /etc/liuqin-slpi-disabled）后重启，系统将不再启动 SLPI，期间自动旋转不可用；删除该文件并重启即可恢复。请勿修改 /etc/systemd/system/liuqin-slpi.service：启动镜像会校验该文件，修改后系统将无法启动。
• 部分安装中 console-setup.service 显示为启动失败（生成控制台键盘布局时缺少所需文件）。该服务只影响文本控制台，不影响图形桌面与键盘输入。
• 锁屏或合盖长时间休眠后可能无法唤醒，需长按电源键强制重启；该问题在专项排查中。
• 平板 USB 先连接充电器再连接电脑时，数据线可能无法完成枚举；强制重启平板可恢复。
• 热重启后屏幕偶发全屏花屏；完全关机后再开机可恢复。
• 其余三颗板载麦克风（AMIC3/4/5）与多麦降噪尚未接入。
• 使用小米适配器或 PPS 适配器的快充尚未确认。
• 尚不支持经 USB-C 连接外接显示器。

安装

全量安装会清空 userdata，请提前备份。下载全部附件后按 INSTALL-TESTING.zh-CN.md 执行；rootfs 分卷先合并：cat rootfs.tar.gz.part-* > rootfs.tar.gz，再以 sha256sum -c SHA256SUMS 核对。双系统布局另需自备原厂线刷包 OS2.0.6.0.VMYCNXM。

来源与校验

项	值
主仓提交	982767b1cd22526f24a4a64e89d3b0d6891ea6fa
内核提交（linux-sm8450-liuqin，liuqin-6.17）	aa148f3421f8f52fcb2ede684cf31adb20572b1d
内核版本	6.17.0-rc1-gaa148f3421f8
内核配置 SHA256	9571ee93d6b4718ad3958ea64b748dd332553d36f8893cacc81d72c07a34ed8e
启动镜像校验的系统文件清单（native-root contract）SHA256	2d9ac33a7ebb4202c12b177cf883c29d7372e34665a0a3bf77c0a3101997b136
boot.img 零填充至 201326592 字节后的 SHA256	81b530fb58352b646b4c3beffbb8d7926eeacdce7bf99d2e899d1be44bd93374
双系统所需原厂线刷包	OS2.0.6.0.VMYCNXM，各镜像校验值见 liuqin-rom-images.json

附件	SHA256
boot.img	99edc4012f1bccd34b0c9094e2519e677400aa1162be558366fc9884e17e893c
installer.img	acb5b87973ebc68efd325869c16ecd17abe79fbb7c36f7b693b537ecc53de6c7
rootfs.tar.gz（由 rootfs.tar.gz.part-00 至 part-02 合并）	aca695ee59d0ddc31e19b68b1861af8263e5da3080969af84a4e84eb5e06ae79
install.py	a240276189bf530b77a8637308c66da240bbca2073d7cc600942da2810c33690
liuqin_layout.py	d2056be3f2552f10b8d9fdb1bfa0de259f8edac3c06f34a7a3eb7aa9eefb3a34
liuqin-rom-images.json	0f9d33ea789bda69754f445375949e8b7d7678f6cb71e8dc55955beb7d58ecfd
INSTALL-TESTING.md	a390ab2661a8858cfca307565e35d2458efc400bc57d44f3042a6694581d0363
INSTALL-TESTING.zh-CN.md	18dd76a7740b6069d42b3bbd1673e65a9c46e50ea198575a0eddb8f1d8dd6373
NOTICE	d193ecf4ac63e8d3763c32b5a43d0e43b05c0fb6f485d5516720b6bfbb625bfb
LICENSE	b9d8b4bd86feb7e54d8c272e786f859209bd6053e880d1fbd6733e16418db881
bundle.json	c2df75febce9e253ca85c83e1576b74dc07a31ed322691001b11b311240efb1a

致谢

• 后置摄像头支持由 reisa 贡献（pull request #8）。
• 扬声器修复采用的路由改动由 @yuzelingsha 提出；@ottoskyer 在 issue #10 中报告问题并完成验证。
• 触控笔坐标修正来自 @verssionhack（linux-sm8450-liuqin pull request #4）。
• 分区表恢复的分段传输修正来自 @TunJinshou050608（pull request #12）。
• NOTICE 补记 @xiaoabiao 为 liuqin 小米充电认证适配与标准 PPS 开关的作者（pull request #7）。

---

Seventh pre-release of the Ubuntu 26.04 port for Xiaomi Pad 6 Pro (liuqin), replacing the withdrawn v0.4.0; the changes below are listed against v0.3.1. Kernel 6.17.0-rc1-gaa148f3421f8, project commit 982767b.

--layout dual installs Ubuntu next to the stock Android of OS2.0.6.0.VMYCNXM, and both systems boot from slot A. A switch writes the other system's boot image across the whole of boot_a, reads it back and restarts only when it matches; if the write or the comparison fails, the previous image is written back and the tablet is not restarted. The active slot is never changed. boot_b holds a copy of the Ubuntu boot image, to which the bootloader falls back on its own if boot_a does not load. The image not currently installed is kept in /var/lib/liuqin/switch/ on the Ubuntu root, which the installer fills. In Ubuntu, Reboot to Android in the application list (administrator password required) or liuqin-switch (status, verify, to-android, import-android) performs the switch. On Android, the liuqin_boot_ubuntu KernelSU module built by tools/build-ksu-module.sh provides a Reboot to Ubuntu button and a boot-ubuntu command, and disables Android system updates on every boot so that an update cannot overwrite the Ubuntu fallback image in slot B. --android-boot stores a KernelSU (v3.3.0) patched Android boot image produced on the host by tools/patch-android-boot-ksu.py; such an image can also be imported later with liuqin-switch import-android. Stock images are not redistributed.

The installer offers two layouts. --layout linux-only removes the Android data partition, gives the tail of the disk to Ubuntu and boots it from slot B, leaving slot A untouched; --layout dual keeps the stock Android and its data partition in slot A. Both separate the Ubuntu system (linux_root) from user data (/home on linux_home). Sizes are set with --android-size and --root-size, as NNG or a percentage; the defaults are Android 96 GiB and system 32 GiB for the dual layout and system 32 GiB for Linux-only, with /home taking the remainder. Every boundary is aligned to 4 MiB, userdata is only shrunk in place with its identity preserved, and infeasible sizes are refused before any device access. Both copies of the partition table are backed up and verified before the edit and compared with the plan afterwards; --restore-partition-table writes a saved table back, transferring it in pieces that fit the installation environment's command-line limit, and any longer remote command is refused before it is sent. --keep-home reinstalls the system on an existing split layout and keeps /home: before anything is formatted, the installer confirms that linux_home carries the existing LIUQIN_HOME file system and passes e2fsck -p, and stops otherwise; only an empty /home receives the default contents. In the withdrawn v0.4.0 this option still formatted /home. The project boot image is written zero-filled across the whole 192 MiB boot partition so that the switcher can identify it.

The rear camera (Samsung S5KJN1, 50 MP) is available as an experimental feature: preview, photos and video recording work in the Camera application (GNOME Snapshot), processed on the CPU by libcamera's software ISP, without autofocus, calibrated tuning or hardware encoding. Images are softer than on the stock system, motion in recordings stutters, and the front camera is not enabled; see docs/CAMERA.md. A fresh installation no longer ends with only "Dummy Output" and silent interna...

v0.3.1 — 充电认证

Xiaomi Pad 6 Pro（liuqin）Ubuntu 26.04 移植，第五个预发布。内核 6.17.0-rc1-gf2d5ed65ac03，主仓 3a9363d。

本版变化（相对 v0.3.0）

• 充电认证：内核在 PMIC GLINK 电源设备上导出小米充电认证接口；device-support 随附 liuqin-mipps-auth 服务，在检测到 USB 供电时自动运行。电池（电量计）认证已在设备上完成，标准 USB-PD 适配器的充电功率由 9 V / 1.4 A 提升至 9 V / 2 A。
• 同时提供面向非小米品牌适配器的标准 PPS 开关，默认启用，以 PD_PPS 合约与线缆 5 A 额定能力为前提条件。使用说明见 docs/FASTCHARGE.zh-CN.md（英文版 docs/FASTCHARGE.md）。
• liuqin-mipps-auth 服务源自 ianchb 的 xiaomi-mipps-auth（GPL-2.0-only），已在 NOTICE 中记录。
• 内核 f2d5ed65a（liuqin-6.17 分支）。内核配置与 v0.3.0 一致。
• 安装内容其余部分与 v0.3.0 一致。

致谢：本版集成基于 @xiaoabiao 的 pull request #7，其实测数据与电量区间建议已体现在随附文档中。

真机验证

在开发机上经增量升级路径完成验证：刷入 boot 镜像、在设备内原地升级软件包，首次启动持久根校验通过，Wi-Fi、蓝牙、显示、触摸、传感器、麦克风录音，以及 USB 供电下充电服务的运行状态均正常。

本版未验证的部分：小米 MiPPS 快充的端到端链路，以及标准 PPS 开关——验证所需的小米 MiPPS 适配器与 PPS 适配器均不可得；两者均已随本版集成，等待适配器到位后验证。安装器与 v0.2.0 / v0.3.0 逐字节一致，全量安装流程未重复执行。

从 v0.3.0 升级（不清除数据）

1. 在运行中的平板系统内安装升级包：sudo dpkg -i liuqin-kernel_0.1_arm64+v0.3.1.deb liuqin-device-support_0.1_arm64+v0.3.1.deb。
2. 随即进入 fastboot：sudo systemctl reboot bootloader，然后刷入本页附件的 boot 镜像：fastboot flash boot_a boot.img。
3. fastboot reboot。

boot 镜像与已安装的软件包必须相互匹配，因此在第 1 步与第 3 步之间不要执行常规重启；若平板进入诊断 shell，刷入 boot.img 后重启即可。

如需回滚：刷回 v0.3.0 的 boot.img，并重新安装 v0.3.0 的对应软件包，顺序同上。

全新安装：流程与 v0.3.0 相同，按 INSTALL-TESTING.zh-CN.md 执行（安装器未变更）。

已知问题

• 锁屏或合盖长时间休眠后可能无法唤醒，需长按电源键强制重启；该问题在专项排查中。
• 平板 USB 先连接充电器再连接电脑时，数据线可能无法完成枚举；强制重启平板可恢复。
• 其余三颗板载麦克风（AMIC3/4/5）与多麦降噪尚未接入。
• 使用小米适配器或 PPS 适配器的快充尚未确认。
• 2025 年款小米 100 W 适配器与本平板协商为普通 PD。

安装

全新安装会清空 userdata，请提前备份。下载全部附件后按 INSTALL-TESTING.zh-CN.md 执行；rootfs 分卷先合并：cat rootfs.tar.gz.part-* > rootfs.tar.gz。

---

Fifth pre-release of the Ubuntu 26.04 port for Xiaomi Pad 6 Pro (liuqin). This version integrates charger authentication: the kernel exposes Xiaomi's charger-authentication interface on the PMIC GLINK power-supply device, and device-support ships the liuqin-mipps-auth service (derived from xiaomi-mipps-auth by ianchb, GPL-2.0-only, recorded in NOTICE), which runs automatically when USB power appears. Battery (fuel-gauge) authentication completes on the device, and standard USB-PD adapters now charge at 9 V / 2 A instead of 9 V / 1.4 A. A standard-PPS switch for adapters that are not Xiaomi-branded is included and enabled by default, gated on a PD_PPS contract and the cable's 5 A rating; see docs/FASTCHARGE.md. The integration builds on pull request #7 by @xiaoabiao, whose measurements and state-of-charge guidance are reflected in the documentation. The kernel configuration is unchanged from v0.3.0.

Validated on the development tablet via the incremental upgrade path — boot image flashed, root packages upgraded in place, first boot with the persistent-root admission passing, Wi-Fi, Bluetooth, display, touch, sensors, microphone capture, and the charger service running on USB power. Xiaomi MiPPS fast charging end to end and the standard-PPS switch were not validated in this release, as no MiPPS-capable Xiaomi adapter and no PPS adapter were available; both ship integrated and await adapter validation. The installer is byte-identical to v0.2.0 and v0.3.0.

Existing v0.3.0 installations can upgrade in place without erasing user data: install the liuqin-kernel and liuqin-device-support packages in the running system, then enter fastboot with sudo systemctl reboot bootloader, flash the attached boot image to boot_a, and fastboot reboot. The boot image and the installed packages must match, so do not reboot normally between installing the packages and the fastboot reboot; if the tablet enters the diagnostics shell, flash boot.img and reboot. Rolling back means flashing the v0.3.0 boot image and reinstalling the v0.3.0 packages, in the same order. See INSTALL-TESTING.md; a fresh installation erases userdata — back up first.

v0.3.0 — 内置麦克风

Xiaomi Pad 6 Pro（liuqin）Ubuntu 26.04 移植，第四个预发布。内核 6.17.0-rc1-ga974a62a45c5，主仓 d50c9d4。

本版变化（相对 v0.2.0）

• 内置麦克风：板载 AMIC1 麦克风完成 mainline 适配——WCD938x 音频编解码器经 SoundWire 接入 LPASS TX macro，由 ADSP codec DMA 采集，支持 48 kHz 录音。系统内通过 UCM「Mic」设备启用，GNOME 录音机与会议应用经 PipeWire 可直接使用。
• 内核 a974a62a4（liuqin-6.17 分支）：新增麦克风采集链路的设备树描述与 SoundWire 外设使能，并将 LPASS 岛引脚控制器驱动内建。
• 音频拓扑新增采集流与对应设备子图；UCM 配置新增 Mic 设备与采集路由。
• 安装内容其余部分与 v0.2.0 一致。

真机验证

在开发机上完成验证：麦克风录音（含人声）、扬声器播放、Wi-Fi、蓝牙、显示、加速度计与 GNOME 桌面均正常；启动契约校验与 boot 分区回读比对通过。本次验证经增量升级路径完成（设备内安装升级包并刷入 boot 镜像）；安装器与 v0.2.0 逐字节一致，全量安装流程未重复执行。

从 v0.2.0 升级（不清除数据）

1. 在运行中的平板系统内安装三个升级包：sudo dpkg -i liuqin-kernel_0.1_arm64+v0.3.0.deb liuqin-firmware_0.1_all+v0.3.0.deb liuqin-device-support_0.1_arm64+v0.3.0.deb。
2. 随即进入 fastboot：sudo systemctl reboot bootloader，然后刷入本页附件的 boot 镜像：fastboot flash boot_a boot.img。
3. fastboot reboot。

boot 镜像与已安装的软件包必须相互匹配，因此在第 1 步与第 3 步之间不要执行常规重启；若平板进入诊断 shell，刷入 boot.img 后重启即可。

如需回滚：刷回 v0.2.0 的 boot.img，并重新安装 v0.2.0 的对应软件包，顺序同上。

已知问题

• 锁屏或合盖长时间休眠后可能无法唤醒，需长按电源键强制重启；该问题在专项排查中。
• 平板 USB 先连接充电器再连接电脑时，数据线可能无法完成枚举；强制重启平板可恢复。
• 其余三颗板载麦克风（AMIC3/4/5）与多麦降噪尚未接入。

安装

全新安装会清空 userdata，请提前备份。下载全部附件后按 INSTALL-TESTING.zh-CN.md 执行；rootfs 分卷先合并：cat rootfs.tar.gz.part-* > rootfs.tar.gz。

---

Fourth pre-release of the Ubuntu 26.04 port for Xiaomi Pad 6 Pro (liuqin). This version adds support for the onboard AMIC1 microphone: the WCD938x codec feeds the LPASS TX macro over SoundWire, captured by the ADSP codec DMA, with 48 kHz recording through the UCM "Mic" device. Validated on the development tablet via the incremental upgrade path — microphone capture (including speech), speaker playback, Wi-Fi, Bluetooth, display, accelerometer and the GNOME desktop are all working; the installer is byte-identical to v0.2.0. Existing v0.2.0 installations can upgrade in place with the attached boot image and the three upgrade packages, without erasing user data. See INSTALL-TESTING.md; a fresh installation erases userdata — back up first.

v0.2.0 — Waydroid 支持、键盘触摸板修复、触摸面板变体

Xiaomi Pad 6 Pro（liuqin）Ubuntu 26.04 移植，第三个预发布。内核 6.17.0-rc1-gb07784536640，主仓 f566133。

本版变化（相对 v0.1.1）

• Waydroid 内核支持：Binder IPC、binderfs 与 IPv4/IPv6 策略路由全部内建，sudo apt install waydroid 即可使用（Android 镜像约 1 GB 需联网下载）。安装与已知限制见 docs/WAYDROID.zh-CN.md。
• 磁吸键盘触摸板修复：触摸板在 pogo i2c 总线上被 libinput 误判为内置触摸板、随平板模式挂起；现在以 udev 规则标记为外置，笔记本形态下触摸板与自动旋转同时正常。
• 触摸固件按面板选择：驱动按 bootloader 上报的面板模块（CSOT / 天马）自动加载对应 NT36532 固件，天马屏机型不再出现触摸半屏镜像。
• 内核 b07784536，REPRO 双空 OUT 构建逐字节一致（含 489 模块）。

真机验证

256 GB 机型完整重刷端到端通过，首启回归（UCSI/NCM/Wi-Fi/蓝牙/音频/传感器栈/触摸/键盘/充电）全绿并经用户确认；键盘触摸板、自动旋转、有线鼠标实测正常。

已知问题

• USB3 SuperSpeed（U盘/扩展坞高速模式）尚未逐一实测，若遇识别问题请带 lsusb -t 输出反馈。
• Waydroid 内核配置已验证，容器运行时（图形、联网）属实验性，欢迎反馈。
• Android 恢复路线未独立验证；不支持 B 槽安装。

安装

下载全部文件后按 INSTALL-TESTING.zh-CN.md 执行；rootfs 分卷先合并：cat rootfs.tar.gz.part-* > rootfs.tar.gz。安装会清空 userdata，请提前备份。

---

Third pre-release of the Ubuntu 26.04 port for Xiaomi Pad 6 Pro (liuqin). Highlights: Waydroid kernel support (Binder, binderfs and policy routing built in), a fix for the magnetic-keyboard touchpad being suspended in tablet mode, and touch firmware selected by the fitted panel module (CSOT or Tianma). Validated on a 256 GB unit with a full end-to-end installation and first-boot regression. See INSTALL-TESTING.md; installation erases userdata — back up first.

v0.1.1 — USB-C OTG host 与安装器放宽

Xiaomi Pad 6 Pro（liuqin）Ubuntu 26.04 移植，第二个预发布。内核 6.17.0-rc1-gd9063dafb，主仓 dea2482。

本版变化（相对 v0.1.0）

• USB-C OTG host 与 UCSI 自动角色：插入有线鼠标、扩展坞即用，角色/供电自动协商。修复四个叠加根因：SM8475 QMP PHY 表缺失、dwc3 maximum-speed=super 触发 LLUCTL 越界、drd role switch 无法用户态控制、UCSI PPM_RESET 重发风暴打死 ADSP。
• 安装器放宽：按 PARTNAME 运行时解析 userdata，容量 ≥16 GiB 即放行（覆盖 128/256/512 GB 及重分区设备），破坏性步骤前增加交互确认；安装器、initramfs、GNOME storage guard 三处规则一致，并有 CI 合同测试守护。
• 模块集裁剪：内核模块 1342 → 489，只保留本机实际使用的集合；内核源码提交与配置已锁定（REPRO 双空 OUT 逐字节一致）。
• 固件入仓：203 个提取固件文件随仓库发布，安装包继续内置全部所需固件。

真机验证

256 GB 机型完整重刷端到端通过（备份→清 userdata→安装→写 boot_a 全自动），首启回归：UCSI/NCM/Wi-Fi/蓝牙/音频/传感器栈/触摸/磁吸键盘/充电全部正常；有线鼠标实测自动枚举可用。

已知问题

• 磁吸键盘触摸板在平板模式下被 libinput 挂起（修复已进 main，v0.2 带入）。
• USB3 SuperSpeed（U盘/扩展坞高速模式）尚未实测。
• 天马（Tianma）屏机型的触摸固件选择已进 main，v0.2 带入；本版镜像仍只覆盖 CSOT 屏。
• Android 恢复路线未独立验证；不支持 128 GB 以外布局的逐项验证、不支持 B 槽安装。

安装

下载全部文件后按 INSTALL-TESTING.zh-CN.md 执行；rootfs 分卷先合并：cat rootfs.tar.gz.part-* > rootfs.tar.gz。安装会清空 userdata，请提前备份。

---

Second pre-release of the Ubuntu 26.04 port for Xiaomi Pad 6 Pro (liuqin). Highlights: USB-C OTG host with automatic UCSI role negotiation (wired mice and docks work out of the box), a relaxed installer (userdata resolved by PARTNAME, any capacity ≥ 16 GiB), a trimmed module set (1342 → 489) and the extracted firmware shipped in the repo. Validated on a 256 GB unit with a full end-to-end installation and first-boot regression. See INSTALL-TESTING.md; installation erases userdata — back up first.

Ubuntu for Xiaomi Pad 6 Pro v0.1.0

Ubuntu for Xiaomi Pad 6 Pro v0.1.0

Experimental Ubuntu 26.04 desktop image for Xiaomi Pad 6 Pro (liuqin, SM8475), with GNOME and a Linux 6.17-rc1-based kernel.

Before Installing

• Installation erases user data. An unlocked bootloader and a Linux host are required. Back up your data and prepare the matching stock firmware before proceeding.
• Only the known 256 GB partition layout has been tested. Other capacities, modified layouts and B-slot installation are unsupported. Do not bypass the installer checks.
• Fresh installation, first boot, automatic rotation, touch, magnetic keyboard and speaker playback have been verified on the development tablet. This does not establish compatibility with every 256 GB unit.
• Android recovery has not been independently validated on hardware. This release is experimental, not a stable daily-use guarantee.
• This is a single-OS Ubuntu installation, not Android dual boot. See the hardware support table for remaining limitations.

Download and Install

Download all 12 attached installation files into one directory, including all three rootfs.tar.gz.part-* files. GitHub's automatic source archives are not installation images.

Follow INSTALL-TESTING.md or INSTALL-TESTING.zh-CN.md. The instructions cover merging the root filesystem parts, backup and installation. Do not mix files from different releases.

The bundle includes firmware and device components needed by the image. Device-specific calibration and addresses are extracted from the target tablet during installation; never copy them between devices. USB root rescue is disabled by default and can be explicitly enabled for diagnostics.

安装前须知

本版本为实验性预发布，仅适用于小米平板 6 Pro（liuqin）的已知 256 GB 分区布局。首次安装会清除用户数据，需要解锁 Bootloader；其他容量、修改过的布局及 B 槽安装不受支持。Android 恢复尚未完成独立真机验证。 请先备份数据并准备匹配的原厂固件。

请下载全部 12 个附件，在同一目录中按 INSTALL-TESTING.zh-CN.md 合并根文件系统分卷并安装。GitHub 自动生成的 Source code 压缩包不是系统安装包。已验证首次安装和启动，以及旋转、触摸、磁吸键盘和扬声器播放；完整支持范围与限制见中文 README。