* [PATCH] Documentation: devicetree: Add PHY no lane swap binding
@ 2017-02-04 15:47 Lukasz Majewski
2017-02-04 17:23 ` Andrew Lunn
0 siblings, 1 reply; 8+ messages in thread
From: Lukasz Majewski @ 2017-02-04 15:47 UTC (permalink / raw)
To: Rob Herring, Mark Rutland, David S. Miller, Florian Fainelli,
jbrunet, Andrew Lunn
Cc: linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam, Lukasz Majewski
Add the documentation to avoid PHY lane swapping. This is a boolean
entry to notify the phy device drivers that the TX/RX lanes NO need
to be swapped.
The use case for this binding mostly happens after wrong HW
configuration of PHY IC during bootstrap.
Signed-off-by: Lukasz Majewski <lukma@denx.de>
---
Documentation/devicetree/bindings/net/phy.txt | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/Documentation/devicetree/bindings/net/phy.txt b/Documentation/devicetree/bindings/net/phy.txt
index fb5056b..5e25bc9 100644
--- a/Documentation/devicetree/bindings/net/phy.txt
+++ b/Documentation/devicetree/bindings/net/phy.txt
@@ -39,6 +39,10 @@ Optional Properties:
- enet-phy-lane-swap: If set, indicates the PHY will swap the TX/RX lanes to
compensate for the board being designed with the lanes swapped.
+- enet-phy-lane-no-swap: If set, indicates that PHY will disable swap of the
+ TX/RX lanes. This binding allows the PHY to work correcly after e.g. wrong
+ bootstrap configuration caused by issues in PCB layout design.
+
- eee-broken-100tx:
- eee-broken-1000t:
- eee-broken-10gt:
--
2.1.4
^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
@ 2017-02-04 17:23 ` Andrew Lunn
0 siblings, 0 replies; 8+ messages in thread
From: Andrew Lunn @ 2017-02-04 17:23 UTC (permalink / raw)
To: Lukasz Majewski
Cc: Rob Herring, Mark Rutland, David S. Miller, Florian Fainelli,
jbrunet, linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam
On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
> Add the documentation to avoid PHY lane swapping. This is a boolean
> entry to notify the phy device drivers that the TX/RX lanes NO need
that the TX/RX lanes should not be swapped.
> to be swapped.
> The use case for this binding mostly happens after wrong HW
> configuration of PHY IC during bootstrap.
>
> Signed-off-by: Lukasz Majewski <lukma@denx.de>
> ---
> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
> 1 file changed, 4 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/net/phy.txt b/Documentation/devicetree/bindings/net/phy.txt
> index fb5056b..5e25bc9 100644
> --- a/Documentation/devicetree/bindings/net/phy.txt
> +++ b/Documentation/devicetree/bindings/net/phy.txt
> @@ -39,6 +39,10 @@ Optional Properties:
> - enet-phy-lane-swap: If set, indicates the PHY will swap the TX/RX lanes to
> compensate for the board being designed with the lanes swapped.
>
> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable swap of the
> + TX/RX lanes. This binding allows the PHY to work correcly after e.g. wrong
> + bootstrap configuration caused by issues in PCB layout design.
> +
We are leaving it undefined what it means if neither
enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
Do we want to define this? That the swap should be left untouched by
the driver?
Andrew
^ permalink raw reply [flat|nested] 8+ messages in thread* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
@ 2017-02-04 17:23 ` Andrew Lunn
0 siblings, 0 replies; 8+ messages in thread
From: Andrew Lunn @ 2017-02-04 17:23 UTC (permalink / raw)
To: Lukasz Majewski
Cc: Rob Herring, Mark Rutland, David S. Miller, Florian Fainelli,
jbrunet, linux-kernel-u79uwXL29TY76Z2rM5mHXA,
devicetree-u79uwXL29TY76Z2rM5mHXA, netdev-u79uwXL29TY76Z2rM5mHXA,
Uwe Kleine-König, Martin Blumenstingl, Jon Mason,
Fabio Estevam
On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
> Add the documentation to avoid PHY lane swapping. This is a boolean
> entry to notify the phy device drivers that the TX/RX lanes NO need
that the TX/RX lanes should not be swapped.
> to be swapped.
> The use case for this binding mostly happens after wrong HW
> configuration of PHY IC during bootstrap.
>
> Signed-off-by: Lukasz Majewski <lukma-ynQEQJNshbs@public.gmane.org>
> ---
> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
> 1 file changed, 4 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/net/phy.txt b/Documentation/devicetree/bindings/net/phy.txt
> index fb5056b..5e25bc9 100644
> --- a/Documentation/devicetree/bindings/net/phy.txt
> +++ b/Documentation/devicetree/bindings/net/phy.txt
> @@ -39,6 +39,10 @@ Optional Properties:
> - enet-phy-lane-swap: If set, indicates the PHY will swap the TX/RX lanes to
> compensate for the board being designed with the lanes swapped.
>
> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable swap of the
> + TX/RX lanes. This binding allows the PHY to work correcly after e.g. wrong
> + bootstrap configuration caused by issues in PCB layout design.
> +
We are leaving it undefined what it means if neither
enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
Do we want to define this? That the swap should be left untouched by
the driver?
Andrew
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 8+ messages in thread* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
2017-02-04 17:23 ` Andrew Lunn
(?)
@ 2017-02-04 21:38 ` Florian Fainelli
2017-02-06 14:15 ` Lukasz Majewski
-1 siblings, 1 reply; 8+ messages in thread
From: Florian Fainelli @ 2017-02-04 21:38 UTC (permalink / raw)
To: Andrew Lunn, Lukasz Majewski
Cc: Rob Herring, Mark Rutland, David S. Miller, jbrunet,
linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam
Le 02/04/17 à 09:23, Andrew Lunn a écrit :
> On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
>> Add the documentation to avoid PHY lane swapping. This is a boolean
>> entry to notify the phy device drivers that the TX/RX lanes NO need
>
> that the TX/RX lanes should not be swapped.
>
>> to be swapped.
>> The use case for this binding mostly happens after wrong HW
>> configuration of PHY IC during bootstrap.
>>
>> Signed-off-by: Lukasz Majewski <lukma@denx.de>
>> ---
>> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
>> 1 file changed, 4 insertions(+)
>>
>> diff --git a/Documentation/devicetree/bindings/net/phy.txt b/Documentation/devicetree/bindings/net/phy.txt
>> index fb5056b..5e25bc9 100644
>> --- a/Documentation/devicetree/bindings/net/phy.txt
>> +++ b/Documentation/devicetree/bindings/net/phy.txt
>> @@ -39,6 +39,10 @@ Optional Properties:
>> - enet-phy-lane-swap: If set, indicates the PHY will swap the TX/RX lanes to
>> compensate for the board being designed with the lanes swapped.
>>
>> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable swap of the
>> + TX/RX lanes. This binding allows the PHY to work correcly after e.g. wrong
>> + bootstrap configuration caused by issues in PCB layout design.
s/binding/property/
>> +
>
> We are leaving it undefined what it means if neither
> enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
> Do we want to define this? That the swap should be left untouched by
> the driver?
Since this is a description of the hardware, absence of a properties
should mean that the driver is at freedom to either keep the hardware
defaults, or come up with its own settings that are sensible for that
particular PHY device.
What would you see clarified here?
--
Florian
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
2017-02-04 21:38 ` Florian Fainelli
@ 2017-02-06 14:15 ` Lukasz Majewski
2017-02-06 14:38 ` Andrew Lunn
2017-02-06 17:58 ` Florian Fainelli
0 siblings, 2 replies; 8+ messages in thread
From: Lukasz Majewski @ 2017-02-06 14:15 UTC (permalink / raw)
To: Florian Fainelli, Andrew Lunn
Cc: Rob Herring, Mark Rutland, David S. Miller, jbrunet,
linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam
Hi Florian, Andrew,
> Le 02/04/17 à 09:23, Andrew Lunn a écrit :
> > On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
> >> Add the documentation to avoid PHY lane swapping. This is a boolean
> >> entry to notify the phy device drivers that the TX/RX lanes NO need
> >
> > that the TX/RX lanes should not be swapped.
> >
> >> to be swapped.
> >> The use case for this binding mostly happens after wrong HW
> >> configuration of PHY IC during bootstrap.
> >>
> >> Signed-off-by: Lukasz Majewski <lukma@denx.de>
> >> ---
> >> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
> >> 1 file changed, 4 insertions(+)
> >>
> >> diff --git a/Documentation/devicetree/bindings/net/phy.txt
> >> b/Documentation/devicetree/bindings/net/phy.txt index
> >> fb5056b..5e25bc9 100644 ---
> >> a/Documentation/devicetree/bindings/net/phy.txt +++
> >> b/Documentation/devicetree/bindings/net/phy.txt @@ -39,6 +39,10 @@
> >> Optional Properties:
> >> - enet-phy-lane-swap: If set, indicates the PHY will swap the
> >> TX/RX lanes to compensate for the board being designed with the
> >> lanes swapped.
> >> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable
> >> swap of the
> >> + TX/RX lanes. This binding allows the PHY to work correcly after
> >> e.g. wrong
> >> + bootstrap configuration caused by issues in PCB layout design.
>
> s/binding/property/
>
> >> +
> >
> > We are leaving it undefined what it means if neither
> > enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
> > Do we want to define this? That the swap should be left untouched by
> > the driver?
>
> Since this is a description of the hardware, absence of a properties
> should mean that the driver is at freedom to either keep the hardware
> defaults, or come up with its own settings that are sensible for that
> particular PHY device.
>
> What would you see clarified here?
Any more comments to this patch?
Is the explanation informative enough?
Best regards,
Lukasz Majewski
--
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd@denx.de
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
2017-02-06 14:15 ` Lukasz Majewski
@ 2017-02-06 14:38 ` Andrew Lunn
2017-02-06 17:58 ` Florian Fainelli
1 sibling, 0 replies; 8+ messages in thread
From: Andrew Lunn @ 2017-02-06 14:38 UTC (permalink / raw)
To: Lukasz Majewski
Cc: Florian Fainelli, Rob Herring, Mark Rutland, David S. Miller,
jbrunet, linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam
> > Since this is a description of the hardware, absence of a properties
> > should mean that the driver is at freedom to either keep the hardware
> > defaults, or come up with its own settings that are sensible for that
> > particular PHY device.
> >
> > What would you see clarified here?
>
> Any more comments to this patch?
Nope.
Andrew
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
2017-02-06 14:15 ` Lukasz Majewski
@ 2017-02-06 17:58 ` Florian Fainelli
2017-02-06 17:58 ` Florian Fainelli
1 sibling, 0 replies; 8+ messages in thread
From: Florian Fainelli @ 2017-02-06 17:58 UTC (permalink / raw)
To: Lukasz Majewski, Andrew Lunn
Cc: Rob Herring, Mark Rutland, David S. Miller, jbrunet,
linux-kernel, devicetree, netdev, Uwe Kleine-König,
Martin Blumenstingl, Jon Mason, Fabio Estevam
On 02/06/2017 06:15 AM, Lukasz Majewski wrote:
> Hi Florian, Andrew,
>
>> Le 02/04/17 à 09:23, Andrew Lunn a écrit :
>>> On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
>>>> Add the documentation to avoid PHY lane swapping. This is a boolean
>>>> entry to notify the phy device drivers that the TX/RX lanes NO need
>>>
>>> that the TX/RX lanes should not be swapped.
>>>
>>>> to be swapped.
>>>> The use case for this binding mostly happens after wrong HW
>>>> configuration of PHY IC during bootstrap.
>>>>
>>>> Signed-off-by: Lukasz Majewski <lukma@denx.de>
>>>> ---
>>>> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
>>>> 1 file changed, 4 insertions(+)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/net/phy.txt
>>>> b/Documentation/devicetree/bindings/net/phy.txt index
>>>> fb5056b..5e25bc9 100644 ---
>>>> a/Documentation/devicetree/bindings/net/phy.txt +++
>>>> b/Documentation/devicetree/bindings/net/phy.txt @@ -39,6 +39,10 @@
>>>> Optional Properties:
>>>> - enet-phy-lane-swap: If set, indicates the PHY will swap the
>>>> TX/RX lanes to compensate for the board being designed with the
>>>> lanes swapped.
>>>> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable
>>>> swap of the
>>>> + TX/RX lanes. This binding allows the PHY to work correcly after
>>>> e.g. wrong
>>>> + bootstrap configuration caused by issues in PCB layout design.
>>
>> s/binding/property/
>>
>>>> +
>>>
>>> We are leaving it undefined what it means if neither
>>> enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
>>> Do we want to define this? That the swap should be left untouched by
>>> the driver?
>>
>> Since this is a description of the hardware, absence of a properties
>> should mean that the driver is at freedom to either keep the hardware
>> defaults, or come up with its own settings that are sensible for that
>> particular PHY device.
>>
>> What would you see clarified here?
>
> Any more comments to this patch?
>
> Is the explanation informative enough?
Please resubmit as part of your PHY driver changes, and change binding
in the description above for property.
--
Florian
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [PATCH] Documentation: devicetree: Add PHY no lane swap binding
@ 2017-02-06 17:58 ` Florian Fainelli
0 siblings, 0 replies; 8+ messages in thread
From: Florian Fainelli @ 2017-02-06 17:58 UTC (permalink / raw)
To: Lukasz Majewski, Andrew Lunn
Cc: Rob Herring, Mark Rutland, David S. Miller, jbrunet,
linux-kernel-u79uwXL29TY76Z2rM5mHXA,
devicetree-u79uwXL29TY76Z2rM5mHXA, netdev-u79uwXL29TY76Z2rM5mHXA,
Uwe Kleine-König, Martin Blumenstingl, Jon Mason,
Fabio Estevam
On 02/06/2017 06:15 AM, Lukasz Majewski wrote:
> Hi Florian, Andrew,
>
>> Le 02/04/17 à 09:23, Andrew Lunn a écrit :
>>> On Sat, Feb 04, 2017 at 04:47:47PM +0100, Lukasz Majewski wrote:
>>>> Add the documentation to avoid PHY lane swapping. This is a boolean
>>>> entry to notify the phy device drivers that the TX/RX lanes NO need
>>>
>>> that the TX/RX lanes should not be swapped.
>>>
>>>> to be swapped.
>>>> The use case for this binding mostly happens after wrong HW
>>>> configuration of PHY IC during bootstrap.
>>>>
>>>> Signed-off-by: Lukasz Majewski <lukma-ynQEQJNshbs@public.gmane.org>
>>>> ---
>>>> Documentation/devicetree/bindings/net/phy.txt | 4 ++++
>>>> 1 file changed, 4 insertions(+)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/net/phy.txt
>>>> b/Documentation/devicetree/bindings/net/phy.txt index
>>>> fb5056b..5e25bc9 100644 ---
>>>> a/Documentation/devicetree/bindings/net/phy.txt +++
>>>> b/Documentation/devicetree/bindings/net/phy.txt @@ -39,6 +39,10 @@
>>>> Optional Properties:
>>>> - enet-phy-lane-swap: If set, indicates the PHY will swap the
>>>> TX/RX lanes to compensate for the board being designed with the
>>>> lanes swapped.
>>>> +- enet-phy-lane-no-swap: If set, indicates that PHY will disable
>>>> swap of the
>>>> + TX/RX lanes. This binding allows the PHY to work correcly after
>>>> e.g. wrong
>>>> + bootstrap configuration caused by issues in PCB layout design.
>>
>> s/binding/property/
>>
>>>> +
>>>
>>> We are leaving it undefined what it means if neither
>>> enet-phy-lane-no-swap nor enet-phy-lane-swap properties are present.
>>> Do we want to define this? That the swap should be left untouched by
>>> the driver?
>>
>> Since this is a description of the hardware, absence of a properties
>> should mean that the driver is at freedom to either keep the hardware
>> defaults, or come up with its own settings that are sensible for that
>> particular PHY device.
>>
>> What would you see clarified here?
>
> Any more comments to this patch?
>
> Is the explanation informative enough?
Please resubmit as part of your PHY driver changes, and change binding
in the description above for property.
--
Florian
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2017-02-06 17:58 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-02-04 15:47 [PATCH] Documentation: devicetree: Add PHY no lane swap binding Lukasz Majewski
2017-02-04 17:23 ` Andrew Lunn
2017-02-04 17:23 ` Andrew Lunn
2017-02-04 21:38 ` Florian Fainelli
2017-02-06 14:15 ` Lukasz Majewski
2017-02-06 14:38 ` Andrew Lunn
2017-02-06 17:58 ` Florian Fainelli
2017-02-06 17:58 ` Florian Fainelli
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.