Received-SPF: pass (google.com: domain of linux-kernel+bounces-85571-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3;
From: Frank Li <Frank.Li@nxp.com>
To: helgaas@kernel.org
Cc: Frank.Li@nxp.com,
	bhelgaas@google.com,
	conor+dt@kernel.org,
	conor@kernel.org,
	devicetree@vger.kernel.org,
	imx@lists.linux.dev,
	krzysztof.kozlowski+dt@linaro.org,
	kw@linux.com,
	linux-kernel@vger.kernel.org,
	linux-pci@vger.kernel.org,
	lpieralisi@kernel.org,
	robh@kernel.org
Subject: [PATCH v5 4/5] dt-bindings: pci: layerscape-pci-ep: Add snps,dw-pcie-ep.yaml reference
Date: Wed, 28 Feb 2024 14:03:20 -0500
Message-Id: <20240228190321.580846-5-Frank.Li@nxp.com>
In-Reply-To: <20240228190321.580846-1-Frank.Li@nxp.com>
References: <20240228190321.580846-1-Frank.Li@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?+kdgwtZhVPkoQ/XdTV5sh8S3Aulr6QQbD8lnFH+MAwGRrzpubYIqOmp3Stki?=
 =?us-ascii?Q?DPlfIPF/L0P5zBjLhL2KTfiR1ROVoj/Hs73/YE6HMQjxU7NY7RgIMkyiVqzE?=
 =?us-ascii?Q?eSgcorKy0RYLsgmqWIGaT6M7HnN4z2/8rLTy8P57OlMYYAEH88k4BOAiQ3qg?=
 =?us-ascii?Q?ePuwaWm+7zRt72RWU7RCn9yUo9ZrNx7er/EWSzalcVyAlaDUrjClXcKEQc2d?=
 =?us-ascii?Q?kef0XBzDmJfclhDuIFvpFWY19iyRxUuBwMZpa4DC/ZBymWpvk3oCkuLcdO7l?=
 =?us-ascii?Q?SwO6VIuxQbSeSEMLsnE391hhO1pbhpqDtLyWNbcuPjsLaYhg+v9RRt5WRmCF?=
 =?us-ascii?Q?I9t4xD5gA+gHNvs8Cs87DD4YVEfAL7eR/9TysywX/grSezXz1l04nor+edYH?=
 =?us-ascii?Q?o/+i31sMYXjBtCCapL0XzXqWxcQz0Z885oA3vRQ/ANGlKI4cpAIsFIIoGbBP?=
 =?us-ascii?Q?FtcNzcmmPWTKZRkMdzu0u6CjvtWbEOsUM9DE0217+Dnshmr/yiutGtpHzHoZ?=
 =?us-ascii?Q?lvDAv84mKJgXUV/xMJw0p2Xp/YYVim6aaV0Y1xDLCQjvFmit0dfn5yCEWvQa?=
 =?us-ascii?Q?RkfVYi9P7ZBCc5HMYlWVAT1Jjr4FHOQxklb65ZFvHov8+AM0nuCY8D9YVqWX?=
 =?us-ascii?Q?CZBbSI9mlHxGMCm4B4HreRi8B6Rsqu64aGMlTf/j2M4MPax8sVs7sJwAiLGp?=
 =?us-ascii?Q?JNXaC7LP4SfpXnphHbUqwMvDVTsXUmDm9NOTm5qu/gdoBGnW/QDkIGDw06jf?=
 =?us-ascii?Q?pdpJtgRJOIyjSVhsmLSHLAJ4/YyXbNbnO6+5OvULGQMZkjMvdR5IexKqh9TH?=
 =?us-ascii?Q?boqzwxhJ2w2dxeUrNgd5VwkH5KOzqELhLvMOUtuiI8uiCVhQ4GDd3rOqilqD?=
 =?us-ascii?Q?OgKrjKJL0EfMFpSztGPe6nWG+UhemRVX5DFjSHz3hdrAl9NOHKCjC3cdmzeH?=
 =?us-ascii?Q?ul+PxaFrNFuQ4vdbFngYvGtJ9M1R4HVpJ9EPDJy+/XDSRpZHXia56EdGMDm8?=
 =?us-ascii?Q?xbFJfqN53NfkxAudGbSFd3gMpGQkok1CwzW/r865SFiSdfahDsiKcbkyne1y?=
 =?us-ascii?Q?ITqDA9XFadi1OtaxwUGLAWyeO1Ezgak41o1VHXQv81d4TR3SV/OK/AtgrIBm?=
 =?us-ascii?Q?MK5ucfTAQoPtNdKa1ebNm8NcLjbLhvNHRtBVVs3A3V/+8lP8/w7CdGSGuog/?=
 =?us-ascii?Q?vipOAoGo3hltXan4ACbFyE4ZJU4Qtj/2ex5poxYX1HH5AyGyPGDbHLfcEOtF?=
 =?us-ascii?Q?4tY+VfqtLTSq6QZfUK94Rf2+MkLwpNtf8KJZOBZIUXcodP8F2MbKDoj/4IGs?=
 =?us-ascii?Q?EFJgmBdUgec5HNE2vPlAi3yLzXx8iNWCplUUb6FNx53ocbiwf3qo7xRZ286b?=
 =?us-ascii?Q?lfzZUxp5qSfm/Nf5oNpBU4oYXlugJTosEHDgVAD4n+Nik7/eq6pMRYchSiHY?=
 =?us-ascii?Q?6rxTwVpeGyUWX1Czjx1fI60OpxoS3ykEj2dXNceDqf4KKIhKwb3PYbl0gz9Y?=
 =?us-ascii?Q?bDd6afCaUsHJGnD1SfnU1gInRSK3Aa2+C+JycERCENikb5x1ElOO99WYvs1S?=
 =?us-ascii?Q?4vqXeVxqnwCE25zH01+2X6nGJOH0GPNodFlBojDo?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 3ef09673-af62-4668-2295-08dc389000ce
X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Feb 2024 19:03:52.1222
 (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: vFUJtkd8UCIoGsgS3JrNkNmTk7/T7qqJXTro//cdi7budKiPgM7CiLvp+vzFrXri++xHn69XW5IZot6/O6g+1A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR04MB8370

Add snps,dw-pcie-ep.yaml.

Remove context that exist in snps,dw-pcie-ep.yaml.

Add an example for pcie-ep.

Signed-off-by: Frank Li <Frank.Li@nxp.com>
---
 .../bindings/pci/fsl,layerscape-pcie-ep.yaml  | 54 ++++++++++---------
 1 file changed, 29 insertions(+), 25 deletions(-)

diff --git a/Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml b/Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml
index 0af70a4bc5d91..e75b8853dca8c 100644
--- a/Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml
+++ b/Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml
@@ -10,8 +10,7 @@ maintainers:
   - Frank Li <Frank.Li@nxp.com>
 
 description:
-  This PCIe RC controller is based on the Synopsys DesignWare PCIe IP
-  and thus inherits all the common properties defined in snps,dw-pcie.yaml.
+  This PCIe RC controller is based on the Synopsys DesignWare PCIe IP.
 
   This controller derives its clocks from the Reset Configuration Word (RCW)
   which is used to describe the PLL settings at the time of chip-reset.
@@ -35,31 +34,18 @@ properties:
       - const: fsl,ls-pcie-ep
 
   reg:
-    description: base addresses and lengths of the PCIe controller register blocks.
+    maxItems: 2
+
+  reg-names:
+    maxItems: 2
 
   interrupts:
-    description: A list of interrupt outputs of the controller. Must contain an
-      entry for each entry in the interrupt-names property.
+    minItems: 1
+    maxItems: 3
 
   interrupt-names:
     minItems: 1
     maxItems: 3
-    description: It could include the following entries.
-    items:
-      oneOf:
-        - description:
-            Used for interrupt line which reports AER events when
-            non MSI/MSI-X/INTx mode is used.
-          const: aer
-        - description:
-            Used for interrupt line which reports PME events when
-            non MSI/MSI-X/INTx mode is used.
-          const: pme
-        - description:
-            Used for SoCs(like ls2080a, lx2160a, ls2080a, ls2088a, ls1088a)
-            which has a single interrupt line for miscellaneous controller
-            events(could include AER and PME events).
-          const: intr
 
   fsl,pcie-scfg:
     $ref: /schemas/types.yaml#/definitions/phandle
@@ -68,10 +54,7 @@ properties:
       The second entry is the physical PCIe controller index starting from '0'.
       This is used to get SCFG PEXN registers
 
-  dma-coherent:
-    description: Indicates that the hardware IP block can ensure the coherency
-      of the data transferred from/to the IP block. This can avoid the software
-      cache flush/invalid actions, and improve the performance significantly
+  dma-coherent: true
 
   big-endian:
     $ref: /schemas/types.yaml#/definitions/flag
@@ -87,3 +70,24 @@ required:
   - fsl,pcie-scfg
   - dma-coherence
 
+allOf:
+  - $ref: /schemas/pci/snps,dw-pcie-ep.yaml#
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+    soc {
+      #address-cells = <2>;
+      #size-cells = <2>;
+
+      pcie-ep@3400000 {
+        compatible = "fsl,ls1028a-pcie-ep", "fsl,ls-pcie-ep";
+        reg = <0x00 0x03400000 0x0 0x00100000
+              0x80 0x00000000 0x8 0x00000000>;
+        reg-names = "dbi", "addr_space";
+        interrupts = <GIC_SPI 108 IRQ_TYPE_LEVEL_HIGH>; /* PME interrupt */
+        interrupt-names = "app";
+      };
+    };
+...
-- 
2.34.1