From patchwork Tue Jun 25 20:10:27 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 13712008 Received: from EUR03-VI1-obe.outbound.protection.outlook.com (mail-vi1eur03on2073.outbound.protection.outlook.com [40.107.103.73]) (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 D6B3D17D8BD for ; Tue, 25 Jun 2024 20:10:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.103.73 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1719346250; cv=fail; b=PMaLB9yKBYFdp+XrnuU0HcKd+BZ7fgT6uifTrq3lLFelo8YDVdFN++3O6f1YJhp3XSfmV6EyvBp7XTdxBgEeeHVbnSJfjIX3jcE8vLRpfK46l2A7V+u9VaARU3b0oP68CuwtaICM7WvyXWd7q1/7ka43ocTKR/u6X4vMLpTyV5Q= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1719346250; c=relaxed/simple; bh=wGZzobkxEM337hanEMk20Uo5vRNZ3Wb4fLo+R3NlB5E=; h=From:To:Cc:Subject:Date:Message-Id:Content-Type:MIME-Version; b=X9mwUzsK+Hxe/bbEm6zZ1Pgwedhyyl7aHAFMr+r0/ur2XrLJFDa5DeGfYWfkzSI6ZCOBZa0LoRfTlu2aDwvARAfTmN5QVahqBYfNW7ISgGHXrYxOIZeX2N+pboG3WJrX0NOhPJ7Mo4VjXgxIXyo3BCWB7TaCqOZzk3FEQDXTSo8= 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 (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b=eSIH46X9; arc=fail smtp.client-ip=40.107.103.73 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 (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b="eSIH46X9" ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Hth5Y4mPBZhawbJhr3U4laP/SGN4NXVbzd8GzxDOx6siOpIhcl7dL3x5yzj5HCbz6Bgrz6ljOaJGceU0vu524ahwF6Is4AwB/EXaegq+HljRH/vTpYqnH5ti7mpmb3+aH3+HekqVjfmAyhTBHk3ULtZjgGMNmrmxnNjd6Sv/SO7XuM+zdvcitesM19DCJfxP1ys+sa12D7wzwWFkZ6Uuc9A2rO1s+HnAjIblARnOn3p/8xJ2V76cWOxvbfBaSnFM/DGg5D9jFMasqSIN7pmFWtFdwfEFGpnCeYh5A9IzWtGYMvRYTLbHQ6+RyeYSvVbnwqEXHkI95xXizaLKBUHIIQ== 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=m9e2d43TAsPNqKeNY1JDrqy35xKWzjsWD2cIRmZDULs=; b=KVNxpk/40kIB5R46orF8jRwrHZpdo7Spk4tSYdTyvSVR+3l0AEc+qZ4SH4S1japl/gsECH1L6JN7FZcc9Ba9py/c5JSHrRhuj6bdCTG8IwfV2Gor3zVQ6eiNfXp8Zw6fSUNVjSOvGtSQo6iFK5O5Rdg5SBt5RrncmxAc/AkUuMB3W2jQp41JTIwOJvz28R+XoUfPyNB1WrZc05k9jfyTA0MVvx8cdYuynCofmHU8GKNm6nHcT3fdoQ2TgWvnhyhawkIzOhoy/Yg6nQoSLRSri5tbr8/50Y490XYiECS1XtdYEndztrxDMGiSSaC5HZuW+4ulAQbgeTmRwNi5s0wHJg== 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=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=m9e2d43TAsPNqKeNY1JDrqy35xKWzjsWD2cIRmZDULs=; b=eSIH46X91vv7lg0kHZ3e3QqRMKa/dUC3puMwJlMZumDEtDvYMCndVZgJoXlw2lE+DUeYiFYCfMCJsoRQc0h+gBybAWiQyjGw5NoZ+mlCBMsnNMo/6H56AsCPzA15StitpLXEfg+XbhxJrK0Bobu+HJyn4Sfvm/0tsKp3UlXeTZc= 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 DB9PR04MB9703.eurprd04.prod.outlook.com (2603:10a6:10:302::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7698.26; Tue, 25 Jun 2024 20:10:43 +0000 Received: from PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06]) by PAXPR04MB9642.eurprd04.prod.outlook.com ([fe80::9126:a61e:341d:4b06%2]) with mapi id 15.20.7698.025; Tue, 25 Jun 2024 20:10:42 +0000 From: Frank Li To: Thomas Gleixner , Rob Herring , Krzysztof Kozlowski , Conor Dooley , linux-kernel@vger.kernel.org (open list:IRQCHIP DRIVERS), devicetree@vger.kernel.org (open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS) Cc: imx@lists.linux.dev Subject: [PATCH 1/1] dt-bindings: interrupt-controller: convert fsl,ls-scfg-msi to yaml Date: Tue, 25 Jun 2024 16:10:27 -0400 Message-Id: <20240625201028.3923845-1-Frank.Li@nxp.com> X-Mailer: git-send-email 2.34.1 X-ClientProxiedBy: SA9PR13CA0033.namprd13.prod.outlook.com (2603:10b6:806:22::8) 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_|DB9PR04MB9703:EE_ X-MS-Office365-Filtering-Correlation-Id: 3cb54644-377e-4e22-198a-08dc9552e42a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230038|366014|52116012|376012|1800799022|38350700012; X-Microsoft-Antispam-Message-Info: xkNlvlptDpdbDAWl8ADt/NxLdkbufBE/a9PiLyzvFULh0gdCifREibP/M1MkOz4PBtAxF+EMkCpHG8nvMJ/PQ4ljGmjLMtBGPV/L8cIpH1xFJ4kr3pAsMbMGTCELetikweCKxuWhgVnEqKKf3PRxCR7Whuqmfm1kz03xhF0WEHgMBSQnedByDW3UVDmXrONMsmY3x1iZeHCMM6xS3HnemgqB9Og/Pu504wMVq3BXP1Mxs215cLPQlNBU82tehAf38o0flSpjOqEo6eoeKbmbVsVnjnreGhlo2jbdGW38RpIua8DgbYRQQPUp/FvEmA9TWjTk/AppkoaM7EXm7YBzAYr2OOAq4nlo9WHqdsCj3qBdj6TN+o0oCDNcWCTx15g17QzEa3qWqE9XuNw9ih63Gs+R51RtF/6Q6GubWJUN0k4iDjnZCy3h0FpBAQAB5Q5GZJEoUsvB0CaZbTKDP3n+a3vwBokWlqS6XiP9eVagGvGhj6HltWR6ltR5MPxEYYBMDc09NnkhiYgLSQgFxOCkmYeouFwooLeHRCCn2iAOjuiGFpXGrC629w7WRWE5dyQ2d9PqGyhrkP8mEX+t/bo9fIDtCK4JAwcxS5mnjDw7uHz7WOPAYtKpBIQBV77K7nz6sFTWJBFu7VJ0/3kBcwfWkIjySW/t5PI5m78l/Z3pf9OsMrhL8MgEAaxwESgnxz+romDbQ3qJbJFxXhS19YEIoTtuwxbkQl47ZywRv1mhCjTHUlRlm56FuJmLp6WuNnsGQBwDGfUuspRbG9BY8sDvAId4FEFP2amif8ztLvFOG3JWFuUEDsVZx/y3QwmmPmVv1Rtv1Jctko0ElXbIJA56mhpvqvRNLqnH2VEpt2hbBwGg/aTT8Egn6JHh375NWjiJPyyvridzuV9VSC/T5Lj6AoObQOL8nXhNVrs9jkppQ8fJIEeQQ/Ki2qFqBf7utY6TUaSqNb3uo9wZ2KZiPJgyYzFKhOu5kGF+G1vM20HqPQEOIsJ06vw05aci01oyMfYlF0nLzvAwbunTEy5TkYpdigXruRRWRdvKozhud1e1svhy1aVd4hw+DcHnMCTRRMraDMAnnR+n6yL0EnEAbQLab6kC9ZBYpJhev83t4fSarOBwX1KTwc4sDprVP9YNQUMeh2qYEkI4Soej8Wn83U/zHp5MavMLvK7eVj/91ll7Hkqud/jtUGoutMuVHb5H0ZZyCRiUKyZT9lxXmhxoSnDx2sIWHWfc9WsM4L5zOGOnLLDu7wPBwvXCu73qpP1BIpN8N2CCVWeuBmTk6uDepAc7mi2UVpg/DLRhfRbHbRNG9jhp7HkMvNura7d8VLDIoNyf 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:(13230038)(366014)(52116012)(376012)(1800799022)(38350700012);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: jh/oaIStrlD915BgbQAve9QvcN/it6sElMp8JxQqa4vhLsKgtG5/RG5zEL2N+O0JYwdmmd5X3uwuswpxibmWp3COsWe73d/T4iSQIUz0BL+0cMfysaqLlPyW9gwyCYpd08otKc2AofZlCESySQUHWClUOKZJ+v/r0pTCnepFNws1lmOZI4fSb5h6gJKlV1fUWLdYRpxf2YGan45d0XOOuNB1nZEnA+VwOZOMryU2h66HWVdVjspr5FjVJPSSuI9IEoREKh3emv34BhuId0QG6NW4sdoWetcwDjMbqnyYj2q26CBAdscAs1ipshf3gkr6st5jyfv2Eu5AgZHjMOQ5RVfQpWdipucAKqbchNkMOBwByt8zHhILewutD7NpMO3fEFG5m0WfmHTJsBlh2YGIDeguxDmz/0DSZpNS2fLdqyQ2dEwzZeL5gDWkoq4B5vByOgnSq3WE1c18VrBN/i/Gu2MysuAOJyziy+3qcwe0/hasxbf+piAUyHUyuCkRdRtOfC8ac3A+hyRVMV5Wy3s20JQVk4wLM80d10A0aEGgcLlsckgtlEokqlLK15CnXJQy1eFEHEUWBHXLwrq8jW/KiUgdKx4dpaHuTaRwPzkWn7ozvZCiAYNR0vx1wMCoLQQclnpfm9SAuhlHKjjzdvldSIEIwVs8Y32U6QTxztpPc5o/8YB2KcEmC6h8geH1RogKAY+/zO6rzK41IrAzkBVmj3dfVm2i7vscRN7DekPeErz5ET8vgusypLUqcygLlQ8racxOH1VQz1YpYB9nVi5YprlJTOg2lO9P45f4S6egVRaVWKlCLBRaTWRdVGHjyK0gZqPR82g0rDiuaiaiZXGR+sL5pzs6tsdLcKSWYkqhO9SdzZNIJnous4JfN8kXeubnkiQ9Zsr1Ni+aN880lF5D3ZQO0NYMJxWHzswnlz9+CgRtCMVJEkjXlnrX1mSip9sVxlcbbOVpfVFxOUUt1EHURPMYlDiOuUSAbv2c67IPq/b8ZdPJJuSXmbesgzxpG7GVt70t3ebJpnvqa16G8HvV5tsYQKYf+uNOBo3JHFRtR4AnqqfUjDcD485ku0xKjo+UwHVjAljhmmeQrf97tmB9+9ptVYt0CifS0GZ/ytTJWWDxFWmM0AWQIzlGMS0BEJCXYKDUJc6G/IgYtKSJSDVOL4/h0I6bFPKahkh9srDnIUJeEZu9Ider3aS/LLqYNvX83ncfFcoTHnUV5FTGV0PTX6nWyhk/YoNYKt9X9VF2j01qCQlRNMzd4gYzaogNNglwhqYB9v/YVC60t33xPNxxdpSaURmZvDChrlI3KV2wt9siUcPtGbW3ss3+Byirz63nzBlw16Mor0i1knFxpdJW6dtnl3ZX0ge/h2MtaFkytT902+bSyVK8kQIseAowd/jI8wLN6RiZHvTuBZ6TmZZ0THA+wgD2Tj/87EBpj+45SXCsxh0bCKkAt0X/QFUEs/KBTqYQtF8P0s32BnG61dFjrYgzqGYq9XyUn4CTAkDuTxI5PsJnU5qz4VY/8JZ2qsfv6ac/o7gAKetcHpWacs0g9gpHHnUkqowiM0YSklcRD/0= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3cb54644-377e-4e22-198a-08dc9552e42a X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9642.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Jun 2024 20:10:42.8886 (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: +9OLt2N2Vf+2Y311feG79/dR6Yh2RPAR+N3pxnfA5/y3K6KOJQSa674zgWrqFxltc6xY/OWJskZi6LKCbJfMgQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB9703 Convert device tree binding fsl,ls-scfg-msi to yaml format. Additional changes: - Include gic.h and use predefined macro in example. - Remove label in example. - Change node name to interrupt-controller in example. - Fix error in example. - ls1046a allow 4 irqs, other platform only 1 irq. Signed-off-by: Frank Li --- .../interrupt-controller/fsl,ls-msi.yaml | 72 +++++++++++++++++++ .../interrupt-controller/fsl,ls-scfg-msi.txt | 30 -------- 2 files changed, 72 insertions(+), 30 deletions(-) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/fsl,ls-msi.yaml delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/fsl,ls-scfg-msi.txt diff --git a/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-msi.yaml b/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-msi.yaml new file mode 100644 index 0000000000000..d11188826dce0 --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-msi.yaml @@ -0,0 +1,72 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/fsl,ls-msi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape SCFG PCIe MSI controller + +description: | + This interrupt controller hardware is a second level interrupt controller that + is hooked to a parent interrupt controller: e.g: ARM GIC for ARM-based + platforms. If interrupt-parent is not provided, the default parent interrupt + controller will be used. + + Each PCIe node needs to have property msi-parent that points to + MSI controller node + +maintainers: + - Frank Li + +properties: + compatible: + enum: + - fsl,ls1021a-msi + - fsl,ls1043a-msi + - fsl,ls1046a-msi + - fsl,ls1043a-v1.1-msi + - fsl,ls1012a-msi + + reg: + maxItems: 1 + + msi-controller: true + + interrupts: + minItems: 1 + maxItems: 4 + +required: + - compatible + - reg + - msi-controller + - interrupts + +additionalProperties: false + +allOf: + - if: + properties: + compatible: + contains: + enum: + - fsl,ls1046a-msi + then: + properties: + interrupts: + minItems: 4 + else: + properties: + interrupts: + maxItems: 1 + +examples: + - | + #include + + interrupt-controller@1571000 { + compatible = "fsl,ls1043a-msi"; + reg = <0x1571000 0x8>; + msi-controller; + interrupts = ; + }; diff --git a/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-scfg-msi.txt b/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-scfg-msi.txt deleted file mode 100644 index 454ce04d67874..0000000000000 --- a/Documentation/devicetree/bindings/interrupt-controller/fsl,ls-scfg-msi.txt +++ /dev/null @@ -1,30 +0,0 @@ -* Freescale Layerscape SCFG PCIe MSI controller - -Required properties: - -- compatible: should be "fsl,-msi" to identify - Layerscape PCIe MSI controller block such as: - "fsl,ls1021a-msi" - "fsl,ls1043a-msi" - "fsl,ls1046a-msi" - "fsl,ls1043a-v1.1-msi" - "fsl,ls1012a-msi" -- msi-controller: indicates that this is a PCIe MSI controller node -- reg: physical base address of the controller and length of memory mapped. -- interrupts: an interrupt to the parent interrupt controller. - -This interrupt controller hardware is a second level interrupt controller that -is hooked to a parent interrupt controller: e.g: ARM GIC for ARM-based -platforms. If interrupt-parent is not provided, the default parent interrupt -controller will be used. -Each PCIe node needs to have property msi-parent that points to -MSI controller node - -Examples: - - msi1: msi-controller@1571000 { - compatible = "fsl,ls1043a-msi"; - reg = <0x0 0x1571000 0x0 0x8>, - msi-controller; - interrupts = <0 116 0x4>; - };