From patchwork Tue Jan 3 05:13:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Colin Foster X-Patchwork-Id: 13087162 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id CDE64C53210 for ; Tue, 3 Jan 2023 05:14:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236671AbjACFOW (ORCPT ); Tue, 3 Jan 2023 00:14:22 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43224 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230159AbjACFOV (ORCPT ); Tue, 3 Jan 2023 00:14:21 -0500 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2108.outbound.protection.outlook.com [40.107.93.108]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E6262B869; Mon, 2 Jan 2023 21:14:17 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MtxGf2atddvU1S/U9s67wSsdVFvg/A2LqxIDiz5v4SpPB8rNP9rPhChNSdVts/ulc1AeJr42UZUH56pjfrUAP/9voUOnuNoMf5RbIQOugChzeaynmE7QVT0x3AkgJVYRO+wmHDYZRG6CDOuSn5MED6yllXE1SFWAGT6YJaGoIEGlVokJ2SoDDgsgQyqv4V/QK0NqRhH4DeGcj38nLOBj+BL/FWN0pvFzqA8AhpQU0h503ndMG2juKvU2mEddnzHTsLVKkdjK35BtKdOvk0vdSEqK2VlsDAKNTIxJKkgANlY3Hvz8d+4sxGsO54oSRR2joTim2pl5y+5XLRO3UZrcmA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=0FooWDq6tpnap13ItYOSXnBKJcASDQ7lbmf78/BGReM=; b=guvOSDYjWMvA6bIY14wuQ5DJQ6AxPFbpnczOSgzwFv9T9i0NaPEhdP3YVnoRmblkJixgfRFii7i+QArWcckdp8uYRoE4gGDzN0psdKda6Y2TH3tnmSsBeYfekkoy21KR9ahspkHn+YH9NAUeznerQDTOF23sLofeJPorRQqNhuN7gsCzzTebQexUOdW9gRBdNsMfo/4IpUgEHhWDR5PZ1EPIk0BzebhGlzpKiS3DFQU7cehpF3PsVyJlDc/ttmO+hGBXZTwN5P3Wh9nLXw1huYH10p5Pda5wNC9nQBd8hNlXI7NJxr26xy+gdeYqfn9jjS9zVRLYXskqtnh4vgTtGA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=in-advantage.com; dmarc=pass action=none header.from=in-advantage.com; dkim=pass header.d=in-advantage.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=inadvantage.onmicrosoft.com; s=selector2-inadvantage-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=0FooWDq6tpnap13ItYOSXnBKJcASDQ7lbmf78/BGReM=; b=F523EI3Wo/di1OxdxM2bsTCnO8GQOxFl/9uDZSBgqh6RjOfRzep6eMkoZB6GiJQ+0xYRt371SX4QVocoj+yq0rbINpMqpzwVkrqV2/KEYls7mNy9I9zLyckPkf+hwoe4fAk0Tk9kQyQz8UgDO8nuGvM/aWyYfUyGJ11XE7Pn0qQ= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=in-advantage.com; Received: from MWHPR1001MB2351.namprd10.prod.outlook.com (2603:10b6:301:35::37) by SA1PR10MB5823.namprd10.prod.outlook.com (2603:10b6:806:235::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5944.19; Tue, 3 Jan 2023 05:14:15 +0000 Received: from MWHPR1001MB2351.namprd10.prod.outlook.com ([fe80::45b5:a860:9cea:a74c]) by MWHPR1001MB2351.namprd10.prod.outlook.com ([fe80::45b5:a860:9cea:a74c%4]) with mapi id 15.20.5944.019; Tue, 3 Jan 2023 05:14:14 +0000 From: Colin Foster To: linux-renesas-soc@vger.kernel.org, linux-mediatek@lists.infradead.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, netdev@vger.kernel.org Cc: John Crispin , Alexandre Belloni , Claudiu Manoil , Marek Vasut , Sean Wang , DENG Qingfang , Landen Chao , =?utf-8?b?bsOnIMOcTkFM?= , =?utf-8?b?Q2zDqW1lbnQg?= =?utf-8?b?TMOpZ2Vy?= , =?utf-8?q?Alvin_=C5=A0ipr?= =?utf-8?q?aga?= , Linus Walleij , UNGLinuxDriver@microchip.com, Woojung Huh , Matthias Brugger , Kurt Kanzenbach , Krzysztof Kozlowski , Rob Herring , Paolo Abeni , Jakub Kicinski , Eric Dumazet , "David S. Miller" , Vladimir Oltean , Florian Fainelli , Andrew Lunn , George McCollister Subject: [PATCH v6 net-next 00/10] dt-binding preparation for ocelot switches Date: Mon, 2 Jan 2023 21:13:51 -0800 Message-Id: <20230103051401.2265961-1-colin.foster@in-advantage.com> X-Mailer: git-send-email 2.25.1 X-ClientProxiedBy: SJ0PR13CA0057.namprd13.prod.outlook.com (2603:10b6:a03:2c2::32) To MWHPR1001MB2351.namprd10.prod.outlook.com (2603:10b6:301:35::37) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2351:EE_|SA1PR10MB5823:EE_ X-MS-Office365-Filtering-Correlation-Id: 8836967d-9a3f-4ebc-b13e-08daed495b29 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: cfz7koniny7/GllPSlzrjS4aVGGiiDRXvdFKA+NUgbZ4TajNaghuytzf0z5C9bWEQZH/+z+pSPzuufn0JGO60kkKY3FMVEHusFFgY7nVuA5ydmsq8BtS5Kkle8ztHPf7R6I5PW2/KnsvexEJpzkI/uPZsIEUU1Eck4TXqaAnPSAn7ESdEW78TDektoweAmC1i10Zrp9Rxs8KFNEVfIKsVIp4Yd18K+RUnmt+SjlaEtDAJ/vxuP+1jxbXis7FoSg1xXvVkJPkMF0XRyyJ074pnURH0YpqY5IRTY4MJNUgqyPTRV0AuSXKP6KxhyBd2mvUXIGLHQx4rS0X9ZY8/pUQ//H1TPRHgnHQHoNCDJzkUPIEUVQnF0R2Ao8+apbr+FktKAy5RpLV0GBaocCaUs8ewgZPg3AcCA++0uJcdfUxgPxXdbmLGZcwO7NbF9tDMgMD9q/tGETKz7zncHya6IeveVZPmWs0OCqh63eF4LzNXoRWvtw3uV3CDx9sqrqzYpDivV+0qCWu0P5cxRX+/7TUPdE4k6q4BOpkytMn2dnN5Uv5wAR8TcRbn54akMy2lqY/8GwrIylZhTec0DNrruromRxEDgyUexVlOv7B+8vMZ9b09T35+l2l9qaKP0UVTwrjnJ6fw4BOIt3B+N+0RET2JFcllyThOiJKkR3P6IRFeTnFtQhfF1YMJlOT9tZtt64FdF93cRRjzhnJI0uJF7cNkK+9vFXfsgYaVTAx52sNdwA= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:MWHPR1001MB2351.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(39830400003)(376002)(366004)(136003)(396003)(346002)(451199015)(54906003)(26005)(186003)(52116002)(6666004)(2616005)(66556008)(66476007)(6486002)(1076003)(316002)(66946007)(478600001)(6512007)(66899015)(4326008)(8936002)(8676002)(7416002)(83380400001)(5660300002)(41300700001)(7406005)(44832011)(2906002)(38100700002)(38350700002)(86362001)(6506007)(36756003)(22166006);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?p3wdzipco9kM3yxkMz+5xLWMMBNP?= =?utf-8?q?n0y95qekfVP6kUnDBTpF26oTu8vGrtcooxg+4SqvvyJ4DYLQLLynS/TTj5xQWojX+?= =?utf-8?q?SyuzZzGMLSWkya1R8qtdhD1m5tz98PenE7eVQpRNVJ386LbG+SZzJI++2TIF5VCto?= =?utf-8?q?BSXgKnK+6lY1SHDXk0aJldDQQKAJaYuv6MGEfC6Bop1bYQSRmhMjRrRkF2Mp1r2mP?= =?utf-8?q?YPuBRq8BBcqhzH7KT5sX6koNVqxGBWqeZdVQGheoS4C1M/MMZkoJhA9ofwiNCAmUP?= =?utf-8?q?cUVMQcqP3+XYrzZPLOxt6rcGegimXpS8gprSeXFGpAKSiCJXIq4nSfmMYn8H+ZeU6?= =?utf-8?q?j2kbvnpmcRroKIXBUTaX8BJ0ID2XescyXdKSaqVTXd4i84ic0RRpPbIJ4zW1aeCMi?= =?utf-8?q?ZkteZQJbOxCPErEKL4vbWenJI7UiBAeiRkszM96zRzSs3tlbw3CMMRRjK8LaJGqK0?= =?utf-8?q?7zIXWe1Lt/upPcALPd1kndLWarmZ3C8O7PDkmq+GIL5Hh0BS+yD/W08kpngeRLCaS?= =?utf-8?q?DJuU/65h4kwxyyPm+cW4Uh2synZv+YLV7iDmndsl0Wob0WopjAdM/z3juxW/x/BQh?= =?utf-8?q?SHl2c8ZU6wfyunpww085OLnxloRkdppfViwY9XwHxy8ei2T3gqD2sopvlzovOkARm?= =?utf-8?q?lS/EkPnQQECGxR2sV2rQPs3RmyujM/4NhzvX76z0VN8IpiPU16/GcF/RH/nJS9eT6?= =?utf-8?q?PhaAdzTew8f2I9Vn03+ZmeIsStRHFJ2A3MMhleCmm5sxpVxkA3mQkU3QRkUjfAuOO?= =?utf-8?q?1jNuWGKmHNd4UZ01TTIxVR3GHtzrWYtTllCRZvugqOjpPr3XLw3lZqnDFo1VPDS6S?= =?utf-8?q?HIzpKsoTARsPzza6h5ke3T8F3yNh4D1PSPas3G04KAitxlSznRoUjqR2ZJAdkCB3o?= =?utf-8?q?iIily4SqQuU561bdVtFrn1LkJ+vIMNkbf4Ut1d8k55GEQ3eyaxo1rB4f0MhdD+XCV?= =?utf-8?q?SuXisc6IpKVI5dA+tZHJd8BprKCKjM/Ykkm/fI1Gfw3phuXPs/+uQGcRX/xnyoDjV?= =?utf-8?q?Sn0cyjC8fK4lfnO+9bd2H8AfY3nmgUbZrVpWHKM+O3YNW2ApLcjf6rJM/vGbJOeGs?= =?utf-8?q?c3dOmjSy8Sf8Qj6sCZPYEL3sIrriJM1cgej/GS54TljWUrJ0Erqn9qxaWhDH6oObo?= =?utf-8?q?WxxQJ9UX7TINF+90KNfG7PAM7PjA6q/ZX79XCCsmPFni7hkIkjljGXVaKZ8l+oQz4?= =?utf-8?q?aIcfgvUtLw2Tm7IagtDBbK0D4XO2dNk2MbAs2wCkiKwgA6BU2k+Wbc1qcZoVWSuMh?= =?utf-8?q?6ZEMyrw8ZSX1QDTocfq/zqgATKc9ssnNWndS9hhoN4iTDqG1wTbS/DYKfQUYa+WqC?= =?utf-8?q?gKuQAbdUbbSIsDlQqTWXxtia5Nx84iAHcFTgoox28E1T8NwkcqJ3sWC0dVBxIm7C9?= =?utf-8?q?MfQx3Mm9FZ6+0OQ+rZ2UjXGiYnYgG6V5bXKCIFarLQqAAjrCaty1SEc2/bgVa95jJ?= =?utf-8?q?HEAy4rdsKYFsya3jgMDXJ4zECSLyZEhQPc0yt0YRzePbDcVWH+Dh38AJtF3z4RN2L?= =?utf-8?q?OZzpQ5sfKgySlXCzdfVC2uxVn02LqbB8dA=3D=3D?= X-OriginatorOrg: in-advantage.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8836967d-9a3f-4ebc-b13e-08daed495b29 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Jan 2023 05:14:14.6544 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 48e842ca-fbd8-4633-a79d-0c955a7d3aae X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: GCeRWpkLlAmGgzLjyGamhVO8dv8MXRBGgEduUojLgQmrP5CLDF6bi+qtwyDycNX0864T5Wc82jmaZeh8zMp7jpwZIenu0z6qrynWpr9ckX8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR10MB5823 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org X-Patchwork-Delegate: kuba@kernel.org Ocelot switches have the abilitiy to be used internally via memory-mapped IO or externally via SPI or PCIe. This brings up issues for documentation, where the same chip might be accessed internally in a switchdev manner, or externally in a DSA configuration. This patch set is perparation to bring DSA functionality to the VSC7512, utilizing as much as possible with an almost identical VSC7514 chip. This patch set changed quite a bit from v2, so I'll omit the background of how those sets came to be. Rob offered a lot of very useful guidance. My thanks. At the end of the day, with this patch set, there should be a framework to document Ocelot switches (and any switch) in scenarios where they can be controlled internally (ethernet-switch) or externally (dsa-switch). --- v5 -> v6 * Rebase so it applies to net-next cleanly. * No other changes - during the last submission round I said I'd submit v6 with a change to move $dsa-port.yaml to outside the allOf list. In retrospect that wasn't the right thing to do, because later in the patch series the $dsa-port.yaml is removed outright. So I believe the submission in v5 to keep "type: object" was correct. v4 -> v5 * Sync DSA maintainers with MAINTAINERS file (new patch 1) * Undo move of port description of mediatek,mt7530.yaml (patch 4) * Move removal of "^(ethernet-)?switch(@.*)?$" in dsa.yaml from patch 4 to patch 8 * Add more consistent capitalization in title lines and better Ethernet switch port description. (patch 8) v3 -> v4 * Renamed "base" to "ethernet-ports" to avoid confusion with the concept of a base class. * Squash ("dt-bindings: net: dsa: mediatek,mt7530: fix port description location") patch into ("dt-bindings: net: dsa: utilize base definitions for standard dsa switches") * Corrections to fix confusion about additonalProperties vs unevaluatedProperties. See specific patches for details. v2 -> v3 * Restructured everything to use a "base" iref for devices that don't have additional properties, and simply a "ref" for devices that do. * New patches to fix up brcm,sf2, qca8k, and mt7530 * Fix unevaluatedProperties errors from previous sets (see specific patches for more detail) * Removed redundant "Device Tree Binding" from titles, where applicable. v1 -> v2 * Two MFD patches were brought into the MFD tree, so are dropped * Add first patch 1/6 to allow DSA devices to add ports and port properties * Test qca8k against new dt-bindings and fix warnings. (patch 2/6) * Add tags (patch 3/6) * Fix vsc7514 refs and properties --- Colin Foster (10): dt-bindings: dsa: sync with maintainers dt-bindings: net: dsa: sf2: fix brcm,use-bcm-hdr documentation dt-bindings: net: dsa: qca8k: remove address-cells and size-cells from switch node dt-bindings: net: dsa: utilize base definitions for standard dsa switches dt-bindings: net: dsa: allow additional ethernet-port properties dt-bindings: net: dsa: qca8k: utilize shared dsa.yaml dt-bindings: net: dsa: mediatek,mt7530: remove unnecessary dsa-port reference dt-bindings: net: add generic ethernet-switch dt-bindings: net: add generic ethernet-switch-port binding dt-bindings: net: mscc,vsc7514-switch: utilize generic ethernet-switch.yaml .../bindings/net/dsa/arrow,xrs700x.yaml | 2 +- .../devicetree/bindings/net/dsa/brcm,b53.yaml | 2 +- .../devicetree/bindings/net/dsa/brcm,sf2.yaml | 15 +++-- .../devicetree/bindings/net/dsa/dsa-port.yaml | 29 ++------- .../devicetree/bindings/net/dsa/dsa.yaml | 49 +++++++-------- .../net/dsa/hirschmann,hellcreek.yaml | 2 +- .../bindings/net/dsa/mediatek,mt7530.yaml | 6 +- .../bindings/net/dsa/microchip,ksz.yaml | 2 +- .../bindings/net/dsa/microchip,lan937x.yaml | 2 +- .../bindings/net/dsa/mscc,ocelot.yaml | 2 +- .../bindings/net/dsa/nxp,sja1105.yaml | 2 +- .../devicetree/bindings/net/dsa/qca8k.yaml | 14 +---- .../devicetree/bindings/net/dsa/realtek.yaml | 2 +- .../bindings/net/dsa/renesas,rzn1-a5psw.yaml | 2 +- .../bindings/net/ethernet-switch-port.yaml | 25 ++++++++ .../bindings/net/ethernet-switch.yaml | 62 +++++++++++++++++++ .../bindings/net/mscc,vsc7514-switch.yaml | 31 +--------- MAINTAINERS | 2 + 18 files changed, 143 insertions(+), 108 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch-port.yaml create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch.yaml