From patchwork Sat Jun 27 16:19:57 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 1318388 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; dmarc=fail (p=none dis=none) header.from=wdc.com 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=fW+oHJ9d; 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=cz8WxmPs; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by ozlabs.org (Postfix) with ESMTP id 49vJsr1q1pz9sRk for ; Sun, 28 Jun 2020 02:21:36 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726740AbgF0QVa (ORCPT ); Sat, 27 Jun 2020 12:21:30 -0400 Received: from esa4.hgst.iphmx.com ([216.71.154.42]:2404 "EHLO esa4.hgst.iphmx.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726703AbgF0QVa (ORCPT ); Sat, 27 Jun 2020 12:21:30 -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=1593274889; x=1624810889; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=tvmc3W4JRYhE0UL8F+9/z2F+anrZBizcFY56B9M2y7g=; b=fW+oHJ9dq+lrJV2FmEoodq9ovgCvGx0Sl6jCLbuUcy8qTPet1vdpKope lJYOZo3X1GFXiJT7KjNgNoKHB1Vk2Lw0wpIALnuPW/CMSo4z8XoX3UeTJ GHev3PxabYTfRjQZ0A/eAXoy12AzqJiwLPXnhdt/mvBM9i2DqLwxOkYh2 ILUhYGohkc2EhkE0P0YEk1tSYZTs5f7oQTbXMhNMxVbVtN2JEMkKYQJJm YrwTqsyDMIOsTJVDAxvugO4vy/PhbI5GhLyMkaLkaSTTA77qdOdy1YVrU SEvVd0DMnomoZX5hAD4KW4Wi58mU0YqVM2qqO/kxvgvjEJtaPQ8wnwV8j Q==; IronPort-SDR: HbY6sZiUNdCzyB12kvm6puITM6KGHJ2i78muAXLbu8x/aiWSBKZAzLhTVgSycfX33nm818i3iL plyGSTVWP8TUKsiOcz1bEoNooyZi+ZqH1B9XVdsMkIlnmJQdT4/6McijM+PHiWSSLYuGr+/8F3 74cvvF2Op+UZL1wn2EpjjuLIgParDECpO4YlYmSMo6V85/rG0e0rvdRDI1Ch1pWDY8iwaPNzbd Rmdftv5VZzFpf7n05VdYIfNILgdi1Vw5UHGrYvVcvDbs4Y8s2v55SJjrbf+D+1XiGs+SRLEQ7m VRg= X-IronPort-AV: E=Sophos;i="5.75,287,1589212800"; d="scan'208";a="141074526" Received: from mail-bn8nam12lp2176.outbound.protection.outlook.com (HELO NAM12-BN8-obe.outbound.protection.outlook.com) ([104.47.55.176]) by ob1.hgst.iphmx.com with ESMTP; 28 Jun 2020 00:21:27 +0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=L8gNZeHo5SJxyKwusO5bW5ZhuYVLhLnTlLfU//Sr6c6isMw6ezJ2sA1sVsg2QgcBpwi4156Rkso+gZU7i6jR1aqh2GD6EJ4hhTlcMRI6BqGfhuXm8D2QUIl2bN8rFk9QBCFziwl8fnlUGmNTdtqp+0/9OnjdxZwUSEasXJu2rF4y/Z+CmYpmtr4HyqkefCw2/n4vczllaPEZ9HBEe/OK/kLfo3pJS2Zn/ynkM37LFUzHKfRMZeKCYkKMhuWsqxGQ69DleF9o+pw6fORXKXsSvjwLRMO1sMZJ+KVSycJy5rfSjv+FvBSrIBLZuWsUQClxBvZX98nqefhTFIi6KJQbxA== 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=LKAyLfo04TzHYenRVAGkBgG/BhNVJ5ZBO2r3ArGrDPI=; b=X6XugljCX0Zn7+qtZTFEl2ptCcwTQ3YGsQ+B0LrY32bVKXQDWzwXxc2s/yU4mNi9Dwqx2hz7soiD7bvU2qzMbQ8woJEPAnJa379Bl8oQrIHySROFAv+epXalcS9e4f2B2QtXH+38nNi5NuOHQemLttpTpDWEKdPpcGL1LcpRlL4g/DzlErKT/lwvIoMo7nxHxLh/au48Qc08HZMj2Lu4QVtqLOI69WbUF0xG2JQgTEwAK6F4PKbHLPpHcbnmtKvI50FSh4+pvTZ2Z81IDZe4pl1jkbDlvHgdrRqCc9HFPnTWKtopm0f7pfT/qiTRXVMADitQsO8me33ZI9sajhDpLg== 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=LKAyLfo04TzHYenRVAGkBgG/BhNVJ5ZBO2r3ArGrDPI=; b=cz8WxmPsMyKlBNZaONetKt5E0FkMD8Zrur4Qvwl/clKmJtuwTa1T0VwqkSnIRyTU4qXO9PGoTiMF0c/bpffx1bJ4XXAr8FW3bfMIJEKn1JdEoVKoljnXclhBoCWGcDVui4vXJKWjMfJx0kjl9qH/3SyfVDIb6FLWJKNor24Bd98= Authentication-Results: dabbelt.com; dkim=none (message not signed) header.d=none;dabbelt.com; dmarc=none action=none header.from=wdc.com; Received: from MN2PR04MB6207.namprd04.prod.outlook.com (2603:10b6:208:de::32) by MN2PR04MB5725.namprd04.prod.outlook.com (2603:10b6:208:a2::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.24; Sat, 27 Jun 2020 16:21:27 +0000 Received: from MN2PR04MB6207.namprd04.prod.outlook.com ([fe80::e0ef:7fce:ff0d:f580]) by MN2PR04MB6207.namprd04.prod.outlook.com ([fe80::e0ef:7fce:ff0d:f580%7]) with mapi id 15.20.3131.026; Sat, 27 Jun 2020 16:21:27 +0000 From: Anup Patel To: Palmer Dabbelt , Paul Walmsley , Albert Ou , Rob Herring , Daniel Lezcano , Thomas Gleixner Cc: Damien Le Moal , Atish Patra , Alistair Francis , Anup Patel , linux-riscv@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Anup Patel , Palmer Dabbelt Subject: [PATCH v2 5/5] dt-bindings: timer: Add CLINT bindings Date: Sat, 27 Jun 2020 21:49:57 +0530 Message-Id: <20200627161957.134376-6-anup.patel@wdc.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200627161957.134376-1-anup.patel@wdc.com> References: <20200627161957.134376-1-anup.patel@wdc.com> X-ClientProxiedBy: MAXPR0101CA0029.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::15) To MN2PR04MB6207.namprd04.prod.outlook.com (2603:10b6:208:de::32) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from wdc.com (42.109.128.251) by MAXPR0101CA0029.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:d::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Sat, 27 Jun 2020 16:21:18 +0000 X-Mailer: git-send-email 2.25.1 X-Originating-IP: [42.109.128.251] X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: f83c4ecf-4e6a-423e-d426-08d81ab62416 X-MS-TrafficTypeDiagnostic: MN2PR04MB5725: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: WDCIPOUTBOUND: EOP-TRUE X-MS-Oob-TLC-OOBClassifiers: OLM:7691; X-Forefront-PRVS: 0447DB1C71 X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: No55Are/S05fEsGb7QWI1E2dsgLg9NgESDaKOYMbq2He6ncoVUZTNpyPYVDr4vjcNjhGZYo/d/pUzS2MbGSERvWLyS05KcGTo2N9jaR72Ckc/5ES9z9av0I8ATkqjnFku7DO+z5b6EY9Dna4Lzvo0brgt/G7Hhrt6AQ9+Pe9f63XLb7wPgo9CWc/FNZ8yHeW1DQewn1ycDIfh0Ylb0W7lhsNq6BmQougnVNN4VXWoPZSIJAOexHIkaU2qu/BfyA4iwIP0hZNO7fm6W6pTgJZxnfz4Wk6M7tM7DMeiIdntQqhKDLd2ZBeASm8idNv4WYKkz1mebu2NjQckD4q5ddOjQ== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:MN2PR04MB6207.namprd04.prod.outlook.com;PTR:;CAT:NONE;SFTY:;SFS:(4636009)(39860400002)(136003)(346002)(376002)(396003)(366004)(1076003)(8886007)(186003)(16526019)(52116002)(86362001)(55016002)(6666004)(1006002)(36756003)(7696005)(66946007)(5660300002)(83380400001)(26005)(66556008)(66476007)(110136005)(2616005)(4326008)(54906003)(478600001)(44832011)(8676002)(8936002)(2906002)(316002)(7416002)(956004);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData: ClsdVQeWFQiIoND4lcyRS9EIYo5UmBPICf/63C/6SFzwC0E36X91GGQEl0bjIGKPh1SWs4MslYv5vzec/eO5RN5E5znHmQZ0UvrMUdqlSA/bZhmw4tbmVda48bFEB+uUcTo4/8Mr0RSUvxLYy3xeUudDUFS07gxcHFd0zdetMUQVZH2+wzGwWpV4tp2WpmON2mT2f87jr8dSrfu3lfuXEYJJnPYEqyRWQig7mj+MWDBV8M1QRidDH+SyQUsjb+yTBLJ1PL1lVlju3HaZfFgnJ67dKiD/9i+0IHd5Xy54mb5LZutO2IIS26mexWrENedPN675OoujuFJdxXzUpjk5fUYeOWya02Y4qxY9R+TEv237i8KggFTig97zntESsPd2plMqoz6/2pZBgBm8t+V/2GNwVLJ9JbJ43DrIf97yAFf1l0H/Sn2+uS/R+LgL0jIhPBxewS+kvcHy5MA3EJVxGy3XtPlGC0c7yw9Sye3Ouyg= X-OriginatorOrg: wdc.com X-MS-Exchange-CrossTenant-Network-Message-Id: f83c4ecf-4e6a-423e-d426-08d81ab62416 X-MS-Exchange-CrossTenant-AuthSource: MN2PR04MB6207.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Jun 2020 16:21:27.0278 (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: JxGFtxbzZE6AvUivVmXLer1/+EvNmAHvh6NMxFVVK3DYLWMjluZA3l65fkFimV1TwchYRyoQ6Coo1fwPkDDVLg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR04MB5725 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org We add DT bindings documentation for CLINT device. Signed-off-by: Anup Patel Reviewed-by: Palmer Dabbelt --- .../bindings/timer/sifive,clint.txt | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 Documentation/devicetree/bindings/timer/sifive,clint.txt diff --git a/Documentation/devicetree/bindings/timer/sifive,clint.txt b/Documentation/devicetree/bindings/timer/sifive,clint.txt new file mode 100644 index 000000000000..45b75347a7d5 --- /dev/null +++ b/Documentation/devicetree/bindings/timer/sifive,clint.txt @@ -0,0 +1,34 @@ +SiFive Core Local Interruptor (CLINT) +------------------------------------- + +SiFive (and other RISC-V) SOCs include an implementation of the SiFive Core +Local Interruptor (CLINT) for M-mode timer and inter-processor interrupts. + +It directly connects to the timer and inter-processor interrupt lines of +various HARTs (or CPUs) so RISC-V per-HART (or per-CPU) local interrupt +controller is the parent interrupt controller for CLINT device. + +The clock frequency of CLINT 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 + +Required properties: +- compatible : should be "riscv,clint0" or "sifive,clint-1.0.0". A specific + string identifying the actual implementation can be added if implementation + specific worked arounds are needed. +- reg : Should contain 1 register range (address and length). +- interrupts-extended : Specifies which HARTs (or CPUs) are connected to + the CLINT. Each node pointed to should be a riscv,cpu-intc node, which + has a riscv node as parent. + +Example: + + clint@2000000 { + compatible = "sifive,clint-1.0.0", "sifive,fu540-c000-clint"; + interrupts-extended = < + &cpu1-intc 3 &cpu1-intc 7 + &cpu2-intc 3 &cpu2-intc 7 + &cpu3-intc 3 &cpu3-intc 7 + &cpu4-intc 3 &cpu4-intc 7>; + reg = <0x2000000 0x4000000>; + };