From eb374a8cb0bdba5b2668dc373b7a681527cd97d5 Mon Sep 17 00:00:00 2001 From: David Collins Date: Mon, 14 Oct 2019 16:53:18 -0700 Subject: [PATCH] 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 --- bindings/spmi/qcom,spmi-pmic-arb-debug.txt | 63 ++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 bindings/spmi/qcom,spmi-pmic-arb-debug.txt diff --git a/bindings/spmi/qcom,spmi-pmic-arb-debug.txt b/bindings/spmi/qcom,spmi-pmic-arb-debug.txt new file mode 100644 index 000000000000..51c748e8bcaf --- /dev/null +++ b/bindings/spmi/qcom,spmi-pmic-arb-debug.txt @@ -0,0 +1,63 @@ +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: + Definition: Must be "qcom,spmi-pmic-arb-debug". + +- reg + Usage: required + Value type: + 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: + 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: + Definition: Must be 2. + +- #size-cells + Usage: required + Value type: + Definition: Must be 0. + +- qcom,fuse-disable-bit + Usage: required if "fuse" is listed in reg-names property + Value type: + 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>; +};