1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 # Copyright (C) 2020 Texas Instruments Incorpo 2 # Copyright (C) 2020 Texas Instruments Incorporated
3 %YAML 1.2 3 %YAML 1.2
4 --- 4 ---
5 $id: http://devicetree.org/schemas/power/suppl !! 5 $id: "http://devicetree.org/schemas/power/supply/bq27xxx.yaml#"
6 $schema: http://devicetree.org/meta-schemas/co !! 6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
7 7
8 title: TI BQ27XXX fuel gauge family 8 title: TI BQ27XXX fuel gauge family
9 9
10 maintainers: 10 maintainers:
11 - Pali Rohár <pali@kernel.org> 11 - Pali Rohár <pali@kernel.org>
12 - Andrew F. Davis <afd@ti.com> 12 - Andrew F. Davis <afd@ti.com>
13 - Sebastian Reichel <sre@kernel.org> 13 - Sebastian Reichel <sre@kernel.org>
14 14
15 description: | 15 description: |
16 Support various Texas Instruments fuel gauge 16 Support various Texas Instruments fuel gauge devices that share similar
17 register maps and power supply properties 17 register maps and power supply properties
18 18
19 allOf: 19 allOf:
20 - $ref: power-supply.yaml# 20 - $ref: power-supply.yaml#
21 21
22 properties: 22 properties:
23 compatible: 23 compatible:
24 enum: 24 enum:
25 - ti,bq27200 25 - ti,bq27200
26 - ti,bq27210 26 - ti,bq27210
27 - ti,bq27500 # deprecated, use revision 27 - ti,bq27500 # deprecated, use revision specific property below
28 - ti,bq27510 # deprecated, use revision 28 - ti,bq27510 # deprecated, use revision specific property below
29 - ti,bq27520 # deprecated, use revision 29 - ti,bq27520 # deprecated, use revision specific property below
30 - ti,bq27500-1 30 - ti,bq27500-1
31 - ti,bq27510g1 31 - ti,bq27510g1
32 - ti,bq27510g2 32 - ti,bq27510g2
33 - ti,bq27510g3 33 - ti,bq27510g3
34 - ti,bq27520g1 34 - ti,bq27520g1
35 - ti,bq27520g2 35 - ti,bq27520g2
36 - ti,bq27520g3 36 - ti,bq27520g3
37 - ti,bq27520g4 37 - ti,bq27520g4
38 - ti,bq27521 38 - ti,bq27521
39 - ti,bq27530 39 - ti,bq27530
40 - ti,bq27531 40 - ti,bq27531
41 - ti,bq27541 41 - ti,bq27541
42 - ti,bq27542 42 - ti,bq27542
43 - ti,bq27546 43 - ti,bq27546
44 - ti,bq27742 44 - ti,bq27742
45 - ti,bq27545 45 - ti,bq27545
46 - ti,bq27411 46 - ti,bq27411
47 - ti,bq27421 47 - ti,bq27421
48 - ti,bq27425 48 - ti,bq27425
49 - ti,bq27426 49 - ti,bq27426
50 - ti,bq27441 50 - ti,bq27441
51 - ti,bq27621 51 - ti,bq27621
52 - ti,bq27z561 52 - ti,bq27z561
53 - ti,bq28z610 53 - ti,bq28z610
54 - ti,bq34z100 <<
55 - ti,bq78z100 <<
56 54
57 reg: 55 reg:
58 maxItems: 1 56 maxItems: 1
59 description: integer, I2C address of the f 57 description: integer, I2C address of the fuel gauge.
60 58
61 monitored-battery: 59 monitored-battery:
62 description: | 60 description: |
>> 61 phandle of battery characteristics node.
63 The fuel gauge uses the following batte 62 The fuel gauge uses the following battery properties:
64 - energy-full-design-microwatt-hours 63 - energy-full-design-microwatt-hours
65 - charge-full-design-microamp-hours 64 - charge-full-design-microamp-hours
66 - voltage-min-design-microvolt 65 - voltage-min-design-microvolt
67 Both or neither of the *-full-design-*- 66 Both or neither of the *-full-design-*-hours properties must be set.
>> 67 See Documentation/devicetree/bindings/power/supply/battery.txt
68 68
69 power-supplies: true 69 power-supplies: true
70 70
71 required: 71 required:
72 - compatible 72 - compatible
73 - reg 73 - reg
74 additionalProperties: false 74 additionalProperties: false
75 75
76 examples: 76 examples:
77 - | 77 - |
78 bat: battery { !! 78 i2c0 {
79 compatible = "simple-battery"; <<
80 voltage-min-design-microvolt = <3200000> <<
81 energy-full-design-microwatt-hours = <52 <<
82 charge-full-design-microamp-hours = <143 <<
83 }; <<
84 <<
85 i2c { <<
86 #address-cells = <1>; 79 #address-cells = <1>;
87 #size-cells = <0>; 80 #size-cells = <0>;
>> 81 bat: battery {
>> 82 compatible = "simple-battery";
>> 83 voltage-min-design-microvolt = <3200000>;
>> 84 energy-full-design-microwatt-hours = <5290000>;
>> 85 charge-full-design-microamp-hours = <1430000>;
>> 86 };
88 87
89 bq27510g3: fuel-gauge@55 { 88 bq27510g3: fuel-gauge@55 {
90 compatible = "ti,bq27510g3"; 89 compatible = "ti,bq27510g3";
91 reg = <0x55>; 90 reg = <0x55>;
92 monitored-battery = <&bat>; 91 monitored-battery = <&bat>;
93 }; 92 };
94 }; 93 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.