[PATCH 1/3] dt-bindings: power: supply: battery: Add a charging temperature range
From: Alexey Charkov
Date: Mon Nov 09 2026 - 04:47:55 EST
Describe batteries rated for separate charging and discharging
temperature ranges, such as 0-45C for charging and -20-60C for
discharging, often with a reduced charge current near the ends of the
charging range: operating-range-celsius holds a single range, and
existing users read it both as the limit for any use of the battery and
as the limit for charging.
Add charge-temp-range-celsius for the charging range, falling back to
operating-range-celsius when absent, and state that
operating-range-celsius covers discharging. Add the charge current and
voltage to use between alert-celsius and the charging range limits, to
describe a reduced charge rate near those limits and none beyond them.
A missing half of an alert charge current and voltage pair falls back to
the matching constant-charge-* setting. alert-celsius is expected to fully
fall inside charge-temp-range-celsius, but when it does not,
charge-temp-range-celsius takes precedence to ensure no charge occurs
outside the allowed range.
Signed-off-by: Alexey Charkov <alchark@xxxxxxxxxxx>
---
.../devicetree/bindings/power/supply/battery.yaml | 45 +++++++++++++++++++++-
1 file changed, 43 insertions(+), 2 deletions(-)
diff --git a/Documentation/devicetree/bindings/power/supply/battery.yaml b/Documentation/devicetree/bindings/power/supply/battery.yaml
index 9575ee1491bb..d2f2ed9a01fe 100644
--- a/Documentation/devicetree/bindings/power/supply/battery.yaml
+++ b/Documentation/devicetree/bindings/power/supply/battery.yaml
@@ -111,11 +111,21 @@ properties:
for each of the battery capacity lookup table.
operating-range-celsius:
- description: operating temperature range of a battery
+ description: operating temperature range of a battery, in which it can be
+ discharged. Charging may be further restricted by
+ charge-temp-range-celsius.
items:
- description: minimum temperature at which battery can operate
- description: maximum temperature at which battery can operate
+ charge-temp-range-celsius:
+ description: temperature range in which the battery can be charged, within
+ operating-range-celsius. If absent, the battery can be charged in all of
+ operating-range-celsius. Outside this range the battery is not charged.
+ items:
+ - description: minimum temperature at which battery can be charged
+ - description: maximum temperature at which battery can be charged
+
ambient-celsius:
description: safe range of ambient temperature
items:
@@ -123,11 +133,39 @@ properties:
- description: alert when ambient temperature is higher than this value
alert-celsius:
- description: safe range of battery temperature
+ description: safe range of battery temperature. Where a limit of this
+ range lies within charge-temp-range-celsius, the battery is charged
+ between the two limits with the alert-low-temp-charge-* or
+ alert-high-temp-charge-* settings. Each of those that is absent falls
+ back to the corresponding constant-charge-* setting.
items:
- description: alert when battery temperature is lower than this value
- description: alert when battery temperature is higher than this value
+ alert-low-temp-charge-current-microamp:
+ description: charge current in place of
+ constant-charge-current-max-microamp, while the battery temperature is
+ between the lower limits of charge-temp-range-celsius and alert-celsius
+ minimum: 1
+
+ alert-low-temp-charge-voltage-microvolt:
+ description: charge voltage in place of
+ constant-charge-voltage-max-microvolt, while the battery temperature is
+ between the lower limits of charge-temp-range-celsius and alert-celsius
+ minimum: 1
+
+ alert-high-temp-charge-current-microamp:
+ description: charge current in place of
+ constant-charge-current-max-microamp, while the battery temperature is
+ between the upper limits of alert-celsius and charge-temp-range-celsius
+ minimum: 1
+
+ alert-high-temp-charge-voltage-microvolt:
+ description: charge voltage in place of
+ constant-charge-voltage-max-microvolt, while the battery temperature is
+ between the upper limits of alert-celsius and charge-temp-range-celsius
+ minimum: 1
+
# The volt-drop* -properties describe voltage-drop for a battery, described
# as VDROP in:
# https://patentimages.storage.googleapis.com/6c/f5/17/c1d901c220f6a9/US20150032394A1.pdf
@@ -200,8 +238,11 @@ examples:
ocv-capacity-table-2 = <4250000 100>, <4200000 95>, <4185000 90>;
resistance-temp-table = <20 100>, <10 90>, <0 80>, <(-10) 60>;
operating-range-celsius = <(-30) 50>;
+ charge-temp-range-celsius = <0 45>;
ambient-celsius = <(-5) 50>;
alert-celsius = <0 40>;
+ alert-high-temp-charge-current-microamp = <450000>;
+ alert-high-temp-charge-voltage-microvolt = <4100000>;
};
charger@11 {
--
2.56.0