summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--include/battery.h3
-rw-r--r--include/config.h10
2 files changed, 8 insertions, 5 deletions
diff --git a/include/battery.h b/include/battery.h
index 55ea92a39e..3d7876662e 100644
--- a/include/battery.h
+++ b/include/battery.h
@@ -48,7 +48,8 @@ extern struct ec_response_battery_dynamic_info
/*
* Shut down main processor and/or hibernate EC when discharging and battery
- * level < this level.
+ * level < this level. Setting this too low makes the battery discharge too
+ * deeply, which isn't good for the battery health.
*/
#define BATTERY_LEVEL_SHUTDOWN 3
diff --git a/include/config.h b/include/config.h
index de48a2134a..4e07add025 100644
--- a/include/config.h
+++ b/include/config.h
@@ -489,18 +489,20 @@
* Thus, we set them as follows by default:
*
* CONFIG_CHARGER_MIN_BAT_PCT_FOR_POWER_ON = 2 (don't boot if soc < 2%)
- * CONFIG_BATT_HOST_SHUTDOWN_PERCENTAGE = 2 (shutdown if soc <= 2%)
+ * CONFIG_BATT_HOST_SHUTDOWN_PERCENTAGE = 3 (shutdown if soc <= 3%)
* BATTERY_LEVEL_SHUTDOWN = 3 (shutdown if soc < 3%)
*
* This produces the following behavior:
*
* - If soc = 1%, system doesn't boot. User wouldn't know why.
- * - If soc = 2%, system boots. Alert is shown. System immediately shuts down.
- * - If battery discharges to 2% while the system is running, system shuts down.
+ * - If soc = 2~3%, system boots. Alert is shown. System immediately shuts down.
+ * - If battery discharges to 3% while the system is running, system shuts down.
* If that happens while a user is away, they can press the power button to
* learn what happened.
+ * - If system fails to shutdown for some reason and battery further discharges
+ * to 2%, EC will trigger shutdown.
*/
-#define CONFIG_BATT_HOST_SHUTDOWN_PERCENTAGE 2 /* shutdown if soc <= 2% */
+#define CONFIG_BATT_HOST_SHUTDOWN_PERCENTAGE 3 /* shutdown if soc <= 3% */
/*
* Powerd's full_factor. The value comes from: