Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Jiho Chu <jiho.chu@samsung.com>
To:     gregkh@linuxfoundation.org, arnd@arndb.de, ogabbay@kernel.org,
        krzysztof.kozlowski@linaro.org, broonie@kernel.org
Cc:     linux-kernel@vger.kernel.org, yelini.jeong@samsung.com,
        myungjoo.ham@samsung.com, jiho.chu@samsung.com
Subject: [PATCH v2 13/13] dt-bindings: arm: Add Samsung Trinity bindings
Date:   Sat, 17 Sep 2022 16:23:56 +0900
Message-Id: <20220917072356.2255620-14-jiho.chu@samsung.com>
In-Reply-To: <20220917072356.2255620-1-jiho.chu@samsung.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="utf-8"
CMS-TYPE: 101P
DLP-Filter: Pass
References: <20220917072356.2255620-1-jiho.chu@samsung.com>
        <CGME20220917072358epcas1p15d18d4cf27694f894332f975bb971bef@epcas1p1.samsung.com>
Precedence: bulk

The Trinity Neural Processing Unit (NPU) is a hardware IP for providing
hardware acceleration for neural network processing workloads. It has
own virtual ISA decoder unit, and controlled by memory mapped control
registers. The IP is composed of Common Processor (CP), Digital Signal
Processor (DSP) and Deep Learning Accelerator (DLA). ComBox is register
set to control IRQ or check overall status of the IP.

Signed-off-by: Jiho Chu <jiho.chu@samsung.com>
Signed-off-by: Yelin Jeong <yelini.jeong@samsung.com>
Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>
---
 .../bindings/arm/samsung,trinity.yaml         | 115 ++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/arm/samsung,trinity.yaml

diff --git a/Documentation/devicetree/bindings/arm/samsung,trinity.yaml b/Documentation/devicetree/bindings/arm/samsung,trinity.yaml
new file mode 100644
index 000000000000..cd79ec040162
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/samsung,trinity.yaml
@@ -0,0 +1,115 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arm/samsung,trinity.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Samsung Trinity NPU Family
+
+maintainers:
+  - Jiho Chu <jiho.chu@samsung.com>
+
+description: |
+  The Trinity Neural Processing Unit (NPU) is a hardware IP for providing
+  hardware acceleration for neural network processing workloads. It has
+  own virtual ISA decoder unit, and controlled by memory mapped control
+  registers. The IP is composed of Common Processor (CP), Digital Signal
+  Processor (DSP) and Deep Learning Accelerator (DLA). ComBox is register
+  set to control IRQ or check overall status of the IP.
+
+properties:
+  compatible:
+    const: samsung,trinity
+
+  samsung,trinity-type:
+    description: type of trinity family
+    enum: ['triv2']
+
+  samsung,tops:
+    description: Performance metric (Tera Operation Per Seconds)
+    enum: [2, 8]
+
+  samsung,idu_cp:
+    items:
+      - description: Address of zero data of CP
+      - description: Address of IDU data of CP
+      - description: Maximum size of CP's IDU binary
+
+  samsung,idu_dsp:
+    items:
+      - description: Address of zero data of DSP
+      - description: Address of IDU data of DSP
+      - description: Maximum size of DSP's IDU binary
+
+  samsung,dspm:
+    description: The size of Data Scratch-Pad Memory
+
+  memory-region:
+    description:
+      phandle to the reserved memory node to be associated
+      with the trinity device. The reserved memory node
+      can be a CMA memory node.
+      Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml
+
+  dma-coherent: true
+
+  reg:
+    items:
+      - description: Memory mapped register of CP
+      - description: Memory mapped register of DSP
+      - description: Memory mapped register of ComBox
+
+  reg-names:
+    items:
+      - const: cp-mmreg
+      - const: dsp-mmreg
+      - const: cbox-mmreg
+
+  interrupts:
+    description: workload complete interrupt
+    maxItems: 1
+
+required:
+  - compatible
+  - samsung,trinity-type
+  - samsung,tops
+  - samsung,idu_cp
+  - samsung,idu_dsp
+  - samsung,dspm
+  - memory-region
+  - dma-coherent
+  - reg
+  - reg-names
+  - interrupts
+
+examples:
+  - |
+    reserved-memory {
+        #address-cells = <2>;
+        #size-cells = <1>;
+        trinity_dram_0: memory@80000000 {
+            compatible = "shared-dma-pool";
+            no-map;
+            reg = <0x0 0x80000000 0x10000000>;
+        };
+    };
+
+    triv2@0x30C00000 {
+        compatible = "samsung,trinity";
+        samsung,trinity-type = "triv2";
+        samsung,tops = <8>;
+        samsung,idu_cp = /bits/ 64 <0x30400000 0x30400010 0x10000>;
+        samsung,idu_dsp = /bits/ 64 <0x30500000 0x30500010 0x10000>;
+        samsung,dspm = <0x40000>;
+
+        memory-region = <&trinity_dram_0>
+
+        dma-coherent;
+
+        reg =   <0x0 0x30C10000 0x0 0x10000>, /* CP MMREG base */
+                <0x0 0x30D40000 0x0 0x10000>, /* DSP MMREG base */
+                <0x0 0x30DF0000 0x0 0x01000>; /* ComBox MMREG base */
+        reg-names = "cp-mmreg", "dsp-mmreg", "cbox-mmreg";
+
+        interrupts = <GIC_SPI 111 IRQ_TYPE_LEVEL_HIGH>;
+    };
-- 
2.25.1