From patchwork Sat Dec 10 03:30:23 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Colin Foster X-Patchwork-Id: 13070217 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 E1F08C4332F for ; Sat, 10 Dec 2022 03:32:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version: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=YI/OwHYkm8Ah8jHrk91hDWkbXsrZXNG/+d4koB9wXMs=; b=XxGgLW7B89mNMI JBUGiodbfnygj/RzAsIhqKYxMHYO1r5rJURuwtChNX5AuSWQ8PcZ06XuzTleaoY7apTwC0wlXZ5UF Js2SDbRzQyQQ4buNK61rIhbkY6Mrhsr2J44zU4ErhZ0X+pp++cPeEbfNyOie+MUzGoP/J8CDwlzYg XfRwxrF1yJj5dB8hOdCOGyZVApnnHYRHOChw4F883mm8lKP3TccmPTEYsZT6sPIVynTcBrWCMsb0k fGTItioZxmRVPJovvHCa5M7ssowSX/wN9UuGhWExc1WUmkhyE1ghvzBe/qSjYkCnoxKHWKQPC9AIR oZOOJCEo3VXI8mZLpMMg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1p3qa0-00DpcJ-HS; Sat, 10 Dec 2022 03:31:12 +0000 Received: from mail-co1nam11on2133.outbound.protection.outlook.com ([40.107.220.133] helo=NAM11-CO1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1p3qZn-00DpXC-RA; Sat, 10 Dec 2022 03:31:01 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=M7zi0pPyPKqvuG9y+HlK6k42R0g42lNdAt+N72DdsmlfutqwqEynNF+t6lheidEzBcCjXVFLn1wc5McAt9uEcIpkpZU45XDbAHw+IqB2q4pkNgutwL3IFExjxlx4A7QX2ZfOB6dSVXITA9Bls15ERpPIv+XMVQ2/WgT7IXw9GnKurwbJZ5mKNgxigmgtD9fxNMeBkI6Nm/VwNZsH9ok11/z9lCRf3CA1xsRC5H27zCC2wTX5+Z9MUBcNCFyCVDkQUOw7q5mhaJ8jvoFhe9bgwSKgcY8CHmL58FIBuTstSCw6jHb7M/w2aTb6ur0DdR06Sy6q0B5wFMqiUkHpih7DHg== 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=MfyIuXlv74z102EP810TFkCdgXV3xIbzuIuDaf9QWF0=; b=mjhXvvg0vOuuU2jNkt4jEwQ9UkY2EPXDt4roqkWrwcZ/cp4CntjQvKd7Ond5n8iOfs1T6tyZot901pvVE2awf+vVx5ux1XiahuAvgOq28hcr361Ns5qUnWVb5TC8OBHrUG0twc6k1IN+oXhbGW0JP/ORnIGRIa6g4kw4VmdIixZdIUJYHxZ89QmD73kE7aqXZ6QSJN0t9H0u7adzEEJaupHMmgqlxbrLl9D0XA11xZT2DAgW2RqOFrdDCO/KpB3ce/9EdBlIhLIvSBuiM2y5rRE7PQmkpVwiUHY9brD9Hmd7lzrUEE9NebfNYc3CdKXHsJaofeV+Po1GCp9npxxzRQ== 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=MfyIuXlv74z102EP810TFkCdgXV3xIbzuIuDaf9QWF0=; b=K9UnNCZQ3Fpt+D5pzEtVyvD5j9XXKgUYnlw3w2iYts36Maishdcb7zTnjWPZwExkPUUlFr2nYwzuk6Vd4UKm7WklcUtwMKDBtJ1c65s5bLDtIxc7r1ey+saap9FBsqKhTZy6jEZaXlEBGopubxXMwHM/+z5N9ccN99HFZbcmT9g= 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 CH0PR10MB5084.namprd10.prod.outlook.com (2603:10b6:610:dc::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.18; Sat, 10 Dec 2022 03:30:47 +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.5880.014; Sat, 10 Dec 2022 03:30:47 +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 v5 net-next 00/10] dt-binding preparation for ocelot switches Date: Fri, 9 Dec 2022 19:30:23 -0800 Message-Id: <20221210033033.662553-1-colin.foster@in-advantage.com> X-Mailer: git-send-email 2.25.1 X-ClientProxiedBy: BY5PR13CA0002.namprd13.prod.outlook.com (2603:10b6:a03:180::15) To MWHPR1001MB2351.namprd10.prod.outlook.com (2603:10b6:301:35::37) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2351:EE_|CH0PR10MB5084:EE_ X-MS-Office365-Filtering-Correlation-Id: 3a229552-0e18-45eb-d2c6-08dada5eed2d X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 8i7WG/IQqYvSFALwRJBDE6sP9NDt6GA8y6tYR96PCbvR04zvDkk5kcPOTv2jHyl3+Buo5RYpbATJzvfVBZmZUQuVFdm6B9NFVdFfn9A2/fF6Vo0BccfFfJ1y3+53JDmjwAO4QZ/+rVW/uEtfFp9Ed7m+IS6lmJxcQrJANFAKbo8tOpzudjGvpqoVebg7VeBMbWQkXYqbPUjWyKcIxkZY80T4M4tkXNys2CQfZqatDy9MPgVftRHULkNnWcCOdQcmFc04ebOq7HpDAOFs724/Gero7KBpF0nOZqEFVJOxaYCiE8nKsIXch1Vl5FgHegd/hW7S84vdI7LBG/76xqSxvfHEzfIRsL5egjAgRd81/f1J5E4FYahExpWLwowq/MwznCH4vBrsVLYwNXvp3M1jhVXJzqMXvo8RNftEANFKceQDrG4CGwOy1a0XMVamNnfaHNriqjtnSSuEBn4ke6KpSh8YcT9F220CEESL159YIAAR3epYsBmT05qIkilQ2ICFUjlV2a4jdHNR3RaVppPx7NTBLYqmp9+2jG3g3gnnwR0t7ogzcsxRscTV72IUvqDlGiqu91LqS2uVXdK7iiuj/dU4tGHdSoPwUTjwLMqSgdIcnT3vAcL8wwTwAk7s4BL85fLKQh3aesFGMkklWu4K/fgsUOrZp5Eu8hcjXjUXqUeF/Y99uV8Ujo+cCuPNsHFQ 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)(346002)(136003)(396003)(376002)(366004)(451199015)(66899015)(2906002)(6506007)(44832011)(7416002)(5660300002)(7406005)(83380400001)(36756003)(66556008)(8936002)(66476007)(4326008)(8676002)(41300700001)(86362001)(316002)(186003)(1076003)(6512007)(26005)(52116002)(6666004)(2616005)(54906003)(66946007)(38100700002)(478600001)(38350700002)(6486002);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?CM7TlsZSc8XlNWDFkZrEW0e7Lm8p?= =?utf-8?q?8T9VpECB+raAzsnyzkvH2XI9iJ0Cn/MfMqifxDAMLPa/l3zm3KWHeZmS+GidCftZ9?= =?utf-8?q?95gHBC1PiVIMzeAZB/RlImaFww5peG1eyP7K9gskJ8VhvnqwS+6kufNLPb3isqrgR?= =?utf-8?q?sItvCKTsV0GBZAaqp0JUCnXJKlTyIeg8U8Es+nuhyg+axOPjVBr3qHo1BLWQM7ELT?= =?utf-8?q?VAJxs0xEJclaFSVKXE4VmVDqNoSB6hbnR/MIs82Ip1AvxnwcuwJgmhaz5oVJnKJLh?= =?utf-8?q?+5BsyxzhSpePLNKehaJGta6VAx0kSdRSMaOFTU3CuaCXz/F3WiRoseQ3uvoBjMP01?= =?utf-8?q?rsrUH/aZyToYTlhjv7v4zH/LcHs6thhpvuvqo9QNA7CY2KTGBpN9+QMWvT6byptpT?= =?utf-8?q?QH+6cxSkKSTuXiUp8UaGvEWa973vi9SAKyGlqggaUVvfJs2m+QGcxOlw6+3SSkdQJ?= =?utf-8?q?/5EI7EnOXLc0w3QH17wwvFiIo7BPdQjGcLVysqzjkGAov3WMXmCSV7Qw7Vq66rO6T?= =?utf-8?q?5YxPK2xxzjaJ9JpHJaZkb6h3/mH3jeUuyE8Hv37/re+NAkj0i8FN6fpwoQ6HTMKWv?= =?utf-8?q?qhqP0BcwyKeSkQXlI9lb3XcxJKFbpLS5KxWNrzFQ37/mPB6cWR2JAGuOan2PWlB4d?= =?utf-8?q?YSzdJOFMnXRFxiUqoyNjH4hB17LNM62T/W3kPjkbsCJkKHAfOuiWKtQrQvGcjGZg1?= =?utf-8?q?rNjRGITP7857WwSYhY1GmK0Rc/rS4OQxH6sah49kSi2gRTZexd5E3uSQAHvb7sv/f?= =?utf-8?q?HAWufonR4gVrcNKb4bUjYb0JQnyAHWsJfihq+okyFbJrsxyidcpdko2hYLK/w79Gk?= =?utf-8?q?5i8qx1YRju9qjg4nyO7YDy1+531voMeqBrR4t6yK6pHoEAcmSTWQA2SM1sEQ/sIxN?= =?utf-8?q?XlOFkL9sh6MfnXmdsGMnDfe7HKuJmYO9PchH+W7JPffuVrMNT+BCcY2HJ125TsF2z?= =?utf-8?q?Rq6CdBxGewpCL6cCWC+w8FK1TtxkxEUl0LvOSOrjtnA3x050Zt+N16v9aRIdQDE8U?= =?utf-8?q?4BE/aG/r814YusdK627tAKv4SjIHuaUS5iyVdwhv3OCxoaznj+R6BV5i4y1e8NUJ4?= =?utf-8?q?f+pyjBUBNWQLt0ye3N8eOcXRbTVVylkSwi6J9bUrcKt6mce4XZDqxmJvS0wmoDsu9?= =?utf-8?q?BXZayJSqgbmxkm+l/k+0ry4HMUnbiDy6tNeQsB4pZKkn1FQWSmA93E4fr8o/RK0+F?= =?utf-8?q?mo/fpUKepluzQE4aUM4S9lT1Rdd3hcvJyYC/WRbzCN/FoA5IXYGzjpGSb8PMfsJKE?= =?utf-8?q?Ox38Okt+lDws9or9qRS1hn5sSj+NGOfghniDxgVzSSbRScSnPASDv1auh6jfxRfq5?= =?utf-8?q?R+obHCSuBbQLMMr2xpdDKl7abWnV+D31uFuqpm4m92VI46oyNZENOQu4NVhgGfn29?= =?utf-8?q?P/6X+bENvpifbl31nviTb4RULZu6a/7CnZZ3MJ7qveI5z3oNRxQEyY5Bd3fOKqYpD?= =?utf-8?q?OJv2n2PbutiFFnU1syWAHqw5Q4391W1HChjPm+6V8QjSeSwd3hhy75K8zXXSC0/2+?= =?utf-8?q?dDbGMUGXeTT7pIFYjp4YJzR4LrvYgbxvaw=3D=3D?= X-OriginatorOrg: in-advantage.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3a229552-0e18-45eb-d2c6-08dada5eed2d X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Dec 2022 03:30:47.1392 (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: H8yvUowUnffVg4cuJeGf0Oqmmj1v9+Xh6S+X5jwIWaFgtFcMCZ7hXAeMvYtdvKDh+PM3ellGLnYCfyAoARUxPDKn7YL7jUxDYlLxMUXMqgU= X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH0PR10MB5084 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221209_193059_910594_85096508 X-CRM114-Status: GOOD ( 15.92 ) X-BeenThere: linux-arm-kernel@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-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=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). --- 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