From patchwork Fri Sep 13 13:15:05 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vladimir Oltean X-Patchwork-Id: 13803437 X-Patchwork-Delegate: kuba@kernel.org Received: from EUR02-DB5-obe.outbound.protection.outlook.com (mail-db5eur02on2074.outbound.protection.outlook.com [40.107.249.74]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DCBFA1DB54B; Fri, 13 Sep 2024 13:15:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.249.74 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726233345; cv=fail; b=JBfgdTWxQri38xsG1zh+eHtPUg1VPaZg0dXkBA/fTKvQQkl9j8JkLZDy/hQIO+hibFAgxsLw7FRhjakFVPE83x18+6briGPILU9aeFuFY6svVuuFPLNo/6x+cdx7wl96/6Ywhnovrk+qb97F+czqHH7YXb8CjwuJstWZJwH7FSw= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726233345; c=relaxed/simple; bh=6ic6d9dfmb7+QNHTOnBonp71/ao7ZJxf7ZqSMwZmw6I=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: Content-Type:MIME-Version; b=s4nwt0X/mnNblo7nyEKFNlthfnpFmZoNIC4IKafH+vKxteh2Sw7nyNReCsSure8RP7XGb5iHH+ggC4ddB5JACAzSPgiM41AYafQRbf19nGsNbRnW1WjlNKkBVjSUqEdAAWAVH8lz0DjaNgV5yE4N5sYfLbcrSq25PWfh29c5PKA= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com; spf=pass smtp.mailfrom=nxp.com; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b=fvBIeWAK; arc=fail smtp.client-ip=40.107.249.74 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=nxp.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b="fvBIeWAK" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=BfXIqzswSlccr6nc/rbd7rDtj1csvxVEOGjL6qykJy3h03DwpQmGLfikdGZdPP250yO1UC3R22dtQNgE/1UKIBOc5dY05gMWYClxnzWIEKNilQrdnf2lE08LM/TeiFaQp66Rull13nBaUMBVPmJgkfh0A8ZQ5kRw62B+ZSGA2zvWoKFvWN6FjgAcDEJYOVV76/hO/z9muHurTCta32zUrgfPPBiNbH1Ww6w0KMyK5NMsgIRncQ/XkKjmENsf3kggmS8NZBekgEeaF6TpKASP1hwjT6iUz9/Hyau+1cQGzdF1PYjySfTUVjNJj20bJVvNjx13PjOLo3MdQy6dptWMbg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=3lUuomDFyLmNbtceRJ6dWGdAT6VpTQI2dbWJv3mHiBM=; b=v0l6xLZ+LObG+tAECOWImpW5feU2h2mR08Uof4CeKVzuoi0WWr72+lJQWTTFzDTLTEl5rQB1EqT9XRBZlYn/iaKimTWSRd+Qo4uYUF/OQ//vhKUtkbqz5XE3QWzKg17JwZmGUYF44jtYxlCHFnwZMILxqmMTrrvL+Iza3w4yPI75+nP8Wssc3VgjQ566WJjwm5VlUE4N913JyCU2it1MNcOo6oiA+oXtI0LOYAhdQrZOzZkv90UoHvZgzlkbasZyQty7R6wGjid4VkArKHZlGDg2ekMy3TVNcbDhbbCjZpU3Pi2sz+V/j8ci3PxmwzcHyZc7GoxOWjtDwtH4InH6pQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3lUuomDFyLmNbtceRJ6dWGdAT6VpTQI2dbWJv3mHiBM=; b=fvBIeWAKHHqLg6zkP9FblvtzGmTfQ0gd933Q5iwy1qZJvlz8QTTvWsGAuzir9jOkr8uVA/SPTxsQdK9/0dDYlyM/3zALH8vl+sFjFNv8lfLDVVsbzhIPk9I2jBjvuoJckf209l1z30aYda+wCf4BuQkPu5aj75PRg5fTRT+zF7LbPpFA9OOAUmRQ5vFigS5QXHbT67gvNjegCF4c4Iw17TvsB4Ddt+PpElGog3Kbaxpgh12/lBE5kQY1SDxGpmV4MAeQ3PedXrcfU+UpBSEfAG0ju3fh1L6UY698adwZy1iK+P9lhFwG4pitRVrmM8Wu/U6kIiHJUeowqs8FMDDynQ== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM8PR04MB7779.eurprd04.prod.outlook.com (2603:10a6:20b:24b::14) by PA4PR04MB7519.eurprd04.prod.outlook.com (2603:10a6:102:f3::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7962.17; Fri, 13 Sep 2024 13:15:38 +0000 Received: from AM8PR04MB7779.eurprd04.prod.outlook.com ([fe80::7417:d17f:8d97:44d2]) by AM8PR04MB7779.eurprd04.prod.outlook.com ([fe80::7417:d17f:8d97:44d2%3]) with mapi id 15.20.7962.017; Fri, 13 Sep 2024 13:15:38 +0000 From: Vladimir Oltean To: netdev@vger.kernel.org Cc: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Andrew Lunn , Florian Fainelli , Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH net-next 2/4] dt-bindings: net: dsa: the adjacent DSA port must appear first in "link" property Date: Fri, 13 Sep 2024 16:15:05 +0300 Message-Id: <20240913131507.2760966-3-vladimir.oltean@nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240913131507.2760966-1-vladimir.oltean@nxp.com> References: <20240913131507.2760966-1-vladimir.oltean@nxp.com> X-ClientProxiedBy: BE1P281CA0119.DEUP281.PROD.OUTLOOK.COM (2603:10a6:b10:7b::12) To AM8PR04MB7779.eurprd04.prod.outlook.com (2603:10a6:20b:24b::14) Precedence: bulk X-Mailing-List: netdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM8PR04MB7779:EE_|PA4PR04MB7519:EE_ X-MS-Office365-Filtering-Correlation-Id: 6eb24c48-91ca-43ee-b56a-08dcd3f628ed X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|7416014|52116014|1800799024|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: WLkTQfqNxR4iuLvvXjMsnZD637qkm01I+VwBCBDotGA9rSSUrkq1Fqf004LnKdij6656y/TOSTURm/kyN8PrYAnynlnExqqF3NFxRvR95ggffzns/EuV8gM7Vcbh5uJa1Igwqej6cQ3t/ez8Pq1ZxBIKWOvQwB01VDOxwrDtgSOcOfEurP2vvtfwmI35Umwd8E1AjhfaCiw1Dr9+KaWXRaq4fO7/XE6G/wwgo3xKJUsC6eq39JVkzIqZ1pNtnIfSkXbOBsEfq5YC+k9Qj7QdWmY2rBrcnA7dLnzonP9E7URTElpMmqX1vu1nKb4zaAq47DTaTHLSAq/PgGxYchdhLpZytYnJgKT8YBgyVULx/JFPR9YBxLIAMomAJap1onZtj8xkPDUupNV8pnU0+RoyxFhRZaWTh4uf3NNYfHyepkKpDha3yViqYlEQVOdMKlmmJ2XL1Y+kkwsB5OrN9HGoBTEbOjD96KEjycy/jWSBkgCvN11wrtTItsrIQEGwaVw8JQMWFk6XLN/nW5jIYyV0aG3qzOyWLVYuZS4MFwTT08wsNixWHf+BgfzYnH31c6R678GLIp7JP1Apb014YGH4nV+EN9+/rC6eUHsrZO7zot4BEYDBUCRoKYxA2MMP9bymakbETMmVaio1wR1MB5JZgqfr9tJ9Bctk8QqZebMvrcXcDPEb11Vpm9R0X+5ISWQnqs2Ol4AITcanLYKgyAvjUUoeMyOwu/4c2gl8vpsTIdUidNObuiVEVwEinxV6ZCy4cx/i2yjmjPjHBzDUc4h410uzuK4US8y1G7yjAXxNb6wdfHlRUqR24mTbC8Ih2uIF7/t5aRVaVB757r8Tzo2mFhqYcvqQz4j9jZ5ZRr+G+QSXNUiFDvllOhj2I2WLAhDMZFAEqau/zFeQE2wAP0mQKKLYC85Vnw2LtSmwwGrgpPfRM6apo7BYp3OzYw7aVchk/GOSEED8r0HDIWftU6UbSK24O295TqFPM71f20ZInHpmDDSz5g/Cqa4+YZ2zY6hjcVbEOhmFmgLTTTC6EvtuYHo3/mx/2vi5S1akkkgvW2WxRFxELhP5nanB/LHPfjs6teI6ahh3YCMe7IZ257dWuHSTmVcZKi/bPojtgfXCfJKq4xAsahpdbIsH03cUVVjeHjQckz+abu7Pia0YuWiHTsCkItx3ijQi/fAOgARvsZrAB2IvHgLvzQ6wSnKrC2TDrQGMo7J2iJ9oCpovwtAU9aHTTQX8OXxiXVDaheVfs6zoECNRcL75+Ch7oK6z8xhBkxFNP2OgE47tVWGmtUXMfOUP4a0ev7lCjSqZlgWnufizwpAnAXmAmzRKQOWRqNxhiZYjNLezr90HJYVUgToga4iKGjqIp1XWoXPb7yCOdrT2Vn1T8XBGA27FvBPa8NsoJY0TA1dXv9FVpqfCyBNQvg== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM8PR04MB7779.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(7416014)(52116014)(1800799024)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: On5wRgqgf0yD0vLsmN4hTU02bh+Yjw9E3ReCvApXpbM2cyTu4rfvEop1Y0vHGxvhSOngcNq5g2Bh0wF+GzlNZR+4f0Z4sasMyHDt1Hnz09D5Z1gbs0XaM/R0fKUAA8ZUohZDIwnGfFeFrF4vw27b0eCjT5euPGxhLmp2ZDdaliR0nJBUts+hQpEIF7lruFy3b89DVIjLSCqELJdf5XVtGfqDUT5uzhS4yXfyO7iowBjIZG3Kg+UTFRQ55LfmiBx9214Ow6tuoVtUGn+6XMRqnqsYaU3q0S1sPCONl+n+Dqaxk4TXe+J4Pd59CxSpCvYSjP3P52MKC+9aPw/CAlTWaf7rcuH8+VHJUFiPfvCEXK7fPEhaHWfGayuXLgRBgFYgoBwx+ITdRTzfEgR0j5wtRYhbMP3H+OMYWj6PXW15zMn7fyfzOEifVx/8rGr3uGaw51l6ka9qLZ6pLezrTNd/phTMW20QUsAdA9C3HzfNWQVll4TlH5liN1elPvznW2/NBI73PMzFuHx8mkuWFQpflGF5VZ29KugEYRPtT/m067DIDMv9jhF4HVJ353ye6R24Lk17D6ajPo/Los6OVwHFMqRUbHsMcvp6WiVIgbPIesFpfyrV2qdkozQgY8ktkViJ4jp5864KwVe6KIrsnGKgmMxylpjYS6tjhe0X+qVAyLMv4ESFEBSesuIwMY3giTf9/mnSOxjwoDdpfETlhxCDQFvDZrgC3HJ/YBjkCpYh99SUjSodf0ELe1AhDv/NOc8oeTa2+ECvkmGYE+i8UqmsfKviLYYBb3DUu+HZtXeHv4YbW9gDuYUdd+ZlAOYp7Kv13A3l9QuubiQt/8bujv1aUEyXuV2fC9/abD0I6Zj8xN0UR0AgYmSrsRdGrv4lWWe/KC+is9RlIMTr0Txtz31i9Vf1MgriFScA7O2+6o+9W7TsmNFoH0pNCzrDXz3FvXRD/7ti8mO6fltBXvwJYwf1kimUkChsesGxgs8Q4bPtC+Ri+yAQr33/F5Zj27dD9iRcYZVK/8lKxhjM+YeXlIGAu5Fu9Uh9JIs8r1XpaOrN+f955UOoZrm2keLsc3s7u3EzgNrBoP1hbq4XqTuSqtICQoRvG+HgIpW0qwnhZ95DiEXK4kmKVndZwqXizI/5SZbWZoGlT82xZ6mmkoUMWoxzeEl2qYI16p2Ss+nBP/YRyfYEG5RfKll7l9ESlakM3HrBFEC/nMSHFmc8mTIWo+hG3Kc3YG8hIlFa5nqCbBXniMk6Ye9P8CLAldxCxjmJF61nysOf6haw/wL4yRMlYZY3GWsjkSzisuyPoSjm3/5VE9C8SLkB/lbWRdUAkKeL2XItGkFDjDFsP6zxLcEax25AhGu7XNmNwpT+/i5f5BUR9uE50Sa2WOmxdEHjczoBxoUlE+l1iYT55TM5llS8jwdsKaz1pxGzBdBD//mKp3eW+g30mcBDQeFCXg0t7TV4ER0kgAkQcDVV9vqdiTYAz7LMiiAo8k23AVT4NakOnMlswI4lju4Z0MetwWV9uduQpJCeWrFzKcCUYBGlusXLajbDEAyBWAbYxqgYTXdgzd95GEPZ5pnYoQvqVUT4w9HXaEM/9jxS6jvySv5vq7uzi6etOg== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6eb24c48-91ca-43ee-b56a-08dcd3f628ed X-MS-Exchange-CrossTenant-AuthSource: AM8PR04MB7779.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Sep 2024 13:15:38.2953 (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: R/BjQFNPL2pbY29u7dgF2H+AFWYCngGU/EcMAe+XnDXdNiM4ARhLVQiCTqoEW9fb/NuQInWoBWrZDF5kCfbZAQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR04MB7519 X-Patchwork-Delegate: kuba@kernel.org If we don't add something along these lines, it is absolutely impossible to know, for trees with 3 or more switches, which links represent direct connections and which don't. I've studied existing mainline device trees, and it seems that the rule has been respected thus far. I've actually tested such a 3-switch setup with the Turris MOX. Signed-off-by: Vladimir Oltean --- Documentation/devicetree/bindings/net/dsa/dsa-port.yaml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml index 480120469953..307c61aadcbc 100644 --- a/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml +++ b/Documentation/devicetree/bindings/net/dsa/dsa-port.yaml @@ -31,10 +31,11 @@ properties: link: description: - Should be a list of phandles to other switch's DSA port. This - port is used as the outgoing port towards the phandle ports. The - full routing information must be given, not just the one hop - routes to neighbouring switches + Should be a list of phandles to other switch's DSA port. This port is + used as the outgoing port towards the phandle ports. In case of trees + with more than 2 switches, the full routing information must be given. + The first element of the list must be the directly connected DSA port + of the adjacent switch. $ref: /schemas/types.yaml#/definitions/phandle-array items: maxItems: 1