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

Commit 2ead6089 authored by David Collins's avatar David Collins
Browse files

dt-bindings: spmi: add SPMI PMIC arbiter debug bus bindings 



Add binding documentation for the SPMI debug bus found on SPMI
PMIC arbiter version 5 and above.  This debug bus has read and
write access to all PMIC peripherals regardless of ownership
configurations.  It cannot be used on production devices because
it is disabled by an eFuse.

Change-Id: I344ddea23ecb09bede5cbdb19197ab52b24dda44
Signed-off-by: default avatarDavid Collins <collinsd@codeaurora.org>
parent bd720091

Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb-debug.txt

0 → 100644
+63 −0
Original line number Diff line number Diff line 
Qualcomm Technologies, Inc. SPMI Debug Controller (PMIC Arbiter)



The SPMI PMIC Arbiter is found on various QTI chips.  It is an SPMI controller

with wrapping arbitration logic to allow for multiple on-chip devices to control

a single SPMI master.



The PMIC Arbiter debug bus is present starting at arbiter version 5.  It has

read and write access to all PMIC peripherals regardless of ownership

configurations.  It cannot be used on production devices because it is disabled

by an eFuse.



See spmi.txt for the generic SPMI controller binding requirements for child

nodes.



Supported Properties:



- compatible

	Usage:      required

	Value type: <string>

	Definition: Must be "qcom,spmi-pmic-arb-debug".



- reg

	Usage:      required

	Value type: <prop-encoded-array>

	Definition: List of address and size pairs.  The address of the PMIC

		    arbiter module is required.  The address of the debug bus

		    disabling fuse is optional.



- reg-names

	Usage:      required

	Value type: <stringlist>

	Definition: Address names. Must include "core" for the PMIC arbiter

		    module and may include "fuse" for the debug bus disabling

		    fuse.  The strings must be specified in the same order as

		    the corresponding addresses are specified in the reg

		    property.



- #address-cells

	Usage:      required

	Value type: <u32>

	Definition: Must be 2.



- #size-cells

	Usage:      required

	Value type: <u32>

	Definition: Must be 0.



- qcom,fuse-disable-bit

	Usage:      required if "fuse" is listed in reg-names property

	Value type: <u32>

	Definition: The bit within the fuse register which is set when the debug

		    bus is not available.  Supported values are 0 to 31.



Example:



qcom,spmi-debug@6b22000 {

	compatible = "qcom,spmi-pmic-arb-debug";

	reg = <0x6b22000 0x60>, <0x7820a8 4>;

	reg-names = "core", "fuse";

	qcom,fuse-disable-bit = <12>;

	#address-cells = <2>;

	#size-cells = <0>;

};