From 0ae00f25cad61adb6298813d7c1b0204d66c13e0 Mon Sep 17 00:00:00 2001
From: Rahul Bedarkar <rabedarkar@nvidia.com>
Date: Wed, 4 May 2022 09:13:06 +0000
Subject: [PATCH] Documentation: Add DT binding for tegra-fsicom

Add DT binding for tegra-fsicom driver

Bug 3583609

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

diff --git a/Documentation/devicetree/bindings/platform/tegra/tegra-fsicom.yaml b/Documentation/devicetree/bindings/platform/tegra/tegra-fsicom.yaml
new file mode 100644
index 00000000..c9983fc1
--- /dev/null
+++ b/Documentation/devicetree/bindings/platform/tegra/tegra-fsicom.yaml
@@ -0,0 +1,72 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/platform/tegra/tegra-fsicom.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Device tree binding for NVIDIA Tegra FSICOM
+
+maintainers:
+  - Rahul Bedarkar <rabedarkar@nvidia.com>
+
+description: |
+   The tegra-fsicom driver provides interface for communication with Functional Safety Island (FSI)
+
+properties:
+  compatible:
+    enum:
+      - nvidia,tegra234-fsicom-client
+
+  mboxes:
+    maxItems: 2
+    description: |
+       Specifies Tx and RX mailboxes for read/write notification.
+
+  mbox-names:
+    maxItems: 2
+    description: |
+       Specifies the name for Tx and Rx mailboxes. Expected Tx mailbox name is "fsi-tx" and Rx mailbox name is "fsi-rx".
+
+  iommus:
+    maxItems: 1
+    description: |
+       A list of phandle and IOMMU specifier pairs that describe the IOMMU master interfaces of the device.
+
+  iommu-resv-regions:
+    maxItems: 1
+    description: |
+       Pairs of upper and lower start addresses and sizes to reserve memory regions.
+
+  dma-coherent:
+    description: |
+       Present if dma operations are coherent
+
+required:
+  - compatible
+  - mboxes
+  - mbox-names
+  - iommus
+  - iommu-resv-regions
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/mailbox/tegra186-hsp.h>
+    #define TEGRA_SID_NISO1_FSI		0x11U
+    #define TEGRA_HSP_MBOX_TYPE_SM_128BIT (1 << 8)
+
+    soc {
+        fsicom_client {
+            compatible = "nvidia,tegra234-fsicom-client";
+            mboxes =
+                <&hsp_top2 (TEGRA_HSP_MBOX_TYPE_SM | TEGRA_HSP_MBOX_TYPE_SM_128BIT) TEGRA_HSP_SM_TX(3)>,
+                <&hsp_top2 (TEGRA_HSP_MBOX_TYPE_SM | TEGRA_HSP_MBOX_TYPE_SM_128BIT) TEGRA_HSP_SM_RX(2)>;
+            mbox-names = "fsi-tx", "fsi-rx";
+            iommus = <&smmu_niso1 TEGRA_SID_NISO1_FSI>;
+            iommu-resv-regions = <0x0 0x0 0x0 0xF0000000 0x0 0xF1000000 0xffffffff 0xffffffff>;
+            dma-coherent;
+        };
+
+     };
+...