适用设备:一加 13(PJZ110 / ColorOS C15–C17 / KernelSU & Magisk),当前版本 v1.24.0(versionCode=85)。
不刷分区、不改 dtbo、不修改原厂 oplus_chg_v2.ko 镜像文件:通过 用户态 /proc/oplus-votable 恒压与闭环温控控制器 + 运行期可逆内核辅助模块 cvchg.ko,在运行期接管 UFCS(15)与 PPS(8);SVOOC(14)与 PD(6)旁路交还原厂。停用、卸载或触发 >= 50.0°C 高温退回时无残留交还原厂(电芯过压红线 FAILSAFE=4575 mV 锁存除外)。
模块使用、完整 42 项配置说明与操作指南见:产物/cvchg/README.md
.
├── src/ 源码(构建唯一输入)
│ ├── cvchg.c 内核辅助模块源码(full_hook + ladder_hook + warm_hook)
│ ├── charger_wait.c 静态无 libc 的 netlink uevent 零轮询插电监听源码
│ ├── cvchg.sh 用户态主控脚本(打包门禁强制与产物副本字节一致)
│ ├── cvchg.symvers 内核导出符号 CRC 表(modpost 强校验)
│ └── build.sh 唯一编译与打包入口
├── 产物/
│ ├── cvchg/ KernelSU / Magisk 模块根目录
│ │ ├── module.prop 模块元信息(v1.24.0 / versionCode=85)
│ │ ├── customize.sh 安装权限设置;覆盖升级保留 cvchg.conf 与 logs/
│ │ ├── service.sh 开机自启守护(.service.lock、日志轮转、charger_wait -> cvchg.sh)
│ │ ├── post-fs-data.sh 启动早期清理残留强制节点、锁与瞬态状态文件
│ │ ├── uninstall.sh 停服、清钩子、rmmod cvchg、释放全部节点
│ │ ├── cvchg.conf 默认配置文件(42 项)
│ │ ├── README.md 模块侧配置与使用文档
│ │ ├── lib/common.sh 公共库(9+3 votable、.conf.lock、功率封顶、42 项校验/原子写)
│ │ ├── bin/
│ │ │ ├── charger_wait 预编译插电监听二进制(0755)
│ │ │ ├── cvchg.ko 预编译内核辅助模块(0644)
│ │ │ ├── cvchg.sh 主控脚本副本(与 src/cvchg.sh 字节一致)
│ │ │ └── webui.sh WebUI 后端 CLI
│ │ └── webroot/ MIUIX 风格三页 WebUI(index.html / style.css / app.js)
│ ├── cvchg.ko 顶层编译产物副本
│ └── charger_wait 顶层编译产物副本
├── 归档/
│ └── lcffix-legacy/lcffix.c 早期 LCF 修复内核模块历史源码归档(不参与当前构建)
└── .gitignore 忽略编译目录 build/、打包产物 产物/*.zip 等
唯一构建与打包入口为 src/build.sh:
./src/build.sh # 仅编译 cvchg.c -> 产物/cvchg.ko & 产物/cvchg/bin/cvchg.ko (0644)
./src/build.sh --charger-wait # 仅编译 charger_wait.c -> 产物/charger_wait & 产物/cvchg/bin/charger_wait
./src/build.sh --all --pack # 编译 cvchg.ko + charger_wait,并打包 产物/cvchg-<version>.zip
./src/build.sh --pack-only # 跳过编译,执行全套门禁后直接打包 产物/cvchg-<version>.zip常用环境变量(按本机环境配置):
KT/KB:编译cvchg.ko时必填;通过KT直接指定内核源码/构建树目录(须包含Module.symvers),或通过KB指定上级目录。LLVM_BIN:LLVM 工具链目录(默认优先使用/usr/lib/llvm-18/bin,charger_wait需要clang与ld.lld)。PYTHON_ELF:安装有pyelftools的python3路径(默认python3),用于校验.koELF 结构。EXTRA_SYMVERS:额外符号 CRC 表路径(默认自动匹配src/cvchg.symvers)。ZIP_NAME:自定义导出 zip 文件名(默认从module.prop读取version,生成产物/cvchg-<version>.zip)。
打包门禁强制检查:
src/cvchg.sh与产物/cvchg/bin/cvchg.sh必须存在且cmp -s字节一致;pyelftools校验cvchg.ko的__versions节完整(非空、64 字节对齐、全部 CRC 非零)且.gnu.linkonce.this_module大小为0x600;- 若存在顶层
产物/cvchg.ko/产物/charger_wait,校验其与产物/cvchg/bin/下对应副本字节一致; - 对模块内全部 7 个
.sh脚本执行mksh -n(宿主机无mksh时回退sh -n并警告);若存在node,同时执行node -c webroot/app.js; - 打包时排除
logs/logs/*/*.bak/*.swp,生成的产物/*.zip已被.gitignore忽略。
1. 内核辅助(src/cvchg.c → bin/cvchg.ko)
提供 3 套运行期可逆内核钩子(默认加载时全关,仅由用户态按生命周期同步开关):
votekprobe(full_hook):- 通过
kaddr_valid()与逐字节短路kname_eq()严格过滤votable->name,只放行PPS_DISABLE/PPS_NOT_ALLOW/UFCS_DISABLE/UFCS_NOT_ALLOW,绝不触碰CHG_DISABLE、VOOC_DISABLE等节点。 - 命中
CHG_FULL_VOTER置en(x2) = 0,命中CHG_FULL_COOL_VOTER或CHG_FULL_WARM_VOTER置en(x2) = 0且val(x3) = 0;保留同 votable 内其余温度/超时安全票,且刻意不拦截SWITCH_TEMP_RANGE。
- 通过
puc_strategy_get_datakprobe(ladder_hook):- 初始化时以全局符号
puc2_strategy_register为锚点自动解码并定位实际调用的puc_strategy_get_data实现与结构偏移(不硬编码小版本偏移,亦支持ladder_dup_delta手工兜底)。 - 运行期先校验整张阶梯表的值域与单调性,再在锁内保存原值并将末档
target_vbat抬高到ladder_vbat(默认4570 mV);关闭钩子或rmmod时按原值写回。原值表满(256 项)或校验异常时 fail-closed 拒写(状态见puc_stat,可用ladder_reset=1复位)。
- 初始化时以全局符号
- WARM 温区运行期改写(
warm_hook,固定44.0 → 50.0°C):- 跨 C15–C17 自动扫描
oplus_{ufcs,pps}_monitor_work(辅以oplus_ufcs_gauge_update_work/oplus_pps_charge_allow_check)指纹,经四重连续字段值域校验(强校验保留51.0°C+原厂过温保护)后,将 UFCS/PPS WARM 门槛抬至50.0°C,消除44.5°CSWITCH_TEMP_RANGE退出与43.0°CBATT_TEMP_VOTER锁 5V。 - 关闭钩子、高温退回、切 SVOOC、拔线或卸载模块时原子写回原值
440(状态见warm_stat)。
- 跨 C15–C17 自动扫描
- 并发与符号最小化:使用内联
local_irq_save+atomic_cmpxchg_acquire/atomic_set_release自旋锁,日志输出全部移出关中断临界区;调试探针ufcs_probe默认由#ifdef CVCHG_ENABLE_UFCS_PROBE编译期剔除。
2. 用户态主控(src/cvchg.sh → bin/cvchg.sh)
主控按协议接管 UFCS(15) 与 PPS(8),SVOOC(14)、PD(6) 或无效功率旁路交还原厂:
-
功率自适应封顶:结合
min(adapter_power, cpa_power)、11V 单调查表与ADAPTER_IMAX_VOTER,受CAP_MAX(默认13700 mA)与PPS_CAP_MAX(默认5000 mA)约束;UFCS 按充电器实际协商功率自适应,最高可达13636 mA。 -
临界阻尼速度型 PI 温控(外环):以 30s 滑动窗计算温升速率,采用匹配 $I^2 R$ 的电流缩放速度型 PI 律、非对称稳态死区(
[target-0.4°C, target+0.1°C]锁流)、极缓升流(<= 22 mA/s)与 Anti-Windup;温度达到ENGAGE_MAX_TEMP(默认500=50.0°C)时清空全部活动与交接节点、关闭内核钩子并写入logs/.ht_hold完整交还原厂,回落至<= 48.0°C恢复。 -
恒压、红线锁存与异常恢复:低端压段按
RAMP_COARSE_MA粗调爬升;达到SOC_CV_ONLY(85%)或VBAT_CV_ONLY(4560 mV)切入只降不升的CV_ONLY;FAILSAFE(4575 mV连续 3 拍)锁存CHG_DISABLE=1(优先级高于高温退出),回落< 4200 mV或拔线解锁;BUS_DROP熔断后支持降温>= 3.0°C、SOC+10或 5 分钟自动衰减恢复;满充终止后电量跌至< TERM_SOC - 5自动复充。 -
按需
TIMER_RESET(仅 UFCS):仅在非 CV、< 48.0°C、30s 内未温控降流、电流与上限余量充足且连续 3 拍检测到适配器真实降档时才执行伪插拔复位(另保留 180 分钟兜底),触发前临时屏蔽VOOC_DISABLE=1防止双协议头切至 SVOOC。 -
内核钩子统一收口:
full_hook/ladder_hook仅在ENGAGE接管期开启,warm_hook在插电在线、< 50.0°C、非FAILSAFE、非满充且非 SVOOC 时开启;待机、高温、切 SVOOC、释放、停服或卸载一律清0。
- 零轮询插电等待(src/charger_wait.c):裸
svc #0系统调用的静态 aarch64 二进制,绑定NETLINK_KOBJECT_UEVENT并复核/sys/class/power_supply/usb/online;未插电时阻塞在recvfrom()上几乎零 CPU 占用(已移除轮询型watchdog.sh)。 - 守护与生命周期(
service.sh/post-fs-data.sh/uninstall.sh/customize.sh):原子.service.lock防双实例;cvchg.log按 512KB 轮转并保留 3 份;.csv/.csv.gz会话曲线永久保留;覆盖升级自动保留cvchg.conf与logs/;卸载时自动停服、清钩子、rmmod cvchg并释放全部节点。 - 公共库与 WebUI(
lib/common.sh/bin/webui.sh/webroot/):收敛 9 个活动 votable + 3 个交接防御节点、.conf.lock互斥锁与 42 项配置校验;MIUIX 三页 WebUI(总览、调参、诊断)支持增量保存、钩子实时状态徽标、充电曲线降采样可视化与会话记录管理。
- 直接使用仓库内已打包或通过
./src/build.sh --all --pack(或--pack-only)生成的产物/cvchg-<version>.zip。 - 在 KernelSU / Magisk 管理器中刷入 zip 并重启设备;覆盖升级会自动保留既有
cvchg.conf与logs/。 - 在模块 WebUI 中调整参数并查看实时状态与历史曲线;详细配置表见 产物/cvchg/README.md。
/proc/oplus-votable/*是投票上限,不是电流驱动:写入force_val只是限制天花板,实际电流仍受原厂 CV、电池内阻与温控制约,不能把「目标电流 - 实测电流」直接当作控制误差。- Android
/system/bin/sh为mksh(32 位有符号整数):epoch 毫秒直接算术会溢出;时间差统一通过now_ms()读/proc/uptime换算开机毫秒,且一律使用差值比较(避免开机超 24.85 天回绕问题)。is_num()已限制数字长度<= 9位。 - 2S 串联电池口径:配置中的所有电压阈值均为单芯 mV(如
4560 mV),整包功率按2 × vbat × ibat计算。 - 内核
bool参数回读为Y/N:/sys/module/cvchg/parameters/full_hook等节点写入接受0/1,但读回为Y/N,状态比对前须归一化。 - Android Toybox
ps -o args会剥离无参二进制路径:检测charger_wait等进程须优先使用ps -A -o pid,cmdline并兼容短名匹配。 - 双副本同步约束:修改 src/cvchg.sh 后须同步到 产物/cvchg/bin/cvchg.sh,否则打包门禁会拒绝通过。