| Qualcomm Switch-Mode Battery Charger and Boost |
| |
| PROPERTIES |
| - compatible: |
| Usage: required |
| Value type: <stringlist> |
| Description: Must be one of: |
| - "qcom,pm8941-charger" |
| |
| - reg: |
| Usage: required |
| Value type: <prop-encoded-array> |
| Description: Base address of registers for SMBB block |
| |
| - interrupts: |
| Usage: required |
| Value type: <prop-encoded-array> |
| Description: The format of the specifier is defined by the binding document |
| describing the node's interrupt parent. Must contain one |
| specifier for each of the following interrupts, in order: |
| - charge done |
| - charge fast mode |
| - charge trickle mode |
| - battery temperature ok |
| - battery present |
| - charger disconnected |
| - USB-in valid |
| - DC-in valid |
| |
| - interrupt-names: |
| Usage: required |
| Value type: <stringlist> |
| Description: Must contain the following list, strictly ordered: |
| "chg-done", |
| "chg-fast", |
| "chg-trkl", |
| "bat-temp-ok", |
| "bat-present", |
| "chg-gone", |
| "usb-valid", |
| "dc-valid" |
| |
| - qcom,fast-charge-current-limit: |
| Usage: optional (default: 1A, or pre-configured value) |
| Value type: <u32>; uA; range [100mA : 3A] |
| Description: Maximum charge current; May be clamped to safety limits. |
| |
| - qcom,fast-charge-low-threshold-voltage: |
| Usage: optional (default: 3.2V, or pre-configured value) |
| Value type: <u32>; uV; range [2.1V : 3.6V] |
| Description: Battery voltage limit above which fast charging may operate; |
| Below this value linear or switch-mode auto-trickle-charging |
| will operate. |
| |
| - qcom,fast-charge-high-threshold-voltage: |
| Usage: optional (default: 4.2V, or pre-configured value) |
| Value type: <u32>; uV; range [3.24V : 5V] |
| Description: Battery voltage limit below which fast charging may operate; |
| The fast charger will attempt to charge the battery to this |
| voltage. May be clamped to safety limits. |
| |
| - qcom,fast-charge-safe-voltage: |
| Usage: optional (default: 4.2V, or pre-configured value) |
| Value type: <u32>; uV; range [3.24V : 5V] |
| Description: Maximum safe battery voltage; May be pre-set by bootloader, in |
| which case, setting this will harmlessly fail. The property |
| 'fast-charge-high-watermark' will be clamped by this value. |
| |
| - qcom,fast-charge-safe-current: |
| Usage: optional (default: 1A, or pre-configured value) |
| Value type: <u32>; uA; range [100mA : 3A] |
| Description: Maximum safe battery charge current; May pre-set by bootloader, |
| in which case, setting this will harmlessly fail. The property |
| 'qcom,fast-charge-current-limit' will be clamped by this value. |
| |
| - qcom,auto-recharge-threshold-voltage: |
| Usage: optional (default: 4.1V, or pre-configured value) |
| Value type: <u32>; uV; range [3.24V : 5V] |
| Description: Battery voltage limit below which auto-recharge functionality |
| will restart charging after end-of-charge; The high cutoff |
| limit for auto-recharge is 5% above this value. |
| |
| - qcom,minimum-input-voltage: |
| Usage: optional (default: 4.3V, or pre-configured value) |
| Value type: <u32>; uV; range [4.2V : 9.6V] |
| Description: Input voltage level above which charging may operate |
| |
| - qcom,dc-current-limit: |
| Usage: optional (default: 100mA, or pre-configured value) |
| Value type: <u32>; uA; range [100mA : 2.5A] |
| Description: Default DC charge current limit |
| |
| - qcom,disable-dc: |
| Usage: optional (default: false) |
| Value type: boolean: <u32> or <empty> |
| Description: Disable DC charger |
| |
| - qcom,jeita-extended-temp-range: |
| Usage: optional (default: false) |
| Value type: boolean: <u32> or <empty> |
| Description: Enable JEITA extended temperature range; This does *not* |
| adjust the maximum charge voltage or current in the extended |
| temperature range. It only allows charging when the battery |
| is in the extended temperature range. Voltage/current |
| regulation must be done externally to fully comply with |
| the JEITA safety guidelines if this flag is set. |
| |
| - usb_otg_in-supply: |
| Usage: optional |
| Value type: <phandle> |
| Description: Reference to the regulator supplying power to the USB_OTG_IN |
| pin. |
| |
| child nodes: |
| - otg-vbus: |
| Usage: optional |
| Description: This node defines a regulator used to control the direction |
| of VBUS voltage - specifically: whether to supply voltage |
| to VBUS for host mode operation of the OTG port, or allow |
| input voltage from external VBUS for charging. In the |
| hardware, the supply for this regulator comes from |
| usb_otg_in-supply. |
| |
| EXAMPLE |
| charger@1000 { |
| compatible = "qcom,pm8941-charger"; |
| reg = <0x1000 0x700>; |
| interrupts = <0x0 0x10 7 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x10 5 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x10 4 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x12 1 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x12 0 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x13 2 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x13 1 IRQ_TYPE_EDGE_BOTH>, |
| <0x0 0x14 1 IRQ_TYPE_EDGE_BOTH>; |
| interrupt-names = "chg-done", |
| "chg-fast", |
| "chg-trkl", |
| "bat-temp-ok", |
| "bat-present", |
| "chg-gone", |
| "usb-valid", |
| "dc-valid"; |
| |
| qcom,fast-charge-current-limit = <1000000>; |
| qcom,dc-charge-current-limit = <1000000>; |
| usb_otg_in-supply = <&pm8941_5vs1>; |
| |
| otg-vbus {}; |
| }; |
