From patchwork Fri Dec 2 20:45:50 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Colin Foster X-Patchwork-Id: 13063240 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 087B7C4332F for ; Fri, 2 Dec 2022 20:47:44 +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=uNGR4YDg/aCzl+smeYy3c65EQQpaJQr+QrjJonLzGsM=; b=Jeanyl4UpUKtWC oBPv0ae1QrdYQtzlZ0DECnM5y8ebLr9xHa3vyLS7ie4Hti3VSVd3aU/7iG+jZ8To9h6YgyRFtoh45 nzPqWpzqGquolDME4r66Ak2PbCie8A9Du6sCZuoixb887vLwcefQjQqmcD1gMa1h0FZP7svy4SHhg oOeOtjY0zZnqr92M+0X3ZbZ1WPpCkawhvW52d6TiSyLIuWyWDqECfOGES1YncxqWtgKP87cbUIAwm DVaRJdSOW9yoSA/pGs3fJLBF2pFY6UxtJg9Thu2eB7WQBKD8m0Nk6ppOQ8/2eKkE2JCzilMdJDwnv INo3oJSXOLRypUNQhbDw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1p1Cva-001CjF-1p; Fri, 02 Dec 2022 20:46:34 +0000 Received: from mail-bn8nam04on20730.outbound.protection.outlook.com ([2a01:111:f400:7e8d::730] helo=NAM04-BN8-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1p1CvN-001Cd9-SM; Fri, 02 Dec 2022 20:46:23 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Tf4VvIDxCfxOfUBGzDzEhC+Th4d1XhztTgh5IMJkGTZDRTKbC+7Rh5DT6rm0E1FM4cQoPvS0iMX1fGISXQCeFK8ve5XSIBhq9KsPpLm9adDOcRdfBFBwuuqx2jgRRpkocaZvA3JO/sJWUEVY//fp2uvCW83MoLvgMA3Vd1saKP9LADp66ZKlNKTRdM2/+2D1Waij0utgZdXvbl6zFdcD+qm8tPy1mHNEOc4Hy5k+836Y4B8e1noA3KxW2izWkgOfM9eaRKOgX2PHG083GAwy2qbephw5za0/w5k7R3K4rLhNU3JRuTnxq2C8Lq44T9TYjyeUZxP6jrSnSZaWQmKLYg== 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=1HBXXg1r2A4uybuMXNStoqOwoaPoUvQ07N5h0rGmIMA=; b=TcT2lyX2BFZl3/dUFoIBbzTHQwN7Q+9hjnNxBhnyR6CbnrKx5eVY4eN3cpjG6LsgNBBGwTEHlPYbmRcm3O7Cu5h6bYz93On3yj8mHN0oNk/6c1BBWqwmCV0O5On8LhHnMuw1AWMoOzxnpkJkTdhSt37Kr/lqzwc4xS3uKSRnvqOw17cp4uR+UmL2gSneFC4h9lYn3BOhTlGgvsqNr1LF51Kz3lHCI3Qu6kIxIgzBmjMY/1BcMvSa05wOzdutnhmWLoadlY86jWYC+ToPDmZ+H4enCcGXFQTBhF3oY+SapwBF3EYOtOnginyLY7FplOTkXmAwCVLdlmVqUuh0vuOxNA== 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=1HBXXg1r2A4uybuMXNStoqOwoaPoUvQ07N5h0rGmIMA=; b=aTZ0uMYWLOKLpP8p2R37PJWK/SYfrLC8FzJS6wXWx7oDjYeOAeFQlT22V/eo1G/S0yX3X3MShBJZa1Yoq2PyNzZ3qg1QJBhekGwEXKI6TYekbHQxgdy7odgzh1iIG93rc3vouRsoBehd8/1D36zz8sM3BJYpFMZAqGlz87mh7QM= 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 BL3PR10MB6258.namprd10.prod.outlook.com (2603:10b6:208:38d::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.8; Fri, 2 Dec 2022 20:46:12 +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.023; Fri, 2 Dec 2022 20:46:12 +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 v4 net-next 0/9] dt-binding preparation for ocelot switches Date: Fri, 2 Dec 2022 12:45:50 -0800 Message-Id: <20221202204559.162619-1-colin.foster@in-advantage.com> X-Mailer: git-send-email 2.25.1 X-ClientProxiedBy: MW4PR03CA0201.namprd03.prod.outlook.com (2603:10b6:303:b8::26) To MWHPR1001MB2351.namprd10.prod.outlook.com (2603:10b6:301:35::37) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MWHPR1001MB2351:EE_|BL3PR10MB6258:EE_ X-MS-Office365-Filtering-Correlation-Id: 2b600fe8-beb5-49b1-23dd-08dad4a63f5d X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: uNch4x3y/4stmroYJbqItYPaL8GS6o4iLHiYVXPPNOI40ZJc719HY0ED/6Y5MXCcxmAz8MFxt517XcXcckwO8YbFDDCvhxqznBtujlkE+Zh7LpimlpHXNwMTO5ToZTuEmgeBiuhMWhL/20IMNYQHt9LaTMhlRdA/uK3Hp53VysuLpsZe9cHVJs6urXeGl7FaubDf0pX0NGfwgg0r+nHW81YPsvG6dw0YSshou8T1IVI+4QRsLl23DTlXlxeYdtRwHsxV6KT7HmUZTjkLDbUOdSbW/6dBlUHdoXJO7YUhY3obO504p3v5I2E3T8+APtOOiCNo4d3R+Use0EOdkIPdGm5HA5U8G/BD+bPN4JEK5wV4NQW0WHTFMigO/ZZYoxy3Cc6xJoDQ3rDkGOMA6LCZL22Zzas5xLc3X58FOvMScTp8zfrwB0FTmLpCbYOuO/6dD6c2KM17gZHanuVUnfBq79yy4IJj0TRr4V9iul0DMlZxNlvMDyNPNp/t8DvP+dUXptuaRUJM61mkicadQNGReSu2trNsVHcZW9uPaOjBIlsz6j2asxFenMHPSwxQ9soFZaO2QTx7ElnTCtVaQkfswqHvKsdiZQ8CCF/+L1JyUKxUnrNbbfCw2/EeoSjBEFZ0oWgAg3VzuU2AcUvN9OfIeHnmrdL5u5LWRXsROeAOQK0bnVdPNYxOTPUhVallFI+H 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)(396003)(39840400004)(346002)(376002)(136003)(366004)(451199015)(36756003)(86362001)(6512007)(54906003)(6486002)(6506007)(52116002)(44832011)(478600001)(7416002)(5660300002)(41300700001)(6666004)(7406005)(66556008)(316002)(4326008)(2906002)(8676002)(66946007)(66476007)(8936002)(38100700002)(38350700002)(1076003)(26005)(186003)(2616005)(83380400001)(66899015);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?lhLcM76TrlaktomlN44flhMH8hDO?= =?utf-8?q?8ska1kkfa6I0K2SLHe0hbp49ELes9oQ5gOpaMt9tWTvyq9xSxUJCUz6KZoAwfN1f/?= =?utf-8?q?wq9PnP9v2kxTVkPjUQzVwrIBeGOSMl4RJ54uYaIPOUWVYdbhb1q+flPeo1S+AVuoY?= =?utf-8?q?Y5MBCEzs4Q+iSP6Wa4F0kUyWOF027/+qxBvn3f8XwirnUwNKltpbC3Duy6guzlm2k?= =?utf-8?q?jrwoUZfzhKDEYON+AyGJa0fmNmPxwXuuSd+oJPO0YuFNHBAicZ7uQO4ymCopsCvlY?= =?utf-8?q?F5nKO4IDsWScNhB/dwAxSpY2Na4147V5FwYSTZx14/ubLpR7oBgEm3/tCxLkVVuO6?= =?utf-8?q?o7XGGD+FqKYuFqo+RQUAvdKGd8LwDXx2RmjdbCAVfnM6B4KA3MXuaINOwMBMUkp2Y?= =?utf-8?q?lkHd4gxE9XWWoU6nxdoyg9bOfj3fkzWQzkl8PRR0EO3horYdBH2ff4Lqw++qrNDO7?= =?utf-8?q?Zn9Ki2ejRVVgzSGjQejqGQ/bTiFKG+ZTxWUEKRpQhivzt8Soce6SDMmIrG72MMwH7?= =?utf-8?q?Fu7AYoVu8FrNv51ZXInf+YXQ2oWFwreHs2Sym7PNenkl8C2dZ870c53vVtLiJEImp?= =?utf-8?q?tFXAuLBL30OBbYWRrxI3weAswwn5CLtsH0o8LQoRNW79rXE243lGBGdK+MTzsVb9u?= =?utf-8?q?k5Jj/F9s6rfVPIdNLkZ1SlHvEUnOalCHSRrJed9KmYtqP8c9b+bXoOjZygj3YPjXA?= =?utf-8?q?PzHtBIVgk8AmjF5+/foPP7TpA6iVyZZ2XNxDGVUaFJO5HZn0URbsEf8Ljpz/HakGZ?= =?utf-8?q?6YiXJLwc0Nms5NEqq9PI4yd0TiFwYIY8zmu3KHYFqS+nu0H+qtO3toqCA9EocvoKn?= =?utf-8?q?vprhIgCkI87k+tr/a9P3qpiVKsDigZl4klSb7DU/lExKGjWO9qt3KbGWeTC/NXbyR?= =?utf-8?q?SG1RuSSRLuGmKcYXqNXdC6ANnStBtY5i0XdyGy1sqxcf7qx5kcaCMJDvfIRKYUBVY?= =?utf-8?q?d6YNPxnqkZDQCEhVKRyplzSCKnaSpGpvWfx1uInXJ67JwAKmv568kurqxmyZ3SFTE?= =?utf-8?q?+ib0w4/eJzkPBhFVnRrCc/O4pcmwq7YQe/n+83uLxFPe9MY2Av9Zyppz9s15KzElL?= =?utf-8?q?ZOyJh0KZzE31lYFLt3Eji/NuMAUEKwNjiyL6jvZZuq9Vao8iu375dx5ZL64EGFMV2?= =?utf-8?q?clnVuXslqcXvnb/Fa+sJzmhbFQHUC5cYz8hu0iM8C4gPSXFDJvZ/gO42rVEpbrNvb?= =?utf-8?q?nA2zpAHfy5hK+pyUBFxgGzGeNZMsAFb5xC9tpYBSPBWR9xk2oeEopRo/a33QUp/ku?= =?utf-8?q?9UOM+ni8MStMx3mMRV9F09pvfhmqEuYmLsbJbVYpKk5YqgQmiW3qWIVFnAS270UTz?= =?utf-8?q?YmA3GOGQy+n1xfndzCZhhYQOxmoVBsyuFKZbV3DrpmTlecR19gfhCvJCDV9boP2Dj?= =?utf-8?q?DexfOSEBFOr7lNxor3m5N7fR6g8sER8B9vZdWolkDdH82xqAhQ0ZKtskeWttgb8ht?= =?utf-8?q?uwJ8HU1FXejCtj7ko+eSR+6Qx02ojfpHSSizy4lC0byy5Iccsbir+9bNmWlc41Jqr?= =?utf-8?q?5bQQPinfrS2mWuGWZtB5QfBF5kKmTk23xw=3D=3D?= X-OriginatorOrg: in-advantage.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2b600fe8-beb5-49b1-23dd-08dad4a63f5d X-MS-Exchange-CrossTenant-AuthSource: MWHPR1001MB2351.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Dec 2022 20:46:12.1418 (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: oU0UPrvK7/bYX9FsRY8rrTpGYgXcamszs2uMGF9VKWQv8ThDe8r6txD3oEoi8/TypKTlUrhET+J47WIdUgcZvCl7jExY4yIpPrtp+Sp/iBU= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL3PR10MB6258 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221202_124621_968725_71324038 X-CRM114-Status: GOOD ( 16.60 ) 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). --- 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 (9): 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 | 24 +------ .../devicetree/bindings/net/dsa/dsa.yaml | 47 +++++++------- .../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 | 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, 142 insertions(+), 113 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch-port.yaml create mode 100644 Documentation/devicetree/bindings/net/ethernet-switch.yaml