]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
dt-bindings: clock: Convert marvell,armada-3700-periph-clock to DT schema
authorRob Herring (Arm) <robh@kernel.org>
Wed, 21 May 2025 21:18:25 +0000 (16:18 -0500)
committerStephen Boyd <sboyd@kernel.org>
Thu, 19 Jun 2025 01:41:30 +0000 (18:41 -0700)
Convert the Marvell Armada 3700 peripheral clock binding to DT schema
format. The north bridge is also a "syscon", so add the compatible to
it.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20250521211826.77098-1-robh@kernel.org
Signed-off-by: Stephen Boyd <sboyd@kernel.org>
Documentation/devicetree/bindings/clock/armada3700-periph-clock.txt [deleted file]
Documentation/devicetree/bindings/clock/marvell,armada-3700-periph-clock.yaml [new file with mode: 0644]

diff --git a/Documentation/devicetree/bindings/clock/armada3700-periph-clock.txt b/Documentation/devicetree/bindings/clock/armada3700-periph-clock.txt
deleted file mode 100644 (file)
index fbf58c4..0000000
+++ /dev/null
@@ -1,71 +0,0 @@
-* Peripheral Clock bindings for Marvell Armada 37xx SoCs
-
-Marvell Armada 37xx SoCs provide peripheral clocks which are
-used as clock source for the peripheral of the SoC.
-
-There are two different blocks associated to north bridge and south
-bridge.
-
-The peripheral clock consumer should specify the desired clock by
-having the clock ID in its "clocks" phandle cell.
-
-The following is a list of provided IDs for Armada 3700 North bridge clocks:
-ID     Clock name      Description
------------------------------------
-0      mmc             MMC controller
-1      sata_host       Sata Host
-2      sec_at          Security AT
-3      sac_dap         Security DAP
-4      tsecm           Security Engine
-5      setm_tmx        Serial Embedded Trace Module
-6      avs             Adaptive Voltage Scaling
-7      sqf             SPI
-8      pwm             PWM
-9      i2c_2           I2C 2
-10     i2c_1           I2C 1
-11     ddr_phy         DDR PHY
-12     ddr_fclk        DDR F clock
-13     trace           Trace
-14     counter         Counter
-15     eip97           EIP 97
-16     cpu             CPU
-
-The following is a list of provided IDs for Armada 3700 South bridge clocks:
-ID     Clock name      Description
------------------------------------
-0      gbe-50          50 MHz parent clock for Gigabit Ethernet
-1      gbe-core        parent clock for Gigabit Ethernet core
-2      gbe-125         125 MHz parent clock for Gigabit Ethernet
-3      gbe1-50         50 MHz clock for Gigabit Ethernet port 1
-4      gbe0-50         50 MHz clock for Gigabit Ethernet port 0
-5      gbe1-125        125 MHz clock for Gigabit Ethernet port 1
-6      gbe0-125        125 MHz clock for Gigabit Ethernet port 0
-7      gbe1-core       Gigabit Ethernet core port 1
-8      gbe0-core       Gigabit Ethernet core port 0
-9      gbe-bm          Gigabit Ethernet Buffer Manager
-10     sdio            SDIO
-11     usb32-sub2-sys  USB 2 clock
-12     usb32-ss-sys    USB 3 clock
-13     pcie            PCIe controller
-
-Required properties:
-
-- compatible : shall be "marvell,armada-3700-periph-clock-nb" for the
-  north bridge block, or
-  "marvell,armada-3700-periph-clock-sb" for the south bridge block
-- reg : must be the register address of North/South Bridge Clock register
-- #clock-cells : from common clock binding; shall be set to 1
-
-- clocks : list of the parent clock phandle in the following order:
-  TBG-A P, TBG-B P, TBG-A S, TBG-B S and finally the xtal clock.
-
-
-Example:
-
-nb_perih_clk: nb-periph-clk@13000{
-       compatible = "marvell,armada-3700-periph-clock-nb";
-       reg = <0x13000 0x1000>;
-       clocks = <&tbg 0>, <&tbg 1>, <&tbg 2>,
-       <&tbg 3>, <&xtalclk>;
-       #clock-cells = <1>;
-};
diff --git a/Documentation/devicetree/bindings/clock/marvell,armada-3700-periph-clock.yaml b/Documentation/devicetree/bindings/clock/marvell,armada-3700-periph-clock.yaml
new file mode 100644 (file)
index 0000000..87e8e4c
--- /dev/null
@@ -0,0 +1,96 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/marvell,armada-3700-periph-clock.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Marvell Armada 37xx SoCs Peripheral Clocks
+
+maintainers:
+  - Andrew Lunn <andrew@lunn.ch>
+  - Gregory Clement <gregory.clement@bootlin.com>
+
+description: >
+  Marvell Armada 37xx SoCs provide peripheral clocks which are used as clock
+  source for the peripheral of the SoC.
+
+  There are two different blocks associated to north bridge and south bridge.
+
+  The following is a list of provided IDs for Armada 3700 North bridge clocks:
+
+    ID Clock name      Description
+    -----------------------------------
+    0  mmc             MMC controller
+    1  sata_host       Sata Host
+    2  sec_at          Security AT
+    3  sac_dap         Security DAP
+    4  tsecm           Security Engine
+    5  setm_tmx        Serial Embedded Trace Module
+    6  avs             Adaptive Voltage Scaling
+    7  sqf             SPI
+    8  pwm             PWM
+    9  i2c_2           I2C 2
+    10 i2c_1           I2C 1
+    11 ddr_phy         DDR PHY
+    12 ddr_fclk        DDR F clock
+    13 trace           Trace
+    14 counter         Counter
+    15 eip97           EIP 97
+    16 cpu             CPU
+
+  The following is a list of provided IDs for Armada 3700 South bridge clocks:
+
+    ID Clock name      Description
+    -----------------------------------
+    0  gbe-50          50 MHz parent clock for Gigabit Ethernet
+    1  gbe-core        parent clock for Gigabit Ethernet core
+    2  gbe-125         125 MHz parent clock for Gigabit Ethernet
+    3  gbe1-50         50 MHz clock for Gigabit Ethernet port 1
+    4  gbe0-50         50 MHz clock for Gigabit Ethernet port 0
+    5  gbe1-125        125 MHz clock for Gigabit Ethernet port 1
+    6  gbe0-125        125 MHz clock for Gigabit Ethernet port 0
+    7  gbe1-core       Gigabit Ethernet core port 1
+    8  gbe0-core       Gigabit Ethernet core port 0
+    9  gbe-bm          Gigabit Ethernet Buffer Manager
+    10 sdio            SDIO
+    11 usb32-sub2-sys  USB 2 clock
+    12 usb32-ss-sys    USB 3 clock
+    13 pcie            PCIe controller
+
+properties:
+  compatible:
+    oneOf:
+      - const: marvell,armada-3700-periph-clock-sb
+      - items:
+          - const: marvell,armada-3700-periph-clock-nb
+          - const: syscon
+  reg:
+    maxItems: 1
+
+  clocks:
+    items:
+      - description: TBG-A P clock and specifier
+      - description: TBG-B P clock and specifier
+      - description: TBG-A S clock and specifier
+      - description: TBG-B S clock and specifier
+      - description: Xtal clock and specifier
+
+  '#clock-cells':
+    const: 1
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    clock-controller@13000{
+        compatible = "marvell,armada-3700-periph-clock-sb";
+        reg = <0x13000 0x1000>;
+        clocks = <&tbg 0>, <&tbg 1>, <&tbg 2>, <&tbg 3>, <&xtalclk>;
+        #clock-cells = <1>;
+    };