All of lore.kernel.org
 help / color / mirror / Atom feed
From: Kishon Vijay Abraham I <kishon@ti.com>
To: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
Cc: grant.likely@linaro.org, tony@atomide.com, balbi@ti.com,
	arnd@arndb.de, swarren@nvidia.com, linux-kernel@vger.kernel.org,
	linux-omap@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
	linux-usb@vger.kernel.org, gregkh@linuxfoundation.org,
	akpm@linux-foundation.org, rob.herring@calxeda.com,
	rob@landley.net, b-cousson@ti.com, linux@arm.linux.org.uk,
	benoit.cousson@linaro.org, mchehab@redhat.com, cesarb@cesarb.net,
	davem@davemloft.net, rnayak@ti.com, shawn.guo@linaro.org,
	santosh.shilimkar@ti.com, devicetree-discuss@lists.ozlabs.org,
	linux-doc@vger.kernel.org, nsekhar@ti.com
Subject: Re: [PATCH v7 1/9] drivers: phy: add generic PHY framework
Date: Mon, 24 Jun 2013 12:07:18 +0530	[thread overview]
Message-ID: <51C7E91E.3030303@ti.com> (raw)
In-Reply-To: <51C0CFAC.9080606@gmail.com>

On Wednesday 19 June 2013 02:52 AM, Sylwester Nawrocki wrote:
> Hi Kishon,
>
> I've noticed there is a little inconsistency between the code and documentation.
>
> On 06/13/2013 10:43 AM, Kishon Vijay Abraham I wrote:
>> +3. Creating the PHY
>> +
>> +The PHY driver should create the PHY in order for other peripheral controllers
>> +to make use of it. The PHY framework provides 2 APIs to create the PHY.
>> +
>> +struct phy *phy_create(struct device *dev, int id, const struct phy_ops *ops,
>> +    void *priv);
>> +struct phy *devm_phy_create(struct device *dev, int id,
>> +    const struct phy_ops *ops, void *priv);
>
> The 'label' argument is missing in those function prototypes. It seems the
> labels must be unique, I guess this needs to be documented. And do we allow
> NULL labels ? If so, then there is probably a check for NULL label needed
> in phy_lookup() and if not, then phy_create() should fail when NULL label
> is passed ?

Yeah. Label is used only for non-dt case so NULL should be allowed while 
phy_create().

Thanks
Kishon

WARNING: multiple messages have this Message-ID (diff)
From: kishon@ti.com (Kishon Vijay Abraham I)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCH v7 1/9] drivers: phy: add generic PHY framework
Date: Mon, 24 Jun 2013 12:07:18 +0530	[thread overview]
Message-ID: <51C7E91E.3030303@ti.com> (raw)
In-Reply-To: <51C0CFAC.9080606@gmail.com>

On Wednesday 19 June 2013 02:52 AM, Sylwester Nawrocki wrote:
> Hi Kishon,
>
> I've noticed there is a little inconsistency between the code and documentation.
>
> On 06/13/2013 10:43 AM, Kishon Vijay Abraham I wrote:
>> +3. Creating the PHY
>> +
>> +The PHY driver should create the PHY in order for other peripheral controllers
>> +to make use of it. The PHY framework provides 2 APIs to create the PHY.
>> +
>> +struct phy *phy_create(struct device *dev, int id, const struct phy_ops *ops,
>> +    void *priv);
>> +struct phy *devm_phy_create(struct device *dev, int id,
>> +    const struct phy_ops *ops, void *priv);
>
> The 'label' argument is missing in those function prototypes. It seems the
> labels must be unique, I guess this needs to be documented. And do we allow
> NULL labels ? If so, then there is probably a check for NULL label needed
> in phy_lookup() and if not, then phy_create() should fail when NULL label
> is passed ?

Yeah. Label is used only for non-dt case so NULL should be allowed while 
phy_create().

Thanks
Kishon

WARNING: multiple messages have this Message-ID (diff)
From: Kishon Vijay Abraham I <kishon@ti.com>
To: Sylwester Nawrocki <sylvester.nawrocki@gmail.com>
Cc: <grant.likely@linaro.org>, <tony@atomide.com>, <balbi@ti.com>,
	<arnd@arndb.de>, <swarren@nvidia.com>,
	<linux-kernel@vger.kernel.org>, <linux-omap@vger.kernel.org>,
	<linux-arm-kernel@lists.infradead.org>,
	<linux-usb@vger.kernel.org>, <gregkh@linuxfoundation.org>,
	<akpm@linux-foundation.org>, <rob.herring@calxeda.com>,
	<rob@landley.net>, <b-cousson@ti.com>, <linux@arm.linux.org.uk>,
	<benoit.cousson@linaro.org>, <mchehab@redhat.com>,
	<cesarb@cesarb.net>, <davem@davemloft.net>, <rnayak@ti.com>,
	<shawn.guo@linaro.org>, <santosh.shilimkar@ti.com>,
	<devicetree-discuss@lists.ozlabs.org>,
	<linux-doc@vger.kernel.org>, <nsekhar@ti.com>
Subject: Re: [PATCH v7 1/9] drivers: phy: add generic PHY framework
Date: Mon, 24 Jun 2013 12:07:18 +0530	[thread overview]
Message-ID: <51C7E91E.3030303@ti.com> (raw)
In-Reply-To: <51C0CFAC.9080606@gmail.com>

On Wednesday 19 June 2013 02:52 AM, Sylwester Nawrocki wrote:
> Hi Kishon,
>
> I've noticed there is a little inconsistency between the code and documentation.
>
> On 06/13/2013 10:43 AM, Kishon Vijay Abraham I wrote:
>> +3. Creating the PHY
>> +
>> +The PHY driver should create the PHY in order for other peripheral controllers
>> +to make use of it. The PHY framework provides 2 APIs to create the PHY.
>> +
>> +struct phy *phy_create(struct device *dev, int id, const struct phy_ops *ops,
>> +    void *priv);
>> +struct phy *devm_phy_create(struct device *dev, int id,
>> +    const struct phy_ops *ops, void *priv);
>
> The 'label' argument is missing in those function prototypes. It seems the
> labels must be unique, I guess this needs to be documented. And do we allow
> NULL labels ? If so, then there is probably a check for NULL label needed
> in phy_lookup() and if not, then phy_create() should fail when NULL label
> is passed ?

Yeah. Label is used only for non-dt case so NULL should be allowed while 
phy_create().

Thanks
Kishon

  reply	other threads:[~2013-06-24  6:37 UTC|newest]

Thread overview: 113+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-06-13  8:43 [PATCH v7 0/9] Generic PHY Framework Kishon Vijay Abraham I
2013-06-13  8:43 ` Kishon Vijay Abraham I
2013-06-13  8:43 ` Kishon Vijay Abraham I
2013-06-13  8:43 ` [PATCH v7 1/9] drivers: phy: add generic PHY framework Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-18  9:38   ` Felipe Balbi
2013-06-18  9:38     ` Felipe Balbi
2013-06-18  9:38     ` Felipe Balbi
2013-06-18 21:22   ` Sylwester Nawrocki
2013-06-18 21:22     ` Sylwester Nawrocki
2013-06-24  6:37     ` Kishon Vijay Abraham I [this message]
2013-06-24  6:37       ` Kishon Vijay Abraham I
2013-06-24  6:37       ` Kishon Vijay Abraham I
2013-06-19 15:49   ` Sylwester Nawrocki
2013-06-19 15:49     ` Sylwester Nawrocki
2013-06-20  5:28     ` Kishon Vijay Abraham I
2013-06-20  5:28       ` Kishon Vijay Abraham I
2013-06-20  5:28       ` Kishon Vijay Abraham I
2013-06-13  8:43 ` [PATCH v7 3/9] usb: phy: twl4030: use the new " Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-18  9:42   ` Felipe Balbi
2013-06-18  9:42     ` Felipe Balbi
2013-06-18  9:42     ` Felipe Balbi
     [not found] ` <1371113039-5784-1-git-send-email-kishon-l0cyMroinI0@public.gmane.org>
2013-06-13  8:43   ` [PATCH v7 2/9] usb: phy: omap-usb2: " Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-18  9:40     ` Felipe Balbi
2013-06-18  9:40       ` Felipe Balbi
2013-06-18  9:40       ` Felipe Balbi
     [not found]       ` <20130618094058.GQ5461-S8G//mZuvNWo5Im9Ml3/Zg@public.gmane.org>
2013-06-18  9:49         ` Kishon Vijay Abraham I
2013-06-18  9:49           ` Kishon Vijay Abraham I
2013-06-18  9:49           ` Kishon Vijay Abraham I
2013-06-18  9:50           ` Felipe Balbi
2013-06-18  9:50             ` Felipe Balbi
2013-06-18  9:50             ` Felipe Balbi
2013-06-18  9:56             ` Kishon Vijay Abraham I
2013-06-18  9:56               ` Kishon Vijay Abraham I
2013-06-18  9:56               ` Kishon Vijay Abraham I
2013-06-18 10:00               ` Felipe Balbi
2013-06-18 10:00                 ` Felipe Balbi
2013-06-18 10:00                 ` Felipe Balbi
2013-06-13  8:43   ` [PATCH v7 4/9] usb: phy: twl4030: twl4030 shouldn't be subsys_initcall Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
     [not found]     ` <1371113039-5784-5-git-send-email-kishon-l0cyMroinI0@public.gmane.org>
2013-06-18  9:43       ` Felipe Balbi
2013-06-18  9:43         ` Felipe Balbi
2013-06-18  9:43         ` Felipe Balbi
2013-06-13  8:43   ` [PATCH v7 5/9] ARM: OMAP: USB: Add phy binding information Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-18  9:44     ` Felipe Balbi
2013-06-18  9:44       ` Felipe Balbi
2013-06-18  9:44       ` Felipe Balbi
     [not found]       ` <20130618094438.GT5461-S8G//mZuvNWo5Im9Ml3/Zg@public.gmane.org>
2013-06-18 10:04         ` Kishon Vijay Abraham I
2013-06-18 10:04           ` Kishon Vijay Abraham I
2013-06-18 10:04           ` Kishon Vijay Abraham I
2013-06-18 10:27           ` Felipe Balbi
2013-06-18 10:27             ` Felipe Balbi
2013-06-18 10:27             ` Felipe Balbi
2013-06-18 11:13             ` Kishon Vijay Abraham I
2013-06-18 11:13               ` Kishon Vijay Abraham I
2013-06-18 11:13               ` Kishon Vijay Abraham I
2013-06-18 12:35               ` Felipe Balbi
2013-06-18 12:35                 ` Felipe Balbi
2013-06-18 12:35                 ` Felipe Balbi
2013-06-18 14:55                 ` Kishon Vijay Abraham I
2013-06-18 14:55                   ` Kishon Vijay Abraham I
2013-06-18 14:55                   ` Kishon Vijay Abraham I
2013-06-18 14:57                   ` Felipe Balbi
2013-06-18 14:57                     ` Felipe Balbi
2013-06-18 14:57                     ` Felipe Balbi
2013-06-13  8:43   ` [PATCH v7 6/9] ARM: dts: omap: update usb_otg_hs data Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-18  9:45     ` Felipe Balbi
2013-06-18  9:45       ` Felipe Balbi
2013-06-18  9:45       ` Felipe Balbi
2013-06-13  8:43   ` [PATCH v7 8/9] usb: phy: omap-usb2: remove *set_suspend* callback from omap-usb2 Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-13  8:43     ` Kishon Vijay Abraham I
2013-06-18  9:47     ` Felipe Balbi
2013-06-18  9:47       ` Felipe Balbi
2013-06-18  9:47       ` Felipe Balbi
2013-06-13  8:43 ` [PATCH v7 7/9] usb: musb: omap2430: use the new generic PHY framework Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-18  9:47   ` Felipe Balbi
2013-06-18  9:47     ` Felipe Balbi
2013-06-18  9:47     ` Felipe Balbi
2013-06-24  5:31     ` Kishon Vijay Abraham I
2013-06-24  5:31       ` Kishon Vijay Abraham I
2013-06-24  5:31       ` Kishon Vijay Abraham I
2013-06-24  6:37       ` Felipe Balbi
2013-06-24  6:37         ` Felipe Balbi
2013-06-24  6:37         ` Felipe Balbi
2013-06-13  8:43 ` [PATCH v7 9/9] usb: phy: twl4030-usb: remove *set_suspend* and *phy_init* ops Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-13  8:43   ` Kishon Vijay Abraham I
2013-06-18  9:47   ` Felipe Balbi
2013-06-18  9:47     ` Felipe Balbi
2013-06-18  9:47     ` Felipe Balbi
2013-06-17 10:16 ` [PATCH v7 0/9] Generic PHY Framework Sylwester Nawrocki
2013-06-17 10:16   ` Sylwester Nawrocki
     [not found]   ` <51BEE203.6090103-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2013-06-18  9:49     ` Felipe Balbi
2013-06-18  9:49       ` Felipe Balbi
2013-06-18  9:49       ` Felipe Balbi
2013-06-24 19:27       ` Sylwester Nawrocki
2013-06-24 19:27         ` Sylwester Nawrocki
     [not found]         ` <51C89D98.1070806-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2013-06-24 19:34           ` Felipe Balbi
2013-06-24 19:34             ` Felipe Balbi
2013-06-24 19:34             ` Felipe Balbi

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=51C7E91E.3030303@ti.com \
    --to=kishon@ti.com \
    --cc=akpm@linux-foundation.org \
    --cc=arnd@arndb.de \
    --cc=b-cousson@ti.com \
    --cc=balbi@ti.com \
    --cc=benoit.cousson@linaro.org \
    --cc=cesarb@cesarb.net \
    --cc=davem@davemloft.net \
    --cc=devicetree-discuss@lists.ozlabs.org \
    --cc=grant.likely@linaro.org \
    --cc=gregkh@linuxfoundation.org \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-omap@vger.kernel.org \
    --cc=linux-usb@vger.kernel.org \
    --cc=linux@arm.linux.org.uk \
    --cc=mchehab@redhat.com \
    --cc=nsekhar@ti.com \
    --cc=rnayak@ti.com \
    --cc=rob.herring@calxeda.com \
    --cc=rob@landley.net \
    --cc=santosh.shilimkar@ti.com \
    --cc=shawn.guo@linaro.org \
    --cc=swarren@nvidia.com \
    --cc=sylvester.nawrocki@gmail.com \
    --cc=tony@atomide.com \
    /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.