summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPeter Marheine <pmarheine@chromium.org>2022-12-15 11:33:19 +1100
committerChromeos LUCI <chromeos-scoped@luci-project-accounts.iam.gserviceaccount.com>2023-01-12 22:52:09 +0000
commit49abac39678928a242f94115f523ba462146412a (patch)
tree4f49575ca917686881027e18bfa17d6cbef6ece5 /docs
parent9a9669c83100f8833d066e8a0e58a561075c3e9f (diff)
downloadchrome-ec-49abac39678928a242f94115f523ba462146412a.tar.gz
Default charger current derating to 5%
Not derating seems like a common pitfall that can cause problems with some chargers, so set a reasonably conservative default. 5% is chosen as the most common derating factor used among boards today (counting occurrences in source code, so this may undercount 5% occurrences because several projects set 5% at the project rather than board-level): 1. 38 x 5% 2. 23 x 4% 3. 6 x 10% 3. 2 x 3% 4. 1 x 2% Boards that currently configure this setting are modified only to continue building without warnings regardless of whether they use the new default value in order to signal that they were explicitly configured. BUG=b:260774380 TEST=make buildall / zmake build -a BRANCH=none Change-Id: I017849d38572fbc48090ae1fa2c539b808e426f9 Signed-off-by: Peter Marheine <pmarheine@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/4109651 Reviewed-by: Daisuke Nojiri <dnojiri@chromium.org> Code-Coverage: Zoss <zoss-cl-coverage@prod.google.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/low_battery_startup.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/low_battery_startup.md b/docs/low_battery_startup.md
index 1f94d4956e..c82268a308 100644
--- a/docs/low_battery_startup.md
+++ b/docs/low_battery_startup.md
@@ -427,3 +427,13 @@ Optional.
Similar to `CONFIG_CHARGER_MIN_POWER_MW_FOR_POWER_ON`, this is the minimum
charger power needed to boot even when the battery is less than
`CONFIG_CHARGER_MIN_BAT_PCT_FOR_POWER_ON_WITH_AC`
+
+### `CONFIG_CHARGER_INPUT_CURRENT_DERATE_PCT`
+
+Optional, default 5%.
+
+This option reduces the charger's programmed current limit below the detected
+current limit for a given charger in an attempt to ensure that load transients
+won't overcurrent the source. Devices that require a lot of power to boot may
+need to either decrease the derating factor (if behavior remains acceptable when
+decreased) or increase `MIN_POWER_MW` settings to compensate. \ No newline at end of file