tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-binding: power: Add Qualcomm SMBB binding
Add the Qualcomm Switch-Mode Battery Charger and Boost device tree
binding.
Signed-off-by: Courtney Cavin <courtney.cavin@sonymobile.com>
Signed-off-by: Bjorn Andersson <bjorn.andersson@sonymobile.com>
Signed-off-by: Sebastian Reichel <sre@kernel.org>
authored by
Courtney Cavin
and committed by
Sebastian Reichel
43fde00b
da42bbd9
+131
+131
Documentation/devicetree/bindings/power_supply/qcom_smbb.txt
+131
Documentation/devicetree/bindings/power_supply/qcom_smbb.txt
···
1
+
Qualcomm Switch-Mode Battery Charger and Boost
2
+
3
+
PROPERTIES
4
+
- compatible:
5
+
Usage: required
6
+
Value type: <stringlist>
7
+
Description: Must be one of:
8
+
- "qcom,pm8941-charger"
9
+
10
+
- reg:
11
+
Usage: required
12
+
Value type: <prop-encoded-array>
13
+
Description: Base address of registers for SMBB block
14
+
15
+
- interrupts:
16
+
Usage: required
17
+
Value type: <prop-encoded-array>
18
+
Description: The format of the specifier is defined by the binding document
19
+
describing the node's interrupt parent. Must contain one
20
+
specifier for each of the following interrupts, in order:
21
+
- charge done
22
+
- charge fast mode
23
+
- charge trickle mode
24
+
- battery temperature ok
25
+
- battery present
26
+
- charger disconnected
27
+
- USB-in valid
28
+
- DC-in valid
29
+
30
+
- interrupt-names:
31
+
Usage: required
32
+
Value type: <stringlist>
33
+
Description: Must contain the following list, strictly ordered:
34
+
"chg-done",
35
+
"chg-fast",
36
+
"chg-trkl",
37
+
"bat-temp-ok",
38
+
"bat-present",
39
+
"chg-gone",
40
+
"usb-valid",
41
+
"dc-valid"
42
+
43
+
- qcom,fast-charge-current-limit:
44
+
Usage: optional (default: 1A, or pre-configured value)
45
+
Value type: <u32>; uA; range [100mA : 3A]
46
+
Description: Maximum charge current; May be clamped to safety limits.
47
+
48
+
- qcom,fast-charge-low-threshold-voltage:
49
+
Usage: optional (default: 3.2V, or pre-configured value)
50
+
Value type: <u32>; uV; range [2.1V : 3.6V]
51
+
Description: Battery voltage limit above which fast charging may operate;
52
+
Below this value linear or switch-mode auto-trickle-charging
53
+
will operate.
54
+
55
+
- qcom,fast-charge-high-threshold-voltage:
56
+
Usage: optional (default: 4.2V, or pre-configured value)
57
+
Value type: <u32>; uV; range [3.24V : 5V]
58
+
Description: Battery voltage limit below which fast charging may operate;
59
+
The fast charger will attempt to charge the battery to this
60
+
voltage. May be clamped to safety limits.
61
+
62
+
- qcom,fast-charge-safe-voltage:
63
+
Usage: optional (default: 4.2V, or pre-configured value)
64
+
Value type: <u32>; uV; range [3.24V : 5V]
65
+
Description: Maximum safe battery voltage; May be pre-set by bootloader, in
66
+
which case, setting this will harmlessly fail. The property
67
+
'fast-charge-high-watermark' will be clamped by this value.
68
+
69
+
- qcom,fast-charge-safe-current:
70
+
Usage: optional (default: 1A, or pre-configured value)
71
+
Value type: <u32>; uA; range [100mA : 3A]
72
+
Description: Maximum safe battery charge current; May pre-set by bootloader,
73
+
in which case, setting this will harmlessly fail. The property
74
+
'qcom,fast-charge-current-limit' will be clamped by this value.
75
+
76
+
- qcom,auto-recharge-threshold-voltage:
77
+
Usage: optional (default: 4.1V, or pre-configured value)
78
+
Value type: <u32>; uV; range [3.24V : 5V]
79
+
Description: Battery voltage limit below which auto-recharge functionality
80
+
will restart charging after end-of-charge; The high cutoff
81
+
limit for auto-recharge is 5% above this value.
82
+
83
+
- qcom,minimum-input-voltage:
84
+
Usage: optional (default: 4.3V, or pre-configured value)
85
+
Value type: <u32>; uV; range [4.2V : 9.6V]
86
+
Description: Input voltage level above which charging may operate
87
+
88
+
- qcom,dc-current-limit:
89
+
Usage: optional (default: 100mA, or pre-configured value)
90
+
Value type: <u32>; uA; range [100mA : 2.5A]
91
+
Description: Default DC charge current limit
92
+
93
+
- qcom,disable-dc:
94
+
Usage: optional (default: false)
95
+
Value type: boolean: <u32> or <empty>
96
+
Description: Disable DC charger
97
+
98
+
- qcom,jeita-extended-temp-range:
99
+
Usage: optional (default: false)
100
+
Value type: boolean: <u32> or <empty>
101
+
Description: Enable JEITA extended temperature range; This does *not*
102
+
adjust the maximum charge voltage or current in the extended
103
+
temperature range. It only allows charging when the battery
104
+
is in the extended temperature range. Voltage/current
105
+
regulation must be done externally to fully comply with
106
+
the JEITA safety guidelines if this flag is set.
107
+
108
+
EXAMPLE
109
+
charger@1000 {
110
+
compatible = "qcom,pm8941-charger";
111
+
reg = <0x1000 0x700>;
112
+
interrupts = <0x0 0x10 7 IRQ_TYPE_EDGE_BOTH>,
113
+
<0x0 0x10 5 IRQ_TYPE_EDGE_BOTH>,
114
+
<0x0 0x10 4 IRQ_TYPE_EDGE_BOTH>,
115
+
<0x0 0x12 1 IRQ_TYPE_EDGE_BOTH>,
116
+
<0x0 0x12 0 IRQ_TYPE_EDGE_BOTH>,
117
+
<0x0 0x13 2 IRQ_TYPE_EDGE_BOTH>,
118
+
<0x0 0x13 1 IRQ_TYPE_EDGE_BOTH>,
119
+
<0x0 0x14 1 IRQ_TYPE_EDGE_BOTH>;
120
+
interrupt-names = "chg-done",
121
+
"chg-fast",
122
+
"chg-trkl",
123
+
"bat-temp-ok",
124
+
"bat-present",
125
+
"chg-gone",
126
+
"usb-valid",
127
+
"dc-valid";
128
+
129
+
qcom,fast-charge-current-limit = <1000000>;
130
+
qcom,dc-charge-current-limit = <1000000>;
131
+
};