Documentation/devicetree/bindings/power/supply/sc27xx-fg.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: "http://devicetree.org/schemas/power/supply/sc27xx-fg.yaml#"
   5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   6
   7 title: Spreadtrum SC27XX PMICs Fuel Gauge Unit Power Supply Bindings
   8
   9 maintainers:
  10   - Sebastian Reichel <sre@kernel.org>
  11
  12 allOf:
  13   - $ref: power-supply.yaml#
  14
  15 properties:
  16   compatible:
  17     enum:
  18       - sprd,sc2720-fgu
  19       - sprd,sc2721-fgu
  20       - sprd,sc2723-fgu
  21       - sprd,sc2730-fgu
  22       - sprd,sc2731-fgu
  23
  24   reg:
  25     maxItems: 1
  26
  27   battery-detect-gpios:
  28     maxItems: 1
  29
  30   io-channels:
  31     items:
  32       - description: Battery Temperature ADC
  33       - description: Battery Charge Voltage ADC
  34
  35   io-channel-names:
  36     items:
  37       - const: bat-temp
  38       - const: charge-vol
  39
  40   nvmem-cells:
  41     maxItems: 1
  42     description: Calibration cells provided by eFuse device
  43
  44   nvmem-cell-names:
  45     const: fgu_calib
  46
  47   sprd,calib-resistance-micro-ohms:
  48     description: real resistance of coulomb counter chip in micro Ohms
  49
  50   monitored-battery: true
  51
  52 required:
  53   - compatible
  54   - reg
  55   - battery-detect-gpios
  56   - io-channels
  57   - io-channel-names
  58   - nvmem-cells
  59   - nvmem-cell-names
  60   - sprd,calib-resistance-micro-ohms
  61   - monitored-battery
  62
  63 additionalProperties: false
  64
  65 examples:
  66   - |
  67     #include <dt-bindings/gpio/gpio.h>
  68     bat: battery {
  69       compatible = "simple-battery";
  70       charge-full-design-microamp-hours = <1900000>;
  71       constant-charge-voltage-max-microvolt = <4350000>;
  72       ocv-capacity-celsius = <20>;
  73       ocv-capacity-table-0 = <4185000 100>, <4113000 95>, <4066000 90>,
  74                              <4022000 85>, <3983000 80>, <3949000 75>,
  75                              <3917000 70>, <3889000 65>, <3864000 60>,
  76                              <3835000 55>, <3805000 50>, <3787000 45>,
  77                              <3777000 40>, <3773000 35>, <3770000 30>,
  78                              <3765000 25>, <3752000 20>, <3724000 15>,
  79                              <3680000 10>, <3605000 5>, <3400000 0>;
  80                              // ...
  81     };
  82
  83     pmic {
  84       #address-cells = <1>;
  85       #size-cells = <0>;
  86
  87       battery@a00 {
  88         compatible = "sprd,sc2731-fgu";
  89         reg = <0xa00>;
  90         battery-detect-gpios = <&pmic_eic 9 GPIO_ACTIVE_HIGH>;
  91         io-channels = <&pmic_adc 5>, <&pmic_adc 14>;
  92         io-channel-names = "bat-temp", "charge-vol";
  93         nvmem-cells = <&fgu_calib>;
  94         nvmem-cell-names = "fgu_calib";
  95         monitored-battery = <&bat>;
  96         sprd,calib-resistance-micro-ohms = <21500>;
  97       };
  98     };