1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 # Copyright (C) 2021 Sebastian Reichel 2 # Copyright (C) 2021 Sebastian Reichel
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/bq24735.yaml#"
6 $schema: http://devicetree.org/meta-schemas/co !! 6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
7 7
8 title: TI BQ24735 Li-Ion Battery Charger !! 8 title: Binding for TI BQ24735 Li-Ion Battery Charger
9 9
10 maintainers: 10 maintainers:
11 - Sebastian Reichel <sre@kernel.org> 11 - Sebastian Reichel <sre@kernel.org>
12 12
13 allOf: 13 allOf:
14 - $ref: power-supply.yaml# 14 - $ref: power-supply.yaml#
15 15
16 properties: 16 properties:
17 compatible: 17 compatible:
18 const: ti,bq24735 18 const: ti,bq24735
19 19
20 reg: 20 reg:
21 maxItems: 1 21 maxItems: 1
22 22
23 interrupts: 23 interrupts:
24 description: AC adapter plug event interru 24 description: AC adapter plug event interrupt
25 maxItems: 1 25 maxItems: 1
26 26
27 ti,ac-detect-gpios: 27 ti,ac-detect-gpios:
28 maxItems: 1 28 maxItems: 1
29 description: | 29 description: |
30 This GPIO is optionally used to read the 30 This GPIO is optionally used to read the AC adapter status. This is a Host GPIO
31 that is configured as an input and conne 31 that is configured as an input and connected to the ACOK pin on the bq24735.
32 Note: for backwards compatibility reason 32 Note: for backwards compatibility reasons, the GPIO must be active on AC adapter
33 absence despite ACOK being active (high) 33 absence despite ACOK being active (high) on AC adapter presence.
34 34
35 ti,charge-current: 35 ti,charge-current:
36 $ref: /schemas/types.yaml#/definitions/uin 36 $ref: /schemas/types.yaml#/definitions/uint32
37 description: | 37 description: |
38 Used to control and set the charging cur 38 Used to control and set the charging current.
39 This value must be between 128mA and 8.1 39 This value must be between 128mA and 8.128A with a 64mA step resolution.
40 The POR value is 0x0000h. This number is 40 The POR value is 0x0000h. This number is in mA (e.g. 8192).
41 See spec for more information about the 41 See spec for more information about the ChargeCurrent (0x14h) register.
42 42
43 ti,charge-voltage: 43 ti,charge-voltage:
44 $ref: /schemas/types.yaml#/definitions/uin 44 $ref: /schemas/types.yaml#/definitions/uint32
45 description: | 45 description: |
46 Used to control and set the charging vol 46 Used to control and set the charging voltage.
47 This value must be between 1.024V and 19 47 This value must be between 1.024V and 19.2V with a 16mV step resolution.
48 The POR value is 0x0000h. This number is 48 The POR value is 0x0000h. This number is in mV (e.g. 19200).
49 See spec for more information about the 49 See spec for more information about the ChargeVoltage (0x15h) register.
50 50
51 ti,input-current: 51 ti,input-current:
52 $ref: /schemas/types.yaml#/definitions/uin 52 $ref: /schemas/types.yaml#/definitions/uint32
53 description: | 53 description: |
54 Used to control and set the charger inpu 54 Used to control and set the charger input current.
55 This value must be between 128mA and 8.0 55 This value must be between 128mA and 8.064A with a 128mA step resolution.
56 The POR value is 0x1000h. This number is 56 The POR value is 0x1000h. This number is in mA (e.g. 8064).
57 See the spec for more information about 57 See the spec for more information about the InputCurrent (0x3fh) register.
58 58
59 ti,external-control: 59 ti,external-control:
60 type: boolean 60 type: boolean
61 description: | 61 description: |
62 Indicates that the charger is configured 62 Indicates that the charger is configured externally and that the host should not
63 attempt to enable/disable charging or se 63 attempt to enable/disable charging or set the charge voltage/current.
64 64
65 poll-interval: 65 poll-interval:
66 $ref: /schemas/types.yaml#/definitions/uin 66 $ref: /schemas/types.yaml#/definitions/uint32
67 description: | 67 description: |
68 If 'interrupts' is not specified, poll A 68 If 'interrupts' is not specified, poll AC adapter presence with this interval (milliseconds).
69 69
70 required: 70 required:
71 - compatible 71 - compatible
72 - reg 72 - reg
73 73
74 additionalProperties: false 74 additionalProperties: false
75 75
76 examples: 76 examples:
77 - | 77 - |
78 #include <dt-bindings/gpio/gpio.h> 78 #include <dt-bindings/gpio/gpio.h>
79 79
80 i2c { !! 80 i2c0 {
81 #address-cells = <1>; 81 #address-cells = <1>;
82 #size-cells = <0>; 82 #size-cells = <0>;
83 83
84 charger@9 { 84 charger@9 {
85 compatible = "ti,bq24735"; 85 compatible = "ti,bq24735";
86 reg = <0x9>; 86 reg = <0x9>;
87 ti,ac-detect-gpios = <&gpio 72 0x1>; 87 ti,ac-detect-gpios = <&gpio 72 0x1>;
88 }; 88 };
89 }; 89 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.