projects / deliverable / linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 43fde00b CC |
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 | }; |