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