Ubuntu for OnePlus Pad 2 Pro v0.2.2

Ubuntu for OnePlus Pad 2 Pro v0.2.2

在一加平板 2 Pro（OPD2413）上运行 Ubuntu Desktop 26.04。这是一个补丁版：带上社区贡献的音量上键和音频电平修复，并用新设备包重建了可直接安装的镜像。

• 音量上键可用：内核把音量上键接到 PMIC 的 PON resin 输入，上报 KEY_VOLUMEUP，实体按 10 次全部收到（linux-sm8750-erhai#1）。
• 麦克风电平可用：内置麦克风改为 ADC 13 / TX DEC 112，离平板约 30 cm 正常说话峰值约 −8 dBFS、不削波（#7）。
• 扬声器候选达到原厂音量：手动启用的扬声器候选把功放从 −22.5 dB 调到原厂的 −2.5 dB，左右两组和六颗功放的位置、响度与音质已实际听音通过；仍默认关闭，也没有原厂扬声器保护（#7）。
• Wi-Fi：内核允许用户态设置国家码，并带上 ath12k 单 pdev 频率范围修复（FROMLIST）；设备包不设国家码，仍为全球通用的 00。
• 镜像用 0.2.2 设备包重建；随附 erhai-switch-v0.2.2.zip。

感谢 @HOSHINO61 贡献这两处改动。

本版在测试平板上实测：已装系统用 APT 升级后启动新内核，启动三件套写入后读回一致；5 GHz Wi-Fi 关联、扫描与通信、约 120 秒休眠恢复通过，约 10 分钟运行内没有 SMMU 故障或无线固件崩溃；音量键、麦克风与扬声器抽查通过；首次准备镜像从内存启动到桌面。

获取、安装与升级

预构建镜像的使用方法 · 安装、升级与恢复 · 构建指南 · 内核源码

超过 2 GiB 的镜像分两段上传，下载后按文件名顺序拼接，再用 SHA256SUMS 校验。已安装 v0.2.0 或 v0.2.1 的设备可以解开 erhai-device-packages-v0.2.2.tar，用 apt install 安装其中的包后重启；这些包不含 USB 调试通道，内核升级会写入当前启动三件套并保留上一版内核，详见安装文档的“升级已有安装”。首次准备 Linux 分区会清除 Android 数据，请先备份并按文档操作；不要混用不同版本的 setup 镜像与根文件系统。

已知限制

Wi-Fi 请保持全球通用国家码 00，不要在已连接时修改国家码：这曾导致无线固件崩溃；00 下无法开 5 GHz 热点。扬声器仍需手动启用，没有原厂扬声器保护，长期使用的保护尚未验证。Linux 下尚未验证能净充电，需要充电时返回 Android。默认播放器 Showtime 播放视频时可能因 Mesa freedreno 断言退出。Vulkan、摄像头和完整 Snap 支持尚未提供。

完整功能状态见 硬件支持表。

Ubuntu for OnePlus Pad 2 Pro v0.2.1

Ubuntu for OnePlus Pad 2 Pro v0.2.1

在一加平板 2 Pro（OPD2413）上运行 Ubuntu Desktop 26.04。这一版开始附带可直接安装的预构建镜像，内核与设备功能和 v0.2.0 相同。

• 预构建镜像：Release 附带安装用根文件系统（不含 USB 调试通道）、首次准备分区用的 setup 根文件系统与启动镜像，以及设备包。不再需要自己构建内核、Mesa 或根文件系统。超过 2 GiB 的镜像分两段上传，下载后拼接，再用 SHA256SUMS 校验。
• 内核与设备功能不变：内核仍为 erhai-v0.2.0，从相同提交重新构建得到同一个内核版本。
• 文档：Linux 下的充电情况按实测重写。插电脑 USB 口时能取电，但亮屏仍缓慢掉电；充电器下尚未实测。
• 随附 erhai-switch-v0.2.1.zip，用于已完成 Linux 安装的设备在 Android 侧切换系统。

本版在测试平板上实测：用安装工具清空 Linux 分区完整重装，首次开机约 20 秒进入系统；最终的首次准备镜像从内存启动到桌面；装上最终设备包后，开机、5 GHz Wi-Fi 自动连接、300 秒休眠恢复、传感器、录音、键盘、温度、视频硬解与双系统往返切换均通过。

获取、安装与升级

预构建镜像的使用方法 · 安装、升级与恢复 · 构建指南 · 内核源码

已安装 v0.2.0 的设备不必升级：本版设备功能与 v0.2.0 相同。如需统一版本，可以解开 erhai-device-packages-v0.2.1.tar，用 apt install 安装其中的包后重启。这些包不含 USB 调试通道，详见安装文档的“升级已有安装”。

已知限制

Linux 下能从 USB 取电，但尚未验证能净充电：插电脑 USB 口亮屏时电量仍缓慢下降，充电器下尚未实测；需要充电时返回 Android，Fastboot 不能用来充电。Wi-Fi 使用全球通用国家码（00），5 GHz 只能被动扫描，因此无法开 5 GHz 热点；设置国家码目前会让无线固件不稳定，推迟到后续版本。拔线待机续航与 SoC 最深电源态尚未测量。默认播放器 Showtime 播放视频时会因 Mesa freedreno 断言退出。扬声器、Vulkan、摄像头和完整 Snap 支持尚未提供。

完整功能状态见 硬件支持表。

Ubuntu for OnePlus Pad 2 Pro v0.2.0

Ubuntu for OnePlus Pad 2 Pro v0.2.0

在一加平板 2 Pro（OPD2413）上运行 Ubuntu Desktop 26.04。这一版合入了社区贡献，并在已安装系统上完成了升级与真机复测。

• 系统挂起默认改为 s2idle：已安装系统在两种显示模式下各挂起 300 秒、由 RTC 唤醒，显示、触控、Wi-Fi 与传感器均恢复。
• 电源键可选休眠：写入 /etc/erhai/power-key-action 后，按电源键锁屏、熄屏并进入系统休眠，再按一次唤醒；默认仍只锁屏熄屏。
• 指南针与陀螺仪：经 iio-sensor-proxy 在 D-Bus 上提供航向与角速度，挂起恢复后仍正常更新。
• 关闭 GNOME 静置变暗：面板不会自动熄屏，静置变暗后要触摸才能恢复，因此关闭。
• 内核 erhai-v0.2.0：移除默认关闭的挂起唤醒诊断代码，IPCC 与 GLINK 驱动回到 Linux v7.2 原样。
• H.264 硬件解码：已在平板上验证，60 帧测试片与软件解码逐帧一致。
• 随附 erhai-switch-v0.2.0.zip，用于已完成 Linux 安装的设备在 Android 侧切换系统。

感谢 @Pidbid 贡献 #1–#4 与 #6。

获取、安装与升级

构建指南 · 安装、升级与恢复 · 系统休眠 · 内核源码

已安装 v0.1.0 的设备无需重新分区或重装：按构建指南构建 v0.2.0 设备包和传感器包后，用 apt install 升级并重启，见安装文档的“升级已有安装”。首次安装流程未变，沿用 v0.1.0 的验证结果。

已知限制

Linux 和 Fastboot 下尚不能可靠净充电，需要返回 Android。拔线待机续航与 SoC 最深电源态尚未测量。电源键休眠的实体按键唤醒由贡献者实测，本版自动化复测覆盖 RTC 唤醒。默认播放器 Showtime 播放视频时会因 Mesa freedreno 断言退出。扬声器、Vulkan、摄像头和完整 Snap 支持尚未提供。

完整功能状态见 硬件支持表。

v0.1.0

Ubuntu for OnePlus Pad 2 Pro v0.1.0

在一加平板 2 Pro（OPD2413）上运行 Ubuntu Desktop 26.04。

• 已验证 16 GB / 512 GB 设备的首次分区、Linux 安装、桌面与触控、普通重启和 Android 双向切换。
• 提供独立内核、设备软件包、源码构建与安装工具；固件和原厂启动构建输入随仓提供，无需手动提取 ROM。
• 随附 erhai-switch-v0.1.0.zip，用于已完成 Linux 安装的设备在 Android 侧切换系统。

获取与安装

构建指南 · 安装与恢复 · 内核源码

请按构建指南使用 Git 获取源码；构建需要 Git 提交信息。首次分区会清除 Android 数据；Linux 重装会清除 Linux 数据。适用固件、活动槽和布局要求见安装指南。

已知限制

Linux 和 Fastboot 下尚不能可靠净充电，需要返回 Android。熄屏采用背光关闭方案，待机功耗仍高。USB 直连转接头及部分重插存在问题；扬声器、Vulkan、摄像头和完整 Snap 支持尚未提供。硬件看门狗不能保证从卡死中恢复。

完整功能状态见 硬件支持表。