Thread (10 messages) 10 messages, 3 authors, 2010-09-28

Re: [PATCH v2 2/3] USB: add of_platform glue driver for FSL USB DR controller

From: Grant Likely <hidden>
Date: 2010-09-28 10:01:50

Hi Anatolij

Looks pretty good.  Comments below.  Main comment is that with the
recent changes in mainline, this no longer needs to be an
of_platform_driver.  It can be a plain old platform_driver instead.
It gets registered as a platform_driver anyway, but of_platform_driver
is a shim that adds a bit of overhead, so it is best to avoid it.
I'll detail the changes you need to make in my comments below.

On Tue, Sep 28, 2010 at 6:36 PM, Anatolij Gustschin [off-list ref] wrote:
The driver creates platform devices based on the information
from USB nodes in the flat device tree. This is the replacement
for old arch fsl_soc usb code removed by the previous patch.
It uses usual of-style binding, available EHCI-HCD and UDC
drivers can be bound to the created devices. The new of-style
driver additionaly instantiates USB OTG platform device, as the
appropriate USB OTG driver will be added soon.

Signed-off-by: Anatolij Gustschin <agust@denx.de>
Cc: Kumar Gala <redacted>
Cc: Grant Likely <redacted>
---
v2:
=A0- drop unneeded PPC_OF dependency
=A0- fix spelling bug in mode table and fix coding style
=A0- print a warning if no valid dr_mode found
=A0- add remove hook to unregister platform devices
=A0 created by probe. So the driver can be unbound
=A0- fix OTG platform device creation order
=A0- drop fs_initcall, replaced by module_init() now
=A0- add module_exit(), MODULE_DESCRIPTION, MODULE_LICENSE

=A0drivers/usb/gadget/Kconfig =A0 =A0 =A0 | =A0 =A01 +
=A0drivers/usb/host/Kconfig =A0 =A0 =A0 =A0 | =A0 =A04 +
=A0drivers/usb/host/Makefile =A0 =A0 =A0 =A0| =A0 =A01 +
=A0drivers/usb/host/fsl-mph-dr-of.c | =A0213 ++++++++++++++++++++++++++++=
++++++++++
quoted hunk ↗ jump to hunk
=A04 files changed, 219 insertions(+), 0 deletions(-)
=A0create mode 100644 drivers/usb/host/fsl-mph-dr-of.c
diff --git a/drivers/usb/gadget/Kconfig b/drivers/usb/gadget/Kconfig
index fab765d..0fe5bc8 100644
--- a/drivers/usb/gadget/Kconfig
+++ b/drivers/usb/gadget/Kconfig
@@ -158,6 +158,7 @@ config USB_GADGET_FSL_USB2
=A0 =A0 =A0 =A0boolean "Freescale Highspeed USB DR Peripheral Controller"
=A0 =A0 =A0 =A0depends on FSL_SOC || ARCH_MXC
=A0 =A0 =A0 =A0select USB_GADGET_DUALSPEED
+ =A0 =A0 =A0 select USB_FSL_MPH_DR_OF
=A0 =A0 =A0 =A0help
=A0 =A0 =A0 =A0 =A0 Some of Freescale PowerPC processors have a High Spee=
d
=A0 =A0 =A0 =A0 =A0 Dual-Role(DR) USB controller, which supports device m=
ode.
quoted hunk ↗ jump to hunk
diff --git a/drivers/usb/host/Kconfig b/drivers/usb/host/Kconfig
index 2d926ce..f3a90b0 100644
--- a/drivers/usb/host/Kconfig
+++ b/drivers/usb/host/Kconfig
@@ -112,10 +112,14 @@ config XPS_USB_HCD_XILINX
=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0support both high speed and full speed dev=
ices, or high speed
=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0devices only.

+config USB_FSL_MPH_DR_OF
+ =A0 =A0 =A0 tristate
+
=A0config USB_EHCI_FSL
=A0 =A0 =A0 =A0bool "Support for Freescale on-chip EHCI USB controller"
=A0 =A0 =A0 =A0depends on USB_EHCI_HCD && FSL_SOC
=A0 =A0 =A0 =A0select USB_EHCI_ROOT_HUB_TT
+ =A0 =A0 =A0 select USB_FSL_MPH_DR_OF
=A0 =A0 =A0 =A0---help---
=A0 =A0 =A0 =A0 =A0Variation of ARC USB block used in some Freescale chip=
s.
quoted hunk ↗ jump to hunk
diff --git a/drivers/usb/host/Makefile b/drivers/usb/host/Makefile
index b6315aa..aacbe82 100644
--- a/drivers/usb/host/Makefile
+++ b/drivers/usb/host/Makefile
@@ -33,4 +33,5 @@ obj-$(CONFIG_USB_R8A66597_HCD) =A0 =A0 =A0 =A0+=3D r8a6=
6597-hcd.o
quoted hunk ↗ jump to hunk
=A0obj-$(CONFIG_USB_ISP1760_HCD) =A0+=3D isp1760.o
=A0obj-$(CONFIG_USB_HWA_HCD) =A0 =A0 =A0+=3D hwa-hc.o
=A0obj-$(CONFIG_USB_IMX21_HCD) =A0 =A0+=3D imx21-hcd.o
+obj-$(CONFIG_USB_FSL_MPH_DR_OF) =A0 =A0 =A0 =A0+=3D fsl-mph-dr-of.o
diff --git a/drivers/usb/host/fsl-mph-dr-of.c b/drivers/usb/host/fsl-mph-=
dr-of.c
quoted hunk ↗ jump to hunk
new file mode 100644
index 0000000..ee8cb94
--- /dev/null
+++ b/drivers/usb/host/fsl-mph-dr-of.c
@@ -0,0 +1,213 @@
+/*
+ * Setup platform devices needed by the Freescale multi-port host
+ * and/or dual-role USB controller modules based on the description
+ * in flat device tree.
+ *
+ * This program is free software; you can redistribute =A0it and/or modi=
fy it
+ * under =A0the terms of =A0the GNU General =A0Public License as publish=
ed by the
+ * Free Software Foundation; =A0either version 2 of the =A0License, or (=
at your
+ * option) any later version.
+ */
+
+#include <linux/kernel.h>
+#include <linux/platform_device.h>
+#include <linux/fsl_devices.h>
+#include <linux/err.h>
+#include <linux/io.h>
+#include <linux/of_platform.h>
+
+struct fsl_usb2_dev_data {
+ =A0 =A0 =A0 char *dr_mode; =A0 =A0 =A0 =A0 =A0/* controller mode */
+ =A0 =A0 =A0 char *drivers[3]; =A0 =A0 =A0 /* drivers to instantiate for=
 this mode */
+ =A0 =A0 =A0 enum fsl_usb2_operating_modes op_mode; =A0/* operating mode=
 */
+};
+
+struct fsl_usb2_dev_data dr_mode_data[] __devinitdata =3D {
+ =A0 =A0 =A0 {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .dr_mode =3D "host",
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .drivers =3D { "fsl-ehci", NULL, NULL, },
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .op_mode =3D FSL_USB2_DR_HOST,
+ =A0 =A0 =A0 },
+ =A0 =A0 =A0 {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .dr_mode =3D "otg",
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .drivers =3D { "fsl-usb2-otg", "fsl-ehci", =
"fsl-usb2-udc", },
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .op_mode =3D FSL_USB2_DR_OTG,
+ =A0 =A0 =A0 },
+ =A0 =A0 =A0 {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .dr_mode =3D "peripheral",
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .drivers =3D { "fsl-usb2-udc", NULL, NULL, =
},
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .op_mode =3D FSL_USB2_DR_DEVICE,
+ =A0 =A0 =A0 },
+};
+
+struct fsl_usb2_dev_data * __devinit get_dr_mode_data(struct device_node=
 *np)
+{
+ =A0 =A0 =A0 const unsigned char *prop;
+ =A0 =A0 =A0 int i;
+
+ =A0 =A0 =A0 prop =3D of_get_property(np, "dr_mode", NULL);
+ =A0 =A0 =A0 if (prop) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 for (i =3D 0; i < ARRAY_SIZE(dr_mode_data);=
 i++) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (!strcmp(prop, dr_mode_d=
ata[i].dr_mode))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 return &dr_=
mode_data[i];
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 }
+ =A0 =A0 =A0 }
+ =A0 =A0 =A0 pr_warn("%s: Invalid 'dr_mode' property, fallback to host m=
ode\n",
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 np->full_name);
+ =A0 =A0 =A0 return &dr_mode_data[0]; /* mode not specified, use host */
+}
+
+static enum fsl_usb2_phy_modes __devinit determine_usb_phy(const char *p=
hy_type)
+{
+ =A0 =A0 =A0 if (!phy_type)
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return FSL_USB2_PHY_NONE;
+ =A0 =A0 =A0 if (!strcasecmp(phy_type, "ulpi"))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return FSL_USB2_PHY_ULPI;
+ =A0 =A0 =A0 if (!strcasecmp(phy_type, "utmi"))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return FSL_USB2_PHY_UTMI;
+ =A0 =A0 =A0 if (!strcasecmp(phy_type, "utmi_wide"))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return FSL_USB2_PHY_UTMI_WIDE;
+ =A0 =A0 =A0 if (!strcasecmp(phy_type, "serial"))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return FSL_USB2_PHY_SERIAL;
+
+ =A0 =A0 =A0 return FSL_USB2_PHY_NONE;
+}
+
+struct platform_device * __devinit fsl_usb2_device_register(
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=
 =A0 struct platform_device *ofdev,
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=
 =A0 struct fsl_usb2_platform_data *pdata,
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=
 =A0 const char *name, int id)
+{
+ =A0 =A0 =A0 struct platform_device *pdev;
+ =A0 =A0 =A0 const struct resource *res =3D ofdev->resource;
+ =A0 =A0 =A0 unsigned int num =3D ofdev->num_resources;
+ =A0 =A0 =A0 int retval;
+
+ =A0 =A0 =A0 pdev =3D platform_device_alloc(name, id);
+ =A0 =A0 =A0 if (!pdev) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 retval =3D -ENOMEM;
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 goto error;
+ =A0 =A0 =A0 }
+
+ =A0 =A0 =A0 pdev->dev.parent =3D &ofdev->dev;
+
+ =A0 =A0 =A0 pdev->dev.coherent_dma_mask =3D ofdev->dev.coherent_dma_mas=
k;
+ =A0 =A0 =A0 pdev->dev.dma_mask =3D &pdev->archdata.dma_mask;
+ =A0 =A0 =A0 *pdev->dev.dma_mask =3D *ofdev->dev.dma_mask;
+
+ =A0 =A0 =A0 retval =3D platform_device_add_data(pdev, pdata, sizeof(*pd=
ata));
+ =A0 =A0 =A0 if (retval)
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 goto error;
+
+ =A0 =A0 =A0 if (num) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 retval =3D platform_device_add_resources(pd=
ev, res, num);
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (retval)
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 goto error;
+ =A0 =A0 =A0 }
+
+ =A0 =A0 =A0 retval =3D platform_device_add(pdev);
+ =A0 =A0 =A0 if (retval)
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 goto error;
+
+ =A0 =A0 =A0 return pdev;
+
+error:
+ =A0 =A0 =A0 platform_device_put(pdev);
+ =A0 =A0 =A0 return ERR_PTR(retval);
+}
+
+static int __devinit fsl_usb2_mph_dr_of_probe(struct platform_device *of=
dev,
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=
 =A0 =A0 =A0const struct of_device_id *match)

Change to:
static int __devinit fsl_usb2_mph_dr_of_probe(struct platform_device *ofdev=
)

You can get the 'match' pointer by calling of_match_device().
+{
+ =A0 =A0 =A0 struct device_node *np =3D ofdev->dev.of_node;
+ =A0 =A0 =A0 struct platform_device *usb_dev;
+ =A0 =A0 =A0 struct fsl_usb2_platform_data data, *pdata;
+ =A0 =A0 =A0 struct fsl_usb2_dev_data *dev_data;
+ =A0 =A0 =A0 const unsigned char *prop;
+ =A0 =A0 =A0 static unsigned int idx;
+ =A0 =A0 =A0 int i;
+
+ =A0 =A0 =A0 if (!of_device_is_available(np))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 return -ENODEV;
+
+ =A0 =A0 =A0 pdata =3D match->data;
+ =A0 =A0 =A0 if (!pdata) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 memset(&data, 0, sizeof(data));
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 pdata =3D &data;
+ =A0 =A0 =A0 }
This is bad behaviour.  *match->data must not be modified in probe
because multiple instances of the device can exist.  The target of
pdata is modified later in the probe routine.

However, the above 4 lines can be removed entirely since none of the
fsl_usb2_mph_dr_of_match entries actually set the data pointer.  The
local 'data' structure can be used directly.
+
+ =A0 =A0 =A0 dev_data =3D get_dr_mode_data(np);
+
+ =A0 =A0 =A0 if (of_device_is_compatible(np, "fsl-usb2-mph")) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (of_get_property(np, "port0", NULL))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 pdata->port_enables |=3D FS=
L_USB2_PORT0_ENABLED;
+
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (of_get_property(np, "port1", NULL))
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 pdata->port_enables |=3D FS=
L_USB2_PORT1_ENABLED;
+
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 pdata->operating_mode =3D FSL_USB2_MPH_HOST=
;
+ =A0 =A0 =A0 } else {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 /* setup mode selected in the device tree *=
/
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 pdata->operating_mode =3D dev_data->op_mode=
;
+ =A0 =A0 =A0 }
+
+ =A0 =A0 =A0 prop =3D of_get_property(np, "phy_type", NULL);
+ =A0 =A0 =A0 pdata->phy_mode =3D determine_usb_phy(prop);
+
+ =A0 =A0 =A0 for (i =3D 0; i < ARRAY_SIZE(dev_data->drivers); i++) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (!dev_data->drivers[i])
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 continue;
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 usb_dev =3D fsl_usb2_device_register(ofdev,=
 pdata,
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=
 =A0 dev_data->drivers[i], idx);
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 if (IS_ERR(usb_dev)) {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 dev_err(&ofdev->dev, "Can't=
 register usb device\n");
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 return PTR_ERR(usb_dev);
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 }
+ =A0 =A0 =A0 }
+ =A0 =A0 =A0 idx++;
+ =A0 =A0 =A0 return 0;
+}
+
+static int __devexit __unregister_subdev(struct device *dev, void *d)
+{
+ =A0 =A0 =A0 platform_device_unregister(to_platform_device(dev));
+ =A0 =A0 =A0 return 0;
+}
+
+static int __devexit fsl_usb2_mph_dr_of_remove(struct platform_device *o=
fdev)
+{
+ =A0 =A0 =A0 device_for_each_child(&ofdev->dev, NULL, __unregister_subde=
v);
+ =A0 =A0 =A0 return 0;
+}
+
+static const struct of_device_id fsl_usb2_mph_dr_of_match[] =3D {
+ =A0 =A0 =A0 { .compatible =3D "fsl-usb2-mph", },
+ =A0 =A0 =A0 { .compatible =3D "fsl-usb2-dr", },
+ =A0 =A0 =A0 {},
+};
+
+static struct of_platform_driver fsl_usb2_mph_dr_driver =3D {
+ =A0 =A0 =A0 .driver =3D {
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .name =3D "fsl-usb2-mph-dr",
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .owner =3D THIS_MODULE,
+ =A0 =A0 =A0 =A0 =A0 =A0 =A0 .of_match_table =3D fsl_usb2_mph_dr_of_matc=
h,
+ =A0 =A0 =A0 },
+ =A0 =A0 =A0 .probe =A0=3D fsl_usb2_mph_dr_of_probe,
+ =A0 =A0 =A0 .remove =3D __devexit_p(fsl_usb2_mph_dr_of_remove),
+};
Change of_platform_driver to platform_driver
+
+static int __init fsl_usb2_mph_dr_init(void)
+{
+ =A0 =A0 =A0 return of_register_platform_driver(&fsl_usb2_mph_dr_driver)=
;

change to platform_driver_register()
+}
+module_init(fsl_usb2_mph_dr_init);
+
+static void __exit fsl_usb2_mph_dr_exit(void)
+{
+ =A0 =A0 =A0 of_unregister_platform_driver(&fsl_usb2_mph_dr_driver);
change to platform_driver_unregister()
+}
+module_exit(fsl_usb2_mph_dr_exit);
+
+MODULE_DESCRIPTION("FSL MPH DR OF devices driver");
+MODULE_AUTHOR("Anatolij Gustschin [off-list ref]");
+MODULE_LICENSE("GPL");
--
1.7.0.4


--=20
Grant Likely, B.Sc., P.Eng.
Secret Lab Technologies Ltd.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help