Skip to contentSkip to conversation

PHY: sunxi: Add driver for sunxi usb phy

PATCH Superseded Hans de Goede 2 participants 8 messages Mar 1, 2014 – Mar 5, 2014

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

v4 cover PHY: sunxi: Add driver for sunxi usb phy

Hi Kishon,

Here is v4 of my sunxi-usb-phy driver:

Changes in v2:
-Use macros rather then direct hex values for register addresses and bits
where possible

Changes in v3:
-Fix check for wrong variable in error handling path pointed out by wens -Switch to using reg-names to differentiate between the different register
ranges needed

Changes in v4:
-Add one more macro for the PHY_CTRL register data bit -Add some extra dependencies to the Kconfig entry -Really fix the reset controller error handling path -Add Maxime Ripard's Acked-by

Kishon, can you please queue up this patch for 3.15 ?

Regards,

Hans

p.s.

No dt patches this time as I'm going to send them as part of a larger sunxi dt series later today.

#1 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed through a single set of registers. Besides this there are also some other phy related bits which need poking, which are per phy, but shared between the ohci and ehci controllers, so these are also controlled from this new phy driver.

---
 .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
 drivers/phy/Kconfig                                |  11 +
 drivers/phy/Makefile                               |   1 +
 drivers/phy/phy-sun4i-usb.c                        | 331 +++++++++++++++++++++
 4 files changed, 369 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt
 create mode 100644 drivers/phy/phy-sun4i-usb.c
Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt new file +26 -0
new file mode 100644
index 0000000..a82361b
@@ -0,0 +1,26 @@
+Allwinner sun4i USB PHY
+-----------------------
+
+Required properties:
+- compatible : should be one of "allwinner,sun4i-a10-usb-phy",
+  "allwinner,sun5i-a13-usb-phy" or "allwinner,sun7i-a20-usb-phy"
+- reg : a list of offset + length pairs
+- reg-names : "phy_ctrl", "pmu1" and for sun4i or sun7i "pmu2"
+- #phy-cells : from the generic phy bindings, must be 1
+- clocks : phandle + clock specifier for the phy clock
+- clock-names : "usb_phy"
+- resets : a list of phandle + reset specifier pairs
+- reset-names : "usb0_reset", "usb1_reset" and for sun4i or sun7i "usb2_reset"
+
+Example:
+	usbphy: phy at 0x01c13400 {
+		#phy-cells = <1>;
+		compatible = "allwinner,sun4i-a10-usb-phy";
+		/* phy base regs, phy1 pmu reg, phy2 pmu reg */
+		reg = <0x01c13400 0x10 0x01c14800 0x4 0x01c1c800 0x4>;
+		reg-names = "phy_ctrl", "pmu1", "pmu2";
+		clocks = <&usb_clk 8>;
+		clock-names = "usb_phy";
+		resets = <&usb_clk 1>, <&usb_clk 2>;
+		reset-names = "usb1_reset", "usb2_reset";
+	};
drivers/phy/Kconfig +11 -0
index c7a551c..66f7c4e 100644
@@ -65,4 +65,15 @@ config BCM_KONA_USB2_PHY
 	help
 	  Enable this to support the Broadcom Kona USB 2.0 PHY.
 
+config PHY_SUN4I_USB
+	tristate "Allwinner sunxi SoC USB PHY driver"
+	depends on ARCH_SUNXI && HAS_IOMEM && OF
+	select GENERIC_PHY
+	help
+	  Enable this to support the transceiver that is part of Allwinner
+	  sunxi SoCs.
+
+	  This driver controls the entire USB PHY block, both the USB OTG
+	  parts, as well as the 2 regular USB 2 host PHYs.
+
 endmenu
drivers/phy/Makefile +1 -0
index b57c253..9d4f8bb 100644
@@ -9,3 +9,4 @@ obj-$(CONFIG_PHY_EXYNOS_MIPI_VIDEO)	+= phy-exynos-mipi-video.o
 obj-$(CONFIG_PHY_MVEBU_SATA)		+= phy-mvebu-sata.o
 obj-$(CONFIG_OMAP_USB2)			+= phy-omap-usb2.o
 obj-$(CONFIG_TWL4030_USB)		+= phy-twl4030-usb.o
+obj-$(CONFIG_PHY_SUN4I_USB)		+= phy-sun4i-usb.o
drivers/phy/phy-sun4i-usb.c new file +331 -0

331 lines not on this page · raw message

Signature · 1 line
1.9.0
#2 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Hi,

Quoted 8 lines · Hans de Goede

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed through a single set of registers. Besides this there are also some other phy related bits which need poking, which are per phy, but shared between the ohci and ehci controllers, so these are also controlled from this new phy driver.

Quoted 9 lines
---
  .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
  drivers/phy/Kconfig                                |  11 +
  drivers/phy/Makefile                               |   1 +
  drivers/phy/phy-sun4i-usb.c                        | 331 +++++++++++++++++++++
  4 files changed, 369 insertions(+)

create mode 100644 Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt create mode 100644 drivers/phy/phy-sun4i-usb.c

..
<snip>
.
.

drivers/phy/phy-sun4i-usb.c line 150

Quoted 8 lines
drivers/phy/phy-sun4i-usb.c new file +8 -0
+static int sun4i_usb_phy_init(struct phy *_phy)
+{
+	struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+	struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+	int ret;
+
+	ret = clk_prepare_enable(data->clk);
+	if (ret)

dev_err here?

drivers/phy/phy-sun4i-usb.c line 154

Quoted 4 lines
drivers/phy/phy-sun4i-usb.c new file +4 -0
+		return ret;
+
+	ret = reset_control_deassert(phy->reset);
+	if (ret) {

here too..

Quoted 24 lines
drivers/phy/phy-sun4i-usb.c new file +24 -0
+		clk_disable_unprepare(data->clk);
+		return ret;
+	}
+
+	/* Adjust PHY's magnitude and rate */
+	sun4i_usb_phy_write(phy, PHY_TX_AMPLITUDE_TUNE, 0x14, 5);
+
+	/* Disconnect threshold adjustment */
+	sun4i_usb_phy_write(phy, PHY_DISCON_TH_SEL, data->disc_thresh, 2);
+
+	sun4i_usb_phy_passby(phy, 1);
+
+	return 0;
+}
+
+static int sun4i_usb_phy_exit(struct phy *_phy)
+{
+	struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+	struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+
+	sun4i_usb_phy_passby(phy, 0);
+	reset_control_assert(phy->reset);
+	clk_disable_unprepare(data->clk);
+

drivers/phy/phy-sun4i-usb.c line 188

Quoted 10 lines
drivers/phy/phy-sun4i-usb.c new file +10 -0
+	return 0;
+}
+
+static int sun4i_usb_phy_power_on(struct phy *_phy)
+{
+	struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+	int ret = 0;
+
+	if (phy->vbus)
+		ret = regulator_enable(phy->vbus);

dev_err here too..

Quoted 52 lines
drivers/phy/phy-sun4i-usb.c new file +52 -0
+
+	return ret;
+}
+
+static int sun4i_usb_phy_power_off(struct phy *_phy)
+{
+	struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+
+	if (phy->vbus)
+		regulator_disable(phy->vbus);
+
+	return 0;
+}
+
+static struct phy_ops sun4i_usb_phy_ops = {
+	.init		= sun4i_usb_phy_init,
+	.exit		= sun4i_usb_phy_exit,
+	.power_on	= sun4i_usb_phy_power_on,
+	.power_off	= sun4i_usb_phy_power_off,
+	.owner		= THIS_MODULE,
+};
+
+static struct phy *sun4i_usb_phy_xlate(struct device *dev,
+					struct of_phandle_args *args)
+{
+	struct sun4i_usb_phy_data *data = dev_get_drvdata(dev);
+
+	if (WARN_ON(args->args[0] == 0 || args->args[0] >= data->num_phys))
+		return ERR_PTR(-ENODEV);
+
+	return data->phys[args->args[0]].phy;
+}
+
+static int sun4i_usb_phy_probe(struct platform_device *pdev)
+{
+	struct sun4i_usb_phy_data *data;
+	struct device *dev = &pdev->dev;
+	struct device_node *np = dev->of_node;
+	void __iomem *pmu = NULL;
+	struct phy_provider *phy_provider;
+	struct reset_control *reset;
+	struct regulator *vbus;
+	struct resource *res;
+	struct phy *phy;
+	char name[16];
+	int i;
+
+	data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+	if (!data)
+		return -ENOMEM;
+
+	mutex_init(&data->mutex);

drivers/phy/phy-sun4i-usb.c line 250

Quoted 10 lines
drivers/phy/phy-sun4i-usb.c new file +10 -0
+
+	if (of_device_is_compatible(np, "allwinner,sun5i-a13-usb-phy"))
+		data->num_phys = 2;
+	else
+		data->num_phys = 3;
+
+	if (of_device_is_compatible(np, "allwinner,sun4i-a10-usb-phy"))
+		data->disc_thresh = 3;
+	else
+		data->disc_thresh = 2;

These 'data' can actually be part of 'of_device_id' table and can be obtained by using 'of_match_device'.

Thanks
Kishon

#3 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Hi,

Quoted 25 lines · Kishon Vijay Abraham I

Hi,

Quoted 8 lines · Hans de Goede

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed through a single set of registers. Besides this there are also some other phy related bits which need poking, which are per phy, but shared between the ohci and ehci controllers, so these are also controlled from this new phy driver.

Quoted 9 lines
---
  .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
  drivers/phy/Kconfig                                |  11 +
  drivers/phy/Makefile                               |   1 +
  drivers/phy/phy-sun4i-usb.c                        | 331 +++++++++++++++++++++
  4 files changed, 369 insertions(+)

create mode 100644 Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt create mode 100644 drivers/phy/phy-sun4i-usb.c

..
<snip>
.
.

Quoted 9 lines

drivers/phy/phy-sun4i-usb.c line 150

Quoted 8 lines
drivers/phy/phy-sun4i-usb.c new file +8 -0
+static int sun4i_usb_phy_init(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+    int ret;
+
+    ret = clk_prepare_enable(data->clk);
+    if (ret)

dev_err here?

I would expect the clk subsys to print an error if anything goes wrong here, repeating that error in the device driver seems not useful to me.

Note that this practice of simply propagating the error is a common pattern in many many users of the clk / reset / regulator framework.

Also can I please get one final review of this patch rather then a round of comments ending with:

"If you can fix these minor comments while changing the $subject (PHY: sunxi) it should be good to get merged."

Only to get more review comments when I've already fixed the minor comments ?

Quoted 6 lines

drivers/phy/phy-sun4i-usb.c line 154

Quoted 4 lines
drivers/phy/phy-sun4i-usb.c new file +4 -0
+        return ret;
+
+    ret = reset_control_deassert(phy->reset);
+    if (ret) {

here too..

idem.

Quoted 27 lines
Quoted 27 lines
drivers/phy/phy-sun4i-usb.c new file +27 -0
+        clk_disable_unprepare(data->clk);
+        return ret;
+    }
+
+    /* Adjust PHY's magnitude and rate */
+    sun4i_usb_phy_write(phy, PHY_TX_AMPLITUDE_TUNE, 0x14, 5);
+
+    /* Disconnect threshold adjustment */
+    sun4i_usb_phy_write(phy, PHY_DISCON_TH_SEL, data->disc_thresh, 2);
+
+    sun4i_usb_phy_passby(phy, 1);
+
+    return 0;
+}
+
+static int sun4i_usb_phy_exit(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+
+    sun4i_usb_phy_passby(phy, 0);
+    reset_control_assert(phy->reset);
+    clk_disable_unprepare(data->clk);
+
+    return 0;
+}
+
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 188

Quoted 7 lines
drivers/phy/phy-sun4i-usb.c new file +7 -0
+static int sun4i_usb_phy_power_on(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    int ret = 0;
+
+    if (phy->vbus)
+        ret = regulator_enable(phy->vbus);

dev_err here too..

idem.

Quoted 56 lines
Quoted 56 lines
drivers/phy/phy-sun4i-usb.c new file +56 -0
+
+    return ret;
+}
+
+static int sun4i_usb_phy_power_off(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+
+    if (phy->vbus)
+        regulator_disable(phy->vbus);
+
+    return 0;
+}
+
+static struct phy_ops sun4i_usb_phy_ops = {
+    .init        = sun4i_usb_phy_init,
+    .exit        = sun4i_usb_phy_exit,
+    .power_on    = sun4i_usb_phy_power_on,
+    .power_off    = sun4i_usb_phy_power_off,
+    .owner        = THIS_MODULE,
+};
+
+static struct phy *sun4i_usb_phy_xlate(struct device *dev,
+                    struct of_phandle_args *args)
+{
+    struct sun4i_usb_phy_data *data = dev_get_drvdata(dev);
+
+    if (WARN_ON(args->args[0] == 0 || args->args[0] >= data->num_phys))
+        return ERR_PTR(-ENODEV);
+
+    return data->phys[args->args[0]].phy;
+}
+
+static int sun4i_usb_phy_probe(struct platform_device *pdev)
+{
+    struct sun4i_usb_phy_data *data;
+    struct device *dev = &pdev->dev;
+    struct device_node *np = dev->of_node;
+    void __iomem *pmu = NULL;
+    struct phy_provider *phy_provider;
+    struct reset_control *reset;
+    struct regulator *vbus;
+    struct resource *res;
+    struct phy *phy;
+    char name[16];
+    int i;
+
+    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+    if (!data)
+        return -ENOMEM;
+
+    mutex_init(&data->mutex);
+
+    if (of_device_is_compatible(np, "allwinner,sun5i-a13-usb-phy"))
+        data->num_phys = 2;
+    else
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 250

Quoted 6 lines
drivers/phy/phy-sun4i-usb.c new file +6 -0
+        data->num_phys = 3;
+
+    if (of_device_is_compatible(np, "allwinner,sun4i-a10-usb-phy"))
+        data->disc_thresh = 3;
+    else
+        data->disc_thresh = 2;

These 'data' can actually be part of 'of_device_id' table and can be obtained by using 'of_match_device'.

This was already suggested by Maxime around the time of v2, and I responded with this:

"The problem with using the of_device_id .data field is that I can only store a single integer there. To store 2 I need to: define a struct, create an array of these structs with initialization. Create an enum for indexing the array which must be kept in sync with the initializers manually, store either the index, or a direct pointer to the correct array entry into the .data field, add code to get the of_device_id from the compatible string, and then finally extract the settings from the struct again.

See IE how this is done in drivers/ata/ahci_platform.c, I've tried to come up with a simpler way and failed, for ahci_platform.c the struct with per compatible-string data is quite big so it makes some sense to use this construction. Here however not so much, this adds a whole lot of unnecessary extra code + indirection. I esp. object against the indirection as that unnecessarily makes it harder to follow whats going on."

Which is still valid.

Regards,

Hans

#4 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Hi,

Quoted 178 lines · Hans de Goede

Hi,

Quoted 25 lines · Kishon Vijay Abraham I

Hi,

Quoted 8 lines · Hans de Goede

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed through a single set of registers. Besides this there are also some other phy related bits which need poking, which are per phy, but shared between the ohci and ehci controllers, so these are also controlled from this new phy driver.

Quoted 9 lines
---
   .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
   drivers/phy/Kconfig                                |  11 +
   drivers/phy/Makefile                               |   1 +
   drivers/phy/phy-sun4i-usb.c                        | 331 +++++++++++++++++++++
   4 files changed, 369 insertions(+)

create mode 100644 Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt create mode 100644 drivers/phy/phy-sun4i-usb.c

..
<snip>
.
.

Quoted 9 lines

drivers/phy/phy-sun4i-usb.c line 150

Quoted 8 lines
drivers/phy/phy-sun4i-usb.c new file +8 -0
+static int sun4i_usb_phy_init(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+    int ret;
+
+    ret = clk_prepare_enable(data->clk);
+    if (ret)

dev_err here?

I would expect the clk subsys to print an error if anything goes wrong here, repeating that error in the device driver seems not useful to me.

Note that this practice of simply propagating the error is a common pattern in many many users of the clk / reset / regulator framework.

Also can I please get one final review of this patch rather then a round of comments ending with:

"If you can fix these minor comments while changing the $subject (PHY: sunxi) it should be good to get merged."

Only to get more review comments when I've already fixed the minor comments ?

Quoted 6 lines

drivers/phy/phy-sun4i-usb.c line 154

Quoted 4 lines
drivers/phy/phy-sun4i-usb.c new file +4 -0
+        return ret;
+
+    ret = reset_control_deassert(phy->reset);
+    if (ret) {

here too..

idem.

Quoted 27 lines
Quoted 27 lines
drivers/phy/phy-sun4i-usb.c new file +27 -0
+        clk_disable_unprepare(data->clk);
+        return ret;
+    }
+
+    /* Adjust PHY's magnitude and rate */
+    sun4i_usb_phy_write(phy, PHY_TX_AMPLITUDE_TUNE, 0x14, 5);
+
+    /* Disconnect threshold adjustment */
+    sun4i_usb_phy_write(phy, PHY_DISCON_TH_SEL, data->disc_thresh, 2);
+
+    sun4i_usb_phy_passby(phy, 1);
+
+    return 0;
+}
+
+static int sun4i_usb_phy_exit(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+
+    sun4i_usb_phy_passby(phy, 0);
+    reset_control_assert(phy->reset);
+    clk_disable_unprepare(data->clk);
+
+    return 0;
+}
+
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 188

Quoted 7 lines
drivers/phy/phy-sun4i-usb.c new file +7 -0
+static int sun4i_usb_phy_power_on(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    int ret = 0;
+
+    if (phy->vbus)
+        ret = regulator_enable(phy->vbus);

dev_err here too..

idem.

Quoted 56 lines
Quoted 56 lines
drivers/phy/phy-sun4i-usb.c new file +56 -0
+
+    return ret;
+}
+
+static int sun4i_usb_phy_power_off(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+
+    if (phy->vbus)
+        regulator_disable(phy->vbus);
+
+    return 0;
+}
+
+static struct phy_ops sun4i_usb_phy_ops = {
+    .init        = sun4i_usb_phy_init,
+    .exit        = sun4i_usb_phy_exit,
+    .power_on    = sun4i_usb_phy_power_on,
+    .power_off    = sun4i_usb_phy_power_off,
+    .owner        = THIS_MODULE,
+};
+
+static struct phy *sun4i_usb_phy_xlate(struct device *dev,
+                    struct of_phandle_args *args)
+{
+    struct sun4i_usb_phy_data *data = dev_get_drvdata(dev);
+
+    if (WARN_ON(args->args[0] == 0 || args->args[0] >= data->num_phys))
+        return ERR_PTR(-ENODEV);
+
+    return data->phys[args->args[0]].phy;
+}
+
+static int sun4i_usb_phy_probe(struct platform_device *pdev)
+{
+    struct sun4i_usb_phy_data *data;
+    struct device *dev = &pdev->dev;
+    struct device_node *np = dev->of_node;
+    void __iomem *pmu = NULL;
+    struct phy_provider *phy_provider;
+    struct reset_control *reset;
+    struct regulator *vbus;
+    struct resource *res;
+    struct phy *phy;
+    char name[16];
+    int i;
+
+    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+    if (!data)
+        return -ENOMEM;
+
+    mutex_init(&data->mutex);
+
+    if (of_device_is_compatible(np, "allwinner,sun5i-a13-usb-phy"))
+        data->num_phys = 2;
+    else
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 250

Quoted 6 lines
drivers/phy/phy-sun4i-usb.c new file +6 -0
+        data->num_phys = 3;
+
+    if (of_device_is_compatible(np, "allwinner,sun4i-a10-usb-phy"))
+        data->disc_thresh = 3;
+    else
+        data->disc_thresh = 2;

These 'data' can actually be part of 'of_device_id' table and can be obtained by using 'of_match_device'.

This was already suggested by Maxime around the time of v2, and I responded with this:

"The problem with using the of_device_id .data field is that I can only store a single integer there. To store 2 I need to: define a struct, create an array of these structs with initialization. Create an enum for indexing the array which must be kept in sync with the initializers manually, store either the index, or a direct pointer to the correct array entry into the .data field, add code to get the of_device_id from the compatible string, and then finally extract the settings from the struct again.

Quoted 7 lines

See IE how this is done in drivers/ata/ahci_platform.c, I've tried to come up with a simpler way and failed, for ahci_platform.c the struct with per compatible-string data is quite big so it makes some sense to use this construction. Here however not so much, this adds a whole lot of unnecessary extra code + indirection. I esp. object against the indirection as that unnecessarily makes it harder to follow whats going on."

alright.. missed that earlier. Sorry.

-Kishon

#5 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Hi,

Quoted 190 lines · Kishon Vijay Abraham I

Hi,

Quoted 178 lines · Hans de Goede

Hi,

Quoted 25 lines · Kishon Vijay Abraham I

Hi,

Quoted 8 lines · Hans de Goede

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed through a single set of registers. Besides this there are also some other phy related bits which need poking, which are per phy, but shared between the ohci and ehci controllers, so these are also controlled from this new phy driver.

Quoted 9 lines
---
   .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
   drivers/phy/Kconfig                                |  11 +
   drivers/phy/Makefile                               |   1 +
   drivers/phy/phy-sun4i-usb.c                        | 331 +++++++++++++++++++++
   4 files changed, 369 insertions(+)

create mode 100644 Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt create mode 100644 drivers/phy/phy-sun4i-usb.c

..
<snip>
.
.

Quoted 9 lines

drivers/phy/phy-sun4i-usb.c line 150

Quoted 8 lines
drivers/phy/phy-sun4i-usb.c new file +8 -0
+static int sun4i_usb_phy_init(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+    int ret;
+
+    ret = clk_prepare_enable(data->clk);
+    if (ret)

dev_err here?

I would expect the clk subsys to print an error if anything goes wrong here, repeating that error in the device driver seems not useful to me.

Note that this practice of simply propagating the error is a common pattern in many many users of the clk / reset / regulator framework.

Also can I please get one final review of this patch rather then a round of comments ending with:

"If you can fix these minor comments while changing the $subject (PHY: sunxi) it should be good to get merged."

Only to get more review comments when I've already fixed the minor comments ?

Quoted 6 lines

drivers/phy/phy-sun4i-usb.c line 154

Quoted 4 lines
drivers/phy/phy-sun4i-usb.c new file +4 -0
+        return ret;
+
+    ret = reset_control_deassert(phy->reset);
+    if (ret) {

here too..

idem.

Quoted 27 lines
Quoted 27 lines
drivers/phy/phy-sun4i-usb.c new file +27 -0
+        clk_disable_unprepare(data->clk);
+        return ret;
+    }
+
+    /* Adjust PHY's magnitude and rate */
+    sun4i_usb_phy_write(phy, PHY_TX_AMPLITUDE_TUNE, 0x14, 5);
+
+    /* Disconnect threshold adjustment */
+    sun4i_usb_phy_write(phy, PHY_DISCON_TH_SEL, data->disc_thresh, 2);
+
+    sun4i_usb_phy_passby(phy, 1);
+
+    return 0;
+}
+
+static int sun4i_usb_phy_exit(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+
+    sun4i_usb_phy_passby(phy, 0);
+    reset_control_assert(phy->reset);
+    clk_disable_unprepare(data->clk);
+
+    return 0;
+}
+
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 188

Quoted 7 lines
drivers/phy/phy-sun4i-usb.c new file +7 -0
+static int sun4i_usb_phy_power_on(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    int ret = 0;
+
+    if (phy->vbus)
+        ret = regulator_enable(phy->vbus);

dev_err here too..

idem.

Quoted 56 lines
Quoted 56 lines
drivers/phy/phy-sun4i-usb.c new file +56 -0
+
+    return ret;
+}
+
+static int sun4i_usb_phy_power_off(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+
+    if (phy->vbus)
+        regulator_disable(phy->vbus);
+
+    return 0;
+}
+
+static struct phy_ops sun4i_usb_phy_ops = {
+    .init        = sun4i_usb_phy_init,
+    .exit        = sun4i_usb_phy_exit,
+    .power_on    = sun4i_usb_phy_power_on,
+    .power_off    = sun4i_usb_phy_power_off,
+    .owner        = THIS_MODULE,
+};
+
+static struct phy *sun4i_usb_phy_xlate(struct device *dev,
+                    struct of_phandle_args *args)
+{
+    struct sun4i_usb_phy_data *data = dev_get_drvdata(dev);
+
+    if (WARN_ON(args->args[0] == 0 || args->args[0] >= data->num_phys))
+        return ERR_PTR(-ENODEV);
+
+    return data->phys[args->args[0]].phy;
+}
+
+static int sun4i_usb_phy_probe(struct platform_device *pdev)
+{
+    struct sun4i_usb_phy_data *data;
+    struct device *dev = &pdev->dev;
+    struct device_node *np = dev->of_node;
+    void __iomem *pmu = NULL;
+    struct phy_provider *phy_provider;
+    struct reset_control *reset;
+    struct regulator *vbus;
+    struct resource *res;
+    struct phy *phy;
+    char name[16];
+    int i;
+
+    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+    if (!data)
+        return -ENOMEM;
+
+    mutex_init(&data->mutex);
+
+    if (of_device_is_compatible(np, "allwinner,sun5i-a13-usb-phy"))
+        data->num_phys = 2;
+    else
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 250

Quoted 6 lines
drivers/phy/phy-sun4i-usb.c new file +6 -0
+        data->num_phys = 3;
+
+    if (of_device_is_compatible(np, "allwinner,sun4i-a10-usb-phy"))
+        data->disc_thresh = 3;
+    else
+        data->disc_thresh = 2;

These 'data' can actually be part of 'of_device_id' table and can be obtained by using 'of_match_device'.

This was already suggested by Maxime around the time of v2, and I responded with this:

"The problem with using the of_device_id .data field is that I can only store a single integer there. To store 2 I need to: define a struct, create an array of these structs with initialization. Create an enum for indexing the array which must be kept in sync with the initializers manually, store either the index, or a direct pointer to the correct array entry into the .data field, add code to get the of_device_id from the compatible string, and then finally extract the settings from the struct again.

Quoted 7 lines

See IE how this is done in drivers/ata/ahci_platform.c, I've tried to come up with a simpler way and failed, for ahci_platform.c the struct with per compatible-string data is quite big so it makes some sense to use this construction. Here however not so much, this adds a whole lot of unnecessary extra code + indirection. I esp. object against the indirection as that unnecessarily makes it harder to follow whats going on."

Quoted 1 line

alright.. missed that earlier. Sorry.

So does this mean you're going to take v4 as is, or do you want me to add the dev_err calls you've pointed out before (note I still prefer to not add these, but if you insist...) ?

Regards,

Hans

#6 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Quoted 204 lines · Hans de Goede

Hi,

Quoted 201 lines · Kishon Vijay Abraham I

Hi,

Quoted 196 lines · Hans de Goede

Hi,

Quoted 31 lines · Kishon Vijay Abraham I

Hi,

Quoted 19 lines · Hans de Goede

The Allwinner A1x / A2x SoCs have 2 or 3 usb phys which are all accessed
through a single set of registers. Besides this there are also some other
phy related bits which need poking, which are per phy, but shared between the
ohci and ehci controllers, so these are also controlled from this new phy
driver.

---
   .../devicetree/bindings/phy/sun4i-usb-phy.txt      |  26 ++
   drivers/phy/Kconfig                                |  11 +
   drivers/phy/Makefile                               |   1 +
   drivers/phy/phy-sun4i-usb.c                        | 331
+++++++++++++++++++++
   4 files changed, 369 insertions(+)
Quoted 4 lines

create mode 100644
Documentation/devicetree/bindings/phy/sun4i-usb-phy.txt
create mode 100644 drivers/phy/phy-sun4i-usb.c

..
<snip>
.
.

Quoted 9 lines

drivers/phy/phy-sun4i-usb.c line 150

Quoted 8 lines
drivers/phy/phy-sun4i-usb.c new file +8 -0
+static int sun4i_usb_phy_init(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+    int ret;
+
+    ret = clk_prepare_enable(data->clk);
+    if (ret)

dev_err here?

I would expect the clk subsys to print an error if anything goes wrong here, repeating that error in the device driver seems not useful to me.

Note that this practice of simply propagating the error is a common pattern in many many users of the clk / reset / regulator framework.

Also can I please get one final review of this patch rather then a round of comments ending with:

"If you can fix these minor comments while changing the $subject (PHY: sunxi) it
should be good to get merged."

Only to get more review comments when I've already fixed the minor comments ?

Quoted 6 lines

drivers/phy/phy-sun4i-usb.c line 154

Quoted 4 lines
drivers/phy/phy-sun4i-usb.c new file +4 -0
+        return ret;
+
+    ret = reset_control_deassert(phy->reset);
+    if (ret) {

here too..

idem.

Quoted 28 lines
Quoted 28 lines
drivers/phy/phy-sun4i-usb.c new file +9 -0
+        clk_disable_unprepare(data->clk);
+        return ret;
+    }
+
+    /* Adjust PHY's magnitude and rate */
+    sun4i_usb_phy_write(phy, PHY_TX_AMPLITUDE_TUNE, 0x14, 5);
+
+    /* Disconnect threshold adjustment */
+    sun4i_usb_phy_write(phy, PHY_DISCON_TH_SEL, data->disc_thresh,

2);

drivers/phy/phy-sun4i-usb.c new file +18 -0
+
+    sun4i_usb_phy_passby(phy, 1);
+
+    return 0;
+}
+
+static int sun4i_usb_phy_exit(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    struct sun4i_usb_phy_data *data = to_sun4i_usb_phy_data(phy);
+
+    sun4i_usb_phy_passby(phy, 0);
+    reset_control_assert(phy->reset);
+    clk_disable_unprepare(data->clk);
+
+    return 0;
+}
+
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 188

Quoted 7 lines
drivers/phy/phy-sun4i-usb.c new file +7 -0
+static int sun4i_usb_phy_power_on(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+    int ret = 0;
+
+    if (phy->vbus)
+        ret = regulator_enable(phy->vbus);

dev_err here too..

idem.

Quoted 58 lines
Quoted 58 lines
drivers/phy/phy-sun4i-usb.c new file +28 -0
+
+    return ret;
+}
+
+static int sun4i_usb_phy_power_off(struct phy *_phy)
+{
+    struct sun4i_usb_phy *phy = phy_get_drvdata(_phy);
+
+    if (phy->vbus)
+        regulator_disable(phy->vbus);
+
+    return 0;
+}
+
+static struct phy_ops sun4i_usb_phy_ops = {
+    .init        = sun4i_usb_phy_init,
+    .exit        = sun4i_usb_phy_exit,
+    .power_on    = sun4i_usb_phy_power_on,
+    .power_off    = sun4i_usb_phy_power_off,
+    .owner        = THIS_MODULE,
+};
+
+static struct phy *sun4i_usb_phy_xlate(struct device *dev,
+                    struct of_phandle_args *args)
+{
+    struct sun4i_usb_phy_data *data = dev_get_drvdata(dev);
+
+    if (WARN_ON(args->args[0] == 0 || args->args[0] >=

data->num_phys))

drivers/phy/phy-sun4i-usb.c new file +29 -0
+        return ERR_PTR(-ENODEV);
+
+    return data->phys[args->args[0]].phy;
+}
+
+static int sun4i_usb_phy_probe(struct platform_device *pdev)
+{
+    struct sun4i_usb_phy_data *data;
+    struct device *dev = &pdev->dev;
+    struct device_node *np = dev->of_node;
+    void __iomem *pmu = NULL;
+    struct phy_provider *phy_provider;
+    struct reset_control *reset;
+    struct regulator *vbus;
+    struct resource *res;
+    struct phy *phy;
+    char name[16];
+    int i;
+
+    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
+    if (!data)
+        return -ENOMEM;
+
+    mutex_init(&data->mutex);
+
+    if (of_device_is_compatible(np, "allwinner,sun5i-a13-usb-phy"))
+        data->num_phys = 2;
+    else
+        data->num_phys = 3;
Quoted 8 lines

drivers/phy/phy-sun4i-usb.c line 250

Quoted 5 lines
drivers/phy/phy-sun4i-usb.c new file +5 -0
+
+    if (of_device_is_compatible(np, "allwinner,sun4i-a10-usb-phy"))
+        data->disc_thresh = 3;
+    else
+        data->disc_thresh = 2;

These 'data' can actually be part of 'of_device_id' table and can be obtained by using 'of_match_device'.

This was already suggested by Maxime around the time of v2, and I responded with this:

"The problem with using the of_device_id .data field is that I can only store a single integer there. To store 2 I need to: define a struct, create an array of these structs with initialization. Create an enum for indexing the array which must be kept in sync with the initializers manually, store either the index, or a direct pointer to the correct array
entry into the .data field, add code to get the of_device_id from the compatible string, and then finally extract the settings from the struct again.

See IE how this is done in drivers/ata/ahci_platform.c, I've tried to come up with a simpler way and failed, for ahci_platform.c the struct with per compatible-string data is quite big so it makes some sense to use this construction. Here however not so much, this adds a whole lot of unnecessary extra code + indirection. I esp. object against the indirection as that unnecessarily makes it harder to follow whats going on."

Quoted 5 lines
Quoted 1 line

alright.. missed that earlier. Sorry.

So does this mean you're going to take v4 as is, or do you want me to add the dev_err calls you've pointed out before (note I still prefer to not add these, but if you insist...) ?

You should have received a notification on it being merged to 'next'. didn't you?

-Kishon

#7 lore raw

PATCH v4 1/1 PHY: sunxi: Add driver for sunxi usb phy

Hi,

Quoted 3 lines · Kishon Vijay Abraham I

On Tuesday 04 March 2014 10:33 PM, Hans de Goede wrote:

<snip>

Quoted 7 lines
Quoted 5 lines
Quoted 1 line

alright.. missed that earlier. Sorry.

So does this mean you're going to take v4 as is, or do you want me to add the dev_err calls you've pointed out before (note I still prefer to not add these, but if you insist...) ?

You should have received a notification on it being merged to 'next'. didn't you?

Not that I remember, I think I'm not receiving these kinds of notifications in general, except for when things hit one of gkh's trees.

Is this something done by your own scripts, or something which I should get for every patch of mine which hits next? If it is the latter I'm definitely not getting these, if it is just from you then I think I'm not getting them either but I'm not 100% sure.

Regards,

Hans