Add configurable idleThreshold, and update idle mode information

README.md

@@ -239,7 +239,7 @@ In interactive mode, it also asks the user whether they want to download and ins
 ```
 #DC#
 
-configVerCode=202207250
+configVerCode=202207300
 
 ampFactor=
 battStatusWorkaround=true
@@ -249,6 +249,7 @@ cooldownRatio=()
 currentWorkaround=false
 dischargePolarity=
 forceOff=false
+idleThreshold=40
 language=en
 offMid=true
 prioritizeBattIdleMode=true
@@ -377,6 +378,8 @@ runCmdOnPause=''
 
 # forceOff=force_off=BOOLEAN
 
+# idleThreshold=idle_threshold=MILLIAMPS
+
 # language=lang=LANGUAGE_CODE NULLABLE
 
 # maxChargingCurrent=max_charging_current=(MILLIAMPS CTRL_FILE1::RAW_VALUE::DEFAULT CTRL_FILE2::RAW_VALUE::DEFAULT...)
@@ -420,6 +423,7 @@ runCmdOnPause=''
 # current_workaround cw
 # discharge_polarity dp
 # force_off fo
+# idle_threshold it
 # lang l
 # max_charging_current mcc
 # max_charging_voltage mcv
@@ -576,6 +580,10 @@ runCmdOnPause=''
 # Some people "systemlessly" disable certain thermal daemons with Magisk. While this is not a general recommendation, they swear by it.
 
 
+# idle_threshold (it) # Default: 40
+# Current threshold (absolute value) in milliamps to consider _status=Idle.
+
+
 # lang (l) # Default: en
 # Display language, when null, English (en) is assumed.
 
@@ -1483,7 +1491,11 @@ A common workaround is having `resume_capacity = pause_capacity - 1`. e.g., resu
 
 It's the ability of running off the charger.
 The battery behaves as if it were physically disconnected from the device.
-The primary indicator of idle mode is charging current within -11 and 11 milliamps.
+The primary indicator of idle mode is charging current around 0 mA. One can customize idleThreshold (absolute value).
+
+Idle mode is great for extended device use (e.g., GPS navigation, gaming, server). Use it when the charger must be plugged for a long time (or permanently).
+
+IMPORTANT: lithium batteries have the longest lifespan when kept about 40-60% charged (about 3.7-3.9ish Volts). That said, try not to use idle mode above 60% too often.
 
 Not all devices support the "native" idle mode. Hence, variants of "emulated" idle mode are available:
 
@@ -1495,7 +1507,6 @@ Notes
 
 - In idle mode, the battery does discharge, although very slowly. The same happens to a battery that is sitting on a shelf.
 - In emulated idle mode, the battery tends to hold its charge, since it works as a "passthrough" device. Imagine pouring water into a glass that is already full.
-- Regardless of the variant, idle mode is not recommended for highly charged batteries. Ideally, battery level shall be around 40-60%, and/or voltage between 3.7-3.9ish Volts.
 
 
 > How do I enable "smart charging"?

install/batt-interface.sh

@@ -1,13 +1,15 @@
 idle_discharging() {
-  [ $curThen != null ] && [ ${curNow#-} -le $idleThreshold ] && _status=Idle || {
-    case "${dischargePolarity-}" in
-      +) [ $curNow -ge 0 ] && _status=Discharging || _status=Charging;;
-      -) [ $curNow -lt 0 ] && _status=Discharging || _status=Charging;;
-      *) [ $curThen = null ] || {
-           tt "$curThen,$curNow" "-*,[0-9]*|[0-9]*,-*" && _status=Discharging || _status=Charging
-         };;
-    esac
+  [ ${curNow#-} -gt $idleThreshold ] || {
+    _status=Idle
+    return 0
   }
+  case "${dischargePolarity-}" in
+    +) [ $curNow -ge 0 ] && _status=Discharging || _status=Charging;;
+    -) [ $curNow -lt 0 ] && _status=Discharging || _status=Charging;;
+    *) [ $curThen = null ] || {
+         tt "$curThen,$curNow" "-*,[0-9]*|[0-9]*,-*" && _status=Discharging || _status=Charging
+       };;
+  esac
 }
 
 
@@ -17,11 +19,15 @@ not_charging() {
   local nci=${nci:-15}
   local switch=${flip-}; flip=
   local curThen=$(cat $curThen)
+  local idleThreshold=$idleThreshold
   local battStatusOverride="${battStatusOverride-}"
   local battStatusWorkaround=${battStatusWorkaround-}
 
   tt "${chargingSwitch[$*]-}" "*\ --" || battStatusOverride=
-  [ $currFile != $TMPDIR/.dummy-curr ] || battStatusWorkaround=false
+
+  [ $currFile = $TMPDIR/.dummy-curr ] && battStatusWorkaround=false || {
+    [ ${ampFactor:-$ampFactor_} -eq 1000 ] || idleThreshold=${idleThreshold}000
+  }
 
   if [ -z "${battStatusOverride-}" ] && [ -n "$switch" ]; then
     for i in $(seq $nci); do
@@ -143,13 +149,11 @@ if ${init:-false}; then
   }
 
 
-  idleThreshold=11 # mA
   ampFactor=$(sed -n 's/^ampFactor=//p' $dataDir/config.txt 2>/dev/null || :)
   ampFactor_=${ampFactor:-1000}
 
   if [ $ampFactor_ -eq 1000000 ] || [ $(sed s/-// $currFile) -ge 16000 ]; then
     ampFactor_=1000000
-    idleThreshold=${idleThreshold}000
   fi
 
   curThen=$TMPDIR/.curr
@@ -162,7 +166,6 @@ battCapacity=$batt/capacity
 battStatus=$battStatus
 currFile=$currFile
 curThen=$curThen
-idleThreshold=$idleThreshold
 temp=$temp
 voltNow=$voltNow" > $TMPDIR/.batt-interface.sh
 

install/default-config.txt

@@ -1,4 +1,4 @@
-configVerCode=202207250
+configVerCode=202207300
 
 ampFactor=
 battStatusWorkaround=true
@@ -8,6 +8,7 @@ cooldownRatio=()
 currentWorkaround=false
 dischargePolarity=
 forceOff=false
+idleThreshold=40
 language=en
 offMid=true
 prioritizeBattIdleMode=true
@@ -136,6 +137,8 @@ runCmdOnPause=''
 
 # forceOff=force_off=BOOLEAN
 
+# idleThreshold=idle_threshold=MILLIAMPS
+
 # language=lang=LANGUAGE_CODE NULLABLE
 
 # maxChargingCurrent=max_charging_current=(MILLIAMPS CTRL_FILE1::RAW_VALUE::DEFAULT CTRL_FILE2::RAW_VALUE::DEFAULT...)
@@ -179,6 +182,7 @@ runCmdOnPause=''
 # current_workaround cw
 # discharge_polarity dp
 # force_off fo
+# idle_threshold it
 # lang l
 # max_charging_current mcc
 # max_charging_voltage mcv
@@ -335,6 +339,10 @@ runCmdOnPause=''
 # Some people "systemlessly" disable certain thermal daemons with Magisk. While this is not a general recommendation, they swear by it.
 
 
+# idle_threshold (it) # Default: 40
+# Current threshold (absolute value) in milliamps to consider _status=Idle.
+
+
 # lang (l) # Default: en
 # Display language, when null, English (en) is assumed.
 

install/print-config.sh

@@ -15,6 +15,7 @@ cooldown_temp=${temperature[0]}
 current_workaround=$currentWorkaround
 discharge_polarity=$dischargePolarity
 force_off=$forceOff
+idle_threshold=$idleThreshold
 lang=$language
 
 max_temp=${temperature[1]}

install/write-config.sh

@@ -16,6 +16,7 @@ ct=${cooldown_temp-${ct-${temperature[0]}}}
 cw=${current_workaround-${cw-$currentWorkaround}}
 dp="${discharge_polarity-${dp-$dischargePolarity}}"
 fo="${force_off-${fo-$forceOff}}"
+it="${idle_threshold-${it-$idleThreshold}}"
 l=${lang-${l-${language}}}
 mcc="${max_charging_current-${mcc-${maxChargingCurrent[@]}}}"
 mcv="${max_charging_voltage-${mcv-${maxChargingVoltage[@]}}}"
@@ -59,6 +60,7 @@ cooldownRatio=($cch $cp)
 currentWorkaround=${cw:-false}
 dischargePolarity=$dp
 forceOff=${fo:-false}
+idleThreshold=${it:-40}
 language=${lang:-en}
 offMid=${om:-true}
 prioritizeBattIdleMode=${pbim:-true}