Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) client-ip=2620:137:e000::3:8;
From:   Vladimir Oltean <vladimir.oltean@nxp.com>
To:     netdev@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org, linux-phy@lists.infradead.org
Cc:     "Russell King (Oracle)" <rmk+kernel@armlinux.org.uk>,
        Heiner Kallweit <hkallweit1@gmail.com>,
        Andrew Lunn <andrew@lunn.ch>,
        Florian Fainelli <f.fainelli@gmail.com>,
        Madalin Bucur <madalin.bucur@nxp.com>,
        Ioana Ciornei <ioana.ciornei@nxp.com>,
        Camelia Groza <camelia.groza@nxp.com>,
        Li Yang <leoyang.li@nxp.com>, Rob Herring <robh+dt@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Conor Dooley <conor@kernel.org>,
        Sean Anderson <sean.anderson@seco.com>,
        Maxime Chevallier <maxime.chevallier@bootlin.com>,
        Vinod Koul <vkoul@kernel.org>,
        Kishon Vijay Abraham I <kishon@kernel.org>
Subject: [RFC PATCH v2 net-next 13/15] dt-bindings: lynx-pcs: add properties for backplane mode
Date:   Sat, 23 Sep 2023 16:49:02 +0300
Message-Id: <20230923134904.3627402-14-vladimir.oltean@nxp.com>
In-Reply-To: <20230923134904.3627402-1-vladimir.oltean@nxp.com>
References: <20230923134904.3627402-1-vladimir.oltean@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?n3i9mO7TWwLSbaP7T64TxWT/uNIVNDHyIrJvU2/lEzGJBRgbWlE2BNN+nQyy?=
 =?us-ascii?Q?8dgIb6jgk6nLSpr/McQx8SWYYE3jtJNAQNKJy/buMLTTaN1TuVuSMJJY2FPX?=
 =?us-ascii?Q?bGAiXLgn3GSB0O5aGL3SOcjaQJAGU4lzyokqqfMToUk1iSbtXfnSdCcdgmUu?=
 =?us-ascii?Q?cLF+3z5bWel0I+B3KZDmRZ4Ajrv9nZfDg0wWwqQ40gmi1uEHGpjNVcfQbVfo?=
 =?us-ascii?Q?FftUpmhY+kKGcgZBHe/eQU1KdC5uaX/HTud02I1zcRAbvo6T9vo72bdBth7P?=
 =?us-ascii?Q?AmkrieEK4P3BQeA0/vX9kk8kv4RFeqwFCjDgC+uSXJLMhfkoOML5XZrwg7VY?=
 =?us-ascii?Q?ba2sgrt/rFwVwyc9+7fiqz3hpkBVPqWdHQHr5FntsbzWDHYhpqOVp2iT1c6j?=
 =?us-ascii?Q?u4CDk75EO/PmvgyFROtYeu35tlay6fyMy+04toFABU96J/xXlpgD//z/KToT?=
 =?us-ascii?Q?kDcOlD1yumEoR9c3I0Bax0cc5bijF40ln5Pq/1zT/udtMistTdO9mSui/P6e?=
 =?us-ascii?Q?DKNRne6+IoSLJAoHdZoVbrMQwKbFUtw2OXtRYZjKxInbuJdI0JQVAIjAPUw3?=
 =?us-ascii?Q?d6+oXxDlwAVJ2SRf4OAm3D8RvAP0sLW+iH1GZUEvWlxf9xpf4Ja6URhXiD8X?=
 =?us-ascii?Q?wEGOM/oADksdK1FxgYuqtan+U+zYANDRiTmPh8aaZP6sbgJUzmMtkO2eQu81?=
 =?us-ascii?Q?BrQiiMAQLqT8xI/qPd063/BU/xHGULp/LYDkBpA7rbbNXeGLgNT5NRjivdSR?=
 =?us-ascii?Q?oWzxbAX27YOZlu9I7I6AHlqkDBvRAvYPnMc+Izsry5mzkBnt9Kzj5DiqEEkG?=
 =?us-ascii?Q?pnB6qhv1UdynyJkwsho8/sElWaRVEodGuLN+MIJVuuJiTkSI9yCd89e37108?=
 =?us-ascii?Q?946xU5qSFu/8plGndTqBNKRllNB/1DuKsatRQjSYxGczPwiTizgqbTAOPlPl?=
 =?us-ascii?Q?Z3CgXj3MFBvg5ehBp8iGedO40zai7E8KfzcMG6ltRKBa2cDHbq141YD0Sj1n?=
 =?us-ascii?Q?rCB2dvMEk1nElu5e8iXtflZJ/rQ9NkI1IsabI25xE5XTeEAuQx+YPAl8oomu?=
 =?us-ascii?Q?ags3d8RtY5gt7w5jH4vHQ5K3IZyiEfToylgxFFsdFa+HStjy0zz3MXGE7rpR?=
 =?us-ascii?Q?sdUcdvlwvbTJVMSxMCnrd1BaV33w+PHL9nDjI3j7h09AxRQjHeXbIVgCLW1r?=
 =?us-ascii?Q?CH0cHXtBfdCKt4dbD1AKSmBns3PZ2IRJvvchmX+0wB1qq/3rEOSP7gMJiPWb?=
 =?us-ascii?Q?Tg2K0KeCJYCMI68z170zycBgemkzoumNbh43bVl2Bpt8tUEFfpcZq+dQzNQZ?=
 =?us-ascii?Q?+n41c3BNKYfrlYZ22NC0Fkjywdj5FJb/XbqwlcaD6hRZ4m9DXDqgp+jxpSj6?=
 =?us-ascii?Q?oydglYLE9msXaiGJb3XO22G81WOj7JDfZqLcx70X0EJOcO9NIO5Xf91lMy7I?=
 =?us-ascii?Q?aS3q4JYKQeUeHfzF0KFsgCM82QMw66ox9ku5mtCDwkCHP08SSKXnoX1qsXq+?=
 =?us-ascii?Q?QGwIRkmFZnKTdRDk3ReEv7zgtLeOhEAg8QCC22gc5jkHKKMxGJ9UQfUwlR/n?=
 =?us-ascii?Q?Cxc0pyROUhvNqfzbe+zJ65pGydq433HcZWWrr1NNyJn/kkmTRmNxoUPqqLkg?=
 =?us-ascii?Q?XQ=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: e134f390-c707-42cc-1f27-08dbbc3bed8f
X-MS-Exchange-CrossTenant-AuthSource: AM0PR04MB6452.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Sep 2023 13:49:37.9078
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: UxaszYWSVU2ol8Cq02t1IM8sNXAt1sDO2MlaFIRxgkB44K0kwVGaFs/zy6psE+U1d4er/GUWwpD1K3XRVbS2jQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS1PR04MB9454
X-Spam-Status: No, score=2.7 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,
	RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no
	version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Sat, 23 Sep 2023 06:50:35 -0700 (PDT)
X-Spam-Level: **

When the Lynx PCS is deployed on a copper backplane link, it must be
prepared to handle clause 73 autoneg and clause 72 link training, which
it can do using a dedicated AN/LT block. The latter doesn't need to be
described in the device tree, because it is discoverable from the SerDes
lanes.

The media type that is deployed on the link is not discoverable though,
so the introduction of a fsl,backplane-mode boolean property appears
necessary to determine whether the AN/LT block should be employed, or
left bypassed.

Signed-off-by: Vladimir Oltean <vladimir.oltean@nxp.com>
---
v1->v2: patch is new

 .../devicetree/bindings/net/pcs/fsl,lynx-pcs.yaml | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/net/pcs/fsl,lynx-pcs.yaml b/Documentation/devicetree/bindings/net/pcs/fsl,lynx-pcs.yaml
index fbedf696c555..40fbcd80ee2a 100644
--- a/Documentation/devicetree/bindings/net/pcs/fsl,lynx-pcs.yaml
+++ b/Documentation/devicetree/bindings/net/pcs/fsl,lynx-pcs.yaml
@@ -16,11 +16,24 @@ description: |
 
 properties:
   compatible:
-    const: fsl,lynx-pcs
+    enum:
+      - fsl,lx2160a-lynx-pcs
+      - fsl,lynx-pcs
 
   reg:
     maxItems: 1
 
+  phys:
+    maxItems: 4
+    description:
+      phandle for the SerDes lanes that act as PMA/PMD layer when the PCS is
+      part of a copper backplane PHY.
+
+  fsl,backplane-mode:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description:
+      Indicates that the PCS is deployed over a copper backplane link.
+
 required:
   - compatible
   - reg
-- 
2.34.1