Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 778eba1b authored by Jishnu Prakash's avatar Jishnu Prakash
Browse files

bindings: smb1390: Add binding documents for SMB1390 charger 

Add binding documentation for SMB1390 charger. SMB1390 is a charge pump
PMIC and is used as a companion charger to the primary charging PMIC.
This is a snapshot from msm-4.19 commit 94e8e08c6890
(" ARM: dts: msm: Correct the dev_id for hdmi cpu-dai").

Change-Id: Idfc0eadb74e0bfa67842de4f610e208de011b05e
parent 3f94d283

bindings/power/supply/qcom/smb1390-charger-psy.txt

0 → 100644
+119 −0
Original line number Diff line number Diff line 
Qualcomm Technologies, Inc. SMB1390 Charger Specific Bindings



SMB1390 charge pump is paired with QTI family of standalone chargers to

enable a high current, high efficiency Li+ battery charging system.



=======================

Required Node Structure

=======================



SMB1390 Charger must be described in two levels of device nodes.



==================================

First Level Node - SMB1390 Charger

==================================



Charger specific properties:

- compatible

  Usage:      required

  Value type: <string>

  Definition: "qcom,smb1390-charger-psy" for master SMB1390 and

	      "qcom,smb1390-slave" for slave SMB1390.



- 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.



- io-channels

- io-channel-names

  Usage:      required

  Value type: <phandle>

  Definition: For details about IIO bindings see:

	      Documentation/devicetree/bindings/iio/iio-bindings.txt



- qcom,min-ilim-ua

  Usage:      optional

  Value type: <u32>

  Definition: Minimum ILIM supported, if requested ILIM goes below this value

	      disable SMB1390. If this values is not specified default minimum

	      ILIM is 1A.



- qcom,max-temp-alarm-degc

  Usage:      optional

  Value type: <u32>

  Definition: Maximum die temperature to trigger temp alarm. The value

	      must be one of the following:

	      80, 90, 105, 115.

	      If this value is not specified or is not one of the above

	      then default value is 105.



- qcom,max-cutoff-soc

  Usage:      optional

  Value type: <u32>

  Definition: SOC beyond which SMB1390 is kept disabled.

	      If this value is not specified then default value is 85%.



- qcom,parallel-output-mode

  Usage:      optional

  Value type: <u32>

  Definition: Defines the SMB1390 output connection topology.

		This should be one of the following:

		0 - If SMB1390 output is not connected to anything;

		1 - If SMB1390 output is connected to VPH_PWR;

		2 - If SMB1390 output is connected to VBATT.

		If this value is not specified then default value is 1.



- qcom,parallel-input-mode

  Usage:      optional

  Value type: <u32>

  Definition: Defines the SMB1390 input connection topology.

		This should be one of the following:

		0 - If SMB1390 input is not connected to anything;

		1 - If SMB1390 input is connected to USBIN;

		3 - If SMB1390 input is connected to USBMID.

		If this value is not specified then default value is 3.



================================================

Second Level Nodes - SMB1390 Charger Peripherals

================================================



Peripheral specific properties:

- 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

=======



smb1390_charger: qcom,charge_pump {

	compatible = "qcom,smb1390-charger-psy";

	qcom,pmic-revid = <&smb1390_revid>;

	interrupt-parent = <&smb1390>;

	status = "disabled";



	io-channels = <&pm8150b_vadc ADC_AMUX_THM2>;

	io-channel-names = "cp_die_temp";



	qcom,core {

		interrupts = <0x10 0x0 IRQ_TYPE_EDGE_RISING>,

			     <0x10 0x1 IRQ_TYPE_EDGE_RISING>,

			     <0x10 0x2 IRQ_TYPE_EDGE_RISING>,

			     <0x10 0x3 IRQ_TYPE_EDGE_RISING>,

			     <0x10 0x4 IRQ_TYPE_EDGE_RISING>;

		interrupt-names = "switcher-off-window",

				  "switcher-off-fault",

				  "vph-ov-soft",

				  "ilim",

				  "temp-alarm";

	};

};