From patchwork Thu Oct 7 12:36:27 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 1537678 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=wdc.com header.i=@wdc.com header.a=rsa-sha256 header.s=dkim.wdc.com header.b=DK/aLosr; dkim=pass (1024-bit key; unprotected) header.d=sharedspace.onmicrosoft.com header.i=@sharedspace.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-sharedspace-onmicrosoft-com header.b=LqE2+sto; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=23.128.96.18; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by bilbo.ozlabs.org (Postfix) with ESMTP id 4HQ9nq1ZL4z9sPB for ; Thu, 7 Oct 2021 23:37:35 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S241526AbhJGMj0 (ORCPT ); Thu, 7 Oct 2021 08:39:26 -0400 Received: from esa3.hgst.iphmx.com ([216.71.153.141]:51014 "EHLO esa3.hgst.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S241500AbhJGMjO (ORCPT ); Thu, 7 Oct 2021 08:39:14 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=wdc.com; i=@wdc.com; q=dns/txt; s=dkim.wdc.com; t=1633610240; x=1665146240; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=H1p7+JG6FND0OTBgXFibcwJ3DtV+jJ9ZbzBXmYkDEMY=; b=DK/aLosryBDu//KUGw8y8f6P8oeKW16uhSzGRNQdCbUbwtrFkfil/MF/ 8j1509zYoK4ikR74RagbkK1pt7sr14uCGv7uSo1k4IvTji+O0IaH0+ye1 +QPsN7E0Nijz9fiSJU2VIuTS+wDP45MUn4Jt4aGNA+DHaphrNECEdXmsD 5Ip3xf/zjQ0NlqgOfgJq/85jlykFR0hXgcd7gsRs7j4TvQj3lPvdIOur5 tqkrOiqFWc298ea1b/V/VMmn0cbZQUP9tWw7UPMxzWjI9pMEjP6vPciNh WeQqGaE3U/KFUbBREFDbJw0UPHafwQBOFmXDZNUdPgg3sQPlYyFIXEdcw Q==; X-IronPort-AV: E=Sophos;i="5.85,354,1624291200"; d="scan'208";a="186926249" Received: from mail-dm6nam12lp2177.outbound.protection.outlook.com (HELO NAM12-DM6-obe.outbound.protection.outlook.com) ([104.47.59.177]) by ob1.hgst.iphmx.com with ESMTP; 07 Oct 2021 20:37:18 +0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GpDWHpJd+qpm07EcpUCYszup3DWltRwUsXMFRADWmetSQj1COyx1WRIg1kORYTBMW3VjytJjAEU2gbWX7UDo0ANyonUdUW3VDqarc5IQa84MGWjNjTJvimb3BCo0RjWv2QhAyKi4cSmGQWJai7QWMeTXLqEc2FdxqnFM1jPmT0hybdcsxmDUuYKLoA5kMmDI63OsEqnG0eFwg7QonuMf2PA1QPM4PxX+G4ySb0PzxwrQXDpwyWu+PAdkWHjMKhfbrm+qJ7ZcsnsHsb7XH91F9q9fCD8RzL6fugCyHfCdrRwiGUKFoakDWLMt6clVyn140JPBBIMvYoeKejhkP4w5Eg== 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=dEuoI7/T6g1PxgVda2pudgr8X17JMCGySnafXuZUo10=; b=NziLMtX61Tvoy0K1xT42sN39lZT0iZTIXx4MZRxiImHN99rZXjH8hN/qwfYXXn3QIbjePxUdrUS92wdOfhwMbAaPUwkW1NV7eYuBXgRVJxfG9teyovPwahYhdqRc7SkQsODbubuUBw4kFZYx5CVkW4Gbq4oosDryz5SfRfspZqaaFVq9bvLoEZm1bP9IlGD+aN0wN5+KUSI2oAk9UmtcLoxeUuSTDnSXKwatHJA7PYho8YxL/SuQgx7IgHfEVd2fSl/2ByeC+VF98xHEZuaWxVIFtdda2pIKK+c64ZwuW4FzHxKSpfSaz8kIlODbrnfSGTyvzSvpDIiktEkD9j+5qQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=wdc.com; dmarc=pass action=none header.from=wdc.com; dkim=pass header.d=wdc.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sharedspace.onmicrosoft.com; s=selector2-sharedspace-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=dEuoI7/T6g1PxgVda2pudgr8X17JMCGySnafXuZUo10=; b=LqE2+sto26JTUKLqRNn+FMUsil9YPmxpAoIT66qxSo8IpduZPNVA9WDD2X91FDvSwTitASUz6dFIe4yLCatAyhZbYigcOGQG2Qs0wMdQW8stnidLnw+AY5mqXEOJ8IGuRgnXgAasKsniKbdNKaX8UhGVXeTiw5T3gwLJq5TvpIw= Authentication-Results: dabbelt.com; dkim=none (message not signed) header.d=none;dabbelt.com; dmarc=none action=none header.from=wdc.com; Received: from CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) by CO6PR04MB7777.namprd04.prod.outlook.com (2603:10b6:5:354::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18; Thu, 7 Oct 2021 12:37:18 +0000 Received: from CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::8100:4308:5b21:8d97]) by CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::8100:4308:5b21:8d97%9]) with mapi id 15.20.4587.020; Thu, 7 Oct 2021 12:37:18 +0000 From: Anup Patel To: Palmer Dabbelt , Palmer Dabbelt , Paul Walmsley , Thomas Gleixner , Marc Zyngier , Daniel Lezcano , Rob Herring Cc: Atish Patra , Alistair Francis , Anup Patel , linux-riscv@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Anup Patel , Bin Meng Subject: [RFC PATCH v4 05/10] dt-bindings: interrupt-controller: Add ACLINT MSWI and SSWI bindings Date: Thu, 7 Oct 2021 18:06:27 +0530 Message-Id: <20211007123632.697666-6-anup.patel@wdc.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211007123632.697666-1-anup.patel@wdc.com> References: <20211007123632.697666-1-anup.patel@wdc.com> X-ClientProxiedBy: MAXPR0101CA0045.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::31) To CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) MIME-Version: 1.0 Received: from wdc.com (171.61.64.222) by MAXPR0101CA0045.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18 via Frontend Transport; Thu, 7 Oct 2021 12:37:14 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 6407e6d3-c664-40c1-90ef-08d9898f3330 X-MS-TrafficTypeDiagnostic: CO6PR04MB7777: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: WDCIPOUTBOUND: EOP-TRUE X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: zvj73z+xou3lHFTFJfYZJsRrHv0ZAaGKqh9WiNrLsKvseiiiMn85IS0ttJVIBBQ2ei0z0LIZLdL0g+wDNxzZCIzCqe4rUPcK3l7jadKRl72FcZu40M+s4Z/EBI2UogYfTjmNGVrI1zx6OvQfKI5Rwyd4BCE1fOG7SUk4QgRk2HnepFMdWtGqkQHWPJGrS4E5sg3elSn9AJkGt9/nnC+PAR1DZDsxGI8o8TRxNw9C/PtrFvJ67psMygNGOl8Or7c8YbtfLTiduZl+hfv4bKbHEBxExZCodfe490+d9BzYKn9gRz+m5veIRKOurs+cQWr4zsyShXM1L1C+ionHkbpz9lcy4A5WkIVirIeccIb1m0v5MgGNXCS/wWvz3JmQwO5ejbtOOwNnlWBHzCNKkh5FMVC/j4KTAxtMDABiFrj9Z7vXvDLOCiSXN+a/x6aTc9p1m+WdxlrOAX2Xj86X+XIUDcNd1S56NuR3cby55ebXz1niu051ssB05Swl8TxHhQD3olD5enBfv9j1InMgER6KHA35S5Kg/XlfIk+zU1OocykEhAsPDTxSK/0IzMiTtmpwCHNmwqfyA5HWK6E8y9jGuhqg0RIVtBruZn3pqTBRJx0Q2RhiKEXRc3TEanmkrucpRy5g6cxo83c1pvVSjszV16DvjT4rt99SKJSmWgS5jGOb6mrg6jky0ZBrAcsZu78U7yVDCLx86L1eA3PYXzDcxI9X1+lLriWIcOC9e/wyQpZVZG4PthNiCMTnbkE0RkKSD472f+oPDSp6nSMU/mMtCOBRqiwHTjRTVRIfQo2YqXRK8UJ6EgedLut0/vhfMi6r X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO6PR04MB7812.namprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(4636009)(366004)(54906003)(5660300002)(52116002)(1076003)(316002)(110136005)(8936002)(7696005)(2906002)(38100700002)(38350700002)(55016002)(508600001)(7416002)(86362001)(966005)(66556008)(66476007)(36756003)(4326008)(66946007)(8676002)(26005)(6666004)(8886007)(186003)(2616005)(956004)(44832011)(473944003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 4nCTDqACoDUW+YGUyaZZ18/fNC3kmURcBrIB//8JK1tsfTiUhtzXb5guj/b1ksYh+VtL/i4esyUZW/6uv6C0o/7ZgQH3jQ/twFMBRClbG67c9aKJjmMPfGsn8yp3x8rSGTM2E8TUV8EF4BJGDzHi7msiW2utFaongjWMn9EXT6tvlBZ0viAbHZJpGVbaLs8bgPJcTdBfbn7AFRewu9uwIqSg9r4/iu+4FkMjbxr6ULuSbiD7RgtmdhJgIZUjdOjEGev+YSsaC1Ra8L2aNLJQWENE6D7hewrUGgiLRsAjjK5ysJ7sEj3bbYxHCnAPA/+eKh1rLY87tMdOV/rW1r/TbO23xDTJ1clj4SfErWWlu1JwB98C236AnXGrYlcS6mKOhglNciKsGr99WZG7nBtAU6qdvED55toVuH4MGx0MBTQhsyhcuSFwZZ/GZTCpErZ7NK/5zBMdnAcR2HIt8TnNHfcjooaw+Ta54XYhxKIphWOw95ftkOS0B97qqi12cJxc+5ACsZoFIaC4aRSDAYthm/79N0hFRrL0gCEsDa6Z36GCghVzOHmvncTfk14eIWRfLdeaxsZ55iAbA7hT+670pI4VwMSx+wr1WFG5xt4rQZJoS8wIoYVZRgKisH6SfgNANX9c9tNQs3/cImeUagvMo2ttV0AT49LCToTqkSxz65/skPpNoK39Xvjve1aKBZnCHQ6HwDqdNYtgE2w2YQSI1KMlT2JCP9slVLHP4FLUxTyjnIK3iCCyU/23BzXMgjNMM2a80Gm+oNvBzFPcV8+QToNdZ/f1bc+gR0pg1G0JI9a/qioMtJQQ91WKMcLELgxZJEfkI9ionhKZVZIdKYOstIojYb6ubr1Htf8l2cETuyFlNYZmP9tUGYUsu2JRMMlLL57SRIaRPig+C+w6fsZvxoc4ESAUyhc2Gxb3bWeNC5arMoy0vql1Hdnt6wTVyv4URbtuZdRAjRR2wau4jgm/NZhYa06s/b86k68f4CwnbZSWmCWGeZ+VY2fxEagKPNC+TAasJSUsz9KT3eKeEVr1JP8xq4Rzz+6SpaNmRat+4saKq8YmFUSFIWnH3sCCNdf/a1S+/zMwwctdfVcJm6GWzZSBFcyF46BJyICnnbfGhXrvWorVpEVbhksprYLnSDNuTboBmKjE3IBqKQ3uYzwCaLJFa71aiyO/vi5o0DpLDc37WThdJJdz1esbJ2qqpiWVhHEzZ6+2nBhAIGR0XIjtThV9gcWurAXJH8EwLfnj1txrZl4aAfYxtEAOUikrc9TgOO3BsmsZUDbv+OqGVy6SIVlIq+3bxhrvL8ptP/IT15ONsDu09Ri6X/m2N6t+kcuK X-OriginatorOrg: wdc.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6407e6d3-c664-40c1-90ef-08d9898f3330 X-MS-Exchange-CrossTenant-AuthSource: CO6PR04MB7812.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Oct 2021 12:37:18.2721 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: b61c8803-16f3-4c35-9b17-6f65f441df86 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: qUKZJi0hS7ZxsWulxy2Z2nqNqL1ULCjmLrsYGmuTpVB1zWFI/YspCF9SW7nwlIaGq78RfrC7x95FakZ31BVxAA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR04MB7777 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org We add DT bindings documentation for the ACLINT MSWI and SSWI devices found on RISC-V SOCs. Signed-off-by: Anup Patel Reviewed-by: Bin Meng --- .../riscv,aclint-swi.yaml | 97 +++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/riscv,aclint-swi.yaml diff --git a/Documentation/devicetree/bindings/interrupt-controller/riscv,aclint-swi.yaml b/Documentation/devicetree/bindings/interrupt-controller/riscv,aclint-swi.yaml new file mode 100644 index 000000000000..f034c18f46bd --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/riscv,aclint-swi.yaml @@ -0,0 +1,97 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/riscv,aclint-swi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RISC-V ACLINT Software Interrupt Devices + +maintainers: + - Anup Patel + +description: + RISC-V SOCs include an implementation of the M-level software interrupt + (MSWI) device and the S-level software interrupt (SSWI) device defined + in the RISC-V Advanced Core Local Interruptor (ACLINT) specification. + + The ACLINT MSWI and SSWI devices are documented in the RISC-V ACLINT + specification located at + https://github.com/riscv/riscv-aclint/blob/main/riscv-aclint.adoc. + + The ACLINT MSWI and SSWI devices directly connect to the M-level and + S-level software interrupt lines of various HARTs (or CPUs) respectively + so the RISC-V per-HART (or per-CPU) local interrupt controller is the + parent interrupt controller for the ACLINT MSWI and SSWI devices. + +allOf: + - $ref: /schemas/interrupt-controller.yaml# + +properties: + compatible: + oneOf: + - items: + - enum: + - sifive,fu540-c000-aclint-mswi + - const: riscv,aclint-mswi + + - items: + - enum: + - vendor,chip-aclint-sswi + - const: riscv,aclint-sswi + + description: + For ACLINT MSWI devices, it should be ",-aclint-mswi" + and "riscv,aclint-mswi". + For ACLINT SSWI devices, it should be ",-aclint-sswi" + and "riscv,aclint-sswi". + + reg: + maxItems: 1 + + "#interrupt-cells": + const: 0 + + interrupts-extended: + minItems: 1 + maxItems: 4095 + + interrupt-controller: true + +additionalProperties: false + +required: + - compatible + - reg + - interrupts-extended + - interrupt-controller + - "#interrupt-cells" + +examples: + - | + // Example 1 (RISC-V MSWI device used by Linux RISC-V NoMMU kernel): + + interrupt-controller@2000000 { + compatible = "sifive,fu540-c000-aclint-mswi", "riscv,aclint-mswi"; + interrupts-extended = <&cpu1intc 3>, + <&cpu2intc 3>, + <&cpu3intc 3>, + <&cpu4intc 3>; + reg = <0x2000000 0x4000>; + interrupt-controller; + #interrupt-cells = <0>; + }; + + - | + // Example 2 (RISC-V SSWI device used by Linux RISC-V MMU kernel): + + interrupt-controller@2f00000 { + compatible = "vendor,chip-aclint-sswi", "riscv,aclint-sswi"; + interrupts-extended = <&cpu1intc 1>, + <&cpu2intc 1>, + <&cpu3intc 1>, + <&cpu4intc 1>; + reg = <0x2f00000 0x4000>; + interrupt-controller; + #interrupt-cells = <0>; + }; +... From patchwork Thu Oct 7 12:36:30 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 1537679 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=wdc.com header.i=@wdc.com header.a=rsa-sha256 header.s=dkim.wdc.com header.b=lYeSp0Bi; dkim=pass (1024-bit key; unprotected) header.d=sharedspace.onmicrosoft.com header.i=@sharedspace.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-sharedspace-onmicrosoft-com header.b=PWUTvdLf; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=23.128.96.18; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by bilbo.ozlabs.org (Postfix) with ESMTP id 4HQ9pD0Smjz9sPB for ; Thu, 7 Oct 2021 23:37:56 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S241557AbhJGMjr (ORCPT ); Thu, 7 Oct 2021 08:39:47 -0400 Received: from esa3.hgst.iphmx.com ([216.71.153.141]:51014 "EHLO esa3.hgst.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S241489AbhJGMj1 (ORCPT ); Thu, 7 Oct 2021 08:39:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=wdc.com; i=@wdc.com; q=dns/txt; s=dkim.wdc.com; t=1633610253; x=1665146253; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=B4KQ5owgxF71t/5+5kv1LHnARsrhX8y/w9R6m9phVCs=; b=lYeSp0Bi+xSB5pcAK1I/W8EXzrwG3yEtRgbPdwWYGRL9hKzAuD/YSxGq HuRDpR71ruLn3pthDKLMLm5etBcL3hoFrZoB+L3P1r0+Cp4ZzvQuipB4j Rktx98pjq9TAAyG0f70JWVcQE+gaIRWQRwlX9Boxs2vb1s5SjttfrEeNy 02e40+s+OoxfvBg2F6N+/+UiuK8/1oWHQNZmJS5wgijw0/2IOH5dsnuCf vI+pGlHPFQu3tU0QyhErbHiKGWMjh4PiAuSZ/oevYMAJBcQlkGh+TSJGN Lu38DePQWl7deAUhUrDghaHeeFHvPsPyODoQ4cbLLMAhYXQfkAEqX47To A==; X-IronPort-AV: E=Sophos;i="5.85,354,1624291200"; d="scan'208";a="186926269" Received: from mail-bn8nam12lp2177.outbound.protection.outlook.com (HELO NAM12-BN8-obe.outbound.protection.outlook.com) ([104.47.55.177]) by ob1.hgst.iphmx.com with ESMTP; 07 Oct 2021 20:37:31 +0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QwOmjqno6DQl+WxPrdK7LRSE74rzQv+zHLu7DzNSx5q/+V+iLvvFssNueBs2BLiXucpm8YozuCUZ3jEcoV9W7voPUX0ZTCOYijsUn6pv5oHHoBGbKIgmYEmpT1jaTOzPe5uXp9JAf0+cT1RyrIR35XsrPdzY6GbyXJt1fCK46QZy5Og4NPKvFmQ74LicE84XakY0PxRMjYz9FluKvXWX0qbL+876w29PCqbkLxTPRFZSZLnOI5QUFJlDwc040A9fvAg+SMJvITIPTsWIAXbh1ttm99MyOMzIK0PbLwqZx7F8Q2NGDQ+waUoL4BRvZ1B3zJMLMRY/j5N6/XOpbzGg6w== 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=Z7eQEKOyVfnV/t/WI49t0azDGir2D1wEEfDQjFQasUk=; b=jppWQqJIXdTWPBGWupJZIsC03AOtyR0sSNFQTJyPNUALJdeBJTCnKJi3hL7ySp0Fp2Y/hhWdnE1Gi3DcQ6JcxKre4dq8Z5aVP6OrPHbsbF4jKbTGjZZaDNIWmVnOTg/7uSHFOPLHeJKndYNR+kSsfk++hNmmtv4+etndo7TRqyK4/sRXmcWjrDxKFHTLvcSMK4GxgXq6EkCmz6FZpVjmnOoEqxdDS1EGD69VNFvyA48DHgeFyZGzF9p4jQSizJqfnOGQsfZYkdQ2uBvSSrUEZozMAheN0vqlwCvCmLCn05IxkqWT82XIbrTDl+PREeRtlQ8QCqPi7kPwh/B48HL20w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=wdc.com; dmarc=pass action=none header.from=wdc.com; dkim=pass header.d=wdc.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sharedspace.onmicrosoft.com; s=selector2-sharedspace-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Z7eQEKOyVfnV/t/WI49t0azDGir2D1wEEfDQjFQasUk=; b=PWUTvdLfl8X6kKbBZOvB4+p0cRS0U5vZxBwQqe8YVPc2JVPKPhdB8dRTSylThjxEcmeVK5UPAHSipzf5REAo3B3aZyqw7ArJirKRdWUrO1krVzZlb37GA3TSGP7XX0Zj3ybPXkzETimK4ji4rMdG2fOf0kEl2Cmg52vFRLuZBM4= Authentication-Results: dabbelt.com; dkim=none (message not signed) header.d=none;dabbelt.com; dmarc=none action=none header.from=wdc.com; Received: from CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) by CO6PR04MB7892.namprd04.prod.outlook.com (2603:10b6:303:13a::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18; Thu, 7 Oct 2021 12:37:30 +0000 Received: from CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::8100:4308:5b21:8d97]) by CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::8100:4308:5b21:8d97%9]) with mapi id 15.20.4587.020; Thu, 7 Oct 2021 12:37:30 +0000 From: Anup Patel To: Palmer Dabbelt , Palmer Dabbelt , Paul Walmsley , Thomas Gleixner , Marc Zyngier , Daniel Lezcano , Rob Herring Cc: Atish Patra , Alistair Francis , Anup Patel , linux-riscv@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Anup Patel , Bin Meng Subject: [RFC PATCH v4 08/10] dt-bindings: timer: Add ACLINT MTIMER bindings Date: Thu, 7 Oct 2021 18:06:30 +0530 Message-Id: <20211007123632.697666-9-anup.patel@wdc.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211007123632.697666-1-anup.patel@wdc.com> References: <20211007123632.697666-1-anup.patel@wdc.com> X-ClientProxiedBy: MAXPR0101CA0045.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::31) To CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) MIME-Version: 1.0 Received: from wdc.com (171.61.64.222) by MAXPR0101CA0045.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18 via Frontend Transport; Thu, 7 Oct 2021 12:37:26 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 08396c37-1210-4275-3fa6-08d9898f3a64 X-MS-TrafficTypeDiagnostic: CO6PR04MB7892: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: WDCIPOUTBOUND: EOP-TRUE X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: k/ca0I+hZppjYDW6K6xc8ah/hIEVf5+gAyx1wVQJ++u6/QbTKFpSNPSoZDgerBH3aM8jzzkKovhRDerxolxkfGmv+SjAn6/sNOqdKyrwwHBml6K2QxavIOnjEafryKVWpAMlHzj8+TPq9QuxWC5Lt4QtS2QIn0lXDQ4sI4U19ur48l2hUSFu1uHXKPF+hO8TA5ZQBUw2FIRWOkocX+TPUdvWf+PJRyB4ZX5CiOQtGvQNMtUhhx8NNcjWfEcp1+Rt9c/89iIG2PPegMbni0RzFD0J4ZMU9Byf+X0xOZSYWWLyh3/uaQn9tOymZ0t+wWhH2eqjwF49dxKEuWoTBiU/7yhk3BiInfl7i0R2sw3SzrFqLuWOp5S427/zgiundP9ylYpbbA3FaB7kkA0YT/OivlTe11/xgCIVaTwSGVYzSXIajln/csULPQwk/Y5Pj3e7SOqKAAIJpP2h/T2YAZwdnNfn+NdR4kGon24Ybyb3L+oaXT4P6ZvMU4O4OM69ZcRFbzZ4IuRWz+j8e14HvzDTMVvXNqlqcEW4OIF7MDlMNP/qSKD4yTNzuMflXSSoCf16CxvK0MQWAQG1eMWr9/2nKmyMYda1oyW8GcZp62+Wab4pFWkeml8p60BJp+YmwPBLGN/vKnwmV9hKAy6F0c3uGIgsAWXy/NDC5wBJNNSvl35sP3JUb+2+lmi4Nw2pZURQCKr6tYEh/eSxcjBXNFp4mzp9GT9WO+Y1ycF75Obdck2ibmGWjObSTepM0q5vAHUt1HRCZ8n4RIBUx1jnStQlvn2btIJQ33lXoSdhUSFgoTGApjlWvzcmxgO+gpyW451F X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO6PR04MB7812.namprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(4636009)(366004)(54906003)(5660300002)(8676002)(110136005)(316002)(8936002)(508600001)(8886007)(4326008)(36756003)(186003)(26005)(2906002)(38100700002)(66946007)(44832011)(1076003)(55016002)(956004)(2616005)(966005)(52116002)(66476007)(66556008)(7696005)(83380400001)(7416002)(6666004)(86362001)(38350700002)(473944003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 6reIMyRhlfLNNrWrFM2Yw0xhNEaGPhsarEbYOvLiEmA4qwyBKJx25EzMoXLfE24SFxXyZYsdyQic+8AkFL/qgf5RTa2XFG6Bemay9s6ouQYM9CZfNv3NLW2rhmn+BIJ+rcFNkS2LcGipCcmGPd659zQkscJPlkXRWRHH2T2y1WxvFSVXKWz20/5ugdR19tpqSZHagnuTflAJWFvJ85a3ypVf9gj8Y3+LsMitTQ36ICljHlmK0arQCuLEDL1d+Ytfz0kI7LpsjJji5AWbOxSJxdXAydAf6ABGW84GkKv4zng5AHRu8BqSeeOOze7+R8J/3gomn1joICVqjrIEtZ/IoO6LZOCvY+ClSnSyNjcqdAZub3sHV7aLLvGPMi3V2IVRhhiOJo7LilQc4N2n77fLY5mnLfv+j0+jEDKyJ0zBccKApASt+fy2mHbfy+VymhHZ/7FD/kTsPGttmbBskbYirSaG3QgA9xK86F6HFxw5PCU6gHCu7BNrryvIc2m2IELbllyLAtuAPnrgsYbvhJ9LWsFaoPTLGTnbj5SZTv+aG0oWuZKlHWKU7VEWu3Z3pzbW9P6ZRufHww/JPykPDjOMx2W/ZjQOS5Hzfc4HvKjQ9UOudt/ZdQCOHvFffWk3x0AXQTwE6C8/AdZwULbwOofKH4bilTtkghguFIIC80tY4d6LbwxQTO3UtPSilrcAvCUsxZt2nh5b5yNQJoUmTt1b9Zz7h79D7iaxOaiHbNT/Q+5CsCCezxmeI2WvnMK2vSMMqsFOe0+uMTO0oULaA9K8b423pOW8ZlOLq6rpuenxTphHfJlhTJ6M0ly1ujQg8z5X4PYH2he6jL2qMK1Gd0+o1olhCTyLKJytg75tvbJq5TlpuGSqbLT74fpLuVqyDYW/6keEhryMazMkyZBGML5qmkWW5q9EqkAU1hMBcBsfRZ8dTcnqs9+sXtI9e4FUTSXtzXZFuN+xDv8zzH/j6mHPfEnSXWzEFICIVIsuNsPMlcRGenP+gk1gqse1+Tp601K2YQrolib/tlADp7wC1CcidwikDmAbe4oE8EHRgFcbav3J9bEYF1nKG7YYRuLR1G8d/ceyCnIcFaLhXNe93iLg7ud8oknIE9jad3WXLd2ytB+eWyUpTEyQ1aU0hM2n5DtCQdtRlNP0vby7IgUi+fNLe37j4IML9FF8wEh0vVAaL/QS4fim6TpmsXhl+vRg4UwG0EOEGJZjkSO9K/xiJva/lg2x5tFKRshnHjuunjHCXXR7bLwCpVetvxZfvZ3vZwQ5ZHxCwm5/JC2+kpSL2+5ItigREA6fDAkTXaJdnzip8UToTcQwAe51WpyELXCfxgbn X-OriginatorOrg: wdc.com X-MS-Exchange-CrossTenant-Network-Message-Id: 08396c37-1210-4275-3fa6-08d9898f3a64 X-MS-Exchange-CrossTenant-AuthSource: CO6PR04MB7812.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Oct 2021 12:37:30.5729 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: b61c8803-16f3-4c35-9b17-6f65f441df86 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: INXk/pEpxoOU7snPaqPiDk1vs3WtlrchH7WxlTFsyt3AqV8uotir9z3gkC0exFtly+ix1+O0wm444lAnuOo2kg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR04MB7892 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org We add DT bindings documentation for the ACLINT MTIMER device found on RISC-V SOCs. Signed-off-by: Anup Patel Reviewed-by: Bin Meng --- .../bindings/timer/riscv,aclint-mtimer.yaml | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 Documentation/devicetree/bindings/timer/riscv,aclint-mtimer.yaml diff --git a/Documentation/devicetree/bindings/timer/riscv,aclint-mtimer.yaml b/Documentation/devicetree/bindings/timer/riscv,aclint-mtimer.yaml new file mode 100644 index 000000000000..ebb7e81a5a12 --- /dev/null +++ b/Documentation/devicetree/bindings/timer/riscv,aclint-mtimer.yaml @@ -0,0 +1,67 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/timer/riscv,aclint-mtimer.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RISC-V ACLINT M-level Timer + +maintainers: + - Anup Patel + +description: + RISC-V SOCs include an implementation of the M-level timer (MTIMER) defined + in the RISC-V Advanced Core Local Interruptor (ACLINT) specification. The + ACLINT MTIMER device is documented in the RISC-V ACLINT specification found + at https://github.com/riscv/riscv-aclint/blob/main/riscv-aclint.adoc. + + The ACLINT MTIMER device directly connects to the M-level timer interrupt + lines of various HARTs (or CPUs) so the RISC-V per-HART (or per-CPU) local + interrupt controller is the parent interrupt controller for the ACLINT + MTIMER device. + + The clock frequency of ACLINT is specified via "timebase-frequency" DT + property of "/cpus" DT node. The "timebase-frequency" DT property is + described in Documentation/devicetree/bindings/riscv/cpus.yaml + +properties: + compatible: + items: + - enum: + - sifive,fu540-c000-aclint-mtimer + - const: riscv,aclint-mtimer + + description: + Should be ",-aclint-mtimer" and "riscv,aclint-mtimer". + + reg: + description: | + Specifies base physical address(s) of the MTIME register and MTIMECMPx + registers. The 1st region is the MTIME register base and size. The 2nd + region is the MTIMECMPx registers base and size. + minItems: 2 + maxItems: 2 + + interrupts-extended: + minItems: 1 + maxItems: 4095 + +additionalProperties: false + +required: + - compatible + - reg + - interrupts-extended + +examples: + - | + timer@2004000 { + compatible = "sifive,fu540-c000-aclint-mtimer", "riscv,aclint-mtimer"; + reg = <0x200bff8 0x8>, + <0x2004000 0x7ff8>; + interrupts-extended = <&cpu1intc 7>, + <&cpu2intc 7>, + <&cpu3intc 7>, + <&cpu4intc 7>; + }; +...