From: Andrew Lunn <andrew@lunn.ch>
To: Gregory Clement <gregory.clement@bootlin.com>
Cc: arm-soc <arm@kernel.org>,
Device Tree <devicetree@vger.kernel.org>,
Andrew Lunn <andrew@lunn.ch>
Subject: [PATCH 11/11] DT: clock: Convert mvebu-gated-clock.txt to YAML
Date: Sat, 20 Aug 2022 21:48:04 +0200 [thread overview]
Message-ID: <20220820194804.3352415-12-andrew@lunn.ch> (raw)
In-Reply-To: <20220820194804.3352415-1-andrew@lunn.ch>
Signed-off-by: Andrew Lunn <andrew@lunn.ch>
---
.../clock/marvell,kirkwood-gating-clock.yaml | 230 ++++++++++++++++++
.../bindings/clock/mvebu-gated-clock.txt | 205 ----------------
2 files changed, 230 insertions(+), 205 deletions(-)
create mode 100644 Documentation/devicetree/bindings/clock/marvell,kirkwood-gating-clock.yaml
delete mode 100644 Documentation/devicetree/bindings/clock/mvebu-gated-clock.txt
diff --git a/Documentation/devicetree/bindings/clock/marvell,kirkwood-gating-clock.yaml b/Documentation/devicetree/bindings/clock/marvell,kirkwood-gating-clock.yaml
new file mode 100644
index 000000000000..b420a2c2a8d3
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/marvell,kirkwood-gating-clock.yaml
@@ -0,0 +1,230 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/marvell,kirkwood-gating-clock.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Marvel Gating Clock Device Tree Bindings
+
+maintainers:
+ - Andrew Lunn <andrew@lunn.ch>
+
+# Marvell Armada 370/375/380/385/39x/XP, Dove and Kirkwood allow some
+# peripheral clocks to be gated to save some power. The clock consumer
+# should specify the desired clock by having the clock ID in its
+# "clocks" phandle cell. The clock ID is directly mapped to the
+# corresponding clock gating control bit in HW to ease manual clock
+# lookup in datasheet.
+#
+# The following is a list of provided IDs for Armada 370:
+# ID Clock Peripheral
+# -----------------------------------
+# 0 Audio AC97 Cntrl
+# 1 pex0_en PCIe 0 Clock out
+# 2 pex1_en PCIe 1 Clock out
+# 3 ge1 Gigabit Ethernet 1
+# 4 ge0 Gigabit Ethernet 0
+# 5 pex0 PCIe Cntrl 0
+# 9 pex1 PCIe Cntrl 1
+# 15 sata0 SATA Host 0
+# 17 sdio SDHCI Host
+# 23 crypto CESA (crypto engine)
+# 25 tdm Time Division Mplx
+# 28 ddr DDR Cntrl
+# 30 sata1 SATA Host 0
+#
+# The following is a list of provided IDs for Armada 375:
+# ID Clock Peripheral
+# -----------------------------------
+# 2 mu Management Unit
+# 3 pp Packet Processor
+# 4 ptp PTP
+# 5 pex0 PCIe 0 Clock out
+# 6 pex1 PCIe 1 Clock out
+# 8 audio Audio Cntrl
+# 11 nd_clk Nand Flash Cntrl
+# 14 sata0_link SATA 0 Link
+# 15 sata0_core SATA 0 Core
+# 16 usb3 USB3 Host
+# 17 sdio SDHCI Host
+# 18 usb USB Host
+# 19 gop Gigabit Ethernet MAC
+# 20 sata1_link SATA 1 Link
+# 21 sata1_core SATA 1 Core
+# 22 xor0 XOR DMA 0
+# 23 xor1 XOR DMA 0
+# 24 copro Coprocessor
+# 25 tdm Time Division Mplx
+# 28 crypto0_enc Cryptographic Unit Port 0 Encryption
+# 29 crypto0_core Cryptographic Unit Port 0 Core
+# 30 crypto1_enc Cryptographic Unit Port 1 Encryption
+# 31 crypto1_core Cryptographic Unit Port 1 Core
+#
+# The following is a list of provided IDs for Armada 380/385:
+# ID Clock Peripheral
+# -----------------------------------
+# 0 audio Audio
+# 2 ge2 Gigabit Ethernet 2
+# 3 ge1 Gigabit Ethernet 1
+# 4 ge0 Gigabit Ethernet 0
+# 5 pex1 PCIe 1
+# 6 pex2 PCIe 2
+# 7 pex3 PCIe 3
+# 8 pex0 PCIe 0
+# 9 usb3h0 USB3 Host 0
+# 10 usb3h1 USB3 Host 1
+# 11 usb3d USB3 Device
+# 13 bm Buffer Management
+# 14 crypto0z Cryptographic 0 Z
+# 15 sata0 SATA 0
+# 16 crypto1z Cryptographic 1 Z
+# 17 sdio SDIO
+# 18 usb2 USB 2
+# 21 crypto1 Cryptographic 1
+# 22 xor0 XOR 0
+# 23 crypto0 Cryptographic 0
+# 25 tdm Time Division Multiplexing
+# 28 xor1 XOR 1
+# 30 sata1 SATA 1
+#
+# The following is a list of provided IDs for Armada 39x:
+# ID Clock Peripheral
+# -----------------------------------
+# 5 pex1 PCIe 1
+# 6 pex2 PCIe 2
+# 7 pex3 PCIe 3
+# 8 pex0 PCIe 0
+# 9 usb3h0 USB3 Host 0
+# 10 usb3h1 USB3 Host 1
+# 15 sata0 SATA 0
+# 17 sdio SDIO
+# 22 xor0 XOR 0
+# 28 xor1 XOR 1
+#
+# The following is a list of provided IDs for Armada XP:
+# ID Clock Peripheral
+# -----------------------------------
+# 0 audio Audio Cntrl
+# 1 ge3 Gigabit Ethernet 3
+# 2 ge2 Gigabit Ethernet 2
+# 3 ge1 Gigabit Ethernet 1
+# 4 ge0 Gigabit Ethernet 0
+# 5 pex0 PCIe Cntrl 0
+# 6 pex1 PCIe Cntrl 1
+# 7 pex2 PCIe Cntrl 2
+# 8 pex3 PCIe Cntrl 3
+# 13 bp
+# 14 sata0lnk
+# 15 sata0 SATA Host 0
+# 16 lcd LCD Cntrl
+# 17 sdio SDHCI Host
+# 18 usb0 USB Host 0
+# 19 usb1 USB Host 1
+# 20 usb2 USB Host 2
+# 22 xor0 XOR DMA 0
+# 23 crypto CESA engine
+# 25 tdm Time Division Mplx
+# 28 xor1 XOR DMA 1
+# 29 sata1lnk
+# 30 sata1 SATA Host 1
+#
+# The following is a list of provided IDs for 98dx3236:
+# ID Clock Peripheral
+# -----------------------------------
+# 3 ge1 Gigabit Ethernet 1
+# 4 ge0 Gigabit Ethernet 0
+# 5 pex0 PCIe Cntrl 0
+# 17 sdio SDHCI Host
+# 18 usb0 USB Host 0
+# 22 xor0 XOR DMA 0
+#
+# The following is a list of provided IDs for Dove:
+# ID Clock Peripheral
+# -----------------------------------
+# 0 usb0 USB Host 0
+# 1 usb1 USB Host 1
+# 2 ge Gigabit Ethernet
+# 3 sata SATA Host
+# 4 pex0 PCIe Cntrl 0
+# 5 pex1 PCIe Cntrl 1
+# 8 sdio0 SDHCI Host 0
+# 9 sdio1 SDHCI Host 1
+# 10 nand NAND Cntrl
+# 11 camera Camera Cntrl
+# 12 i2s0 I2S Cntrl 0
+# 13 i2s1 I2S Cntrl 1
+# 15 crypto CESA engine
+# 21 ac97 AC97 Cntrl
+# 22 pdma Peripheral DMA
+# 23 xor0 XOR DMA 0
+# 24 xor1 XOR DMA 1
+# 30 gephy Gigabit Ethernel PHY
+# Note: gephy(30) is implemented as a parent clock of ge(2)
+#
+# The following is a list of provided IDs for Kirkwood:
+# ID Clock Peripheral
+# -----------------------------------
+# 0 ge0 Gigabit Ethernet 0
+# 2 pex0 PCIe Cntrl 0
+# 3 usb0 USB Host 0
+# 4 sdio SDIO Cntrl
+# 5 tsu Transp. Stream Unit
+# 6 dunit SDRAM Cntrl
+# 7 runit Runit
+# 8 xor0 XOR DMA 0
+# 9 audio I2S Cntrl 0
+# 14 sata0 SATA Host 0
+# 15 sata1 SATA Host 1
+# 16 xor1 XOR DMA 1
+# 17 crypto CESA engine
+# 18 pex1 PCIe Cntrl 1
+# 19 ge1 Gigabit Ethernet 1
+# 20 tdm Time Division Mplx
+#
+#
+
+properties:
+ compatible:
+ enum:
+ - marvell,armada-370-gating-clock
+ - marvell,armada-375-gating-clock
+ - marvell,armada-380-gating-clock
+ - marvell,armada-390-gating-clock
+ - marvell,armada-xp-gating-clock
+ - marvell,mv98dx3236-gating-clock
+ - marvell,dove-gating-clock
+ - marvell,kirkwood-gating-clock
+
+ reg:
+ description:
+ Shall be the register address of the Clock Gating Control register
+ maxItems: 1
+
+ "#clock-cells":
+ const: 1
+ description:
+ This additional argument passed to that clock is the offset of
+ the bit controlling this particular gate in the register.
+
+ clocks:
+ description:
+ default parent clock phandle (e.g. tclk)
+ maxItems: 1
+
+required:
+ - "#clock-cells"
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ gate_clk: clock-gating-control@d0038 {
+ compatible = "marvell,dove-gating-clock";
+ reg = <0xd0038 0x4>;
+ /* default parent clock is tclk */
+ clocks = <&core_clk 0>;
+ #clock-cells = <1>;
+ };
+...
diff --git a/Documentation/devicetree/bindings/clock/mvebu-gated-clock.txt b/Documentation/devicetree/bindings/clock/mvebu-gated-clock.txt
deleted file mode 100644
index de562da2ae77..000000000000
--- a/Documentation/devicetree/bindings/clock/mvebu-gated-clock.txt
+++ /dev/null
@@ -1,205 +0,0 @@
-* Gated Clock bindings for Marvell EBU SoCs
-
-Marvell Armada 370/375/380/385/39x/XP, Dove and Kirkwood allow some
-peripheral clocks to be gated to save some power. The clock consumer
-should specify the desired clock by having the clock ID in its
-"clocks" phandle cell. The clock ID is directly mapped to the
-corresponding clock gating control bit in HW to ease manual clock
-lookup in datasheet.
-
-The following is a list of provided IDs for Armada 370:
-ID Clock Peripheral
------------------------------------
-0 Audio AC97 Cntrl
-1 pex0_en PCIe 0 Clock out
-2 pex1_en PCIe 1 Clock out
-3 ge1 Gigabit Ethernet 1
-4 ge0 Gigabit Ethernet 0
-5 pex0 PCIe Cntrl 0
-9 pex1 PCIe Cntrl 1
-15 sata0 SATA Host 0
-17 sdio SDHCI Host
-23 crypto CESA (crypto engine)
-25 tdm Time Division Mplx
-28 ddr DDR Cntrl
-30 sata1 SATA Host 0
-
-The following is a list of provided IDs for Armada 375:
-ID Clock Peripheral
------------------------------------
-2 mu Management Unit
-3 pp Packet Processor
-4 ptp PTP
-5 pex0 PCIe 0 Clock out
-6 pex1 PCIe 1 Clock out
-8 audio Audio Cntrl
-11 nd_clk Nand Flash Cntrl
-14 sata0_link SATA 0 Link
-15 sata0_core SATA 0 Core
-16 usb3 USB3 Host
-17 sdio SDHCI Host
-18 usb USB Host
-19 gop Gigabit Ethernet MAC
-20 sata1_link SATA 1 Link
-21 sata1_core SATA 1 Core
-22 xor0 XOR DMA 0
-23 xor1 XOR DMA 0
-24 copro Coprocessor
-25 tdm Time Division Mplx
-28 crypto0_enc Cryptographic Unit Port 0 Encryption
-29 crypto0_core Cryptographic Unit Port 0 Core
-30 crypto1_enc Cryptographic Unit Port 1 Encryption
-31 crypto1_core Cryptographic Unit Port 1 Core
-
-The following is a list of provided IDs for Armada 380/385:
-ID Clock Peripheral
------------------------------------
-0 audio Audio
-2 ge2 Gigabit Ethernet 2
-3 ge1 Gigabit Ethernet 1
-4 ge0 Gigabit Ethernet 0
-5 pex1 PCIe 1
-6 pex2 PCIe 2
-7 pex3 PCIe 3
-8 pex0 PCIe 0
-9 usb3h0 USB3 Host 0
-10 usb3h1 USB3 Host 1
-11 usb3d USB3 Device
-13 bm Buffer Management
-14 crypto0z Cryptographic 0 Z
-15 sata0 SATA 0
-16 crypto1z Cryptographic 1 Z
-17 sdio SDIO
-18 usb2 USB 2
-21 crypto1 Cryptographic 1
-22 xor0 XOR 0
-23 crypto0 Cryptographic 0
-25 tdm Time Division Multiplexing
-28 xor1 XOR 1
-30 sata1 SATA 1
-
-The following is a list of provided IDs for Armada 39x:
-ID Clock Peripheral
------------------------------------
-5 pex1 PCIe 1
-6 pex2 PCIe 2
-7 pex3 PCIe 3
-8 pex0 PCIe 0
-9 usb3h0 USB3 Host 0
-10 usb3h1 USB3 Host 1
-15 sata0 SATA 0
-17 sdio SDIO
-22 xor0 XOR 0
-28 xor1 XOR 1
-
-The following is a list of provided IDs for Armada XP:
-ID Clock Peripheral
------------------------------------
-0 audio Audio Cntrl
-1 ge3 Gigabit Ethernet 3
-2 ge2 Gigabit Ethernet 2
-3 ge1 Gigabit Ethernet 1
-4 ge0 Gigabit Ethernet 0
-5 pex0 PCIe Cntrl 0
-6 pex1 PCIe Cntrl 1
-7 pex2 PCIe Cntrl 2
-8 pex3 PCIe Cntrl 3
-13 bp
-14 sata0lnk
-15 sata0 SATA Host 0
-16 lcd LCD Cntrl
-17 sdio SDHCI Host
-18 usb0 USB Host 0
-19 usb1 USB Host 1
-20 usb2 USB Host 2
-22 xor0 XOR DMA 0
-23 crypto CESA engine
-25 tdm Time Division Mplx
-28 xor1 XOR DMA 1
-29 sata1lnk
-30 sata1 SATA Host 1
-
-The following is a list of provided IDs for 98dx3236:
-ID Clock Peripheral
------------------------------------
-3 ge1 Gigabit Ethernet 1
-4 ge0 Gigabit Ethernet 0
-5 pex0 PCIe Cntrl 0
-17 sdio SDHCI Host
-18 usb0 USB Host 0
-22 xor0 XOR DMA 0
-
-The following is a list of provided IDs for Dove:
-ID Clock Peripheral
------------------------------------
-0 usb0 USB Host 0
-1 usb1 USB Host 1
-2 ge Gigabit Ethernet
-3 sata SATA Host
-4 pex0 PCIe Cntrl 0
-5 pex1 PCIe Cntrl 1
-8 sdio0 SDHCI Host 0
-9 sdio1 SDHCI Host 1
-10 nand NAND Cntrl
-11 camera Camera Cntrl
-12 i2s0 I2S Cntrl 0
-13 i2s1 I2S Cntrl 1
-15 crypto CESA engine
-21 ac97 AC97 Cntrl
-22 pdma Peripheral DMA
-23 xor0 XOR DMA 0
-24 xor1 XOR DMA 1
-30 gephy Gigabit Ethernel PHY
-Note: gephy(30) is implemented as a parent clock of ge(2)
-
-The following is a list of provided IDs for Kirkwood:
-ID Clock Peripheral
------------------------------------
-0 ge0 Gigabit Ethernet 0
-2 pex0 PCIe Cntrl 0
-3 usb0 USB Host 0
-4 sdio SDIO Cntrl
-5 tsu Transp. Stream Unit
-6 dunit SDRAM Cntrl
-7 runit Runit
-8 xor0 XOR DMA 0
-9 audio I2S Cntrl 0
-14 sata0 SATA Host 0
-15 sata1 SATA Host 1
-16 xor1 XOR DMA 1
-17 crypto CESA engine
-18 pex1 PCIe Cntrl 1
-19 ge1 Gigabit Ethernet 1
-20 tdm Time Division Mplx
-
-Required properties:
-- compatible : shall be one of the following:
- "marvell,armada-370-gating-clock" - for Armada 370 SoC clock gating
- "marvell,armada-375-gating-clock" - for Armada 375 SoC clock gating
- "marvell,armada-380-gating-clock" - for Armada 380/385 SoC clock gating
- "marvell,armada-390-gating-clock" - for Armada 39x SoC clock gating
- "marvell,armada-xp-gating-clock" - for Armada XP SoC clock gating
- "marvell,mv98dx3236-gating-clock" - for 98dx3236 SoC clock gating
- "marvell,dove-gating-clock" - for Dove SoC clock gating
- "marvell,kirkwood-gating-clock" - for Kirkwood SoC clock gating
-- reg : shall be the register address of the Clock Gating Control register
-- #clock-cells : from common clock binding; shall be set to 1
-
-Optional properties:
-- clocks : default parent clock phandle (e.g. tclk)
-
-Example:
-
-gate_clk: clock-gating-control@d0038 {
- compatible = "marvell,dove-gating-clock";
- reg = <0xd0038 0x4>;
- /* default parent clock is tclk */
- clocks = <&core_clk 0>;
- #clock-cells = <1>;
-};
-
-sdio0: sdio@92000 {
- compatible = "marvell,dove-sdhci";
- /* get clk gate bit 8 (sdio0) */
- clocks = <&gate_clk 8>;
-};
--
2.37.2
next prev parent reply other threads:[~2022-08-20 19:48 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-08-20 19:47 [PATCH 00/11] Start converting MVEBU bindings to YAML Andrew Lunn
2022-08-20 19:47 ` [PATCH 01/11] DT: RTC: orion-rtc: Convert " Andrew Lunn
2022-08-22 20:49 ` Rob Herring
2022-08-22 20:55 ` Rob Herring
2022-08-20 19:47 ` [PATCH 02/11] DT: thermal: marvell,kirkwood-thermal: " Andrew Lunn
2022-08-20 19:47 ` [PATCH 03/11] DT: pinctrl: Convert marvell,kirkwood-pintctrl " Andrew Lunn
2022-08-22 21:16 ` Rob Herring
2022-08-20 19:47 ` [PATCH 04/11] DT: USB: Convert ehci-orion " Andrew Lunn
2022-08-21 20:21 ` Rob Herring
2022-08-20 19:47 ` [PATCH 05/11] DT: watchdog: Convert marvel.txt " Andrew Lunn
2022-08-21 20:21 ` Rob Herring
2022-08-22 0:20 ` Andrew Lunn
2022-08-22 13:47 ` Rob Herring
2022-08-20 19:47 ` [PATCH 06/11] arm: DT: kirkwood/orion5: Rename watchdog node Andrew Lunn
2022-08-20 19:48 ` [PATCH 07/11] DT: nand-controller: Reflect reality of marvell,orion-nand Andrew Lunn
2022-08-21 20:21 ` Rob Herring
2022-08-20 19:48 ` [PATCH 08/11] DT: mtd: Convert orion-nand to YAML Andrew Lunn
2022-08-21 20:21 ` Rob Herring
2022-08-22 0:48 ` Andrew Lunn
2022-08-22 13:43 ` Rob Herring
2022-08-20 19:48 ` [PATCH 09/11] arm: DT: kirkwood.dtsi: Rename nand to nand-controller Andrew Lunn
2022-08-20 19:48 ` [PATCH 10/11] DT: timer: Convert marvell,orion-timer.txt to YAML Andrew Lunn
2022-08-20 19:48 ` Andrew Lunn [this message]
2022-08-22 13:49 ` [PATCH 00/11] Start converting MVEBU bindings " Rob Herring
2022-08-22 13:53 ` Rob Herring
2022-08-22 14:28 ` Andrew Lunn
2022-08-30 18:58 ` Rob Herring
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220820194804.3352415-12-andrew@lunn.ch \
--to=andrew@lunn.ch \
--cc=arm@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=gregory.clement@bootlin.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).