]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
dt-bindings: battery: Clarify trickle-charge
authorMatti Vaittinen <mazziesaccount@gmail.com>
Mon, 15 Dec 2025 13:17:38 +0000 (15:17 +0200)
committerLee Jones <lee@kernel.org>
Tue, 13 Jan 2026 12:44:30 +0000 (12:44 +0000)
commitdc74d1107f1506176c1f4f32dbef0417f3e678e1
tree759b50da1bea345672b2f94b9acdc7900e4a87aa
parent4d08b3634fe824409e75696635fb27204b8d4720
dt-bindings: battery: Clarify trickle-charge

The term 'trickle-charging' is used to describe a very slow charging
phase, where electrons "trickle-in" the battery.

There are two different use-cases for this type of charging. At least
some Li-Ion batteries can benefit from very slow, constant current,
pre-pre phase 'trickle-charging', if a battery is very empty.

Some other batteries use top-off phase 'trickle-charging', which is
different from the above case.

The battery bindings use the term 'trickle-charge' without specifying
which of the use-cases properties are addressing. This has already
caused some confusion.

Clarify that the 'trickle-charge-current-microamp' refers to the first
one, the "pre-pre" -charging use-case.

Suggested-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Matti Vaittinen <mazziesaccount@gmail.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Link: https://patch.msgid.link/e2794140343103245410c3301f8994e1babaeb96.1765804226.git.mazziesaccount@gmail.com
Signed-off-by: Lee Jones <lee@kernel.org>
Documentation/devicetree/bindings/power/supply/battery.yaml