Documentation/devicetree/bindings/power/supply/bq24735.yaml

   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: Binding for 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     i2c0 {
  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     };