From patchwork Thu Sep 19 22:03:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 13808006 Received: from EUR02-AM0-obe.outbound.protection.outlook.com (mail-am0eur02on2044.outbound.protection.outlook.com [40.107.247.44]) (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 373DE1B2EFB for ; Thu, 19 Sep 2024 22:03:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.247.44 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726783426; cv=fail; b=VBroH5vvNtn56+MViQpC6p/uSLJw7F6nnRK3IjRlNW3RhGy0s17pr9MtWIqD/IW6lUtyCeE/XVAcpu4Ag5ErydWW87/FCZPToXmxLXOrl8S+ok7+FNTiAFC3l6x4wAoZMEBkV36KxjuTlI5RaldPwJ8IiRbC2LFoWys3Prea8SA= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1726783426; c=relaxed/simple; bh=Joeh5ILISqH6dXaQEB03rw2ORJ0Vtdkmkn6ixa3NYsQ=; h=From:Date:Subject:Content-Type:Message-Id:References:In-Reply-To: To:Cc:MIME-Version; b=CblsQn6mF5KwADdQCtKhTzDih27bywqqSevVGIUReL/kwpXt/PIWfvKf9YgwmUOQ5DgvOP0MoCYPXoOUOONZzux32KpbX3KAtWkfJ3W44QFNokWYI+WXQxHe90zFZcR7zhAKS4ncFti9oGs+B5KLBZsXLyoG4EqpsNMkpAg3ibo= 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=QXRLFQQa; arc=fail smtp.client-ip=40.107.247.44 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="QXRLFQQa" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=pyLXK1AOe5YitHVCuYO522aAG8+3h/PWRwP4uQuLcbBBZbMvXKdphgu8OSYqFKa6oBLlG7VV3eHgEIyenz25Em7+i31uDch4vGpS86MFexnt3THQJ8SKhVz4OjYkvaUZRA4cpX8/MPNuROErasl+8q1tW1+lU/pnhKXl+UNit5Cih/z2Z4XkkV51iN5qFxMb1ZDRSWYGaqleDSJI2TCsm8TNDeGu8PEG8D9381/vtCJz/BqTE4s+3NeXF0It1lWq13A/4zaS1q+VGNdMiR86prhkykERZ++3nQziIgSgKwFdK9GWijW5hI+TnLdGqAxqdgGpSqeakwKk434H/JJy2A== 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=cdskRDGseKh1PSivh2HmCqLJU1/ZnHANExAHf6ygLhs=; b=o6y6EtcH6021fGVW7qsUG9yit04aEWefzLsTM7vT2ad3uZ99ZmPKQZ9oGuLtSjfv/r33jMKuVH8Qm+n5lcQMm/J6StCv4+2GeOT9UwvS/235nTdfELYhN6ulhCiEQPghZocwh9Izt51/1UvEfV0SxVvXwSm4bYqsw9J11bBcQXHMwaKZnHNCQ65be/gQpClP+bxCYifIJi7USOj3EBqbb9pNYuo0DWGqYjlk7r28xxBuxISnXZwaTZEoVwegOBGufDvjMudzvpwKualNs0aBxwAejQUIfOS9h/WVMbr3LlHTW4gp0gTOyUveGfMJSKsOusPdUWpuEcrF13BYMTWnqA== 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=cdskRDGseKh1PSivh2HmCqLJU1/ZnHANExAHf6ygLhs=; b=QXRLFQQa5racaPa0EDCfCsZ2/R98dg53BXmZs46m8gn61eK5QfP3pv173BLy5uZN8hA/ow6H7fOBQ6peLw9qZW3qT9duz0vBpS7pBkLadXJkhMLZus1k+MKDjqsvl3Oriu7ZY8bbtI9ClI8VApWz52xY3IOVuTiVe+xPzQUxVtRpInn1l0aq3JM8OUmxCrp/hJPG0hCUbORnEwbt1Nwx810dcqdzUnkoevKQiZy7aMuCvBKy1nWk3o+dHELHWPeWQbCfmFtHLKZ7f148b93FjxY55Ak6oDAItEYIHAWt6XHT6fgZpi8AS0oVqO2WJS6xeYyQOKzb3HP01gn+hiSxvg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) by AM7PR04MB6965.eurprd04.prod.outlook.com (2603:10a6:20b:104::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7982.16; Thu, 19 Sep 2024 22:03:41 +0000 Received: from PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06]) by PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06%4]) with mapi id 15.20.7982.018; Thu, 19 Sep 2024 22:03:41 +0000 From: Frank Li Date: Thu, 19 Sep 2024 18:03:01 -0400 Subject: [PATCH 1/9] dt-bindings: PCI: pci-ep: Document 'ranges' property Message-Id: <20240919-pcie_ep_range-v1-1-b3e9d62780b7@nxp.com> References: <20240919-pcie_ep_range-v1-0-b3e9d62780b7@nxp.com> In-Reply-To: <20240919-pcie_ep_range-v1-0-b3e9d62780b7@nxp.com> To: Lorenzo Pieralisi , =?utf-8?q?Krzysztof_Wilczy?= =?utf-8?q?=C5=84ski?= , Manivannan Sadhasivam , Rob Herring , Bjorn Helgaas , Krzysztof Kozlowski , Conor Dooley , Abraham I , Saravana Kannan , Jingoo Han , Gustavo Pimentel , Jesper Nilsson , Richard Zhu , Lucas Stach , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam Cc: linux-pci@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@axis.com, linux-arm-kernel@lists.infradead.org, imx@lists.linux.dev, =?utf-8?q?Krzys?= =?utf-8?q?ztof_Wilczy=C5=84ski?= , Frank Li X-Mailer: b4 0.13-dev-e586c X-Developer-Signature: v=1; a=ed25519-sha256; t=1726783409; l=1981; i=Frank.Li@nxp.com; s=20240130; h=from:subject:message-id; bh=Joeh5ILISqH6dXaQEB03rw2ORJ0Vtdkmkn6ixa3NYsQ=; b=Cb/aWmRHcy7CNArIv19ubX8Us30zWIc63ZKRFd3jnipeSgJfQmMZK4KErclw3ZWzTRJ4wF08U WDr/VDKl6L0B53p89s1HNuXRvua/n5KOmYay6G5OXZ+yP5qD9Mwames X-Developer-Key: i=Frank.Li@nxp.com; a=ed25519; pk=I0L1sDUfPxpAkRvPKy7MdauTuSENRq+DnA+G4qcS94Q= X-ClientProxiedBy: SJ0PR05CA0057.namprd05.prod.outlook.com (2603:10b6:a03:33f::32) To PAXPR04MB9642.eurprd04.prod.outlook.com (2603:10a6:102:240::14) Precedence: bulk X-Mailing-List: imx@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXPR04MB9642:EE_|AM7PR04MB6965:EE_ X-MS-Office365-Filtering-Correlation-Id: 0a47cfac-0466-4c49-ab99-08dcd8f6ec03 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|7416014|366016|52116014|376014|1800799024|921020|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?XSQVk/mJccAx+b6e1gb5wcnIiKkKuvs?= =?utf-8?q?voc24cVta8cxx9BQVU9h/2aNlFS2ylH51ahBEH44cfaNyXPw9rRA4y7jR+pALInYQ?= =?utf-8?q?kcmGyo2ZL7Q6MxyXfrjsJcLm+UzaMwPnJ/lNH+874bzgkfsDOgPuXOnQv8GrmQcfZ?= =?utf-8?q?7u3obxdgrloUCsRZuaQGHVnVmdQBIgvwnJr+1lLknTbZBk3GLmmIe0ndlExYCKP1w?= =?utf-8?q?MTNDjfHmvAKqXq3U8ZWrrr0OBrYjAWmn9wkTJqb9VnaFBjlGtE4X9W+MPd91nLpwz?= =?utf-8?q?i2M/c76z85wj/ie3cBamCsDrqFtYd6ONgm4K5+FzOGIJDr7VKAUyC5aRNTXpnz9Lv?= =?utf-8?q?JPeBb8RjnwA634nqNmZl1NUzqzUVgzuXLJwo8WHv2RZu9BJAa+cn4w+jFrQH+hqly?= =?utf-8?q?ooPJEU8z+a84xx7nWT0gTK2+DXEiJlVnuJQgsfH5jXxgjFzYqGJA95hUj52j7sc+9?= =?utf-8?q?v70DBb71HNZxZ/oeBz+D3jTlMRdPufCvL0JtwkxUJDb9MxZqFJdOyPfxMsau3Lx7g?= =?utf-8?q?AUlItZGO31qoyxTqyTSi5pX0Eyz9ttiCkUaLDE0OJfBRvJaITTDAe10EkgFUqwyzF?= =?utf-8?q?logKZLMxqW2qkuKchKsgAAScCNOWYWXZrHitrAh5FwSNegqSjRs62DS+/8i9DVHYX?= =?utf-8?q?SKpCOvuS/xT5N5mJ0AeJ6QOCMkkh5cw2UCs5NrjUv6HnJqbLbEolZ6TWv/ux/ngtE?= =?utf-8?q?JNjFm9Bil5DyUSr4EKXv+/fF1upWYJBX4SJlwvkQnSBICzLfUhE1ykscGGHCz09nf?= =?utf-8?q?BCjZ03p8pJiX7wre6GiUUb9E7NY1xH2zj8Ps9qOtD803CtGe9rhbNnPiba4Pl5b43?= =?utf-8?q?nvwAq2lgIBJTMubZjT03fGATnHXZvAa4XkUUu+CA4QyYic7vqRDiLy2UE9qjEnUIJ?= =?utf-8?q?Xap9BYXfIJ0tXVtJxyTLgjzTdH40Z/WZPacs2OE2srjD8GJJklrv/Gk3+3KzuIiYf?= =?utf-8?q?RIlF4RtHbQiwwLzZUqSd8MTzbH79Q/TO99d59HWImvXRrOy1J8JE72P9kqv/tns0d?= =?utf-8?q?6nSNzqbjOj9Ye5wmx4fXv180SBNaYXg2PT8PPjFytsVYNVtMgctRM30RWLdAfan15?= =?utf-8?q?CGboCXOyya0qsbGYhMFU1bcQbDMfH/4kHxJ7UkLmxg/W6RArYJJ/KqH69hjDjWsfx?= =?utf-8?q?bwnr8AAyfiThk22kCReUudfuhGc+tymyrKB/7w/fYq0LuNQH9Qz0WMWz5irRHbAqY?= =?utf-8?q?fI+6V1W8Qrdw6J3ahyXEtEPEiJRZx1wsAgx2kEUpjDnkHqpKrbN3AXgvlGwst05DC?= =?utf-8?q?GLaXpGQStXY2tmPyl5mc0YlNNAhrxkeSzPmXebM/IYBgEmJ/CgUcY/Ev15MmbDFH6?= =?utf-8?q?8SJtg3olUHz4ydUunf9yIgzuJrxKTu3ybXkZyOCKdsE9+kcKjDfp5co=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAXPR04MB9642.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(7416014)(366016)(52116014)(376014)(1800799024)(921020)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?8+yQPo/0r8YOLo1sE0MjWHJcAeVq?= =?utf-8?q?0zBD4K0/doVrlo6R5Z45FggPhznYWlvaJCAlnpR8BC/3j1CL5FMbnOpOdqvFyPsXJ?= =?utf-8?q?rm8C6ZqaRLtcDzncwZCPmPTblSjRpDuIURDOg5BjSyI6RlzoO5cp1MoizQHaMPJ0k?= =?utf-8?q?YecsPhiFsnqnH4qIMHCevCyqsmwejpsxWRjmljDptVLbm+iXLb99T22ns5lNkquqz?= =?utf-8?q?9Ic7y4LHwuwtxdLapWXdJZwomOOO51O+m4O8TTdbbMI4lJGnAIKKQFSD6uHhKnB/R?= =?utf-8?q?xS9Gu5jPLXZ1gjxNt+nwtPWuEsym09X0sF7g4qZxj3mqXbrSGlRYjyT6xBCrTBYnP?= =?utf-8?q?TvhHu4xx/IYd8miXwQpCj7qmAn1jVOeSZtQVAbIZxEdsUmYIzii61fKJvL0z2t7iT?= =?utf-8?q?1nWxcIo1250Hdwlp0bhEw/8Tekx2rRfmWJUoAVVqsWKCX9v8V8HRRtcjR04wcZpFK?= =?utf-8?q?DzZhjkYVPPwVW40j0EiXjDR4TX6ksdVXajQUjxdamDz46Mmd5MMzxgO/4EbndmEVa?= =?utf-8?q?AJA6+d05U3dCq50PXRzbt4M34zXnWco5gT4unEWM90IgoV6yaWH+w7FXVrN7vHl8M?= =?utf-8?q?4MozFZ0u+3kJ+RDPjQ4EhqxMw4GesNDKiNuiTMkhZzphuMASesEqayUXh4y0kJGxT?= =?utf-8?q?kmvEFOko7TWwzsgSnZTH3k70K5e1ncVD5cAfL+pd/XBlALxuFaCOApmkDrviVTEF8?= =?utf-8?q?c4/ia2WFQKazFZpoI535qN0b8Q71JnpDIgoDWeqla69VaKhkIQd5lwnoNSgQ04eTh?= =?utf-8?q?0WjLsJTxScc2xGqe+J38cqSDwi8nFE+6m+fiZ+LOPa4dpJ7mpAKTT38EfsuKbYWSy?= =?utf-8?q?VDC5kSNnnMO37KsNAIuwEARPVybQ1ZeeOwB34ztRB5KYX2gWwgx67ySg9dre//dY9?= =?utf-8?q?RUC7IgveCuTicxbhaCYUGWadICHQM27qd0GVBgWrz9dYwKFl1qgnvfTG7ohGvDOmM?= =?utf-8?q?2syhSkv4DMEjajOSwn8zB8PfpETXdJ6sorpJwi33oO3hoAo0P15j1li7Fbq4A2Ls0?= =?utf-8?q?cTQr5QTcqeb1D+yhFIvEa9peXMvL0ca2tTFrX3Vqop5+zc8xR5VzVGowdSNK47J9m?= =?utf-8?q?Lw7+Jn56HG/9OaLa7QtH+ibysuEpvORQLRnBdNxcqLuMY263a5sS5E42HzVQS6icy?= =?utf-8?q?sXZzOu4soUUdX01nRo31OO6V/FSlsAKIDXhKj3IhC2euE7xdkF8fq1+QhaY6nnkqY?= =?utf-8?q?mQQxYY4qLBGYlitHMj/uO1oXx2xU4odJvCe7KmO/9e6zyWctFc9n54sOY/28WVgSJ?= =?utf-8?q?DzmljAhQPLzjeDJyzNu7DGR4hQwAikGL5jyPufuVqTnIPTdft2v5bNmyiVIbe5Jdk?= =?utf-8?q?KrupvuKev1YCwz5CtCa1wp2rGFD6Tcnf/4K61G9mETywBxU+xtfI8tihEJlkSwDqL?= =?utf-8?q?dYigbYvYv0PDYdVlnNBe4XVHz/LCvAo0S0m0AD+sA2QxwxwKRicaxYUhosrPN82Pz?= =?utf-8?q?tSiV06HwvneCwnbOHpRWYGGMLMm1W5B37qjtbcz1XIuIhK59lUPNO/wvyhalQo7br?= =?utf-8?q?kg549stQiG+K?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0a47cfac-0466-4c49-ab99-08dcd8f6ec03 X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Sep 2024 22:03:41.3791 (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: deIWz3qd4ih+0TEhPiQY5YIOW0+EbuXCI/gj2xnQSQRwz6tz4Lkr2sOr9IEfG9blC7Jo4116trk/6JCV083RFQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM7PR04MB6965 The PCI bus device tree supports 'ranges' properties that indicate how to convert PCI addresses to CPU addresses. Many PCI controllers are dual-role controllers, supporting both Root Complex (RC) and Endpoint (EP) modes. The EP side also needs similar information for proper address translation. Add 'ranges' property for pcie-ep, which format is same as PCI's ranges. Signed-off-by: Frank Li --- Documentation/devicetree/bindings/pci/pci-ep.yaml | 30 +++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/Documentation/devicetree/bindings/pci/pci-ep.yaml b/Documentation/devicetree/bindings/pci/pci-ep.yaml index f75000e3093db..2de00d2bf7326 100644 --- a/Documentation/devicetree/bindings/pci/pci-ep.yaml +++ b/Documentation/devicetree/bindings/pci/pci-ep.yaml @@ -17,6 +17,26 @@ properties: $nodename: pattern: "^pcie-ep@" + ranges: + description: + Outbound memory regions, which is extend reg 'addr_space' if pci bus + address is not equal cpu address or there are more one outbound + memory regions. + oneOf: + - type: boolean + - minItems: 1 + maxItems: 32 # Should be enough + items: + minItems: 5 + maxItems: 8 + additionalItems: true + items: + - enum: + - 0x42000000 + - 0x43000000 + - 0x82000000 + - 0x83000000 + max-functions: description: Maximum number of functions that can be configured $ref: /schemas/types.yaml#/definitions/uint8 @@ -42,6 +62,16 @@ properties: default: 1 maximum: 16 + device_type: + $ref: /schemas/types.yaml#/definitions/string + const: pci-ep + + "#address-cells": + const: 3 + + "#size-cells": + const: 2 + linux,pci-domain: description: If present this property assigns a fixed PCI domain number to a PCI