Re: [PATCH 2/3] dt-bindings: msm: Add QTI download mode support binding

From: Rob Herring
Date: Tue Aug 17 2021 - 17:28:45 EST


On Thu, Aug 12, 2021 at 02:47:41PM +0530, Sai Prakash Ranjan wrote:
> Add device tree binding for QTI download mode cookies
> region found in IMEM.
>
> Signed-off-by: Sai Prakash Ranjan <saiprakash.ranjan@xxxxxxxxxxxxxx>
> ---
> .../bindings/arm/msm/qcom,dload-mode.yaml | 53 +++++++++++++++++++
> 1 file changed, 53 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/arm/msm/qcom,dload-mode.yaml
>
> diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,dload-mode.yaml b/Documentation/devicetree/bindings/arm/msm/qcom,dload-mode.yaml
> new file mode 100644
> index 000000000000..90b9b6a9b75e
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/arm/msm/qcom,dload-mode.yaml
> @@ -0,0 +1,53 @@
> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/arm/msm/qcom,dload-mode.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Qualcomm Download Mode binding
> +
> +maintainers:
> + - Sai Prakash Ranjan <saiprakash.ranjan@xxxxxxxxxxxxxx>
> +
> +description:
> + Qualcomm download mode cookies memory region in IMEM is used by SDI
> + (System Debug Image) firmware to determine whether to enter download
> + mode or not to collect ramdump for post mortem debug.
> +
> +properties:
> + compatible:
> + const: qcom,dload-mode
> +
> + reg:
> + maxItems: 1
> +
> + qcom,sdi-disable-regs:
> + $ref: /schemas/types.yaml#/definitions/phandle-array
> + description:
> + Phandle reference to a syscon representing TCSR followed by the
> + offset and length for SDI disable register.
> +
> +required:
> + - compatible
> + - reg
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + imem@146aa000 {
> + compatible = "simple-mfd";

If this is just internal RAM, then we already have a binding for it and
'simple-mfd' is not it.

> + reg = <0x146aa000 0x2000>;
> +
> + #address-cells = <1>;
> + #size-cells = <1>;
> +
> + ranges = <0 0x146aa000 0x2000>;
> +
> + dload-mode@1c00 {
> + compatible = "qcom,dload-mode";
> + reg = <0x1c00 0x1000>;

0x1c00 + 0x1000 > 0x2000


> + qcom,sdi-disable-regs = <&tcsr_regs 0x3a000 0x4>;
> + };
> + };
> +...
> --
> QUALCOMM INDIA, on behalf of Qualcomm Innovation Center, Inc. is a member
> of Code Aurora Forum, hosted by The Linux Foundation
>
>