Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
From:   Sean Anderson <sean.anderson@seco.com>
Subject: Re: [RFC net-next PATCH 01/16] dt-bindings: net: Add pcs property
To:     Rob Herring <robh@kernel.org>
Cc:     "Russell King (Oracle)" <linux@armlinux.org.uk>,
        netdev <netdev@vger.kernel.org>,
        "David S . Miller" <davem@davemloft.net>,
        Jakub Kicinski <kuba@kernel.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        Andrew Lunn <andrew@lunn.ch>,
        Heiner Kallweit <hkallweit1@gmail.com>,
        devicetree@vger.kernel.org
References: <20211004191527.1610759-1-sean.anderson@seco.com>
 <20211004191527.1610759-2-sean.anderson@seco.com>
 <YVwdWIJiV1nkJ4A3@shell.armlinux.org.uk>
 <YWWKuhn4FfgbcqO/@robh.at.kernel.org>
 <2e5ebf4e-bc97-1b8b-02e2-fe455aa1c100@seco.com>
 <CAL_Jsq+MAy8CRjLvqAg5oC53=ZO2UZcH_s0kMnaYD8M+y8+dLw@mail.gmail.com>
Message-ID: <ac2ceacc-db1d-ec99-61c4-f20e5d371fad@seco.com>
Date:   Tue, 12 Oct 2021 13:01:21 -0400
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.10.0
In-Reply-To: <CAL_Jsq+MAy8CRjLvqAg5oC53=ZO2UZcH_s0kMnaYD8M+y8+dLw@mail.gmail.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?UU9zeGVmSysrcG5VRkI0MGYwTmMrVW4rRHZpODNMQWVWajdxd2RVWXk5b1Jn?=
 =?utf-8?B?MnBUNWtWbWtQcGE2akVqdzQ1VnltV0cxTlpDYXI3a3JHMW1HakRvUFl5VVBr?=
 =?utf-8?B?NHpPVHBDVHBaT1BaOXBGU21Uc0dwT2pQdWdjWTlxMGF2cU5qcU92Y3NkMkNL?=
 =?utf-8?B?Tml5Tm5RcHBlWkVqY1l1YnVIVlJFUGV1a2JtNkthYVNsckxmMS9sMzU2RCtv?=
 =?utf-8?B?ZjBiWVZPVGRRYVdEMWxjV0RDaXJNbTh6aER4TTdNeEJpRFZvOUkwQmc0eWxm?=
 =?utf-8?B?dm1FWE5YYjAyQkhqYVdMOUlYQVoxZjRxbWNwY3ZCb0RvdUNwc1VjYnJuSVlS?=
 =?utf-8?B?UDI4U3FZM3hRTmppb21YSE1HZVFpcUZTTmVTcithRVhnTEJHUmQvZ3NoNjRp?=
 =?utf-8?B?NldNVkQ3U3IvdGl1NlU4a0U5aTFCS3JtR01yZzZOa1EzbDJiKzJNYlhwTTJz?=
 =?utf-8?B?dkFDQ0dyT2NiRjRWc1RDS1JDeFNEeU9jVnBmbXd2elRkeEx2dFpMZmplYzJo?=
 =?utf-8?B?dFc2UmlGaWN2cWJSRzBnSGJSUkdGV1dwdE9yOGVoaERJUnNXRVQ5ck44a2U2?=
 =?utf-8?B?SGM5K3dVblZieW44TlR5cGp5MjE5cksreWFZb3JteVNidlhLRi85Y0lpZzlW?=
 =?utf-8?B?TmNUcmJGbGRSYVFQSTloa0lFNVQxRWZqQ1VTcm1GY0IwdGljNHM3aGM1d2hB?=
 =?utf-8?B?U3NyaUJ0SWFFcVhST01OY1BiRmNWVEROK1IranBCaTVHSCtoaFVNMm1PTThQ?=
 =?utf-8?B?eFVVT0JtcGU3QitjMXJ4eEVZMkUyeHR2bUlaYkNHbjMwYm1kY2RGLzA4Uk5C?=
 =?utf-8?B?S252YlhnbUhIaHB0d2NjVGV1UFFmcFBMMWl2QU5vMFNrdUk2NmhzaUxPMHcr?=
 =?utf-8?B?VFkzN0pMQmRVK1g4ZmxWa2JhZXVlYVc0Z21ENVVVVTJ5OVA2b0N2SFh0SzBL?=
 =?utf-8?B?L0JLa1FsYm55UDFvdWVmajlWbi9pdTd1V3pMY2VhMFFiSmVxZ1dJcjJTakk1?=
 =?utf-8?B?ck5IdTR4RlFEd1dGb01oQUtZbFFiNHdiU0grdUR5NmVReXVsdHBoM05hQlJx?=
 =?utf-8?B?ZkdGNnZiUldVT3MvZVd3L2x0MUhMTUxKKzdBMjl0cTUrTUhUbjI1TklaV04z?=
 =?utf-8?B?YS9zc0ZSekVGYk12Qmtka2gxWkxySElGYkpoREVDdCtNZlYrRTE5cG0xZHFl?=
 =?utf-8?B?d1F4OHEzZ3RQQVZxNHY3Z1YrSUFmZ0hmbGl4cEJsU2JtSThQNGluUFpteDFj?=
 =?utf-8?B?UW5QZlMvQlJiRkRwZkF1OFZiRFd3elVSanptVmxPRGFWc1B4Tkp6WWFSbHJS?=
 =?utf-8?B?QWMzcG1saU01ZDlQWXpZN1dDSFFURWdvYUM2SWoxYmRuMURtR1A0S2hDR0xm?=
 =?utf-8?B?ZFluZzZDUzExRjNVdDNrbkZIVHpZeUtyZGdIOG5wYldETk5xa2g0c2M5MlZa?=
 =?utf-8?B?bGpqcFZNS0toWjdHVnpvMHhzN1pPc2RET1hCU3dnV04zajN6eXduNWFCdUhp?=
 =?utf-8?B?d0dXYkZ4ZmxvaDkyU2RPWFlOQUVQRVl5YTZhWnZtNndNcjI0SmVQY2twZnVQ?=
 =?utf-8?B?NDNaVndpUUhubUdwVWEybGlOelNZcEJ6dkZzOERkSHk5Z2c3cjA1Wk13NXNi?=
 =?utf-8?B?ZTBScTRzNkM2d1A3QTMvcUc1NXI3a3BxVDY1TWd1YTdEaytqVEszWHVCd0to?=
 =?utf-8?B?ejdHdllyWXpHSDM1MXAvZFFYRTdzcnBET29QQ1o2c3dtSmFMMjhRNWRIUDZs?=
 =?utf-8?Q?VRtWTz4Sgev/OkhxCqo82Vr7Yd+k2skMZA2Bch0?=
X-OriginatorOrg: seco.com
X-MS-Exchange-CrossTenant-Network-Message-Id: aea553fe-e996-43e5-4341-08d98da1ed6b
X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4523.eurprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Oct 2021 17:01:26.2726
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: gaLkQbao7Zor+dhD8ZhHD2+CLFLRJBlYaOuz533dX8nGADHQ0rkn086YpEB7zVkdO/uZwoj35Lh9PBPoD3SYuw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR03MB6762
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org


On 10/12/21 12:44 PM, Rob Herring wrote:
> On Tue, Oct 12, 2021 at 11:18 AM Sean Anderson <sean.anderson@seco.com> wrote:
>>
>> Hi Rob,
>>
>> On 10/12/21 9:16 AM, Rob Herring wrote:
>> > On Tue, Oct 05, 2021 at 10:39:36AM +0100, Russell King (Oracle) wrote:
>> >> On Mon, Oct 04, 2021 at 03:15:12PM -0400, Sean Anderson wrote:
>> >> > Add a property for associating PCS devices with ethernet controllers.
>> >> > Because PCS has no generic analogue like PHY, I have left off the
>> >> > -handle suffix.
>> >>
>> >> For PHYs, we used to have phy and phy-device as property names, but the
>> >> modern name is "phy-handle". I think we should do the same here, so I
>> >> would suggest using "pcs-handle".
>> >
>> > On 1G and up ethernet, we have 2 PHYs. There's the external (typically)
>> > ethernet PHY which is what the above properties are for. Then there's
>> > the on-chip serdes PHY similar to SATA, PCIe, etc. which includes the
>> > PCS part. For this part, we should use the generic PHY binding. I think
>> > we already have bindings doing that.
>>
>> In the 802.3 models, there are several components which convert between
>> the MII (from the MAC) and the MDI (the physical protocol on the wire).
>> These are the Physical Coding Sublayer (PCS), Physical Medium Attachment
>> (PMA) sublayer, and Physical Medium Dependent (PMD) sublayer. The PMD
>> converts between the physical layer signaling and the on-chip (or
>> on-board) signalling. The PMA performs clock recovery and converts the
>> serial data from the PMD into parallel data for the PCS. The PCS handles
>> autonegotiation, CSMA/CD, and conversion to the apripriate MII for
>> communicating with the MAC.
>>
>> In the above model, generic serdes devices generally correspond to the
>> PMA/PMD sublayers. The PCS is generally a separate device, both
>> on the hardware and software level. It provides an ethernet-specific
>> layer on top of the more generic underlying encoding. For this reason,
>> the PCS should be modeled as its own device, which may then contain a
>> reference to the appropriate serdes.
>
> On the h/w I've worked on, PCS was an additional block instantiated
> within the PHY, so it looked like one block to s/w. But that's been
> almost 10 years ago now.

Well, perhaps the line is not as clear as I made it seem above. The
PCS/PMA/PMD separation is mostly a logical one, so different platforms
divide up the work differently. In addition, the naming may not align
with ethernet's idea of what a PCS or PMA is. For example, on the
ZynqMP, the serdes (GTH) contains its own PCS and PMD (as shown on the
datasheet). However, these blocks both correspond to the PMA layer from
ethernet's POV. The ethernet PCS is a block controlled via registers
within the MAC's address space.

> If you do have 2 h/w blocks, one option is doing something like this:
>
> phys = <&pcs_phy>, <&sgmii_phy>;

Generally, PCSs don't export the same interface as PHYs (see e.g.
drivers/net/pcs and include/linux/phylink.h). IMO it would be an abuse
of the phys property to use it for a PCS as well.

> I'm okay with 'pcs-handle', but just want to make sure we're not using
> it where 'phys' would work.
>
>> The above model describes physical layers such as 1000BASE-X or
>> 10GBASE-X where the PCS/PMA/PMD is the last layer before the physical
>> medium. In that case, the PCS could be modeled as a traditional PHY.
>> However, when using (e.g.) SGMII, it is common for the "MDI" to be
>> SGMII, and for another PHY to convert to 1000BASE-T. To model this
>> correctly, the PCS/PMA/PMD layer must be considered independently from
>> the PHY which will ultimately convert the MII to the MDI.
>