From d8d55ac5dd05c999e3e1ba2f23a6e390f1ed4e7d Mon Sep 17 00:00:00 2001
From: Melody Olvera <quic_molvera@quicinc.com>
Date: Tue, 13 Jun 2023 13:14:22 -0700
Subject: [PATCH] dt-bindings: soc: qcom: Add documentation for minidump driver

Add snapshot of the minidump driver documentation from
qcom-6.1 commit 2ae57ab8fb9a ("spmi: viospmi-pmic-arb: update of_node
property").

Change-Id: Idae54e552b0736c2e0c2621116760159ec302e0d
Signed-off-by: Melody Olvera <quic_molvera@quicinc.com>
Signed-off-by: Gokul krishna Krishnakumar <quic_gokukris@quicinc.com>
---
 bindings/soc/qcom/qcom,minidump.yaml    | 29 ++++++++++++++++++
 bindings/soc/qcom/qcom,va-minidump.yaml | 40 +++++++++++++++++++++++++
 2 files changed, 69 insertions(+)
 create mode 100644 bindings/soc/qcom/qcom,minidump.yaml
 create mode 100644 bindings/soc/qcom/qcom,va-minidump.yaml

diff --git a/bindings/soc/qcom/qcom,minidump.yaml b/bindings/soc/qcom/qcom,minidump.yaml
new file mode 100644
index 00000000..a4eac137
--- /dev/null
+++ b/bindings/soc/qcom/qcom,minidump.yaml
@@ -0,0 +1,29 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/soc/qcom/qcom,minidump.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: Qualcomm Technologies, Inc. Minidump driver
+
+maintainers:
+  - Melody Olvera <quic_molvera@quicinc.com>
+
+description: |
+  Minidump driver allows clients to register memory regions. It can dump
+  registered memory regions when system goes wrong.
+
+properties:
+  compatible:
+    enum:
+      - qcom,minidump
+      - qcom,minidump-rm
+
+required:
+  - compatible
+
+examples:
+  - |
+    qcom,minidump {
+        compatible = "qcom,minidump";
+    };
diff --git a/bindings/soc/qcom/qcom,va-minidump.yaml b/bindings/soc/qcom/qcom,va-minidump.yaml
new file mode 100644
index 00000000..155f0e40
--- /dev/null
+++ b/bindings/soc/qcom/qcom,va-minidump.yaml
@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/soc/qcom/qcom,va-minidump.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: Qualcomm Technologies, Inc. VA Minidump driver
+
+maintainers:
+  - Melody Olvera <quic_molvera@quicinc.com>
+
+description: |
+  VA based minidump driver helps in registering dynamic data structures
+  from vendor modules with minidump. This driver works on VA, which
+  would be contiguous even if physical pages are scattered. Each client
+  can register area with contiguous VA as a section for ELF. This driver
+  creates ELF in panic notifier, combining all the section registered
+  by client drivers.
+
+properties:
+  compatible:
+    items:
+      - const: qcom,va-minidump
+
+  memory-region:
+    $ref: '/schemas/types.yaml#/definitions/phandle'
+    maxItems: 1
+    description: |
+      CMA region which is owned by this device.
+
+required:
+  - compatible
+  - memory-region
+
+examples:
+  - |
+    va_mini_dump {
+        compatible = "qcom,va-minidump";
+        memory-region = <&va_md_mem>;
+    };