From patchwork Sat Jun 12 16:04:20 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 1491303 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org 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=) Authentication-Results: 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=SUVkg9u8; 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=Y4OlaO7n; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by ozlabs.org (Postfix) with ESMTP id 4G2My23czGz9t0T for ; Sun, 13 Jun 2021 02:05:46 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231519AbhFLQHp (ORCPT ); Sat, 12 Jun 2021 12:07:45 -0400 Received: from esa3.hgst.iphmx.com ([216.71.153.141]:42497 "EHLO esa3.hgst.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231500AbhFLQHn (ORCPT ); Sat, 12 Jun 2021 12:07:43 -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=1623513942; x=1655049942; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=qfg/Aq4VfuKMl+XFVyg+80MLJYyE1rKYjxTp8Wix7Ng=; b=SUVkg9u8UXB5oys2oK29T7j5v9LBS9/jhreczPrI3n+MbGuRzlFf7iIB HAYkTHKWu25S9MN6w/TyGA+0jRJqOQfatOk5HJgLFBGNHGBti73bFDXvM OtyVBwRVHtT40twaCjAHzYsggnZcodk7d1pwK5DpNrdn5NzhhjQ/nekrV va/g/qmkd6H+1MgphtXRof973PlQeAv1urEZmg8TqXUDtRD3vvmNH/DPT Cty6I9E4KqzNYjE3ROlQDuHZLzTcEPkAlUIQLbYU3ExaoD6lDZv+RYNs4 +nhwwRX3jqtJ1JALpMbJi/6tLZWYOI8mf/q+pBJfkFqSvmsTZsLVXrEaO w==; IronPort-SDR: sgS2cijaG0bFyzthBi4iXM8rzFrqf49xPotANzHPUWYVZJXWmUd354S/POlFgn+RMCiQWcQsoz /Qv8IXKA6keud9tcxmkLZEKynEqYc/gL/i0pGXx1uOce6YXTsm7qaBF3RfKiFIS4WOpPhOOKOM HYq8E6B6n3AaCjMldwj22DFmifM4wSsNqRH1GQX3ox9nafrFDO//37JckkyIJO8D+wSkntw94X LSEPsL5+w6+/t5l/sVbGmjI3L++69DMkycXNkcf8hVm7y9JawJunsc6pE5BMbUAcMrLyUCUREQ IwY= X-IronPort-AV: E=Sophos;i="5.83,268,1616428800"; d="scan'208";a="176494361" Received: from mail-bn7nam10lp2101.outbound.protection.outlook.com (HELO NAM10-BN7-obe.outbound.protection.outlook.com) ([104.47.70.101]) by ob1.hgst.iphmx.com with ESMTP; 13 Jun 2021 00:05:40 +0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=S4nAcvfkp5sZ9JV8/QZPrI/Cw1r7KVTlIhLRNXwHq+7qN8T9xTcibeIMmxPJMig2rLQEgLtuPRw1Goq70E8QDUmmOqcQjdcy0GFPmE6avp9iw0zuGEk0wBBfJjn5GVqGi7x16RuahJ54U8QNUgPASeDPp/Qpra0fB2gTeeV4VmdRChJ72YojJ9fy0hnWHgNVjQtVA3Z5+b1o34H46W2FMvRVBoyHchYpNhz4sZLw9I4yUZvylNdTF/0uDyyRrgn3a1mfWjHXx6cRlkrNTFHJNAYeP4oWBq4eTvD7Yssfkn2QAxqq5ZvMfLQxzT8KprE2XBGjajmc379H3ckQq5Tffg== 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-SenderADCheck; bh=l6nO9+zvHF2BW8iRaUuUWvLNeem5iqK/wUCxD2y3icA=; b=gGCuGT0tHaozY0M2hUifmwIuCSjIzCg8Hl7tsB3KN3cbO/kayPuTQGt4UoPo+evwfF3xy/2F2FjKWmCAufPigb9GZZxlbJ/IY4d69RoEqJZ2j71QRcLoPpRACzKg+dwIbXeBsZWHmZlK/qW6jYxz6eGmIqm8zGerZXq8iRiSvGyAbQklyHg651QrElPhPotW2rWdZloDAq19TvqynAAsipU0HEpIf278vVkmJl2CchdjtW5bLXAJbC/ReJxq3Sfw7qDTcQUTBhYDNucWOH5kHvOF0GD8J2JkBp36aY6F4NnZ18LrmrZY9FiMk+v9wsbjq8zKep0kVYv9lr6T9HCwzQ== 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=l6nO9+zvHF2BW8iRaUuUWvLNeem5iqK/wUCxD2y3icA=; b=Y4OlaO7n5pMXqIDOJuNz0hVag8ehNmsvjhomYcubPDhENKRWWZZvMeCgGyHAH0RbatN7LL4ml0lj4qZ2tb5tcXT0WADHDQJx88k3McoPj0vDYrqWqvIIp4COsPild1j39nL368udpuliEH1DHVEFEsyV4PRetMT/O6O/LpM1HZg= 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 CO6PR04MB7747.namprd04.prod.outlook.com (2603:10b6:5:35b::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4219.22; Sat, 12 Jun 2021 16:05:40 +0000 Received: from CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::a153:b7f8:c87f:89f8]) by CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::a153:b7f8:c87f:89f8%9]) with mapi id 15.20.4219.025; Sat, 12 Jun 2021 16:05:40 +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 Subject: [RFC PATCH v1 08/10] dt-bindings: timer: Add ACLINT MTIMER bindings Date: Sat, 12 Jun 2021 21:34:20 +0530 Message-Id: <20210612160422.330705-9-anup.patel@wdc.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210612160422.330705-1-anup.patel@wdc.com> References: <20210612160422.330705-1-anup.patel@wdc.com> X-Originating-IP: [122.171.171.205] X-ClientProxiedBy: MA1PR0101CA0052.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:20::14) To CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from wdc.com (122.171.171.205) by MA1PR0101CA0052.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:20::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4219.21 via Frontend Transport; Sat, 12 Jun 2021 16:05:35 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 1eed982b-58fd-401d-f01f-08d92dbbec9e X-MS-TrafficTypeDiagnostic: CO6PR04MB7747: 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-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: yLbBqSBXgXSTJwFGULF8Gv8P/iMhMZKSBH6huhoeeeMj0EC6V51WY+D9utJfrIw8+EsFGyUuXD7Gxcu2pIF6c9s4UBkFCPjR0dt/7Za/Z+tmsOFrjGARZEtwLHtxthW6vsaep1jY6aQBObqqCLdNFxCSy6988W+jaF47zVElYG51E6JhJisC60eCdyXcMIT0dNkIUbQxtt5y1sJgekZ7A+3WgnR9HU1xUKqOeDzstaWvJ/6WGuzEiyoO1Wr3Xn+0VH0nVMl7oC7k7PuXe71yTPMQlToqDfXC16aBiwds+zuCuUj2iHlnE4kZRqDatHgAMDBZAZqwXhJHgCSJRfbaEdVPbivo++3jIG4nl7s/0CYP79z5qSxF16Vf2D02yCImQ0DN3UjadJAO351KT9yYi16Kam7AdIrU3xisPUVBpzmg/fqkf9IlmvtHlg8KN73dp1g+co1lzgTtzSkiGBhd4tuXQC0txnphmFcVT7lGBIEgsm99Jiz+DhGAnOcc1f43Mcp8g9ridifVcT5bbgZtk2u785uz2ZSSUkRJUKz+GMT35IDeOu63Dzu4IGF/Kr2Swkx205UrNuko5N0J3OiBlqWemNsx3gLSi9RHsIWMYjOQpn9KdxinbAhupFNvmBzk3CgbRO/X4V4EoUH2cWRZJeS2JVLH8EzYqPtw/7u8HaRESc4YpXmWtJ7bUKPk4wvVnhqH6z22RpPVylfTJNGPs5QVRvI7vJjA9eg44BOlrfXsx05BNdfPDuucw0IFSQGo0hsifSczCeNcKyWQcziY2rHU+pFyqvKu9VuQ7qtmSzJf1jPNF4nNLOpxrGTMVgNmLLRG2kVsIQ2MVq/IRXh9Sw== 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)(376002)(396003)(136003)(366004)(346002)(39860400002)(54906003)(8936002)(8676002)(110136005)(4326008)(2616005)(44832011)(16526019)(186003)(66476007)(66556008)(66946007)(2906002)(956004)(316002)(38350700002)(86362001)(38100700002)(55016002)(26005)(7696005)(966005)(7416002)(8886007)(36756003)(52116002)(6666004)(83380400001)(1076003)(478600001)(5660300002)(473944003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: +mYz9rzNDGO7iCHksZSAq5UvaZkUIGj14D+PiCMd3E9vzMm7k9nP7Csc5DA2CT60AOzSjkqOWQmz9LMMvM6m773jB4R0wxTRRXgxIokMIE/vOTnSqoI3eWyIbPyD3dyoG5/U7HQ4QgrZCmlpfjdmOifmdOoDskxV/f2u9zE3KfkfWRLs6kawbQTUFtn4V/t4dhcCo/uOidkrDdJwLlfD886NPgA95t1+gioIpqNEvEdYxiaLvLe9tiV8lkR5/I+MyXCJ5ekk/VZn4WPOCYrhG/iPGO9sqjJlML6sg0QiDAZBdOeZPF3QtWpkdaJL7fXwcB+i1wTecVQlU0SEnlUopR386MqgHHtTVSZhsWfwT2v0ijL+lIlsqbpHzVVKvkq+mvptMn7v0PZo4Y2JxwNMV28vCre/JMn63nCIaiDVGYIPN0I7Gflhf9oDIOjZSvIHWXb5s2Ks5DoXOIm4oj7fjZQATTS4TYtKzVZ+Zm+NwXEJAE9r12sAmRoGs0U2p3dgH+DrOUv/hRxbvBWQ4dQ/QY7u+1rocwvsE5wmmS7WdWtoqGAZ0xVMwtyytUs3YlUCf6ZHirr5ESLvGeRucXbOW19GjswhADj4n//wmWbx0CClHXTw/vDmlDPvlpVMJm6UIJ77II30W/1VLdRmvF1KLUrCeTfqsCjCeEja0aEAzgADNTP0To/UiOrztmHyC2CNHxTwHhRMy2u/90R/eoXTdXCZMWQqPNdoYPBbtiabpGIQKuXRHg/OzS64bZwErgiFSPGsjGEs+rQEpe/fdgwZKs6Az9TqI626LRTk0ma6y7Vqblj90fQJR3LiLbQG+pCtQzXMWhGBhXcnmEqbCHfQ/GWrXqpjlVg68Nq5Qr8kQ5jgGWTabCM8NKdvBcYoChZkh9i4mKRblWi9x8En0qcLbUuOEcIFsvLAzJ9oj8kA9PcP5sypNMrimT6oR3zGVzJ0hQ3Ly+T3Xg8M9o/Tszhe35lQSmjhKg7xOHlVrcThyRlaftQyKYiO1UAoTSTJnqhxssyjGjMtJit2ZQcXlt9vx6L0gRksURMmjVu32iLgMtomkCxGr/+Q4halMSihokO4MJ08KrFkviDnqKpwrGUa5C2Cvwm9BZVlK3OjEgJEiEt3SvtDjPEMuVs/qFM61zIFGnsay4S4xZ7L8Uxas9uf6Niny6uFgGFefto8S5Gt2QITo7OfK8TnkdPRVeQwtfa5Pt84chmx/nZy91mhfIh1cR90fF9L57CfueLW6YCfOc0gc5+6U+XdtqpENGrPdfPGlVpAPaZp6oZNjKkgZUHgDSI0vePkqHvpWF0jpPg9XC5oawT/+b+cMc+i32IQxN1G X-OriginatorOrg: wdc.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1eed982b-58fd-401d-f01f-08d92dbbec9e X-MS-Exchange-CrossTenant-AuthSource: CO6PR04MB7812.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jun 2021 16:05:40.3929 (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: 04QVyIygWysW0Y+ElnQOKeEBJZipFAI7iT2oynSBo7rhjc6BrGISZBP8Nw8teJM4UIwgT2ZuXv5sjK0CwyLFRQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR04MB7747 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 | 55 +++++++++++++++++++ 1 file changed, 55 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..21c718f8ab4c --- /dev/null +++ b/Documentation/devicetree/bindings/timer/riscv,aclint-mtimer.yaml @@ -0,0 +1,55 @@ +# 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 connect 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: + - const: riscv,aclint-mtimer + + description: + Should be ",-aclint-mtimer" and "riscv,aclint-mtimer". + + reg: + maxItems: 1 + + interrupts-extended: + minItems: 1 + +additionalProperties: false + +required: + - compatible + - reg + - interrupts-extended + +examples: + - | + timer@2004000 { + compatible = "riscv,aclint-mtimer"; + interrupts-extended = <&cpu1intc 7 &cpu2intc 7 &cpu3intc 7 &cpu4intc 7>; + reg = <0x2004000 0x8000>; + }; +... From patchwork Sat Jun 12 16:04:21 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 1491304 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org 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=) Authentication-Results: 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=dbv8yaty; 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=qb0LE3o5; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by ozlabs.org (Postfix) with ESMTP id 4G2My91byXz9sjJ for ; Sun, 13 Jun 2021 02:05:53 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231531AbhFLQHv (ORCPT ); Sat, 12 Jun 2021 12:07:51 -0400 Received: from esa1.hgst.iphmx.com ([68.232.141.245]:36030 "EHLO esa1.hgst.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231555AbhFLQHt (ORCPT ); Sat, 12 Jun 2021 12:07:49 -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=1623513949; x=1655049949; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=WiKGTOT9nU7qiYJukPIw5BwLduirJk0Xuc57qaH1DAo=; b=dbv8yatyi6QYeEoEVnXdvvkNs2mRVsYn2SANoPAdvlKD4Oj81mm0Mc2c EcQ0FArt1ToTkYnGF6NL4hWxjNmwReg7FCBJeEq2ZYtam2cfo5kxj7I3r H4KRIFIimNlp1I24n1R9s2934bjl3hCCbZbqlGf82+TL27ltBV8JjsrKw YfW8DerLdQGjmPj5+a06SzbpLtnWZxJorYMjdnyQOk+DgZ7ycT/b17LJE xb5Q/tKMhEgyA4d5XUDn7N7sVaFl0ukOIdfxWK5xBTd52ffknHriHNH0e 2KFI2jHKzS/4dT1r0/nxVD2o3oPypX4TXpje94XrpeiIgT5vNHgVx0LP7 g==; IronPort-SDR: be1y0gwo8EOkSHrSCCeJHgcVkdDPigQLW3bSDpfMVIpusx+nnu8J8HlaJDxK+KoQbccdN0tviz 0dAItrCkHNTAhYBv9P4cZQ/6l7QBZ6ZpcflQibvdHqi/Ch8qc6KNAZePmM8heG+6nQ9yTUWlvq 7fANZWvnrOUshNTgfTIpjzHbMf9rlNoG5YSEDC5muGSYd8NMuB+Raziq4FCnfxJebWrV32/fq2 v27HAOwrPxkI4Dym+M3J8qfflIB0APzb1K5SnF+zmwQrEsl/ZYgOrf5CMbFIMTIhhnA/TDghgE 7io= X-IronPort-AV: E=Sophos;i="5.83,268,1616428800"; d="scan'208";a="283161042" Received: from mail-bn7nam10lp2101.outbound.protection.outlook.com (HELO NAM10-BN7-obe.outbound.protection.outlook.com) ([104.47.70.101]) by ob1.hgst.iphmx.com with ESMTP; 13 Jun 2021 00:05:47 +0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=SJhmQw647EjRsgRVPJVw69Xd82vFmQmVCE+c8QmrkCLWaiqGnVdjVw6pseQzFyOz6QNH1gHW7XNqWXhtaAKDDjkYjo3yywZryNWBOHDwFQyFtubFe2UDj6MzhOaj91KDxqnpAO2V3ADES1SIu0Bu6RvQDQeB94YswkGpqu0GK2f5zmWiTnq/kAeFhoQemnLxafW0sAfn6uiMvrIJ5p7UUAzCnklSp+byLXpOfPeiGOvdixt7mjXEt2pLNZABMkuNU2heRYcGi9E025uU3u2uuuyE9gwEOiGHErVQvl7w8rRIRZJZeCpG1MHTRiKAGTKtewTu74f8qBNHCk+nFdYAnQ== 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-SenderADCheck; bh=xa0MUS5v8HPjdsk79qDbWbZcnzNdKQu4Vo2XQA0cdXg=; b=ZyWyZ0Y5cJFpCuwe3QwpTXtDzx8+xO9ODGDon7Sav/uOFRM2Sd9iqO818Kw4wjgIa28FKd2slpbtj39XfHQqKWwaA7hLoSGjoXkC4uuUpR4/L4saEVDQCt4fXwfe7dmoOs+iv1YJG/Ob8uOKwvtNb7rTH/yLkJwl0p51BQ/ziDlRypYAp6Jn8ssU/7T/DnwaNwZ3YOLK1B04gDijWcef3Nwdn6t8FeI751/aPrdSbeRh0dV0fnJGgVhZXEQw/l/spJ6yFExLYtWxfU+vssVoJ6PR8MfHPuF3wkpddVZcQruemw5/H6A1XESZBjsH/R2XzMz2E3fddRwAgdwuR0FOPg== 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=xa0MUS5v8HPjdsk79qDbWbZcnzNdKQu4Vo2XQA0cdXg=; b=qb0LE3o5sPDr3DntIotOouKMQBviHGMk9qzBKmGLvuhCSbuZD7cyoSLeG0vWZswAXq5gXrPzety0xjzBL0I/vBuz/CSCxlTDWbjIICf9WT7RVJ36DlMgskA+GZ2jO7XKpDGdq4EmurvvOoteX3isqg55l8j5EQatC+lZfC4BJMg= 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 CO6PR04MB7747.namprd04.prod.outlook.com (2603:10b6:5:35b::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4219.22; Sat, 12 Jun 2021 16:05:46 +0000 Received: from CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::a153:b7f8:c87f:89f8]) by CO6PR04MB7812.namprd04.prod.outlook.com ([fe80::a153:b7f8:c87f:89f8%9]) with mapi id 15.20.4219.025; Sat, 12 Jun 2021 16:05:46 +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 Subject: [RFC PATCH v1 09/10] dt-bindings: timer: Add ACLINT MSWI and SSWI bindings Date: Sat, 12 Jun 2021 21:34:21 +0530 Message-Id: <20210612160422.330705-10-anup.patel@wdc.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210612160422.330705-1-anup.patel@wdc.com> References: <20210612160422.330705-1-anup.patel@wdc.com> X-Originating-IP: [122.171.171.205] X-ClientProxiedBy: MA1PR0101CA0052.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:20::14) To CO6PR04MB7812.namprd04.prod.outlook.com (2603:10b6:303:138::6) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from wdc.com (122.171.171.205) by MA1PR0101CA0052.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:20::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4219.21 via Frontend Transport; Sat, 12 Jun 2021 16:05:40 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 1d94f077-002d-4c75-9cd2-08d92dbbefeb X-MS-TrafficTypeDiagnostic: CO6PR04MB7747: 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-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: uAKjDOCbMM2ogMOsBmQZ18JYYD4zjJv2S/JPAMSpF+SMleCDsq0WsXv1H/LS6LfFJNA7ACps/fz6RvXNit+a40fIR4ImqslAZ2N+d19FPfx5/A4UfGb/H/imnd7z1p06e/mBASlXwYdYzxLvBh1wrRKI/zG7OCEBcTbnwDA9SbaOcumP2boprmBlM3urE0hD+RcIM7Mlb97aihfpAvceNReqriyOz/hxmXmglvi/U1B/0M1IQWGEL60qEYMDiMzB+lembK7k2PN9cWLPRBwf+iDgq5p0sgzBtVTy66Lq0VB48sReAv85C3kO+bydYvLkhp/CDk1B8hOEZGJFRLZtkYDQpYw6wrFkafdFmyE7j/8q8D7tvWM9dKgWrWxcgDHBw81cr2AYEE3c5CFHnu0mfvCT7a2NQBjWmRpy8B4lZ2ZvkJQ5WxgtXXW7FEbr5CYJAvaNFvFo//JcQbprKCad/v6lB9PRbx+Z4JMGOivRaDrQDNRwf1Kt480wQ1SnK+oPqZStXoxjOAvqC/Vokx00yTAoLNlnyhfE/zVXLyRD+x8m3M2D7sgbFEzE5FFZStuaaimoPVs/XsabIj3s05vX2Xj91aCIz0bv/8Jxp86KNLfENWs2MJAAWvCtv5NGNxME831C+8t+w7gBhVjotvWjPL/3dKU2gMcdwWo/HHoMbV5uBKdIR8MOkrOqg5sYEbbY+AXm5R/zvc1M5sbkNzbtOuhTF/gWjyPJJXfu18+xIPJzhUMhmV599FkoMXLO39rkT9FHdhYSLDm6CGy1t+Fz9UsESNlK0V7ttcQ8rxr8qI8zYbJt5pmvShjF6D43ZhAHlk1BVpfEyPN03DHPbteOcg== 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)(376002)(396003)(136003)(366004)(346002)(39860400002)(54906003)(8936002)(8676002)(110136005)(4326008)(2616005)(44832011)(16526019)(186003)(66476007)(66556008)(66946007)(2906002)(956004)(316002)(38350700002)(86362001)(38100700002)(55016002)(26005)(7696005)(966005)(7416002)(8886007)(36756003)(52116002)(6666004)(1076003)(478600001)(5660300002)(473944003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: RKEpe8mI8DypuLDNRbSynHKEbWBAOiOJ5F3yu3bfeLELxO5G/rve+ZYDR9yhd+bZmKFGBk/2krcQpnLdRP5HTuYiwUwOCmFjdZw4C6FYd5kPAkDtCCRYMi94eXRhE3vIXYvAikdMcLf4eeKfd8ydYWcfneBLB97K2+d/cN1dFV1/UjQ9YBK3HggS0NwvNUSWCr/Qe0zyvbaoONFC8ASQZe8wGSNBV7BQCths4xIrMN20AqJXNPMSXySttFajV2TwAQE1MwNFkncA1bttZmS/YZ4R4y0vOQaT7ThWzj+TNMkkEbD+7iJPxYNxWfb+F/AHo9bmAYWrc5MKvVxLNgfbbdOyMKdgENVEDEu/MHZTEws1XJBHeG0jApca68CrjqkZvN3vK1m7xcyJkTMEYKfyfLunNGokqAPM8lQY8UujblhMsc1bl0Qi00S431jT+LzVmF36sHvC6RilFp3VHNfzptjn6+ZnPranzOvrHAWn7GuadCwT1gkr7770oKzQ/59tCRyeaJD9glX410LeGbYWkwoxNCTrYXElgO/GWnuZf6vjjA2Ez4RR4TFOoMyvFTnyJ7jt39/Ha3veComV+L4QusgNpPwZOb53UMZMeDiWOlIRXF/Q6wb9LBWuuyMLOgGKNK9Ja9CQULHHDCnp4Xb26EY2tAUzXQIyGwGiAevyTGrFMQ3fVdOdbctVL8RR4CnJKjRblckdyjYtDqwGjVB4G14uliqQAOC8fjjLUWIVJkg77i5jpFkMJG8j9Vi3GGg9tFay4aiwbmk8DLMkFiLU8Bh9shhoDrhceIYZmt9v2SU4U8HND2b+9VEeBfNCFoTHhNx6bwXsArWoctOYX0hRcduxM957G5Pu4XXUP0eRcRgT4oKrmuArTg2GinCCS7zbxodVnoPP4xoyY/CAFtnOo8jEXm7vmlehS+UqMBMtrwQLCBc9Q3PVTCdTFLrK9+4ZDsclTtN+C8pxbSUG7cngj4KMINoimvuwvohiwhhaVDSF2GcVVVbjdlXnbz3q9u4YBLE2dFF2fodtX0a4C+KofzkxE81y+ZhsIK5YL0HM/o+FR6epziONL9DFTX4zKUF7wRNFxPVxnljr/5rUtOfs1XifU9kHserNKyv3pxamt+LCa0TTTlZEjBvbjOJEO8Qee8840GRONeUCuz9YR1wjWa5H7vUFqe4oh4R5NWsBa+SBiuwn+VJAjOA+HIMRogJnS2aAyqq2kxavi+nO/C0d3b0mqb8tDwxyzvOQROClXfUBkAnMNdO1BRRLD463ZjcB4BdKzq4LsJzWdwuxm+Jzzqmf3xaAOtLoywUatXSOjiFGkPLI8ZREzz9sfqAKOZft X-OriginatorOrg: wdc.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1d94f077-002d-4c75-9cd2-08d92dbbefeb X-MS-Exchange-CrossTenant-AuthSource: CO6PR04MB7812.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jun 2021 16:05:46.0400 (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: NHpvqdKoAOJ5Mg428/oDIYabB5ky039Ru7XIia+hCCiQuGl6qbYJGW3K1qqeshqXjTiv/q+my2A88Q5tS5h4tA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR04MB7747 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 | 82 +++++++++++++++++++ 1 file changed, 82 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..bed15411c18f --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/riscv,aclint-swi.yaml @@ -0,0 +1,82 @@ +# 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: + items: + - enum: + - riscv,aclint-mswi + - riscv,aclint-sswi + + description: + Should be ",-aclint-mswi" and "riscv,aclint-mswi" OR + ",-aclint-sswi" and "riscv,aclint-sswi". + + reg: + maxItems: 1 + + "#interrupt-cells": + const: 0 + + interrupts-extended: + minItems: 1 + + 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 = "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@2100000 { + compatible = "riscv,aclint-sswi"; + interrupts-extended = <&cpu1intc 1 &cpu2intc 1 &cpu3intc 1 &cpu4intc 1>; + reg = <0x2100000 0x4000>; + interrupt-controller; + #interrupt-cells = <0>; + }; +...