From nobody Tue Dec 23 14:11:31 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id B8139C43334 for ; Tue, 28 Jun 2022 13:33:03 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1346547AbiF1NdC (ORCPT ); Tue, 28 Jun 2022 09:33:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34740 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1346583AbiF1Nc1 (ORCPT ); Tue, 28 Jun 2022 09:32:27 -0400 Received: from relay12.mail.gandi.net (relay12.mail.gandi.net [IPv6:2001:4b98:dc4:8::232]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 53EF43135D; Tue, 28 Jun 2022 06:32:06 -0700 (PDT) Received: (Authenticated sender: ash@heyquark.com) by mail.gandi.net (Postfix) with ESMTPSA id AD13020000A; Tue, 28 Jun 2022 13:31:57 +0000 (UTC) From: Ash Logan To: krzysztof.kozlowski+dt@linaro.org, paulus@samba.org, mpe@ellerman.id.au, christophe.leroy@csgroup.eu, robh+dt@kernel.org, benh@kernel.crashing.org Cc: linux-kernel@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, j.ne@posteo.net, linkmauve@linkmauve.fr, rw-r-r-0644@protonmail.com, devicetree@vger.kernel.org, joel@jms.id.au Subject: [PATCH v3 01/12] dt-bindings: wiiu: Document the Nintendo Wii U devicetree Date: Tue, 28 Jun 2022 23:31:33 +1000 Message-Id: <20220628133144.142185-2-ash@heyquark.com> X-Mailer: git-send-email 2.36.1 In-Reply-To: <20220628133144.142185-1-ash@heyquark.com> References: <20220622131037.57604-1-ash@heyquark.com> <20220628133144.142185-1-ash@heyquark.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Adds schema for the various Wii U devicetree nodes used. Signed-off-by: Ash Logan --- .../bindings/powerpc/nintendo/wiiu.yaml | 28 +++++++++++ .../powerpc/nintendo/wiiu/espresso-pic.yaml | 42 +++++++++++++++++ .../bindings/powerpc/nintendo/wiiu/gpu7.yaml | 41 +++++++++++++++++ .../powerpc/nintendo/wiiu/latte-ahci.yaml | 43 +++++++++++++++++ .../powerpc/nintendo/wiiu/latte-dsp.yaml | 35 ++++++++++++++ .../powerpc/nintendo/wiiu/latte-pic.yaml | 46 +++++++++++++++++++ .../powerpc/nintendo/wiiu/latte-sdhci.yaml | 40 ++++++++++++++++ .../bindings/powerpc/nintendo/wiiu/latte.yaml | 25 ++++++++++ 8 files changed, 300 insertions(+) create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= .yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /espresso-pic.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /gpu7.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /latte-ahci.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /latte-dsp.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /latte-pic.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /latte-sdhci.yaml create mode 100644 Documentation/devicetree/bindings/powerpc/nintendo/wiiu= /latte.yaml diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu.yaml b= /Documentation/devicetree/bindings/powerpc/nintendo/wiiu.yaml new file mode 100644 index 000000000000..5824b07928f5 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu.yaml @@ -0,0 +1,28 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- + +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U bindings + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Nintendo Wii U video game console binding. + +properties: + $nodename: + const: "/" + compatible: + oneOf: + - description: Nintendo Wii U video game console + items: + - const: nintendo,wiiu + +additionalProperties: true + +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/espres= so-pic.yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/espre= sso-pic.yaml new file mode 100644 index 000000000000..878a81595f5f --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/espresso-pic.= yaml @@ -0,0 +1,42 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/espresso-pic.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U "Espresso" interrupt controller + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Interrupt controller found on the Nintendo Wii U for the "Espresso" proc= essor. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U "Espresso" interrupt controller + items: + - const: nintendo,espresso-pic + '#interrupt-cells': + # Interrupt numbers 0-32 in one cell + const: 1 + interrupt-controller: true + reg: + items: + - description: Core registers + +additionalProperties: false + +examples: + - | + espresso_pic: pic@c000078 { + #interrupt-cells =3D <1>; + interrupt-controller; + + compatible =3D "nintendo,espresso-pic"; + reg =3D <0x0c000078 0x18>; + }; + +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/gpu7.y= aml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/gpu7.yaml new file mode 100644 index 000000000000..e54d49015f36 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/gpu7.yaml @@ -0,0 +1,41 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/gpu7.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U Latte "GPU7" graphics processor + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + GPU7 graphics processor, also known as "GX2", found in the Latte multifu= nction chip of the + Nintendo Wii U. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U Latte "GPU7" graphics processor + items: + - const: nintendo,latte-gpu7 + reg: + items: + - description: GpuF0MMReg registers + interrupts: + items: + - description: Main interrupt, connected via Espresso PIC + +# This will likely get bound to the Radeon driver one day, which will necc= esitate extra properties +additionalProperties: true + +examples: + - | + gpu7@c200000 { + compatible =3D "nintendo,latte-gpu7"; + reg =3D <0x0c200000 0x80000>; + interrupts =3D <2>; + interrupt-parent =3D <&espresso_pic>; + }; +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-= ahci.yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-a= hci.yaml new file mode 100644 index 000000000000..7b9de4effcb0 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-ahci.ya= ml @@ -0,0 +1,43 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/latte-ahci.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U Latte AHCI controller + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Nintendo Wii U AHCI SATA controller, as found in the Latte chip. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U Latte AHCI controller + items: + - const: nintendo,latte-ahci + reg: + items: + - description: | + HBA memory registers. Note that unlike the spec, space for only = 6 ports exist, with 2 vendor + registers afterwards, thus register space should be 0x408 long (= 0x100+0x80*6+0x8). + interrupts: + items: + - description: Main HBA interrupt + - description: Vendor debugging interrupt + +additionalProperties: false + +examples: + - | + sata: ahci@d160400 { + compatible =3D "nintendo,latte-ahci"; + reg =3D <0x0d160400 0x408>; + + interrupt-parent =3D <&latte_pic>; + interrupts =3D <38>, <28>; + }; +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-= dsp.yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-ds= p.yaml new file mode 100644 index 000000000000..ed0b4c28ce48 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-dsp.yaml @@ -0,0 +1,35 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/latte-dsp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U Latte DSP + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Nintendo Wii U digital signal processor, as found in the Latte chip. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U Latte DSP + items: + - const: nintendo,latte-dsp + reg: + items: + - description: DSP registers + +# Once more is known about this device more properties will likely be added +additionalProperties: true + +examples: + - | + latte_dsp: dsp@c005000 { + compatible =3D "nintendo,latte-dsp"; + reg =3D <0x0c005000 0x200>; + }; +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-= pic.yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-pi= c.yaml new file mode 100644 index 000000000000..a2df71fb9964 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-pic.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/latte-pic.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U Latte interrupt controller + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Interrupt controller found on the Nintendo Wii U for the "Latte" devices. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U Latte interrupt controller + items: + - const: nintendo,latte-pic + '#interrupt-cells': + # Interrupt numbers 0-64 in one cell. + const: 1 + interrupt-controller: true + reg: + items: + - description: Core registers + interrupts: + items: + - description: Cascade interrupt for Espresso PIC + +additionalProperties: false + +examples: + - | + latte_pic: pic@d800440 { + #interrupt-cells =3D <1>; + interrupt-controller; + + compatible =3D "nintendo,latte-pic"; + reg =3D <0x0d800440 0x30>; + interrupt-parent =3D <&espresso_pic>; + interrupts =3D <24>; + }; +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-= sdhci.yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-= sdhci.yaml new file mode 100644 index 000000000000..4b9b0820edc1 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte-sdhci.y= aml @@ -0,0 +1,40 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/latte-sdhci.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nintendo Wii U Latte SD Host controller + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + SDHCI hosts found on the Nintendo Wii U's Latte SoC for SD cards and SDI= O devices. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U Latte SDHCI + items: + - const: nintendo,latte-sdhci + - const: sdhci + reg: + items: + - description: Core registers + interrupts: + items: + - description: SDHCI interrupt + +additionalProperties: false + +examples: + - | + sdcard_0: sdhci@d070000 { + compatible =3D "nintendo,latte-sdhci","sdhci"; + reg =3D <0x0d070000 0x200>; + interrupts =3D <7>; + interrupt-parent =3D <&latte_pic>; + }; +... diff --git a/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte.= yaml b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte.yaml new file mode 100644 index 000000000000..6ae86d198fa3 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/nintendo/wiiu/latte.yaml @@ -0,0 +1,25 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/powerpc/nintendo/wiiu/latte.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Latte system bus + +maintainers: + - Ash Logan + - Emmanuel Gil Peyrot + +description: | + Latte multi-function SoC, containing many of the devices found on the Ni= ntendo Wii U. + +properties: + compatible: + oneOf: + - description: Nintendo Wii U "Latte" SoC + items: + - const: nintendo,latte + +additionalProperties: true + +... --=20 2.36.1