Skip to contentSkip to conversation

ohci and ehci-platform clks, phy and dt support

PATCH Superseded Hans de Goede 4 participants 9 messages Jan 8, 2014 – Jan 9, 2014

Subsystems (4)

v2 of 9 Superseded Latest is v9 →

lore
Share & tools
lore
#0 lore raw

v2 cover ohci and ehci-platform clks, phy and dt support

Hi All,

Here is v2 of my ohci and ehci-platform clks, phy and dt support patch-set.

Changes since v1:
-Various improvements to dt-bindings as suggested by various people -Support up-to 3 clocks

Regards,

Hans

#1 lore raw

PATCH v2 1/2 ohci-platform: Add support for devicetree instantiation

Add support for ohci-platform instantiation from devicetree, including optionally getting clks and a phy from devicetree, and enabling / disabling those on power_on / off.

This should allow using ohci-platform from devicetree in various cases. Specifically after this commit it can be used for the ohci controller found on Allwinner sunxi SoCs.

---
 .../devicetree/bindings/usb/platform-ohci.txt      |  25 ++++
 drivers/usb/host/ohci-platform.c                   | 148 ++++++++++++++++++---
 2 files changed, 153 insertions(+), 20 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/usb/platform-ohci.txt
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +25 -0
new file mode 100644
index 0000000..44bfa57
@@ -0,0 +1,25 @@
+Generic Platform OHCI controller
+
+Required properties:
+- compatible : "allwinner,sun4i-ohci"
+- reg : ohci controller register range (address and length)
+- interrupts : ohci controller interrupt
+
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy
+- phy-names : "phy0"
+
+Example:
+
+	ohci0: ohci at 0x01c14400 {
+		compatible = "allwinner,sun4i-ohci";
+		reg = <0x01c14400 0x100>;
+		interrupts = <64>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";
+		phys = <&usbphy 1>;
+		phy-names = "phy0";
+	};
drivers/usb/host/ohci-platform.c +128 -20

224 lines not on this page · raw message

Signature · 1 line
1.8.4.2
#2 lore raw

PATCH v2 1/2 ohci-platform: Add support for devicetree instantiation

Hello,

2014/1/8 Hans de Goede <[email protected]>:

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 20 lines

Add support for ohci-platform instantiation from devicetree, including optionally getting clks and a phy from devicetree, and enabling / disabling those on power_on / off.

This should allow using ohci-platform from devicetree in various cases. Specifically after this commit it can be used for the ohci controller found on Allwinner sunxi SoCs.

---
 .../devicetree/bindings/usb/platform-ohci.txt      |  25 ++++
 drivers/usb/host/ohci-platform.c                   | 148 ++++++++++++++++++---
 2 files changed, 153 insertions(+), 20 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/usb/platform-ohci.txt
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +0 -0
new file mode 100644
index 0000000..44bfa57

ohci-mmio might be a better name than platform maybe?

[snip]

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 12 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +12 -0
+static int ohci_platform_power_on(struct platform_device *dev)
+{
+       struct usb_hcd *hcd = platform_get_drvdata(dev);
+       struct ohci_platform_priv *priv =
+               (struct ohci_platform_priv *)hcd_to_ohci(hcd)->priv;
+       int clk, ret;
+
+       for (clk = 0; priv->clks[clk] && clk < OHCI_MAX_CLKS; clk++) {
+               ret = clk_prepare_enable(priv->clks[clk]);
+               if (ret)
+                       goto err_disable_clks;
+       }

Do we really need to cap this to OHCI_MAX_CLKS, the next driver which has 4 clocks will have to bump this, so maybe a linked-list would be best?

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +10 -0
+
+       if (priv->phy) {
+               ret = phy_init(priv->phy);
+               if (ret)
+                       goto err_disable_clks;
+
+               ret = phy_power_on(priv->phy);
+               if (ret)
+                       goto err_exit_phy;
+       }

Although I do value the idea of having DT probing for ohci-platform, ehci-platform et al, I am not sure if this really belongs in the generic OHCI platform driver, or if we should rather have small glue drivers which register the ohci-platform driver and which provides all the platform-specific power_on, power_off, suspend callbacks to the ohci platform driver? Such glue driver would be the one which gets probed based off a specific compatible string a

At first glance it does look like this covers 80% of the existing OHCI drivers out there, so this is good. We might also want to support clock pointers provided via platform_data so we can remove ohci-at91, ohci-ep93xx, ohci-spear and friends in the future.

ohci-ppc-of could also probably be removed once we add quirks and endian properties parsing to ohci-platform?

Quoted 79 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +54 -6
+
+       return 0;
+
+err_exit_phy:
+       phy_exit(priv->phy);
+err_disable_clks:
+       while (--clk >= 0)
+               clk_disable_unprepare(priv->clks[clk]);
+
+       return ret;
+}
+
+static void ohci_platform_power_off(struct platform_device *dev)
+{
+       struct usb_hcd *hcd = platform_get_drvdata(dev);
+       struct ohci_platform_priv *priv =
+               (struct ohci_platform_priv *)hcd_to_ohci(hcd)->priv;
+       int clk;
+
+       if (priv->phy) {
+               phy_power_off(priv->phy);
+               phy_exit(priv->phy);
+       }
+
+       for (clk = OHCI_MAX_CLKS - 1; clk >= 0; clk--)
+               if (priv->clks[clk])
+                       clk_disable_unprepare(priv->clks[clk]);
+}
+
 static struct hc_driver __read_mostly ohci_platform_hc_driver;
 
 static const struct ohci_driver_overrides platform_overrides __initconst = {
-       .product_desc = "Generic Platform OHCI controller",
-       .reset =        ohci_platform_reset,
+       .product_desc =         "Generic Platform OHCI controller",
+       .reset =                ohci_platform_reset,
+       .extra_priv_size =      sizeof(struct ohci_platform_priv),
+};
+
+static struct usb_ohci_pdata ohci_platform_defaults = {
+       .power_on =             ohci_platform_power_on,
+       .power_suspend =        ohci_platform_power_off,
+       .power_off =            ohci_platform_power_off,
 };
 
 static int ohci_platform_probe(struct platform_device *dev)
@@ -60,12 +128,24 @@ static int ohci_platform_probe(struct platform_device *dev)
        struct usb_hcd *hcd;
        struct resource *res_mem;
        struct usb_ohci_pdata *pdata = dev_get_platdata(&dev->dev);
-       int irq;
-       int err = -ENOMEM;
+       int clk, irq, err;
+       char name[8];
 
+       /*
+        * Use reasonable defaults so platforms don't have to provide these
+        * with DT probing on ARM.
+        */
        if (!pdata) {
-               WARN_ON(1);
-               return -ENODEV;
+               pdata = dev->dev.platform_data = &ohci_platform_defaults;
+               /*
+                * Right now device-tree probed devices don't get dma_mask set.
+                * Since shared usb code relies on it, set it here for now.
+                * Once we have dma capability bindings this can go away.
+                */
+               err = dma_coerce_mask_and_coherent(&dev->dev,
+                                                  DMA_BIT_MASK(32));
+               if (err)
+                       return err;
        }
 
        if (usb_disabled())
@@ -83,17 +163,40 @@ static int ohci_platform_probe(struct platform_device *dev)
                return -ENXIO;
        }
 

Documentation/devicetree/bindings/usb/platform-ohci.txt static int ohci_platform_probe(struct platform_device *dev) · line 175

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +10 -0
+       hcd = usb_create_hcd(&ohci_platform_hc_driver, &dev->dev,
+                       dev_name(&dev->dev));
+       if (!hcd)
+               return -ENOMEM;
+
+       if (pdata == &ohci_platform_defaults) {
+               struct ohci_platform_priv *priv = (struct ohci_platform_priv *)
+                                                 hcd_to_ohci(hcd)->priv;
+
+               priv->phy = devm_phy_get(&dev->dev, "phy0");

Does this work with a more than one OHCI controller which could possibly have a dedicated PHY?

Quoted 6 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +6 -0
+               if (IS_ERR(priv->phy)) {
+                       err = PTR_ERR(priv->phy);
+                       if (err == -EPROBE_DEFER)
+                               goto err_put_hcd;
+                       priv->phy = NULL;
+               }
#3 lore raw

PATCH v2 1/2 ohci-platform: Add support for devicetree instantiation

Hi,

Quoted 18 lines · Florian Fainelli

Hello,

2014/1/8 Hans de Goede <[email protected]>:

Quoted 15 lines

Add support for ohci-platform instantiation from devicetree, including optionally getting clks and a phy from devicetree, and enabling / disabling those on power_on / off.

This should allow using ohci-platform from devicetree in various cases. Specifically after this commit it can be used for the ohci controller found on Allwinner sunxi SoCs.

---
  .../devicetree/bindings/usb/platform-ohci.txt      |  25 ++++
  drivers/usb/host/ohci-platform.c                   | 148 ++++++++++++++++++---
  2 files changed, 153 insertions(+), 20 deletions(-)

create mode 100644 Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 7 lines

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 5 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +0 -0
new file mode 100644
index 0000000..44bfa57

ohci-mmio might be a better name than platform maybe?

We already have platform-uhci too, and this matches the name of the .c file so that people can actually correlate the 2.

Quoted 19 lines

[snip]

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 12 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +12 -0
+static int ohci_platform_power_on(struct platform_device *dev)
+{
+       struct usb_hcd *hcd = platform_get_drvdata(dev);
+       struct ohci_platform_priv *priv =
+               (struct ohci_platform_priv *)hcd_to_ohci(hcd)->priv;
+       int clk, ret;
+
+       for (clk = 0; priv->clks[clk] && clk < OHCI_MAX_CLKS; clk++) {
+               ret = clk_prepare_enable(priv->clks[clk]);
+               if (ret)
+                       goto err_disable_clks;
+       }

Do we really need to cap this to OHCI_MAX_CLKS, the next driver which has 4 clocks will have to bump this, so maybe a linked-list would be best?

I can make OHCI_MAX_CLKS 4 or 8 if that makes you happy, other then that I greatly prefer to keep this KISS. Devices with 3 clks are already quite rare, so its not like we're going to need to bump this every other week a linked list where a simple array suffices is just overkill and unnecessarily complicates things.

Quoted 12 lines

Documentation/devicetree/bindings/usb/platform-ohci.txt

Quoted 11 lines
Documentation/devicetree/bindings/usb/platform-ohci.txt new file +10 -0
+
+       if (priv->phy) {
+               ret = phy_init(priv->phy);
+               if (ret)
+                       goto err_disable_clks;
+
+               ret = phy_power_on(priv->phy);
+               if (ret)
+                       goto err_exit_phy;
+       }
Quoted 7 lines

Although I do value the idea of having DT probing for ohci-platform, ehci-platform et al, I am not sure if this really belongs in the generic OHCI platform driver, or if we should rather have small glue drivers which register the ohci-platform driver and which provides all the platform-specific power_on, power_off, suspend callbacks to the ohci platform driver? Such glue driver would be the one which gets probed based off a specific compatible string a

This can already be done by having a platform driver with its own compatible string providing platform data with the hooks. The whole idea here is to avoid having to write such a glue driver for every other soc, so cover the common simple case, and use glue drivers for more complicated scenarios.

Quoted 4 lines

At first glance it does look like this covers 80% of the existing OHCI drivers out there, so this is good. We might also want to support clock pointers provided via platform_data so we can remove ohci-at91, ohci-ep93xx, ohci-spear and friends in the future.

Lets first get the generic devicetree support merged as is, if after that people want to extend it, so that (more) existing ohci drivers can be removed, they are very much welcome to do so. Preferably people with access to the hardware, so that they can actually test the changes.

Quoted 2 lines

ohci-ppc-of could also probably be removed once we add quirks and endian properties parsing to ohci-platform?

Add-on patches extending my initial work are welcome. Again probably best done by people who actually have access to the relevant hw.

Regards,

Hans

#4 lore raw

PATCH v2 2/2 ehci-platform: Add support for clks and phy passed through devicetree

In reply to Hans de Goede

Currently ehci-platform is only used in combination with devicetree when used with some via socs. By extending it to (optionally) get clks and a phy from devicetree, and enabling / disabling those on power_on / off, it can be used more generically. Specifically after this commit it can be used for the ehci controller on Allwinner sunxi SoCs.

Somehow we've ended up with 2 device-bindings documents for ehci-platform.c, this patch renames and updates one to platform-ehci.txt to reflect that this is a generic platform driver, and removes the other.

---
 .../devicetree/bindings/usb/platform-ehci.txt      |  25 ++++
 .../devicetree/bindings/usb/via,vt8500-ehci.txt    |  15 ---
 .../devicetree/bindings/usb/vt8500-ehci.txt        |  12 --
 drivers/usb/host/ehci-platform.c                   | 126 +++++++++++++++++----
 4 files changed, 131 insertions(+), 47 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/usb/platform-ehci.txt
 delete mode 100644 Documentation/devicetree/bindings/usb/via,vt8500-ehci.txt
 delete mode 100644 Documentation/devicetree/bindings/usb/vt8500-ehci.txt
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +25 -0
new file mode 100644
index 0000000..56c478d
@@ -0,0 +1,25 @@
+Generic Platform EHCI controller
+
+Required properties:
+- compatible : "via,vt8500-ehci" or "wm,prizm-ehci"
+- reg : ehci controller register range (address and length)
+- interrupts : ehci controller interrupt
+
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy
+- phy-names : "phy0"
+
+Example:
+
+	ehci at d8007900 {
+		compatible = "via,vt8500-ehci";
+		reg = <0xd8007900 0x200>;
+		interrupts = <43>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";
+		phys = <&usbphy 1>;
+		phy-names = "phy0";
+	};
Documentation/devicetree/bindings/usb/via,vt8500-ehci.txt deleted +0 -15
deleted file mode 100644
index 17b3ad1..0000000
@@ -1,15 +0,0 @@
-VIA/Wondermedia VT8500 EHCI Controller
------------------------------------------------------
-
-Required properties:
-- compatible : "via,vt8500-ehci"
-- reg : Should contain 1 register ranges(address and length)
-- interrupts : ehci controller interrupt
-
-Example:
-
-	ehci at d8007900 {
-		compatible = "via,vt8500-ehci";
-		reg = <0xd8007900 0x200>;
-		interrupts = <43>;
-	};
Documentation/devicetree/bindings/usb/vt8500-ehci.txt deleted +0 -12
deleted file mode 100644
index 5fb8fd6..0000000
@@ -1,12 +0,0 @@
-VIA VT8500 and Wondermedia WM8xxx SoC USB controllers.
-
-Required properties:
- - compatible: Should be "via,vt8500-ehci" or "wm,prizm-ehci".
- - reg: Address range of the ehci registers. size should be 0x200
- - interrupts: Should contain the ehci interrupt.
-
-usb: ehci at D8007100 {
-	compatible = "wm,prizm-ehci", "usb-ehci";
-	reg = <0xD8007100 0x200>;
-	interrupts = <1>;
-};
drivers/usb/host/ehci-platform.c +106 -20

196 lines not on this page · raw message

Signature · 1 line
1.8.4.2
#5 lore raw

PATCH v2 2/2 ehci-platform: Add support for clks and phy passed through devicetree

Quoted 39 lines · Hans de Goede

Currently ehci-platform is only used in combination with devicetree when used with some via socs. By extending it to (optionally) get clks and a phy from devicetree, and enabling / disabling those on power_on / off, it can be used more generically. Specifically after this commit it can be used for the ehci controller on Allwinner sunxi SoCs.

Somehow we've ended up with 2 device-bindings documents for ehci-platform.c, this patch renames and updates one to platform-ehci.txt to reflect that this is a generic platform driver, and removes the other.

---
 .../devicetree/bindings/usb/platform-ehci.txt      |  25 ++++
 .../devicetree/bindings/usb/via,vt8500-ehci.txt    |  15 ---
 .../devicetree/bindings/usb/vt8500-ehci.txt        |  12 --
 drivers/usb/host/ehci-platform.c                   | 126 +++++++++++++++++----
 4 files changed, 131 insertions(+), 47 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/usb/platform-ehci.txt
 delete mode 100644 Documentation/devicetree/bindings/usb/via,vt8500-ehci.txt
 delete mode 100644 Documentation/devicetree/bindings/usb/vt8500-ehci.txt
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +12 -0
new file mode 100644
index 0000000..56c478d
@@ -0,0 +1,25 @@
+Generic Platform EHCI controller
+
+Required properties:
+- compatible : "via,vt8500-ehci" or "wm,prizm-ehci"
+- reg : ehci controller register range (address and length)
+- interrupts : ehci controller interrupt
+
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy

Documentation/devicetree/bindings/usb/platform-ehci.txt line 22

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +10 -0
+- phy-names : "phy0"
+
+Example:
+
+	ehci at d8007900 {
+		compatible = "via,vt8500-ehci";
+		reg = <0xd8007900 0x200>;
+		interrupts = <43>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";

I'm really not convinced by this either. It prevents you from doing anything useful out of these clocks, and the only thing you can actually do with it is calling clk_get, and that's pretty much it.

What if you some platform needs to adjust the rate of one of the two? Or wants to cut one but not the other for any reason? You're just screwed, and you can do anything about it, because you have no way of telling what "clk0" is used for.

Especially, since what you really want is to access the clocks by index, that you can do with of_clk_get.

Calling it "bus" and "phy" or whatever it's used for both provide a way of differentiating the two, yet being rather generic. And if we need to add a third one, I'm pretty sure we will be able to come up with a generic name then.

Maxime

Signature · 10 lines
Maxime Ripard, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.infradead.org/pipermail/linux-arm-kernel/attachments/20140108/f9c3b60a/attachment-0001.sig>
#6 lore raw

PATCH v2 2/2 ehci-platform: Add support for clks and phy passed through devicetree

Hi,

Quoted 55 lines · Maxime Ripard
Quoted 39 lines · Hans de Goede

Currently ehci-platform is only used in combination with devicetree when used with some via socs. By extending it to (optionally) get clks and a phy from devicetree, and enabling / disabling those on power_on / off, it can be used more generically. Specifically after this commit it can be used for the ehci controller on Allwinner sunxi SoCs.

Somehow we've ended up with 2 device-bindings documents for ehci-platform.c, this patch renames and updates one to platform-ehci.txt to reflect that this is a generic platform driver, and removes the other.

---
  .../devicetree/bindings/usb/platform-ehci.txt      |  25 ++++
  .../devicetree/bindings/usb/via,vt8500-ehci.txt    |  15 ---
  .../devicetree/bindings/usb/vt8500-ehci.txt        |  12 --
  drivers/usb/host/ehci-platform.c                   | 126 +++++++++++++++++----
  4 files changed, 131 insertions(+), 47 deletions(-)

create mode 100644 Documentation/devicetree/bindings/usb/platform-ehci.txt delete mode 100644 Documentation/devicetree/bindings/usb/via,vt8500-ehci.txt delete mode 100644 Documentation/devicetree/bindings/usb/vt8500-ehci.txt

Documentation/devicetree/bindings/usb/platform-ehci.txt new file +12 -0
new file mode 100644
index 0000000..56c478d
@@ -0,0 +1,25 @@
+Generic Platform EHCI controller
+
+Required properties:
+- compatible : "via,vt8500-ehci" or "wm,prizm-ehci"
+- reg : ehci controller register range (address and length)
+- interrupts : ehci controller interrupt
+
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy

Documentation/devicetree/bindings/usb/platform-ehci.txt line 22

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +10 -0
+- phy-names : "phy0"
+
+Example:
+
+	ehci at d8007900 {
+		compatible = "via,vt8500-ehci";
+		reg = <0xd8007900 0x200>;
+		interrupts = <43>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";

I'm really not convinced by this either. It prevents you from doing anything useful out of these clocks, and the only thing you can actually do with it is calling clk_get, and that's pretty much it.

Quoted 1 line

What if you some platform needs to adjust the rate of one of the two?

Then it needs its own driver. This is intended as a binding for a *generic* driver, which is meant to cover simple straight forward non-pci ohci cases. For more complex cases a separate driver will need to be written.

I must say I'm becoming a bit unhappy with how the reviews of devicetree bindings are being done. In one case it is not generic enough (ahci-sunxi).

If I then try to make it more generic in a case where that can actually be done as the hardware is pretty straight forward, it is not specific enough. You can simply not have both!

Quoted 1 line

Or wants to cut one but not the other for any reason?

This is another example of non generic behavior, requiring a separate (small using the existing ohci core) platform glue driver, like the *19* we already have.

Regards,

Hans

maintainer
#7 lore raw

PATCH v2 2/2 ehci-platform: Add support for clks and phy passed through devicetree

Quoted 34 lines · Hans de Goede
Quoted 20 lines
Quoted 5 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +5 -0
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy

Documentation/devicetree/bindings/usb/platform-ehci.txt line 22

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +10 -0
+- phy-names : "phy0"
+
+Example:
+
+	ehci at d8007900 {
+		compatible = "via,vt8500-ehci";
+		reg = <0xd8007900 0x200>;
+		interrupts = <43>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";

I'm really not convinced by this either. It prevents you from doing anything useful out of these clocks, and the only thing you can actually do with it is calling clk_get, and that's pretty much it.

Quoted 1 line

What if you some platform needs to adjust the rate of one of the two?

Then it needs its own driver. This is intended as a binding for a *generic* driver, which is meant to cover simple straight forward non-pci ohci cases. For more complex cases a separate driver will need to be written.

I must say I'm becoming a bit unhappy with how the reviews of devicetree bindings are being done. In one case it is not generic enough (ahci-sunxi).

If I then try to make it more generic in a case where that can actually be done as the hardware is pretty straight forward, it is not specific enough. You can simply not have both!

Quoted 5 lines
Quoted 1 line

Or wants to cut one but not the other for any reason?

This is another example of non generic behavior, requiring a separate (small using the existing ohci core) platform glue driver, like the *19* we already have.

Would DT allow ehci-platform.c to access the clocks by their index in the array, rather than by name? After all, you don't really care about the names at all, since the driver knows nothing about the clocks' functions.

The same is true of the phy entry.

Alan Stern

#8 lore raw

[linux-sunxi] Re: [PATCH v2 2/2] ehci-platform: Add support for clks and phy passed through devicetree

Hi,

Quoted 38 lines · Alan Stern
Quoted 36 lines · Hans de Goede
Quoted 20 lines
Quoted 5 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +5 -0
+Optional properties:
+- clocks : a list of phandle + clock specifier pairs, one for each entry
+   in clock-names.
+- clock-names : "clk0", "clk1", ...
+- phys : phy

Documentation/devicetree/bindings/usb/platform-ehci.txt line 22

Quoted 10 lines
Documentation/devicetree/bindings/usb/platform-ehci.txt new file +10 -0
+- phy-names : "phy0"
+
+Example:
+
+	ehci at d8007900 {
+		compatible = "via,vt8500-ehci";
+		reg = <0xd8007900 0x200>;
+		interrupts = <43>;
+		clocks = <&usb_clk 6>, <&ahb_gates 2>;
+		clock-names = "clk0", "clk1";

I'm really not convinced by this either. It prevents you from doing anything useful out of these clocks, and the only thing you can actually do with it is calling clk_get, and that's pretty much it.

Quoted 1 line

What if you some platform needs to adjust the rate of one of the two?

Then it needs its own driver. This is intended as a binding for a *generic* driver, which is meant to cover simple straight forward non-pci ohci cases. For more complex cases a separate driver will need to be written.

I must say I'm becoming a bit unhappy with how the reviews of devicetree bindings are being done. In one case it is not generic enough (ahci-sunxi).

If I then try to make it more generic in a case where that can actually be done as the hardware is pretty straight forward, it is not specific enough. You can simply not have both!

Quoted 1 line

Or wants to cut one but not the other for any reason?

Quoted 8 lines
Quoted 3 lines

This is another example of non generic behavior, requiring a separate (small using the existing ohci core) platform glue driver, like the *19* we already have.

Would DT allow ehci-platform.c to access the clocks by their index in the array, rather than by name? After all, you don't really care about the names at all, since the driver knows nothing about the clocks' functions.

Yes, actually I've been discussing this with Maxime on irc and I'm just done preparing a v3 doing exactly that. I was just checking mail for any more review comments before pushing out v3 :)

Quoted 1 line

The same is true of the phy entry.

The phy entry must have a name, this is specified in the phy bindings in Documentation/devicetree/bindings/phy/phy-bindings.txt:

"""
PHY user node
=============

Required Properties:
phys : the phandle for the PHY device (used by the PHY subsystem) phy-names : the names of the PHY corresponding to the PHYs present in the
*phys* phandle
"""

Now that I've dropped the clock-names, I've changed the ugly "phy0" name to "usb" as the phy pointed to is supposed to be an usb phy.

Regards,

Hans