xref: /openbmc/linux/Documentation/devicetree/bindings/power/supply/twl4030-charger.yaml (revision bb56712abab423881808cdbac92db742b806bc9a)
1*bb56712aSSebastian Reichel# SPDX-License-Identifier: GPL-2.0
2*bb56712aSSebastian Reichel%YAML 1.2
3*bb56712aSSebastian Reichel---
4*bb56712aSSebastian Reichel$id: "http://devicetree.org/schemas/power/supply/twl4030-charger.yaml#"
5*bb56712aSSebastian Reichel$schema: "http://devicetree.org/meta-schemas/core.yaml#"
6*bb56712aSSebastian Reichel
7*bb56712aSSebastian Reicheltitle: TWL4030 BCI (Battery Charger Interface)
8*bb56712aSSebastian Reichel
9*bb56712aSSebastian Reicheldescription: |
10*bb56712aSSebastian Reichel  The battery charger needs to interact with the USB phy in order to know when
11*bb56712aSSebastian Reichel  charging is permissible, and when there is a connection or disconnection.
12*bb56712aSSebastian Reichel
13*bb56712aSSebastian Reichel  The choice of phy cannot be configured at a hardware level, so there is no
14*bb56712aSSebastian Reichel  value in explicit configuration in device-tree. Rather if there is a sibling
15*bb56712aSSebastian Reichel  of the BCI node which is compatible with "ti,twl4030-usb", then that is used
16*bb56712aSSebastian Reichel  to determine when and how use USB power for charging.
17*bb56712aSSebastian Reichel
18*bb56712aSSebastian Reichelmaintainers:
19*bb56712aSSebastian Reichel  - Sebastian Reichel <sre@kernel.org>
20*bb56712aSSebastian Reichel
21*bb56712aSSebastian ReichelallOf:
22*bb56712aSSebastian Reichel  - $ref: power-supply.yaml#
23*bb56712aSSebastian Reichel
24*bb56712aSSebastian Reichelproperties:
25*bb56712aSSebastian Reichel  compatible:
26*bb56712aSSebastian Reichel    const: ti,twl4030-bci
27*bb56712aSSebastian Reichel
28*bb56712aSSebastian Reichel  interrupts:
29*bb56712aSSebastian Reichel    minItems: 2
30*bb56712aSSebastian Reichel    maxItems: 2
31*bb56712aSSebastian Reichel
32*bb56712aSSebastian Reichel  ti,bb-uvolt:
33*bb56712aSSebastian Reichel    $ref: /schemas/types.yaml#/definitions/uint32
34*bb56712aSSebastian Reichel    description: microvolts for charging the backup battery
35*bb56712aSSebastian Reichel
36*bb56712aSSebastian Reichel  ti,bb-uamp:
37*bb56712aSSebastian Reichel    $ref: /schemas/types.yaml#/definitions/uint32
38*bb56712aSSebastian Reichel    description: microamps for charging the backup battery
39*bb56712aSSebastian Reichel
40*bb56712aSSebastian Reichel  io-channels:
41*bb56712aSSebastian Reichel    items:
42*bb56712aSSebastian Reichel      - description: Accessory Charger Voltage Channel
43*bb56712aSSebastian Reichel
44*bb56712aSSebastian Reichel  io-channel-names:
45*bb56712aSSebastian Reichel    items:
46*bb56712aSSebastian Reichel      - const: vac
47*bb56712aSSebastian Reichel
48*bb56712aSSebastian Reichel  bci3v1-supply:
49*bb56712aSSebastian Reichel    description: 3.1V USB regulator
50*bb56712aSSebastian Reichel
51*bb56712aSSebastian Reichelrequired:
52*bb56712aSSebastian Reichel  - compatible
53*bb56712aSSebastian Reichel  - interrupts
54*bb56712aSSebastian Reichel
55*bb56712aSSebastian ReicheladditionalProperties: false
56*bb56712aSSebastian Reichel
57*bb56712aSSebastian Reichelexamples:
58*bb56712aSSebastian Reichel  - |
59*bb56712aSSebastian Reichel    pmic {
60*bb56712aSSebastian Reichel      charger {
61*bb56712aSSebastian Reichel        compatible = "ti,twl4030-bci";
62*bb56712aSSebastian Reichel        interrupts = <9>, <2>;
63*bb56712aSSebastian Reichel        ti,bb-uvolt = <3200000>;
64*bb56712aSSebastian Reichel        ti,bb-uamp = <150>;
65*bb56712aSSebastian Reichel        io-channels = <&twl_madc 11>;
66*bb56712aSSebastian Reichel        io-channel-names = "vac";
67*bb56712aSSebastian Reichel      };
68*bb56712aSSebastian Reichel    };
69