linux-kernel - [PATCH RESEND net-next] dt-bindings: net: dp83822: change ti,rmii-mode description

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Date: Tue,  5 Mar 2024 15:13:09 +0100
From: Jérémie Dautheribes <jeremie.dautheribes@...tlin.com>
To: "David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>,
	Paolo Abeni <pabeni@...hat.com>,
	Rob Herring <robh+dt@...nel.org>,
	Krzysztof Kozlowski <krzysztof.kozlowski+dt@...aro.org>,
	Conor Dooley <conor+dt@...nel.org>,
	Andrew Davis <afd@...com>,
	Andrew Lunn <andrew@...n.ch>
Cc: netdev@...r.kernel.org,
	devicetree@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	Thomas Petazzoni <thomas.petazzoni@...tlin.com>,
	Yen-Mei Goh <yen-mei.goh@...sight.com>,
	Miquèl Raynal <miquel.raynal@...tlin.com>,
	Jérémie Dautheribes <jeremie.dautheribes@...tlin.com>
Subject: [PATCH RESEND net-next] dt-bindings: net: dp83822: change ti,rmii-mode description

Drop reference to the 25MHz clock as it has nothing to do with connecting
the PHY and the MAC.
Add info about the reference clock direction between the PHY and the MAC
as it depends on the selected rmii mode.

Suggested-by: Andrew Lunn <andrew@...n.ch>
Signed-off-by: Jérémie Dautheribes <jeremie.dautheribes@...tlin.com>
---
This patch follows on from my previous patch series [1] which has already been 
merged into the net-next tree and which added the "ti,rmii-mode" property.
As suggested by Andrew Lunn, this patch updates the description of this 
property to make it more consistent with the master/slave relationship it 
conveys.

[1] https://lore.kernel.org/all/20240222103117.526955-1-jeremie.dautheribes@bootlin.com/

Resending because I previously forgot to include the "net-next" entry in 
the email subject.

 Documentation/devicetree/bindings/net/ti,dp83822.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/devicetree/bindings/net/ti,dp83822.yaml b/Documentation/devicetree/bindings/net/ti,dp83822.yaml
index 8f23254c0458..784866ea392b 100644
--- a/Documentation/devicetree/bindings/net/ti,dp83822.yaml
+++ b/Documentation/devicetree/bindings/net/ti,dp83822.yaml
@@ -84,10 +84,10 @@ properties:
     description: |
        If present, select the RMII operation mode. Two modes are
        available:
-         - RMII master, where the PHY operates from a 25MHz clock reference,
-         provided by a crystal or a CMOS-level oscillator
-         - RMII slave, where the PHY operates from a 50MHz clock reference,
-         provided by a CMOS-level oscillator
+         - RMII master, where the PHY outputs a 50MHz reference clock which can
+         be connected to the MAC.
+         - RMII slave, where the PHY expects a 50MHz reference clock input
+         shared with the MAC.
        The RMII operation mode can also be configured by its straps.
        If the strap pin is not set correctly or not set at all, then this can be
        used to configure it.
-- 
2.34.1