From cd924ab2b25c45e24a94218f811604bab6a3bf70 Mon Sep 17 00:00:00 2001
From: Laxman Dewangan <ldewangan@nvidia.com>
Date: Mon, 2 May 2022 15:21:12 +0530
Subject: [PATCH] Documentation: Add DT binding doc for Tegra i2c-slave

Add DT binding document for NVIDIA Tegra I2C slave controller.

Bug 3631219

Change-Id: Iec8f9f9cd6ce7ab443f2751bb141e03ed9b448ba
Signed-off-by: Laxman Dewangan <ldewangan@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nv-oot/+/2705959
Reviewed-by: Krishna Yarlagadda <kyarlagadda@nvidia.com>
GVS: Gerrit_Virtual_Submit
---
 .../bindings/i2c/i2c-tegra-slave-byte.yaml    | 97 +++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/i2c/i2c-tegra-slave-byte.yaml

diff --git a/Documentation/devicetree/bindings/i2c/i2c-tegra-slave-byte.yaml b/Documentation/devicetree/bindings/i2c/i2c-tegra-slave-byte.yaml
new file mode 100644
index 00000000..eec1767a
--- /dev/null
+++ b/Documentation/devicetree/bindings/i2c/i2c-tegra-slave-byte.yaml
@@ -0,0 +1,97 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/i2c/i2c-tegra-slave-byte.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NVIDIA Tegra I2C slave Device Tree binding
+
+maintainers:
+  - Laxman Dewangan <ldewangan@nvidia.com>
+
+allOf:
+  - $ref: /schemas/i2c/i2c-controller.yaml#
+
+properties:
+  compatible:
+    enum:
+      - nvidia,tegra210-i2c-slave
+      - nvidia,tegra-i2c-slave-byte
+
+  reg:
+    maxItems: 1
+    description: |
+       Base address and size of the physical address of I2C controller.
+
+  interrupts:
+    maxItems: 1
+
+  clocks:
+    maxItems: 2
+    description: |
+       Two entries, first one is root clock of the controller and second
+       one is parent clock of the controller.
+
+  clock-names:
+     description: |
+        Name of the clock source. The valid names are "div-clk" and "parent".
+
+  resets:
+    maxItems: 1
+    description: |
+       Specifies the reset line.
+
+  reset-names:
+    description: |
+      Specifies the name of the reset line. Valid name is "i2c".
+
+
+  clock-frequency:
+    minimum: 500
+    maximum: 4000000
+    default: 100000
+    description: frequency of the bus clock in Hz defaults to 100 kHz when not
+      specified
+
+  nvidia,hw-instance-id:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: Instance ID of the controller.
+
+
+required:
+  - reg
+  - compatible
+  - clocks
+  - clock-names
+  - resets
+  - reset-names
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    #define TEGRA234_IRQ_I2C5                29
+    #define TEGRA234_CLK_PLLP_OUT0           102U
+    #define TEGRA234_CLK_I2C5                305U
+    #define TEGRA234_RESET_I2C5              32U
+
+    soc {
+       #address-cells = <2>;
+       #size-cells = <2>;
+
+       pwr_i2c: i2c@31a0000 {
+            #address-cells = <1>;
+            #size-cells = <0>;
+            compatible = "nvidia,tegra210-i2c-slave";
+            reg = <0x0 0x31a0000 0x0 0x100>;
+            nvidia,hw-instance-id = <0x4>;
+            interrupts = <0 TEGRA234_IRQ_I2C5 0x04>;
+            clock-frequency = <100000>;
+            clocks = <&bpmp_clks TEGRA234_CLK_I2C5>,
+                     <&bpmp_clks TEGRA234_CLK_PLLP_OUT0>;
+            clock-names = "div-clk", "parent";
+            resets = <&bpmp_resets TEGRA234_RESET_I2C5>;
+            reset-names = "i2c";
+        };
+    };
+...