All of lore.kernel.org
 help / color / mirror / Atom feed
From: balbi@ti.com (Felipe Balbi)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCH 5/9] usb: add phy connection by phy-mode
Date: Fri, 16 Nov 2012 15:41:16 +0200	[thread overview]
Message-ID: <20121116134116.GA18527@arwen.pp.htv.fi> (raw)
In-Reply-To: <50A62713.5070407@pengutronix.de>

Hi,

On Fri, Nov 16, 2012 at 12:44:19PM +0100, Marc Kleine-Budde wrote:
> >> diff --git a/drivers/of/of_usbphy.c b/drivers/of/of_usbphy.c
> >> new file mode 100644
> >> index 0000000..2e71f7b
> >> --- /dev/null
> >> +++ b/drivers/of/of_usbphy.c
> >> @@ -0,0 +1,49 @@
> >> +/*
> >> + * OF helpers for network devices.
> >> + *
> >> + * This file is released under the GPLv2
> >> + *
> >> + * Initially copied out of drivers/of/of_net.c
> >> + */
> >> +#include <linux/etherdevice.h>
> >> +#include <linux/kernel.h>
> >> +#include <linux/of_usbphy.h>
> >> +#include <linux/usb/phy.h>
> >> +#include <linux/export.h>
> >> +
> >> +/**
> >> + * It maps 'enum usb_phy_interface' found in include/linux/usb/phy.h
> >> + * into the device tree binding of 'phy-mode', so that USB
> >> + * device driver can get phy interface from device tree.
> >> + */
> > 
> > provide proper kernel-doc
> > 
> >> +static const char *usbphy_modes[] = {
> >> +	[USBPHY_INTERFACE_MODE_NA]	= "",
> >> +	[USBPHY_INTERFACE_MODE_UTMI]	= "utmi",
> >> +	[USBPHY_INTERFACE_MODE_UTMIW]	= "utmiw",
> >> +	[USBPHY_INTERFACE_MODE_ULPI]	= "ulpi",
> >> +	[USBPHY_INTERFACE_MODE_SERIAL]	= "fsls",
> >> +};
> > 
> > In fact, these would be better off as constants:
> > 
> > #define USBPHY_INTERFACE_MODE_UTMI	1
> > #define USBPHY_INTERFACE_MODE_UTMIW	2
> > ...
> 
> Why are defines better than an enum? BTW: this code is a copy of the

because with enums can change value if you add another one in the middle
and it's really easy to miss that sort of thing during review and cause
regressions to many DTS files.

> ethernet phy of-helper code.

so ?

> >> +/**
> >> + * of_get_phy_mode - Get phy mode for given device_node
> >> + * @np:	Pointer to the given device_node
> >> + *
> >> + * The function gets phy interface string from property 'phy-mode',
> >> + * and return its index in phy_modes table, or errno in error case.
> >> + */
> > 
> > why do you pass a string instead of passing an Integer ? This makes no
> > sense to me.
> 
> This code returns an integer or rather an enum....see header file below.

I mean through DT, should've been more explicit. The dts files should
pass an integer, not a string. Then you don't need this silly conversion
helper.

-- 
balbi
-------------- 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/20121116/5eb3366f/attachment.sig>

WARNING: multiple messages have this Message-ID (diff)
From: Felipe Balbi <balbi-l0cyMroinI0@public.gmane.org>
To: Marc Kleine-Budde <mkl-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org>
Cc: balbi-l0cyMroinI0@public.gmane.org,
	Michael Grzeschik
	<m.grzeschik-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org>,
	linux-usb-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
	linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r@public.gmane.org,
	alexander.shishkin-VuQAYsv1563Yd54FQh9/CA@public.gmane.org,
	gregkh-hQyY1W1yCW8ekmWlsbkhG0B+6BGkLq7r@public.gmane.org,
	fabio.estevam-KZfg59tc24xl57MIdRCFDg@public.gmane.org,
	kernel-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org,
	devicetree-discuss-uLR06cmDAlY/bJ5BZ2RsiQ@public.gmane.org,
	Kishon Vijay Abraham I <kishon-l0cyMroinI0@public.gmane.org>
Subject: Re: [PATCH 5/9] usb: add phy connection by phy-mode
Date: Fri, 16 Nov 2012 15:41:16 +0200	[thread overview]
Message-ID: <20121116134116.GA18527@arwen.pp.htv.fi> (raw)
In-Reply-To: <50A62713.5070407-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org>

[-- Attachment #1: Type: text/plain, Size: 2306 bytes --]

Hi,

On Fri, Nov 16, 2012 at 12:44:19PM +0100, Marc Kleine-Budde wrote:
> >> diff --git a/drivers/of/of_usbphy.c b/drivers/of/of_usbphy.c
> >> new file mode 100644
> >> index 0000000..2e71f7b
> >> --- /dev/null
> >> +++ b/drivers/of/of_usbphy.c
> >> @@ -0,0 +1,49 @@
> >> +/*
> >> + * OF helpers for network devices.
> >> + *
> >> + * This file is released under the GPLv2
> >> + *
> >> + * Initially copied out of drivers/of/of_net.c
> >> + */
> >> +#include <linux/etherdevice.h>
> >> +#include <linux/kernel.h>
> >> +#include <linux/of_usbphy.h>
> >> +#include <linux/usb/phy.h>
> >> +#include <linux/export.h>
> >> +
> >> +/**
> >> + * It maps 'enum usb_phy_interface' found in include/linux/usb/phy.h
> >> + * into the device tree binding of 'phy-mode', so that USB
> >> + * device driver can get phy interface from device tree.
> >> + */
> > 
> > provide proper kernel-doc
> > 
> >> +static const char *usbphy_modes[] = {
> >> +	[USBPHY_INTERFACE_MODE_NA]	= "",
> >> +	[USBPHY_INTERFACE_MODE_UTMI]	= "utmi",
> >> +	[USBPHY_INTERFACE_MODE_UTMIW]	= "utmiw",
> >> +	[USBPHY_INTERFACE_MODE_ULPI]	= "ulpi",
> >> +	[USBPHY_INTERFACE_MODE_SERIAL]	= "fsls",
> >> +};
> > 
> > In fact, these would be better off as constants:
> > 
> > #define USBPHY_INTERFACE_MODE_UTMI	1
> > #define USBPHY_INTERFACE_MODE_UTMIW	2
> > ...
> 
> Why are defines better than an enum? BTW: this code is a copy of the

because with enums can change value if you add another one in the middle
and it's really easy to miss that sort of thing during review and cause
regressions to many DTS files.

> ethernet phy of-helper code.

so ?

> >> +/**
> >> + * of_get_phy_mode - Get phy mode for given device_node
> >> + * @np:	Pointer to the given device_node
> >> + *
> >> + * The function gets phy interface string from property 'phy-mode',
> >> + * and return its index in phy_modes table, or errno in error case.
> >> + */
> > 
> > why do you pass a string instead of passing an Integer ? This makes no
> > sense to me.
> 
> This code returns an integer or rather an enum....see header file below.

I mean through DT, should've been more explicit. The dts files should
pass an integer, not a string. Then you don't need this silly conversion
helper.

-- 
balbi

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

  reply	other threads:[~2012-11-16 13:41 UTC|newest]

Thread overview: 98+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-11-14 16:19 [PATCH 0/9] chipidea fixes and features Michael Grzeschik
2012-11-14 16:19 ` Michael Grzeschik
2012-11-14 16:19 ` [PATCH 1/9] usb: chipidea: pci: mark platformdata as static and __devinitdata Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 10:06   ` Alexander Shishkin
2012-11-16 10:06     ` Alexander Shishkin
2012-11-16 10:17     ` Marc Kleine-Budde
2012-11-16 10:17       ` Marc Kleine-Budde
2012-11-16 11:41       ` Alexander Shishkin
2012-11-16 11:41         ` Alexander Shishkin
2012-11-16 12:02     ` Greg KH
2012-11-16 12:02       ` Greg KH
2012-11-14 16:19 ` [PATCH 2/9] usb: chipidea: ci13xxx_imx: add 2nd and 3rd clock to support imx5x and newer Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-26  9:29   ` Peter Chen
2012-11-26  9:29     ` Peter Chen
2012-11-26 10:22     ` Sascha Hauer
2012-11-26 10:22       ` Sascha Hauer
2012-11-27  6:50       ` Peter Chen
2012-11-27  6:50         ` Peter Chen
2012-11-27  7:34         ` Sascha Hauer
2012-11-27  7:34           ` Sascha Hauer
2012-11-14 16:19 ` [PATCH 3/9] usb: chipidea: ci13xxx-imx: create dynamic platformdata Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 10:14   ` Alexander Shishkin
2012-11-16 10:14     ` Alexander Shishkin
2012-11-16 10:19     ` Marc Kleine-Budde
2012-11-16 10:19       ` Marc Kleine-Budde
2012-11-16 12:06   ` Alexander Shishkin
2012-11-16 12:06     ` Alexander Shishkin
2012-11-14 16:19 ` [PATCH 4/9] usb: chipidea: ci13xxx-imx: add "dr_mode" property to device tree bindings Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 11:53   ` Alexander Shishkin
2012-11-16 11:53     ` Alexander Shishkin
2012-11-16 11:55     ` Marc Kleine-Budde
2012-11-16 11:55       ` Marc Kleine-Budde
2012-11-26  9:46     ` Peter Chen
2012-11-26  9:46       ` Peter Chen
2012-11-29 12:54       ` Alexander Shishkin
2012-11-29 12:54         ` Alexander Shishkin
2012-11-14 16:19 ` [PATCH 5/9] usb: add phy connection by phy-mode Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16  9:25   ` Alexander Shishkin
2012-11-16  9:25     ` Alexander Shishkin
2012-11-16 11:28   ` Felipe Balbi
2012-11-16 11:28     ` Felipe Balbi
2012-11-16 11:31   ` Felipe Balbi
2012-11-16 11:31     ` Felipe Balbi
2012-11-16 11:44     ` Marc Kleine-Budde
2012-11-16 11:44       ` Marc Kleine-Budde
2012-11-16 13:41       ` Felipe Balbi [this message]
2012-11-16 13:41         ` Felipe Balbi
2012-11-16 14:32         ` Marc Kleine-Budde
2012-11-16 14:32           ` Marc Kleine-Budde
2012-11-26  9:56   ` Peter Chen
2012-11-26  9:56     ` Peter Chen
2012-11-14 16:19 ` [PATCH 6/9] usb: chipidea: add PTW and PTS handling Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 12:18   ` Alexander Shishkin
2012-11-16 12:18     ` Alexander Shishkin
2012-11-16 12:45   ` Alexander Shishkin
2012-11-16 12:45     ` Alexander Shishkin
2012-11-16 13:16     ` Michael Grzeschik
2012-11-16 13:16       ` Michael Grzeschik
2012-11-16 13:34       ` Alexander Shishkin
2012-11-16 13:34         ` Alexander Shishkin
2012-11-16 13:57         ` Michael Grzeschik
2012-11-16 13:57           ` Michael Grzeschik
2012-11-16 14:06           ` Alexander Shishkin
2012-11-16 14:06             ` Alexander Shishkin
2012-11-16 14:46             ` Matthieu CASTET
2012-11-16 14:46               ` Matthieu CASTET
2012-11-16 15:39               ` Alexander Shishkin
2012-11-16 15:39                 ` Alexander Shishkin
2012-11-21 15:57                 ` Michael Grzeschik
2012-11-21 15:57                   ` Michael Grzeschik
2012-11-21 16:06                   ` Matthieu CASTET
2012-11-21 16:06                     ` Matthieu CASTET
2012-11-27  1:12   ` Peter Chen
2012-11-27  1:12     ` Peter Chen
2012-11-27  9:54     ` Michael Grzeschik
2012-11-27  9:54       ` Michael Grzeschik
2012-11-28  1:26       ` Peter Chen
2012-11-28  1:26         ` Peter Chen
2012-11-14 16:19 ` [PATCH 7/9] usb: chipidea: udc: add force-full-speed option Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 12:51   ` Alexander Shishkin
2012-11-16 12:51     ` Alexander Shishkin
2012-11-16 14:53     ` Matthieu CASTET
2012-11-16 14:53       ` Matthieu CASTET
2012-11-14 16:19 ` [PATCH 8/9] usb: chipidea: udc: remove unlocked ep_queue which can lead to an race Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-16 12:55   ` Alexander Shishkin
2012-11-16 12:55     ` Alexander Shishkin
2012-11-14 16:19 ` [PATCH 9/9] usb: chipidea: udc: configure iso endpoints Michael Grzeschik
2012-11-14 16:19   ` Michael Grzeschik
2012-11-14 18:04   ` Sergei Shtylyov
2012-11-14 18:04     ` Sergei Shtylyov

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=20121116134116.GA18527@arwen.pp.htv.fi \
    --to=balbi@ti.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    /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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.