From 26a2a22e85f53836f92285e65b5c9ce5816d6998 Mon Sep 17 00:00:00 2001
From: Rahul Bedarkar <rabedarkar@nvidia.com>
Date: Mon, 9 May 2022 12:09:33 +0000
Subject: [PATCH] Documentation: Add DT binding for tegra-epl driver

Add DT binding for tegra-epl driver

Bug 3583609

Change-Id: Idcbc693689ce8516d32956655ac23e6c0401168a
Signed-off-by: Rahul Bedarkar <rabedarkar@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nv-oot/+/2710278
Reviewed-by: Laxman Dewangan <ldewangan@nvidia.com>
GVS: Gerrit_Virtual_Submit
---
 .../bindings/platform/tegra/tegra-epl.yaml    | 95 +++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/platform/tegra/tegra-epl.yaml

diff --git a/Documentation/devicetree/bindings/platform/tegra/tegra-epl.yaml b/Documentation/devicetree/bindings/platform/tegra/tegra-epl.yaml
new file mode 100644
index 00000000..7272bbf9
--- /dev/null
+++ b/Documentation/devicetree/bindings/platform/tegra/tegra-epl.yaml
@@ -0,0 +1,95 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/platform/tegra/tegra-epl.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Device tree binding for NVIDIA Tegra EPL
+
+maintainers:
+  - Rahul Bedarkar <rabedarkar@nvidia.com>
+
+description: |
+   The tegra-epl driver provides interface for reporting software detected errors
+   to Functional Safety Island (FSI) via HSP mailbox or MISC EC registers.
+
+properties:
+  compatible:
+    enum:
+      - nvidia,tegra234-epl-client
+
+  mboxes:
+    maxItems: 1
+    description: |
+       Specifies TX mailbox.
+
+  mbox-names:
+    maxItems: 1
+    description: |
+       Specifies the name for TX mailbox. It should be "epl-tx".
+
+  reg:
+    minItems: 11
+    maxItems: 11
+    description: |
+       Address and size pairs of MISC EC error and assert registers followed by
+       address and size of mission error status register.
+
+  client-misc-sw-generic-err0:
+    description: |
+       Device driver's name for reporting errors via MISCREG_MISC_EC_ERR0_SW_ERR_CODE_0.
+
+  client-misc-sw-generic-err1:
+    description: |
+       Device driver's name for reporting errors via MISCREG_MISC_EC_ERR1_SW_ERR_CODE_0.
+
+  client-misc-sw-generic-err2:
+    description: |
+       Device driver's name for reporting errors via MISCREG_MISC_EC_ERR2_SW_ERR_CODE_0.
+
+  client-misc-sw-generic-err3:
+    description: |
+       Device driver's name for reporting errors via MISCREG_MISC_EC_ERR3_SW_ERR_CODE_0.
+
+  client-misc-sw-generic-err4:
+    description: |
+       Device driver's name for reporting errors via MISCREG_MISC_EC_ERR4_SW_ERR_CODE_0.
+
+required:
+  - compatible
+  - mboxes
+  - mbox-names
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/mailbox/tegra186-hsp.h>
+    #define TEGRA_HSP_MBOX_TYPE_SM_128BIT (1 << 8)
+
+    soc {
+        #address-cells = <1>;
+        #size-cells = <1>;
+        epl_client@110000 {
+            compatible = "nvidia,tegra234-epl-client";
+            mboxes =
+                <&hsp_top2 (TEGRA_HSP_MBOX_TYPE_SM | TEGRA_HSP_MBOX_TYPE_SM_128BIT) TEGRA_HSP_SM_RX(1)>;
+            mbox-names = "epl-tx";
+            reg = <0x00110000 0x4>,
+                  <0x00110004 0x4>,
+                  <0x00120000 0x4>,
+                  <0x00120004 0x4>,
+                  <0x00130000 0x4>,
+                  <0x00130004 0x4>,
+                  <0x00140000 0x4>,
+                  <0x00140004 0x4>,
+                  <0x00150000 0x4>,
+                  <0x00150004 0x4>,
+                  <0x024e0038 0x4>;
+            client-misc-sw-generic-err0 = "fsicom_client";
+            client-misc-sw-generic-err4 = "gk20e";
+        };
+
+     };
+...