From patchwork Tue Sep 12 21:57:01 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Palmer Dabbelt X-Patchwork-Id: 9950253 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 4900A602C9 for ; Tue, 12 Sep 2017 22:01:39 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3883B28C60 for ; Tue, 12 Sep 2017 22:01:39 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2CE5229029; Tue, 12 Sep 2017 22:01:39 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.3 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7813528C60 for ; Tue, 12 Sep 2017 22:01:38 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751774AbdILWBh (ORCPT ); Tue, 12 Sep 2017 18:01:37 -0400 Received: from mail-pg0-f66.google.com ([74.125.83.66]:38808 "EHLO mail-pg0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751463AbdILV5s (ORCPT ); Tue, 12 Sep 2017 17:57:48 -0400 Received: by mail-pg0-f66.google.com with SMTP id m30so1775491pgn.5 for ; Tue, 12 Sep 2017 14:57:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=dabbelt-com.20150623.gappssmtp.com; s=20150623; h=subject:date:message-id:in-reply-to:references:cc:from:to; bh=P7hP37KZUH4PAc3F9bs8GLnkqlQP6YyLQnoFsrtUMrs=; b=OiZkgjPaC0H6XmJk5lPUXy3tjt9hxq45nnCstRYdF+e4smf70NGQf6R6K5Wv1CH3YS VtPu82Iu7q2uxLJUR2Uh9TEOoMZd/+9d9+nipZDhv4x54pri9fyZ8fUQWNL1tus+nqQX 1AevNMRcv0t2iLBQKSmVJrgGFMtMjsidk3CtQXD26r+1CUmJvpv+iei6dIwiMyK3NFe1 rCJ9kFPPFa3RrKsZSVTnV8dS6aFkamPz7aXZCta4Mg2uDomK3qqDe5rJpKlYB7aE2p0L QxZPvKjv8pAEHaJeKJ4CDmM/uZ3De4Ehf+AT1wHQDu8qGrayQLtUYuYPmJ2Bf2xshQvb s9Ew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:date:message-id:in-reply-to:references :cc:from:to; bh=P7hP37KZUH4PAc3F9bs8GLnkqlQP6YyLQnoFsrtUMrs=; b=g2VxgpMnqoauuFBv/4TauERy3giAXsXrnJG2RxSw2eafuwwe+eI7WvSiLxICFjGMog E4dX7Wy7O8OXc3rz7PZdHtzxvCwHb0hN9iKu7jVw6MpGke/4UQOIZv9uEBhzeqQxTUix 7+C2pIMO/4Ei2NO09xLwqC/LeJIJSdSocvzKFzEQQ7yelzwus0qOgCCNDERyCb11dk6r 8R6pFGuH/pwpa2JJpKzDLhBJUlT9vqMg1rdrIIoEVisRB+6qWA5qY+8VON/ohl8kVLA2 WW04X4z8qBlmZPVzOtbytAXvjQIBlQSeT7W/zZOznJjjPNvV0yHYoqWnvB1r2zWIn/CO Lfpw== X-Gm-Message-State: AHPjjUhaM2XEIJQ3Fw2iaT87BnL9+gdc+rvcjgCtZ92jyjImCwVuSFEV hMo8a2TCcSaA6B4g X-Google-Smtp-Source: ADKCNb5i77wyROMY+HkJn70TOTEoysMvPnBwXaf8MElH53QXg865m+1os43ng/ftW1u9sVV82KZ3fA== X-Received: by 10.99.157.200 with SMTP id i191mr15711940pgd.247.1505253468056; Tue, 12 Sep 2017 14:57:48 -0700 (PDT) Received: from localhost ([12.206.222.5]) by smtp.gmail.com with ESMTPSA id f74sm3833489pfa.36.2017.09.12.14.57.47 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 12 Sep 2017 14:57:47 -0700 (PDT) Subject: [PATCH v8 04/18] dt-bindings: interrupt-controller: RISC-V PLIC documentation Date: Tue, 12 Sep 2017 14:57:01 -0700 Message-Id: <20170912215715.4186-5-palmer@dabbelt.com> X-Mailer: git-send-email 2.13.5 In-Reply-To: <20170912215715.4186-1-palmer@dabbelt.com> References: <20170912215715.4186-1-palmer@dabbelt.com> Cc: yamada.masahiro@socionext.com, mmarek@suse.com, albert@sifive.com, will.deacon@arm.com, boqun.feng@gmail.com, oleg@redhat.com, mingo@redhat.com, daniel.lezcano@linaro.org, gregkh@linuxfoundation.org, jslaby@suse.com, davem@davemloft.net, mchehab@kernel.org, hverkuil@xs4all.nl, rdunlap@infradead.org, viro@zeniv.linux.org.uk, mhiramat@kernel.org, fweisbec@gmail.com, mcgrof@kernel.org, dledford@redhat.com, bart.vanassche@sandisk.com, sstabellini@kernel.org, mpe@ellerman.id.au, rmk+kernel@armlinux.org.uk, paul.gortmaker@windriver.com, nicolas.dichtel@6wind.com, linux@roeck-us.net, heiko.carstens@de.ibm.com, schwidefsky@de.ibm.com, geert@linux-m68k.org, akpm@linux-foundation.org, andriy.shevchenko@linux.intel.com, jiri@mellanox.com, vgupta@synopsys.com, airlied@redhat.com, jk@ozlabs.org, chris@chris-wilson.co.uk, Jason@zx2c4.com, paulmck@linux.vnet.ibm.com, ncardwell@google.com, linux-kernel@vger.kernel.org, linux-kbuild@vger.kernel.org, patches@groups.riscv.org, Palmer Dabbelt From: Palmer Dabbelt To: peterz@infradead.org, tglx@linutronix.de, jason@lakedaemon.net, marc.zyngier@arm.com, Arnd Bergmann , dmitriy@oss-tech.org Sender: linux-kbuild-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kbuild@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds documentation for the platform-level interrupt controller (PLIC) found in all RISC-V systems. This interrupt controller routes interrupts from all the devices in the system to each hart-local interrupt controller. Note: the DTS bindings for the PLIC aren't set in stone yet, as we might want to change how we're specifying holes in the hart list. Signed-off-by: Palmer Dabbelt --- .../bindings/interrupt-controller/riscv,plic0.txt | 55 ++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/riscv,plic0.txt diff --git a/Documentation/devicetree/bindings/interrupt-controller/riscv,plic0.txt b/Documentation/devicetree/bindings/interrupt-controller/riscv,plic0.txt new file mode 100644 index 000000000000..99cd359dbd43 --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/riscv,plic0.txt @@ -0,0 +1,55 @@ +RISC-V Platform-Level Interrupt Controller (PLIC) +------------------------------------------------- + +The RISC-V supervisor ISA specification allows for the presence of a +platform-level interrupt controller (PLIC). The PLIC connects all external +interrupts in the system to all hart contexts in the system, via the external +interrupt source in each hart's hart-local interrupt controller (HLIC). A hart +context is a privilege mode in a hardware execution thread. For example, in +an 4 core system with 2-way SMT, you have 8 harts and probably at least two +privilege modes per hart; machine mode and supervisor mode. + +Each interrupt can be enabled on per-context basis. Any context can claim +a pending enabled interrupt and then release it once it has been handled. + +Each interrupt has a configurable priority. Higher priority interrupts are +serviced firs. Each context can specify a priority threshold. Interrupts +with priority below this threshold will not cause the PLIC to raise its +interrupt line leading to the context. + +While the PLIC supports both edge-triggered and level-triggered interrupts, +interrupt handlers are oblivious to this distinction and therefor it is not +specific in the PLIC device-tree binding. + +While the RISC-V ISA doesn't specify a memory layout for the PLIC, the +"riscv,plic0" device is a concrete implementation of the PLIC that contains a +specific memory layout. More details about the memory layout of the +"riscv,plic0" device can be found as a comment in the device driver, or as part +of the SiFive U5 Coreplex Series Manual (page 22 of the PDF of version 1.0) + + +Required properties: +- compatible : "riscv,plic0" +- #address-cells : should be <0> +- #interrupt-cells : should be <1> +- interrupt-controller : Identifies the node as an interrupt controller +- reg : Should contain 1 register range (address and length) +- interrupts-extended : Specifies which contexts are connected to the PLIC, + with "-1" specifying that a context is not present. + +Example: + + plic: interrupt-controller@c000000 { + #address-cells = <0>; + #interrupt-cells = <1>; + compatible = "riscv,plic0"; + interrupt-controller; + interrupts-extended = < + &cpu0-intc 11 + &cpu1-intc 11 &cpu1-intc 9 + &cpu2-intc 11 &cpu2-intc 9 + &cpu3-intc 11 &cpu3-intc 9 + &cpu4-intc 11 &cpu4-intc 9>; + reg = <0xc000000 0x4000000>; + riscv,ndev = <10>; + };