diff mbox series

[net-next] dt-bindings: net: snps,dwmac: Do not make 'phy-mode' required

Message ID 20231113204052.43688-1-festevam@gmail.com (mailing list archive)
State Changes Requested
Delegated to: Netdev Maintainers
Headers show
Series [net-next] dt-bindings: net: snps,dwmac: Do not make 'phy-mode' required | expand

Checks

Context Check Description
netdev/series_format success Single patches do not need cover letters
netdev/tree_selection success Clearly marked for net-next
netdev/fixes_present success Fixes tag not required for -next series
netdev/header_inline success No static functions without inline keyword in header files
netdev/build_32bit success Errors and warnings before: 8 this patch: 8
netdev/cc_maintainers warning 3 maintainers not CCed: peppe.cavallaro@st.com alexandre.torgue@foss.st.com joabreu@synopsys.com
netdev/build_clang success Errors and warnings before: 8 this patch: 8
netdev/verify_signedoff success Signed-off-by tag matches author and committer
netdev/deprecated_api success None detected
netdev/check_selftest success No net selftest shell script
netdev/verify_fixes success No Fixes tag
netdev/build_allmodconfig_warn success Errors and warnings before: 8 this patch: 8
netdev/checkpatch success total: 0 errors, 0 warnings, 0 checks, 17 lines checked
netdev/build_clang_rust success No Rust files in patch. Skipping build
netdev/kdoc success Errors and warnings before: 0 this patch: 0
netdev/source_inline success Was 0 now: 0

Commit Message

Fabio Estevam Nov. 13, 2023, 8:40 p.m. UTC
From: Fabio Estevam <festevam@denx.de>

The property 'phy-connection-type' can also be used to describe
the interface type between the Ethernet device and the Ethernet PHY
device.

Mark 'phy-mode' as a non required property.

This fixes the following schema warning:

imx8mp-debix-model-a.dtb: ethernet@30bf0000: 'phy-mode' is a required property
	from schema $id: http://devicetree.org/schemas/net/snps,dwmac.yaml#

Signed-off-by: Fabio Estevam <festevam@denx.de>
---
 Documentation/devicetree/bindings/net/snps,dwmac.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

Comments

Andrew Lunn Nov. 13, 2023, 9:51 p.m. UTC | #1
On Mon, Nov 13, 2023 at 05:40:52PM -0300, Fabio Estevam wrote:
> From: Fabio Estevam <festevam@denx.de>
> 
> The property 'phy-connection-type' can also be used to describe
> the interface type between the Ethernet device and the Ethernet PHY
> device.
> 
> Mark 'phy-mode' as a non required property.

Hi Fabio

What does the driver actually require? Will it error out if neither is
provided?

Maybe we should be changing the condition that one or the other is
required?

	Andrew
Florian Fainelli Nov. 13, 2023, 10:03 p.m. UTC | #2
On 11/13/23 13:51, Andrew Lunn wrote:
> On Mon, Nov 13, 2023 at 05:40:52PM -0300, Fabio Estevam wrote:
>> From: Fabio Estevam <festevam@denx.de>
>>
>> The property 'phy-connection-type' can also be used to describe
>> the interface type between the Ethernet device and the Ethernet PHY
>> device.
>>
>> Mark 'phy-mode' as a non required property.
> 
> Hi Fabio
> 
> What does the driver actually require? Will it error out if neither is
> provided?
> 
> Maybe we should be changing the condition that one or the other is
> required?

'phy-connection-type' is the deprecated version of 'phy-mode' which 
of_get_phy_mode() will fall back to if 'phy-mode' is not provided. It 
does not appear that stmmac attempts to use anything other than 
of_get_phy_mode() therefore would not it be acceptable to update the 
relevant .dts file such that it uses 'phy-mode'?

That really should not have a functional impact given that 
of_get_phy_mode() has worked that way for a while.
Andrew Lunn Nov. 13, 2023, 10:23 p.m. UTC | #3
On Mon, Nov 13, 2023 at 02:03:00PM -0800, Florian Fainelli wrote:
> On 11/13/23 13:51, Andrew Lunn wrote:
> > On Mon, Nov 13, 2023 at 05:40:52PM -0300, Fabio Estevam wrote:
> > > From: Fabio Estevam <festevam@denx.de>
> > > 
> > > The property 'phy-connection-type' can also be used to describe
> > > the interface type between the Ethernet device and the Ethernet PHY
> > > device.
> > > 
> > > Mark 'phy-mode' as a non required property.
> > 
> > Hi Fabio
> > 
> > What does the driver actually require? Will it error out if neither is
> > provided?
> > 
> > Maybe we should be changing the condition that one or the other is
> > required?

Hi Florian

 
> 'phy-connection-type' is the deprecated version of 'phy-mode'

I thought that too, but
Documentation/devicetree/bindings/net/ethernet-controller.yaml does
not mark it deprecated.

The original .txt file has a different wording:

- phy-mode: string, operation mode of the PHY interface. This is now a de-facto
  standard property; supported values are:
  * "internal" (Internal means there is not a standard bus between the MAC and
     the PHY, something proprietary is being used to embed the PHY in the MAC.)
  * "mii"
  * "gmii"

- phy-connection-type: the same as "phy-mode" property but described in the
  Devicetree Specification;

So it could technically be we cannot deprecate phy-connection-type
because it is part of the standard, and we need to accept it.

> which
> of_get_phy_mode() will fall back to if 'phy-mode' is not provided. It does
> not appear that stmmac attempts to use anything other than of_get_phy_mode()
> therefore would not it be acceptable to update the relevant .dts file such
> that it uses 'phy-mode'?

Using phy-mode would be more consistent, since its used > 10x more
than phy-connection-type.

     Andrew
Fabio Estevam Nov. 13, 2023, 10:55 p.m. UTC | #4
Hi Andrew and Florian,

On Mon, Nov 13, 2023 at 7:23 PM Andrew Lunn <andrew@lunn.ch> wrote:

> Using phy-mode would be more consistent, since its used > 10x more
> than phy-connection-type.

Thanks for the suggestion. I will change the dts to use phy-mode then.

Thanks
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/net/snps,dwmac.yaml b/Documentation/devicetree/bindings/net/snps,dwmac.yaml
index 5c2769dc689a..6c0d9e694d76 100644
--- a/Documentation/devicetree/bindings/net/snps,dwmac.yaml
+++ b/Documentation/devicetree/bindings/net/snps,dwmac.yaml
@@ -505,6 +505,10 @@  properties:
     required:
       - compatible
 
+  phy-connection-type: true
+
+  phy-mode: true
+
   stmmac-axi-config:
     type: object
     unevaluatedProperties: false
@@ -564,7 +568,6 @@  required:
   - reg
   - interrupts
   - interrupt-names
-  - phy-mode
 
 dependencies:
   snps,reset-active-low: ["snps,reset-gpio"]