ChargeLimiter(CL)是针对iOS开发的AlDente替代工具,适用于长时间过充情况下保护电池健康度.
支持有根越狱(???-arm.deb)/无根越狱(???-arm64.deb )/TrollStore(???.tipa),目前支持iOS12-17.(注意: TrollStore环境下安装新版之前请先卸载旧版)
测试过的环境: iPhone6/7+iOS12/13 Checkra1n/Unc0ver/Odyssey; iPhone7/X/11+iOS15/16 Palera1n/Dopamine/TrollStore.
常见问题
什么情况下需要用CL?
- 手机需要长期连电源
- 手机需要整夜充电
- 充电时希望控制温度
CL更费电吗?
- 大多数用户感觉并不明显,CL的后台并不耗电,如果感觉确实耗电可以尝试关闭界面App和悬浮窗,或将更新频率调低到1分钟.
CL支持第三方电池吗?
使用CL后能增加健康度吗？
- 个人认为健康度递减是自然过程,软件更不可能直接修复硬件.不过有些用户使用CL一个月后确实健康度涨了.
- 大部分使用者会明显延缓电池健康度下降速度.
- 极个别用户在使用CL后出现健康度下降更快的情况,请立即停用并卸载.
- 停充状态下一直连电源的情况下(非禁流),正常情况下电池电流为0,健康度永久不掉.
为什么手机用一会不充电了?(小白经常遇到的问题)
- CL并非傻瓜式工具,如果开启了温控请根据实际情况调整温度上下限,否则到达上限会停止充电,下限又无法达到自然无法充电
- CL的设计思路就是减少充电次数,因此不会连着usb就充电,插电即充模式下需要重新插拔才会开始充电
CL可以不依赖越狱或巨魔类工具吗?
- CL需要用到私有API所以无法上架
- CL需要用到特殊签名因此无法以常规IPA方式来安装
测试电池兼容性
在使用CL前需要测试电池兼容性,如果不支持请放弃使用
- 1.测试电池是否支持停充.在“正在充电”按钮开启的状态下,手动关闭之,若120秒内按钮有反应则电池支持停充,但如果停充后有较大持续电池电流(>=50mA)则无法支持停充(有些电池返回电池电流值有误,此时以实际电量变化为准).目前反馈不支持停充的电池包括但不限于:马拉松.
- 2.测试电池是否支持智能停充.开启"高级-智能停充",其余同1.
- 3.测试电池是否支持禁流.在“电源已连接”按钮开启的状态下,手动关闭之,若120秒内按钮有反应则电池支持禁流,但如果禁流后有较大持续电流(>=50mA)则无法支持禁流(有些电池返回电池电流值有误,此时以实际电量变化为准).
- 若电池既不支持停充也不支持禁流则永远不被CL支持.
- 如果使用CL过程中,健康度以不正常的方式下降,请停止使用并卸载.
使用说明
- 有研究表明电量在20%-80%之间,温度在10°C-35°C之间,对电池寿命影响最小.因此CL上下阈值默认设定为20/80.过充/零电量充电/高温对电池会产生不良影响.
- 插电即充模式适合普通用户使用,边缘触发模式适合工作室使用.
- iPhone8+存在120秒设定充电状态延迟. iPad可能也存在.
- 停充模式不会更新系统状态栏的充电标志,实际充电状态可以在看爱思助手或者CL查看.禁流模式会改变系统状态栏的充电标志(iPhone8+), 禁流模式在"高级-停充时启用禁流"中设定
- 对于TrollStore环境,因任何原因导致的后台被杀(比如重启系统/重启用户空间/...),将导致CL失效.
- CL不会连着线就自发充电,充电/停充都有触发条件,请仔细查看本页说明.
- 设定阈值和实际触发值不一定完全相同,例如设定80%上限结果到81%停充,大部分手机差距在0-1%,极少数3-5%,产生5%差异值具体原因未知,与8系及以上存在设定延迟有关,也可能与充电速度有关.
- 健康度与爱思助手保持一致,若健康度超过100%则说明新电池相比该代手机发行时的原始电池容量有升级.CL健康度是根据最大实际容量计算的.
- 硬件电量若超过100%(或超过显示电量)可能是未校准或质量问题导致.
- 电池电流为正说明从充电器流入电池,电池电流为负说明电池为设备供电.使用CL且停充状态下电池电流一般为0,此时电流流经电池为设备供电,电池起到闭合电路作用(可以理解为导线),此时对电池的损耗应小于仅使用电池为设备供电.禁流状态下电池电流一般为负,此时电池损耗和正常使用一致.
- 系统自带电池优化会导致CL失效,1.3版本起会自动关闭自带优化(但系统设置里不会显示).如果不使用CL需在系统设置中手动重置电池优化开关(先关后开).不推荐在过新的设备上使用,因为iPhone15起自带电池优化已经很完善.
- CL是开放式项目,如果有兴趣参与或者对CL有建议的的欢迎参提交代码.CL纯属偶然兴趣而开发,最开始是作者自己玩的,后来觉得其他人会需要才开源分享.CL承诺永久免费且无广告,但因为使用CL导致系统或硬件方面的影响(或认为会有影响的)作者不负任何责任,用户使用CL即为默认同意本条款.
支持的模式:
- 插电即充,重新接入电源时开始充电, 电量到达指定上限时停止充电, 适合个人使用.
- 边缘触发,电量到达指定下限时开始充电, 电量到达指定上限时停止充电, 适合工作室使用.
目前触发充电的条件
- 电量低于设定的最小值
- 插电即充模式下重新接入电源
- 插电即充模式下温度低于设定的最小值
目前触发停充的条件
ChargeLimiter(CL) is inspired by MacOS version AlDente, used to prevent iDevice from getting overcharged, which will cause damage to the battery.
Support Rootful Jailbreak(???-arm.deb)/Rootless Jailbreak(???-arm64.deb)/TrollStore(???.ipa). Currently support iOS12-17.(Notice: For TrollStore, Please uninstall older version CL before installing a newer one)
Tested on iPhone6/7+iOS12/13 Checkra1n/Unc0ver/Odyssey; iPhone7/X/11+iOS15/16 Palera1n/Dopamine/TrollStore.
Questions
Why should I use CL?
- iDevice always connected to an adaptor
- iDevice always charged overnight
- Want to control the temparature during charging
Does CL consume more power?
- Insensitive for most users. App UI and float window may consume a little power if frequancy is 1sec. if you feel the capacity dropping fast, try to set the update frequency to 1min.
Does CL support 3rd party battery?
- CL support battery of most brands.
Will the battery health percentage increase after using CL for a period of time?
- I don't think it's possible, especially for a software, but there are indeed some users have their battery health increased after using CL for a month.
- CL will slow down dropping speed of battery health for most users.
- Health percentage may fluctuate in certain range. There are indeed little users keep dropping health after using CL, please stop using CL in this case.
- Keep connecting to an adaptor and enable ChargeInhibit(without DisableInflow) as long as possible, the normal amperage should be 0mA, and the health of battery will never drop.
Why does my iPhone won't charge any more after using for a while(Most questions from freshman)?
- CL is not a fully-automatic tool, please set the threshhold carefully according to the actual temperature if temperature control is enabled, or CL will surely stop charging and won't re-charge any more.
- CL is designed to reduce the charging count, so it won't start charging for connecting to an adaptor in "Plug and charge" mode, but will start charging for re-connecting to an adaptor.
Is it possible to install CL without Jailbreak or TrollStore(-like) enviroment?
- Private api is used in CL, so it is impossible to be published to Appstore.
- Special entitlements is used in CL, so it is impossible to be installed as common ipa files.
Compatibility
Please test battery compatibility before using CL, stop and uninstall CL if unsupported
- 1.Check compatibility of ChargeInhibit.Disable charging by toggling the "Charging" button, any change within 120 seconds means ChargeInhibit is supported, unless the InstantAmperage keep above 50mA after being disabled.(InstantAmperage may be invalid for a few kinds of batteries, in this case take a look at capacity increasement)
- 2.Check compatibility of PredictiveChargingInhibit. Enable it from "Advanced-Predictive charging inhibit", then follow steps in '1'.
- 3.Disable inflow by toggling the "External connected" button when it is enabled, any change within 120 seconds means DisableInflow is supported, unless the InstantAmperage keep above 50mA after being disabled.(InstantAmperage may be invalid for a few kinds of batteries, in this case take a look at capacity increasement)
- The battery will never be supported by CL if neither ChargeInhibit nor DisableInflow is supported.
- If the health of battery keep dropping abnormally while using CL, please stop and uninstall CL.
Instruction
- Some studies shown that capacity between 20%-80%, and temperature is between 10°C-35°C, is better for battery. Therefore, the default threshold is set to 20/80.
- There is 120-seconds delay after setting the charging status for iPhone8+(equal or higher than), maybe the same for iPad.
- The lightning icon of system status bar will not be updated in ChargeInhibit mode, the actual charging status can be found in 3utools(and similar) or CL, while it will be updated in DisableInflow mode(iPhone8+), this mode is enabled in "Advanced-Control inflow".
- For TrollStore, if the daemon(of CL) get killed in any condition(such as system-reboot/userspace-reboot/...), CL will become invalid for not being able to restart daemon itself automatically.
- CL only start/stop charging under certain conditions as show behind.
- The real value stop on trigger is not necessarily equal to the target value, the difference may have sth. to do with the "120 seconds delay" for iPhone8+, and charging speed.
- Health, calculated with NominalChargeCapacity, with value higher than 100% indicates the battery must have been replaced before, and with more capacity than battery shipped with this model first released.
- Hardware capacity with value higher than 100%, maybe indicate the battery is not calibrated or has been changed.
- InstantAmperage with positive value means the current flow into battery from adaptor, negative means the current flow into iDevice from battery without any adaptor. InstantAmperage should be 0mA normally in ChargeInhibit mode, in this case the current will flow through battery and feed iDevice, it will cause less damage to battery than use battery to supply power directly. (In fact, keep connecting to any adaptor and stop charging, the health may never drop). InstantAmperage should be negative in DisableInflow mode.
- CL is not compatible with "Optimized Battery Charging" of Settings.app. After v1.4 CL will disable it automatically(won't shown in Settings.app). Please re-enable in Settings.app after disabling CL if necessary. It's not recommend to use CL on newest iDevice, "Optimized Battery Charging" is already perfect from iPhone15.
- This project is opensourced, any better ideas, submit code directly; any suggestions, submit to issue region. This software will be opensourced, free, without ads forever. Author is not responsible for any impact on iOS system or hardware caused by this software.
Supported mode
- "Plug and charge", iDevice will start charging when reconnected to an adaptor, and stop charging when capacity increase to the max threshhold specified. Useful for individual.
- "Edge trigger", iDevice will stop charging when capacity increase to the max threshhold specified, and start charging only when capacity drop to the min threshhold specified. Useful for developer & studio.
Conditions may trigger starting charging:
- Capacity lower than specified value
- Plug in an adaptor once!!! in "Plug and charge" mode.
- Temparature lower than specified value
Conditions may trigger stoping charging:
- Capacity higher than specified value
- Temparature higher than specified value