Documentation/devicetree/bindings/power_supply/qcom_smbb.txt

   1 Qualcomm Switch-Mode Battery Charger and Boost
   2
   3 PROPERTIES
   4 - compatible:
   5   Usage: required
   6   Value type: <stringlist>
   7   Description: Must be one of:
   8                - "qcom,pm8941-charger"
   9
  10 - reg:
  11   Usage: required
  12   Value type: <prop-encoded-array>
  13   Description: Base address of registers for SMBB block
  14
  15 - interrupts:
  16   Usage: required
  17   Value type: <prop-encoded-array>
  18   Description: The format of the specifier is defined by the binding document
  19                describing the node's interrupt parent.  Must contain one
  20                specifier for each of the following interrupts, in order:
  21                - charge done
  22                - charge fast mode
  23                - charge trickle mode
  24                - battery temperature ok
  25                - battery present
  26                - charger disconnected
  27                - USB-in valid
  28                - DC-in valid
  29
  30 - interrupt-names:
  31   Usage: required
  32   Value type: <stringlist>
  33   Description: Must contain the following list, strictly ordered:
  34                "chg-done",
  35                "chg-fast",
  36                "chg-trkl",
  37                "bat-temp-ok",
  38                "bat-present",
  39                "chg-gone",
  40                "usb-valid",
  41                "dc-valid"
  42
  43 - qcom,fast-charge-current-limit:
  44   Usage: optional (default: 1A, or pre-configured value)
  45   Value type: <u32>; uA; range [100mA : 3A]
  46   Description: Maximum charge current; May be clamped to safety limits.
  47
  48 - qcom,fast-charge-low-threshold-voltage:
  49   Usage: optional (default: 3.2V, or pre-configured value)
  50   Value type: <u32>; uV; range [2.1V : 3.6V]
  51   Description: Battery voltage limit above which fast charging may operate;
  52                Below this value linear or switch-mode auto-trickle-charging
  53                will operate.
  54
  55 - qcom,fast-charge-high-threshold-voltage:
  56   Usage: optional (default: 4.2V, or pre-configured value)
  57   Value type: <u32>; uV; range [3.24V : 5V]
  58   Description: Battery voltage limit below which fast charging may operate;
  59                The fast charger will attempt to charge the battery to this
  60                voltage.  May be clamped to safety limits.
  61
  62 - qcom,fast-charge-safe-voltage:
  63   Usage: optional (default: 4.2V, or pre-configured value)
  64   Value type: <u32>; uV; range [3.24V : 5V]
  65   Description: Maximum safe battery voltage; May be pre-set by bootloader, in
  66                which case, setting this will harmlessly fail. The property
  67                'fast-charge-high-watermark' will be clamped by this value.
  68
  69 - qcom,fast-charge-safe-current:
  70   Usage: optional (default: 1A, or pre-configured value)
  71   Value type: <u32>; uA; range [100mA : 3A]
  72   Description: Maximum safe battery charge current; May pre-set by bootloader,
  73                in which case, setting this will harmlessly fail. The property
  74                'qcom,fast-charge-current-limit' will be clamped by this value.
  75
  76 - qcom,auto-recharge-threshold-voltage:
  77   Usage: optional (default: 4.1V, or pre-configured value)
  78   Value type: <u32>; uV; range [3.24V : 5V]
  79   Description: Battery voltage limit below which auto-recharge functionality
  80                will restart charging after end-of-charge;  The high cutoff
  81                limit for auto-recharge is 5% above this value.
  82
  83 - qcom,minimum-input-voltage:
  84   Usage: optional (default: 4.3V, or pre-configured value)
  85   Value type: <u32>; uV; range [4.2V : 9.6V]
  86   Description: Input voltage level above which charging may operate
  87
  88 - qcom,dc-current-limit:
  89   Usage: optional (default: 100mA, or pre-configured value)
  90   Value type: <u32>; uA; range [100mA : 2.5A]
  91   Description: Default DC charge current limit
  92
  93 - qcom,disable-dc:
  94   Usage: optional (default: false)
  95   Value type: boolean: <u32> or <empty>
  96   Description: Disable DC charger
  97
  98 - qcom,jeita-extended-temp-range:
  99   Usage: optional (default: false)
 100   Value type: boolean: <u32> or <empty>
 101   Description: Enable JEITA extended temperature range;  This does *not*
 102                adjust the maximum charge voltage or current in the extended
 103                temperature range.  It only allows charging when the battery
 104                is in the extended temperature range.  Voltage/current
 105                regulation must be done externally to fully comply with
 106                the JEITA safety guidelines if this flag is set.
 107
 108 EXAMPLE
 109 charger@1000 {
 110        compatible = "qcom,pm8941-charger";
 111        reg = <0x1000 0x700>;
 112        interrupts = <0x0 0x10 7 IRQ_TYPE_EDGE_BOTH>,
 113                        <0x0 0x10 5 IRQ_TYPE_EDGE_BOTH>,
 114                        <0x0 0x10 4 IRQ_TYPE_EDGE_BOTH>,
 115                        <0x0 0x12 1 IRQ_TYPE_EDGE_BOTH>,
 116                        <0x0 0x12 0 IRQ_TYPE_EDGE_BOTH>,
 117                        <0x0 0x13 2 IRQ_TYPE_EDGE_BOTH>,
 118                        <0x0 0x13 1 IRQ_TYPE_EDGE_BOTH>,
 119                        <0x0 0x14 1 IRQ_TYPE_EDGE_BOTH>;
 120        interrupt-names = "chg-done",
 121                        "chg-fast",
 122                        "chg-trkl",
 123                        "bat-temp-ok",
 124                        "bat-present",
 125                        "chg-gone",
 126                        "usb-valid",
 127                        "dc-valid";
 128
 129        qcom,fast-charge-current-limit = <1000000>;
 130        qcom,dc-charge-current-limit = <1000000>;
 131 };