From patchwork Sun Nov 27 22:47:24 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Colin Foster X-Patchwork-Id: 13056900 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 9BD08C47088 for ; Sun, 27 Nov 2022 22:48:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version: Content-Transfer-Encoding:Content-Type:Message-Id:Date:Subject:Cc:To:From: Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender :Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=bWqmAsxGEqCHpnf5VYOCyVMh+tFsVdWiQUD69klJ4yM=; b=cJe2u3uXtX9PhG1B8hcpWkdI+I K4pBmIs3yMdjPnYHG8ZIuhUHlSCP3W2sOgHxC9aCyTa2vFRIhUGxWk49kRPzPl2wVMlU+dBCWdgpC IpTO89+morxvNEHOAGli3Nw0gm0ndYbRAj7zFFIYCp9ArucYwuTwjFXD6YK7gb8+dHdFKOj//7aY6 mN5/qMhwQwwFmalbQkm+vCe32JPBYl9UxYWk5IIS8NePmY6k8XjlEBGna2aVoVRIZ0SQ12ARpEw+t o7Xi5tJ+mn8kDM9wNh2hWQWTlyCS0WoKtcgDKkotzOaM1kDmvahELqMakbrJlOQ+VAIy6+whRGz+O z7c02dTg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1ozQRX-00E0mg-J0; Sun, 27 Nov 2022 22:48:11 +0000 Received: from mail-mw2nam10on2072c.outbound.protection.outlook.com ([2a01:111:f400:7e89::72c] helo=NAM10-MW2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1ozQRG-00E0cz-Ra; Sun, 27 Nov 2022 22:47:58 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OqsDrH3CK+CCLyjDxDQ5GHZjKskl33SKwRgFtVNtxm0HlXpFHa9EKi/n2zHGgGuDT9dA5ZcQdEsEOM47/CsNi0H2OzKzpDFMqKq4GjP/rj+RbWuCNwlWGiGJeUeVsXoopVeb+Llmqeq86CbZU4ABy8pRAkm2/UrowYTpRaGaq8XVgNaJ+gE+TBpJIro59VVfUNMIaXjh79DNcNk8ZmlvmfGzPTNqWXuYwxqwgeXZvgGTbcagayuIyBaS+DzO5hgbLdf0TL85/ouHKwA2YyURX7Nvf/2UYIkODbX/Y1oK5Yu8WG//ns/hr3bU1youBVlrx0ZR/yN7KedmK+7FBf/UnQ== 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=bWqmAsxGEqCHpnf5VYOCyVMh+tFsVdWiQUD69klJ4yM=; b=LHi4aqxlSBtcK3e+lYR5IHQxmfxWgXiu3ciXlynHzIt1gzv48DNxm0KGCteXFCbJlle3p7xSFwKot5Lne1jhYZTdMK0WTSfObdh0hKIFpyOUcO13k/geT9NI6DqRy5K4ntoT6/niX1l/x99O+62KYeelVZJswmByujlQZLT9JFLksARgSMTL9oYPdnsrH2r4Ad1bjzP2aevRrpo/QTMmBOUPTkxtD63NByWegczpUa22lpxWME+8EnuBxc2VHqDoP6gUAzIYtzaPsMoZ0a/GMZkz8DC9EX9elHoy3VHr24Q5Y+1CZ/1jOUh2qBoc63Uy4ZlGNZ7hsfP/sH0onGA/cQ== 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=bWqmAsxGEqCHpnf5VYOCyVMh+tFsVdWiQUD69klJ4yM=; b=AZ67X7p0haHyHYVODn/MH05UJh2C1STi+6Vn86/N54kSikuUpqqiFZ6UaNUV2hxjv332COzccSBZzPrtoA1TogvDH72541saaJbHR8fmzXk6glyukj/j/3X4nLqmDhSgSrAgtrwK0CdP/Bzvj+yOgAGPFN/C66cN6M0z6pP1q2Y= 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 BN0PR10MB4998.namprd10.prod.outlook.com (2603:10b6:408:120::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5857.22; Sun, 27 Nov 2022 22:47:46 +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.5857.022; Sun, 27 Nov 2022 22:47:46 +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?= , Vivien Didelot , =?utf-8?b?Q2zDqW1lbnQgTMOpZ2Vy?= , =?utf-8?q?Alv?= =?utf-8?q?in_=C5=A0ipraga?= , 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 v3 net-next 00/10] dt-binding preparation for ocelot switches Date: Sun, 27 Nov 2022 14:47:24 -0800 Message-Id: <20221127224734.885526-1-colin.foster@in-advantage.com> X-Mailer: git-send-email 2.25.1 X-ClientProxiedBy: SJ0PR05CA0027.namprd05.prod.outlook.com (2603:10b6:a03:33b::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_|BN0PR10MB4998:EE_ X-MS-Office365-Filtering-Correlation-Id: 0207d6c2-2448-4bb3-85ed-08dad0c966f6 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 2wvTFUzjNytosAcIieJlJiROOmsfrn0OtCUjQMHzW6Y8t6QS+n3t7B7/rg9aDKqIxqe6AKJucIqEaSS9hYb7sQYBZMzkuNqNj38VB9x2JBoOS+WVlCXTqwh9lbOTb9fCv3snnoX50tEry8BhMsnv3M+ziqVhu/RqHTG05XDKQWLdRDyLi6dvKKV5q/vEBaGLqORRmK0EE3RwdurQ6fkfpVASMsuu1A7BMJIVVT7R2VqptAwG9/K52/3gLPGc1oF+xrOqmJBwwK3xRRULsKUHSxJJJMjioV7ayqqOV3zT47K+PtzUosTDGzDMgYUVx1DEMNqu1hY7+Lkv39DU/fWG9d8Evf5BoBDaMudh+LLMrmqyQIoOsmPfVZGepFCQDTHJavxKJ+MVNF/Z5DxBb95br5QiaiRmrLC9R/JEWr4Fum++hb1P8buUd4LqaSxusmlEnyaikIHcXbWQ001BcCMHeEQwXEw4k5i6ltI8qHUPl9qcE361jSr2IR89EC3WrTIqgk8t7bhQwIj+x4o5mlZxZW5pTMtH2DiqFQoAp1xQ91JsVqefADRcO3xG/VrKow0BYdaipUBEkmWSIfSTDGq8adH1DPMFp/XccXHgCgvjsj3b64q5WMPU6JKxlDUgEICPZxLuE/ve9hcGbJDi0ywChTrnlmvkSsCZ8GckT91Qxq4HdX5Lws1/fmU2luhlvZqNmaKGkyFUnjXk1t2I5o+7pUs0YZsIduXDOsZNKYoSe0E= 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)(136003)(396003)(39830400003)(376002)(346002)(366004)(451199015)(6506007)(2906002)(36756003)(86362001)(7416002)(7406005)(966005)(6486002)(478600001)(52116002)(53546011)(316002)(66946007)(66556008)(66476007)(6666004)(41300700001)(4326008)(5660300002)(8936002)(54906003)(8676002)(44832011)(38100700002)(38350700002)(2616005)(26005)(186003)(1076003)(83380400001)(6512007)(66899015);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?L+xN+SsB55FS2lY6Cp7IcO2u3+Oz?= =?utf-8?q?xmglTJ6fXXfFKi+Z7aZbhT4qEd1yfWEtJjY72eRCFJG0NEEMhB14pj0o5/HrXPy/c?= =?utf-8?q?i5TIPsAuhtU3EzYK3lmcwAfO1sJyn/w02goiRDgwIxMFlcVB3O12LzHTm4vgrIS3B?= =?utf-8?q?3v5YUimFC2yjcThqa/KHjLFXoEGgBqJuqQjkt56tXOV2n9t8PAG6g94sJygixIF/l?= =?utf-8?q?jM/g5E0HLxvO0nxuldETf3FoGdpD4Lu+42P89Zsn4HwbC4M4F6gkIbC3tRtRZjCPS?= =?utf-8?q?0hRU8JH9X0wiHsqajGtc4h7740iEh7xffNd+iABTFujTyFh+GvVGpYXLw4qkmrSYn?= =?utf-8?q?yPKMFkxdCmWoA/QdE5oHGtBtidVZejxhr6jj+kDYMQZf7nM0QoB2Fmq3oPz9ZZU5w?= =?utf-8?q?891wwBzxD0fA9FELRMjRA6HZ4dfcpoyEZjrYtOqhZ+/ofKP9qg7g9pD3SykqiwxnB?= =?utf-8?q?1zLe9sHeJnDGj/aVLzVYs5LOVygRkThpaNuBrqvsQE6pihozVUPgnY0QkQSjvT+cp?= =?utf-8?q?hudRLLsa91EalDB09+kalxMhA+RSwPftlIjQT6yO54L9161fgYfhRahrGTjgE4P3h?= =?utf-8?q?No0k1juGNxH4lytJiswBHKVV6bX1M+b44nmvv411RI5DC1xMwErp7cyQYvrZuDceH?= =?utf-8?q?oNN1Gi7ht5W7SjDZDlR+vjtBY4pXSN9SHz9faVJp+WQRu1cWrnMGCZeos8zcwzmhq?= =?utf-8?q?1OWCWRoQf6fgCuBtihg5MC2Aq/D6q90o6zJTGLhSs1gQJaZsae+lSZK50p+8M3Aaf?= =?utf-8?q?8aCryBxFLD5n33fvLalf5nZdlEc6RntdulEVxdYQLsxHPNguFsJUbWq8Hr5ktbfZr?= =?utf-8?q?i5F7iwB5pnRzPUjcc/GeX+iJvShoQyrFG/mSrWOKssyhFeNo9ACl/8YKxJjvx9cxA?= =?utf-8?q?QaF3MyZYd5jdwmH5NV5C5Jm8qhN224QE8cpciRi7KCnYmuvlQFINGGbVh+I9zb/1w?= =?utf-8?q?kSlteHS+TIeyZQwUM/bRHuUk+q/JJh26jvwFxghAOEJDAusdJ3Odxh7+AGh5hiRFO?= =?utf-8?q?7kgXWgENZnG1UW4tKs8cXMYcHxTz5o8GZzF5FYwYeDQaZJDaQ+dsKouLmseJD4rSt?= =?utf-8?q?mNNi0qbmihpOtedim8S1tqnTJ8jme8IEUxyW38h9pMT7wTbW6bzbZyLmilu9FLHG1?= =?utf-8?q?YnJjFDGw+pbQ3+V0ER32OMJF0/XYWxMwF9VTfAp9w0EnQ71T5k1xAgGns3DSIag7O?= =?utf-8?q?PaWttnm4+j5pfcFcL1D5Cn5Fvo47FNfM0v1sbMa7cLSdnY4eTQRyC/u0tydjglC70?= =?utf-8?q?PDX/G+bXWjxiyVdMjrlPVzdYE7LcuqqeR6xIS6EmbiiGSf52zoYsLCMNkgVzXMkRu?= =?utf-8?q?Dojbi2jJYWxgZ9+Wz6OwZ5ti1QD2JccyWW0By9kqpg/+8c2lAgsjCqnbH0Fu8C9cI?= =?utf-8?q?xYiVH+mjm6vtPhw/x8G6hYyukBj+dy/SIj2VXJY8Cty45L+2XLL1LGI8IjyNSrIfC?= =?utf-8?q?gdx0gIyG6vpA20A5Yo/7dPYy6R70zyxAs8Tyxnxsx0bz0v5DV/V4XJ9KX1bMNS8iW?= =?utf-8?q?e6kLiyoSYqK/hgQgYbyb9IN0nwu7LDPRMw=3D=3D?= X-OriginatorOrg: in-advantage.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0207d6c2-2448-4bb3-85ed-08dad0c966f6 X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Nov 2022 22:47:46.2813 (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: iFIVrosDCTWyQr8z1S+BhwyL7dVf5C/f7j86RzI/hkAn2wSTZnkoTJnjI3yjWiZMATr+FeXH77lsnIsvB4WfU106Tfl5Z3/9MkgCUgQfjMs= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN0PR10MB4998 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221127_144755_208556_C41E71F6 X-CRM114-Status: GOOD ( 23.67 ) X-BeenThere: linux-mediatek@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "Linux-mediatek" Errors-To: linux-mediatek-bounces+linux-mediatek=archiver.kernel.org@lists.infradead.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). --- 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: 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: fix port description location 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 | 24 +------ .../devicetree/bindings/net/dsa/dsa.yaml | 37 +++++------ .../net/dsa/hirschmann,hellcreek.yaml | 2 +- .../bindings/net/dsa/mediatek,mt7530.yaml | 17 ++--- .../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 | 15 +---- .../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, 134 insertions(+), 112 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch-port.yaml create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch.yaml