d8483f3148
The bindings for charger-manager were very unclear and didn't specify allowable values in many cases. Clean these up to show what each value does and make sure all properties are documented here rather than using wildcards. Signed-off-by: Jonathan Bakker <xc-racer2@live.ca> Acked-by: Rob Herring <robh@kernel.org> Signed-off-by: Sebastian Reichel <sebastian.reichel@collabora.com>
92 lines
2.9 KiB
Plaintext
92 lines
2.9 KiB
Plaintext
charger-manager bindings
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Required properties :
|
|
- compatible : "charger-manager"
|
|
- <>-supply : for regulator consumer, named according to cm-regulator-name
|
|
- cm-chargers : name of chargers
|
|
- cm-fuel-gauge : name of battery fuel gauge
|
|
- subnode <regulator> :
|
|
- cm-regulator-name : name of charger regulator
|
|
- subnode <cable> :
|
|
- cm-cable-name : name of charger cable - one of USB, USB-HOST,
|
|
SDP, DCP, CDP, ACA, FAST-CHARGER, SLOW-CHARGER, WPT,
|
|
PD, DOCK, JIG, or MECHANICAL
|
|
- cm-cable-extcon : name of extcon dev
|
|
(optional) - cm-cable-min : minimum current of cable
|
|
(optional) - cm-cable-max : maximum current of cable
|
|
|
|
Optional properties :
|
|
- cm-name : charger manager's name (default : "battery")
|
|
- cm-poll-mode : polling mode - 0 for disabled, 1 for always, 2 for when
|
|
external power is connected, or 3 for when charging. If not present,
|
|
then polling is disabled
|
|
- cm-poll-interval : polling interval (in ms)
|
|
- cm-battery-stat : battery status - 0 for battery always present, 1 for no
|
|
battery, 2 to check presence via fuel gauge, or 3 to check presence
|
|
via charger
|
|
- cm-fullbatt-vchkdrop-volt : voltage drop (in uV) before restarting charging
|
|
- cm-fullbatt-voltage : voltage (in uV) of full battery
|
|
- cm-fullbatt-soc : state of charge to consider as full battery
|
|
- cm-fullbatt-capacity : capcity (in uAh) to consider as full battery
|
|
- cm-thermal-zone : name of external thermometer's thermal zone
|
|
- cm-battery-* : threshold battery temperature for charging
|
|
-cold : critical cold temperature of battery for charging
|
|
-cold-in-minus : flag that cold temperature is in minus degrees
|
|
-hot : critical hot temperature of battery for charging
|
|
-temp-diff : temperature difference to allow recharging
|
|
- cm-dis/charging-max = limits of charging duration
|
|
|
|
Deprecated properties:
|
|
- cm-num-chargers
|
|
- cm-fullbatt-vchkdrop-ms
|
|
|
|
Example :
|
|
charger-manager@0 {
|
|
compatible = "charger-manager";
|
|
chg-reg-supply = <&charger_regulator>;
|
|
|
|
cm-name = "battery";
|
|
/* Always polling ON : 30s */
|
|
cm-poll-mode = <1>;
|
|
cm-poll-interval = <30000>;
|
|
|
|
cm-fullbatt-vchkdrop-volt = <150000>;
|
|
cm-fullbatt-soc = <100>;
|
|
|
|
cm-battery-stat = <3>;
|
|
|
|
cm-chargers = "charger0", "charger1", "charger2";
|
|
|
|
cm-fuel-gauge = "fuelgauge0";
|
|
|
|
cm-thermal-zone = "thermal_zone.1"
|
|
/* in deci centigrade */
|
|
cm-battery-cold = <50>;
|
|
cm-battery-cold-in-minus;
|
|
cm-battery-hot = <800>;
|
|
cm-battery-temp-diff = <100>;
|
|
|
|
/* Allow charging for 5hr */
|
|
cm-charging-max = <18000000>;
|
|
/* Allow discharging for 2hr */
|
|
cm-discharging-max = <7200000>;
|
|
|
|
regulator@0 {
|
|
cm-regulator-name = "chg-reg";
|
|
cable@0 {
|
|
cm-cable-name = "USB";
|
|
cm-cable-extcon = "extcon-dev.0";
|
|
cm-cable-min = <475000>;
|
|
cm-cable-max = <500000>;
|
|
};
|
|
cable@1 {
|
|
cm-cable-name = "SDP";
|
|
cm-cable-extcon = "extcon-dev.0";
|
|
cm-cable-min = <650000>;
|
|
cm-cable-max = <675000>;
|
|
};
|
|
};
|
|
|
|
};
|