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:   Sarah Walker <sarah.walker@imgtec.com>
To:     <dri-devel@lists.freedesktop.org>
CC:     <frank.binns@imgtec.com>, <donald.robson@imgtec.com>,
        <boris.brezillon@collabora.com>, <faith.ekstrand@collabora.com>,
        <airlied@gmail.com>, <daniel@ffwll.ch>,
        <maarten.lankhorst@linux.intel.com>, <mripard@kernel.org>,
        <tzimmermann@suse.de>, <afd@ti.com>, <hns@goldelico.com>,
        <matthew.brost@intel.com>, <christian.koenig@amd.com>,
        <luben.tuikov@amd.com>, <dakr@redhat.com>,
        <linux-kernel@vger.kernel.org>, <robh+dt@kernel.org>,
        <krzysztof.kozlowski+dt@linaro.org>, <conor+dt@kernel.org>,
        <devicetree@vger.kernel.org>
Subject: [PATCH v4 02/17] dt-bindings: gpu: Add Imagination Technologies PowerVR GPU
Date:   Fri, 14 Jul 2023 15:25:26 +0100
Message-Id: <20230714142526.111569-1-sarah.walker@imgtec.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?P+48hmJ7FMr9tUCHqcpMY2+r/9GkvPurnsOlTmpONZuceeTvvM13UwOmeAzi?=
 =?us-ascii?Q?7R57nzSf1cLZGnwcTde2CmrwcfV03bW5sCINTyEc+qpG491ZSWJTFswTGj1K?=
 =?us-ascii?Q?irOW9e1ICCtwc4Lz05Tifshts1LPuhFo1rqG6+yzQcw/rZJM6hH8/hT1pVjU?=
 =?us-ascii?Q?bKM+cpetbKUMp1y8TRfjEp6qGzwfVg4DQKfJTKM4/WYHyJ9FLf0PVVekLgEv?=
 =?us-ascii?Q?PnC2Ot0GkdVLVhM3DnlV+GQUha1U5b1w/uPhgg48cxAKgA/SrUf9rxw2yb3t?=
 =?us-ascii?Q?C+t3cX0CVzAEQSCTjhath1otfh5NsP9GGC36UkOnis6XyWmBRDRwyte2ryg1?=
 =?us-ascii?Q?nSbAcDW5sgwXF792hjkUXhrfYaQAHuWHse1BvTWP2y3TAvbZ26css8/wC9q3?=
 =?us-ascii?Q?2IHC9j2i1g6EWbs2IkTMyhHYHXodePQMzWrSdhhB4KjLFH8lIHvYoYnmhk3e?=
 =?us-ascii?Q?JV0UgOexdQtiR9dhJSxunAoVBcOkn6KCRrBuK4zCJSefSzCt/ZPOpkHl1Vrk?=
 =?us-ascii?Q?zNqFXPD/SqkQ02hFt+s+gU4RHUVFJi3r3QBP+VEhSoOcpv4A1mV695e0cm87?=
 =?us-ascii?Q?mqFtqhH4pmS7TFeis4hUKMO+PEBim1L5GbQeCcHNe5syUk/2XZp2alK3m94Y?=
 =?us-ascii?Q?R9VEU40FsKA6nHe6VT/NNt/eQ4eBtmau8lpxMHqZBzvPEHq2nLxhKau/kaqL?=
 =?us-ascii?Q?/JOUKP+0FFYftcRA2iErY59A5nM0GclC7YadGhympBP7WSZDu0w1wFPpFqbs?=
 =?us-ascii?Q?Q8gJa8Htyrltc3tWgmUJZ2r25cZtuZ5N2HviZaPUCJcngqx80yOop4gJa4XU?=
 =?us-ascii?Q?hBGg6Sj16CMGZuXOBK26ELg9NQE+m6M3FZH7TDizGZYzwYPzzKdlXLl7cdXZ?=
 =?us-ascii?Q?kmyApdpahE0OxzFXxdOIVPfWyow67yo5V8QlS5Xeu1SozpyDiulbxMw+88wq?=
 =?us-ascii?Q?2bplv2+QawwW0hRIGeTWj0xQiQL3zIIC7BK6kJsoVoYtt/g/Q51HBxTdIT/j?=
 =?us-ascii?Q?3ez6UsAU2vB1j0wUySoOw1WGTp8otfC7z+3OeOx1x+6NU2RqqyvJhxCY5Vvs?=
 =?us-ascii?Q?zydyWZfYzrVAp2XusniELwJD9x0eTmhBILHV7yNByv1XG80/feXSXHPEAcx+?=
 =?us-ascii?Q?dPq1KJFu7kKhVBmRewmHEm6aQD4Ql1X+8suNVF+CuIlL47PqO8BWEOoew8tx?=
 =?us-ascii?Q?AobDkpppR//aSRpmVlCbXYNDukmHvJRNuYYhqTrQOimSblF9HpCDGZQ7+5K2?=
 =?us-ascii?Q?LxvM5jV7nAsofD+LutGVdhQYeFNZYlW6NUU9RZKsciSQPp6TJwRPagqYZmMF?=
 =?us-ascii?Q?uaz+/bP/BcGHRQNkcMiCdQNxPhShugckvKIZfygJQ1v9WEKshHoyCfOqmSdJ?=
 =?us-ascii?Q?ysiz8iyusj+2rKmpp0AAoGZ9RfneMsQVedr/155r6+TIp7XMwho+JSTTQIo8?=
 =?us-ascii?Q?drLQP9jhw0gLNXJenqqBjdv1TGflAOu2B71cpfCTMkXiQ+7LdZKsr70tr3dE?=
 =?us-ascii?Q?3z8jFYfD2sjW0Edt/PnzIl6j3Y9N7+Pmd4lrHZpeLcOvrwsJp/nB3vkZOgLp?=
 =?us-ascii?Q?QLG+b284SlIvDd91tPT5y1BqfcwHlumFEksF0PKGXlruyzXi3rU9x48j+LuC?=
 =?us-ascii?Q?9w=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: 3622dca5-bb47-4291-4cc0-08db84763126
X-MS-Exchange-CrossTenant-AuthSource: CWLP265MB4817.GBRP265.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Jul 2023 14:25:36.9943
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 0d5fd8bb-e8c2-4e0a-8dd5-2c264f7140fe
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: Z+7xIHIMtAIxqulwcUdImp3nlR3ZTgXSgUzdGoYNJujX76cj3j6U8uhA4WaKSzVyo4RKv9qn8BkL+PMYuJqvIg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: LOYP265MB2077
X-OriginatorOrg: imgtec.com
X-EXCLAIMER-MD-CONFIG: 15a78312-3e47-46eb-9010-2e54d84a9631
X-Proofpoint-ORIG-GUID: FP64EOKhokCop1KTsu6mJuCImfC3KIyE
X-Proofpoint-GUID: FP64EOKhokCop1KTsu6mJuCImfC3KIyE
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED,
        SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Add the device tree binding documentation for the Series AXE GPU used in
TI AM62 SoCs.

Changes since v3:
- Remove oneOf in compatible property
- Remove power-supply (not used on AM62)

Changes since v2:
- Add commit message description
- Remove mt8173-gpu support (not currently supported)
- Drop quotes from $id and $schema
- Remove reg: minItems
- Drop _clk suffixes from clock-names
- Remove operating-points-v2 property and cooling-cells (not currently
  used)
- Add additionalProperties: false
- Remove stray blank line at the end of file

Signed-off-by: Sarah Walker <sarah.walker@imgtec.com>
---
 .../devicetree/bindings/gpu/img,powervr.yaml  | 68 +++++++++++++++++++
 MAINTAINERS                                   |  7 ++
 2 files changed, 75 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/gpu/img,powervr.yaml

diff --git a/Documentation/devicetree/bindings/gpu/img,powervr.yaml b/Documentation/devicetree/bindings/gpu/img,powervr.yaml
new file mode 100644
index 000000000000..3292a0440465
--- /dev/null
+++ b/Documentation/devicetree/bindings/gpu/img,powervr.yaml
@@ -0,0 +1,68 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+# Copyright (c) 2022 Imagination Technologies Ltd.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/gpu/img,powervr.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Imagination Technologies PowerVR GPU
+
+maintainers:
+  - Sarah Walker <sarah.walker@imgtec.com>
+
+properties:
+  compatible:
+    items:
+      - enum:
+          - ti,am62-gpu
+      - const: img,powervr-seriesaxe
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    minItems: 1
+    maxItems: 3
+
+  clock-names:
+    items:
+      - const: core
+      - const: mem
+      - const: sys
+    minItems: 1
+
+  interrupts:
+    items:
+      - description: GPU interrupt
+
+  interrupt-names:
+    items:
+      - const: gpu
+
+  power-domains:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - clock-names
+  - interrupts
+  - interrupt-names
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+    gpu: gpu@fd00000 {
+        compatible = "ti,am62-gpu", "img,powervr-seriesaxe";
+        reg = <0x0fd00000 0x20000>;
+        power-domains = <&some_pds 187>;
+        clocks = <&k3_clks 187 0>;
+        clock-names = "core";
+        interrupts = <GIC_SPI 86 IRQ_TYPE_LEVEL_HIGH>;
+        interrupt-names = "gpu";
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index 9852d6bfdb95..0763388b31ef 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -10099,6 +10099,13 @@ IMGTEC IR DECODER DRIVER
 S:	Orphan
 F:	drivers/media/rc/img-ir/
 
+IMGTEC POWERVR DRM DRIVER
+M:	Frank Binns <frank.binns@imgtec.com>
+M:	Sarah Walker <sarah.walker@imgtec.com>
+M:	Donald Robson <donald.robson@imgtec.com>
+S:	Supported
+F:	Documentation/devicetree/bindings/gpu/img,powervr.yaml
+
 IMON SOUNDGRAPH USB IR RECEIVER
 M:	Sean Young <sean@mess.org>
 L:	linux-media@vger.kernel.org
-- 
2.41.0