bq256xx.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2# Copyright (C) 2020 Texas Instruments Incorporated
  3%YAML 1.2
  4---
  5$id: http://devicetree.org/schemas/power/supply/bq256xx.yaml#
  6$schema: http://devicetree.org/meta-schemas/core.yaml#
  7
  8title: TI bq256xx Switch Mode Buck Charger
  9
 10maintainers:
 11  - Andrew Davis <afd@ti.com>
 12
 13description: |
 14  The bq256xx devices are a family of highly-integrated battery charge
 15  management and system power management ICs for single cell Li-ion and Li-
 16  polymer batteries.
 17
 18  Datasheets:
 19    - https://www.ti.com/lit/ds/symlink/bq25600.pdf
 20    - https://www.ti.com/lit/ds/symlink/bq25601.pdf
 21    - https://www.ti.com/lit/ds/symlink/bq25600d.pdf
 22    - https://www.ti.com/lit/ds/symlink/bq25601d.pdf
 23    - https://www.ti.com/lit/ds/symlink/bq25611d.pdf
 24    - https://www.ti.com/lit/ds/symlink/bq25618.pdf
 25    - https://www.ti.com/lit/ds/symlink/bq25619.pdf
 26
 27properties:
 28  compatible:
 29    enum:
 30      - ti,bq25600
 31      - ti,bq25601
 32      - ti,bq25600d
 33      - ti,bq25601d
 34      - ti,bq25611d
 35      - ti,bq25618
 36      - ti,bq25619
 37
 38  reg:
 39    maxItems: 1
 40
 41  ti,watchdog-timeout-ms:
 42    default: 0
 43    description: |
 44      Watchdog timer in ms. 0 (default) disables the watchdog
 45    minimum: 0
 46    maximum: 160000
 47    enum: [ 0, 40000, 80000, 160000]
 48
 49  input-voltage-limit-microvolt:
 50    description: |
 51       Minimum input voltage limit in µV with a 100000 µV step
 52    minimum: 3900000
 53    maximum: 5400000
 54
 55  input-current-limit-microamp:
 56    description: |
 57       Maximum input current limit in µA with a 100000 µA step
 58    minimum: 100000
 59    maximum: 3200000
 60
 61  monitored-battery: true
 62
 63  interrupts:
 64    maxItems: 1
 65    description: |
 66      Interrupt sends an active low, 256 μs pulse to host to report the charger
 67      device status and faults.
 68
 69  ti,no-thermistor:
 70    type: boolean
 71    description: Indicates that no thermistor is connected to the TS pin
 72
 73required:
 74  - compatible
 75  - reg
 76  - monitored-battery
 77
 78allOf:
 79  - $ref: power-supply.yaml#
 80  - if:
 81      properties:
 82        compatible:
 83          contains:
 84            enum:
 85              - ti,bq25600
 86              - ti,bq25601
 87              - ti,bq25600d
 88              - ti,bq25601d
 89    then:
 90      properties:
 91        ti,no-thermistor: false
 92
 93additionalProperties: false
 94
 95examples:
 96  - |
 97    bat: battery {
 98      compatible = "simple-battery";
 99      constant-charge-current-max-microamp = <2040000>;
100      constant-charge-voltage-max-microvolt = <4352000>;
101      precharge-current-microamp = <180000>;
102      charge-term-current-microamp = <180000>;
103    };
104    #include <dt-bindings/gpio/gpio.h>
105    #include <dt-bindings/interrupt-controller/irq.h>
106    i2c {
107
108      clock-frequency = <400000>;
109
110      #address-cells = <1>;
111      #size-cells = <0>;
112
113      charger@6b {
114        compatible = "ti,bq25601";
115        reg = <0x6b>;
116        monitored-battery = <&bat>;
117
118        interrupt-parent = <&gpio1>;
119        interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
120        ti,watchdog-timeout-ms = <40000>;
121
122        input-voltage-limit-microvolt = <4500000>;
123        input-current-limit-microamp = <2400000>;
124       };
125    };
126...