blob: 528c285a936147c1d6d4aebb48c6d75b0524dfa4 [file] [log] [blame]
Qualcomm Technologies, Inc. SMB1355 Charger Specific Bindings
SMB1355 slave charger is paired with QTI family of standalone chargers to
enable a high current, low profile Li+ battery charging system.
The device provides 28V DC withstand, wide operating input range of 3.8 to
14.2V for standard 5V USB inputs as well as a wide variety of HVDCP Travel
Adapters and is compatible with QTI's Quick Charge technology.
=======================
Required Node Structure
=======================
SMB1355 Charger must be described in two levels of device nodes.
==================================
First Level Node - SMB1355 Charger
==================================
Charger specific properties:
- compatible
Usage: required
Value type: <string>
Definition: "qcom,smb1355".
- qcom,pmic-revid
Usage: required
Value type: phandle
Definition: Should specify the phandle of SMB's revid module. This is used
to identify the SMB subtype.
- qcom,disable-ctm
Usage: optional
Value type: <empty>
Definition: boolean flag. Usually a thermistor near usb/typeC connector is
connected to AUX. Set this flag to indicate the thermistor
doesn't exist.
- qcom,parallel-mode
Usage: optional
Value type: <u32>
Definition: Specifies parallel charging mode. If not specified, MID-MID
option is selected by default.
- qcom,stacked-batfet
Usage: optional
Value type: <empty>
Definition: boolean flag. Specifies if parallel charger has stacked BATFET
configuration.
In stacked batfet the main and parallel charger's batfet are
stacked one after the other and thus all the charge current
(FCC) flows through main. In a non-stacked configuration each
charger controls the charge current (FCC) separately.
- qcom,die-temp-threshold-degc
Usage: optional
Value type: <u32>
Definition: Specifies DIE temp threshold beyond which h/w starts mitigation.
If not sepcified, 90 degrees centigrade is used.
- qcom,hw-die-temp-mitigation
Usage: optional
Value type: bool
Definition: Boolean property to enable h/w controlled die temp mitigation.
================================================
Second Level Nodes - SMB1355 Charger Peripherals
================================================
Peripheral specific properties:
- reg
Usage: required
Value type: <prop-encoded-array>
Definition: Address and size of the peripheral's register block.
- interrupts
Usage: required
Value type: <prop-encoded-array>
Definition: Peripheral interrupt specifier.
- interrupt-names
Usage: required
Value type: <stringlist>
Definition: Interrupt names. This list must match up 1-to-1 with the
interrupts specified in the 'interrupts' property.
=======
Example
=======
smb1355_charger: qcom,smb1355-charger {
compatible = "qcom,smb1355";
#address-cells = <1>;
#size-cells = <1>;
qcom,chgr@1000 {
reg = <0x1000 0x100>;
interrupts = <0x10 0x1 IRQ_TYPE_EDGE_BOTH>;
interrupt-names = "chg-state-change";
};
qcom,chgr-misc@1600 {
reg = <0x1600 0x100>;
interrupts = <0x16 0x1 IRQ_TYPE_EDGE_BOTH>;
interrupt-names = "wdog-bark";
};
};