ApartTUSITU's Xiaomi SM8250 Kernel

目录 / Table of Contents

• 简介 / Introduction
• 特性 / Features
• 注意事项 / Notes
• 社区 / Community
• 支持的设备 / Supported Devices
• 其他特性 / Other Features
• 构建方法 / Build Instructions
  • 快速构建 / Quick Build
  • 手动构建 / Manual Build

---

简介 / Introduction

中文:
该 repo 主要基于 Starwing's Xiaomi SM8250 Kernel Source。如果想了解 电量卡在1%的问题，请前往上面的仓库获取更多信息。

English:
This repo is mainly based on Starwing's Xiaomi SM8250 Kernel Source.
If you want to know more about the battery stuck at 1% issue, please check the repo above for more details.

---

特性 / Features

中文:
本内核支持 SukiSU Ultra(一个 KernelSU 的 fork，支持 KPM) & SUSFS。请自行安装 SukiSU Ultra 的管理器，以及根据需要刷上 SUSFS 模块。NoKernelSU 版本支持应用 Magisk 和 APatch。

Release 里的编译好的内核成品由 android16-aptusitu-new 分支编译，应当能在原版 MIUI/HyperOS 和第三方的基于 AOSP 的各种 Android11-16 的 ROM 上使用。欢迎大家尝试并反馈(提 Issue 或 Pull Requests)! 酷友们到 酷安的这个帖子 讨论或反馈，也可以给我私信反馈!

English:
This kernel supports SukiSU Ultra (a fork of KernelSU with KPM support) & SUSFS.
Please install the SukiSU Ultra Manager yourself, and flash the SUSFS module as needed.
The NoKernelSU version supports Magisk and APatch.

The prebuilt kernel in the Release section is compiled from the android16-aptusitu-new branch, and should work on stock MIUI/HyperOS as well as third-party AOSP-based ROMs for Android 11–16.
Feedback is welcome (via Issues or Pull Requests)! Coolapk users can join the discussion in this post, or send me private feedback.

---

注意事项 / Notes

中文:
提示：该内核的 zip 包不包含 dtbo.img，并且不会刷你的 dtbo 分区。推荐使用原厂的 dtbo，或者来自第三方系统包自带的 dtbo(如果原作者确认那好用的话)。因为该源码 build 出来的 dtbo.img 有些小问题，比如在锁屏界面上尝试熄屏时，屏幕会突然闪一下到最高亮度。如果你刷过其它第三方内核，或者遇到一些奇怪的问题，建议检查一下你的 dtbo 是否被替换过。

注意：如果你在用 HyperOS/MIUI 请刷 MIUI 的版本，AOSP 版因为 display 驱动不同，在 HyperOS/MIUI 上屏幕无法正常显示，如果刷内核之后开机黑屏，请先检查你是不是正在用着 HyperOS/MIUI 但是刷了 AOSP 版，默认不受理关于这条的反馈。

English:
Note: The kernel zip package does not contain dtbo.img and will not flash your dtbo partition.
It is recommended to use the stock dtbo, or one from the bundled files of a third-party ROM (if the original author confirms it works well).
The dtbo.img built from this source has some issues—for example, on the lock screen, the display may suddenly flash to max brightness when trying to turn off the screen.
If you have flashed other third-party kernels or encounter strange issues, please check whether your dtbo has been replaced.

Warning: If you are using HyperOS/MIUI, please flash the MIUI version.
The AOSP version has different display drivers, which will cause the screen not to display properly on HyperOS/MIUI.
If you get a black screen after flashing, check if you are on HyperOS/MIUI but flashed the AOSP version.
Feedback about this specific issue will not be accepted by default.

---

社区 / Community

中文:
欢迎加入 Starwing's QQ 交流群: 459094061。

English:
Join Starwing's QQ Group: 459094061

---

支持的设备 / Supported Devices

设备代号 / Codename	设备名称 / Device Name
psyche	Xiaomi 12X
umi	Xiaomi 10
munch	Redmi K40S
lmi	Redmi K30 Pro / POCO F2 Pro
cmi	Xiaomi 10 Pro
cas	Xiaomi 10 Ultra
apollo	Xiaomi 10T / Redmi K30S Ultra
alioth	Xiaomi 11X / POCO F3 / Redmi K40
elish	Xiaomi Pad 5 Pro
enuma	Xiaomi Pad 5 Pro 5G
dagu	Xiaomi Pad 5 Pro 12.4
pipa	Xiaomi Pad 6

---

其他特性 / Other Features

1. 中文: 支持 USB 串口驱动(CH340/FTDI/PL2303/OTI6858/TI/SPCP8X5/QT2/UPD78F0730/CP210X)
   English: Support for USB serial drivers (CH340 / FTDI / PL2303 / OTI6858 / TI / SPCP8X5 / QT2 / UPD78F0730 / CP210X)

2. 中文: 支持 EROFS
   English: Support for EROFS

3. 中文: F2FS 开启了 realtime discard 以更好地 TRIM 闪存
   English: F2FS with realtime discard enabled for better flash TRIM

4. 中文: 支持 CANBus 和 USB CAN (如 CANable) 适配器
   English: Support for CANBus and USB CAN adapters (e.g. CANable)

5. 中文: zRAM 支持 LZ4、LZ4HC、ZSTD 压缩算法
   English: zRAM support for LZ4, LZ4HC, and ZSTD compression

6. 中文: 向后移植 5.10 BPF
   English: Backported BPF from 5.10

---

构建方法 / Build Instructions

快速构建 / Quick Build

中文:

1. fork 本仓库(别忘了点个 Star~)
2. 进入 Actions
3. 如果你要为所有支持的设备编译内核，找到 Build All Devices Kernel (Matrix Parallel + Release)，点击 Run workflow
4. 如果你要为单个设备编译内核，找到 Build Kernel， 点击 Run workflow 并选择必要内容

English:

1. Fork this repo (don’t forget to leave a Star~)
2. Go to Actions
3. If you want to compile the kernel for all supported devices, find Build All Devices Kernel (Matrix Parallel + Release) and click Run workflow
4. If you want to compile the kernel for a single device, find Build Kernel, click Run workflow, and select the necessary options

---

手动构建 / Manual Build

中文:

1. 准备基本构建环境。
   需要常用工具链 git、make、curl、bison、flex、zip 等，以及一些软件包。

   • 在 Debian/Ubuntu:

   sudo apt install build-essential git curl wget bison flex zip bc cpio libssl-dev ccache
   

   还需要 python (仅有 python3 不够)，可安装:

   sudo apt install python-is-python3
   

   • 在 RHEL/RPM 系统:

   sudo yum groupinstall 'Development Tools'
   sudo yum install wget bc openssl-devel ccache
   

   注意：build.sh 中启用了 ccache，路径是 $HOME/.cache/ccache_mikernel。可修改或删除。

2. 下载 ZyC-Clang v15 工具链:

   mkdir zyc-clang
   cd zyc-clang
   wget https://github.com/ZyCromerZ/Clang/releases/download/15.0.7-20251111-release/Clang-15.0.7-20251111.tar.gz
   tar -zxvf Clang-15.0.7-20251111.tar.gz
   cd ..
   

3. 构建:

   • 不使用 KernelSU:

     bash build.sh TARGET_DEVICE
     

   • 使用 KernelSU:

     bash build.sh TARGET_DEVICE ksu
     

   示例:

   • lmi (Redmi K30 Pro/POCO F2 Pro) 不使用 KernelSU:

     bash build.sh lmi
     

   • umi (Xiaomi 10) 使用 KernelSU:

     bash build.sh umi ksu
     

   另外，buildall.sh 可一次性为所有设备构建。

English:

1. Prepare the build environment.
   You need git, make, curl, bison, flex, zip, etc.

   • On Debian/Ubuntu:

   sudo apt install build-essential git curl wget bison flex zip bc cpio libssl-dev ccache
   

   You also need python (not just python3):

   sudo apt install python-is-python3
   

   • On RHEL/RPM-based OS:

   sudo yum groupinstall 'Development Tools'
   sudo yum install wget bc openssl-devel ccache
   

   Note: ccache is enabled in build.sh ($HOME/.cache/ccache_mikernel). You may remove/modify it.

2. Download ZyC-Clang v15 toolchain:

   mkdir zyc-clang
   cd zyc-clang
   wget https://github.com/ZyCromerZ/Clang/releases/download/15.0.7-20251111-release/Clang-15.0.7-20251111.tar.gz
   tar -zxvf Clang-15.0.7-20251111.tar.gz
   cd ..
   

3. Build:

   • Without KernelSU:

     bash build.sh TARGET_DEVICE
     

   • With KernelSU:

     bash build.sh TARGET_DEVICE ksu
     

   Example:

   • lmi (Redmi K30 Pro/POCO F2 Pro) without KernelSU:

     bash build.sh lmi
     

   • umi (Xiaomi 10) with KernelSU:

     bash build.sh umi ksu
     

   Additionally, buildall.sh can build for all supported devices at once.