[PATCH net-next RFC 0/5] net: phy: Introduce a port representation

[Kory Maincent]

On Thu, 2 Jan 2025 18:03:52 +0100
Oleksij Rempel <o.rempel at pengutronix.de> wrote:

> On Thu, Jan 02, 2025 at 10:48:05AM +0000, Russell King (Oracle) wrote:
> > On Sun, Dec 22, 2024 at 07:54:37PM +0100, Oleksij Rempel wrote:  
> > > Here is updated version:
> > > 
> > > ports {
> > >     /* 1000BaseT Port with Ethernet and simple PoE */
> > >     port0: ethernet-port at 0 {
> > >         reg = <0>; /* Port index */
> > >         label = "ETH0"; /* Physical label on the device */
> > >         connector = "RJ45"; /* Connector type */
> > >         supported-modes = <10BaseT 100BaseTX 1000BaseT>; /* Supported
> > > modes */
> > > 
> > >         transformer {
> > >             model = "ABC123"; /* Transformer model number */
> > >             manufacturer = "TransformerCo"; /* Manufacturer name */
> > > 
> > >             pairs {
> > >                 pair at 0 {
> > >                     name = "A"; /* Pair A */
> > >                     pins = <1 2>; /* Connector pins */
> > >                     phy-mapping = <PHY_TX0_P PHY_TX0_N>; /* PHY pin
> > > mapping */ center-tap = "CT0"; /* Central tap identifier */
> > >                     pse-negative = <PSE_GND>; /* CT0 connected to GND */
> > >                 };
> > >                 pair at 1 {
> > >                     name = "B"; /* Pair B */
> > >                     pins = <3 6>; /* Connector pins */
> > >                     phy-mapping = <PHY_RX0_P PHY_RX0_N>;
> > >                     center-tap = "CT1"; /* Central tap identifier */
> > >                     pse-positive = <PSE_OUT0>; /* CT1 connected to
> > > PSE_OUT0 */ };
> > >                 pair at 2 {
> > >                     name = "C"; /* Pair C */
> > >                     pins = <4 5>; /* Connector pins */
> > >                     phy-mapping = <PHY_TXRX1_P PHY_TXRX1_N>; /* PHY
> > > connection only */ center-tap = "CT2"; /* Central tap identifier */
> > >                     /* No power connection to CT2 */
> > >                 };
> > >                 pair at 3 {
> > >                     name = "D"; /* Pair D */
> > >                     pins = <7 8>; /* Connector pins */
> > >                     phy-mapping = <PHY_TXRX2_P PHY_TXRX2_N>; /* PHY
> > > connection only */ center-tap = "CT3"; /* Central tap identifier */
> > >                     /* No power connection to CT3 */
> > >                 };
> > >             };
> > >         };  

Couldn't we begin with something simple like the following and add all the
transformers and pairs information as you described later if the community feels
we need it?

mdis {

    /* 1000BaseT Port with Ethernet and PoE */
    mdi0: ethernet-mdi at 0 {
        reg = <0>; /* Port index */
        label = "ETH0"; /* Physical label on the device */
        connector = "RJ45"; /* Connector type */
        supported-modes = <10BaseT 100BaseTX 1000BaseT>; /* Supported modes */
        lanes = <2>;
        variant = "MDI-X"; /* MDI or MDI-X */
        pse = <&pse1>;
    };
};

We can also add led, thermal and fuse subnodes later.
Let's begin with something simple for the initial support, considering
that it has places for additional details in the future.

Regards,
-- 
Köry Maincent, Bootlin
Embedded Linux and kernel engineering
https://bootlin.com